*/
namespace RankMath\Analytics;
use RankMath\KB;
use RankMath\Helper;
use RankMath\Helpers\Arr;
use RankMath\Helpers\Param;
use RankMath\Google\Api;
use RankMath\Module\Base;
use RankMath\Admin\Page;
use RankMath\Google\Console;
use RankMath\Google\Authentication;
use RankMath\Analytics\Workflow\Jobs;
use RankMath\Analytics\Workflow\OAuth;
use RankMath\Analytics\Workflow\Workflow;
defined( 'ABSPATH' ) || exit;
/**
* Analytics class.
*/
class Analytics extends Base {
/**
* Module ID.
*
* @var string
*/
public $id = '';
/**
* Module directory.
*
* @var string
*/
public $directory = '';
/**
* Module help.
*
* @var array
*/
public $help = [];
/**
* Module page.
*
* @var object
*/
public $page;
/**
* The Constructor
*/
public function __construct() {
if ( Helper::is_heartbeat() || ! Helper::has_cap( 'analytics' ) ) {
return;
}
$directory = dirname( __FILE__ );
$this->config(
[
'id' => 'analytics',
'directory' => $directory,
'help' => [
'title' => esc_html__( 'Analytics', 'rank-math' ),
'view' => $directory . '/views/help.php',
],
]
);
parent::__construct();
new AJAX();
Api::get();
Watcher::get();
Stats::get();
Jobs::get();
Workflow::get();
$this->action( 'admin_notices', 'render_notice' );
$this->action( 'rank_math/admin/enqueue_scripts', 'enqueue' );
$this->action( 'admin_enqueue_scripts', 'options_panel_messages' );
$this->action( 'wp_helpers_notification_dismissed', 'analytic_first_fetch_dismiss' );
if ( is_admin() ) {
$this->filter( 'rank_math/database/tools', 'add_tools' );
$this->filter( 'rank_math/settings/general', 'add_settings' );
$this->action( 'admin_init', 'refresh_token_missing', 25 );
$this->action( 'admin_init', 'cancel_fetch', 5 );
new OAuth();
}
}
/**
* Cancel Fetching of Google.
*/
public function cancel_fetch() {
$cancel = Param::get( 'cancel-fetch', false );
if (
empty( $cancel ) ||
! Param::get( '_wpnonce' ) ||
! wp_verify_nonce( Param::get( '_wpnonce' ), 'rank_math_cancel_fetch' ) ||
! Helper::has_cap( 'analytics' )
) {
return;
}
Workflow::kill_workflows();
}
/**
* If refresh token missing add notice.
*/
public function refresh_token_missing() {
// Bail if the user is not authenticated at all yet.
if ( ! Helper::is_site_connected() || ! Authentication::is_authorized() ) {
return;
}
$tokens = Authentication::tokens();
if ( ! empty( $tokens['refresh_token'] ) ) {
Helper::remove_notification( 'reconnect' );
return;
}
// Show admin notification.
Helper::add_notification(
sprintf(
/* translators: Auth URL */
'' . __( 'It seems like the connection with your Google account & Rank Math needs to be made again. Please click here.', 'rank-math' ),
esc_url( Authentication::get_auth_url() )
),
[
'type' => 'error',
'classes' => 'rank-math-error rank-math-notice',
'id' => 'reconnect',
]
);
}
/**
* Hide fetch notice.
*
* @param string $notification_id Notification id.
*/
public function analytic_first_fetch_dismiss( $notification_id ) {
if ( 'rank_math_analytics_first_fetch' !== $notification_id ) {
return;
}
update_option( 'rank_math_analytics_first_fetch', 'hidden' );
}
/**
* Admin init.
*/
public function render_notice() {
$this->remove_action( 'admin_notices', 'render_notice' );
if ( 'fetching' === get_option( 'rank_math_analytics_first_fetch' ) ) {
$actions = as_get_scheduled_actions(
[
'order' => 'DESC',
'hook' => 'rank_math/analytics/clear_cache',
'status' => \ActionScheduler_Store::STATUS_PENDING,
]
);
if ( empty( $actions ) ) {
update_option( 'rank_math_analytics_first_fetch', 'hidden' );
return;
}
$action = current( $actions );
$schedule = $action->get_schedule();
$next_timestamp = $schedule->get_date()->getTimestamp();
// Calculate extra time needed for the inspections.
$objects_count = DB::objects()->selectCount( 'id' )->getVar();
$daily_api_limit = \RankMath\Analytics\Workflow\Inspections::API_LIMIT;
$time_gap = \RankMath\Analytics\Workflow\Inspections::REQUEST_GAP_SECONDS;
$extra_time = $objects_count * $time_gap;
if ( $objects_count > $daily_api_limit ) {
$extra_time += DAY_IN_SECONDS * floor( $objects_count / $daily_api_limit );
}
// phpcs:disable
$notification = new \RankMath\Admin\Notifications\Notification(
/* translators: delete counter */
sprintf(
'' .
esc_html__( 'Rank Math is importing latest data from connected Google Services, %1$s remaining.', 'rank-math' ) .
' ' . esc_html__( 'Cancel Fetch', 'rank-math' ) . '',
$this->human_interval( $next_timestamp - gmdate( 'U' ) + $extra_time ),
esc_url( wp_nonce_url( add_query_arg( 'cancel-fetch', 1 ), 'rank_math_cancel_fetch' ) )
),
[
'type' => 'info',
'id' => 'rank_math_analytics_first_fetch',
'classes' => 'rank-math-notice',
]
);
echo $notification;
}
}
/**
* Convert an interval of seconds into a two part human friendly string.
*
* The WordPress human_time_diff() function only calculates the time difference to one degree, meaning
* even if an action is 1 day and 11 hours away, it will display "1 day". This function goes one step
* further to display two degrees of accuracy.
*
* Inspired by the Crontrol::interval() function by Edward Dale: https://wordpress.org/plugins/wp-crontrol/
*
* @param int $interval A interval in seconds.
* @param int $periods_to_include Depth of time periods to include, e.g. for an interval of 70, and $periods_to_include of 2, both minutes and seconds would be included. With a value of 1, only minutes would be included.
* @return string A human friendly string representation of the interval.
*/
private function human_interval( $interval, $periods_to_include = 2 ) {
$time_periods = [
[
'seconds' => YEAR_IN_SECONDS,
/* translators: %s: amount of time */
'names' => _n_noop( '%s year', '%s years', 'rank-math' ),
],
[
'seconds' => MONTH_IN_SECONDS,
/* translators: %s: amount of time */
'names' => _n_noop( '%s month', '%s months', 'rank-math' ),
],
[
'seconds' => WEEK_IN_SECONDS,
/* translators: %s: amount of time */
'names' => _n_noop( '%s week', '%s weeks', 'rank-math' ),
],
[
'seconds' => DAY_IN_SECONDS,
/* translators: %s: amount of time */
'names' => _n_noop( '%s day', '%s days', 'rank-math' ),
],
[
'seconds' => HOUR_IN_SECONDS,
/* translators: %s: amount of time */
'names' => _n_noop( '%s hour', '%s hours', 'rank-math' ),
],
[
'seconds' => MINUTE_IN_SECONDS,
/* translators: %s: amount of time */
'names' => _n_noop( '%s minute', '%s minutes', 'rank-math' ),
],
[
'seconds' => 1,
/* translators: %s: amount of time */
'names' => _n_noop( '%s second', '%s seconds', 'rank-math' ),
],
];
if ( $interval <= 0 ) {
return __( 'Now!', 'rank-math' );
}
$output = '';
for ( $time_period_index = 0, $periods_included = 0, $seconds_remaining = $interval; $time_period_index < count( $time_periods ) && $seconds_remaining > 0 && $periods_included < $periods_to_include; $time_period_index++ ) { // phpcs:ignore
$periods_in_interval = floor( $seconds_remaining / $time_periods[ $time_period_index ]['seconds'] );
if ( $periods_in_interval > 0 ) {
if ( ! empty( $output ) ) {
$output .= ' ';
}
$output .= sprintf( _n( $time_periods[ $time_period_index ]['names'][0], $time_periods[ $time_period_index ]['names'][1], $periods_in_interval, 'rank-math' ), $periods_in_interval ); // phpcs:ignore
$seconds_remaining -= $periods_in_interval * $time_periods[ $time_period_index ]['seconds'];
$periods_included++;
}
}
return $output;
}
/**
* Add l18n for the Settings.
*
* @return void
*/
public function options_panel_messages() {
$screen = get_current_screen();
if ( 'rank-math_page_rank-math-options-general' !== $screen->id ) {
return;
}
Helper::add_json( 'confirmAction', esc_html__( 'Are you sure you want to do this?', 'rank-math' ) );
Helper::add_json( 'confirmClearImportedData', esc_html__( 'You are about to delete all the previously imported data.', 'rank-math' ) );
Helper::add_json( 'confirmClear90DaysCache', esc_html__( 'You are about to delete your 90 days cache.', 'rank-math' ) );
Helper::add_json( 'confirmDisconnect', esc_html__( 'Are you sure you want to disconnect Google services from your site?', 'rank-math' ) );
Helper::add_json( 'feedbackCacheDeleted', esc_html__( 'Cache deleted.', 'rank-math' ) );
}
/**
* Enqueue scripts for the metabox.
*/
public function enqueue() {
$screen = get_current_screen();
if ( 'rank-math_page_rank-math-analytics' !== $screen->id ) {
return;
}
$uri = untrailingslashit( plugin_dir_url( __FILE__ ) );
wp_enqueue_style(
'rank-math-analytics',
$uri . '/assets/css/stats.css',
[],
rank_math()->version
);
wp_register_script(
'rank-math-analytics',
$uri . '/assets/js/stats.js',
[
'lodash',
'wp-components',
'wp-element',
'wp-i18n',
'wp-date',
'wp-api-fetch',
'wp-html-entities',
],
rank_math()->version,
true
);
wp_set_script_translations( 'rank-math-analytics', 'rank-math', plugin_dir_path(__FILE__) . 'languages/' );
$this->action( 'admin_footer', 'dequeue_cmb2' );
$preference = apply_filters(
'rank_math/analytics/user_preference',
[
'topPosts' => [
'seo_score' => false,
'schemas_in_use' => false,
'impressions' => true,
'pageviews' => true,
'clicks' => false,
'position' => true,
'positionHistory' => true,
],
'siteAnalytics' => [
'seo_score' => true,
'schemas_in_use' => true,
'impressions' => false,
'pageviews' => true,
'links' => true,
'clicks' => false,
'position' => false,
'positionHistory' => false,
],
'performance' => [
'seo_score' => true,
'schemas_in_use' => true,
'impressions' => true,
'pageviews' => true,
'ctr' => false,
'clicks' => true,
'position' => true,
'positionHistory' => true,
],
'keywords' => [
'impressions' => true,
'ctr' => false,
'clicks' => true,
'position' => true,
'positionHistory' => true,
],
'topKeywords' => [
'impressions' => true,
'ctr' => true,
'clicks' => true,
'position' => true,
'positionHistory' => true,
],
'trackKeywords' => [
'impressions' => true,
'ctr' => false,
'clicks' => true,
'position' => true,
'positionHistory' => true,
],
'rankingKeywords' => [
'impressions' => true,
'ctr' => false,
'clicks' => true,
'position' => true,
'positionHistory' => true,
],
'indexing' => [
'index_verdict' => true,
'indexing_state' => true,
'mobile_usability_verdict' => true,
'rich_results_items' => true,
'page_fetch_state' => false,
],
]
);
$user_id = get_current_user_id();
if ( metadata_exists( 'user', $user_id, 'rank_math_analytics_table_columns' ) ) {
$preference = wp_parse_args(
get_user_meta( $user_id, 'rank_math_analytics_table_columns', true ),
$preference
);
}
Helper::add_json( 'userColumnPreference', $preference );
// Last Updated.
$updated = get_option( 'rank_math_analytics_last_updated', false );
$updated = $updated ? date_i18n( get_option( 'date_format' ), $updated ) : '';
Helper::add_json( 'lastUpdated', $updated );
Helper::add_json( 'singleImage', rank_math()->plugin_url() . 'includes/modules/analytics/assets/img/single-post-report.jpg' );
// Index Status tab.
$enable_index_status = Helper::can_add_index_status();
Helper::add_json( 'enableIndexStatus', $enable_index_status );
Helper::add_json( 'viewedIndexStatus', get_option( 'rank_math_viewed_index_status', false ) );
if ( $enable_index_status ) {
update_option( 'rank_math_viewed_index_status', true );
}
Helper::add_json( 'isRtl', is_rtl() );
}
/**
* Dequeue cmb2.
*/
public function dequeue_cmb2() {
wp_dequeue_script( 'cmb2-scripts' );
}
/**
* Register admin page.
*/
public function register_admin_page() {
$dot_color = '#ed5e5e';
if ( Console::is_console_connected() ) {
$dot_color = '#11ac84';
}
$this->page = new Page(
'rank-math-analytics',
esc_html__( 'Analytics', 'rank-math' ) . '',
[
'position' => 5,
'parent' => 'rank-math',
'capability' => 'rank_math_analytics',
'render' => $this->directory . '/views/dashboard.php',
'classes' => [ 'rank-math-page' ],
'assets' => [
'styles' => [
'rank-math-common' => '',
'rank-math-analytics' => '',
],
'scripts' => [
'rank-math-analytics' => '',
],
],
]
);
}
/**
* Add module settings into general optional panel.
*
* @param array $tabs Array of option panel tabs.
*
* @return array
*/
public function add_settings( $tabs ) {
Arr::insert(
$tabs,
[
'analytics' => [
'icon' => 'rm-icon rm-icon-search-console',
'title' => esc_html__( 'Analytics', 'rank-math' ),
/* translators: Link to kb article */
'desc' => sprintf( esc_html__( 'See your Google Search Console, Analytics and AdSense data without leaving your WP dashboard. %s.', 'rank-math' ), '' . esc_html__( 'Learn more', 'rank-math' ) . '' ),
'file' => $this->directory . '/views/options.php',
],
],
9
);
return $tabs;
}
/**
* Add database tools.
*
* @param array $tools Array of tools.
*
* @return array
*/
public function add_tools( $tools ) {
Arr::insert(
$tools,
[
'analytics_clear_caches' => [
'title' => __( 'Purge Analytics Cache', 'rank-math' ),
'description' => __( 'Clear analytics cache to re-calculate all the stats again.', 'rank-math' ),
'button_text' => __( 'Clear Cache', 'rank-math' ),
],
'analytics_reindex_posts' => [
'title' => __( 'Rebuild Index for Analytics', 'rank-math' ),
'description' => __( 'Missing some posts/pages in the Analytics data? Clear the index and build a new one for more accurate stats.', 'rank-math' ),
'button_text' => __( 'Rebuild Index', 'rank-math' ),
],
],
3
);
return $tools;
}
}