Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified	Actions
📁 ..	-	2025-10-27 18:36
📁 assets	-	2025-10-27 18:36
📄 attachment.php <?php /** * Attachment Meta Data * * This file will handle functionality to print meta_data in frontend for different requests. * * @package surerank * @since 0.0.1 / namespace SureRank\Inc\Admin; if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } use SureRank\Inc\Functions\Settings; use SureRank\Inc\Meta_Variables\Post; use SureRank\Inc\Traits\Get_Instance; /* * Attachment Page SEO * This class will handle functionality to print meta_data in frontend for different requests. * * @since 1.0.0 / class Attachment { use Get_Instance; /* * Constructor * * @since 1.0.0 / public function __construct() { add_action( 'wp', [ $this, 'template_redirect' ] ); add_action( 'add_attachment', [ $this, 'generate_attachment_attributes' ] ); } /* * Filter title * * @since 1.0.0 * @return void / public function template_redirect() { if ( ! empty( Settings::get( 'redirect_attachment_pages_to_post_parent' ) ) ) { global $post; if ( is_attachment() && isset( $post->post_parent ) && is_numeric( $post->post_parent ) && ( 0 !== $post->post_parent ) ) { wp_reset_postdata(); $location = get_permalink( intval( $post->post_parent ) ); if ( is_string( $location ) ) { wp_safe_redirect( $location, 301 ); exit; } } elseif ( is_attachment() && isset( $post->post_parent ) && is_numeric( $post->post_parent ) && ( 0 === $post->post_parent ) ) { wp_safe_redirect( get_home_url(), 302 ); exit; } } } /* * Process title * * @param string $title Title. * @return string * @since 1.0.0 / public function process_title( $title ) { // Sanitize the title: remove hyphens, underscores & extra spaces. $title = preg_replace( '%\s[-_\s]+\s%', ' ', $title ); if ( empty( $title ) ) { return ''; } // Lowercase attributes. return strtolower( $title ); } /* * Get attachment title * * @param int $post_id Post ID. * @return string * @since 1.0.0 / public function get_attachment_title( $post_id ) { Post::get_instance()->set_post( intval( $post_id ) ); if ( empty( Post::get_instance()->post ) ) { return ''; } $parent = Post::get_instance()->post->post_parent ? Post::get_instance()->post->post_parent : null; if ( empty( $parent ) ) { $cpt = get_post_type( $post_id ) ? get_post_type( $post_id ) : null; } else { $cpt = get_post_type( $parent ) ? get_post_type( $parent ) : null; } $title = ''; if ( isset( $cpt ) && 'product' === $cpt ) { $parent_post = get_post( $parent ); if ( ! empty( $parent_post ) ) { $title = $parent_post->post_title; // Use the product title for WooCommerce products. } } else { $title = Post::get_instance()->post->post_title; } return $title; } /* * Generate image attributes * * @param int $post_id Post ID. * @param bool $bulk Bulk. * @return void * @since 1.0.0 */ public function generate_attachment_attributes( $post_id, $bulk = false ) { if ( ! wp_attachment_is_image( $post_id ) ) { return; } if ( ! apply_filters( 'surerank_auto_set_image_title_and_alt', true ) ) { return; } $title = $this->process_title( $this->get_attachment_title( $post_id ) ); if ( ! empty( Settings::get( 'auto_set_image_title' ) ) ) { wp_update_post( [ 'ID' => $post_id, 'post_title' => $title, ] ); } if ( ! empty( Settings::get( 'auto_set_image_alt' ) ) ) { update_post_meta( $post_id, '_wp_attachment_image_alt', $title ); } } }	3.45 KB	2025-10-27 18:36
📄 bulk-actions.php <?php /** * Bulk Edit class. * * Handles bulk editing of SureRank robot settings for posts, pages, and taxonomies. * * @package SureRank\Inc\Admin / namespace SureRank\Inc\Admin; use SureRank\Inc\Functions\Helper as FunctionsHelper; use SureRank\Inc\Schema\Helper as SchemaHelper; use SureRank\Inc\Traits\Get_Instance; /* * SureRank Bulk Edit * * Handles bulk editing of robot settings (Index/NoIndex, Follow/NoFollow) for posts and taxonomies. / class BulkActions { use Get_Instance; /* * Constructor. / public function __construct() { add_action( 'admin_init', [ $this, 'setup_bulk_actions' ] ); add_action( 'admin_notices', [ $this, 'admin_notices' ] ); add_action( 'admin_footer', [ $this, 'disable_surerank_options' ] ); } /* * Setup bulk actions for posts and taxonomies. * * @return void / public function setup_bulk_actions(): void { if ( ! current_user_can( 'manage_options' ) ) { return; } $post_types = array_keys( FunctionsHelper::get_public_cpts() ); $taxonomies_data = SchemaHelper::get_instance()->get_taxonomies( [ 'public' => true ] ); $taxonomies = []; foreach ( $taxonomies_data as $taxonomy ) { if ( isset( $taxonomy['slug'] ) && is_string( $taxonomy['slug'] ) ) { $taxonomies[] = $taxonomy['slug']; } } $screens = array_merge( $post_types, $taxonomies ); foreach ( $screens as $screen ) { add_filter( "bulk_actions-edit-{$screen}", [ $this, 'add_bulk_actions' ] ); add_filter( "handle_bulk_actions-edit-{$screen}", [ $this, 'handle_bulk_actions' ], 10, 3 ); } } /* * Add SureRank bulk actions to the dropdown. * * @param array<string, string> $actions Existing bulk actions. * @return array<string, string> Modified bulk actions. / public function add_bulk_actions( array $actions ): array { return array_merge( $actions, $this->get_bulk_action_labels() ); } /* * Disable the 'surerank-settings' bulk action in the dropdown. * * @return void / public function disable_surerank_options(): void { $screen = get_current_screen(); if ( ! $screen \|\| ! in_array( $screen->base, [ 'edit', 'edit-tags' ], true ) ) { return; } ?> <script> jQuery(document).ready(function($) { $('select[name^="action"] option[value="surerank-settings"]').prop('disabled', true); }); </script> <?php } /* * Handle bulk actions. * * @param string $redirect_to Redirect URL. * @param string $action Action being performed. * @param array<int\|string> $ids Array of post/term IDs. * @return string Modified redirect URL. / public function handle_bulk_actions( string $redirect_to, string $action, array $ids ): string { if ( ! current_user_can( 'manage_options' ) ) { return $redirect_to; } $is_taxonomy = Helper::is_taxonomy_screen(); if ( ! isset( $_REQUEST['_wpnonce'] ) ) { return $redirect_to; } $nonce = sanitize_text_field( wp_unslash( $_REQUEST['_wpnonce'] ) ); $nonce_action = $is_taxonomy ? 'bulk-tags' : 'bulk-posts'; if ( ! wp_verify_nonce( $nonce, $nonce_action ) ) { return $redirect_to; } $surerank_actions = apply_filters( 'surerank_allowed_bulk_actions', [ 'surerank_index', 'surerank_noindex', 'surerank_follow', 'surerank_nofollow', 'surerank_archive', 'surerank_noarchive' ] ); if ( ! in_array( $action, $surerank_actions, true ) \|\| empty( $ids ) ) { return $redirect_to; } do_action( 'surerank_bulk_action_performed', $action, $ids ); $is_taxonomy = Helper::is_taxonomy_screen(); foreach ( $ids as $id ) { $id = (int) $id; if ( $id > 0 ) { $this->update_robot_settings( $id, $action, $is_taxonomy ); } } $query_args = [ 'surerank_bulk_action' => $action, 'surerank_updated' => count( $ids ), 'surerank_nonce' => wp_create_nonce( 'surerank_bulk_action_nonce' ), ]; // If we're on a taxonomy screen, ensure the taxonomy parameter is preserved. if ( $is_taxonomy && isset( $_REQUEST['taxonomy'] ) ) { $query_args['taxonomy'] = sanitize_text_field( wp_unslash( $_REQUEST['taxonomy'] ) ); } $redirect_url = add_query_arg( $query_args, $redirect_to ); return apply_filters( 'surerank_bulk_action_redirect_url', $redirect_url, $action, count( $ids ) ); } /* * Display admin notices for bulk actions. * * @return void / public function admin_notices(): void { if ( ! isset( $_GET['surerank_bulk_action'], $_GET['surerank_updated'], $_GET['surerank_nonce'] ) \|\| ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_GET['surerank_nonce'] ) ), 'surerank_bulk_action_nonce' ) ) { return; } $updated_count = isset( $_GET['surerank_updated'] ) ? absint( $_GET['surerank_updated'] ) : 0; if ( ! $updated_count ) { return; } $action = sanitize_text_field( wp_unslash( $_GET['surerank_bulk_action'] ) ); $action_labels = $this->get_bulk_action_labels(); if ( ! isset( $action_labels[ $action ] ) ) { return; } printf( '<div class="notice notice-success"><p>%s</p></div>', sprintf( / translators: %1$d: number of items updated, %2$s: action performed / esc_html( _n( '%1$d item %2$s.', '%1$d items %2$s.', $updated_count, 'surerank' ) ), esc_html( (string) $updated_count ), esc_html( $action_labels[ $action ] ) ) ); // Clear the URL parameters after displaying the notice. $this->clear_bulk_action_url_parameters(); } /* * Clear SureRank bulk action URL parameters * * @return void / public function clear_bulk_action_url_parameters() { ?> <script> jQuery(document).ready(function() { if ( window.history.replaceState ) { var url = new URL(window.location.href); url.searchParams.delete('surerank_bulk_action'); url.searchParams.delete('surerank_updated'); url.searchParams.delete('surerank_error'); url.searchParams.delete('surerank_nonce'); window.history.replaceState({}, document.title, url.toString()); } }); </script> <?php } /* * Get SureRank bulk action labels. * * @return array<string, string> Bulk action labels. / private function get_bulk_action_labels(): array { return apply_filters( 'surerank_bulk_actions', [ 'surerank-settings' => __( 'SureRank Settings', 'surerank' ), 'surerank_index' => __( 'Set to index', 'surerank' ), 'surerank_noindex' => __( 'Set to noindex', 'surerank' ), 'surerank_follow' => __( 'Set to follow', 'surerank' ), 'surerank_nofollow' => __( 'Set to nofollow', 'surerank' ), 'surerank_archive' => __( 'Set to archive', 'surerank' ), 'surerank_noarchive' => __( 'Set to noarchive', 'surerank' ), ] ); } /* * Update robot settings for a post or term. * * @param int $id Post or term ID. * @param string $action Action being performed. * @param bool $is_taxonomy Whether this is a taxonomy. * @return bool Success status. */ private function update_robot_settings( int $id, string $action, bool $is_taxonomy ): bool { $actions = [ 'surerank_index' => [ 'key' => 'post_no_index', 'value' => 'no', ], 'surerank_noindex' => [ 'key' => 'post_no_index', 'value' => 'yes', ], 'surerank_follow' => [ 'key' => 'post_no_follow', 'value' => 'no', ], 'surerank_nofollow' => [ 'key' => 'post_no_follow', 'value' => 'yes', ], 'surerank_archive' => [ 'key' => 'post_no_archive', 'value' => 'no', ], 'surerank_noarchive' => [ 'key' => 'post_no_archive', 'value' => 'yes', ], ]; if ( ! isset( $actions[ $action ] ) ) { return false; } $meta = $actions[ $action ]; return Helper::update_robot_meta( $id, $meta['key'], $meta['value'], $is_taxonomy ); } }	7.58 KB	2025-10-27 18:36
📄 bulk-edit.php <?php /** * Bulk Edit class. * * Handles bulk editing of SureRank robot settings for posts and pages. * * @package SureRank\Inc\Admin / namespace SureRank\Inc\Admin; use SureRank\Inc\Functions\Helper as FunctionsHelper; use SureRank\Inc\Traits\Get_Instance; defined( 'ABSPATH' ) \|\| exit; /* * SureRank Bulk Edit * * Handles bulk editing of robot settings (Index/NoIndex, Follow/NoFollow) for posts. / class BulkEdit { use Get_Instance; /* * Flag to check if fields have been added. * * @var bool / private static $fields_added = false; /* * Constructor. / public function __construct() { $post_types = array_keys( FunctionsHelper::get_public_cpts() ); add_action( 'bulk_edit_custom_box', [ $this, 'add_bulk_edit_fields' ], 10, 2 ); foreach ( $post_types as $post_type ) { add_action( "save_post_{$post_type}", [ $this, 'save_bulk_edit' ], 10, 2 ); } } /* * Add SureRank bulk edit fields to the post bulk edit form. * * @param string $column_name The name of the column. * @param string $post_type The post type. * @return void / public function add_bulk_edit_fields( string $column_name, string $post_type ): void { if ( ! current_user_can( 'manage_options' ) ) { return; } if ( self::$fields_added ) { return; } ?> <fieldset class="inline-edit-col-right"> <div class="inline-edit-col"> <div class="inline-edit-group wp-clearfix"> <span class="title inline-edit-surerank-settings" style="font-weight: bold; margin-bottom: 5px; display: block;"><?php esc_html_e( 'SURERANK SETTINGS', 'surerank' ); ?></span> <div style="display: flex; flex-direction: column; gap: 10px;"> <label> <span class="title"><?php esc_html_e( 'No Index -', 'surerank' ); ?></span> <select name="surerank_no_index"> <option value="-1"><?php esc_html_e( '— No Change —', 'surerank' ); ?></option> <option value="yes"><?php esc_html_e( 'Yes', 'surerank' ); ?></option> <option value="no"><?php esc_html_e( 'No', 'surerank' ); ?></option> </select> </label> <label> <span class="title"><?php esc_html_e( 'No Follow -', 'surerank' ); ?></span> <select name="surerank_no_follow"> <option value="-1"><?php esc_html_e( '— No Change —', 'surerank' ); ?></option> <option value="yes"><?php esc_html_e( 'Yes', 'surerank' ); ?></option> <option value="no"><?php esc_html_e( 'No', 'surerank' ); ?></option> </select> </label> <label> <span class="title"><?php esc_html_e( 'No Archive -', 'surerank' ); ?></span> <select name="surerank_no_archive"> <option value="-1"><?php esc_html_e( '— No Change —', 'surerank' ); ?></option> <option value="yes"><?php esc_html_e( 'Yes', 'surerank' ); ?></option> <option value="no"><?php esc_html_e( 'No', 'surerank' ); ?></option> </select> </label> </div> </div> </div> </fieldset> <?php self::$fields_added = true; } /* * Save bulk edit settings for posts. * * @param int $post_id Post ID. * @param \WP_Post $post Post object. * @return void */ public function save_bulk_edit( int $post_id, \WP_Post $post ): void { if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) { return; } if ( ! current_user_can( 'edit_post', $post_id ) ) { return; } // Check if this is a bulk edit request. if ( ! isset( $_REQUEST['bulk_edit'], $_REQUEST['post'], $_REQUEST['_wpnonce'] ) ) { return; } if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_REQUEST['_wpnonce'] ) ), 'bulk-posts' ) ) { return; } // Ensure this post is part of the bulk edit. $post_ids = array_map( 'intval', (array) wp_unslash( $_REQUEST['post'] ) ); if ( ! in_array( $post_id, $post_ids, true ) ) { return; } $no_index = isset( $_REQUEST['surerank_no_index'] ) ? sanitize_text_field( wp_unslash( $_REQUEST['surerank_no_index'] ) ) : '-1'; $no_follow = isset( $_REQUEST['surerank_no_follow'] ) ? sanitize_text_field( wp_unslash( $_REQUEST['surerank_no_follow'] ) ) : '-1'; $no_archive = isset( $_REQUEST['surerank_no_archive'] ) ? sanitize_text_field( wp_unslash( $_REQUEST['surerank_no_archive'] ) ) : '-1'; if ( '-1' !== $no_index ) { Helper::update_robot_meta( $post_id, 'post_no_index', $no_index, false ); } if ( '-1' !== $no_follow ) { Helper::update_robot_meta( $post_id, 'post_no_follow', $no_follow, false ); } if ( '-1' !== $no_archive ) { Helper::update_robot_meta( $post_id, 'post_no_archive', $no_archive, false ); } } }	4.5 KB	2025-10-27 18:36
📄 dashboard.php <?php /** * Admin Dashboard * * @since 1.0.0 * @package surerank / namespace SureRank\Inc\Admin; if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } use SureRank\Inc\API\Migrations; use SureRank\Inc\API\Onboarding; use SureRank\Inc\Functions\Get; use SureRank\Inc\Functions\Helper; use SureRank\Inc\Functions\Settings; use SureRank\Inc\Functions\Update; use SureRank\Inc\Import_Export\Settings_Exporter; use SureRank\Inc\Sitemap\Xml_Sitemap; use SureRank\Inc\Traits\Enqueue; use SureRank\Inc\Traits\Get_Instance; /* * Admin Dashboard * * @method void wp_enqueue_scripts() * @since 1.0.0 / class Dashboard { use Enqueue; use Get_Instance; /* * Constructor * * @since 0.0.1 * @return void / public function __construct() { $this->enqueue_scripts_admin(); add_action( 'admin_menu', [ $this, 'add_menu_page' ], 9 ); add_action( 'admin_init', [ $this, 'redirect_to_dashboard' ] ); add_action( 'admin_head', [ $this, 'common_css' ] ); add_action( 'admin_head', [ $this, 'common_js' ] ); add_action( 'admin_enqueue_scripts', [ $this, 'site_seo_check_enqueue_scripts' ] ); } /* * Common JS for admin pages. * * @return void / public function common_js() { ?> <script type="text/javascript"> // This is a common JS file for admin pages. // You can add your custom JS code here. jQuery(document).ready(function ($) { const checkScore = parseInt(window?.surerank_globals?.check_score) \|\| 0; if (checkScore <= 0) { return; } const sidebarMenu = $('#toplevel_page_surerank > a > div.wp-menu-name'); if (!sidebarMenu.length) { return; } // Check if the badge is already added. const notificationBadge = sidebarMenu.find('.awaiting-mod'); if (notificationBadge.length) { notificationBadge.text(checkScore); return; } // Add space after the menu name if not already present. if (!sidebarMenu.text().endsWith(' ')) { sidebarMenu.text(sidebarMenu.text() + ' '); } // Create and add the badge. const badge = $('<span>', { class: 'awaiting-mod', text: checkScore }); sidebarMenu.append(badge); }); </script> <?php } /* * Enqueue admin scripts. * * @since 1.0.0 * @return void / public function site_seo_check_enqueue_scripts() { // Add localize JS. wp_localize_script( 'jquery', 'surerank_globals', apply_filters( 'surerank_globals_localization_vars', array_merge( [ 'check_score' => $this->get_seo_score(), 'exporter_options' => Settings_Exporter::get_instance()->get_categories(), 'dashboard_plugins_sequence' => $this->get_plugin_sequence(), ], $this->get_common_variables(), $this->get_disabled_settings(), ) ) ); } /* * Get plugin sequence for dashboard. * * @return array<int,string> $sequence Plugin sequence. * @since 1.4.2 / public function get_plugin_sequence() { $sequence = [ 'ultimate-addons-for-gutenberg', 'sureforms', 'suremails', 'suretriggers', ]; if ( defined( 'ELEMENTOR_VERSION' ) ) { $sequence = [ 'ultimate-addons-for-gutenberg', 'sureforms', 'suremails', 'header-footer-elementor', ]; } return apply_filters( 'surerank_dashboard_plugins_sequence', $sequence ); } /* * Get SEO score. * * @since 1.0.0 * @return int / public function get_seo_score() { $seo_checks = Get::option( 'surerank_site_seo_checks', [] ); if ( ! is_array( $seo_checks ) \|\| empty( $seo_checks ) ) { return 0; } $seo_score = 0; foreach ( $seo_checks as $category ) { foreach ( $category as $check ) { if ( isset( $check['status'] ) && $check['status'] === 'error' && ! ( isset( $check['ignore'] ) && $check['ignore'] ) ) { $seo_score++; } } } return $seo_score; } /* * Redirect to dashboard after plugin activation. * * @since 1.0.0 * @return void / public function redirect_to_dashboard() { // Avoid redirection in case of WP_CLI calls. if ( defined( 'WP_CLI' ) && \WP_CLI ) { return; } // Avoid redirection in case of ajax calls. if ( wp_doing_ajax() ) { return; } if ( isset( $_GET['skip_onboarding'] ) && 'true' === $_GET['skip_onboarding'] ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended $this->redirect_to_page( 'surerank', '#/dashboard' ); } $do_redirect = apply_filters( 'surerank_enable_redirect_on_activation', get_option( 'surerank_redirect_on_activation' ) ); if ( 'yes' === $do_redirect ) { update_option( 'surerank_redirect_on_activation', 'no' ); if ( ! is_multisite() ) { $onboarding_completed = get_option( 'surerank_onboarding_completed' ); if ( $onboarding_completed ) { $this->redirect_to_page( 'surerank', '#/dashboard' ); } else { $this->redirect_to_page( 'surerank_onboarding' ); } } } } /* * Add menu page. * * @since 1.0.0 * @return void / public function add_menu_page() { if ( ! current_user_can( 'manage_options' ) ) { return; } $menu_slug = 'surerank'; // Add the main Dashboard Menu. add_menu_page( __( 'SureRank', 'surerank' ), __( 'SureRank', 'surerank' ), 'manage_options', $menu_slug, static function () { }, 'none', 30 ); // Register sub menus. $this->register_sub_menus( $menu_slug ); } /* * Register sub menus. * * @param string $menu_slug Menu slug. * @since 1.0.0 * @return void / public function register_sub_menus( $menu_slug ) { $capability = 'manage_options'; $submenus = [ [ 'id' => $menu_slug, 'page_title' => __( 'Dashboard', 'surerank' ), ], [ 'id' => apply_filters( 'surerank_general_menu_url', 'surerank#/general' ), 'page_title' => __( 'General', 'surerank' ), ], [ 'id' => 'surerank#/advanced', 'page_title' => __( 'Advanced', 'surerank' ), ], ]; if ( Settings::get( 'enable_google_console' ) ) { $submenus[] = [ 'id' => 'surerank#/search-console', 'page_title' => __( 'Search Console', 'surerank' ), ]; } $submenus[] = [ 'id' => 'surerank#/tools', 'page_title' => __( 'Tools', 'surerank' ), ]; $submenus = apply_filters( 'surerank_wp_admin_submenus', $submenus ); // Register the submenus. foreach ( $submenus as $submenu ) { add_submenu_page( $menu_slug, $submenu['page_title'], $submenu['page_title'], $capability, $submenu['id'], [ $this, 'render_dashboard' ] ); } } /* * Enqueue admin scripts * * @since 0.0.1 * @return void / public function admin_enqueue_scripts() { $screen = get_current_screen(); if ( empty( $screen->base ) ) { return; } // Is page is top level page. $is_top_level_page = 'toplevel_page_surerank' === $screen->base; // surerank_page string should be in the start of the $screen->base. if ( ! ( 0 === strpos( $screen->base, 'surerank_page' ) \|\| $is_top_level_page ) ) { return; } $page_id = ''; if ( $is_top_level_page ) { $page_id = 'admin-dashboard'; } else { $page_id = str_replace( 'surerank_page_surerank_', 'admin-', $screen->base ); // If page id has _ then replace it with -. if ( strpos( $page_id, '_' ) ) { $page_id = str_replace( '_', '-', $page_id ); } // Use admin-dashboard for all main admin pages since they're now combined. if ( 'admin-settings' === $page_id ) { $page_id = 'admin-dashboard'; } } // Load page specific assets. $this->build_assets_operations( $page_id, [], [ 'updates' ] ); // Enqueue vendor and common assets. $this->enqueue_vendor_and_common_assets(); // Load common assets. $this->load_common_assets( $page_id ); } /* * Load common assets. which are required on all admin pages. * * @since 1.0.0 * * @param string $page_id Page id. * @return void / public function load_common_assets( $page_id ) { $this->style_operations( 'inter-google-font', 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap', [], '' ); wp_enqueue_media(); $this->build_assets_operations( $page_id, [ 'hook' => $page_id, 'object_name' => 'admin_common', 'data' => apply_filters( 'surerank_dashboard_localization_vars', [ 'social_profiles' => Onboarding::social_profiles(), 'website_details' => Helper::website_details(), 'sitemap_url' => Xml_Sitemap::get_instance()->get_sitemap_url(), 'onboarding_complete_status' => get_option( 'surerank_onboarding_completed', false ) ? 'yes' : 'no', 'plugins_for_migration' => Migrations::get_instance()->get_available_plugins(), 'migration_ever_completed' => Migrations::has_migration_ever_completed(), 'migration_completed_plugins' => Migrations::get_completed_migrations(), 'active_cache_plugins' => Migrations::is_cache_plugin_active(), 'robots_data' => Helper::get_robots_data(), 'wp_reading_settings_url' => admin_url( 'options-reading.php' ), ] ), ] ); } /* * Get common admin assets variables. * * @since 1.0.0 * @return array<string, mixed> / public function get_common_variables() { return apply_filters( 'surerank_common_localization_vars', [ '_ajax_nonce' => current_user_can( 'manage_options' ) ? wp_create_nonce( 'surerank_plugin' ) : '', 'admin_assets_url' => SURERANK_URL . 'inc/admin/assets', 'version' => SURERANK_VERSION, 'help_link' => esc_url( 'https://surerank.com/docs/' ), 'support_link' => esc_url( 'https://surerank.com/support/' ), 'rating_link' => esc_url( 'https://wordpress.org/support/plugin/surerank/reviews/#new-post' ), 'community_link' => esc_url( 'https://www.facebook.com/groups/surecrafted' ), 'pricing_link' => esc_url( 'https://surerank.com/pricing/' ), 'pro_link' => esc_url( 'https://surerank.com/pro/' ), 'privacy_policy_url' => esc_url( 'https://surerank.com/privacy-policy/' ), 'surerank_url' => esc_url( 'https://surerank.com' ), 'wp_dashboard_url' => admin_url( 'admin.php' ), 'site_url' => site_url(), 'wp_general_settings_url' => admin_url( 'options-general.php' ), 'url_length' => Get::url_length(), 'description_length' => Get::description_length(), 'title_length' => Get::title_length(), 'open_graph_tags' => apply_filters( 'surerank_disable_open_graph_tags', false ), 'input_variable_suggestions' => $this->get_input_variable_suggestions(), ] ); } /* * Get disabled settings. * * @since 1.0.0 * @return array<string, mixed> / public function get_disabled_settings() { return [ 'enable_page_level_seo' => Settings::get( 'enable_page_level_seo' ), 'enable_google_console' => Settings::get( 'enable_google_console' ), 'enable_schemas' => Settings::get( 'enable_schemas' ), 'enable_migration' => Settings::get( 'enable_migration' ), ]; } /* * Render Html template. * * @since 0.0.1 * @return void / public function render_dashboard() { Update::option( 'surerank_site_seo_checks_score', 0 ); echo "<div class='surerank-root surerank-setting-page surerank-styles'><div id='surerank-root'></div></div>"; } /* * Common CSS for admin pages. * * @since 1.0.0 * @return void / public function common_css() { // Early return if it's not admin page. if ( ! is_admin() ) { return; } $logo_uri = 'data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEzLjU1MzcgMS41QzE3Ljg0NTMgMS41IDIxLjMyNTEgNC45Nzg5NSAyMS4zMjUyIDkuMjcwNTFDMjEuMzI1MiAxMi4zNDcgMTkuNTM2OCAxNS4wMDU2IDE2Ljk0MzQgMTYuMjY0NkgyMS4zMjUyVjIyLjVIMTguMDg4OUMxNC45MDg2IDIyLjUgMTIuMjg2MSAyMC4xMTg2IDExLjkwMzMgMTcuMDQySDExLjkwMTRMMTEuOTAzMyAxMy43ODUyQzE0LjgyODMgMTMuNzY2MSAxNy4wMzQyIDExLjM4OTQgMTcuMDM0MiA4LjQ1OTk2VjYuMDI5M0MxNC4xMzcgNi4wMjk0NyAxMS42OTQ4IDcuOTc2ODIgMTAuOTQ0MyAxMC42MzM4QzEwLjE2MDUgOS41MzM0NSA4Ljg3MzgzIDguODE2NSA3LjQxOTkyIDguODE2NDFINi4zODA4NlY5Ljg1MzUySDYuMzgzNzlDNi40NDUxNSAxMi4wMzU2IDguMjMzNzUgMTMuNzg2IDEwLjQzMDcgMTMuNzg2MUgxMC43MDYxTDEwLjY5MzQgMTcuMDQySDEwLjY4NjVDMTAuMjk0MyAyMC4xMDgyIDcuNjc2NzggMjIuNDc4NSA0LjUwMzkxIDIyLjQ3ODVIMi42NzQ4VjEuNUgxMy41NTM3WiIgZmlsbD0iI0EwQTVBQSIvPgo8L3N2Zz4K'; // 24px x 24px in #A0A5AA $logo_uri_active = 'data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEzLjU1MzcgMS41QzE3Ljg0NTMgMS41IDIxLjMyNTEgNC45Nzg5NSAyMS4zMjUyIDkuMjcwNTFDMjEuMzI1MiAxMi4zNDcgMTkuNTM2OCAxNS4wMDU2IDE2Ljk0MzQgMTYuMjY0NkgyMS4zMjUyVjIyLjVIMTguMDg4OUMxNC45MDg2IDIyLjUgMTIuMjg2MSAyMC4xMTg2IDExLjkwMzMgMTcuMDQySDExLjkwMTRMMTEuOTAzMyAxMy43ODUyQzE0LjgyODMgMTMuNzY2MSAxNy4wMzQyIDExLjM4OTQgMTcuMDM0MiA4LjQ1OTk2VjYuMDI5M0MxNC4xMzcgNi4wMjk0NyAxMS42OTQ4IDcuOTc2ODIgMTAuOTQ0MyAxMC42MzM4QzEwLjE2MDUgOS41MzM0NSA4Ljg3MzgzIDguODE2NSA3LjQxOTkyIDguODE2NDFINi4zODA4NlY5Ljg1MzUySDYuMzgzNzlDNi40NDUxNSAxMi4wMzU2IDguMjMzNzUgMTMuNzg2IDEwLjQzMDcgMTMuNzg2MUgxMC43MDYxTDEwLjY5MzQgMTcuMDQySDEwLjY4NjVDMTAuMjk0MyAyMC4xMDgyIDcuNjc2NzggMjIuNDc4NSA0LjUwMzkxIDIyLjQ3ODVIMi42NzQ4VjEuNUgxMy41NTM3WiIgZmlsbD0iI0ZGRkZGRiIvPgo8L3N2Zz4K'; // 24px x 24px in #FFFFFF ?> <style> #toplevel_page_surerank .wp-submenu li:has(a[href="admin.php?page=surerank_onboarding"]) { display: none !important; } #toplevel_page_surerank .wp-menu-image:before { content: ""; background-image: url('<?php echo $logo_uri; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>'); background-position: center center; background-repeat: no-repeat; background-size: contain; } #toplevel_page_surerank .wp-menu-image { align-content: center; } #toplevel_page_surerank.wp-menu-open .wp-menu-image:before { background-image: url('<?php echo $logo_uri_active; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>'); } </style> <?php } /* * Redirect to a specific admin page. * * @since 1.0.0 * * @param string $page Page slug to redirect. * @param string $hash Optional hash fragment to append. * @return void / private function redirect_to_page( $page, $hash = '' ) { $url = add_query_arg( [ 'page' => $page ], admin_url( 'admin.php' ) ); if ( ! empty( $hash ) ) { $url .= $hash; } wp_safe_redirect( $url ); exit; } /* * Get input variable suggestions. * * @since 1.0.0 * * @return array<int, array<string,string>> */ private function get_input_variable_suggestions() { return apply_filters( 'surerank_input_variable_suggestions', [ [ 'label' => __( 'Site Name', 'surerank' ), 'value' => '%site_name%', 'description' => __( 'The name of the site.', 'surerank' ), ], [ 'label' => __( 'Tagline', 'surerank' ), 'value' => '%tagline%', 'description' => __( 'The tagline of the site.', 'surerank' ), ], [ 'label' => __( 'Term Title', 'surerank' ), 'value' => '%term_title%', 'description' => __( 'The name of the term.', 'surerank' ), ], [ 'label' => __( 'Post Title', 'surerank' ), 'value' => '%title%', 'description' => __( 'The title of the post.', 'surerank' ), ], [ 'label' => __( 'Post Excerpt', 'surerank' ), 'value' => '%excerpt%', 'description' => __( 'The excerpt of the post.', 'surerank' ), ], [ 'label' => __( 'Post Content', 'surerank' ), 'value' => '%content%', 'description' => __( 'The content of the post.', 'surerank' ), ], [ 'label' => __( 'Term Description', 'surerank' ), 'value' => '%term_description%', 'description' => __( 'The description of the term.', 'surerank' ), ], [ 'label' => __( 'Date Published', 'surerank' ), 'value' => '%published%', 'description' => __( 'Publication date of the current post/page OR specified date on date archives', 'surerank' ), ], [ 'label' => __( 'Date Modified', 'surerank' ), 'value' => '%modified%', 'description' => __( 'Last modification date of the current post/page', 'surerank' ), ], [ 'label' => __( 'Post URL', 'surerank' ), 'value' => '%permalink%', 'description' => __( 'URL of the current post/page', 'surerank' ), ], [ 'label' => __( 'Current Date', 'surerank' ), 'value' => '%currentdate%', 'description' => __( 'Current server date', 'surerank' ), ], [ 'label' => __( 'Current Day', 'surerank' ), 'value' => '%currentday%', 'description' => __( 'Current server day', 'surerank' ), ], [ 'label' => __( 'Current Month', 'surerank' ), 'value' => '%currentmonth%', 'description' => __( 'Current server month', 'surerank' ), ], [ 'label' => __( 'Current Year', 'surerank' ), 'value' => '%currentyear%', 'description' => __( 'Current server year', 'surerank' ), ], [ 'label' => __( 'Current Time', 'surerank' ), 'value' => '%currenttime%', 'description' => __( 'Current server time', 'surerank' ), ], [ 'label' => __( 'Organization Name', 'surerank' ), 'value' => '%org_name%', 'description' => __( 'The Organization Name added in Local SEO Settings.', 'surerank' ), ], [ 'label' => __( 'Organization Logo', 'surerank' ), 'value' => '%org_logo%', 'description' => __( 'Organization Logo added in Local SEO Settings.', 'surerank' ), ], [ 'label' => __( 'Organization URL', 'surerank' ), 'value' => '%org_url%', 'description' => __( 'Organization URL added in Local SEO Settings.', 'surerank' ), ], [ 'label' => __( 'Post Author Name', 'surerank' ), 'value' => '%author_name%', 'description' => __( "Display author's nicename of the current post, page or author archive.", 'surerank' ), ], ] ); } }	18.15 KB	2025-10-27 18:36
📄 helper.php <?php /** * Helper class for bulk operations. * * Contains common functionality shared between bulk edit and bulk actions. * * @package SureRank\Inc\Admin / namespace SureRank\Inc\Admin; use SureRank\Inc\Functions\Update; defined( 'ABSPATH' ) \|\| exit; /* * Helper class for bulk operations. / class Helper { /* * Update robot settings for a post or term. * * @param int $id Post or term ID. * @param string $meta_key Meta key (post_no_index or post_no_follow). * @param string $meta_value Meta value (yes or no). * @param bool $is_taxonomy Whether this is a taxonomy. * @return bool Success status. / public static function update_robot_meta( int $id, string $meta_key, string $meta_value, bool $is_taxonomy = false ): bool { $full_meta_key = 'surerank_settings_' . $meta_key; if ( $is_taxonomy ) { Update::term_meta( $id, $full_meta_key, $meta_value ); } else { Update::post_meta( $id, $full_meta_key, $meta_value ); } return true; } /* * Check if current screen is a taxonomy screen. * * @return bool Whether current screen is taxonomy. / public static function is_taxonomy_screen(): bool { if ( ! function_exists( 'get_current_screen' ) ) { return false; } $screen = get_current_screen(); return $screen && 'edit-tags' === $screen->base; } /* * Display success notice. * * @param string $message Notice message. * @return void */ public static function display_notice( string $message ): void { printf( '<div class="notice notice-success is-dismissible"><p>%s</p></div>', esc_html( $message ) ); } }	1.58 KB	2025-10-27 18:36
📄 onboarding.php <?php /** * Onboarding * * @package SureRank\Inc\Admin / namespace SureRank\Inc\Admin; use SureRank\Inc\Traits\Get_Instance; if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } /* * Onboarding class / class Onboarding { use Get_Instance; /* * Constructor / public function __construct() { add_action( 'admin_menu', [ $this, 'register_menu' ] ); } /* * Register menu * * @return void / public function register_menu() { add_submenu_page( 'surerank', __( 'Onboarding', 'surerank' ), __( 'Onboarding', 'surerank' ), 'manage_options', 'surerank_onboarding', [ $this, 'render_onboarding' ], 99 ); } /* * Render onboarding * * @return void */ public function render_onboarding() { echo '<div class="surerank-root surerank-setting-page surerank-styles"><div id="surerank-root"></div></div>'; } }	889 B	2025-10-27 18:36
📄 seo-bar.php <?php /** * SEO Bar class. * * Handles the addition of a custom column and enqueuing of assets for the SureRank plugin in WordPress post/page and taxonomy admin views. * * @package SureRank\Inc\Admin / namespace SureRank\Inc\Admin; use SureRank\Inc\Functions\Settings; use SureRank\Inc\Traits\Enqueue; use SureRank\Inc\Traits\Get_Instance; /* * SureRank Seo Bar * * Handles the addition of a custom column and enqueuing of assets for the SureRank plugin in WordPress post/page and taxonomy admin views. / class Seo_Bar { use Get_Instance; use Enqueue; /* * Constructor. / public function __construct() { if ( ! Settings::get( 'enable_page_level_seo' ) ) { return; } if ( ! current_user_can( 'manage_options' ) ) { return; } $this->enqueue_scripts_admin(); add_action( 'admin_init', [ $this, 'setup_columns' ] ); add_action( 'admin_init', [ $this, 'setup_taxonomy_columns' ] ); } /* * Override enqueue_scripts to prevent wp_enqueue_scripts action. * * @since 1.0.0 * @return void / public function enqueue_scripts() { } /* * Enqueue admin scripts and styles for admin-seo-bar. * * @param string $hook The current admin page hook. * @return void / public function admin_enqueue_scripts( $hook ) { if ( ! function_exists( 'get_current_screen' ) ) { return; } $screen = get_current_screen(); if ( ! $screen ) { return; } if ( 'edit.php' === $hook && 'edit' === $screen->base && $this->display_metabox( $screen->post_type, 'wp_posts' ) ) { // Enqueue vendor and common assets. $this->enqueue_vendor_and_common_assets(); $this->build_assets_operations( 'admin-seo-bar', [ 'hook' => 'admin-seo-bar', 'object_name' => 'seo_bar', 'data' => [ 'post_type' => $screen->post_type, 'type' => 'post', ], ] ); do_action( 'surerank_seo_bar_enqueue_post_type_scripts', $hook, $screen ); } if ( 'edit-tags.php' === $hook && 'edit-tags' === $screen->base && $this->display_metabox( $screen->taxonomy, 'wp_terms' ) ) { // Enqueue vendor and common assets. $this->enqueue_vendor_and_common_assets(); $this->build_assets_operations( 'admin-seo-bar', [ 'hook' => 'admin-seo-bar', 'object_name' => 'seo_bar', 'data' => [ 'taxonomy' => $screen->taxonomy, 'type' => 'taxonomy', ], ] ); do_action( 'surerank_seo_bar_enqueue_taxonomy_scripts', $hook, $screen ); } } /* * Adds the custom column to the post admin table. * * @param array<string, string> $columns The existing columns. * @return array<string, string> The modified columns. / public function column_heading( $columns ) { if ( $this->display_metabox() === false ) { return $columns; } $new_columns = []; $target_column = apply_filters( 'surerank_seo_bar_column_position_post', 5 ); $custom_column = [ 'surerank-data' => __( 'SEO Checks', 'surerank' ), ]; return array_slice( $columns, 0, $target_column, true ) + $custom_column + array_slice( $columns, $target_column, null, true ); } /* * Adds the custom column to the taxonomy admin table. * * @param array<string, string> $columns The existing columns. * @return array<string, string> The modified columns. / public function column_heading_taxonomy( $columns ) { if ( $this->display_metabox() === false ) { return $columns; } $new_columns = []; $target_column = apply_filters( 'surerank_seo_bar_column_position_taxonomy', 4 ); $custom_column = [ 'surerank-data' => __( 'SEO Checks', 'surerank' ), ]; return array_slice( $columns, 0, $target_column, true ) + $custom_column + array_slice( $columns, $target_column, null, true ); } /* * Renders column content for posts or taxonomies. * * @param string\|int $column_name The name of the column. * @param int $id The ID of the post or term. * @return void / public function column_content( $column_name, $id ) { if ( ! $id ) { return; } // Skip if the page is built with Bricks builder. if ( get_post_meta( $id, '_bricks_page_content_2', true ) ) { return; } $post_title = get_the_title( $id ); if ( $column_name === 'surerank-data' ) { echo '<span id="surerank-seo-popup-' . esc_attr( (string) $id ) . '" class="surerank-root surerank-page-score" data-title="' . esc_attr( (string) $post_title ) . '" data-id="' . esc_attr( (string) $id ) . '"><div class="bg-gray-200 animate-pulse w-full h-6 rounded-full max-w-32"></div></span>'; } } /* * Sets up column filters and actions for accessible post types. * * @return void / public function setup_columns() { $post_types = $this->get_accessible_post_types(); foreach ( $post_types as $post_type ) { if ( $this->display_metabox( $post_type, 'wp_posts' ) !== false ) { add_filter( "manage_{$post_type}_posts_columns", [ $this, 'column_heading' ], 10, 1 ); add_action( "manage_{$post_type}_posts_custom_column", [ $this, 'column_content' ], 10, 2 ); } } } /* * Sets up column filters and actions for accessible taxonomies. * * @return void / public function setup_taxonomy_columns() { $taxonomies = $this->get_accessible_taxonomies(); foreach ( $taxonomies as $taxonomy ) { if ( $this->display_metabox( $taxonomy, 'wp_terms' ) !== false ) { add_filter( "manage_edit-{$taxonomy}_columns", [ $this, 'column_heading_taxonomy' ], 10, 1 ); add_action( "manage_{$taxonomy}_custom_column", [ $this, 'column_content_taxonomy' ], 10, 3 ); } } } /* * Renders column content for taxonomies. * * @param string $content The current column content. * @param string $column_name The name of the column. * @param int $term_id The ID of the term. * @return void / public function column_content_taxonomy( $content, $column_name, $term_id ) { if ( ! $term_id ) { return; } $term_title = get_term( $term_id ); if ( is_wp_error( $term_title ) ) { $term_title = ''; } else { $term_title = $term_title->name ?? ''; } if ( $column_name === 'surerank-data' ) { echo '<span id="surerank-seo-popup-' . esc_attr( (string) $term_id ) . '" class="surerank-root surerank-page-score" data-title="' . esc_attr( (string) $term_title ) . '" data-id="' . esc_attr( (string) $term_id ) . '"><div class="bg-gray-200 animate-pulse w-full h-6 rounded-full max-w-32"></div></span>'; } } /* * Checks if the metabox should be displayed. * * @param string $post_type_or_taxonomy Post type or taxonomy to check. * @param string $object_type Object type to check. * @return bool Whether the metabox should be displayed. / public static function display_metabox( $post_type_or_taxonomy = '', $object_type = '' ) { if ( $object_type === 'wp_posts' ) { if ( in_array( $post_type_or_taxonomy, apply_filters( 'surerank_excluded_post_types_from_seo_checks', [ 'elementor_library', 'sureforms_form', 'astra-advanced-hook' ] ), true ) ) { return false; } } if ( $object_type === 'wp_terms' ) { if ( in_array( $post_type_or_taxonomy, apply_filters( 'surerank_excluded_taxonomies_from_seo_checks', [] ), true ) ) { return false; } } return true; } /* * Retrieves accessible post types. * * @return array<string> List of accessible post types. / private function get_accessible_post_types() { return get_post_types( [ 'public' => true ], 'names' ); } /* * Retrieves accessible taxonomies. * * @return array<string> List of accessible taxonomies. */ private function get_accessible_taxonomies() { return get_taxonomies( [ 'public' => true ], 'names' ); } }	7.52 KB	2025-10-27 18:36
📄 seo-popup.php <?php /** * Post Popup * * @since 1.0.0 * @package surerank / namespace SureRank\Inc\Admin; if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } use SureRank\Inc\Analyzer\PostAnalyzer; use SureRank\Inc\Frontend\Crawl_Optimization; use SureRank\Inc\Frontend\Image_Seo; use SureRank\Inc\Functions\Get; use SureRank\Inc\Functions\Update; use SureRank\Inc\Traits\Enqueue; use SureRank\Inc\Traits\Get_Instance; /* * Post Popup * * @method void wp_enqueue_scripts() * @since 1.0.0 / class Seo_Popup { use Enqueue; use Get_Instance; /* * Constructor * * @since 0.0.1 * @return void / public function __construct() { $this->enqueue_scripts_admin(); add_action( 'category_term_edit_form_top', [ $this, 'add_meta_box_trigger' ] ); add_action( 'created_category', [ $this, 'update_category_seo_values' ] ); add_action( 'edited_category', [ $this, 'update_category_seo_values' ] ); } /* * Add tags * * @since 0.0.1 * @return void / public function add_meta_box_trigger() { echo '<span id="seo-popup" class="surerank-root"></span>'; } /* * Enqueue admin scripts * * @since 0.0.1 * @return void / public function admin_enqueue_scripts() { wp_enqueue_media(); $screen = $this->get_current_screen_safe(); $editor_type = $this->detect_editor_type( $screen ); if ( ! $this->should_enqueue_scripts( $editor_type, $screen ) ) { return; } $context_data = $this->get_context_data( $editor_type, $screen ); $this->enqueue_assets( $editor_type, $context_data ); } /* * Update seo values * * @param int $term_id Post ID. * * @since 0.0.1 * @return void / public function update_category_seo_values( $term_id ) { // Validate post ID. if ( empty( $term_id ) \|\| ! is_int( $term_id ) ) { return; } // Update post seo values. $result = Update::term_meta( $term_id, [], [] ); if ( is_wp_error( $result ) ) { return; } do_action( 'surerank_after_update_category_seo_values', $term_id ); } /* * Get current screen safely. * * @return \WP_Screen\|null / private function get_current_screen_safe() { return function_exists( 'get_current_screen' ) ? get_current_screen() : null; } /* * Detect the current editor type. * * @param \WP_Screen\|null $screen Current screen object. * @return string Editor type. / private function detect_editor_type( $screen ): string { if ( class_exists( \Elementor\Plugin::class ) && \Elementor\Plugin::instance()->editor->is_edit_mode() ) { return 'elementor'; } if ( function_exists( 'bricks_is_builder_main' ) && bricks_is_builder_main() ) { return 'bricks'; } if ( $screen && $screen->is_block_editor ) { return 'block'; } return 'classic'; } /* * Check if scripts should be enqueued. * * @param string $editor_type Editor type. * @param \WP_Screen\|null $screen Current screen object. * @return bool True if scripts should be enqueued. / private function should_enqueue_scripts( string $editor_type, $screen ): bool { if ( $editor_type === 'bricks' ) { return true; } return $screen && ! empty( $screen->base ) && in_array( $screen->base, [ 'post', 'term' ], true ); } /* * Get context data for the current page. * * @param string $editor_type Editor type. * @param \WP_Screen\|null $screen Current screen object. * @return array{post_data: array<string, mixed>, term_data: array<string, mixed>, post_type: string, is_taxonomy: bool} Context data. / private function get_context_data( string $editor_type, $screen ): array { $post_data = $this->get_post_data( $editor_type, $screen ); $term_data = $this->get_term_data( $screen ); return [ 'post_data' => $post_data, 'term_data' => $term_data, 'post_type' => $this->get_post_type( $editor_type, $screen ), 'is_taxonomy' => $this->is_taxonomy( $editor_type, $screen ), ]; } /* * Get post data if on post edit screen. * * @param string $editor_type Editor type. * @param \WP_Screen\|null $screen Current screen object. * @return array<string, mixed> Post data. / private function get_post_data( string $editor_type, $screen ): array { if ( ( $screen && 'post' === $screen->base ) \|\| $editor_type === 'bricks' ) { return [ 'post_id' => get_the_ID(), 'editor_type' => $editor_type, 'link' => get_the_permalink( (int) get_the_ID() ), ]; } return []; } /* * Get term data if on term edit screen. * * @param \WP_Screen\|null $screen Current screen object. * @return array<string, mixed> Term data. / private function get_term_data( $screen ): array { if ( ! $screen \|\| 'term' !== $screen->base ) { return []; } global $tag_ID; $final_link = get_term_link( (int) $tag_ID ); if ( is_wp_error( $final_link ) ) { return []; } $final_link = $this->process_category_link( $final_link, $tag_ID, $screen ); return [ 'term_id' => $tag_ID, 'link' => $final_link, ]; } /* * Process category link if needed. * * @param string $link Term link. * @param int $tag_ID Term ID. * @param \WP_Screen\|null $screen Current screen object. * @return string Processed link. / private function process_category_link( string $link, int $tag_ID, $screen ): string { if ( $screen && 'category' === $screen->taxonomy && apply_filters( 'surerank_remove_category_base', false ) ) { $term = get_term( $tag_ID ); if ( $term && ! is_wp_error( $term ) ) { return Crawl_Optimization::get_instance()->remove_category_base_from_links( $link, $term, $screen->taxonomy ); } } return $link; } /* * Get post type for current context. * * @param string $editor_type Editor type. * @param \WP_Screen\|null $screen Current screen object. * @return string Post type. / private function get_post_type( string $editor_type, $screen ): string { if ( $editor_type === 'bricks' ) { $post_type = get_the_ID() ? get_post_type( get_the_ID() ) : false; return $post_type !== false ? $post_type : ''; } if ( ! $screen ) { return ''; } return ! empty( $screen->taxonomy ) ? $screen->taxonomy : $screen->post_type; } /* * Check if current context is taxonomy. * * @param string $editor_type Editor type. * @param \WP_Screen\|null $screen Current screen object. * @return bool True if taxonomy context. / private function is_taxonomy( string $editor_type, $screen ): bool { if ( $editor_type === 'bricks' ) { return false; } return $screen && ! empty( $screen->taxonomy ); } /* * Enqueue assets for SEO popup. * * @param string $editor_type Editor type. * @param array{post_data: array<string, mixed>, term_data: array<string, mixed>, post_type: string, is_taxonomy: bool} $context_data Context data. * @return void / private function enqueue_assets( string $editor_type, array $context_data ): void { $this->enqueue_vendor_and_common_assets(); $this->build_assets_operations( 'seo-popup', [ 'hook' => 'seo-popup', 'object_name' => 'seo_popup', 'data' => array_merge( [ 'admin_assets_url' => SURERANK_URL . 'inc/admin/assets', 'site_icon_url' => get_site_icon_url( 16 ), 'editor_type' => $editor_type, 'post_type' => $context_data['post_type'], 'is_taxonomy' => $context_data['is_taxonomy'], 'description_length' => Get::description_length(), 'title_length' => Get::title_length(), 'keyword_checks' => $this->keyword_checks(), 'page_checks' => $this->page_checks(), 'image_seo' => Image_Seo::get_instance()->status(), ], $context_data['post_data'], $context_data['term_data'] ), ] ); } /* * Get keyword checks configuration * * @since 1.0.0 * @return array / /* * Get keyword checks configuration * * @since 1.0.0 * @return array<string> / public function keyword_checks() { return [ 'keyword_in_title', 'keyword_in_description', 'keyword_in_url', 'keyword_in_content', ]; } /* * Get page checks configuration * * @since 1.0.0 * @return array<string> */ public function page_checks() { return [ 'h2_subheadings', 'image_alt_text', 'media_present', 'links_present', 'url_length', 'search_engine_title', 'search_engine_description', 'canonical_url', 'all_links', 'open_graph_tags', 'broken_links', ]; } }	8.45 KB	2025-10-27 18:36
📄 sync.php <?php /** * Admin Sync * * @since 1.2.0 * @package surerank / namespace SureRank\Inc\Admin; if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } use SureRank\Inc\BatchProcess\Cleanup; use SureRank\Inc\BatchProcess\Process; use SureRank\Inc\BatchProcess\Sync_Posts; use SureRank\Inc\BatchProcess\Sync_Taxonomies; use SureRank\Inc\Functions\Cache; use SureRank\Inc\Functions\Helper; use SureRank\Inc\Schema\Helper as Schema_Helper; use SureRank\Inc\Sitemap\Checksum; use SureRank\Inc\Sitemap\Utils; use SureRank\Inc\Traits\Get_Instance; use SureRank\Inc\Traits\Logger; use WP_CLI; /* * Admin Sync * * @since 1.2.0 / class Sync { use Get_Instance; use Logger; /* * All processes. * * @since 1.2.0 * @var object Class object. * @access public / public static $processes; /* * Constructor * * @since 1.2.0 * @return void / public function __construct() { add_action( 'surerank_start_building_cache', [ $this, 'start_building_cache' ], 10, 1 ); add_action( 'surerank_batch_process_complete', [ $this, 'batch_process_complete' ] ); } /* * Batch Process Complete. * * @since 1.2.0 * @return void / public function batch_process_complete() { Checksum::get_instance()->update_cache_checksum( Checksum::get_instance()->get_checksum() ); } /* * Start Building the cache. * * @param string $force Force flag to regenerate cache. * @since 1.2.0 * @return void / public function start_building_cache( $force = '' ) { if ( empty( $force ) && ! $this->should_initiate_batch_process() ) { if ( defined( 'WP_CLI' ) ) { WP_CLI::line( 'Checksum are matching, no data available to sync.' ); } else { self::log( 'Checksum are matching, no data available to sync.' ); } return; } // Get the singleton instance of Process. self::$processes = Process::get_instance(); // Clear existing sitemap cache before regeneration. Cache::clear_all(); $classes = []; $chunk_size = apply_filters( 'surerank_sitemap_json_chunk_size', 20 ); /* Handle taxonomies with pagination. / $classes = array_merge( $classes, $this->create_post_type_sync_classes( $chunk_size ) ); $classes = array_merge( $classes, $this->create_taxonomy_sync_classes( $chunk_size ) ); $classes = apply_filters( 'surerank_batch_process_classes', $classes ); $classes = array_merge( $classes, $this->create_cleanup_class() ); if ( defined( 'WP_CLI' ) ) { WP_CLI::line( 'Batch Process Started..' ); foreach ( $classes as $key => $class ) { if ( is_object( $class ) && method_exists( $class, 'import' ) ) { $class->import(); } } WP_CLI::line( 'Batch Process Complete!' ); } else { // Add all classes to batch queue. foreach ( $classes as $key => $class ) { if ( method_exists( self::$processes, 'push_to_queue' ) ) { self::$processes->push_to_queue( $class ); } } if ( method_exists( self::$processes, 'save' ) ) { // Dispatch Queue. self::$processes->save()->dispatch(); } } } /* * Check if batch process should be initiated. * * @since 1.2.0 * @return bool / public function should_initiate_batch_process() { $data_updates_checksum = Checksum::get_instance()->get_checksum(); $sync_process_checksum = Checksum::get_instance()->get_cache_checksum(); if ( empty( $data_updates_checksum ) ) { // 1st time sync, no previous checksum available. Checksum::get_instance()->update_checksum(); return true; } if ( empty( $sync_process_checksum ) ) { return true; } if ( $data_updates_checksum === $sync_process_checksum ) { return false; } return true; } /* * Get all post types. * * @return array<string, mixed>\|array<int, string> / public function get_included_post_types() { return apply_filters( 'surerank_sitemap_enabled_cpts', Helper::get_public_cpts() ); } /* * Get all taxonomies. * * @return array<string, mixed>\|array<int, string> / public function get_included_taxonomies() { return apply_filters( 'surerank_sitemap_enabled_taxonomies', Schema_Helper::get_instance()->get_taxonomies( [ 'public' => true, ] ) ); } /* * Get count of indexable posts for a specific post type * * @param string $post_type The post type. * @since 1.2.0 * @return int / private function get_indexable_posts_count( string $post_type ): int { $args = [ 'post_type' => $post_type, 'post_status' => 'publish', 'posts_per_page' => -1, 'fields' => 'ids', 'ignore_sticky_posts' => true, 'meta_query' => Utils::get_indexable_meta_query( $post_type ), //phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_query ]; $query = new \WP_Query( $args ); return $query->found_posts; } /* * Get count of indexable terms for a specific taxonomy * * @param string $taxonomy The taxonomy name. * @since 1.2.0 * @return int / private function get_indexable_terms_count( string $taxonomy ) { $args = [ 'taxonomy' => $taxonomy, 'hide_empty' => true, 'number' => 0, 'fields' => 'ids', 'meta_query' => Utils::get_indexable_meta_query( $taxonomy ), //phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_query ]; $terms = get_terms( $args ); if ( is_wp_error( $terms ) ) { return 0; } return count( $terms ); } /* * Create taxonomy sync classes * * @param int $chunk_size Chunk size for pagination. * @return array<int, object> / private function create_taxonomy_sync_classes( int $chunk_size ) { $classes = []; $taxonomies = $this->get_included_taxonomies(); if ( empty( $taxonomies ) ) { return $classes; } $excluded_taxonomies = [ 'post_format' ]; foreach ( $taxonomies as $taxonomy ) { if ( ! isset( $taxonomy['slug'] ) ) { continue; // Skip if not a valid taxonomy slug. } if ( in_array( $taxonomy['slug'], $excluded_taxonomies, true ) ) { continue; } $indexable_count = $this->get_indexable_terms_count( $taxonomy['slug'] ); $classes = array_merge( $classes, $this->create_sync_classes( $indexable_count, $chunk_size, $taxonomy['slug'], 'taxonomy' ) ); } return $classes; } /* * Create cleanup class * /** * * @return array<int, object> / private function create_cleanup_class() { return [ Cleanup::get_instance() ]; } /* * Create post type sync classes * * @param int $chunk_size Chunk size for pagination. * @return array<int, object> / private function create_post_type_sync_classes( int $chunk_size ) { $classes = []; $cpts = $this->get_included_post_types(); if ( empty( $cpts ) ) { return $classes; } $excluded_cpts = [ 'attachment' ]; foreach ( $cpts as $cpt ) { if ( ! isset( $cpt->name ) ) { continue; // Skip if not a valid post type object. } if ( in_array( $cpt->name, $excluded_cpts, true ) ) { continue; } $indexable_count = $this->get_indexable_posts_count( $cpt->name ); $classes = array_merge( $classes, $this->create_sync_classes( $indexable_count, $chunk_size, $cpt->name, 'post' ) ); } return $classes; } /* * Create sync classes for given count and parameters. * * @param int $indexable_count Number of indexable items. * @param int $chunk_size Chunk size for pagination. * @param string $name Taxonomy or post type name. * @param string $type Type of sync class (taxonomy or post). * @return array<int, object> / private function create_sync_classes( int $indexable_count, int $chunk_size, string $name, string $type ) { $classes = []; if ( $indexable_count <= 0 ) { return $classes; } $no_of_times = (int) ceil( $indexable_count / $chunk_size ); for ( $i = 1; $i <= $no_of_times; $i++ ) { $offset = ( $i - 1 ) $chunk_size; if ( $type === 'taxonomy' ) { $classes[] = new Sync_Taxonomies( $offset, $name, $chunk_size ); } else { $classes[] = new Sync_Posts( $offset, $name, $chunk_size ); } } return $classes; } }	7.9 KB	2025-10-27 18:36
📄 update-timestamp.php <?php /** * Update Timestamp * * @since 1.0.0 * @package surerank / namespace SureRank\Inc\Admin; if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } use SureRank\Inc\Functions\Update; use SureRank\Inc\Traits\Get_Instance; /* * Update Timestamp * * @since 1.0.0 / class Update_Timestamp { use Get_Instance; /* * Constructor * * @since 0.0.1 * @return void / public function __construct() { self::init_actions(); } /* * Initialize actions in which we will update the timestamp. * * @since 0.0.1 * @return void / public static function init_actions() { /* * These options represent a list of settings for which we intend to update the timestamp upon modification. / $actions_name = [ 'blogname', 'blogdescription', 'new_admin_email', ]; foreach ( $actions_name as $action_name ) { add_action( "update_option_{$action_name}", [ 'SureRank\Inc\Admin\Update_Timestamp', 'timestamp_option' ] ); } } /* * Update the timestamp option. * * @since 1.0.0 * @return void */ public static function timestamp_option() { // Update the timestamp option. Update::option( SURERANK_SEO_LAST_UPDATED, time() ); } }	1.19 KB	2025-10-27 18:36

Terminal