settings = Plugin::get_settings( 'users' );
add_filter( 'adminease_settings_fields', [ $this, 'adminease_settings_fields' ] );
if( !current_user_can( 'edit_users' ) ) {
return;
}
if( empty( $this->settings['enable_users_metadata_box'] ) ) {
return;
}
add_action( 'show_user_profile', [ $this, 'render_metabox' ] );
add_action( 'edit_user_profile', [ $this, 'render_metabox' ] );
add_action( 'admin_footer', [ $this, 'render_modal' ] );
add_action( 'admin_enqueue_scripts', [ $this, 'admin_enqueue_scripts' ] );
add_action( 'wp_ajax_adminease_get_user_metadata', [ $this, 'ajax_get_user_metadata' ] );
add_action( 'wp_ajax_adminease_update_user_metadata', [ $this, 'ajax_update_user_metadata' ] );
add_action( 'wp_ajax_adminease_delete_user_metadata', [ $this, 'ajax_delete_user_metadata' ] );
}
/**
* Modifies and returns the settings fields for admin security features.
*
* @param array $fields The existing configuration fields to be updated with additional options.
*
* @return array The updated configuration fields, including the option to add metadata boxes to users.
*/
public function adminease_settings_fields( array $fields ): array {
$fields['users']['fields'][] = [
'type' => 'switch',
'id' => 'enable-users-metadata-box',
'name' => 'adminease[users][enable_users_metadata_box]',
'value' => $this->settings['enable_users_metadata_box'] ?? false,
'label_class' => 'pwp-switch',
'input_class' => 'pwp-field-input toggle-field',
'label' => __( 'Enable Users Metadata Box', 'adminease' ),
'description' => __( 'Enable a metadata box on user profile screens to view and manage custom fields easily.', 'adminease' ),
];
return $fields;
}
/**
* Renders the meta box content.
*
* @param WP_User $user The user object.
*
* @return void
*/
public function render_metabox( WP_User $user ): void {
$user_id = $user->ID;
if( !$user_id ) {
echo '
';
esc_html_e( 'Invalid user.', 'adminease' );
echo '
';
return;
}
?>
id, [ 'profile', 'user-edit' ] ) ) {
return;
}
// phpcs:ignore WordPress.Security.NonceVerification.Recommended
$user_id = isset( $_GET['user_id'] ) ? absint( $_GET['user_id'] ) : get_current_user_id();
?>
admin_url( 'admin-ajax.php' ),
'security' => [
'getUserMetadata' => wp_create_nonce( 'adminease_get_user_metadata' ),
'updateUserMetadata' => wp_create_nonce( 'adminease_update_user_metadata' ),
'deleteUserMetadata' => wp_create_nonce( 'adminease_delete_user_metadata' ),
],
'i18n' => [
'metadataModalTitleEdit' => esc_html__( 'Edit Metadata', 'adminease' ),
'metadataModalTitleAdd' => esc_html__( 'Add New Metadata', 'adminease' ),
'metadataConfirmDelete' => esc_html__( 'Are you sure you want to delete this metadata?', 'adminease' ),
'metadataLoadError' => esc_html__( 'Failed to load metadata. Please refresh the page and try again.', 'adminease' ),
'metadataSaveError' => esc_html__( 'Failed to save metadata. Please try again.', 'adminease' ),
'metadataDeleteError' => esc_html__( 'Failed to delete metadata. Please try again.', 'adminease' ),
'metadataSaveSuccess' => esc_html__( 'Metadata saved successfully.', 'adminease' ),
'metadataDeleteSuccess' => esc_html__( 'Metadata deleted successfully.', 'adminease' ),
'metadataKeyRequired' => esc_html__( 'Meta key is required.', 'adminease' ),
'metadataNoMetadata' => esc_html__( 'No metadata found for this user.', 'adminease' ),
'metadataEdit' => esc_html__( 'Edit', 'adminease' ),
'metadataDelete' => esc_html__( 'Delete', 'adminease' ),
'metadataInvalidJSON' => esc_html__( 'Invalid JSON format. Please check your value.', 'adminease' ),
'metadataLoading' => esc_html__( 'Loading metadata...', 'adminease' ),
'metadataTableHeaderKey' => esc_html__( 'Meta Key', 'adminease' ),
'metadataTableHeaderValue' => esc_html__( 'Meta Value', 'adminease' ),
'metadataTableHeaderActions' => esc_html__( 'Actions', 'adminease' ),
'metadataProtectedKey' => esc_html__( 'Protected meta key', 'adminease' ),
'metadataSearch' => esc_html__( 'Search metadata...', 'adminease' ),
'metadataSortAZ' => esc_html__( 'Sort A-Z', 'adminease' ),
'metadataSortZA' => esc_html__( 'Sort Z-A', 'adminease' ),
'metadataNoResults' => esc_html__( 'No metadata found matching your search.', 'adminease' ),
],
]
);
}
/**
* AJAX handler to get user metadata.
*
* @return void
*/
public function ajax_get_user_metadata(): void {
if( !isset( $_POST['security'] ) || !wp_verify_nonce( sanitize_key( wp_unslash( $_POST['security'] ) ), 'adminease_get_user_metadata' ) ) {
wp_send_json_error( [ 'message' => esc_html__( 'Security check failed. Refresh the page and try again.', 'adminease' ) ] );
}
$user_id = isset( $_POST['user_id'] ) ? absint( $_POST['user_id'] ) : 0;
if( !$user_id || !current_user_can( 'edit_users' ) ) {
wp_send_json_error( [ 'message' => esc_html__( 'Invalid user or insufficient permissions.', 'adminease' ) ] );
}
$all_meta = get_user_meta( $user_id );
$metadata = [];
foreach( $all_meta as $key => $values ) {
$value = $values[0] ?? '';
$display_value = $this->format_meta_value( $value );
$metadata[] = [
'key' => $key,
'value' => $value,
'display_value' => $display_value,
'is_serialized' => is_serialized( $value ),
'is_protected' => substr( $key, 0, 1 ) === '_',
];
}
wp_send_json_success( [ 'metadata' => $metadata ] );
}
/**
* AJAX handler to update user metadata.
*
* @return void
*/
public function ajax_update_user_metadata(): void {
if( !isset( $_POST['security'] ) || !wp_verify_nonce( sanitize_key( wp_unslash( $_POST['security'] ) ), 'adminease_update_user_metadata' ) ) {
wp_send_json_error( [ 'message' => esc_html__( 'Security check failed. Refresh the page and try again.', 'adminease' ) ] );
}
$user_id = isset( $_POST['user_id'] ) ? absint( $_POST['user_id'] ) : 0;
$meta_key = isset( $_POST['meta_key'] ) ? sanitize_text_field( wp_unslash( $_POST['meta_key'] ) ) : '';
$meta_value = isset( $_POST['meta_value'] ) ? wp_unslash( $_POST['meta_value'] ) : ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
$original_key = isset( $_POST['original_key'] ) ? sanitize_text_field( wp_unslash( $_POST['original_key'] ) ) : '';
if( !$user_id || !current_user_can( 'edit_users' ) ) {
wp_send_json_error( [ 'message' => esc_html__( 'Invalid user or insufficient permissions.', 'adminease' ) ] );
}
if( empty( $meta_key ) ) {
wp_send_json_error( [ 'message' => esc_html__( 'Meta key is required.', 'adminease' ) ] );
}
$processed_value = $this->process_meta_value( $meta_value );
if( !empty( $original_key ) && $original_key !== $meta_key ) {
delete_user_meta( $user_id, $original_key );
}
update_user_meta( $user_id, $meta_key, $processed_value );
wp_send_json_success( [ 'message' => esc_html__( 'Metadata updated successfully.', 'adminease' ) ] );
}
/**
* AJAX handler to delete user metadata.
*
* @return void
*/
public function ajax_delete_user_metadata(): void {
if( !isset( $_POST['security'] ) || !wp_verify_nonce( sanitize_key( wp_unslash( $_POST['security'] ) ), 'adminease_delete_user_metadata' ) ) {
wp_send_json_error( [ 'message' => esc_html__( 'Security check failed. Refresh the page and try again.', 'adminease' ) ] );
}
$user_id = isset( $_POST['user_id'] ) ? absint( $_POST['user_id'] ) : 0;
$meta_key = isset( $_POST['meta_key'] ) ? sanitize_text_field( wp_unslash( $_POST['meta_key'] ) ) : '';
if( !$user_id || !current_user_can( 'edit_users' ) ) {
wp_send_json_error( [ 'message' => esc_html__( 'Invalid user or insufficient permissions.', 'adminease' ) ] );
}
if( empty( $meta_key ) ) {
wp_send_json_error( [ 'message' => esc_html__( 'Meta key is required.', 'adminease' ) ] );
}
delete_user_meta( $user_id, $meta_key );
wp_send_json_success( [ 'message' => esc_html__( 'Metadata deleted successfully.', 'adminease' ) ] );
}
/**
* Formats meta value for display.
*
* @param mixed $value The meta value.
*
* @return string Formatted value.
*/
private function format_meta_value( $value ): string {
$unserialized = maybe_unserialize( $value );
if( is_array( $unserialized ) || is_object( $unserialized ) ) {
return wp_json_encode( $unserialized, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE );
}
return (string) $value;
}
/**
* Processes meta value from form input.
* Detects JSON and converts it to proper PHP structure.
*
* @param mixed $value The input value.
*
* @return mixed Processed value.
*/
private function process_meta_value( $value ) {
if( is_serialized( $value ) ) {
return $value;
}
$decoded = json_decode( $value, true );
if( json_last_error() === JSON_ERROR_NONE && ( is_array( $decoded ) || is_object( $decoded ) ) ) {
return $decoded;
}
return sanitize_textarea_field( $value );
}
}