LLMS_Rest_Admin_Settings_API_Keys::get_fields()
Get settings fields for the Keys tab.
Return Return
(array)
Source Source
File: libraries/lifterlms-rest/includes/admin/class-llms-rest-admin-settings-api-keys.php
public static function get_fields() {
require_once 'tables/class-llms-rest-table-api-keys.php';
$add_key = '1' === llms_filter_input( INPUT_GET, 'add-key', FILTER_SANITIZE_NUMBER_INT );
$key_id = llms_filter_input( INPUT_GET, 'edit-key', FILTER_SANITIZE_NUMBER_INT );
$settings = array();
$settings[] = array(
'class' => 'top',
'id' => 'rest_keys_options_start',
'type' => 'sectionstart',
);
$settings[] = array(
'title' => $key_id || $add_key ? __( 'API Key Details', 'lifterlms' ) : __( 'API Keys', 'lifterlms' ),
'type' => 'title-with-html',
'id' => 'rest_keys_options_title',
'html' => $key_id || $add_key ? '' : '<a href="' . esc_url( admin_url( 'admin.php?page=llms-settings&tab=rest-api§ion=keys&add-key=1' ) ) . '" class="llms-button-primary small" type="submit" style="top:-2px;">' . __( 'Add API Key', 'lifterlms' ) . '</a>',
);
if ( $add_key || $key_id ) {
$key = $add_key ? false : new LLMS_REST_API_Key( $key_id );
if ( self::$generated_key ) {
$key = self::$generated_key;
}
if ( $add_key || $key->exists() ) {
$user_id = $key ? $key->get( 'user_id' ) : get_current_user_id();
$settings[] = array(
'title' => __( 'Description', 'lifterlms' ),
'desc' => '<br>' . __( 'A friendly, human-readable, name used to identify the key.', 'lifterlms' ),
'id' => 'llms_rest_key_description',
'type' => 'text',
'value' => $key ? $key->get( 'description' ) : '',
'custom_attributes' => array(
'required' => 'required',
),
);
$settings[] = array(
'title' => __( 'User', 'lifterlms' ),
'class' => 'llms-select2-student',
'desc' => sprintf(
// Translators: %1$s = opening anchor tag to capabilities doc; %2$s closing anchor tag.
__( 'The owner is used to determine what user %1$scapabilities%2$s are available to the API key.', 'lifterlms' ),
'<a href="https://lifterlms.com/docs/roles-and-capabilities/" target="_blank">',
'</a>'
),
'custom_attributes' => array(
'data-placeholder' => __( 'Select a user', 'lifterlms' ),
),
'id' => 'llms_rest_key_user_id',
'options' => llms_make_select2_student_array( array( $user_id ) ),
'type' => 'select',
);
$settings[] = array(
'title' => __( 'Permissions', 'lifterlms' ),
'desc' => '<br>' . sprintf(
// Translators: %1$s = opening anchor tag to doc; %2$s closing anchor tag.
__( 'Determines what kind of requests can be made with the API key. %1$sRead more%2$s.', 'lifterlms' ),
'<a href="https://lifterlms.com/docs/getting-started-with-the-lifterlms-rest-api/#api-keys" target="_blank">',
'</a>'
),
'id' => 'llms_rest_key_permissions',
'type' => 'select',
'options' => LLMS_REST_API()->keys()->get_permissions(),
'value' => $key ? $key->get( 'permissions' ) : '',
);
if ( $key && ! self::$generated_key ) {
$settings[] = array(
'title' => __( 'Consumer key ending in', 'lifterlms' ),
'custom_attributes' => array(
'readonly' => 'readonly',
),
'class' => 'code',
'id' => 'llms_rest_key__read_only_key',
'type' => 'text',
'value' => '…' . $key->get( 'truncated_key' ),
);
$settings[] = array(
'title' => __( 'Last accessed at', 'lifterlms' ),
'custom_attributes' => array(
'readonly' => 'readonly',
),
'id' => 'llms_rest_key__read_only_date',
'type' => 'text',
'value' => $key->get_last_access_date(),
);
} elseif ( self::$generated_key ) {
$settings[] = array(
'type' => 'custom-html',
'id' => 'llms_rest_key_onetime_notice',
'value' => '<p style="padding: 10px;border-left:4px solid #ff922b;background:rgba(255, 146, 43, 0.3);">' . __( 'Make sure to copy or download the consumer key and consumer secret. After leaving this page they will not be displayed again.', 'lifterlms' ) . '</p>',
);
$settings[] = array(
'title' => __( 'Consumer key', 'lifterlms' ),
'custom_attributes' => array(
'readonly' => 'readonly',
),
'css' => 'width:400px',
'class' => 'code widefat',
'id' => 'llms_rest_key__read_only_key',
'type' => 'text',
'value' => $key->get( 'consumer_key_one_time' ),
);
$settings[] = array(
'title' => __( 'Consumer secret', 'lifterlms' ),
'custom_attributes' => array(
'readonly' => 'readonly',
),
'css' => 'width:400px',
'class' => 'code widefat',
'id' => 'llms_rest_key__read_only_secret',
'type' => 'text',
'value' => $key->get( 'consumer_secret' ),
);
}
$buttons = '<br><br>';
if ( self::$generated_key ) {
$download_url = wp_nonce_url(
admin_url(
add_query_arg(
array(
'id' => $key->get( 'id' ),
'ck' => base64_encode( $key->get( 'consumer_key_one_time' ) ), //phpcs:disable WordPress.PHP.DiscouragedPHPFunctions.obfuscation_base64_encode -- This is benign usage.
),
'admin.php'
)
),
'dl-key',
'dl-key-nonce'
);
$buttons .= '<a class="llms-button-primary" href="' . $download_url . '" target="_blank"><i class="fa fa-download" aria-hidden="true"></i> ' . __( 'Download Keys', 'lifterlms' ) . '</a>';
} else {
$buttons .= '<button class="llms-button-primary" type="submit" value="llms-rest-save-key">' . __( 'Save', 'lifterlms' ) . '</button>';
}
if ( $key ) {
$buttons .= $buttons ? ' ' : '<br><br>';
$buttons .= '<a class="llms-button-danger" href="' . esc_url( $key->get_delete_link() ) . '">' . __( 'Revoke', 'lifterlms' ) . '</a>';
}
$buttons .= wp_nonce_field( 'lifterlms-settings', '_wpnonce', true, false );
$settings[] = array(
'type' => 'custom-html',
'id' => 'llms_rest_key_buttons',
'value' => $buttons,
);
} else {
$settings[] = array(
'id' => 'rest_keys_options_invalid_error',
'type' => 'custom-html',
'value' => __( 'Invalid api key.', 'lifterlms' ),
);
}
} else {
$settings[] = array(
'id' => 'llms_api_keys_table',
'table' => new LLMS_REST_Table_API_Keys(),
'type' => 'table',
);
}
$settings[] = array(
'id' => 'rest_keys_options_end',
'type' => 'sectionend',
);
return $settings;
}
Expand full source code Collapse full source code View on GitHub
Changelog Changelog
| Version | Description |
|---|---|
| 1.0.0-beta.3 | Add "required" to the description field, add helper text, & add credential download option after generation. |
| 1.0.0-beta.1 | Introduced. |