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 '' . $total_count . '';
}
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!
';
$_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'] );
}
}
}