noindex-seo/noindex-seo.php
2026-06-02 16:50:35 +00:00

2246 lines
79 KiB
PHP

<?php
/**
* Plugin Name: noindex SEO
* Plugin URI: https://wordpress.org/plugins/noindex-seo/
* Description: Control search engine indexing with robots directives (noindex, nofollow, noarchive, nosnippet, noimageindex) for specific parts of your WordPress site.
* Requires at least: 5.7
* Requires PHP: 7.2
* Version: 2.0.1
* Author: ROBOTSTXT
* Author URI: https://www.robotstxt.es/
* License: GPL-3.0-or-later
* License URI: https://www.gnu.org/licenses/gpl-3.0.txt
* Text Domain: noindex-seo
* Domain Path: /languages
*
* @package noindex-seo
*/
declare(strict_types=1);
defined( 'ABSPATH' ) || die( 'Bye bye!' );
/**
* Plugin version constant. Used for asset cache-busting and internal version checks.
*
* @since 2.0.1
*/
define( 'NOINDEX_SEO_VERSION', '2.0.1' );
/**
* Outputs robots directives using the configured implementation method.
*
* This function adds robots directives (noindex, nofollow, noarchive, nosnippet, noimageindex)
* to instruct search engines how to handle the current page. It supports three implementation methods:
*
* - 'meta': HTML meta tags via wp_robots filter (default)
* - 'header': HTTP X-Robots-Tag header
* - 'both': Both HTML meta tags and HTTP headers
*
* The HTTP header method is more robust and works with non-HTML content (PDFs, images, feeds).
* The meta tag method is more visible and easier for users to verify.
*
* @since 1.1.0
* @since 2.0.0 Removed fallback for WordPress < 5.7. Requires WP 5.7+ (the 6.6 minimum in the 2.0.0 header was overly conservative; corrected in 2.0.1).
* @since 2.0.0 Added support for HTTP X-Robots-Tag headers and multiple implementation methods.
* @since 2.0.0 Added support for multiple directives (noindex, nofollow, noarchive, nosnippet, noimageindex).
*
* @see https://developer.wordpress.org/reference/hooks/wp_robots/
* @see https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag
*
* @param string $method Implementation method: 'meta', 'header', or 'both'. Default 'meta'.
* @param array<int, string> $directives Array of directives to apply. Default array('noindex').
* @return void
*/
function noindex_seo_metarobots( string $method = 'meta', array $directives = array( 'noindex' ) ): void {
// Sanitize method.
$valid_methods = array( 'meta', 'header', 'both' );
$method = in_array( $method, $valid_methods, true ) ? $method : 'meta';
// Sanitize directives.
$valid_directives = array( 'noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
$directives = array_intersect( $directives, $valid_directives );
if ( empty( $directives ) ) {
return; // No valid directives to apply.
}
// Send HTTP header if requested.
$header_sent = false;
if ( in_array( $method, array( 'header', 'both' ), true ) ) {
if ( ! headers_sent() ) {
$header_value = implode( ', ', $directives );
header( 'X-Robots-Tag: ' . $header_value, false );
$header_sent = true;
}
}
// Add HTML meta tag if requested, or as fallback if headers already sent.
$use_meta = in_array( $method, array( 'meta', 'both' ), true );
$fallback_needed = in_array( $method, array( 'header', 'both' ), true ) && ! $header_sent;
if ( $use_meta || $fallback_needed ) {
add_filter(
'wp_robots',
function ( array $robots ) use ( $directives ): array {
foreach ( $directives as $directive ) {
$robots[ $directive ] = true;
}
return $robots;
},
99 // High priority to ensure our directives take precedence over other plugins.
);
}
}
/**
* Clear all robots directive meta values for a post.
*
* This helper function deletes all robots directive post meta fields for a given post ID.
* Used when disabling granular control override or resetting directive settings.
*
* @since 2.0.0
*
* @param int $post_id The post ID to clear directives for.
* @return void
*/
function noindex_seo_clear_post_directives( int $post_id ): void {
$directives = array( 'noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
foreach ( $directives as $directive ) {
delete_post_meta( $post_id, '_noindex_seo_' . $directive );
}
}
/**
* Determines whether to output robots directives based on page context and plugin settings.
*
* This function checks the current page context (e.g., single post, category archive, 404 page, etc.)
* and evaluates plugin settings to determine which robots directives (noindex, nofollow, noarchive,
* nosnippet, noimageindex) should be added.
*
* It retrieves settings efficiently using a transient cache. If the cache is not set, it pulls values
* from the WordPress options API and rebuilds the cache.
*
* The list of contexts can be filtered via the {@see 'noindex_seo_contexts'} filter.
* Once a matching context is found, it calls {@see noindex_seo_metarobots()} to apply the directives.
*
* @since 1.1.0
* @since 2.0.0 Added support for multiple directives (noindex, nofollow, noarchive, nosnippet, noimageindex).
*
* @global WP_Post $post The global post object, if available.
*
* @return void
*/
function noindex_seo_show(): void {
/**
* Filter the contexts and corresponding option keys used for robots directives.
*
* Custom option keys MUST follow the pattern `noindex_seo_{context}`.
* Directive option keys for non-noindex directives are derived by replacing
* the leading `noindex` with the directive name via str_replace(), e.g.
* `noindex_seo_single` → `nofollow_seo_single`. Keys that do not start with
* `noindex_seo_` are silently discarded.
*
* @since 1.0.0
*
* @param array<string, string> $contexts Associative array of context slug => option_key.
*/
$contexts = apply_filters(
'noindex_seo_contexts',
array(
'single' => 'noindex_seo_single',
'page' => 'noindex_seo_page',
'privacy_policy' => 'noindex_seo_privacy_policy',
'attachment' => 'noindex_seo_attachment',
'category' => 'noindex_seo_category',
'tag' => 'noindex_seo_tag',
'author' => 'noindex_seo_author',
'post_type_archive' => 'noindex_seo_post_type_archive',
'date' => 'noindex_seo_date',
'day' => 'noindex_seo_day',
'month' => 'noindex_seo_month',
'year' => 'noindex_seo_year',
'archive' => 'noindex_seo_archive',
'search' => 'noindex_seo_search',
'error' => 'noindex_seo_error',
'front_page' => 'noindex_seo_front_page',
'home' => 'noindex_seo_home',
'singular' => 'noindex_seo_singular',
'paged' => 'noindex_seo_paged',
'preview' => 'noindex_seo_preview',
'customize_preview' => 'noindex_seo_customize_preview',
'time' => 'noindex_seo_time',
)
);
// Validate filtered contexts to prevent injection of invalid option names.
// phpstan-wordpress types apply_filters() based on its default argument (array).
// The cast below ensures runtime safety if a filter callback returns a non-array.
foreach ( (array) $contexts as $context => $option_key ) {
// Ensure option_key follows expected pattern.
// is_string() check is omitted: PHPStan guarantees $option_key is string
// because apply_filters returns array<string,string> based on its default argument.
if ( 0 !== strpos( $option_key, 'noindex_seo_' ) ) {
unset( $contexts[ $context ] );
}
}
// PRIORITY 1: Check for per-post/page override (granular control).
// If granular control is enabled and we're on a singular post/page,
// check if there's an override for this specific content.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( $granular_enabled && is_singular() ) {
$post_id = get_queried_object_id();
if ( $post_id ) {
$override = get_post_meta( $post_id, '_noindex_seo_override', true );
if ( $override ) {
// Collect active directives from post meta.
$post_directives = array();
$available_directives = array( 'noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
foreach ( $available_directives as $directive ) {
$meta_value = get_post_meta( $post_id, '_noindex_seo_' . $directive, true );
// Explicitly check for 1 or '1' to avoid false positives with '0' string.
if ( is_scalar( $meta_value ) && 1 === absint( $meta_value ) ) {
$post_directives[] = $directive;
}
}
// Apply post-specific directives if any are enabled.
if ( ! empty( $post_directives ) ) {
$opt = get_option( 'noindex_seo_config_method', 'meta' );
$implementation_method = is_string( $opt ) ? $opt : 'meta';
noindex_seo_metarobots( $implementation_method, $post_directives );
return; // Exit early - post meta takes precedence over global settings.
}
}
}
}
// PRIORITY 2: Apply global settings (existing behavior).
// Try to get the options from the transient.
$options = get_transient( 'noindex_seo_options' );
// Available directives.
$available_directives = array( 'noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
if ( false === $options || ! is_array( $options ) || empty( $options ) ) {
// Transient not set, retrieve options from the database.
$options = array();
foreach ( $contexts as $context => $option_key ) {
// Load all directives for each context.
foreach ( $available_directives as $directive ) {
$directive_key = str_replace( 'noindex', $directive, (string) $option_key );
$options[ $directive_key ] = get_option( $directive_key, 0 );
}
}
// Set the transient for 1 hour to cache the options.
set_transient( 'noindex_seo_options', $options, HOUR_IN_SECONDS );
}
// Define current conditions, ordered from most specific to most general.
// Note on 'date' context: is_date() returns true for any date-based archive (day/month/year/time).
// In normal WordPress, if is_date() is true, at least one specific date function should also be true.
// However, this catch-all condition is kept for edge cases, custom implementations, or future
// WordPress versions that might introduce new date archive types not covered by the specific functions.
// While this condition may rarely (or never) be true in practice, it provides defensive coverage.
$current_conditions = array(
'single' => is_single(),
'page' => is_page(),
'attachment' => is_attachment(),
'privacy_policy' => is_privacy_policy(),
'category' => is_category(),
'tag' => is_tag(),
'author' => is_author(),
'post_type_archive' => is_post_type_archive(),
'day' => is_day(),
'month' => is_month(),
'year' => is_year(),
'time' => is_time(),
'date' => is_date() && ! ( is_day() || is_month() || is_year() || is_time() ), // Catch-all for date archives.
'archive' => is_archive() && ! ( is_category() || is_tag() || is_author() || is_post_type_archive() || is_date() ),
'search' => is_search(),
'error' => is_404(),
'front_page' => is_front_page() && ! is_paged() && ! is_home(),
'home' => is_home() && ! is_paged(),
'singular' => is_singular() && ! ( is_single() || is_page() || is_attachment() ),
'paged' => is_paged() && ! is_front_page() && ! is_home(),
'preview' => is_preview(),
'customize_preview' => is_customize_preview(),
);
// Get implementation method configuration.
$opt = get_option( 'noindex_seo_config_method', 'meta' );
$implementation_method = is_string( $opt ) ? $opt : 'meta';
// Iterate through the contexts and collect active directives.
foreach ( $contexts as $context => $option_key ) {
if (
isset( $current_conditions[ $context ] ) &&
$current_conditions[ $context ]
) {
// Collect all active directives for this context.
$active_directives = array();
foreach ( $available_directives as $directive ) {
$directive_key = str_replace( 'noindex', $directive, (string) $option_key );
if ( isset( $options[ $directive_key ] ) && (bool) $options[ $directive_key ] ) {
$active_directives[] = $directive;
}
}
// Apply directives if any are active.
if ( ! empty( $active_directives ) ) {
noindex_seo_metarobots( $implementation_method, $active_directives );
break; // Prevent multiple meta tags from being added.
}
}
}
unset( $contexts, $options, $current_conditions, $available_directives );
}
/**
* Checks if configuration migration is needed and executes it.
*
* This function runs on plugin load and checks the configuration version stored in the database.
* If the version is less than 2 (or doesn't exist), it migrates old single-directive options
* to the new multi-directive system introduced in version 2.0.
*
* @since 2.0.0
*
* @return void
*/
function noindex_seo_check_migration(): void {
$current_config_version = get_option( 'noindex_seo_config_version', 0 );
// Check if we need to migrate to version 2.
if ( $current_config_version < 2 ) {
noindex_seo_migrate_to_v2();
}
}
/**
* Migrates configuration from version 1.x to version 2.0.
*
* Version 1.x had single options per context (e.g., noindex_seo_attachment).
* Version 2.0 has 5 independent directives per context (e.g., noindex_seo_attachment,
* nofollow_seo_attachment, noarchive_seo_attachment, etc.).
*
* This function:
* 1. Reads existing noindex_seo_* options
* 2. Preserves their values (they're already in the correct format)
* 3. Initializes new directive options (nofollow, noarchive, nosnippet, noimageindex) to 0
* 4. Marks migration as complete by setting config version to 2
* 5. Clears the transient cache
*
* @since 2.0.0
*
* @return void
*/
function noindex_seo_migrate_to_v2(): void {
$contexts = array(
'error',
'archive',
'attachment',
'author',
'category',
'comment_feed',
'customize_preview',
'date',
'day',
'feed',
'front_page',
'home',
'month',
'page',
'paged',
'post_type_archive',
'preview',
'privacy_policy',
'robots',
'search',
'single',
'singular',
'tag',
'time',
'year',
);
$new_directives = array( 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
// For each context, initialize new directives to 0.
// The noindex directive already exists and will keep its value.
foreach ( $contexts as $context ) {
foreach ( $new_directives as $directive ) {
$option_key = $directive . '_seo_' . $context;
// Only set if it doesn't exist (shouldn't exist in v1.x).
if ( false === get_option( $option_key ) ) {
add_option( $option_key, 0 );
}
}
}
// Mark migration as complete.
update_option( 'noindex_seo_config_version', 2 );
// Clear transient cache.
delete_transient( 'noindex_seo_options' );
}
add_action( 'template_redirect', 'noindex_seo_show' );
add_filter( 'plugin_action_links_' . plugin_basename( __FILE__ ), 'noindex_seo_settings_link' );
add_action( 'admin_init', 'noindex_seo_register' );
add_action( 'admin_menu', 'noindex_seo_menu' );
add_action( 'admin_enqueue_scripts', 'noindex_seo_enqueue_admin_assets' );
add_action( 'plugins_loaded', 'noindex_seo_check_migration' );
/**
* Enqueues admin CSS and JavaScript assets.
*
* Loads the modern admin panel styles and interactive JavaScript only on the
* noindex SEO settings page for better performance.
*
* @since 2.0.0
*
* @param string $hook The current admin page hook.
* @return void
*/
function noindex_seo_enqueue_admin_assets( string $hook ): void {
// Only load on our settings page..
if ( 'settings_page_noindex_seo' !== $hook ) {
return;
}
// Enqueue admin CSS..
wp_enqueue_style(
'noindex-seo-admin',
plugins_url( 'assets/css/admin.css', __FILE__ ),
array(),
NOINDEX_SEO_VERSION,
'all'
);
// Enqueue admin JavaScript..
wp_enqueue_script(
'noindex-seo-admin',
plugins_url( 'assets/js/admin.js', __FILE__ ),
array( 'jquery' ),
NOINDEX_SEO_VERSION,
true
);
// Localize script with translations..
wp_localize_script(
'noindex-seo-admin',
'noindexSeoAdmin',
array(
'successMessage' => __( 'Settings saved successfully!', 'noindex-seo' ),
'expandAll' => __( 'Expand All', 'noindex-seo' ),
'collapseAll' => __( 'Collapse All', 'noindex-seo' ),
)
);
}
/**
* Enqueue Gutenberg sidebar panel assets.
*
* Loads the JavaScript for the native Gutenberg sidebar panel
* that allows editing robots directives in the Block Editor.
*
* @since 2.0.0
*
* @return void
*/
function noindex_seo_enqueue_editor_assets(): void {
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return;
}
// Get the current screen.
$screen = get_current_screen();
// Only load in block editor for supported post types.
if ( ! $screen || ! $screen->is_block_editor() ) {
return;
}
// Enqueue editor sidebar script.
wp_enqueue_script(
'noindex-seo-editor-sidebar',
plugins_url( 'assets/js/editor-sidebar.js', __FILE__ ),
array(
'wp-plugins',
'wp-edit-post',
'wp-element',
'wp-components',
'wp-data',
'wp-i18n',
),
NOINDEX_SEO_VERSION,
true
);
// Set up translations for the script.
wp_set_script_translations(
'noindex-seo-editor-sidebar',
'noindex-seo'
);
}
add_action( 'enqueue_block_editor_assets', 'noindex_seo_enqueue_editor_assets' );
/**
* Adds a "Settings" link to the plugin row actions on the Plugins admin screen.
*
* This function appends a direct link to the plugin's settings page within the list of action links
* shown for the plugin on the Plugins page (`/wp-admin/plugins.php`). This improves user accessibility
* by allowing quick access to the plugin's configuration page.
*
* Hooked to the {@see 'plugin_action_links_{plugin_basename}'} filter.
*
* @since 1.0.0
*
* @param array<string|int, string> $links Array of existing action links for the plugin.
* @return array<string|int, string> Modified array including the "Settings" link.
*/
function noindex_seo_settings_link( array $links ): array {
$settings_link = '<a href="' . esc_url( admin_url( 'options-general.php?page=noindex_seo' ) ) . '">' . esc_html__( 'Settings', 'noindex-seo' ) . '</a>';
$links[] = $settings_link;
return $links;
}
/**
* Registers the "noindex SEO" settings page in the WordPress admin menu.
*
* This function adds an entry under the "Settings" menu in the WordPress admin area,
* which links to the plugin's main configuration page. The settings page is only accessible
* to users with the 'manage_options' capability.
*
* Internally uses {@see add_options_page()} to register the page.
*
* @since 1.0.0
*
* @return void
*/
function noindex_seo_menu(): void {
add_options_page(
__( 'noindex SEO', 'noindex-seo' ),
__( 'noindex SEO', 'noindex-seo' ),
'manage_options',
'noindex_seo',
'noindex_seo_admin'
);
}
/**
* Registers all settings used by the 'noindex SEO' plugin.
*
* This function registers individual options for each context and directive combination.
* Each context (e.g., single posts, category pages, archives, etc.) can have multiple
* directives (noindex, nofollow, noarchive, nosnippet, noimageindex) applied independently.
*
* Each setting is stored as an integer (0 or 1), where 1 indicates that the directive is enabled
* for that context.
*
* All settings are grouped under the option group 'noindexseo' and will be handled by the
* WordPress Settings API when the options form is submitted.
*
* Also registers the general configuration options.
* A transient cache is cleared upon update using the {@see 'update_option_noindexseo'} action.
*
* @since 1.0.0
* @since 2.0.0 Added support for multiple directives per context.
*
* @return void
*/
function noindex_seo_register(): void {
$contexts = array(
'error',
'archive',
'attachment',
'author',
'category',
'comment_feed',
'customize_preview',
'date',
'day',
'feed',
'front_page',
'home',
'month',
'page',
'paged',
'post_type_archive',
'preview',
'privacy_policy',
'robots',
'search',
'single',
'singular',
'tag',
'time',
'year',
);
$directives = array( 'noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
// Register each directive for each context.
foreach ( $contexts as $context ) {
foreach ( $directives as $directive ) {
register_setting(
'noindexseo',
$directive . '_seo_' . $context,
array(
'type' => 'integer',
'default' => 0,
)
);
}
}
register_setting(
'noindexseo',
'noindex_seo_config_seoplugins',
array(
'type' => 'integer',
'default' => 0,
)
);
register_setting(
'noindexseo',
'noindex_seo_config_method',
array(
'type' => 'string',
'default' => 'meta',
'sanitize_callback' => function ( $value ): string {
return in_array( $value, array( 'meta', 'header', 'both' ), true ) ? $value : 'meta';
},
)
);
register_setting(
'noindexseo',
'noindex_seo_config_granular',
array(
'type' => 'integer',
'default' => 0,
)
);
register_setting(
'noindexseo',
'noindex_seo_config_delete_on_uninstall',
array(
'type' => 'integer',
'default' => 0,
)
);
// NOTE: 'noindexseo' is the Settings API *group* name, not an option name.
// update_option_noindexseo would never fire; the transient is cleared explicitly
// inside noindex_seo_process_form() after every successful form save.
}
/**
* Clears the cached plugin settings stored in the transient.
*
* This function deletes the 'noindex_seo_options' transient to ensure that updated
* option values are fetched fresh from the database on the next request. It is typically
* triggered after the plugin settings are updated to prevent stale data from being used.
*
* Hooked to the {@see 'update_option_noindexseo'} action.
*
* @since 1.0.0
* @since 2.0.0 Added admin context verification for security.
*
* @return void
*/
function noindex_seo_clear_transient(): void {
// Verify we're in a valid admin context..
if ( ! is_admin() && ! wp_doing_ajax() ) {
return;
}
// Delete the transient cache..
delete_transient( 'noindex_seo_options' );
}
/**
* Detects potential conflicts with other SEO plugins and displays an admin notice.
*
* This function checks for the presence of known SEO plugins that may conflict with
* the functionality of 'noindex SEO'. If a conflicting plugin is active and the user
* has not opted to suppress warnings (via the 'noindex_seo_config_seoplugins' option),
* a dismissible admin notice is displayed to alert the site administrator.
*
* The list of conflicting plugins includes popular SEO tools such as Yoast SEO, Rank Math,
* SEOPress, and others. The check is performed using {@see is_plugin_active()}.
*
* Hooked to the {@see 'admin_init'} action.
*
* @since 1.1.0
*
* @return void
*/
function noindex_seo_detect_conflicts(): void {
$option_config_seoplugins = get_option( 'noindex_seo_config_seoplugins', 0 );
if ( ! ( is_scalar( $option_config_seoplugins ) ? absint( $option_config_seoplugins ) : 0 ) ) {
// Include the plugin.php file if the function is not available..
if ( ! function_exists( 'is_plugin_active' ) ) {
include_once ABSPATH . 'wp-admin/includes/plugin.php';
}
// Define an associative array of conflicting plugins: slug/file => real plugin name..
$conflicting_plugins = array(
'all-in-one-seo-pack/all_in_one_seo_pack.php' => 'All in One SEO',
'premium-seo-pack/index.php' => 'Premium SEO Pack',
'seo-by-rank-math/rank-math.php' => 'Rank Math SEO',
'wp-seopress/seopress.php' => 'SEOPress',
'slim-seo/slim-seo.php' => 'Slim SEO',
'squirrly-seo/squirrly.php' => 'Squirrly SEO',
'autodescription/autodescription.php' => 'The SEO Framework',
'wordpress-seo/wp-seo.php' => 'Yoast SEO',
);
// Iterate through the conflicting plugins to check if any are active..
foreach ( $conflicting_plugins as $plugin_path => $plugin_name ) {
if ( is_plugin_active( $plugin_path ) ) {
// Add an admin notice if a conflicting plugin is active..
add_action(
'admin_notices',
function () use ( $plugin_name ) {
echo '<div class="notice notice-warning is-dismissible"><p>';
// translators: plugin name.
printf( esc_html__( 'noindex SEO has detected that %s is active. This may cause conflicts. Please configure the options accordingly.', 'noindex-seo' ), esc_html( $plugin_name ) );
echo '</p></div>';
}
);
break; // Stop checking after finding the first conflict.
}
}
}
}
add_action( 'admin_init', 'noindex_seo_detect_conflicts' );
/**
* Processes the form submission for the 'noindex SEO' plugin settings.
*
* This function handles the saving of plugin options submitted from the custom admin form.
* It first verifies the current user's capability and nonce for security. Then it resets all
* registered options to `0`, and selectively updates those submitted as checked in the form.
*
* Additionally, it updates the general configuration settings,
* clears the plugin's transient cache, and redirects back to the settings page.
*
* Hooked to the {@see 'admin_post_update_noindex_seo'} action.
*
* @since 1.2.0
* @since 2.0.0 Added support for multiple directives (noindex, nofollow, noarchive, nosnippet, noimageindex).
*
* @return void
*/
function noindex_seo_process_form(): void {
if ( ! current_user_can( 'manage_options' ) || ! check_admin_referer( 'update_noindex_seo_nonce' ) ) {
wp_die( esc_html__( 'Permission denied or invalid nonce.', 'noindex-seo' ) );
}
$contexts = array(
'error',
'archive',
'attachment',
'author',
'category',
'comment_feed',
'customize_preview',
'date',
'day',
'feed',
'front_page',
'home',
'month',
'page',
'paged',
'post_type_archive',
'preview',
'privacy_policy',
'robots',
'search',
'single',
'singular',
'tag',
'time',
'year',
);
$directives = array( 'noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
// Get the implementation method to validate field compatibility.
$method_value = ( isset( $_POST['noindex_seo_config_method'] ) && is_string( $_POST['noindex_seo_config_method'] ) )
? sanitize_text_field( wp_unslash( $_POST['noindex_seo_config_method'] ) )
: 'meta';
// Validate method.
$method_value = in_array( $method_value, array( 'meta', 'header', 'both' ), true ) ? $method_value : 'meta';
// Fields that only work with HTTP headers.
$header_only_contexts = array( 'attachment', 'feed', 'comment_feed' );
$is_header_enabled = in_array( $method_value, array( 'header', 'both' ), true );
// Reset all options to 0 and process form data.
foreach ( $contexts as $context ) {
// Validate context is in our allowed list (defense in depth).
if ( ! in_array( $context, $contexts, true ) ) {
continue; // Skip invalid context.
}
foreach ( $directives as $directive ) {
// Validate directive is in our allowed list (defense in depth).
if ( ! in_array( $directive, $directives, true ) ) {
continue; // Skip invalid directive.
}
$option_key = $directive . '_seo_' . $context;
$option_value = ( isset( $_POST[ $option_key ] ) && is_string( $_POST[ $option_key ] ) ) ? sanitize_text_field( wp_unslash( $_POST[ $option_key ] ) ) : '';
// Additional validation: only accept '1' or empty string.
if ( '' !== $option_value && '1' !== $option_value ) {
$option_value = ''; // Invalid value, treat as unchecked.
}
// Validate: header-only contexts require header implementation method.
if ( in_array( $context, $header_only_contexts, true ) && ! $is_header_enabled ) {
// Force to 0 - this context doesn't work with current method.
update_option( $option_key, 0 );
continue;
}
// Only set to 1 if the checkbox was actually checked (value should be "1").
if ( '1' === $option_value ) {
update_option( $option_key, 1 );
} else {
update_option( $option_key, 0 );
}
}
}
// Save general configuration option..
$config_value = ( isset( $_POST['noindex_seo_config_seoplugins'] ) && is_string( $_POST['noindex_seo_config_seoplugins'] ) )
? absint( $_POST['noindex_seo_config_seoplugins'] )
: 0;
// Ensure value is either 0 or 1..
$config_value = ( 1 === $config_value ) ? 1 : 0;
update_option( 'noindex_seo_config_seoplugins', $config_value );
// Save implementation method configuration (already validated above).
update_option( 'noindex_seo_config_method', $method_value );
// Save granular control configuration.
$granular_value = ( isset( $_POST['noindex_seo_config_granular'] ) && is_string( $_POST['noindex_seo_config_granular'] ) )
? absint( $_POST['noindex_seo_config_granular'] )
: 0;
$granular_value = ( 1 === $granular_value ) ? 1 : 0;
update_option( 'noindex_seo_config_granular', $granular_value );
// Save delete-on-uninstall configuration.
$delete_value = ( isset( $_POST['noindex_seo_config_delete_on_uninstall'] ) && is_string( $_POST['noindex_seo_config_delete_on_uninstall'] ) )
? absint( $_POST['noindex_seo_config_delete_on_uninstall'] )
: 0;
$delete_value = ( 1 === $delete_value ) ? 1 : 0;
update_option( 'noindex_seo_config_delete_on_uninstall', $delete_value );
// Clear cache..
delete_transient( 'noindex_seo_options' );
wp_safe_redirect( admin_url( 'options-general.php?page=noindex_seo&updated=true' ) );
exit;
}
add_action( 'admin_post_update_noindex_seo', 'noindex_seo_process_form' );
/**
* Register post meta for REST API and Gutenberg support.
*
* Registers all robots directive post meta fields with REST API support
* to enable Gutenberg sidebar panel to read and write values.
*
* @since 2.0.0
*
* @return void
*/
function noindex_seo_register_post_meta(): void {
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return;
}
// Get all public post types.
$post_types = get_post_types( array( 'public' => true ), 'names' );
// Meta fields to register.
$meta_fields = array(
'_noindex_seo_override',
'_noindex_seo_noindex',
'_noindex_seo_nofollow',
'_noindex_seo_noarchive',
'_noindex_seo_nosnippet',
'_noindex_seo_noimageindex',
);
// Register each meta field for each post type.
foreach ( $post_types as $post_type ) {
foreach ( $meta_fields as $meta_key ) {
register_post_meta(
$post_type,
$meta_key,
array(
'show_in_rest' => true,
'single' => true,
'type' => 'integer',
'default' => 0,
'auth_callback' => function () {
return current_user_can( 'edit_posts' );
},
)
);
}
}
}
add_action( 'init', 'noindex_seo_register_post_meta' );
/**
* Register meta boxes for granular per-post/page control.
*
* Only registers meta boxes if granular control is enabled in settings.
* Adds meta box to all public post types (posts, pages, custom post types).
*
* @since 2.0.0
*
* @return void
*/
function noindex_seo_add_meta_boxes(): void {
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return;
}
// Get all public post types.
$post_types = get_post_types( array( 'public' => true ), 'names' );
// Add meta box to each public post type.
foreach ( $post_types as $post_type ) {
add_meta_box(
'noindex_seo_meta_box',
__( 'Search Engine Visibility', 'noindex-seo' ),
'noindex_seo_render_meta_box',
$post_type,
'side',
'default'
);
}
}
add_action( 'add_meta_boxes', 'noindex_seo_add_meta_boxes' );
/**
* Render the meta box content for per-post/page control.
*
* Displays a checkbox to override global settings and 5 directive checkboxes.
* Shows current global settings as reference.
*
* @since 2.0.0
*
* @param WP_Post $post The current post object.
* @return void
*/
function noindex_seo_render_meta_box( WP_Post $post ): void {
// Add nonce for security.
wp_nonce_field( 'noindex_seo_meta_box', 'noindex_seo_meta_box_nonce' );
// Get current post meta values.
$override = get_post_meta( $post->ID, '_noindex_seo_override', true );
$noindex = get_post_meta( $post->ID, '_noindex_seo_noindex', true );
$nofollow = get_post_meta( $post->ID, '_noindex_seo_nofollow', true );
$noarchive = get_post_meta( $post->ID, '_noindex_seo_noarchive', true );
$nosnippet = get_post_meta( $post->ID, '_noindex_seo_nosnippet', true );
$noimageindex = get_post_meta( $post->ID, '_noindex_seo_noimageindex', true );
// Get global settings for reference.
$global_directives = array();
$directives = array( 'noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
// Determine which context applies to this post type.
$post_type = get_post_type( $post );
$context = ( 'page' === $post_type ) ? 'page' : 'single';
foreach ( $directives as $directive ) {
$option_key = $directive . '_seo_' . $context;
if ( get_option( $option_key, 0 ) ) {
$global_directives[] = $directive;
}
}
?>
<div class="noindex-seo-meta-box">
<p style="margin-top: 0;">
<label>
<input type="checkbox" name="noindex_seo_override" value="1" <?php checked( 1, $override ); ?> id="noindex-seo-override-toggle">
<strong><?php esc_html_e( 'Override global settings', 'noindex-seo' ); ?></strong>
</label>
</p>
<p class="description" style="margin: 8px 0 12px 0; font-size: 12px; line-height: 1.4;">
<?php esc_html_e( 'When enabled, these directives will override the global settings for this specific content.', 'noindex-seo' ); ?>
</p>
<div id="noindex-seo-directives-container" style="<?php echo $override ? '' : 'display: none;'; ?>">
<div style="border-top: 1px solid #ddd; padding-top: 12px; margin-bottom: 12px;">
<label style="display: flex; align-items: center; margin-bottom: 8px;">
<input type="checkbox" name="noindex_seo_noindex" value="1" <?php checked( 1, $noindex ); ?> style="margin: 0 8px 0 0;">
<span><strong>🔍 noindex</strong> — <?php esc_html_e( 'Prevent indexing', 'noindex-seo' ); ?></span>
</label>
<label style="display: flex; align-items: center; margin-bottom: 8px;">
<input type="checkbox" name="noindex_seo_nofollow" value="1" <?php checked( 1, $nofollow ); ?> style="margin: 0 8px 0 0;">
<span><strong>🔗 nofollow</strong> — <?php esc_html_e( 'Prevent link following', 'noindex-seo' ); ?></span>
</label>
<label style="display: flex; align-items: center; margin-bottom: 8px;">
<input type="checkbox" name="noindex_seo_noarchive" value="1" <?php checked( 1, $noarchive ); ?> style="margin: 0 8px 0 0;">
<span><strong>💾 noarchive</strong> — <?php esc_html_e( 'Prevent caching', 'noindex-seo' ); ?></span>
</label>
<label style="display: flex; align-items: center; margin-bottom: 8px;">
<input type="checkbox" name="noindex_seo_nosnippet" value="1" <?php checked( 1, $nosnippet ); ?> style="margin: 0 8px 0 0;">
<span><strong>📄 nosnippet</strong> — <?php esc_html_e( 'Prevent snippets', 'noindex-seo' ); ?></span>
</label>
<label style="display: flex; align-items: center; margin-bottom: 8px;">
<input type="checkbox" name="noindex_seo_noimageindex" value="1" <?php checked( 1, $noimageindex ); ?> style="margin: 0 8px 0 0;">
<span><strong>🖼️ noimageindex</strong> — <?php esc_html_e( 'Prevent image indexing', 'noindex-seo' ); ?></span>
</label>
</div>
</div>
<!-- Information Section -->
<div style="margin-top: 12px; padding: 10px; background: #f9f9f9; border: 1px solid #e0e0e0; border-radius: 4px;">
<p style="margin: 0 0 8px 0; font-size: 11px; font-weight: 600; color: #333;">
<?php esc_html_e( 'Effective Directives:', 'noindex-seo' ); ?>
</p>
<?php if ( $override ) : ?>
<?php
// Show what will be applied with override.
$active_directives = array();
if ( $noindex ) {
$active_directives[] = 'noindex';
}
if ( $nofollow ) {
$active_directives[] = 'nofollow';
}
if ( $noarchive ) {
$active_directives[] = 'noarchive';
}
if ( $nosnippet ) {
$active_directives[] = 'nosnippet';
}
if ( $noimageindex ) {
$active_directives[] = 'noimageindex';
}
?>
<?php if ( ! empty( $active_directives ) ) : ?>
<p style="margin: 0 0 4px 0; padding: 6px; background: #e3f2fd; border-left: 3px solid #2196f3; font-size: 11px;">
<strong style="color: #1976d2;"><?php esc_html_e( 'Override active:', 'noindex-seo' ); ?></strong><br>
<code style="font-size: 10px;"><?php echo esc_html( implode( ', ', $active_directives ) ); ?></code>
</p>
<?php else : ?>
<p style="margin: 0; padding: 6px; background: #fff3cd; border-left: 3px solid #ffc107; font-size: 11px; color: #856404;">
<?php esc_html_e( 'Override enabled but no directives selected', 'noindex-seo' ); ?>
</p>
<?php endif; ?>
<?php else : ?>
<?php if ( ! empty( $global_directives ) ) : ?>
<p style="margin: 0; padding: 6px; background: #fff; border-left: 3px solid #9e9e9e; font-size: 11px;">
<strong style="color: #666;"><?php esc_html_e( 'Global settings:', 'noindex-seo' ); ?></strong><br>
<code style="font-size: 10px;"><?php echo esc_html( implode( ', ', $global_directives ) ); ?></code>
</p>
<?php else : ?>
<p style="margin: 0; padding: 6px; background: #e8f5e9; border-left: 3px solid #4caf50; font-size: 11px; color: #2e7d32;">
<?php esc_html_e( 'No restrictions (indexable)', 'noindex-seo' ); ?>
</p>
<?php endif; ?>
<?php endif; ?>
</div>
<script type="text/javascript">
(function() {
var toggle = document.getElementById('noindex-seo-override-toggle');
var container = document.getElementById('noindex-seo-directives-container');
if (toggle && container) {
toggle.addEventListener('change', function() {
container.style.display = this.checked ? 'block' : 'none';
});
}
})();
</script>
</div>
<?php
}
/**
* Persist robots override and directive post meta from the current $_POST data.
*
* Shared by the meta box save path and the Quick Edit save path.
* Callers are responsible for nonce verification and capability checks
* before invoking this helper.
*
* @since 2.0.1
*
* @param int $post_id The post ID to update.
* @return void
*/
function noindex_seo_save_directives_from_post( int $post_id ): void {
// phpcs:disable WordPress.Security.NonceVerification.Missing
// Nonce verification and capability checks are performed by the callers:
// noindex_seo_save_post_meta() and noindex_seo_save_quick_edit().
$override = isset( $_POST['noindex_seo_override'] ) ? 1 : 0;
update_post_meta( $post_id, '_noindex_seo_override', $override );
if ( $override ) {
$directives = array( 'noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
foreach ( $directives as $directive ) {
$value = isset( $_POST[ 'noindex_seo_' . $directive ] ) ? 1 : 0;
update_post_meta( $post_id, '_noindex_seo_' . $directive, $value );
}
} else {
noindex_seo_clear_post_directives( $post_id );
}
// phpcs:enable WordPress.Security.NonceVerification.Missing
}
/**
* Save post meta when post is saved.
*
* Validates nonce, checks user permissions, and saves the override settings.
* Only saves meta if override is enabled.
*
* @since 2.0.0
*
* @param int $post_id The post ID being saved.
* @return void
*/
function noindex_seo_save_post_meta( int $post_id ): void {
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return;
}
// Verify nonce. The is_string() ternary narrows the type from mixed to string
// so wp_unslash() returns string and sanitize_text_field() receives string.
if ( ! isset( $_POST['noindex_seo_meta_box_nonce'] ) ||
! wp_verify_nonce(
sanitize_text_field( wp_unslash( is_string( $_POST['noindex_seo_meta_box_nonce'] ) ? $_POST['noindex_seo_meta_box_nonce'] : '' ) ),
'noindex_seo_meta_box'
)
) {
return;
}
// Check if this is an autosave.
if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
return;
}
// Check user permissions.
if ( ! current_user_can( 'edit_post', $post_id ) ) {
return;
}
noindex_seo_save_directives_from_post( $post_id );
}
add_action( 'save_post', 'noindex_seo_save_post_meta' );
/**
* Add custom column to post/page list showing robots directives override status.
*
* Only adds column if granular control is enabled.
*
* @since 2.0.0
*
* @param array<string, string> $columns Existing columns.
* @return array<string, string> Modified columns.
*/
function noindex_seo_add_custom_column( array $columns ): array {
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return $columns;
}
// Insert column after title (or at the end if title doesn't exist).
$new_columns = array();
foreach ( $columns as $key => $value ) {
$new_columns[ $key ] = $value;
if ( 'title' === $key ) {
$new_columns['noindex_seo_directives'] = __( 'Robots', 'noindex-seo' );
}
}
// If title column doesn't exist, add at the end.
if ( ! isset( $new_columns['noindex_seo_directives'] ) ) {
$new_columns['noindex_seo_directives'] = __( 'Robots', 'noindex-seo' );
}
return $new_columns;
}
/**
* Display content of custom robots directives column.
*
* @since 2.0.0
*
* @param string $column Column name.
* @param int $post_id Post ID.
* @return void
*/
function noindex_seo_display_custom_column( string $column, int $post_id ): void {
if ( 'noindex_seo_directives' !== $column ) {
return;
}
$override = get_post_meta( $post_id, '_noindex_seo_override', true );
// Collect directive values for Quick Edit.
$meta_noindex = get_post_meta( $post_id, '_noindex_seo_noindex', true );
$meta_nofollow = get_post_meta( $post_id, '_noindex_seo_nofollow', true );
$meta_noarchive = get_post_meta( $post_id, '_noindex_seo_noarchive', true );
$meta_nosnippet = get_post_meta( $post_id, '_noindex_seo_nosnippet', true );
$meta_noimageindex = get_post_meta( $post_id, '_noindex_seo_noimageindex', true );
$directives_values = array(
'override' => ( is_scalar( $override ) ? absint( $override ) : 0 ),
'noindex' => ( is_scalar( $meta_noindex ) ? absint( $meta_noindex ) : 0 ),
'nofollow' => ( is_scalar( $meta_nofollow ) ? absint( $meta_nofollow ) : 0 ),
'noarchive' => ( is_scalar( $meta_noarchive ) ? absint( $meta_noarchive ) : 0 ),
'nosnippet' => ( is_scalar( $meta_nosnippet ) ? absint( $meta_nosnippet ) : 0 ),
'noimageindex' => ( is_scalar( $meta_noimageindex ) ? absint( $meta_noimageindex ) : 0 ),
);
// Output hidden data for Quick Edit to read.
echo '<div class="noindex-seo-override-data hidden" ';
foreach ( $directives_values as $key => $value ) {
echo 'data-' . esc_attr( $key ) . '="' . esc_attr( (string) $value ) . '" ';
}
echo '></div>';
if ( ! $override ) {
echo '<span style="color: #999;">—</span>';
return;
}
// Collect active directives for display.
$directives = array( 'noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
$active = array();
foreach ( $directives as $directive ) {
if ( 1 === $directives_values[ $directive ] ) {
$active[] = $directive;
}
}
if ( empty( $active ) ) {
echo '<span style="color: #999;">' . esc_html__( 'Override (none)', 'noindex-seo' ) . '</span>';
return;
}
// Display active directives as badges.
echo '<div style="display: flex; flex-wrap: wrap; gap: 4px;">';
foreach ( $active as $directive ) {
$emoji = '';
switch ( $directive ) {
case 'noindex':
$emoji = '🔍';
break;
case 'nofollow':
$emoji = '🔗';
break;
case 'noarchive':
$emoji = '💾';
break;
case 'nosnippet':
$emoji = '📄';
break;
case 'noimageindex':
$emoji = '🖼️';
break;
}
echo '<span style="display: inline-block; padding: 2px 6px; background: #eff6ff; border: 1px solid #667eea; border-radius: 3px; font-size: 11px; line-height: 1.2;">';
echo esc_html( $emoji . ' ' . $directive );
echo '</span>';
}
echo '</div>';
}
// Register column hooks after all CPTs are registered (admin_init fires after init).
add_action(
'admin_init',
function (): void {
$post_types = get_post_types( array( 'public' => true ), 'names' );
foreach ( $post_types as $post_type ) {
add_filter( "manage_{$post_type}_posts_columns", 'noindex_seo_add_custom_column' );
add_action( "manage_{$post_type}_posts_custom_column", 'noindex_seo_display_custom_column', 10, 2 );
}
}
);
/**
* Add Quick Edit fields for robots directives.
*
* Displays the same directive checkboxes in Quick Edit interface.
*
* @since 2.0.0
*
* @param string $column_name Column name.
* @param string $post_type Post type (unused but required by hook).
* @return void
*/
function noindex_seo_quick_edit_fields( string $column_name, string $post_type ): void { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return;
}
if ( 'noindex_seo_directives' !== $column_name ) {
return;
}
// Add nonce field.
wp_nonce_field( 'noindex_seo_quick_edit', 'noindex_seo_quick_edit_nonce' );
?>
<fieldset class="inline-edit-col-right">
<div class="inline-edit-col">
<label class="inline-edit-group">
<span class="title"><?php esc_html_e( 'Robots Directives', 'noindex-seo' ); ?></span>
<div style="padding: 5px 0;">
<label style="display: block; margin-bottom: 6px;">
<input type="checkbox" name="noindex_seo_override" value="1" id="noindex-seo-quick-edit-override">
<strong><?php esc_html_e( 'Override global settings', 'noindex-seo' ); ?></strong>
</label>
<div id="noindex-seo-quick-edit-directives" style="margin-left: 20px; margin-top: 8px; display: none;">
<label style="display: block; margin-bottom: 4px;">
<input type="checkbox" name="noindex_seo_noindex" value="1">
<?php esc_html_e( '🔍 noindex', 'noindex-seo' ); ?>
</label>
<label style="display: block; margin-bottom: 4px;">
<input type="checkbox" name="noindex_seo_nofollow" value="1">
<?php esc_html_e( '🔗 nofollow', 'noindex-seo' ); ?>
</label>
<label style="display: block; margin-bottom: 4px;">
<input type="checkbox" name="noindex_seo_noarchive" value="1">
<?php esc_html_e( '💾 noarchive', 'noindex-seo' ); ?>
</label>
<label style="display: block; margin-bottom: 4px;">
<input type="checkbox" name="noindex_seo_nosnippet" value="1">
<?php esc_html_e( '📄 nosnippet', 'noindex-seo' ); ?>
</label>
<label style="display: block; margin-bottom: 4px;">
<input type="checkbox" name="noindex_seo_noimageindex" value="1">
<?php esc_html_e( '🖼️ noimageindex', 'noindex-seo' ); ?>
</label>
</div>
</div>
</label>
</div>
</fieldset>
<script type="text/javascript">
jQuery(document).ready(function($) {
// Toggle directives visibility when override checkbox changes
$('#noindex-seo-quick-edit-override').on('change', function() {
if ($(this).is(':checked')) {
$('#noindex-seo-quick-edit-directives').show();
} else {
$('#noindex-seo-quick-edit-directives').hide();
}
});
// Populate Quick Edit fields when "Edit" is clicked
$('#the-list').on('click', '.editinline', function() {
var post_id = $(this).closest('tr').attr('id').replace('post-', '');
var $row = $('#post-' + post_id);
// Get current values from the column (we'll use data attributes)
var override = $row.find('.noindex-seo-override-data').data('override');
var noindex = $row.find('.noindex-seo-override-data').data('noindex');
var nofollow = $row.find('.noindex-seo-override-data').data('nofollow');
var noarchive = $row.find('.noindex-seo-override-data').data('noarchive');
var nosnippet = $row.find('.noindex-seo-override-data').data('nosnippet');
var noimageindex = $row.find('.noindex-seo-override-data').data('noimageindex');
// Set checkbox values
$('#noindex-seo-quick-edit-override').prop('checked', override == 1);
$('input[name="noindex_seo_noindex"]').prop('checked', noindex == 1);
$('input[name="noindex_seo_nofollow"]').prop('checked', nofollow == 1);
$('input[name="noindex_seo_noarchive"]').prop('checked', noarchive == 1);
$('input[name="noindex_seo_nosnippet"]').prop('checked', nosnippet == 1);
$('input[name="noindex_seo_noimageindex"]').prop('checked', noimageindex == 1);
// Show/hide directives based on override
if (override == 1) {
$('#noindex-seo-quick-edit-directives').show();
} else {
$('#noindex-seo-quick-edit-directives').hide();
}
});
});
</script>
<?php
}
add_action( 'quick_edit_custom_box', 'noindex_seo_quick_edit_fields', 10, 2 );
add_action( 'bulk_edit_custom_box', 'noindex_seo_quick_edit_fields', 10, 2 );
/**
* Save Quick Edit data for robots directives.
*
* @since 2.0.0
*
* @param int $post_id Post ID being saved.
* @return void
*/
function noindex_seo_save_quick_edit( int $post_id ): void {
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return;
}
// Verify nonce. The is_string() ternary narrows the type from mixed to string
// so wp_unslash() returns string and sanitize_text_field() receives string.
if ( ! isset( $_POST['noindex_seo_quick_edit_nonce'] ) ||
! wp_verify_nonce(
sanitize_text_field( wp_unslash( is_string( $_POST['noindex_seo_quick_edit_nonce'] ) ? $_POST['noindex_seo_quick_edit_nonce'] : '' ) ),
'noindex_seo_quick_edit'
)
) {
return;
}
// Check user permissions.
if ( ! current_user_can( 'edit_post', $post_id ) ) {
return;
}
// Check if we're in Quick Edit (not regular post save).
if ( ! isset( $_POST['_inline_edit'] ) ) {
return;
}
noindex_seo_save_directives_from_post( $post_id );
}
add_action( 'save_post', 'noindex_seo_save_quick_edit' );
/**
* Register custom bulk actions for robots directives.
*
* Adds "Enable Override" and "Disable Override" bulk actions.
*
* @since 2.0.0
*
* @param array<string, string> $bulk_actions Existing bulk actions.
* @return array<string, string> Modified bulk actions.
*/
function noindex_seo_register_bulk_actions( array $bulk_actions ): array {
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return $bulk_actions;
}
$bulk_actions['noindex_seo_enable_override'] = __( 'Enable Robots Override', 'noindex-seo' );
$bulk_actions['noindex_seo_disable_override'] = __( 'Disable Robots Override', 'noindex-seo' );
return $bulk_actions;
}
/**
* Handle custom bulk actions for robots directives.
*
* @since 2.0.0
*
* @param string $redirect_to Redirect URL.
* @param string $action Action being taken.
* @param array<int, string> $post_ids Array of post IDs.
* @return string Modified redirect URL.
*/
function noindex_seo_handle_bulk_actions( string $redirect_to, string $action, array $post_ids ): string {
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return $redirect_to;
}
// Validate that we have post IDs to process.
if ( empty( $post_ids ) ) {
return $redirect_to;
}
// Check user permissions - user must be able to edit posts.
if ( ! current_user_can( 'edit_posts' ) ) {
return $redirect_to;
}
// Filter post IDs to only include ones the current user can edit.
$editable_post_ids = array();
foreach ( $post_ids as $post_id ) {
$post_id = intval( $post_id );
if ( $post_id > 0 && current_user_can( 'edit_post', $post_id ) ) {
$editable_post_ids[] = $post_id;
}
}
// If no editable posts remain after filtering, return early.
if ( empty( $editable_post_ids ) ) {
return $redirect_to;
}
// Replace original post IDs with filtered list.
$post_ids = $editable_post_ids;
global $wpdb;
if ( 'noindex_seo_enable_override' === $action ) {
// Use direct SQL for better performance with large selections.
// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
// Direct database queries are necessary here for performance with bulk operations.
// This is an INSERT/UPDATE operation, so caching is not applicable.
// Update or insert override meta for all selected posts.
foreach ( $post_ids as $post_id ) {
$wpdb->query(
$wpdb->prepare(
"INSERT INTO {$wpdb->postmeta} (post_id, meta_key, meta_value) VALUES (%d, '_noindex_seo_override', '1') ON DUPLICATE KEY UPDATE meta_value = '1'",
$post_id
)
);
}
// phpcs:enable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
$redirect_to = add_query_arg( 'noindex_seo_bulk_enabled', count( $post_ids ), $redirect_to );
}
if ( 'noindex_seo_disable_override' === $action ) {
// Use direct SQL for better performance with large selections.
// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
// Direct database queries are necessary here for performance with bulk operations.
// This is an UPDATE/DELETE operation, so caching is not applicable.
// Update override meta to 0 for all selected posts.
$wpdb->query(
$wpdb->prepare(
"UPDATE {$wpdb->postmeta} SET meta_value = '0' WHERE meta_key = '_noindex_seo_override' AND post_id IN (" . implode( ',', array_fill( 0, count( $post_ids ), '%d' ) ) . ')',
...$post_ids
)
);
// Delete all directive meta for selected posts.
$directives = array( 'noindex', 'nofollow', 'noarchive', 'nosnippet', 'noimageindex' );
foreach ( $directives as $directive ) {
// Build parameter array: meta_key + post IDs.
$prepare_params = array_merge(
array( '_noindex_seo_' . $directive ),
$post_ids
);
$wpdb->query(
$wpdb->prepare(
"DELETE FROM {$wpdb->postmeta} WHERE meta_key = %s AND post_id IN (" . implode( ',', array_fill( 0, count( $post_ids ), '%d' ) ) . ')',
...$prepare_params
)
);
}
// phpcs:enable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
$redirect_to = add_query_arg( 'noindex_seo_bulk_disabled', count( $post_ids ), $redirect_to );
}
return $redirect_to;
}
/**
* Display admin notice after bulk actions.
*
* @since 2.0.0
*
* @return void
*/
function noindex_seo_bulk_actions_admin_notice(): void {
// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- URL parameter from redirect after bulk action, not form data.
if ( ! empty( $_REQUEST['noindex_seo_bulk_enabled'] ) ) {
// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- URL parameter from redirect after bulk action, not form data.
$count = is_scalar( $_REQUEST['noindex_seo_bulk_enabled'] ) ? absint( $_REQUEST['noindex_seo_bulk_enabled'] ) : 0;
printf(
'<div class="notice notice-success is-dismissible"><p>%s</p></div>',
esc_html(
sprintf(
/* translators: %d: Number of posts updated */
_n(
'Robots override enabled for %d post.',
'Robots override enabled for %d posts.',
$count,
'noindex-seo'
),
$count
)
)
);
}
// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- URL parameter from redirect after bulk action, not form data.
if ( ! empty( $_REQUEST['noindex_seo_bulk_disabled'] ) ) {
// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- URL parameter from redirect after bulk action, not form data.
$count = is_scalar( $_REQUEST['noindex_seo_bulk_disabled'] ) ? absint( $_REQUEST['noindex_seo_bulk_disabled'] ) : 0;
printf(
'<div class="notice notice-success is-dismissible"><p>%s</p></div>',
esc_html(
sprintf(
/* translators: %d: Number of posts updated */
_n(
'Robots override disabled for %d post.',
'Robots override disabled for %d posts.',
$count,
'noindex-seo'
),
$count
)
)
);
}
}
add_action( 'admin_notices', 'noindex_seo_bulk_actions_admin_notice' );
// Register bulk action hooks after all CPTs are registered.
add_action(
'admin_init',
function (): void {
$post_types = get_post_types( array( 'public' => true ), 'names' );
foreach ( $post_types as $post_type ) {
add_filter( "bulk_actions-edit-{$post_type}", 'noindex_seo_register_bulk_actions' );
add_filter( "handle_bulk_actions-edit-{$post_type}", 'noindex_seo_handle_bulk_actions', 10, 3 );
}
}
);
/**
* Add filter dropdown to post list for robots override status.
*
* Allows filtering posts by override status: all, with override, without override.
*
* @since 2.0.0
*
* @param string $post_type Current post type (unused but required by hook).
* @return void
*/
function noindex_seo_add_list_filter( string $post_type ): void { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return;
}
// Get current filter value from URL parameters (not a form submission, no nonce needed).
// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- URL parameter for filtering, not form data.
$current_filter = ( isset( $_GET['noindex_seo_filter'] ) && is_string( $_GET['noindex_seo_filter'] ) ) ? sanitize_text_field( wp_unslash( $_GET['noindex_seo_filter'] ) ) : '';
?>
<select name="noindex_seo_filter">
<option value=""><?php esc_html_e( 'All robots settings', 'noindex-seo' ); ?></option>
<option value="with_override" <?php selected( $current_filter, 'with_override' ); ?>>
<?php esc_html_e( 'With override', 'noindex-seo' ); ?>
</option>
<option value="without_override" <?php selected( $current_filter, 'without_override' ); ?>>
<?php esc_html_e( 'Without override', 'noindex-seo' ); ?>
</option>
</select>
<?php
}
/**
* Filter posts query by robots override status.
*
* Modifies the query to show only posts with or without override
* based on the selected filter.
*
* @since 2.0.0
*
* @param WP_Query $query Current query object.
* @return void
*/
function noindex_seo_filter_posts_by_override( WP_Query $query ): void {
// Only in admin list view.
if ( ! is_admin() || ! $query->is_main_query() ) {
return;
}
// Check if granular control is enabled.
$granular_enabled = get_option( 'noindex_seo_config_granular', 0 );
if ( ! $granular_enabled ) {
return;
}
// Check if filter is set (URL parameter, not form submission, no nonce needed).
// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- URL parameter for filtering, not form data.
if ( ! isset( $_GET['noindex_seo_filter'] ) || empty( $_GET['noindex_seo_filter'] ) ) {
return;
}
// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- URL parameter for filtering, not form data.
$filter = is_string( $_GET['noindex_seo_filter'] ) ? sanitize_text_field( wp_unslash( $_GET['noindex_seo_filter'] ) ) : '';
// Validate against whitelist of allowed filter values.
$valid_filters = array( 'with_override', 'without_override' );
if ( ! in_array( $filter, $valid_filters, true ) ) {
return; // Invalid filter value, ignore.
}
// Build meta query.
$meta_query = array();
if ( 'with_override' === $filter ) {
$meta_query = array(
array(
'key' => '_noindex_seo_override',
'value' => '1',
'compare' => '=',
),
);
} elseif ( 'without_override' === $filter ) {
$meta_query = array(
'relation' => 'OR',
array(
'key' => '_noindex_seo_override',
'value' => '1',
'compare' => '!=',
),
array(
'key' => '_noindex_seo_override',
'compare' => 'NOT EXISTS',
),
);
}
$query->set( 'meta_query', $meta_query );
}
add_action( 'pre_get_posts', 'noindex_seo_filter_posts_by_override' );
// Register filter dropdown after all CPTs are registered.
add_action(
'admin_init',
function (): void {
$post_types = get_post_types( array( 'public' => true ), 'names' );
foreach ( $post_types as $post_type ) {
add_action(
'restrict_manage_posts',
function () use ( $post_type ): void {
global $typenow;
if ( $typenow === $post_type ) {
noindex_seo_add_list_filter( $post_type );
}
}
);
}
}
);
/**
* Renders the modern, visual settings page for the 'noindex SEO' plugin.
*
* This function outputs a completely redesigned admin interface with:
* - Modern card-based layout
* - Toggle switches instead of checkboxes
* - Tabbed navigation for better organization
* - Visual indicators and badges
* - Collapsible sections
* - Search/filter functionality
* - Statistics dashboard
*
* @since 1.0.0
* @since 2.0.0 Completely redesigned with modern UI/UX.
*
* @return void
*/
function noindex_seo_admin(): void {
// Verify user capabilities for defense in depth..
if ( ! current_user_can( 'manage_options' ) ) {
wp_die(
esc_html__( 'You do not have sufficient permissions to access this page.', 'noindex-seo' ),
esc_html__( 'Permission Denied', 'noindex-seo' ),
array( 'response' => 403 )
);
}
// Define section icons (using Dashicons)..
$section_icons = array(
'main_pages' => 'dashicons-admin-home',
'pages_posts' => 'dashicons-admin-page',
'taxonomies' => 'dashicons-category',
'dates' => 'dashicons-calendar-alt',
'archives' => 'dashicons-archive',
'pagination' => 'dashicons-ellipsis',
'search' => 'dashicons-search',
'attachments' => 'dashicons-paperclip',
'previews' => 'dashicons-visibility',
'error_page' => 'dashicons-warning',
);
// Define sections and their respective settings..
$sections = array(
'main_pages' => array(
'title' => __( 'Main Pages', 'noindex-seo' ),
'fields' => array(
'front_page' => array(
'label' => __( 'Front Page', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => false,
'description' => __( 'Block the indexing of the site\'s front page.', 'noindex-seo' ),
'view_url' => get_site_url(),
),
'home' => array(
'label' => __( 'Home', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => false,
'description' => __( 'Block the indexing of the site\'s home page.', 'noindex-seo' ),
'view_url' => get_home_url(),
),
),
),
'pages_posts' => array(
'title' => __( 'Pages and Posts', 'noindex-seo' ),
'fields' => array(
'page' => array(
'label' => __( 'Page', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => false,
'description' => __( 'Block the indexing of site pages.', 'noindex-seo' ),
),
'privacy_policy' => array(
'label' => __( 'Privacy Policy', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing of the privacy policy page.', 'noindex-seo' ),
'view_url' => get_privacy_policy_url(),
),
'single' => array(
'label' => __( 'Single Post', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => false,
'description' => __( 'Block the indexing of individual posts.', 'noindex-seo' ),
),
'singular' => array(
'label' => __( 'Singular', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => false,
'description' => __( 'Block the indexing of any singular content (post or page).', 'noindex-seo' ),
),
),
),
'taxonomies' => array(
'title' => __( 'Taxonomies', 'noindex-seo' ),
'fields' => array(
'category' => array(
'label' => __( 'Category', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => false,
'description' => __( 'Block the indexing of category archive pages.', 'noindex-seo' ),
),
'tag' => array(
'label' => __( 'Tag', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => false,
'description' => __( 'Block the indexing of tag archive pages.', 'noindex-seo' ),
),
),
),
'dates' => array(
'title' => __( 'Date Archives', 'noindex-seo' ),
'fields' => array(
'date' => array(
'label' => __( 'Date', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing of any date-based archive page.', 'noindex-seo' ),
),
'day' => array(
'label' => __( 'Day', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing of daily archive pages.', 'noindex-seo' ),
),
'month' => array(
'label' => __( 'Month', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing of monthly archive pages.', 'noindex-seo' ),
),
'time' => array(
'label' => __( 'Time', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing of time-based archive pages.', 'noindex-seo' ),
),
'year' => array(
'label' => __( 'Year', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing of yearly archive pages.', 'noindex-seo' ),
),
),
),
'archives' => array(
'title' => __( 'Archives', 'noindex-seo' ),
'fields' => array(
'archive' => array(
'label' => __( 'Archive', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => false,
'description' => __( 'Block the indexing of any type of archive page.', 'noindex-seo' ),
),
'author' => array(
'label' => __( 'Author', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => false,
'description' => __( 'Block the indexing of author archive pages.', 'noindex-seo' ),
),
'post_type_archive' => array(
'label' => __( 'Post Type Archive', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => false,
'description' => __( 'Block the indexing of post type archive pages.', 'noindex-seo' ),
),
),
),
'pagination' => array(
'title' => __( 'Pagination', 'noindex-seo' ),
'fields' => array(
'paged' => array(
'label' => __( 'Paginated Pages', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing of pagination pages (page 2, 3, etc.).', 'noindex-seo' ),
),
),
),
'search' => array(
'title' => __( 'Search', 'noindex-seo' ),
'fields' => array(
'search' => array(
'label' => __( 'Search Results', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing of search result pages.', 'noindex-seo' ),
),
),
),
'attachments' => array(
'title' => __( 'Attachments', 'noindex-seo' ),
'fields' => array(
'attachment' => array(
'label' => __( 'Attachment Pages', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing of attachment pages (does not affect the file itself).', 'noindex-seo' ),
),
),
),
'previews' => array(
'title' => __( 'Previews', 'noindex-seo' ),
'fields' => array(
'customize_preview' => array(
'label' => __( 'Customize Preview', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing when content is in customize preview mode.', 'noindex-seo' ),
),
'preview' => array(
'label' => __( 'Post Preview', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing when viewing post previews.', 'noindex-seo' ),
),
),
),
'error_page' => array(
'title' => __( 'Error Pages', 'noindex-seo' ),
'fields' => array(
'error' => array(
'label' => __( 'Error 404', 'noindex-seo' ),
'recommended' => __( 'Recommended', 'noindex-seo' ),
'suggestion' => true,
'description' => __( 'Block the indexing of 404 error pages.', 'noindex-seo' ),
),
),
),
);
// Get config options with explicit type narrowing.
$opt_seoplugins = get_option( 'noindex_seo_config_seoplugins', 0 );
$option_config_seoplugins = is_scalar( $opt_seoplugins ) ? absint( $opt_seoplugins ) : 0;
$opt_method = get_option( 'noindex_seo_config_method', 'meta' );
$option_config_method = is_string( $opt_method ) ? $opt_method : 'meta';
$opt_granular = get_option( 'noindex_seo_config_granular', 0 );
$option_config_granular = is_scalar( $opt_granular ) ? absint( $opt_granular ) : 0;
$opt_delete = get_option( 'noindex_seo_config_delete_on_uninstall', 0 );
$option_config_delete_on_uninstall = is_scalar( $opt_delete ) ? absint( $opt_delete ) : 0;
// Define fields that only work with HTTP headers (non-HTML content).
$header_only_fields = array( 'attachment', 'feed', 'comment_feed' );
$is_header_enabled = in_array( $option_config_method, array( 'header', 'both' ), true );
// Define available directives with config.
$directives_config = array(
'noindex' => array(
'label' => __( 'noindex', 'noindex-seo' ),
'desc' => __( 'Prevent search engines from indexing this page', 'noindex-seo' ),
'icon' => '🔍',
),
'nofollow' => array(
'label' => __( 'nofollow', 'noindex-seo' ),
'desc' => __( 'Prevent search engines from following links on this page', 'noindex-seo' ),
'icon' => '🔗',
),
'noarchive' => array(
'label' => __( 'noarchive', 'noindex-seo' ),
'desc' => __( 'Prevent search engines from showing a cached version', 'noindex-seo' ),
'icon' => '💾',
),
'nosnippet' => array(
'label' => __( 'nosnippet', 'noindex-seo' ),
'desc' => __( 'Prevent search engines from showing text snippets', 'noindex-seo' ),
'icon' => '📄',
),
'noimageindex' => array(
'label' => __( 'noimageindex', 'noindex-seo' ),
'desc' => __( 'Prevent search engines from indexing images', 'noindex-seo' ),
'icon' => '🖼️',
),
);
?>
<div class="wrap noindex-seo-admin-wrap">
<h1><?php esc_html_e( 'noindex SEO Settings', 'noindex-seo' ); ?></h1>
<p><?php esc_html_e( 'Control how search engines index and display your WordPress content using robots directives.', 'noindex-seo' ); ?></p>
<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
<input type="hidden" name="action" value="update_noindex_seo">
<?php wp_nonce_field( 'update_noindex_seo_nonce' ); ?>
<!-- Statistics Dashboard -->
<div class="noindex-seo-stats">
<div class="noindex-seo-stat-card">
<div class="noindex-seo-stat-number" id="noindex-seo-stat-total">0</div>
<div class="noindex-seo-stat-label"><?php esc_html_e( 'Total Options', 'noindex-seo' ); ?></div>
</div>
<div class="noindex-seo-stat-card">
<div class="noindex-seo-stat-number" id="noindex-seo-stat-enabled">0</div>
<div class="noindex-seo-stat-label"><?php esc_html_e( 'Enabled', 'noindex-seo' ); ?></div>
</div>
<div class="noindex-seo-stat-card">
<div class="noindex-seo-stat-number" id="noindex-seo-stat-recommended">0</div>
<div class="noindex-seo-stat-label"><?php esc_html_e( 'Recommended to Enable', 'noindex-seo' ); ?></div>
</div>
</div>
<!-- General Configuration -->
<div class="noindex-seo-general-config">
<h2>
<span class="dashicons dashicons-admin-settings"></span>
<?php esc_html_e( 'General Configuration', 'noindex-seo' ); ?>
</h2>
<div class="noindex-seo-config-option">
<label class="noindex-seo-switch">
<input
type="checkbox"
id="noindex_seo_config_seoplugins"
name="noindex_seo_config_seoplugins"
value="1"
<?php checked( 1, $option_config_seoplugins ); ?>
>
<span class="noindex-seo-slider"></span>
</label>
<label for="noindex_seo_config_seoplugins">
<?php esc_html_e( 'Disable compatibility warnings with other SEO plugins', 'noindex-seo' ); ?>
</label>
</div>
<div class="noindex-seo-config-option" style="margin-top: 20px;">
<div style="flex: 1;">
<label for="noindex_seo_config_method" style="display: block; font-weight: 600; margin-bottom: 8px; color: #92400e;">
<?php esc_html_e( 'Implementation Method', 'noindex-seo' ); ?>
</label>
<select
id="noindex_seo_config_method"
name="noindex_seo_config_method"
style="width: 100%; max-width: 400px; padding: 8px; border: 1px solid #fcd34d; border-radius: 4px; background: #fff; color: #78350f;"
>
<option value="meta" <?php selected( $option_config_method, 'meta' ); ?>>
<?php esc_html_e( 'HTML Meta Tags (default, easier to verify)', 'noindex-seo' ); ?>
</option>
<option value="header" <?php selected( $option_config_method, 'header' ); ?>>
<?php esc_html_e( 'HTTP Headers (more robust, works with PDFs/images)', 'noindex-seo' ); ?>
</option>
<option value="both" <?php selected( $option_config_method, 'both' ); ?>>
<?php esc_html_e( 'Both (maximum compatibility)', 'noindex-seo' ); ?>
</option>
</select>
<p style="margin: 8px 0 0 0; font-size: 13px; color: #92400e; line-height: 1.5;">
<?php esc_html_e( 'Choose how noindex directives are sent to search engines. Meta tags work for HTML pages. HTTP headers work for all content types including PDFs, images, and feeds.', 'noindex-seo' ); ?>
</p>
</div>
</div>
<div class="noindex-seo-config-option" style="margin-top: 20px;">
<label class="noindex-seo-switch">
<input
type="checkbox"
id="noindex_seo_config_granular"
name="noindex_seo_config_granular"
value="1"
<?php checked( 1, $option_config_granular ); ?>
>
<span class="noindex-seo-slider"></span>
</label>
<div style="flex: 1;">
<label for="noindex_seo_config_granular" style="display: block; font-weight: 600; color: #1e40af;">
<?php esc_html_e( 'Enable per-post/page granular control', 'noindex-seo' ); ?>
</label>
<p style="margin: 4px 0 0 0; font-size: 13px; color: #64748b; line-height: 1.5;">
<?php esc_html_e( 'When enabled, a meta box will appear in the post/page editor allowing you to override global settings for individual content. Useful for specific pages that need different robots directives.', 'noindex-seo' ); ?>
</p>
</div>
</div>
<div class="noindex-seo-config-option" style="margin-top: 20px;">
<label class="noindex-seo-switch">
<input
type="checkbox"
id="noindex_seo_config_delete_on_uninstall"
name="noindex_seo_config_delete_on_uninstall"
value="1"
<?php checked( 1, $option_config_delete_on_uninstall ); ?>
>
<span class="noindex-seo-slider"></span>
</label>
<div style="flex: 1;">
<label for="noindex_seo_config_delete_on_uninstall" style="display: block; font-weight: 600; color: #b91c1c;">
<?php esc_html_e( 'Delete all plugin data on uninstall', 'noindex-seo' ); ?>
</label>
<p style="margin: 4px 0 0 0; font-size: 13px; color: #64748b; line-height: 1.5;">
<?php esc_html_e( 'When enabled, all settings and per-post robots directives will be permanently deleted when the plugin is uninstalled. By default data is preserved.', 'noindex-seo' ); ?>
</p>
</div>
</div>
</div>
<!-- Alert -->
<div class="noindex-seo-alert">
<span class="dashicons dashicons-warning"></span>
<p><?php esc_html_e( 'Important: Enabling noindex on the wrong pages can harm your search engine rankings. Only enable options you fully understand.', 'noindex-seo' ); ?></p>
</div>
<!-- Search Box -->
<div class="noindex-seo-search">
<input
type="search"
placeholder="<?php esc_attr_e( 'Search options...', 'noindex-seo' ); ?>"
aria-label="<?php esc_attr_e( 'Search options', 'noindex-seo' ); ?>"
>
</div>
<!-- Sections as Cards -->
<?php foreach ( $sections as $section_id => $section ) : ?>
<?php
$icon = $section_icons[ $section_id ];
?>
<div class="noindex-seo-card" id="noindex-seo-card-<?php echo esc_attr( $section_id ); ?>">
<div class="noindex-seo-card-header">
<h3>
<span class="dashicons <?php echo esc_attr( $icon ); ?>"></span>
<?php echo esc_html( $section['title'] ); ?>
</h3>
<span class="dashicons dashicons-arrow-down-alt2 noindex-seo-card-toggle"></span>
</div>
<div class="noindex-seo-card-body">
<?php foreach ( $section['fields'] as $field_id => $field ) : ?>
<?php
// Check if field should be disabled (header-only fields with meta method).
$should_disable = in_array( $field_id, $header_only_fields, true ) && ! $is_header_enabled;
?>
<div class="noindex-seo-option<?php echo $should_disable ? ' disabled' : ''; ?>"<?php echo $should_disable ? ' title="' . esc_attr__( 'This option only works with HTTP Headers implementation method', 'noindex-seo' ) . '"' : ''; ?>>
<div class="noindex-seo-option-header">
<div class="noindex-seo-option-title">
<strong><?php echo esc_html( $field['label'] ); ?></strong>
<span class="noindex-seo-badge <?php echo $field['suggestion'] ? 'recommended' : 'not-recommended'; ?>">
<?php
if ( $field['suggestion'] ) {
esc_html_e( 'Recommended', 'noindex-seo' );
} else {
esc_html_e( 'Not Recommended', 'noindex-seo' );
}
?>
</span>
<?php if ( isset( $field['view_url'] ) && ! empty( $field['view_url'] ) ) : ?>
<a href="<?php echo esc_url( $field['view_url'] ); ?>" target="_blank" class="noindex-seo-view-link" title="<?php esc_attr_e( 'View Page', 'noindex-seo' ); ?>">
<span class="dashicons dashicons-external"></span>
</a>
<?php endif; ?>
</div>
<p class="noindex-seo-option-description">
<?php echo esc_html( $field['description'] ); ?>
</p>
</div>
<div class="noindex-seo-directives">
<?php foreach ( $directives_config as $directive => $config ) : ?>
<?php
$directive_option_key = $directive . '_seo_' . $field_id;
$directive_value = get_option( $directive_option_key, 0 );
?>
<label class="noindex-seo-directive-checkbox">
<input
type="checkbox"
id="<?php echo esc_attr( $directive_option_key ); ?>"
name="<?php echo esc_attr( $directive_option_key ); ?>"
value="1"
<?php checked( 1, $directive_value ); ?>
<?php disabled( $should_disable ); ?>
>
<span class="directive-icon"><?php echo esc_html( $config['icon'] ); ?></span>
<span class="directive-label"><?php echo esc_html( $config['label'] ); ?></span>
<span class="directive-description"><?php echo esc_html( $config['desc'] ); ?></span>
</label>
<?php endforeach; ?>
</div>
</div>
<?php endforeach; ?>
</div>
</div>
<?php endforeach; ?>
<?php submit_button(); ?>
</form>
</div>
<?php
}