0 Day Analytics – WP Panel Module Developer Documentation

<?php
namespace ADVAN\Helpers;

class WP_Panel {
    public const PAGE_SLUG     = ADVAN_INNER_SLUG . '_page_advan_wp_panel';  // Screen base
    public const MENU_SLUG     = 'advan_wp_panel';                           // Submenu slug
    public const OPTION_NAME   = ADVAN_PREFIX . 'wp_panel_settings';         // wp_options key

    private const SAVE_ACTION   = 'advan_wp_panel_save';                     // admin_post action
    private const NONCE_ACTION  = 'advan_wp_panel_nonce';                    // Nonce action string
    private const NONCE_FIELD   = '_advan_wp_panel_nonce';                   // Nonce field name
    private const LAST_LOGIN_META = '_advan_last_login';                     // User meta key
}

<?php
public static function get_defaults(): array {
    return array(
        // Content & editing — all boolean, default false.
        'disable_comments'              => false,
        'disable_post_revisions'        => false,
        'post_revisions_limit'          => 10,    // int, 1–100
        'disable_autosave'              => false,
        'disable_block_editor'          => false,
        'disable_file_editing'          => false,

        // Security & API — all boolean, default false.
        'disable_xmlrpc'                => false,
        'disable_rest_api_public'       => false,
        'disable_application_passwords' => false,
        // ... 7 more boolean keys ...

        // Updates — all boolean, default false.
        'disable_auto_updates_core'     => false,
        // ... 3 more keys ...

        // Front-end / performance — all boolean, default false.
        'disable_emojis'                => false,
        // ... 7 more keys ...

        // Dequeue frontend assets — all boolean, default false.
        'dequeue_wp_embed'              => false,
        // ... 8 more keys ...

        // Media — boolean.
        'disable_attachment_pages'      => false,

        // Admin — boolean.
        'disable_admin_bar_frontend'    => false,

        // Heartbeat control.
        'heartbeat_control'             => 'default', // 'default' | 'disable' | 'modify'
        'heartbeat_frequency'           => 60,        // int, 15–300
        'heartbeat_admin_disable'       => false,
        'heartbeat_editor_disable'      => false,
        'heartbeat_frontend_disable'    => false,

        // WP back-end extend.
        'enable_last_login_column'      => false,
        'enable_registration_date_column' => false,
    );
}

<?php
\wp_safe_redirect(
    \add_query_arg(
        array(
            'page'    => self::MENU_SLUG,
            'updated' => '1',
        ),
        \admin_url( 'admin.php' )
    )
);
exit;

<?php
// Get all WP Panel settings (merged with defaults).
$settings = \ADVAN\Helpers\WP_Panel::get_settings();

// Check a specific setting.
if ( ! empty( $settings['disable_comments'] ) ) {
    // Comments are disabled.
}

// Get raw stored value (without defaults).
$raw = get_option( \ADVAN\Helpers\WP_Panel::OPTION_NAME, array() );

<?php
// 1. Settings tab (wp-panel.php) registers checkbox:
//    Option ID: 'wp_panel_module_enabled'
//    Default:   true (enabled)

// 2. Main plugin class checks this setting:
// In class-advanced-analytics.php:
if ( Settings::get_option( 'wp_panel_module_enabled' ) ) {
    WP_Panel::init();
}

// 3. Menu registration (in class-settings.php):
if ( get_option( 'wp_panel_module_enabled' ) ) {
    WP_Panel::menu_add();
}

<?php
// Check if a specific WP Panel setting is active.
$settings = \ADVAN\Helpers\WP_Panel::get_settings();

if ( ! empty( $settings['disable_comments'] ) ) {
    // Comments are disabled via WP Panel.
}

<?php
// Check if the WP Panel module is enabled.
$module_enabled = \ADVAN\Helpers\Settings::get_option( 'wp_panel_module_enabled' );

if ( $module_enabled ) {
    // WP Panel is active and enforcing settings.
}

<?php
// Override WP Panel settings via wp_options directly.
// Warning: This bypasses the module's sanitisation.
$settings = get_option( \ADVAN\Helpers\WP_Panel::OPTION_NAME, array() );
$settings['disable_emojis'] = true;
update_option( \ADVAN\Helpers\WP_Panel::OPTION_NAME, $settings );

<?php
/**
 * Conditionally render a comment form only if WP Panel hasn't disabled comments.
 */
function my_theme_maybe_show_comments() {
    if ( class_exists( '\ADVAN\Helpers\WP_Panel' ) ) {
        $settings = \ADVAN\Helpers\WP_Panel::get_settings();
        if ( ! empty( $settings['disable_comments'] ) ) {
            return; // WP Panel has disabled comments.
        }
    }

    comments_template();
}

<?php
/**
 * Check if the REST API is restricted to logged-in users.
 */
function is_rest_api_restricted(): bool {
    if ( ! class_exists( '\ADVAN\Helpers\WP_Panel' ) ) {
        return false;
    }

    $settings = \ADVAN\Helpers\WP_Panel::get_settings();

    return ! empty( $settings['disable_rest_api_public'] );
}

<?php
/**
 * Hook into WordPress option update to log WP Panel setting changes.
 */
\add_action( 'update_option_' . \ADVAN\Helpers\WP_Panel::OPTION_NAME, function ( $old, $new ) {
    $changes = array_diff_assoc( $new, $old );
    if ( ! empty( $changes ) ) {
        error_log( 'WP Panel settings changed: ' . \wp_json_encode( $changes ) );
    }
}, 10, 2 );

<?php
/**
 * Only enqueue jQuery in your theme if WP Panel hasn't dequeued it.
 */
add_action( 'wp_enqueue_scripts', function () {
    if ( class_exists( '\ADVAN\Helpers\WP_Panel' ) ) {
        $settings = \ADVAN\Helpers\WP_Panel::get_settings();
        if ( ! empty( $settings['dequeue_jquery'] ) ) {
            // WP Panel has dequeued jQuery; use a vanilla JS alternative.
            wp_enqueue_script( 'my-theme-vanilla', get_template_directory_uri() . '/js/vanilla.js', array(), '1.0', true );
            return;
        }
    }

    wp_enqueue_script( 'my-theme-scripts', get_template_directory_uri() . '/js/scripts.js', array( 'jquery' ), '1.0', true );
}, 20 );