arenagroove · December 18, 2025 06:18
diff --git a/README.md b/README.md
diff --git a/lr-coming-soon.php b/lr-coming-soon.php
 <?php
 /**
 * Plugin Name: LR Coming Soon Page
 * Plugin URI: https://gist.github.com/yourusername/
 * Description: Displays a customizable Coming Soon page to non-logged-in users while allowing authenticated users and preview access via a secret key. Maintains proper HTTP 503 status and SEO headers.
 * Version: 1.7.0
 * Requires at least: 5.0
 * Requires PHP: 7.4
 * Author: Luis Martinez
 * Author URI: https://www.lessrain.com
 * License: GPL v2 or later
 * License URI: https://www.gnu.org/licenses/gpl-2.0.html
 *
 * @package LR_Coming_Soon
 */

 if (!defined('ABSPATH')) {
    exit; // Exit if accessed directly
 }

 /**
 * Disable canonical redirect when preview parameter is present.
 *
 * Prevents WordPress from redirecting when using the lr_preview parameter,
 * allowing the preview functionality to work correctly.
 *
 * @param string|false $redirect_url The redirect URL.
 * @return string|false Modified redirect URL or false to prevent redirect.
 */
 add_filter('redirect_canonical', function ($redirect_url) {
    if (isset($_GET['lr_preview']) && $_GET['lr_preview'] !== '') {
        return false;
    }
    return $redirect_url;
 });

 /* ==========================================================================
   ADMIN INTERFACE
   ========================================================================== */

 /**
 * Register admin settings page.
 *
 * Adds a submenu under Settings for configuring the Coming Soon page.
 */
 add_action('admin_menu', function () {
    add_options_page(
        'LR Coming Soon',           // Page title
        'LR Coming Soon',           // Menu title
        'manage_options',           // Capability
        'lr-coming-soon',           // Menu slug
        'lr_render_coming_soon_settings'  // Callback
    );
 });

 /**
 * Add preview button to admin bar.
 *
 * When Coming Soon mode is active, adds a button to the admin bar that
 * allows administrators to preview the Coming Soon page while logged in.
 */
 add_action('admin_bar_menu', function ($wp_admin_bar) {
    // Only show if Coming Soon is enabled and user can manage options
    if (!get_option('lr_coming_soon_enabled')) return;
    if (!current_user_can('manage_options')) return;

    $wp_admin_bar->add_node([
        'id'     => 'preview-coming-soon',
        'title'  => '👁 Preview Coming Soon',
        'href'   => home_url('/?lr_preview_coming_soon=1'),
        'meta'   => [
            'title' => 'Preview the Coming Soon page as visitors see it',
        ],
    ]);
 }, 999);

 /**
 * Render the admin settings page.
 *
 * Displays the configuration interface for enabling/disabling the Coming Soon mode,
 * selecting the page to display, and setting the preview key.
 */
 function lr_render_coming_soon_settings() {
    ?>
    <div class="wrap">
        <h1>Coming Soon Page Settings</h1>
        <p>Configure your Coming Soon page settings below. Non-logged-in users will see the selected page when Coming Soon mode is active.</p>

        <form method="post" action="options.php">
            <?php
                settings_fields('lr-coming-soon');
                do_settings_sections('lr-coming-soon');
            ?>

            <table class="form-table">
                <tr>
                    <th scope="row">Enable Coming Soon Mode</th>
                    <td>
                        <label>
                            <input type="checkbox"
                                   name="lr_coming_soon_enabled"
                                   value="1"
                                   <?php checked(1, get_option('lr_coming_soon_enabled')); ?>>
                            Active
                        </label>
                        <p class="description">When enabled, non-logged-in users will see the Coming Soon page.</p>
                    </td>
                </tr>

                <tr>
                    <th scope="row">Coming Soon Page</th>
                    <td>
                        <?php
                        wp_dropdown_pages([
                            'name'              => 'lr_coming_soon_page_id',
                            'selected'          => get_option('lr_coming_soon_page_id'),
                            'show_option_none'  => '— Select Page —',
                            'option_none_value' => 0
                        ]);
                        ?>
                        <p class="description">Select the published page to display as your Coming Soon content. Must be a published page.</p>
                    </td>
                </tr>

                <tr>
                    <th scope="row">Preview Key</th>
                    <td>
                        <input type="text"
                               name="lr_coming_soon_preview_key"
                               value="<?php echo esc_attr(get_option('lr_coming_soon_preview_key')); ?>"
                               class="regular-text"
                               placeholder="Enter a secret key">
                        <p class="description">
                            Optional: Set a secret key to bypass Coming Soon mode.<br>
                            Share this URL: <code><?php echo esc_url(home_url('/?lr_preview=YOUR_KEY')); ?></code>
                        </p>
                    </td>
                </tr>
            </table>

            <?php submit_button(); ?>
        </form>

        <hr>

        <h2>How It Works</h2>
        <ul>
            <li><strong>Logged-in users:</strong> See the normal site (unaffected)</li>
            <li><strong>Non-logged-in users:</strong> See the Coming Soon page (when enabled)</li>
            <li><strong>Preview access:</strong> Anyone with the preview URL can view the normal site</li>
            <li><strong>HTTP 503 status:</strong> Proper status code for maintenance mode</li>
            <li><strong>SEO protection:</strong> noindex/nofollow headers prevent search engine indexing</li>
        </ul>

        <h2>Template Customization</h2>
        <p>The plugin looks for custom templates in this order:</p>
        <ol>
            <li><code>coming-soon.php</code> (theme root)</li>
            <li><code>templates/coming-soon.php</code></li>
            <li><code>parts/page/coming-soon.php</code></li>
        </ol>
        <p>If no custom template is found, it uses a minimal default template with the selected page's content.</p>
    </div>
    <?php
 }

 /* ==========================================================================
   SETTINGS REGISTRATION
   ========================================================================== */

 /**
 * Register plugin settings.
 *
 * Registers three settings:
 * - lr_coming_soon_enabled: Boolean toggle for Coming Soon mode
 * - lr_coming_soon_page_id: ID of the page to display
 * - lr_coming_soon_preview_key: Secret key for preview access
 */
 add_action('admin_init', function () {

    // Enable/disable toggle
    register_setting('lr-coming-soon', 'lr_coming_soon_enabled', 'absint');
    
    // Preview key
    register_setting('lr-coming-soon', 'lr_coming_soon_preview_key', 'sanitize_text_field');

    // Page selection with validation
    register_setting('lr-coming-soon', 'lr_coming_soon_page_id', [
        'type'              => 'integer',
        'sanitize_callback' => function ($value) {
            $value = absint($value);

            // Ensure selected page is published
            if ($value && get_post_status($value) !== 'publish') {
                add_settings_error(
                    'lr-coming-soon',
                    'invalid-page',
                    'Selected page must be published.'
                );
                return get_option('lr_coming_soon_page_id');
            }

            return $value;
        }
    ]);
 });

 /* ==========================================================================
   ADMIN NOTICES
   ========================================================================== */

 /**
 * Display admin notice when Coming Soon mode is active.
 *
 * Shows a persistent warning in the admin area to remind administrators
 * that the site is in Coming Soon mode.
 */
 add_action('admin_notices', function () {
    if (get_option('lr_coming_soon_enabled')) {
        echo '<div class="notice notice-warning is-dismissible">';
        echo '<p><strong>⚠ Coming Soon mode is active.</strong> Non-logged-in users see the Coming Soon page.</p>';
        echo '</div>';
    }
 });

 /* ==========================================================================
   FRONTEND INTERCEPTION
   ========================================================================== */

 /**
 * Intercept frontend requests and display Coming Soon page.
 *
 * This is the core functionality that:
 * 1. Checks for preview key bypass
 * 2. Validates conditions (logged in, enabled, etc.)
 * 3. Sets proper HTTP headers (503, no-cache, no-index)
 * 4. Replaces the main query with the Coming Soon page
 * 5. Renders the appropriate template
 *
 * @return void Exits after rendering if conditions are met.
 */
 add_action('template_redirect', function () {

    // =========================================================================
    // PREVIEW BYPASS - Checked first with time-safe comparison
    // =========================================================================
    $preview_key = get_option('lr_coming_soon_preview_key');

    if (
        $preview_key &&
        isset($_GET['lr_preview']) &&
        hash_equals($preview_key, (string) $_GET['lr_preview'])
    ) {
        return; // Allow normal site access
    }

    // =========================================================================
    // LOGGED-IN PREVIEW MODE - Allow admins to preview Coming Soon page
    // =========================================================================
    $force_preview = isset($_GET['lr_preview_coming_soon']) && 
                     $_GET['lr_preview_coming_soon'] === '1' &&
                     current_user_can('manage_options');

    // =========================================================================
    // GUARD CONDITIONS - Exit early if Coming Soon should not be shown
    // =========================================================================
    
    // Logged-in users see normal site (unless forcing preview)
    if (is_user_logged_in() && !$force_preview) return;
    
    // Coming Soon mode must be enabled
    if (!get_option('lr_coming_soon_enabled')) return;
    
    // Don't interfere with admin area
    if (is_admin()) return;
    
    // Don't interfere with AJAX or cron
    if (wp_doing_ajax() || wp_doing_cron()) return;
    
    // Allow RSS feeds to work normally
    if (is_feed()) return;
    
    // Allow REST API requests
    if (defined('REST_REQUEST') && REST_REQUEST) return;

    // Page must be configured and published
    $page_id = (int) get_option('lr_coming_soon_page_id');
    if (!$page_id) return;

    $post = get_post($page_id);
    if (!$post || $post->post_status !== 'publish') return;

    // =========================================================================
    // HTTP HEADERS - Set proper status and SEO directives
    // =========================================================================
    
    status_header(503);                             // Service Unavailable
    nocache_headers();                              // Prevent caching
    header('X-Robots-Tag: noindex, nofollow');     // Prevent indexing
    header('Retry-After: 86400');                   // Suggest retry in 24h

    // =========================================================================
    // QUERY REPLACEMENT - Swap main query with Coming Soon page
    // =========================================================================
    
    global $wp_query, $wp_the_query;

    // Store original queries for restoration
    $old_wp_query     = $wp_query;
    $old_wp_the_query = $wp_the_query;

    // Create new query for Coming Soon page
    $wp_query = $wp_the_query = new WP_Query([
        'post_type'      => 'page',
        'p'              => $page_id,
        'posts_per_page' => 1,
    ]);

    // Set query flags for proper template hierarchy
    $wp_query->is_home       = false;
    $wp_query->is_front_page = false;
    $wp_query->is_page       = true;
    $wp_query->is_singular   = true;

    // =========================================================================
    // TEMPLATE RENDERING - Use custom template or fallback
    // =========================================================================
    
    ob_start();

    // Look for custom template in theme
    $template = locate_template([
        'coming-soon.php',
        'templates/coming-soon.php',
        'parts/page/coming-soon.php',
    ]);

    if ($template) {
        // Use custom template
        include $template;
    } else {
        // Fallback: minimal default template
        echo '<!doctype html><html><head>';
        wp_head();
        echo '</head><body>';
        while (have_posts()) {
            the_post();
            the_content();
        }
        wp_footer();
        echo '</body></html>';
    }

    echo ob_get_clean();

    // Restore original queries (cleanup, though script exits)
    $wp_query     = $old_wp_query;
    $wp_the_query = $old_wp_the_query;

    exit; // Stop execution
 });
