container = $container; $this->assets = $assets; $this->settings = $settings; $this->kbmigration = $kbmigration; $this->slug = 'betterdocs-dashboard'; add_action( 'init', [ $type, 'register' ], 9 ); add_action('rest_api_init', [$this, 'order_terms_in_wp_terms_admin_table']); $type->init(); $type->admin_init(); $this->faq_builder = $this->container->get( FAQBuilder::class ); $this->glossaries = $this->container->get( Glossaries::class ); if ( ! is_admin() ) { return; } $this->installer = new PluginInstaller(); $this->plugin_insights(); add_action( 'admin_notices', [ $this, 'compatibility_notices' ] ); // add_action( 'admin_init', [$this, 'notices'], 9 ); add_filter( 'admin_init', [ $this, 'save_admin_page' ], 99 ); add_action( 'admin_menu', [ $this, 'menus' ] ); add_action( 'admin_menu', [ $this, 'reset_submenu' ] ); add_action( 'admin_head', [ $this, 'add_custom_classes_to_menu_items' ] ); add_filter( 'plugin_action_links_' . BETTERDOCS_PLUGIN_BASENAME, [ $this, 'insert_plugin_links' ] ); // $this->container->get( SetupWizard::class )->init(); add_action( 'admin_enqueue_scripts', [ $this, 'styles' ] ); add_action( 'admin_enqueue_scripts', [ $this, 'scripts' ] ); //add_action( 'betterdocs_listing_header', [ $this, 'header' ], 10, 1 ); add_action( 'admin_bar_menu', [ $this, 'toolbar_menu' ], 32 ); add_filter( 'admin_body_class', [ $this, 'body_classes' ] ); add_filter( 'parent_file', [ $type, 'highlight_admin_menu' ] ); add_filter( 'submenu_file', [ $type, 'highlight_admin_submenu' ], 10, 2 ); add_filter( 'betterdocs_admin_menu', [ $this, 'quick_setup_menu' ], 10, 1 ); /** * Remove Comments Column from List Table. */ add_filter( 'manage_docs_posts_columns', [ $this, 'set_custom_edit_action_columns' ] ); add_filter( 'manage_docs_posts_custom_column', [ $this, 'manage_custom_columns' ], 10, 2 ); /** * Add New Column */ add_filter( 'manage_users_columns', [ $this, 'add_users_total_docs_column' ], 10, 1 ); add_filter( 'manage_users_custom_column', [ $this, 'popular_users_docs_data' ], 10, 3 ); if ( is_plugin_active( 'betterdocs-pro/betterdocs-pro.php' ) ) { add_action( 'admin_footer-plugins.php', array( $this, 'disable_deactivation' ) ); } if ( $this->settings->get( 'enable_estimated_reading_time' ) ) { add_action( 'add_meta_boxes', [ $this, 'reading_meta_box_' ], 10 ); } self::$cache_bank = CacheBank::get_instance(); // Remove OLD notice from 1.0.0 (if other WPDeveloper plugin has notice) NoticeRemover::get_instance( '1.0.0' ); try { $this->notices(); } catch ( Exception $e ) { unset( $e ); } } public function order_terms_in_wp_terms_admin_table() { //order the terms correctly to be shown on the admin panel categories menu with betterdocs order add_action('rest_insert_doc_category', function( $term, $request, $bool ) { $max_order = Helper::get_max_doc_category_order_from_term_meta() ?? 0; $next_order = $max_order + 1; update_term_meta( $term->term_id, 'doc_category_order', $next_order ); }, 10, 3); } public function disable_deactivation() { $tooltip_text = esc_html__( 'Deactivate BetterDocs Pro First', 'betterdocs' ); ?> __( 'Docs', 'betterdocs' ) ]; $columns = array_merge( $columns, $new_column ); return $columns; } public function popular_users_docs_data( $output, $column_name, $user_id ) { if ( $column_name == 'docs' ) { $total_count = count_user_posts( $user_id, 'docs', true ); return ''; } return $output; } public function reading_meta_box_() { add_meta_box( 'betterdocs_estimated_time_metabox', __( 'Estimated Reading Time', 'betterdocs' ), [ $this, 'render_estimated_time_markup' ], 'docs' ); } public function render_estimated_time_markup() { betterdocs()->views->get( 'admin/metabox/estimated-reading-box' ); } public function compatibility_notices() { if ( betterdocs()->is_pro_active() ) { $plugins = Helper::get_plugins(); $plugin_data = $plugins['betterdocs-pro/betterdocs-pro.php']; if ( isset( $plugin_data['Version'] ) && version_compare( $plugin_data['Version'], '2.5.0', '>=' ) ) { return; } betterdocs()->views->get( 'admin/notices/compatibility', [ 'version' => $plugin_data['Version'] ] ); } } public function plugin_insights( $prevent_init = false ) { $this->insights = Insights::get_instance( BETTERDOCS_PLUGIN_FILE, [ 'opt_in' => true, 'goodbye_form' => true, 'item_id' => 'c7b16777b4f1b83f6083' ] ); $this->insights->set_notice_options( [ 'notice' => __( 'Want to help make BetterDocs even more awesome? You can get a 10% discount coupon for Premium extensions if you allow us to track the usage.', 'betterdocs' ), 'extra_notice' => __( 'We collect non-sensitive diagnostic data and plugin usage information. Your site URL, WordPress & PHP version, plugins & themes and email address to send you the discount coupon. This data lets us make sure this plugin always stays compatible with the most popular plugins and themes. No spam, I promise.', 'betterdocs' ) ] ); if ( ! $prevent_init ) { $this->insights->init(); } return $this->insights; } /** * Admin notices for Review and others. * * @return void * @throws Exception */ public function notices() { $notices = new Notices( [ 'id' => 'betterdocs', 'storage_key' => 'notices', 'lifetime' => 3, 'stylesheet_url' => $this->assets->asset_url( 'admin/css/notices.css' ), 'styles' => $this->assets->asset_url( 'admin/css/notices.css' ), 'priority' => 4 ] ); /** * Review Notice * @var mixed $message */ $message = __( 'We hope you\'re enjoying BetterDocs! Could you please do us a BIG favor and give it a 5-star rating on WordPress to help us spread the word and boost our motivation?', 'betterdocs' ); $_review_notice = [ 'thumbnail' => $this->assets->icon( 'betterdocs-logo.svg', true ), 'html' => '

