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.

267 lines
6.4 KiB
PHP

<?php
/**
* The 404 Monitor Module.
*
* @since 0.9.0
* @package RankMath
* @subpackage RankMath\Monitor
* @author Rank Math <support@rankmath.com>
*/
namespace RankMath\Monitor;
use RankMath\Helper;
use RankMath\Helpers\Str;
use RankMath\Helpers\Param;
use RankMath\Traits\Ajax;
use RankMath\Traits\Hooker;
use donatj\UserAgent\UserAgentParser;
defined( 'ABSPATH' ) || exit;
/**
* Monitor class.
*/
class Monitor {
use Hooker, Ajax;
/**
* Admin object.
*
* @var Admin
*/
public $admin;
/**
* The Constructor.
*/
public function __construct() {
if ( is_admin() ) {
$this->admin = new Admin();
}
if ( Helper::is_ajax() ) {
$this->ajax( 'delete_log', 'delete_log' );
}
if ( Helper::has_cap( '404_monitor' ) && Helper::is_rest() ) {
$this->action( 'rank_math/dashboard/widget', 'dashboard_widget', 11 );
}
$this->action( $this->get_hook(), 'capture_404' );
if ( Helper::has_cap( '404_monitor' ) ) {
$this->action( 'rank_math/admin_bar/items', 'admin_bar_items', 11 );
}
}
/**
* Add stats in the admin dashboard widget.
*/
public function dashboard_widget() {
$data = DB::get_stats();
?>
<h3>
<?php esc_html_e( '404 Monitor', 'rank-math' ); ?>
<a href="<?php echo esc_url( Helper::get_admin_url( '404-monitor' ) ); ?>" 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">
<div>
<h4>
<?php esc_html_e( 'Log Count', 'rank-math' ); ?>
<span class="rank-math-tooltip"><em class="dashicons-before dashicons-editor-help"></em><span><?php esc_html_e( 'Total number of 404 pages opened by the users.', 'rank-math' ); ?></span></span>
</h4>
<strong class="text-large"><?php echo esc_html( Str::human_number( $data->total ) ); ?></strong>
</div>
<div>
<h4>
<?php esc_html_e( 'URL Hits', 'rank-math' ); ?>
<span class="rank-math-tooltip"><em class="dashicons-before dashicons-editor-help"></em><span><?php esc_html_e( 'Total number visits received on all the 404 pages.', 'rank-math' ); ?></span></span>
</h4>
<strong class="text-large"><?php echo esc_html( Str::human_number( $data->hits ) ); ?></strong>
</div>
</div>
<?php
}
/**
* Add admin bar item.
*
* @param Admin_Bar_Menu $menu Menu class instance.
*/
public function admin_bar_items( $menu ) {
$menu->add_sub_menu(
'404-monitor',
[
'title' => esc_html__( '404 Monitor', 'rank-math' ),
'href' => Helper::get_admin_url( '404-monitor' ),
'meta' => [ 'title' => esc_html__( 'Review 404 errors on your site', 'rank-math' ) ],
'priority' => 50,
]
);
}
/**
* Delete a log item.
*/
public function delete_log() {
check_ajax_referer( '404_delete_log', 'security' );
$this->has_cap_ajax( '404_monitor' );
$id = Param::request( 'log' );
if ( ! $id ) {
$this->error( esc_html__( 'No valid id found.', 'rank-math' ) );
}
DB::delete_log( $id );
$this->success( esc_html__( 'Log item successfully deleted.', 'rank-math' ) );
}
/**
* Log the request details when is_404() is true and WP's response code is *not* 410 or 451.
*/
public function capture_404() {
if ( ! is_404() || in_array( http_response_code(), [ 410, 451 ], true ) ) {
return;
}
$uri = untrailingslashit( Helper::get_current_page_url( Helper::get_settings( 'general.404_monitor_ignore_query_parameters' ) ) );
$uri = str_replace( Helper::get_home_url( '/' ), '', $uri );
// Check if excluded.
if ( $this->is_url_excluded( $uri ) ) {
return;
}
// Mode = simple.
if ( 'simple' === Helper::get_settings( 'general.404_monitor_mode' ) ) {
DB::update( [ 'uri' => $uri ] );
return;
}
// Mode = advanced.
DB::add(
[
'uri' => $uri,
'referer' => Param::server( 'HTTP_REFERER', '' ),
'user_agent' => $this->get_user_agent(),
]
);
}
/**
* Check if given URL is excluded.
*
* @param string $uri The URL to check for exclusion.
*
* @return boolean
*/
private function is_url_excluded( $uri ) {
$excludes = Helper::get_settings( 'general.404_monitor_exclude' );
if ( ! is_array( $excludes ) ) {
return false;
}
foreach ( $excludes as $rule ) {
$rule['exclude'] = empty( $rule['exclude'] ) ? '' : $this->sanitize_exclude_pattern( $rule['exclude'], $rule['comparison'] );
if ( ! empty( $rule['exclude'] ) && Str::comparison( $rule['exclude'], $uri, $rule['comparison'] ) ) {
return true;
}
}
return false;
}
/**
* Check if regex pattern has delimiters or not, and add them if not.
*
* @param string $pattern The pattern to check.
* @param string $comparison The comparison type.
*
* @return string
*/
private function sanitize_exclude_pattern( $pattern, $comparison ) {
if ( 'regex' !== $comparison ) {
return $pattern;
}
if ( preg_match( '[^(?:([^a-zA-Z0-9\\\\]).*\\1|\\(.*\\)|\\{.*\\}|\\[.*\\]|<.*>)[imsxADSUXJu]*$]', $pattern ) ) {
return $pattern;
}
return '[' . addslashes( $pattern ) . ']';
}
/**
* Get user-agent header.
*
* @return string
*/
private function get_user_agent() {
$u_agent = Param::server( 'HTTP_USER_AGENT' );
if ( empty( $u_agent ) ) {
return '';
}
$parsed = $this->parse_user_agent( $u_agent );
$nice_ua = '';
if ( ! empty( $parsed['browser'] ) ) {
$nice_ua .= $parsed['browser'];
}
if ( ! empty( $parsed['version'] ) ) {
$nice_ua .= ' ' . $parsed['version'];
}
return $nice_ua . ' | ' . $u_agent;
}
/**
* Parses a user-agent string into its parts.
*
* @link https://github.com/donatj/PhpUserAgent
*
* @param string $u_agent User agent string to parse or null. Uses $_SERVER['HTTP_USER_AGENT'] on NULL.
*
* @return string[] an array with browser, version and platform keys
*/
private function parse_user_agent( $u_agent ) {
if ( ! $u_agent ) {
return [
'platform' => null,
'browser' => null,
'version' => null,
];
}
$parser = new UserAgentParser();
$agent = $parser->parse( $u_agent );
return [
'platform' => $agent->platform(),
'browser' => $agent->browser(),
'version' => $agent->browserVersion(),
];
}
/**
* Function to get the hook name depending on the theme.
*
* @return string WP hook.
*/
private function get_hook() {
if ( defined( 'CT_VERSION' ) ) {
return 'oxygen_enqueue_frontend_scripts';
}
if ( function_exists( 'wp_is_block_theme' ) && wp_is_block_theme() ) {
return 'wp_head';
}
return 'get_header';
}
}