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 ); } }