' . $message . '

', 'links' => [ 'later' => [ 'link' => 'https://wordpress.org/plugins/betterdocs/#reviews', 'target' => '_blank', 'label' => __( 'Sure, you deserve it!', 'betterdocs' ), 'icon_class' => 'dashicons dashicons-external' ], 'allready' => [ 'label' => __( 'I already did', 'betterdocs' ), 'icon_class' => 'dashicons dashicons-smiley', 'attributes' => [ 'data-dismiss' => true ] ], 'maybe_later' => [ 'label' => __( 'Maybe Later', 'betterdocs' ), 'icon_class' => 'dashicons dashicons-calendar-alt', 'attributes' => [ 'data-later' => true, 'class' => 'dismiss-btn' ] ], 'support' => [ 'link' => 'https://wpdeveloper.com/support', 'attributes' => [ 'target' => '_blank' ], 'label' => __( 'I need help', 'betterdocs' ), 'icon_class' => 'dashicons dashicons-sos' ], 'never_show_again' => [ 'label' => __( 'Never show again', 'betterdocs' ), 'icon_class' => 'dashicons dashicons-dismiss', 'attributes' => [ 'data-dismiss' => true ] ] ] ]; $notices->add( 'review', $_review_notice, [ 'start' => $notices->strtotime( '+10 days' ), 'recurrence' => 30, 'dismissible' => true ] ); if ( $this->kbmigration->existing_plugins && ! in_array( $this->kbmigration->existing_plugins[0][0], $this->kbmigration->migrated_plugins ) ) { $plugin_name = '' . esc_html( $this->kbmigration->existing_plugins[0][1] ) . ''; $message = sprintf( /* translators: %s is the name of the existing knowledge base plugin. */ __( 'Already using %s? Power up your Knowledge Base by migrating all your docs and settings to BetterDocs with just 1 click.', 'betterdocs' ), esc_html( $plugin_name ) ); $migration_message = sprintf( '