diff --git a/Quickstart.md b/Quickstart.md
	<?php
	/**
	* Plugin Name: LR Coming Soon Page
	* Plugin URI: https://gist.github.com/yourusername/
	* Description: Displays a customizable Coming Soon page to non-logged-in users while allowing authenticated users and preview access via a secret key. Maintains proper HTTP 503 status and SEO headers.
	* Version: 1.7.0
	* Requires at least: 5.0
	* Requires PHP: 7.4
	* Author: Luis Martinez
	* Author URI: https://www.lessrain.com
	* License: GPL v2 or later
	* License URI: https://www.gnu.org/licenses/gpl-2.0.html
	*
	* @package LR_Coming_Soon
	*/

	if (!defined('ABSPATH')) {
	exit; // Exit if accessed directly
	}

	/**
	* Disable canonical redirect when preview parameter is present.
	*
	* Prevents WordPress from redirecting when using the lr_preview parameter,
	* allowing the preview functionality to work correctly.
	*
	* @param string\|false $redirect_url The redirect URL.
	* @return string\|false Modified redirect URL or false to prevent redirect.
	*/
	add_filter('redirect_canonical', function ($redirect_url) {
	if (isset($_GET['lr_preview']) && $_GET['lr_preview'] !== '') {
	return false;
	}
	return $redirect_url;
	});

	/* ==========================================================================
	ADMIN INTERFACE
	========================================================================== */

	/**
	* Register admin settings page.
	*
	* Adds a submenu under Settings for configuring the Coming Soon page.
	*/
	add_action('admin_menu', function () {
	add_options_page(
	'LR Coming Soon', // Page title
	'LR Coming Soon', // Menu title
	'manage_options', // Capability
	'lr-coming-soon', // Menu slug
	'lr_render_coming_soon_settings' // Callback
	);
	});

	/**
	* Add preview button to admin bar.
	*
	* When Coming Soon mode is active, adds a button to the admin bar that
	* allows administrators to preview the Coming Soon page while logged in.
	*/
	add_action('admin_bar_menu', function ($wp_admin_bar) {
	// Only show if Coming Soon is enabled and user can manage options
	if (!get_option('lr_coming_soon_enabled')) return;
	if (!current_user_can('manage_options')) return;

	$wp_admin_bar->add_node([
	'id' => 'preview-coming-soon',
	'title' => '👁 Preview Coming Soon',
	'href' => home_url('/?lr_preview_coming_soon=1'),
	'meta' => [
	'title' => 'Preview the Coming Soon page as visitors see it',
	],
	]);
	}, 999);

	/**
	* Render the admin settings page.
	*
	* Displays the configuration interface for enabling/disabling the Coming Soon mode,
	* selecting the page to display, and setting the preview key.
	*/
	function lr_render_coming_soon_settings() {
	?>
	<div class="wrap">
	<h1>Coming Soon Page Settings</h1>
	<p>Configure your Coming Soon page settings below. Non-logged-in users will see the selected page when Coming Soon mode is active.</p>

	<form method="post" action="options.php">
	<?php
	settings_fields('lr-coming-soon');
	do_settings_sections('lr-coming-soon');
	?>

	<table class="form-table">
	<tr>
	<th scope="row">Enable Coming Soon Mode</th>
	<td>
	<label>
	<input type="checkbox"
	name="lr_coming_soon_enabled"
	value="1"
	<?php checked(1, get_option('lr_coming_soon_enabled')); ?>>
	Active
	</label>
	<p class="description">When enabled, non-logged-in users will see the Coming Soon page.</p>
	</td>
	</tr>

	<tr>
	<th scope="row">Coming Soon Page</th>
	<td>
	<?php
	wp_dropdown_pages([
	'name' => 'lr_coming_soon_page_id',
	'selected' => get_option('lr_coming_soon_page_id'),
	'show_option_none' => '— Select Page —',
	'option_none_value' => 0
	]);
	?>
	<p class="description">Select the published page to display as your Coming Soon content. Must be a published page.</p>
	</td>
	</tr>

	<tr>
	<th scope="row">Preview Key</th>
	<td>
	<input type="text"
	name="lr_coming_soon_preview_key"
	value="<?php echo esc_attr(get_option('lr_coming_soon_preview_key')); ?>"
	class="regular-text"
	placeholder="Enter a secret key">
	<p class="description">
	Optional: Set a secret key to bypass Coming Soon mode.<br>
	Share this URL: <code><?php echo esc_url(home_url('/?lr_preview=YOUR_KEY')); ?></code>
	</p>
	</td>
	</tr>
	</table>

	<?php submit_button(); ?>
	</form>

	<hr>

	<h2>How It Works</h2>
	<ul>
	<li><strong>Logged-in users:</strong> See the normal site (unaffected)</li>
	<li><strong>Non-logged-in users:</strong> See the Coming Soon page (when enabled)</li>
	<li><strong>Preview access:</strong> Anyone with the preview URL can view the normal site</li>
	<li><strong>HTTP 503 status:</strong> Proper status code for maintenance mode</li>
	<li><strong>SEO protection:</strong> noindex/nofollow headers prevent search engine indexing</li>
	</ul>

	<h2>Template Customization</h2>
	<p>The plugin looks for custom templates in this order:</p>
	<ol>
	<li><code>coming-soon.php</code> (theme root)</li>
	<li><code>templates/coming-soon.php</code></li>
	<li><code>parts/page/coming-soon.php</code></li>
	</ol>
	<p>If no custom template is found, it uses a minimal default template with the selected page's content.</p>
	</div>
	<?php
	}

	/* ==========================================================================
	SETTINGS REGISTRATION
	========================================================================== */

	/**
	* Register plugin settings.
	*
	* Registers three settings:
	* - lr_coming_soon_enabled: Boolean toggle for Coming Soon mode
	* - lr_coming_soon_page_id: ID of the page to display
	* - lr_coming_soon_preview_key: Secret key for preview access
	*/
	add_action('admin_init', function () {

	// Enable/disable toggle
	register_setting('lr-coming-soon', 'lr_coming_soon_enabled', 'absint');

	// Preview key
	register_setting('lr-coming-soon', 'lr_coming_soon_preview_key', 'sanitize_text_field');

	// Page selection with validation
	register_setting('lr-coming-soon', 'lr_coming_soon_page_id', [
	'type' => 'integer',
	'sanitize_callback' => function ($value) {
	$value = absint($value);

	// Ensure selected page is published
	if ($value && get_post_status($value) !== 'publish') {
	add_settings_error(
	'lr-coming-soon',
	'invalid-page',
	'Selected page must be published.'
	);
	return get_option('lr_coming_soon_page_id');
	}

	return $value;
	}
	]);
	});

	/* ==========================================================================
	ADMIN NOTICES
	========================================================================== */

	/**
	* Display admin notice when Coming Soon mode is active.
	*
	* Shows a persistent warning in the admin area to remind administrators
	* that the site is in Coming Soon mode.
	*/
	add_action('admin_notices', function () {
	if (get_option('lr_coming_soon_enabled')) {
	echo '<div class="notice notice-warning is-dismissible">';
	echo '<p><strong>⚠ Coming Soon mode is active.</strong> Non-logged-in users see the Coming Soon page.</p>';
	echo '</div>';
	}
	});

	/* ==========================================================================
	FRONTEND INTERCEPTION
	========================================================================== */

	/**
	* Intercept frontend requests and display Coming Soon page.
	*
	* This is the core functionality that:
	* 1. Checks for preview key bypass
	* 2. Validates conditions (logged in, enabled, etc.)
	* 3. Sets proper HTTP headers (503, no-cache, no-index)
	* 4. Replaces the main query with the Coming Soon page
	* 5. Renders the appropriate template
	*
	* @return void Exits after rendering if conditions are met.
	*/
	add_action('template_redirect', function () {

	// =========================================================================
	// PREVIEW BYPASS - Checked first with time-safe comparison
	// =========================================================================
	$preview_key = get_option('lr_coming_soon_preview_key');

	if (
	$preview_key &&
	isset($_GET['lr_preview']) &&
	hash_equals($preview_key, (string) $_GET['lr_preview'])
	) {
	return; // Allow normal site access
	}

	// =========================================================================
	// LOGGED-IN PREVIEW MODE - Allow admins to preview Coming Soon page
	// =========================================================================
	$force_preview = isset($_GET['lr_preview_coming_soon']) &&
	$_GET['lr_preview_coming_soon'] === '1' &&
	current_user_can('manage_options');

	// =========================================================================
	// GUARD CONDITIONS - Exit early if Coming Soon should not be shown
	// =========================================================================

	// Logged-in users see normal site (unless forcing preview)
	if (is_user_logged_in() && !$force_preview) return;

	// Coming Soon mode must be enabled
	if (!get_option('lr_coming_soon_enabled')) return;

	// Don't interfere with admin area
	if (is_admin()) return;

	// Don't interfere with AJAX or cron
	if (wp_doing_ajax() \|\| wp_doing_cron()) return;

	// Allow RSS feeds to work normally
	if (is_feed()) return;

	// Allow REST API requests
	if (defined('REST_REQUEST') && REST_REQUEST) return;

	// Page must be configured and published
	$page_id = (int) get_option('lr_coming_soon_page_id');
	if (!$page_id) return;

	$post = get_post($page_id);
	if (!$post \|\| $post->post_status !== 'publish') return;

	// =========================================================================
	// HTTP HEADERS - Set proper status and SEO directives
	// =========================================================================

	status_header(503); // Service Unavailable
	nocache_headers(); // Prevent caching
	header('X-Robots-Tag: noindex, nofollow'); // Prevent indexing
	header('Retry-After: 86400'); // Suggest retry in 24h

	// =========================================================================
	// QUERY REPLACEMENT - Swap main query with Coming Soon page
	// =========================================================================

	global $wp_query, $wp_the_query;

	// Store original queries for restoration
	$old_wp_query = $wp_query;
	$old_wp_the_query = $wp_the_query;

	// Create new query for Coming Soon page
	$wp_query = $wp_the_query = new WP_Query([
	'post_type' => 'page',
	'p' => $page_id,
	'posts_per_page' => 1,
	]);

	// Set query flags for proper template hierarchy
	$wp_query->is_home = false;
	$wp_query->is_front_page = false;
	$wp_query->is_page = true;
	$wp_query->is_singular = true;

	// =========================================================================
	// TEMPLATE RENDERING - Use custom template or fallback
	// =========================================================================

	ob_start();

	// Look for custom template in theme
	$template = locate_template([
	'coming-soon.php',
	'templates/coming-soon.php',
	'parts/page/coming-soon.php',
	]);

	if ($template) {
	// Use custom template
	include $template;
	} else {
	// Fallback: minimal default template
	echo '<!doctype html><html><head>';
	wp_head();
	echo '</head><body>';
	while (have_posts()) {
	the_post();
	the_content();
	}
	wp_footer();
	echo '</body></html>';
	}

	echo ob_get_clean();

	// Restore original queries (cleanup, though script exits)
	$wp_query = $old_wp_query;
	$wp_the_query = $old_wp_the_query;

	exit; // Stop execution
	});
No results found