' . esc_html( $page_details['description'] ) . '
' : '', 'help_links' => $help_links, 'source' => array( 'type' => 'plugin', 'name' => 'Ultimate FAQs', 'slug' => 'ultimate-faqs', ), 'target_callback' => array( __CLASS__, 'aiaa_target_callback' ), 'priority' => 20, 'capability' => 'manage_options', 'icon' => 'dashicons-editor-help', ); return $items; } /** * AIAA advanced targeting callback. * * @param array $context * @param array $item * @return bool * * @since 2.4.8 */ public static function aiaa_target_callback( $context, $item ) { $context = is_array( $context ) ? $context : array(); $screen_id = isset( $context['screen_id'] ) ? (string) $context['screen_id'] : ''; $post_type = isset( $context['post_type'] ) ? (string) $context['post_type'] : ''; $taxonomy = isset( $context['taxonomy'] ) ? (string) $context['taxonomy'] : ''; return self::aiaa_matches_context( $screen_id, $post_type, $taxonomy ); } /** * Shared matcher: aligns with should_button_display(), plus supports screen_id substring matches. * * @param string $screen_id * @param string $post_type * @param string $taxonomy * @return bool * * @since 2.4.8 */ private static function aiaa_matches_context( $screen_id, $post_type, $taxonomy ) { if ( ! empty( $post_type ) && in_array( $post_type, self::$post_types, true ) ) { return true; } if ( ! empty( $taxonomy ) && in_array( $taxonomy, self::$taxonomies, true ) ) { return true; } if ( ! empty( $screen_id ) && ! empty( self::$additional_pages ) ) { foreach ( self::$additional_pages as $slug ) { if ( empty( $slug ) ) { continue; } if ( strpos( $screen_id, $slug ) !== false ) { return true; } } } return false; } /** * Handle ajax requests in admin area for logged out users * @since 2.1.1 */ public static function admin_nopriv_ajax() { wp_send_json_error( array( 'error' => 'loggedout', 'msg' => sprintf( __( 'You have been logged out. Please %slogin again%s.', 'ultimate-faqs' ), '', '' ), ) ); } /** * Handle ajax requests where an invalid nonce is passed with the request * @since 2.1.1 */ public static function bad_nonce_ajax() { wp_send_json_error( array( 'error' => 'badnonce', 'msg' => __( 'The request has been rejected because it does not appear to have come from this site.', 'ultimate-faqs' ), ) ); } /** * Escapes PHP data being passed to JS, recursively * @since 2.1.0 */ public static function escape_js_recursive( $values ) { $return_values = array(); foreach ( (array) $values as $key => $value ) { if ( is_array( $value ) ) { $value = ewdufaqHelper::escape_js_recursive( $value ); } elseif ( ! is_scalar( $value ) ) { continue; } else { $value = html_entity_decode( (string) $value, ENT_QUOTES, 'UTF-8' ); } $return_values[ $key ] = $value; } return $return_values; } public static function display_help_button() { // If AI Admin Assistance (AIAA) is active, UFAQ help is provided via the // AIAA third-party help tab instead of showing the native UFAQ bubble. if ( defined( 'AIT_AIAA_VERSION' ) ) { return; } // If AIAA is active, UFAQ help will be provided via AIAA instead of the UFAQ bubble. if ( self::aiaa_is_active() ) { return; } if ( ! ewdufaqHelper::should_button_display() ) { return; } $page_details = self::get_page_details(); ?> post_type : ''; } else { $post_type = isset( $_GET['post_type'] ) ? sanitize_text_field( $_GET['post_type'] ) : ''; } if ( in_array( $post_type, self::$post_types ) ) { return true; } if ( in_array( $taxonomy, self::$taxonomies ) ) { return true; } if ( in_array( $page, self::$additional_pages ) ) { return true; } return false; } public static function enqueue_scripts() { if ( ! self::should_button_display() ) { return; } wp_enqueue_style( 'ewd-ufaq-admin-helper-button', EWD_UFAQ_PLUGIN_URL . '/assets/css/ewd-ufaq-helper-button.css', array(), EWD_UFAQ_PLUGIN_URL ); wp_enqueue_script( 'ewd-ufaq-admin-helper-button', EWD_UFAQ_PLUGIN_URL . '/assets/js/ewd-ufaq-helper-button.js', array( 'jquery' ), EWD_UFAQ_PLUGIN_URL, true ); } /** * Get page details based on an AIAA context array (AJAX-safe). * * @param array $context { screen_id, post_type, taxonomy } * @return array { description, tutorials } * * @since 2.4.8 */ public static function get_page_details_for_context( $context ) { $context = is_array( $context ) ? $context : array(); $screen_id = isset( $context['screen_id'] ) ? (string) $context['screen_id'] : ''; $post_type = isset( $context['post_type'] ) ? (string) $context['post_type'] : ''; $taxonomy = isset( $context['taxonomy'] ) ? (string) $context['taxonomy'] : ''; $req = ( isset( $context['request'] ) && is_array( $context['request'] ) ) ? $context['request'] : array(); // Prefer the AIAA request snapshot (most accurate for settings tabs). $page = isset( $req['page'] ) ? sanitize_text_field( $req['page'] ) : ''; // Derive a "page" slug from screen_id if not provided. if ( $screen_id && ! empty( self::$additional_pages ) ) { foreach ( self::$additional_pages as $slug ) { if ( $slug && strpos( $screen_id, $slug ) !== false ) { $page = $slug; break; } } } // AIAA request snapshot includes tab (e.g. ewd-ufaq-basic-tab). $tab = isset( $req['tab'] ) ? sanitize_text_field( $req['tab'] ) : ''; return self::get_page_details_by_values( $page, $tab, $taxonomy, $post_type ); } /** * Shared resolver used by both get_page_details() (GET-based) and get_page_details_for_context() (context-based). * * @param string $page * @param string $tab * @param string $taxonomy * @param string $post_type * @return array { description, tutorials } * * @since 2.4.8 */ private static function get_page_details_by_values( $page, $tab, $taxonomy, $post_type ) { $page_details = array( 'ufaq' => array( 'description' => __( 'The FAQs page displays a list of all your frequently asked questions, with options to manage them via quick edit, bulk actions, import/export tools, and sorting or search filters. This serves as the central hub for maintaining your FAQ content at scale.', 'ultimate-faqs' ), 'tutorials' => array( array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faqs/create', 'title' => 'Create an FAQ' ), array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faqs/create', 'title' => 'Add FAQs to a Page' ), array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faqs/edit', 'title' => 'Edit/Delete FAQs' ), array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faqs/sort', 'title' => 'Re-Order FAQs' ), ) ), 'edit-ufaq-question' => array( 'description' => __( 'The FAQ edit screen allows you to create or update an individual FAQ, including its question, answer, categories/tags, and display settings. Use this to keep your FAQs accurate and up to date.', 'ultimate-faqs' ), 'tutorials' => array( array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faqs/create', 'title' => 'Create an FAQ' ), array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faqs/edit', 'title' => 'Edit/Delete FAQs' ), ) ), 'ufaq-category' => array( 'description' => __( 'FAQ Categories let you organize your FAQs into groups for easier navigation and display. You can create, edit, and assign categories to FAQs from here.', 'ultimate-faqs' ), 'tutorials' => array( array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/categories', 'title' => 'FAQ Categories' ), ) ), 'ufaq-tag' => array( 'description' => __( 'FAQ Tags provide an additional way to label and filter FAQs. Use tags to help users find related questions or to power tag-based displays.', 'ultimate-faqs' ), 'tutorials' => array( array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/tags', 'title' => 'FAQ Tags' ), ) ), 'ewd-ufaq-dashboard' => array( 'description' => __( 'The Ultimate FAQs dashboard provides a quick overview of your plugin configuration, shortcuts to key areas, and useful resources to help you get started.', 'ultimate-faqs' ), 'tutorials' => array( array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/overview', 'title' => 'Plugin Overview' ), ) ), 'ewd-ufaq-ordering-table' => array( 'description' => __( 'Use the Ordering Table to quickly rearrange FAQs in the order they will appear. This is useful when you want precise control over the display sequence.', 'ultimate-faqs' ), 'tutorials' => array( array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faqs/sort', 'title' => 'Re-Order FAQs' ), ) ), 'ewd-ufaq-import' => array( 'description' => __( 'The Import screen allows you to upload FAQs in bulk from a file, saving time when migrating or creating large FAQ sets.', 'ultimate-faqs' ), 'tutorials' => array( array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/import', 'title' => 'Import FAQs' ), ) ), 'ewd-ufaq-export' => array( 'description' => __( 'The Export screen lets you download your FAQs and settings for backup or migration to another site.', 'ultimate-faqs' ), 'tutorials' => array( array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/export', 'title' => 'Export FAQs' ), ) ), 'ewd-ufaq-settings' => array( 'description' => __( 'The Settings page controls how your FAQs display and behave. Review options to match your theme and desired layout, and use the tabs to explore advanced configuration.', 'ultimate-faqs' ), 'tutorials' => array( array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/settings', 'title' => 'Settings Overview' ), ) ), 'ewd-ufaq-settings-styling' => array( 'description' => __( 'The Styling tab provides options to customize the look and feel of your FAQ display. You can adjust colors, typography, and layout-related settings.', 'ultimate-faqs' ), 'tutorials' => array( array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/styling', 'title' => 'Styling Settings' ), array( 'url' => 'https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/styling/css', 'title' => 'Custom CSS' ), ) ), ); $page = $page ? sanitize_text_field( $page ) : ''; $tab = $tab ? sanitize_text_field( $tab ) : ''; $taxonomy= $taxonomy ? sanitize_text_field( $taxonomy ) : ''; $post_type = $post_type ? sanitize_text_field( $post_type ) : ''; if ( $page && $tab && isset( $page_details[ $page . '-' . $tab ] ) ) { return $page_details[ $page . '-' . $tab ]; } if ( $page && isset( $page_details[ $page ] ) ) { return $page_details[ $page ]; } if ( $taxonomy && isset( $page_details[ $taxonomy ] ) ) { return $page_details[ $taxonomy ]; } if ( $post_type && isset( $page_details[ $post_type ] ) ) { return $page_details[ $post_type ]; } return array( 'description' => '', 'tutorials' => array() ); } public static function get_page_details() { $tab = isset( $_GET['tab'] ) ? sanitize_text_field( $_GET['tab'] ) : ''; $page = isset( $_GET['page'] ) ? sanitize_text_field( $_GET['page'] ) : ''; $taxonomy = isset( $_GET['taxonomy'] ) ? sanitize_text_field( $_GET['taxonomy'] ) : ''; if ( isset( $_GET['post'] ) ) { $post = get_post( intval( $_GET['post'] ) ); $post_type = $post ? $post->post_type : ''; } else { $post_type = isset( $_GET['post_type'] ) ? sanitize_text_field( $_GET['post_type'] ) : ''; } return self::get_page_details_by_values( $page, $tab, $taxonomy, $post_type ); } } // Register integrations after all plugins load. add_action( 'plugins_loaded', array( 'ewdufaqHelper', 'aiaa_add_filter' ), 20 ); add_action( 'admin_enqueue_scripts', array( 'ewdufaqHelper', 'enqueue_scripts' ) ); }