You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

367 lines
11 KiB
PHTML

<?php
/**
* Methods for frontend and backend in admin-only module
*
* @since 1.0.49
* @package RankMath
* @subpackage RankMath\Analytics
* @author Rank Math <support@rankmath.com>
*/
namespace RankMath\Analytics;
use RankMath\Helper;
use RankMath\Helpers\Str;
use RankMath\Helpers\DB as DB_Helper;
use RankMath\Traits\Hooker;
use RankMath\Google\Console;
use RankMath\Google\Authentication;
use RankMath\Analytics\Workflow\Jobs;
use RankMath\Analytics\Workflow\Workflow;
defined( 'ABSPATH' ) || exit;
/**
* Analytics class.
*/
class Analytics_Common {
use Hooker;
/**
* The Constructor
*/
public function __construct() {
if ( Helper::is_heartbeat() ) {
return;
}
if ( Helper::has_cap( 'analytics' ) ) {
$this->action( 'rank_math/admin_bar/items', 'admin_bar_items', 11 );
}
// Show Analytics block in the Dashboard widget only if account is connected or user has permissions.
if ( Helper::has_cap( 'analytics' ) && Authentication::is_authorized() ) {
$this->action( 'rank_math/dashboard/widget', 'dashboard_widget' );
}
new GTag();
new Analytics_Stats();
$this->action( 'plugins_loaded', 'maybe_init_email_reports', 15 );
$this->action( 'init', 'maybe_enable_email_reports', 20 );
$this->action( 'cmb2_save_options-page_fields_rank-math-options-general_options', 'maybe_update_report_schedule', 20, 3 );
Jobs::get();
Workflow::get();
$this->action( 'rest_api_init', 'init_rest_api' );
$this->filter( 'rank_math/webmaster/google_verify', 'add_site_verification' );
$this->filter( 'rank_math/tools/analytics_clear_caches', 'analytics_clear_caches' );
$this->filter( 'rank_math/tools/analytics_reindex_posts', 'analytics_reindex_posts' );
$this->filter( 'rank_math/tools/analytics_fix_collations', 'analytics_fix_collations' );
$this->filter( 'wp_helpers_notifications_render', 'replace_notice_link', 10, 3 );
}
/**
* Add stats widget into admin dashboard.
*/
public function dashboard_widget() {
?>
<h3>
<?php esc_html_e( 'Analytics', 'rank-math' ); ?>
<span><?php esc_html_e( 'Last 30 Days', 'rank-math' ); ?></span>
<a href="<?php echo esc_url( Helper::get_admin_url( 'analytics' ) ); ?>" class="rank-math-view-report" title="<?php esc_html_e( 'View Report', 'rank-math' ); ?>">
<i class="dashicons dashicons-chart-bar"></i>
</a>
</h3>
<div class="rank-math-dashboard-block items-4">
<?php
$items = $this->get_dashboard_widget_items();
foreach ( $items as $label => $item ) {
if ( ! $item['value'] ) {
continue;
}
?>
<div>
<h4>
<?php echo esc_html( $item['label'] ); ?>
<span class="rank-math-tooltip">
<em class="dashicons-before dashicons-editor-help"></em>
<span>
<?php echo esc_html( $item['desc'] ); ?>
</span>
</span>
</h4>
<?php $this->get_analytic_block( $item['data'], ! empty( $item['revert'] ) ); ?>
</div>
<?php } ?>
</div>
<?php
}
/**
* Return site verification code.
*
* @param string $content If any code from setting.
*
* @return string
*/
public function add_site_verification( $content ) {
$code = get_transient( 'rank_math_google_site_verification' );
return ! empty( $code ) ? $code : $content;
}
/**
* Load the REST API endpoints.
*/
public function init_rest_api() {
$controllers = [
new Rest(),
];
foreach ( $controllers as $controller ) {
$controller->register_routes();
}
}
/**
* Add admin bar item.
*
* @param Admin_Bar_Menu $menu Menu class instance.
*/
public function admin_bar_items( $menu ) {
$dot_color = '#ed5e5e';
if ( Console::is_console_connected() ) {
$dot_color = '#11ac84';
}
$menu->add_sub_menu(
'analytics',
[
'title' => esc_html__( 'Analytics', 'rank-math' ) . '<span class="rm-menu-new update-plugins" style="background: ' . $dot_color . ';margin-left: 5px;min-width: 10px;height: 10px;margin-bottom: -1px;display: inline-block;border-radius: 5px;"><span class="plugin-count"></span></span>',
'href' => Helper::get_admin_url( 'analytics' ),
'meta' => [ 'title' => esc_html__( 'Review analytics and sitemaps', 'rank-math' ) ],
'priority' => 20,
]
);
}
/**
* Purge cache.
*
* @return string
*/
public function analytics_clear_caches() {
DB::purge_cache();
return __( 'Analytics cache cleared.', 'rank-math' );
}
/**
* ReIndex posts.
*
* @return string
*/
public function analytics_reindex_posts() {
// Clear all objects data.
DB::objects()
->truncate();
// Clear all metadata related to object.
DB::table( 'postmeta' )
->where( 'meta_key', 'rank_math_analytic_object_id' )
->delete();
// Start reindexing posts.
( new \RankMath\Analytics\Workflow\Objects() )->flat_posts();
return __( 'Post re-index in progress.', 'rank-math' );
}
/**
* Fix table & column collations.
*
* @return string
*/
public function analytics_fix_collations() {
$tables = [
'rank_math_analytics_ga',
'rank_math_analytics_gsc',
'rank_math_analytics_keyword_manager',
'rank_math_analytics_inspections',
];
$objects_coll = DB_Helper::get_table_collation( 'rank_math_analytics_objects' );
$changed = 0;
foreach ( $tables as $table ) {
$changed += (int) DB_Helper::check_collation( $table, 'all', $objects_coll );
}
return $changed ? sprintf(
/* translators: %1$d: number of changes, %2$s: new collation. */
_n( '%1$d collation changed to %2$s.', '%1$d collations changed to %2$s.', $changed, 'rank-math' ),
$changed,
'`' . $objects_coll . '`'
) : __( 'No collation mismatch to fix.', 'rank-math' );
}
/**
* Init Email Reports class if the option is enabled.
*
* @return void
*/
public function maybe_init_email_reports() {
if ( Helper::get_settings( 'general.console_email_reports' ) ) {
new Email_Reports();
}
}
/**
* Enable the email reports option if the `enable_email_reports` param is set.
*
* @return void
*/
public function maybe_enable_email_reports() {
if ( ! Helper::has_cap( 'analytics' ) ) {
return;
}
if ( ! isset( $_GET['_wpnonce'] ) || ! wp_verify_nonce( $_GET['_wpnonce'], 'enable_email_reports' ) ) {
return;
}
if ( ! empty( $_GET['enable_email_reports'] ) ) {
$all_opts = rank_math()->settings->all_raw();
$general = $all_opts['general'];
$general['console_email_reports'] = 'on';
Helper::update_all_settings( $general, null, null );
rank_math()->settings->reset();
$this->schedule_email_reporting();
Helper::remove_notification( 'rank_math_analytics_new_email_reports' );
Helper::redirect( remove_query_arg( 'enable_email_reports' ) );
die();
}
}
/**
* Add/remove/change scheduled action when the report on/off or the frequency options are changed.
*
* @param int $object_id The ID of the current object.
* @param array $updated Array of field IDs that were updated.
* Will only include field IDs that had values change.
* @param object $cmb CMB object.
*/
public function maybe_update_report_schedule( $object_id, $updated, $cmb ) {
// Early bail if our options are not changed.
if ( ! in_array( 'console_email_reports', $updated, true ) && ! in_array( 'console_email_frequency', $updated, true ) ) {
return;
}
as_unschedule_all_actions( 'rank_math/analytics/email_report_event', [], 'rank-math' );
$values = $cmb->get_sanitized_values( $_POST ); // phpcs:ignore
if ( 'off' === $values['console_email_reports'] ) {
return;
}
$frequency = isset( $values['console_email_frequency'] ) ? $values['console_email_frequency'] : 'monthly';
$this->schedule_email_reporting( $frequency );
}
/**
* Replace link inside notice dynamically to avoid issues with the nonce.
*
* @param string $output Notice output.
* @param string $message Notice message.
* @param array $options Notice options.
*
* @return string
*/
public function replace_notice_link( $output, $message, $options ) {
$url = wp_nonce_url( Helper::get_admin_url( 'options-general&enable_email_reports=1#setting-panel-analytics' ), 'enable_email_reports' );
$output = str_replace( '###ENABLE_EMAIL_REPORTS###', $url, $output );
return $output;
}
/**
* Get Dashboard Widget items.
*/
private function get_dashboard_widget_items() {
// Get stats info within last 30 days.
Stats::get()->set_date_range( '-30 days' );
$data = Stats::get()->get_widget();
$analytics = get_option( 'rank_math_google_analytic_options' );
$is_connected = ! empty( $analytics ) && ! empty( $analytics['view_id'] );
return [
'search-traffic' => [
'label' => __( 'Search Traffic', 'rank-math' ),
'desc' => __( 'This is the number of pageviews carried out by visitors from Search Engines.', 'rank-math' ),
'value' => $is_connected && defined( 'RANK_MATH_PRO_FILE' ),
'data' => isset( $data->pageviews ) ? $data->pageviews : '',
],
'total-impressions' => [
'label' => __( 'Total Impressions', 'rank-math' ),
'desc' => __( 'How many times your site showed up in the search results.', 'rank-math' ),
'value' => true,
'data' => $data->impressions,
],
'total-clicks' => [
'label' => __( 'Total Clicks', 'rank-math' ),
'desc' => __( 'This is the number of pageviews carried out by visitors from Google.', 'rank-math' ),
'value' => ! $is_connected || ( $is_connected && ! defined( 'RANK_MATH_PRO_FILE' ) ),
'data' => $data->clicks,
],
'total-keywords' => [
'label' => __( 'Total Keywords', 'rank-math' ),
'desc' => __( 'Total number of keywords your site ranking below 100 position.', 'rank-math' ),
'value' => true,
'data' => $data->keywords,
],
'average-position' => [
'label' => __( 'Average Position', 'rank-math' ),
'desc' => __( 'Average position of all the ranking keywords below 100 position.', 'rank-math' ),
'value' => true,
'revert' => true,
'data' => $data->position,
],
];
}
/**
* Get analytic block
*
* @param object $item Item.
* @param boolean $revert Flag whether to revert difference icon or not.
*/
private function get_analytic_block( $item, $revert = false ) {
$total = isset( $item['total'] ) ? abs( $item['total'] ) : 0;
$difference = isset( $item['difference'] ) ? abs( $item['difference'] ) : 0;
$is_negative = isset( $item['difference'] ) && abs( $item['difference'] ) !== $item['difference'];
$diff_class = 'up';
if ( ( ! $revert && $is_negative ) || ( $revert && ! $is_negative && $item['difference'] > 0 ) ) {
$diff_class = 'down';
}
?>
<div class="rank-math-item-numbers">
<strong class="text-large" title="<?php echo esc_html( Str::human_number( $total ) ); ?>"><?php echo esc_html( Str::human_number( $total ) ); ?></strong>
<span class="rank-math-item-difference <?php echo esc_attr( $diff_class ); ?>" title="<?php echo esc_html( Str::human_number( $difference ) ); ?>"><?php echo esc_html( Str::human_number( $difference ) ); ?></span>
</div>
<?php
}
/**
* Schedule Email Reporting.
*
* @param string $frequency The frequency in which the action should run.
* @return void
*/
private function schedule_email_reporting( $frequency = 'monthly' ) {
$interval_days = Email_Reports::get_period_from_frequency( $frequency );
$midnight = strtotime( 'tomorrow midnight' );
as_schedule_recurring_action( $midnight, $interval_days * DAY_IN_SECONDS, 'rank_math/analytics/email_report_event', [], 'rank-math' );
}
}