%s

%s', $message, esc_url( admin_url( 'admin.php?page=betterdocs-settings&tab=tab-migration' ) ), esc_html__( 'Start Migration', 'betterdocs' ) ); $_migration_notice = [ 'thumbnail' => '', 'html' => $migration_message, 'links' => [ 'maybe_later' => [ 'label' => __( 'Maybe Later', 'betterdocs' ), 'icon_class' => 'dashicons dashicons-calendar-alt', 'attributes' => [ 'data-later' => true, 'class' => 'dismiss-btn' ] ], 'never_show_again' => [ 'label' => __( 'Never show again', 'betterdocs' ), 'icon_class' => 'dashicons dashicons-dismiss', 'attributes' => [ 'data-dismiss' => true ] ] ] ]; $notices->add( 'migration', $_migration_notice, [ 'start' => $notices->time(), 'recurrence' => false, 'dismissible' => true ] ); } /** * Opt-In Notice */ $allow_tracking = get_option( 'wpins_allow_tracking' ); if ( $this->insights != null && ! isset( $allow_tracking['betterdocs'] ) ) { $notices->add( 'opt_in', [ $this->insights, 'notice' ], [ 'classes' => 'updated put-dismiss-notice', 'start' => $notices->time(), 'refresh' => BETTERDOCS_VERSION, 'dismissible' => true, 'do_action' => 'wpdeveloper_notice_clicked_for_betterdocs', 'display_if' => ! function_exists( 'betterdocs_pro' ), 'screens' => [ 'dashboard' ] ] ); } // $blackfriday_message = '

🛍️ Black Friday Specials: Save up to 35% OFF on BetterDocs PRO plans & manage docs/FAQs seamlessly.

// // // Upgrade To PRO
'; // $_blackfriday_notice = [ // 'thumbnail' => $this->assets->icon( 'betterdocs-logo.svg', true ), // 'html' => $blackfriday_message // ]; // $notices->add( // 'blackfriday24', // $_blackfriday_notice, // [ // 'start' => $notices->time(), // 'recurrence' => false, // 'dismissible' => true, // 'refresh' => BETTERDOCS_VERSION, // 'expire' => strtotime( '11:59:59pm December 5, 2024' ), // 'display_if' => ! is_plugin_active( 'betterdocs-pro/betterdocs-pro.php' ) // ] // ); $offer_message = '

🎉 BetterDocs Just Hit 40,000+ Users! Join the celebration with 20% OFF & unlock even more power with premium features today!

Upgrade To PRO
'; $_offer_notice = [ 'thumbnail' => $this->assets->icon( 'betterdocs-logo.svg', true ), 'html' => $offer_message ]; $notices->add( '40k_offer', $_offer_notice, [ 'start' => $notices->time(), 'recurrence' => false, 'dismissible' => true, 'refresh' => BETTERDOCS_VERSION, 'expire' => strtotime( '11:59:59pm April 30, 2025' ), 'display_if' => ! is_plugin_active( 'betterdocs-pro/betterdocs-pro.php' ) ] ); self::$cache_bank->create_account( $notices ); self::$cache_bank->calculate_deposits( $notices ); if ( method_exists( self::$cache_bank, 'clear_notices_in_' ) ) { self::$cache_bank->clear_notices_in_( [ 'toplevel_page_betterdocs-dashboard', 'admin_page_betterdocs-admin', 'betterdocs_page_betterdocs-admin', 'betterdocs_page_betterdocs-settings', 'betterdocs_page_betterdocs-faq', 'betterdocs_page_betterdocs-analytics', 'betterdocs_page_betterdocs-glossaries', 'betterdocs_page_betterdocs-ai-chatbot', 'edit-doc_category', 'edit-doc_tag' ], $notices, true ); } } public function body_classes( $classes ) { $saved_settings = get_option( 'betterdocs_settings', false ); $dark_mode = isset( $saved_settings['dark_mode'] ) ? $saved_settings['dark_mode'] : false; $dark_mode = ! empty( $dark_mode ) ? boolval( $dark_mode ) : false; $current_screen_id = get_current_screen() != null ? str_replace( 'betterdocs_page_', '', str_replace( 'toplevel_page_', '', str_replace( 'admin_page_', '', get_current_screen()->id ) ) ) : ''; $registered_screens = [ 'betterdocs-settings', 'betterdocs-admin', 'betterdocs-dashboard', 'betterdocs-analytics', 'betterdocs-glossaries', 'betterdocs-faq', 'edit-doc_category', 'edit-doc_tag', 'edit-knowledge_base', 'betterdocs-ai-chatbot' ]; if( in_array( $current_screen_id, $registered_screens ) ) { $classes .= ' betterdocs-admin '; } if ( $dark_mode === true && in_array( $current_screen_id, $registered_screens ) ) { $classes .= ' betterdocs-dark-mode '; } return $classes; } /** * Remove Comments Column From List Table * * @param array $columns * * @return array * @since 1.0.0 */ public function set_custom_edit_action_columns( $columns ) { unset( $columns['comments'] ); $new_columns = []; foreach ( $columns as $key => $value ) { if ( $key == 'date' ) { $new_columns['betterdocs_word_count'] = __( 'Word Count', 'betterdocs' ); // put the tags column before it $new_columns['betterdocs_reaction'] = __( 'Reactions', 'betterdocs' ); } $new_columns[ $key ] = $value; } return $new_columns; } public function manage_custom_columns( $column, $post_id ) { global $wpdb; switch ( $column ) { case 'betterdocs_word_count': $content_without_html_tags = trim( strip_tags( get_post_field( 'post_content', $post_id ) ) ); preg_match_all( '/<[^>]*>|[\p{L}\p{M}]+/u', $content_without_html_tags, $matches ); $total_words = ! empty( $matches[0] ) ? count( $matches[0] ) : count( [] ); $word_count = $total_words; echo '' . esc_html( intval( $word_count ) ) . ''; break; case 'betterdocs_reaction': $where = "WHERE post_id='" . esc_sql( $post_id ) . "'"; $analytics = $wpdb->get_results( "SELECT sum(impressions) as totalViews, sum(unique_visit) as totalUniqueViews, sum(happy + sad + normal) as totalReactions, sum(happy) as totalHappy, sum(normal) as totalNormal, sum(sad) as totalSad FROM {$wpdb->prefix}betterdocs_analytics $where" ); echo ''; break; } } /** * Enqueue Assets for Admin ( Styles ) * * @param string $hook * * @return void * @since 1.0.0 */ public function styles( $hook ) { $this->assets->enqueue( 'betterdocs-global', 'admin/css/global.css', [], 'all' ); if ( ! betterdocs()->is_betterdocs_screen( $hook ) ) { return; } $this->assets->enqueue( 'betterdocs-select2', 'vendor/css/select2.min.css', [], 'all' ); $this->assets->enqueue( 'betterdocs-daterangepicker', 'vendor/css/daterangepicker.css', [], 'all' ); $this->assets->enqueue( 'betterdocs-old', 'admin/css/betterdocs.css', [], 'all' ); /** * This scripts enqueued for Dashboard App. */ $this->assets->enqueue( 'betterdocs', 'admin/css/dashboard.css', [ 'betterdocs-old' ], '', BETTERDOCS_VERSION ); $this->assets->enqueue( 'betterdocs-icons', 'admin/btd-icon/style.css' ); } /** * Enqueue Assets for Admin ( Scripts ) * * @param string $hook * * @return void * @since 1.0.0 */ public function scripts( $hook ) { if ( ( $hook === 'edit.php' ) && get_post_type() == 'docs' ) { $this->assets->enqueue( 'betterdocs-switcher', 'admin/js/switcher.js', [ 'jquery' ] ); $this->assets->localize( 'betterdocs-switcher', 'betterdocsSwitcher', [ 'menu_title' => __( 'Switch to BetterDocs UI', 'betterdocs' ), 'site_address' => get_bloginfo( 'url' ), 'betterdocs_pro_plugin' => betterdocs()->is_pro_active(), 'betterdocs_pro_version' => betterdocs()->pro_version() ] ); return; } wp_enqueue_script( 'wp-editor' ); // enqueue this for yoast related issue if ( ! betterdocs()->is_betterdocs_screen( $hook ) ) { return; } wp_enqueue_media(); // load early to fix problems with media upload issues on settings for wordpress 6.0.9 $this->assets->register( 'betterdocs-admin', 'admin/js/dashboard.js' ); $saved_settings = get_option( 'betterdocs_settings', false ); $dark_mode = $saved_settings['dark_mode'] ?? false; $dark_mode = ! empty( $dark_mode ) && boolval( $dark_mode ); $this->assets->localize( 'betterdocs-admin', 'betterdocs_admin', [ 'ajaxurl' => admin_url( 'admin-ajax.php' ), 'doc_cat_order_nonce' => wp_create_nonce( 'doc_cat_order_nonce' ), 'knowledge_base_order_nonce' => wp_create_nonce( 'knowledge_base_order_nonce' ), 'paged' => isset( $_GET['paged'] ) ? absint( wp_unslash( $_GET['paged'] ) ) : 0, // phpcs:ignore WordPress.Security.NonceVerification.Missing 'per_page_id' => 'edit_doc_category_per_page', 'menu_title' => __( 'Switch to BetterDocs UI', 'betterdocs' ), 'dark_mode' => $dark_mode, 'text' => __( 'Copied!', 'betterdocs' ), 'test_report' => __( 'Test Report!', 'betterdocs' ), 'sending' => __( 'Sending...', 'betterdocs' ), 'dir_url' => BETTERDOCS_ABSURL, 'rest_url' => esc_url_raw( rest_url() ), 'free_version' => betterdocs()->version, 'generate_data_url' => get_rest_url( null, '/betterdocs/v1/create-sample-docs' ), 'nonce' => wp_create_nonce( 'wp_rest' ), 'sync_nonce' => wp_create_nonce( 'ai_chatbot_embed' ), 'count_all_docs' => array_sum((array) wp_count_posts('docs')), 'count_all_faq' => array_sum((array) wp_count_posts('betterdocs_faq')), 'count_new_docs' => count(get_option('saved_docs_post_ids', [])) + count(get_option('betterdocs_ai_chatbot_error_posts', [])), 'admin_url' => admin_url(), 'ia_preview' => betterdocs()->settings->get( 'ia_enable_preview', false ), 'multiple_kb' => betterdocs()->settings->get( 'multiple_kb' ), 'previewMode' => betterdocs()->settings->get( 'ia_enable_preview', false ), 'dashboard_mode' => get_option( 'dashboard_mode' ), 'betterdocs_pro_plugin' => betterdocs()->is_pro_active(), 'betterdocs_pro_version' => betterdocs()->pro_version(), 'analytics_older' => version_compare( betterdocs()->pro_version(), '3.3.4', '<=' ), 'disabled_embed_model_option' => get_option('disabled_embed_model_option'), 'betterdocs_ChatBot_plugin' => is_plugin_active( 'betterdocs-ai-chatbot/betterdocs-ai-chatbot.php' ), 'total_doc_category_terms' => wp_count_terms( 'doc_category') ] ); // If wp-date (which includes moment.js) is not registered, enqueue your custom moment.js if ( ! wp_script_is( 'wp-date', 'registered' ) ) { $this->assets->enqueue( 'moment', 'vendor/js/moment.min.js', [] ); } wp_enqueue_script( 'betterdocs-admin' ); /** * Duplicate Codes Need to Be Removed From Here Onwards */ //FAQ Builder Related Localization betterdocs()->assets->enqueue( 'betterdocs-admin-faq', 'admin/css/faq.css' ); betterdocs()->assets->enqueue( 'betterdocs-admin-faq', 'admin/js/faq.js' ); // removing emoji support remove_action( 'wp_head', 'print_emoji_detection_script', 7 ); remove_action( 'admin_print_scripts', 'print_emoji_detection_script' ); betterdocs()->assets->localize( 'betterdocs-admin-faq', 'betterdocsFaq', [ 'dir_url' => BETTERDOCS_ABSURL, 'rest_url' => esc_url_raw( rest_url() ), 'free_version' => betterdocs()->version, 'nonce' => wp_create_nonce( 'wp_rest' ), 'betterdocs_settings' => get_option( 'betterdocs_settings', false ) ] ); //Glossaries Related Localization betterdocs()->assets->enqueue( 'betterdocs-admin-glossaries', 'admin/css/faq.css' ); betterdocs()->assets->enqueue( 'betterdocs-admin-glossaries', 'admin/js/glossaries.js' ); betterdocs()->assets->localize( 'betterdocs-admin-glossaries', 'betterdocsGlossary', [ 'dir_url' => BETTERDOCS_ABSURL, 'rest_url' => esc_url_raw( rest_url() ), 'free_version' => betterdocs()->version, 'nonce' => wp_create_nonce( 'wp_rest' ), 'betterdocs_settings' => get_option( 'betterdocs_settings', false ) ] ); } /** * All admin pages header * * @return void * @since 1.0.0 */ public function header( $admin_tab_name ) { $quick_links = [ 'switch_view' => sprintf( '%s', add_query_arg( [ 'post_type' => 'docs', 'bdocs_view' => 'classic' ], 'edit.php' ), __( 'Switch to Classic UI', 'betterdocs' ) ), 'add_new_doc' => sprintf( '%s', add_query_arg( [ 'post_type' => 'docs' ], 'post-new.php' ), __( 'Add New Doc', 'betterdocs' ) ) ]; $quick_links = apply_filters( 'betterdocs_quick_links', $quick_links ); betterdocs()->views->get( 'admin/header', [ 'quick_links' => $quick_links, 'active_tab' => $admin_tab_name ] ); } /** * Register all the menus for BetterDocs * * @return void * @since 1.0.0 */ public function menus() { $default_args = [ 'page_title' => 'BetterDocs', 'menu_title' => 'BetterDocs', 'capability' => 'edit_docs', // Unified capability 'menu_slug' => $this->slug, 'callback' => [ $this, 'output' ], 'icon_url' => betterdocs()->assets->icon( 'betterdocs-icon-white.svg', true ), 'position' => 5 ]; $_menu_position = 5; global $submenu; // Always register both UI endpoints $this->register_modern_ui_fallback(); foreach ( $this->menu_list() as $key => $value ) { if ( $key === 'betterdocs' ) { $callable = 'add_menu_page'; $value = wp_parse_args( $value, $default_args ); call_user_func_array( $callable, $value ); } else { $is_core_page = strpos($value['menu_slug'], '?') !== false; if ($is_core_page) { // Add classic UI directly $submenu[$this->slug][] = [ $value['menu_title'], $value['capability'], $value['menu_slug'], $value['page_title'] ]; } else { // Add modern UI through WordPress API add_submenu_page( $this->slug, $value['page_title'], $value['menu_title'], $value['capability'], $value['menu_slug'], $value['callback'] ); } $_menu_position++; } } } private function register_modern_ui_fallback() { // Add the submenu with valid parent slug add_submenu_page( 'betterdocs', // Valid parent slug __('All Docs', 'betterdocs'), '', // Empty menu title hides it 'edit_docs', 'betterdocs-admin', [ $this, 'output' ] ); // Hide the menu item from appearing in the admin sidebar global $submenu; if (isset($submenu['betterdocs'])) { foreach ($submenu['betterdocs'] as $key => $item) { if ($item[2] === 'betterdocs-admin') { unset($submenu['betterdocs'][$key]); break; } } } } /** * BetterDocs Admin Page Output * * @return void * @since 1.0.0 */ public function output() { if ( betterdocs()->is_pro_active() && version_compare( betterdocs()->pro_version(), '3.3.4', '<=' ) && get_current_screen()->id == 'betterdocs_page_betterdocs-analytics' ) { betterdocs_pro()->views->get( 'admin/analytics-pro' ); } else { betterdocs()->views->get( 'admin/main', [ 'admin_ui' => 'dnd' ] ); } } /** * Menu creator helper * * @param string $title * @param string $slug * @param string $cap * @param array $callback * * @return array * @since 2.5.0 * */ private function normalize_menu( $title, $slug, $cap = 'edit_docs', $callback = null, $optional = [] ) { return Helper::normalize_menu( $title, $slug, $cap, $callback, $optional ); } /** * BetterDocs Menu List * * @return array * @since 1.0.0 */ private function menu_list() { $parent_slug = []; $betterdocs_admin_pages = [ 'betterdocs' => [ 'menu_slug' => $this->slug, 'page_title' => 'BetterDocs', 'menu_title' => 'BetterDocs', 'capability' => 'edit_docs', 'callback' => [ $this, 'output' ], 'icon_url' => betterdocs()->assets->icon( 'betterdocs-icon-white.svg', true ), 'position' => 5 ], 'dashboard' => $this->normalize_menu( __( 'Dashboard', 'betterdocs' ), 'betterdocs-dashboard', 'edit_docs', [ $this, 'output' ] ), 'all_docs' => $this->normalize_menu( __( 'All Docs', 'betterdocs' ), $this->ui_slug(), 'edit_docs', [ $this, 'output' ], $parent_slug ), 'add_new' => $this->normalize_menu( __( 'Add New', 'betterdocs' ), 'post-new.php?post_type=docs' ), 'categories' => $this->normalize_menu( __( 'Categories', 'betterdocs' ), 'edit-tags.php?taxonomy=doc_category&post_type=docs', 'manage_doc_terms' ), 'tags' => $this->normalize_menu( __( 'Tags', 'betterdocs' ), 'edit-tags.php?taxonomy=doc_tag&post_type=docs', 'manage_doc_terms' ), 'settings' => $this->normalize_menu( __( 'Settings', 'betterdocs' ), 'betterdocs-settings', 'edit_docs_settings', [ $this, 'output' ], $parent_slug ), 'analytics' => $this->normalize_menu( __( 'Analytics', 'betterdocs' ), 'betterdocs-analytics', 'read_docs_analytics', [ $this, 'output' ], $parent_slug ), 'faq' => $this->normalize_menu( __( 'FAQ Builder', 'betterdocs' ), 'betterdocs-faq', 'read_faq_builder', [ $this, 'output' ], $parent_slug ) ]; if ( betterdocs()->is_pro_active() && betterdocs()->settings->get( 'enable_glossaries' ) == true ) { $betterdocs_admin_pages['glossaries'] = $this->normalize_menu( __( 'Glossaries', 'betterdocs' ), 'betterdocs-glossaries', 'read_docs_analytics', [ $this, 'output' ], $parent_slug ); } if (!betterdocs()->is_chatbot_active()) { $betterdocs_admin_pages['ai_chatbot'] = $this->normalize_menu( __('AI Chatbot', 'betterdocs'), 'betterdocs-ai-chatbot', 'edit_docs_settings', [ $this, 'output' ], $parent_slug ); } return apply_filters( 'betterdocs_admin_menu', $betterdocs_admin_pages, [$this, 'output'], $parent_slug); } public function add_custom_classes_to_menu_items() { global $menu, $submenu; $menu_items = [ 'betterdocs' => 'betterdocs', 'betterdocs_page_all_docs' => 'betterdocs-all-docs', 'betterdocs_page_add_new' => 'betterdocs-add-new', 'edit-tags.php?taxonomy=doc_category&post_type=docs' => 'betterdocs-categories', 'edit-tags.php?taxonomy=doc_tag&post_type=docs' => 'betterdocs-tags', 'betterdocs-settings' => 'betterdocs-settings', 'betterdocs-analytics' => 'betterdocs-analytics', 'betterdocs-faq' => 'betterdocs-faq', 'betterdocs-glossaries' => 'betterdocs-glossaries', 'betterdocs-ai-chatbot' => 'betterdocs-ai-chatbot', 'edit-tags.php?taxonomy=knowledge_base&post_type=docs' => 'betterdocs-multiplekb' ]; foreach ( $menu as &$item ) { if ( isset( $menu_items[ $item[2] ] ) ) { if ( ! isset( $item[4] ) ) { $item[4] = ''; } $item[4] .= '' . $menu_items[ $item[2] ]; } } foreach ( $submenu as &$submenu_items ) { foreach ( $submenu_items as &$sub_item ) { if ( isset( $menu_items[ $sub_item[2] ] ) ) { if ( ! isset( $sub_item[4] ) ) { $sub_item[4] = ''; } $sub_item[4] .= '' . $menu_items[ $sub_item[2] ]; } } } } public function quick_setup_menu( $menus ) { $betterdocs_settings = get_option( 'betterdocs_settings' ); if ( $betterdocs_settings ) { return $menus; } else { $menus['quick_setup'] = $this->normalize_menu( __( 'Quick Setup', 'betterdocs' ), 'betterdocs-setup', 'delete_users', [ $this->container->get( SetupWizard::class ), 'views' ] ); } return $menus; } public function insert_plugin_links( $links ) { $links[] = '' . __( 'Settings', 'betterdocs' ) . ''; return $links; } public function toolbar_menu( $admin_bar ) { if ( ! is_admin() || ! is_admin_bar_showing() ) { return; } // Show only when the user is a member of this site, or they're a super admin. if ( ! is_user_member_of_blog() && ! is_super_admin() ) { return; } $docs_url = ''; $encyclopedia_url = ''; if ( $this->settings->get( 'builtin_doc_page' ) ) { $docs_url = get_post_type_archive_link( 'docs' ); } elseif ( intval( $docs_page = $this->settings->get( 'docs_page' ) ) ) { $docs_url = ! empty( $docs_page ) ? get_page_link( $docs_page ) : false; } if ( ! $docs_url ) { return; } $slug = $this->settings->get( 'encyclopedia_root_slug' ); $encyclopedia_url = home_url( $slug ); $admin_bar->add_node( [ 'parent' => 'site-name', 'id' => 'view-docs', 'title' => __( 'Visit Documentation', 'betterdocs' ), 'href' => $docs_url ] ); $is_enable_encyclopedia = betterdocs()->settings->get( 'enable_encyclopedia' ); if ( $is_enable_encyclopedia && betterdocs()->is_pro_active() ) { $admin_bar->add_node( [ 'parent' => 'site-name', 'id' => 'view-encyclopedia', 'title' => __( 'Visit Encyclopedia', 'betterdocs' ), 'href' => $encyclopedia_url ] ); } } /** * Save last visited admin ui * * @since 3.0.1 * */ public function save_admin_page() { if ( isset( $_GET['post_type'] ) && $_GET['post_type'] === 'docs' && isset( $_GET['bdocs_view'] ) && $_GET['bdocs_view'] === 'classic' ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing update_user_meta( get_current_user_id(), 'last_visited_docs_admin_page', 'classic_ui' ); } elseif ( isset( $_GET['page'] ) && $_GET['page'] === 'betterdocs-admin' ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing update_user_meta( get_current_user_id(), 'last_visited_docs_admin_page', 'modern_ui' ); } } /** * Return last visited admin ui slug * * @return string * @since 3.0.1 */ public function ui_slug() { $last_visited = get_user_meta(get_current_user_id(), 'last_visited_docs_admin_page', true); $docs_exist = get_posts([ 'post_type' => 'docs', 'post_status' => 'any', 'numberposts' => 1 ]); return ($last_visited === 'modern_ui' || empty($docs_exist)) ? 'betterdocs-admin' : 'edit.php?post_type=docs&bdocs_view=classic'; } /** * Resets a duplicate submenu in WordPress if the parent main menu and the first submenu permalink are not the same. * * @return string * @since 3.0.1 */ public function reset_submenu() { global $submenu; $docs = get_posts( [ 'post_type' => 'docs' ] ); if ( count( $docs ) == 0 ) { return; } $last_visited = get_user_meta( get_current_user_id(), 'last_visited_docs_admin_page', true ); if ( $last_visited === 'classic_ui' && isset( $submenu['betterdocs-admin'] ) && in_array( 'betterdocs-admin', $submenu['betterdocs-admin'][0] ) ) { unset( $submenu['betterdocs-admin'][0] ); $submenu['betterdocs-admin'] = array_values( $submenu['betterdocs-admin'] ); } } }