Changeset 357886

Timestamp:

11/07/2026 12:35:45 PM (less than one hour ago)

Author:

themedropbox

Message:

New version of Nexversal - 3.5.9

Location:

nexversal/3.5.9

Files:

• . (copied) (copied from nexversal/2.5.2 )
• 404.php (modified) (1 diff)
• archive.php (modified) (2 diffs)
• assets/css/editor-style.css (modified) (1 diff)
• assets/js/customize-preview.js (added)
• assets/js/main.js (modified) (1 diff)
• author.php (modified) (2 diffs)
• comments.php (modified) (1 diff)
• footer.php (modified) (4 diffs)
• front-page.php (added)
• functions.php (modified) (15 diffs)
• header.php (modified) (4 diffs)
• home.php (added)
• inc/ad-cls-optimizer.php (added)
• inc/ad-manager.php (modified) (35 diffs)
• inc/cookie-consent.php (added)
• index.php (modified) (3 diffs)
• page.php (modified) (4 diffs)
• readme.txt (modified) (4 diffs)
• search.php (modified) (2 diffs)
• sidebar.php (modified) (1 diff)
• single.php (modified) (4 diffs)
• style.css (modified) (22 diffs)
• template-about.php (added)
• template-blog.php (added)
• template-contact.php (added)
• template-full-width.php (modified) (2 diffs)
• template-home.php (added)
• template-parts/content-card.php (modified) (3 diffs)
• template-parts/newsletter-box.php (modified) (1 diff)
• template-parts/social-share.php (modified) (1 diff)

nexversal/3.5.9/404.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * 404 template (Page Not Found - Enhanced Traffic Retention) for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
 
-/**
- * 404 template (Page Not Found - Enhanced Traffic Retention)
- *
- * @package Nexversal
- */
+// Failsafe auto-redirect: If visitor hits ?page_id=2 or legacy sample/about URLs, 301 redirect immediately to About Us
+$requested_page_id = isset($_GET['page_id']) ? (int) $_GET['page_id'] : 0;
+$req_uri           = isset($_SERVER['REQUEST_URI']) ? $_SERVER['REQUEST_URI'] : '';
+if ($requested_page_id === 2 || strpos($req_uri, 'page_id=2') !== false || strpos($req_uri, 'sample-page') !== false || strpos($req_uri, 'aboutAbout') !== false) {
+    $dest = function_exists('nexversal_get_about_page_url') ? nexversal_get_about_page_url() : home_url('/about/');
+    wp_safe_redirect($dest, 301);
+    exit;
+}
+
+// Master 301 Redirect Record evaluation
+$clean_path = parse_url($req_uri, PHP_URL_PATH);
+$clean_path = $clean_path ? rtrim($clean_path, '/') : '';
+if (!empty($clean_path)) {
+    $blog_url = function_exists('nexversal_get_blogs_page_url') ? nexversal_get_blogs_page_url() : home_url('/blog/');
+    $redirects = array(
+        '/aboutAbout'                                              => function_exists('nexversal_get_about_page_url') ? nexversal_get_about_page_url() : home_url('/about/'),
+        '/contactContact'                                          => function_exists('nexversal_get_contact_page_url') ? nexversal_get_contact_page_url() : home_url('/contact/'),
+        '/Home'                                                    => home_url('/'),
+        '/category/comparisonsComparisons'                         => home_url('/category/comparisons/'),
+        '/sample-page'                                             => function_exists('nexversal_get_about_page_url') ? nexversal_get_about_page_url() : home_url('/about/'),
+        '/blogs'                                                   => $blog_url,
+        '/kepler-vs-github-copilot'                                => home_url('/blog/kepler-ai-coding'),
+        '/gitkraken-kepler'                                        => home_url('/blog/setup-gitkraken-kepler'),
+        '/seo-in-the-age-of-answer-engines'                        => home_url('/blog/best-ai-seo-tools'),
+        '/search-marketing-course'                                 => home_url('/blog/best-ai-seo-tools'),
+        '/category/artificial-intelligence'                        => home_url('/blog'),
+        '/future-of-artificial-intelligence-2026'                  => home_url('/blog'),
+        '/the-self-taught-engineers-curriculum'                     => home_url('/blog/best-free-ai-tools-for-coding-2026'),
+        '/the-anatomy-of-a-supply-chain-attack'                    => home_url('/blog'),
+        '/the-quiet-revolution-of-agentic-llms'                    => home_url('/blog/chatgpt-vs-claude-vs-gemini-which-should-you-use'),
+        '/designing-with-restraint'                                => home_url('/blog'),
+        '/best-ai-video-generators-for-creators-in-2026'          => home_url('/blog/ai-tools-for-a-video-generator'),
+        '/category/education'                                      => home_url('/blog/best-ai-tools-for-students'),
+        '/why-pricing-is-strategy-not-a-number'                    => home_url('/blog/ai-tools-for-small-business'),
+        '/how-to-learn-seo-at-home-for-free-complete-2026-roadmap' => home_url('/blog/best-ai-seo-tools'),
+        '/key-takeaways-for-mastering-rankings'                    => home_url('/blog/best-ai-seo-tools'),
+        '/the-best-chatgpt-alternatives-worth-trying'              => home_url('/blog/chatgpt-alternatives'),
+        '/best-ai-tools-for-text-to-video-generators'              => home_url('/blog/ai-tools-for-a-video-generator'),
+        '/ai-tools-for-text-to-video-generators'                   => home_url('/blog/ai-tools-for-a-video-generator'),
+    );
+
+    if (isset($redirects[$clean_path])) {
+        wp_safe_redirect($redirects[$clean_path], 301);
+        exit;
+    }
+}
+
+// Failsafe virtual ads.txt interceptor if server routed request to 404
+if (preg_match('#^/ads\.txt(\?.*)?$#i', $req_uri)) {
+    if (function_exists('nexversal_render_virtual_ads_txt_output')) {
+        nexversal_render_virtual_ads_txt_output();
+    }
+}
 
 get_header();

nexversal/3.5.9/archive.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Archive template (Categories, Tags, Authors, Dates) for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Archive template (Categories, Tags, Authors, Dates)
- *
- * @package Nexversal
- */
 
 get_header();
@@ -52 +53 @@
         </div>
 
-        <?php get_sidebar(); ?>
+        <?php
+        if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_sidebar')) {
+            get_sidebar();
+        }
+        ?>
     </div>
 </main>

nexversal/3.5.9/assets/css/editor-style.css

@@ -177 +177 @@
 }
 
+/* ==========================================================================
+   Hero Banner Block Styles inside Gutenberg Block Editor
+   ========================================================================== */
+.nx-hero-section {
+  padding: 36px 20px;
+  background: #f8fafc;
+  border: 1px solid #e2e8f0;
+  border-radius: 12px;
+  margin-bottom: 30px;
+}
+
+.nx-hero-badge {
+  display: inline-block;
+  font-size: 0.75rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: #4f46e5;
+  background: #eef2ff;
+  padding: 5px 14px;
+  border-radius: 20px;
+  margin-bottom: 14px;
+}
+
+.nx-hero-title {
+  font-size: 2.2rem;
+  font-weight: 900;
+  line-height: 1.2;
+  letter-spacing: -0.03em;
+  color: #0f172a;
+  margin-bottom: 14px;
+}
+
+.nx-hero-description {
+  font-size: 1.1rem;
+  line-height: 1.65;
+  color: #64748b;
+  max-width: 780px;
+  margin-bottom: 20px;
+}
+
+.nx-hero-btn .wp-block-button__link {
+  display: inline-flex;
+  align-items: center;
+  padding: 12px 28px;
+  background-color: #4f46e5 !important;
+  color: #ffffff !important;
+  border-radius: 30px !important;
+  font-weight: 700;
+  font-size: 0.95rem;
+  text-decoration: none;
+}
+
+/* Newsletter Card Styles in Gutenberg Editor */
+.nx-newsletter-card {
+  background: linear-gradient(135deg, rgba(79, 70, 229, 0.06) 0%, rgba(6, 182, 212, 0.06) 100%);
+  border: 1px solid #e2e8f0;
+  border-radius: 12px;
+  padding: 30px 24px;
+  margin: 32px 0;
+}
+
+.nx-newsletter-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 12px;
+  background: #eef2ff;
+  color: #4f46e5;
+  border-radius: 20px;
+  font-size: 0.75rem;
+  font-weight: 700;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  margin-bottom: 12px;
+}
+
+.nx-newsletter-title {
+  font-size: 1.5rem !important;
+  font-weight: 800 !important;
+  color: #0f172a !important;
+  margin: 0 0 8px 0 !important;
+}
+
+.nx-newsletter-desc {
+  font-size: 0.95rem;
+  color: #64748b;
+  margin-bottom: 18px;
+}
+
+.nx-newsletter-input-group {
+  display: flex;
+  gap: 10px;
+  max-width: 500px;
+}
+
+.nx-newsletter-input {
+  flex: 1;
+  padding: 10px 16px;
+  border: 1px solid #cbd5e1;
+  border-radius: 8px;
+  font-size: 0.9rem;
+}
+
+.nx-newsletter-btn {
+  padding: 10px 22px;
+  background: #4f46e5;
+  color: #ffffff;
+  border: none;
+  border-radius: 8px;
+  font-weight: 700;
+  cursor: pointer;
+}
+
+.nx-newsletter-privacy {
+  font-size: 0.8rem;
+  color: #94a3b8;
+  margin-top: 8px;
+}
+
+/* Contact Details in Editor */
+.nx-contact-details {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+  margin-top: 16px;
+}
+
+.nx-contact-item {
+  margin-bottom: 8px;
+}
+
+.nx-contact-label {
+  font-size: 0.78rem !important;
+  font-weight: 700 !important;
+  color: #64748b !important;
+  text-transform: uppercase !important;
+  letter-spacing: 0.05em !important;
+  margin-bottom: 2px !important;
+}
+
+.nx-contact-val {
+  font-weight: 600 !important;
+  font-size: 0.95rem !important;
+  color: #0f172a !important;
+  margin-top: 0 !important;
+  margin-bottom: 0 !important;
+}
+
+
+

nexversal/3.5.9/assets/js/main.js

@@ -228 +228 @@
         }
     }
+
+    // 8. Newsletter Subscription Persistence on Load (Logged-in or Previously Subscribed)
+    try {
+        if (localStorage.getItem('nx_newsletter_subscribed') === 'true') {
+            document.querySelectorAll('.nx-newsletter-v2').forEach(function (box) {
+                var f = box.querySelector('.nx-newsletter-form-v2');
+                var s = box.querySelector('.nx-nl-success-card');
+                if (f && s) {
+                    f.style.display = 'none';
+                    s.style.display = 'block';
+                }
+            });
+        }
+    } catch (err) {}
+
+    // 9. Newsletter AJAX Subscription Handler with Validation & WP-Admin Storage
+    document.addEventListener('submit', function (e) {
+        var form = e.target.closest('.nx-newsletter-form, .nx-newsletter-form-v2');
+        if (!form) return;
+        e.preventDefault();
+
+        var input = form.querySelector('.nx-newsletter-input') || form.querySelector('input[type="email"]');
+        var btn = form.querySelector('.nx-newsletter-btn') || form.querySelector('button[type="submit"]');
+        var email = input ? input.value.trim() : '';
+
+        if (!email) {
+            alert('Please enter your email address to subscribe.');
+            if (input) input.focus();
+            return;
+        }
+
+        // Email validation regex
+        var emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        if (!emailRegex.test(email)) {
+            alert('Please enter a valid email format (e.g. name@company.com).');
+            if (input) input.focus();
+            return;
+        }
+
+        // Disable button while processing
+        var originalBtnHtml = btn ? btn.innerHTML : '';
+        if (btn) {
+            btn.disabled = true;
+            btn.innerHTML = '<span>Subscribing...</span>';
+        }
+
+        var ajaxUrl = (typeof nexversal_ajax !== 'undefined' && nexversal_ajax.ajax_url) ? nexversal_ajax.ajax_url : '/wp-admin/admin-ajax.php';
+        var nonce = (typeof nexversal_ajax !== 'undefined' && nexversal_ajax.nonce) ? nexversal_ajax.nonce : '';
+
+        var formData = new FormData();
+        formData.append('action', 'nexversal_subscribe');
+        formData.append('nonce', nonce);
+        formData.append('email', email);
+
+        fetch(ajaxUrl, {
+            method: 'POST',
+            body: formData
+        })
+        .then(function (res) { return res.json(); })
+        .then(function (data) {
+            if (data.success) {
+                try {
+                    localStorage.setItem('nx_newsletter_subscribed', 'true');
+                } catch (e) {}
+
+                var v2Container = form.closest('.nx-newsletter-v2');
+                if (v2Container) {
+                    var successCard = v2Container.querySelector('.nx-nl-success-card');
+                    if (successCard) {
+                        form.style.display = 'none';
+                        successCard.style.display = 'block';
+                        return;
+                    }
+                }
+
+                if (btn) {
+                    btn.innerHTML = '<span>✓ ' + data.data.message + '</span>';
+                    btn.style.background = '#10b981';
+                }
+                if (input) {
+                    input.disabled = true;
+                    input.style.borderColor = '#10b981';
+                }
+            } else {
+                if (btn) {
+                    btn.disabled = false;
+                    btn.innerHTML = originalBtnHtml || '<span>Subscribe &rarr;</span>';
+                }
+                alert(data.data ? data.data.message : 'Error subscribing. Please try again.');
+            }
+        })
+        .catch(function () {
+            if (btn) {
+                btn.disabled = false;
+                btn.innerHTML = originalBtnHtml || '<span>Subscribe &rarr;</span>';
+            }
+            alert('Unable to process subscription right now. Please try again later.');
+        });
+    });
+
+    // 10. Built-in Ad Engine: Impressions Tracking, Click Tracker & Ad-Blocker Bypass
+    var adSlots = document.querySelectorAll('.nx-ad-slot');
+    if (adSlots.length > 0) {
+        var ajaxUrl = (typeof nexversal_ajax !== 'undefined' && nexversal_ajax.ajax_url) ? nexversal_ajax.ajax_url : '/wp-admin/admin-ajax.php';
+
+        // A. Record Impressions on load
+        adSlots.forEach(function (slot) {
+            var slotName = slot.getAttribute('data-ad-slot');
+            if (slotName) {
+                var fd = new FormData();
+                fd.append('action', 'nexversal_ad_beacon');
+                fd.append('slot', slotName);
+                fd.append('type', 'impression');
+                if (navigator.sendBeacon) {
+                    navigator.sendBeacon(ajaxUrl, fd);
+                } else {
+                    fetch(ajaxUrl, { method: 'POST', body: fd, keepalive: true }).catch(function () {});
+                }
+            }
+        });
+
+        // B. Record Clicks on Ad Links
+        document.addEventListener('click', function (e) {
+            var adLink = e.target.closest('.nx-ad-slot a');
+            if (!adLink) return;
+            var slot = adLink.closest('.nx-ad-slot');
+            var slotName = slot ? slot.getAttribute('data-ad-slot') : '';
+            if (slotName) {
+                var fd = new FormData();
+                fd.append('action', 'nexversal_ad_beacon');
+                fd.append('slot', slotName);
+                fd.append('type', 'click');
+                if (navigator.sendBeacon) {
+                    navigator.sendBeacon(ajaxUrl, fd);
+                } else {
+                    fetch(ajaxUrl, { method: 'POST', body: fd, keepalive: true }).catch(function () {});
+                }
+            }
+        });
+
+        // C. Ad-Blocker Bypass Detection & Fallback Switcher
+        var bypassElements = document.querySelectorAll('.nx-ad-blocker-bypass');
+        if (bypassElements.length > 0) {
+            var bait = document.createElement('div');
+            bait.className = 'ads ad adsense ad-banner sponsor pub_300x250 text-ad';
+            bait.style.cssText = 'position:absolute;left:-9999px;top:-9999px;width:1px;height:1px;';
+            document.body.appendChild(bait);
+
+            window.setTimeout(function () {
+                var isBlocked = (bait.offsetParent === null || bait.offsetHeight === 0 || bait.clientHeight === 0);
+                if (isBlocked) {
+                    bypassElements.forEach(function (bypass) {
+                        var parentSlot = bypass.closest('.nx-ad-slot');
+                        if (parentSlot) {
+                            var content = parentSlot.querySelector('.nx-ad-content');
+                            if (content) content.style.display = 'none';
+                            bypass.style.display = 'block';
+                        }
+                    });
+                }
+                if (bait && bait.parentNode) {
+                    bait.parentNode.removeChild(bait);
+                }
+            }, 120);
+        }
+    }
 });

nexversal/3.5.9/author.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Author Archive Template for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Author Archive Template
- *
- * @package Nexversal
- */
 
 get_header();
@@ -70 +71 @@
                 <?php endif; ?>
             </div>
-            <?php get_sidebar(); ?>
+            <?php
+            if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_sidebar')) {
+                get_sidebar();
+            }
+            ?>
         </div>
     </div>

nexversal/3.5.9/comments.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Comments template for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Modern Comments Template
- *
- * @package Nexversal
- */
 
 if (post_password_required()) {

nexversal/3.5.9/footer.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Footer template for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Footer template
- *
- * @package Nexversal
- */
 ?>
+<?php if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_footer')) : ?>
 <footer id="colophon" class="site-footer">
     <div class="container">
@@ -30 +32 @@
                 <div class="footer-widget">
                     <h4 class="widget-title"><?php bloginfo('name'); ?></h4>
-                    <p style="line-height:1.6;"><?php bloginfo('description'); ?></p>
-                    <p style="font-size:0.85rem;color:#64748b;"><?php esc_html_e('Empowering creators, developers, and businesses with actionable technology insights.', 'nexversal'); ?></p>
+                    <?php
+                    $site_desc = get_bloginfo('description');
+                    if (!empty($site_desc)) :
+                        ?>
+                        <p style="line-height: 1.6; color: #94a3b8; font-size: 0.92rem; margin-top: 8px;"><?php echo esc_html($site_desc); ?></p>
+                    <?php endif; ?>
                 </div>
                 <div class="footer-widget">
@@ -96 +102 @@
                     ?>
                     <p class="nx-footer-credits">
-                        &copy; <?php echo esc_html(gmdate('Y')); ?>. <?php esc_html_e('All rights reserved.', 'nexversal'); ?>
+                        <?php
+                        $site_name = get_bloginfo('name');
+                        if (empty($site_name)) {
+                            $site_name = 'Nexversal';
+                        }
+                        $site_year = gmdate('Y');
+                        ?>
+                        &copy; <?php echo esc_html($site_year); ?> <?php echo esc_html($site_name); ?>. <?php esc_html_e('All rights reserved.', 'nexversal'); ?>
                         <span class="nx-footer-sep">&bull;</span>
                         <?php
@@ -119 +132 @@
     </div>
 </footer>
+<?php endif; // End disable_footer check ?>
 
 <button type="button" id="nx-back-to-top" aria-label="<?php esc_attr_e('Back to top', 'nexversal'); ?>">

nexversal/3.5.9/functions.php

@@ -1 +1 @@
 <?php
 /**
- * Nexversal Theme Functions & Definitions
+ * Nexversal WordPress Theme functions and definitions
  *
  * @package Nexversal
- * @version 2.5.2
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
+ * @version 3.3.0
  */
 
@@ -68 +72 @@
         add_theme_support('wp-block-styles');
 
-        // Custom Header support.
+        // Custom background support.
+        add_theme_support('custom-background', apply_filters('nexversal_custom_background_args', array(
+            'default-color' => 'ffffff',
+            'default-image' => '',
+        )));
+
+        // Custom header support.
         add_theme_support('custom-header', apply_filters('nexversal_custom_header_args', array(
             'default-image' => '',
             'width'         => 1200,
-            'height'        => 300,
+            'height'        => 280,
             'flex-height'   => true,
             'flex-width'    => true,
             'header-text'   => false,
-        )));
-
-        // Custom Background support.
-        add_theme_support('custom-background', apply_filters('nexversal_custom_background_args', array(
-            'default-color' => 'ffffff',
         )));
     }
@@ -99 +104 @@
         register_block_pattern_category('nexversal', array(
             'label' => esc_html__('Nexversal', 'nexversal'),
+        ));
+    }
+    if (function_exists('register_block_pattern')) {
+        register_block_pattern('nexversal/hero-banner', array(
+            'title'       => esc_html__('Homepage Hero Banner', 'nexversal'),
+            'description' => esc_html__('High-impact hero banner with badge, headline, description, and CTA button.', 'nexversal'),
+            'categories'  => array('nexversal'),
+            'content'     => '<!-- wp:group {"className":"nx-hero-section","layout":{"type":"constrained"}} -->
+<div class="wp-block-group nx-hero-section"><div class="container">
+<!-- wp:paragraph {"className":"nx-hero-badge"} -->
+<p class="nx-hero-badge">MASTER AI WITH POWERFUL &amp; READY-TO-USE PROMPTS</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading {"level":1,"className":"nx-hero-title"} -->
+<h1 class="wp-block-heading nx-hero-title">Copy, paste, and customize high-performing prompts for modern AI tools and workflows.</h1>
+<!-- /wp:heading -->
+
+<!-- wp:paragraph {"className":"nx-hero-description"} -->
+<p class="nx-hero-description">Discover the ultimate AI prompt library. Copy, paste, and customize expert-tested ChatGPT, Midjourney, and Claude prompts to boost your productivity instantly.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:buttons {"className":"nx-hero-actions"} -->
+<div class="wp-block-buttons nx-hero-actions">
+<!-- wp:button {"className":"nx-hero-btn"} -->
+<div class="wp-block-button nx-hero-btn"><a class="wp-block-button__link wp-element-button" href="#primary">Explore Articles &rarr;</a></div>
+<!-- /wp:button -->
+</div>
+<!-- /wp:buttons -->
+</div></div>
+<!-- /wp:group -->',
         ));
     }
@@ -132 +167 @@
 
 /**
+ * GDPR & Google AdSense Cookie Consent Manager
+ */
+require_once get_template_directory() . '/inc/cookie-consent.php';
+
+/**
  * Set the content width in pixels, based on the theme's design and stylesheet.
  */
@@ -202 +242 @@
     );
 
+    wp_localize_script('nexversal-main', 'nexversal_ajax', array(
+        'ajax_url' => admin_url('admin-ajax.php'),
+        'nonce'    => wp_create_nonce('nexversal_newsletter_nonce'),
+    ));
+
     if (is_singular() && comments_open() && get_option('thread_comments')) {
         wp_enqueue_script('comment-reply');
     }
 
-    // Dynamic customizer accent color injection
-    $accent = get_theme_mod('nexversal_accent_color', '#4f46e5');
-    if ($accent && $accent !== '#4f46e5') {
-        $custom_css = ":root { --nx-primary: {$accent}; --nx-primary-hover: {$accent}; }";
-        wp_add_inline_style('nexversal-style', $custom_css);
-    }
+    // Dynamic customizer color injection for theme & all buttons
+    $accent       = get_theme_mod('nexversal_accent_color', '#4f46e5');
+    $btn_bg       = get_theme_mod('nexversal_btn_bg_color', '');
+    $btn_text     = get_theme_mod('nexversal_btn_text_color', '#ffffff');
+    $btn_hover_bg = get_theme_mod('nexversal_btn_hover_bg_color', '');
+
+    if (empty($btn_bg)) {
+        $btn_bg = $accent ? $accent : '#4f46e5';
+    }
+    if (empty($btn_text)) {
+        $btn_text = '#ffffff';
+    }
+    if (empty($btn_hover_bg)) {
+        $btn_hover_bg = $btn_bg;
+    }
+
+    $custom_css = "
+        :root {
+            --nx-primary: {$accent};
+            --nx-primary-hover: {$accent};
+            --nx-btn-bg: {$btn_bg};
+            --nx-btn-text: {$btn_text};
+            --nx-btn-hover: {$btn_hover_bg};
+        }
+        .nx-hero-btn,
+        .nx-btn,
+        .nx-btn-primary,
+        .nx-card-cta,
+        .nx-newsletter-btn,
+        .nx-contact-submit,
+        .wp-block-button__link,
+        .wp-element-button,
+        button[type=\"submit\"],
+        input[type=\"submit\"],
+        .comment-form .submit,
+        #commentform #submit,
+        .search-submit {
+            background-color: var(--nx-btn-bg, {$btn_bg}) !important;
+            color: var(--nx-btn-text, {$btn_text}) !important;
+            border-color: var(--nx-btn-bg, {$btn_bg}) !important;
+        }
+        .nx-hero-btn:hover,
+        .nx-btn:hover,
+        .nx-btn-primary:hover,
+        .nx-card-cta:hover,
+        .nx-newsletter-btn:hover,
+        .nx-contact-submit:hover,
+        .wp-block-button__link:hover,
+        .wp-element-button:hover,
+        button[type=\"submit\"]:hover,
+        input[type=\"submit\"]:hover,
+        .comment-form .submit:hover,
+        #commentform #submit:hover,
+        .search-submit:hover {
+            background-color: var(--nx-btn-hover, {$btn_hover_bg}) !important;
+            border-color: var(--nx-btn-hover, {$btn_hover_bg}) !important;
+        }
+    ";
+    wp_add_inline_style('nexversal-style', $custom_css);
 }
 add_action('wp_enqueue_scripts', 'nexversal_scripts');
 
 /**
+ * Enqueue live preview scripts in WordPress Customizer.
+ */
+function nexversal_customize_preview_js() {
+    wp_enqueue_script(
+        'nexversal-customize-preview',
+        get_template_directory_uri() . '/assets/js/customize-preview.js',
+        array('customize-preview', 'jquery'),
+        '2.8.0',
+        true
+    );
+}
+add_action('customize_preview_init', 'nexversal_customize_preview_js');
+
+/**
+ * Render callback for hero button partial selective refresh.
+ */
+function nexversal_render_hero_button() {
+    $hero_btn_text = get_theme_mod('nexversal_hero_btn_text', 'Explore Articles');
+    $hero_btn_url  = get_theme_mod('nexversal_hero_btn_url', '#primary');
+    if (!empty($hero_btn_text)) :
+        ?>
+        <div class="nx-hero-actions nx-hero-btn-wrap" style="margin-bottom: 22px;">
+            <a href="<?php echo esc_url($hero_btn_url); ?>" class="nx-btn nx-btn-primary nx-hero-btn" data-nx-setting="nexversal_hero_btn_text">
+                <span class="nx-hero-btn-label"><?php echo esc_html($hero_btn_text); ?></span>
+                <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" style="margin-left: 6px;"><line x1="5" y1="12" x2="19" y2="12"></line><polyline points="12 5 19 12 12 19"></polyline></svg>
+            </a>
+        </div>
+        <?php
+    endif;
+}
+
+/**
  * Customizer options.
  */
 function nexversal_customize_register($wp_customize) {
-    // Styling Section
+    // Remove default Background Image and Header Image sections
+    $wp_customize->remove_section('background_image');
+    $wp_customize->remove_section('header_image');
+
+    // Styling Section - Colors for theme and all buttons
     $wp_customize->add_section('nexversal_styling', array(
-        'title'    => esc_html__('Theme Styling & Colors', 'nexversal'),
-        'priority' => 30,
-    ));
-
+        'title'       => esc_html__('Theme Styling & Colors', 'nexversal'),
+        'priority'    => 30,
+        'description' => esc_html__('Customize colors for the theme and all buttons across your entire website.', 'nexversal'),
+    ));
+
+    // Accent / Primary Color
     $wp_customize->add_setting('nexversal_accent_color', array(
         'default'           => '#4f46e5',
         'sanitize_callback' => 'sanitize_hex_color',
-    ));
-
+        'transport'         => 'postMessage',
+    ));
     $wp_customize->add_control(new WP_Customize_Color_Control($wp_customize, 'nexversal_accent_color', array(
-        'label'    => esc_html__('Accent / Primary Color', 'nexversal'),
+        'label'    => esc_html__('Theme Accent / Primary Color', 'nexversal'),
         'section'  => 'nexversal_styling',
         'settings' => 'nexversal_accent_color',
+        'priority' => 10,
+    )));
+
+    // Buttons Background Color
+    $wp_customize->add_setting('nexversal_btn_bg_color', array(
+        'default'           => '#4f46e5',
+        'sanitize_callback' => 'sanitize_hex_color',
+        'transport'         => 'postMessage',
+    ));
+    $wp_customize->add_control(new WP_Customize_Color_Control($wp_customize, 'nexversal_btn_bg_color', array(
+        'label'       => esc_html__('All Buttons Background Color', 'nexversal'),
+        'description' => esc_html__('Sets background color for hero CTA, cards, forms, blocks, and all site buttons.', 'nexversal'),
+        'section'     => 'nexversal_styling',
+        'settings'    => 'nexversal_btn_bg_color',
+        'priority'    => 20,
+    )));
+
+    // Buttons Text Color
+    $wp_customize->add_setting('nexversal_btn_text_color', array(
+        'default'           => '#ffffff',
+        'sanitize_callback' => 'sanitize_hex_color',
+        'transport'         => 'postMessage',
+    ));
+    $wp_customize->add_control(new WP_Customize_Color_Control($wp_customize, 'nexversal_btn_text_color', array(
+        'label'       => esc_html__('All Buttons Text Color', 'nexversal'),
+        'description' => esc_html__('Sets text and icon color inside all website buttons.', 'nexversal'),
+        'section'     => 'nexversal_styling',
+        'settings'    => 'nexversal_btn_text_color',
+        'priority'    => 30,
+    )));
+
+    // Buttons Hover Background Color
+    $wp_customize->add_setting('nexversal_btn_hover_bg_color', array(
+        'default'           => '#4338ca',
+        'sanitize_callback' => 'sanitize_hex_color',
+        'transport'         => 'postMessage',
+    ));
+    $wp_customize->add_control(new WP_Customize_Color_Control($wp_customize, 'nexversal_btn_hover_bg_color', array(
+        'label'       => esc_html__('All Buttons Hover Background Color', 'nexversal'),
+        'description' => esc_html__('Hover state background color for all website buttons.', 'nexversal'),
+        'section'     => 'nexversal_styling',
+        'settings'    => 'nexversal_btn_hover_bg_color',
+        'priority'    => 40,
     )));
 
@@ -254 +433 @@
 
     $wp_customize->add_setting('nexversal_hero_badge', array(
-        'default'           => 'Tech & Trends 2026',
+        'default'           => 'MASTER AI WITH POWERFUL & READY-TO-USE PROMPTS',
         'sanitize_callback' => 'sanitize_text_field',
     ));
@@ -265 +444 @@
 
     $wp_customize->add_setting('nexversal_hero_title', array(
-        'default'           => 'Discover In-Depth Tech Reviews, Guides & Insights',
+        'default'           => 'Copy, paste, and customize high-performing prompts for modern AI tools and workflows.',
         'sanitize_callback' => 'sanitize_text_field',
     ));
@@ -276 +455 @@
 
     $wp_customize->add_setting('nexversal_hero_desc', array(
-        'default'           => 'Explore curated articles on software, AI tools, comparisons, and modern web development.',
+        'default'           => 'Discover the ultimate AI prompt library. Copy, paste, and customize expert-tested ChatGPT, Midjourney, and Claude prompts to boost your productivity instantly.',
         'sanitize_callback' => 'sanitize_textarea_field',
     ));
@@ -289 +468 @@
         'default'           => 'Explore Articles',
         'sanitize_callback' => 'sanitize_text_field',
+        'transport'         => 'postMessage',
     ));
     $wp_customize->add_control('nexversal_hero_btn_text', array(
         'label'       => esc_html__('Hero Button Text', 'nexversal'),
-        'description' => esc_html__('Text for the primary CTA button in the hero banner. Leave empty to hide button.', 'nexversal'),
+        'description' => esc_html__('Text for the primary CTA button in the hero banner. Click button in preview to edit.', 'nexversal'),
         'section'     => 'nexversal_hero',
         'type'        => 'text',
@@ -301 +481 @@
         'default'           => '#primary',
         'sanitize_callback' => 'esc_url_raw',
+        'transport'         => 'postMessage',
     ));
     $wp_customize->add_control('nexversal_hero_btn_url', array(
@@ -310 +491 @@
     ));
 
-    // Custom Buttons & CTAs Section
-    $wp_customize->add_section('nexversal_buttons', array(
-        'title'       => esc_html__('Buttons & CTA Customization', 'nexversal'),
-        'priority'    => 38,
-        'description' => esc_html__('Customize the wording on buttons across cards, newsletters, and system pages.', 'nexversal'),
-    ));
-
-    $wp_customize->add_setting('nexversal_card_btn_text', array(
-        'default'           => 'Read Article',
-        'sanitize_callback' => 'sanitize_text_field',
-    ));
-    $wp_customize->add_control('nexversal_card_btn_text', array(
-        'label'       => esc_html__('Post Card "Read More" Button Text', 'nexversal'),
-        'description' => esc_html__('Text displayed on article cards in grids (e.g. Read Article, Continue Reading, Learn More). Leave empty to hide.', 'nexversal'),
-        'section'     => 'nexversal_buttons',
-        'type'        => 'text',
-        'priority'    => 10,
-    ));
-
-    $wp_customize->add_setting('nexversal_newsletter_btn_text', array(
-        'default'           => 'Subscribe',
-        'sanitize_callback' => 'sanitize_text_field',
-    ));
-    $wp_customize->add_control('nexversal_newsletter_btn_text', array(
-        'label'       => esc_html__('Newsletter Submit Button Text', 'nexversal'),
-        'description' => esc_html__('Text on the subscription form button (e.g. Subscribe, Join Now, Get Updates).', 'nexversal'),
-        'section'     => 'nexversal_buttons',
-        'type'        => 'text',
-        'priority'    => 20,
-    ));
-
-    $wp_customize->add_setting('nexversal_404_btn_text', array(
-        'default'           => 'Back to Homepage',
-        'sanitize_callback' => 'sanitize_text_field',
-    ));
-    $wp_customize->add_control('nexversal_404_btn_text', array(
-        'label'       => esc_html__('404 Page Return Button Text', 'nexversal'),
-        'description' => esc_html__('Text on the error page button returning visitors to home.', 'nexversal'),
-        'section'     => 'nexversal_buttons',
-        'type'        => 'text',
-        'priority'    => 30,
-    ));
+    // Selective refresh for Hero Button (Shortcut pencil in preview)
+    if (isset($wp_customize->selective_refresh)) {
+        $wp_customize->selective_refresh->add_partial('nexversal_hero_btn_partial', array(
+            'selector'            => '.nx-hero-btn-wrap',
+            'settings'            => array('nexversal_hero_btn_text', 'nexversal_hero_btn_url'),
+            'render_callback'     => 'nexversal_render_hero_button',
+            'container_inclusive' => true,
+        ));
+    }
 
     // Social Media Section
@@ -382 +530 @@
     }
 
+    // Contact Page Settings Section
+    $wp_customize->add_section('nexversal_contact', array(
+        'title'       => esc_html__('Contact Page Settings', 'nexversal'),
+        'priority'    => 42,
+        'description' => esc_html__('Customize the contact information card, support email, headquarters location, and response times on your Contact page.', 'nexversal'),
+    ));
+
+    // Enable/Disable Contact Info Card
+    $wp_customize->add_setting('nexversal_show_contact_info', array(
+        'default'           => true,
+        'sanitize_callback' => 'nexversal_sanitize_checkbox',
+    ));
+    $wp_customize->add_control('nexversal_show_contact_info', array(
+        'label'       => esc_html__('Show Contact Information Card', 'nexversal'),
+        'description' => esc_html__('Display the contact details card alongside the message form.', 'nexversal'),
+        'section'     => 'nexversal_contact',
+        'type'        => 'checkbox',
+    ));
+
+    // Contact Title
+    $wp_customize->add_setting('nexversal_contact_title', array(
+        'default'           => 'Contact Information',
+        'sanitize_callback' => 'sanitize_text_field',
+    ));
+    $wp_customize->add_control('nexversal_contact_title', array(
+        'label'   => esc_html__('Card Heading', 'nexversal'),
+        'section' => 'nexversal_contact',
+        'type'    => 'text',
+    ));
+
+    // Contact Description
+    $wp_customize->add_setting('nexversal_contact_desc', array(
+        'default'           => 'We are dedicated to fast response times and transparent communication.',
+        'sanitize_callback' => 'sanitize_textarea_field',
+    ));
+    $wp_customize->add_control('nexversal_contact_desc', array(
+        'label'   => esc_html__('Card Description', 'nexversal'),
+        'section' => 'nexversal_contact',
+        'type'    => 'textarea',
+    ));
+
+    // Support Email
+    $wp_customize->add_setting('nexversal_contact_email', array(
+        'default'           => get_option('admin_email', 'contact@nexversal.com'),
+        'sanitize_callback' => 'sanitize_email',
+    ));
+    $wp_customize->add_control('nexversal_contact_email', array(
+        'label'       => esc_html__('Support Email Address', 'nexversal'),
+        'description' => esc_html__('The public email address visitors can write to.', 'nexversal'),
+        'section'     => 'nexversal_contact',
+        'type'        => 'email',
+    ));
+
+    // Headquarters Text
+    $wp_customize->add_setting('nexversal_contact_hq_text', array(
+        'default'           => 'nexversal.com/contact',
+        'sanitize_callback' => 'sanitize_text_field',
+    ));
+    $wp_customize->add_control('nexversal_contact_hq_text', array(
+        'label'   => esc_html__('Official Headquarters Text / City', 'nexversal'),
+        'section' => 'nexversal_contact',
+        'type'    => 'text',
+    ));
+
+    // Headquarters URL
+    $wp_customize->add_setting('nexversal_contact_hq_url', array(
+        'default'           => 'https://nexversal.com/contact',
+        'sanitize_callback' => 'esc_url_raw',
+    ));
+    $wp_customize->add_control('nexversal_contact_hq_url', array(
+        'label'   => esc_html__('Headquarters Link / Maps URL', 'nexversal'),
+        'section' => 'nexversal_contact',
+        'type'    => 'url',
+    ));
+
+    // Custom Social Links (One URL per line)
+    $wp_customize->add_setting('nexversal_custom_social_links', array(
+        'default'           => "https://facebook.com/nexversal\nhttps://twitter.com/nexversal\nhttps://linkedin.com/company/nexversal\nhttps://github.com/nexversal\nhttps://youtube.com/@nexversal",
+        'sanitize_callback' => 'sanitize_textarea_field',
+    ));
+    $wp_customize->add_control('nexversal_custom_social_links', array(
+        'label'       => esc_html__('Social & Website Links (One URL per line)', 'nexversal'),
+        'description' => esc_html__('Add your Facebook, X/Twitter, LinkedIn, Instagram, YouTube, GitHub, TikTok, Discord, Telegram, or personal website links. Logos are auto-detected!', 'nexversal'),
+        'section'     => 'nexversal_contact',
+        'type'        => 'textarea',
+    ));
+
+    // Homepage Author Section (Image 3)
+    $wp_customize->add_section('nexversal_homepage_author', array(
+        'title'    => esc_html__('Homepage Author Box', 'nexversal'),
+        'priority' => 38,
+    ));
+
+    $wp_customize->add_setting('nexversal_author_name', array(
+        'default'           => 'Muhammad Shahid',
+        'sanitize_callback' => 'sanitize_text_field',
+    ));
+    $wp_customize->add_control('nexversal_author_name', array(
+        'label'   => esc_html__('Author Name', 'nexversal'),
+        'section' => 'nexversal_homepage_author',
+        'type'    => 'text',
+    ));
+
+    $wp_customize->add_setting('nexversal_author_role', array(
+        'default'           => 'Founder & Editor',
+        'sanitize_callback' => 'sanitize_text_field',
+    ));
+    $wp_customize->add_control('nexversal_author_role', array(
+        'label'   => esc_html__('Author Role / Title', 'nexversal'),
+        'section' => 'nexversal_homepage_author',
+        'type'    => 'text',
+    ));
+
+    $wp_customize->add_setting('nexversal_author_link', array(
+        'default'           => home_url('/about/'),
+        'sanitize_callback' => 'esc_url_raw',
+    ));
+    $wp_customize->add_control('nexversal_author_link', array(
+        'label'       => esc_html__('Author Profile / Website Link (Clickable URL)', 'nexversal'),
+        'description' => esc_html__('Enter the link destination when users click the author name, role, or avatar.', 'nexversal'),
+        'section'     => 'nexversal_homepage_author',
+        'type'        => 'url',
+    ));
+
+    $wp_customize->add_setting('nexversal_author_avatar', array(
+        'default'           => '',
+        'sanitize_callback' => 'esc_url_raw',
+    ));
+    $wp_customize->add_control(new WP_Customize_Image_Control($wp_customize, 'nexversal_author_avatar', array(
+        'label'       => esc_html__('Author Profile Photo / Avatar', 'nexversal'),
+        'description' => esc_html__('Upload a profile picture. If left empty, the first initial of the author name will be displayed in the gradient circle.', 'nexversal'),
+        'section'     => 'nexversal_homepage_author',
+    )));
+
+    $wp_customize->add_setting('nexversal_author_bio', array(
+        'default'           => 'Researches and writes every review and comparison on Nexversal.',
+        'sanitize_callback' => 'sanitize_textarea_field',
+    ));
+    $wp_customize->add_control('nexversal_author_bio', array(
+        'label'   => esc_html__('Author Bio', 'nexversal'),
+        'section' => 'nexversal_homepage_author',
+        'type'    => 'textarea',
+    ));
+
+    // Homepage Newsletter Box Customization (Image 2 Design & Success State)
+    $wp_customize->add_section('nexversal_newsletter', array(
+        'title'    => esc_html__('Homepage Newsletter Box', 'nexversal'),
+        'priority' => 39,
+    ));
+
+    $wp_customize->add_setting('nexversal_newsletter_title', array(
+        'default'           => 'New AI tool reviews,',
+        'sanitize_callback' => 'sanitize_text_field',
+    ));
+    $wp_customize->add_control('nexversal_newsletter_title', array(
+        'label'   => esc_html__('Title', 'nexversal'),
+        'section' => 'nexversal_newsletter',
+        'type'    => 'text',
+    ));
+
+    $wp_customize->add_setting('nexversal_newsletter_highlight', array(
+        'default'           => 'in your inbox.',
+        'sanitize_callback' => 'sanitize_text_field',
+    ));
+    $wp_customize->add_control('nexversal_newsletter_highlight', array(
+        'label'   => esc_html__('Title Highlight Text', 'nexversal'),
+        'section' => 'nexversal_newsletter',
+        'type'    => 'text',
+    ));
+
+    $wp_customize->add_setting('nexversal_newsletter_desc', array(
+        'default'           => 'Get new reviews and comparisons in your inbox. No spam, unsubscribe anytime.',
+        'sanitize_callback' => 'sanitize_textarea_field',
+    ));
+    $wp_customize->add_control('nexversal_newsletter_desc', array(
+        'label'   => esc_html__('Description', 'nexversal'),
+        'section' => 'nexversal_newsletter',
+        'type'    => 'textarea',
+    ));
+
+    $wp_customize->add_setting('nexversal_newsletter_btn_text', array(
+        'default'           => 'Subscribe',
+        'sanitize_callback' => 'sanitize_text_field',
+    ));
+    $wp_customize->add_control('nexversal_newsletter_btn_text', array(
+        'label'   => esc_html__('Button Text', 'nexversal'),
+        'section' => 'nexversal_newsletter',
+        'type'    => 'text',
+    ));
+
+    $wp_customize->add_setting('nexversal_newsletter_success_title', array(
+        'default'           => "You're in. ✨",
+        'sanitize_callback' => 'sanitize_text_field',
+    ));
+    $wp_customize->add_control('nexversal_newsletter_success_title', array(
+        'label'   => esc_html__('Subscribed / Logged-in Success Title', 'nexversal'),
+        'section' => 'nexversal_newsletter',
+        'type'    => 'text',
+    ));
+
+    $wp_customize->add_setting('nexversal_newsletter_success_desc', array(
+        'default'           => "We'll email you new reviews and comparisons as we publish them.",
+        'sanitize_callback' => 'sanitize_textarea_field',
+    ));
+    $wp_customize->add_control('nexversal_newsletter_success_desc', array(
+        'label'   => esc_html__('Subscribed / Logged-in Success Message', 'nexversal'),
+        'section' => 'nexversal_newsletter',
+        'type'    => 'textarea',
+    ));
+
     // Footer Customization Section
     $wp_customize->add_section('nexversal_footer', array(
@@ -448 +806 @@
     switch ($network) {
         case 'twitter':
+        case 'x':
             return '<svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z"/></svg>';
         case 'linkedin':
@@ -459 +818 @@
         case 'youtube':
             return '<svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z"/></svg>';
+        case 'tiktok':
+            return '<svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="M12.525.02c1.31-.02 2.61-.01 3.91-.02.08 1.53.63 3.09 1.75 4.17 1.12 1.11 2.7 1.62 4.24 1.79v4.03c-1.44-.05-2.89-.35-4.2-.97-.57-.26-1.1-.59-1.62-.93-.01 2.92.01 5.84-.02 8.75-.08 1.4-.54 2.79-1.35 3.94-1.31 1.92-3.58 3.17-5.91 3.21-1.43.08-2.86-.31-4.08-1.03-2.02-1.19-3.44-3.37-3.65-5.71-.02-.5-.03-1-.01-1.49.18-1.9 1.12-3.72 2.58-4.96 1.66-1.44 3.98-2.13 6.15-1.72.02 1.48-.04 2.96-.04 4.44-.99-.32-2.15-.23-3.02.37-.63.41-1.11 1.04-1.36 1.75-.21.51-.24 1.07-.14 1.61.24 1.16 1.18 2.09 2.35 2.29.97.16 1.98-.07 2.74-.69.64-.51 1.05-1.27 1.13-2.09.06-2.58.02-5.16.03-7.74.01-4.45-.02-8.9.02-13.35z"/></svg>';
+        case 'discord':
+            return '<svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="M20.317 4.37a19.791 19.791 0 0 0-4.885-1.515.074.074 0 0 0-.079.037c-.21.375-.444.864-.608 1.25a18.27 18.27 0 0 0-5.487 0 12.64 12.64 0 0 0-.617-1.25.077.077 0 0 0-.079-.037A19.736 19.736 0 0 0 3.677 4.37a.07.07 0 0 0-.032.027C.533 9.046-.32 13.58.099 18.057a.082.082 0 0 0 .031.057 19.9 19.9 0 0 0 5.993 3.03.078.078 0 0 0 .084-.028c.462-.63.874-1.295 1.226-1.994.021-.041.001-.09-.041-.106a13.107 13.107 0 0 1-1.872-.892.077.077 0 0 1-.008-.128 10.2 10.2 0 0 0 .372-.292.074.074 0 0 1 .077-.01c3.929 1.793 8.18 1.793 12.061 0a.074.074 0 0 1 .078.01c.12.098.246.198.373.292a.077.077 0 0 1-.006.127 12.299 12.299 0 0 1-1.873.894.077.077 0 0 0-.041.107c.36.698.772 1.362 1.225 1.993a.076.076 0 0 0 .084.028 19.839 19.839 0 0 0 6.002-3.03.077.077 0 0 0 .032-.054c.5-5.177-.838-9.674-3.549-13.66a.061.061 0 0 0-.031-.028zM8.02 15.33c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.956-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.956 2.418-2.157 2.418zm7.975 0c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.955-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.946 2.418-2.157 2.418z"/></svg>';
+        case 'telegram':
+            return '<svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm4.64 6.8c-.15 1.58-.8 5.42-1.13 7.19-.14.75-.42 1-.68 1.03-.58.05-1.02-.38-1.58-.75-.88-.58-1.38-.94-2.23-1.5-.99-.65-.35-1.01.22-1.59.15-.15 2.71-2.48 2.76-2.69a.2.2 0 0 0-.05-.18c-.06-.05-.14-.03-.21-.02-.09.02-1.49.95-4.22 2.79-.4.27-.76.41-1.08.4-.36-.01-1.04-.2-1.55-.37-.63-.2-1.12-.31-1.08-.66.02-.18.27-.36.75-.55 2.92-1.27 4.86-2.11 5.83-2.51 2.78-1.16 3.35-1.36 3.73-1.36.08 0 .27.02.39.12.1.08.13.19.14.27-.01.06.01.24 0 .38z"/></svg>';
+        case 'website':
+            return '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="2" y1="12" x2="22" y2="12"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg>';
         default:
-            return '';
-    }
+            return '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="2" y1="12" x2="22" y2="12"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg>';
+    }
+}
+
+/**
+ * Parse any list of custom URLs and auto-detect social networks with corresponding official logos.
+ */
+function nexversal_get_smart_social_links() {
+    $raw_links = get_theme_mod('nexversal_custom_social_links', '');
+    $urls = array();
+
+    if (!empty(trim($raw_links))) {
+        $lines = preg_split('/[\r\n,]+/', $raw_links);
+        foreach ($lines as $line) {
+            $u = trim($line);
+            if (!empty($u) && filter_var($u, FILTER_VALIDATE_URL)) {
+                $urls[] = $u;
+            }
+        }
+    } else {
+        $platforms = array('facebook', 'twitter', 'linkedin', 'instagram', 'youtube', 'github');
+        foreach ($platforms as $p) {
+            $u = get_theme_mod('nexversal_social_' . $p, '');
+            if (!empty($u)) {
+                $urls[] = $u;
+            }
+        }
+        if (empty($urls)) {
+            $urls = array(
+                'https://facebook.com/nexversal',
+                'https://twitter.com/nexversal',
+                'https://linkedin.com/company/nexversal',
+                'https://github.com/nexversal',
+                'https://youtube.com/@nexversal',
+            );
+        }
+    }
+
+    $parsed = array();
+    foreach ($urls as $url) {
+        $host = strtolower(parse_url($url, PHP_URL_HOST) ?? '');
+        $host = preg_replace('/^www\./', '', $host);
+
+        if (strpos($host, 'facebook.com') !== false || strpos($host, 'fb.com') !== false) {
+            $parsed[] = array('platform' => 'facebook', 'title' => 'Facebook', 'url' => $url);
+        } elseif (strpos($host, 'twitter.com') !== false || strpos($host, 'x.com') !== false) {
+            $parsed[] = array('platform' => 'twitter', 'title' => 'X (Twitter)', 'url' => $url);
+        } elseif (strpos($host, 'linkedin.com') !== false) {
+            $parsed[] = array('platform' => 'linkedin', 'title' => 'LinkedIn', 'url' => $url);
+        } elseif (strpos($host, 'instagram.com') !== false) {
+            $parsed[] = array('platform' => 'instagram', 'title' => 'Instagram', 'url' => $url);
+        } elseif (strpos($host, 'youtube.com') !== false || strpos($host, 'youtu.be') !== false) {
+            $parsed[] = array('platform' => 'youtube', 'title' => 'YouTube', 'url' => $url);
+        } elseif (strpos($host, 'github.com') !== false) {
+            $parsed[] = array('platform' => 'github', 'title' => 'GitHub', 'url' => $url);
+        } elseif (strpos($host, 'tiktok.com') !== false) {
+            $parsed[] = array('platform' => 'tiktok', 'title' => 'TikTok', 'url' => $url);
+        } elseif (strpos($host, 'discord.gg') !== false || strpos($host, 'discord.com') !== false) {
+            $parsed[] = array('platform' => 'discord', 'title' => 'Discord', 'url' => $url);
+        } elseif (strpos($host, 't.me') !== false || strpos($host, 'telegram.org') !== false) {
+            $parsed[] = array('platform' => 'telegram', 'title' => 'Telegram', 'url' => $url);
+        } else {
+            $parsed[] = array('platform' => 'website', 'title' => !empty($host) ? $host : 'Website', 'url' => $url);
+        }
+    }
+
+    return $parsed;
 }
 
@@ -712 +1144 @@
 add_action('admin_init', 'nexversal_add_privacy_policy_content');
 
-
-
+/**
+ * Automatically configure default pages (Home, Blogs, About Us, Contact) and navigation menu.
+ */
+function nexversal_setup_default_content() {
+    // 1. Setup Home Page with Editable Hero Blocks & Newsletter Box
+    $home_content = '<!-- wp:group {"className":"nx-hero-section","layout":{"type":"constrained"}} -->
+<div class="wp-block-group nx-hero-section"><div class="container">
+<!-- wp:paragraph {"className":"nx-hero-badge"} -->
+<p class="nx-hero-badge">MASTER AI WITH POWERFUL &amp; READY-TO-USE PROMPTS</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading {"level":1,"className":"nx-hero-title"} -->
+<h1 class="wp-block-heading nx-hero-title">Copy, paste, and customize high-performing prompts for modern AI tools and workflows.</h1>
+<!-- /wp:heading -->
+
+<!-- wp:paragraph {"className":"nx-hero-description"} -->
+<p class="nx-hero-description">Discover the ultimate AI prompt library. Copy, paste, and customize expert-tested ChatGPT, Midjourney, and Claude prompts to boost your productivity instantly.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:buttons {"className":"nx-hero-actions"} -->
+<div class="wp-block-buttons nx-hero-actions">
+<!-- wp:button {"className":"nx-hero-btn"} -->
+<div class="wp-block-button nx-hero-btn"><a class="wp-block-button__link wp-element-button" href="#primary">Explore Articles &rarr;</a></div>
+<!-- /wp:button -->
+</div>
+<!-- /wp:buttons -->
+</div></div>
+<!-- /wp:group -->
+
+<!-- wp:group {"className":"nx-newsletter-card","layout":{"type":"constrained"}} -->
+<div class="wp-block-group nx-newsletter-card">
+<div class="nx-newsletter-content">
+<!-- wp:paragraph {"className":"nx-newsletter-badge"} -->
+<p class="nx-newsletter-badge">✉ NEXVERSAL TECH DISPATCH</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading {"level":3,"className":"nx-newsletter-title"} -->
+<h3 class="wp-block-heading nx-newsletter-title">Stay Ahead in Tech &amp; Modern Software</h3>
+<!-- /wp:heading -->
+
+<!-- wp:paragraph {"className":"nx-newsletter-desc"} -->
+<p class="nx-newsletter-desc">Join developers, engineers, and digital innovators getting our weekly deep-dives on AI tools, cloud architectures, and development strategies.</p>
+<!-- /wp:paragraph -->
+</div>
+
+<!-- wp:html -->
+<form class="nx-newsletter-form" onsubmit="event.preventDefault(); var btn=this.querySelector(\'button\'); btn.innerText=\'Subscribed!\'; btn.style.background=\'#10b981\'; this.querySelector(\'input\').disabled=true;">
+    <div class="nx-newsletter-input-group">
+        <input type="email" placeholder="Enter your work email..." required class="nx-newsletter-input" />
+        <button type="submit" class="nx-newsletter-btn">
+            <span>Subscribe &rarr;</span>
+        </button>
+    </div>
+    <p class="nx-newsletter-privacy">
+        🔒 No spam. Unsubscribe anytime with 1-click.
+    </p>
+</form>
+<!-- /wp:html -->
+</div>
+<!-- /wp:group -->';
+
+    $home = get_page_by_path('home');
+    if (!$home) {
+        $home_id = wp_insert_post(array(
+            'post_title'   => 'Home',
+            'post_name'    => 'home',
+            'post_status'  => 'publish',
+            'post_type'    => 'page',
+            'post_content' => $home_content,
+        ));
+    } else {
+        $home_id = $home->ID;
+        $current_content = $home->post_content;
+        if (empty(trim($current_content)) || strpos($current_content, 'Welcome to Nexversal') !== false || strpos($current_content, 'nx-newsletter-card') === false) {
+            wp_update_post(array(
+                'ID'           => $home_id,
+                'post_content' => $home_content,
+            ));
+        }
+    }
+    if ($home_id && !is_wp_error($home_id)) {
+        update_post_meta($home_id, '_wp_page_template', 'template-home.php');
+        update_option('show_on_front', 'page');
+        update_option('page_on_front', $home_id);
+    }
+
+    // 2. Setup Blogs Page with Editable Blocks
+    $blog_content = '<!-- wp:paragraph {"className":"nx-hero-badge"} -->
+<p class="nx-hero-badge">ARTICLES &amp; GUIDES</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading {"level":1} -->
+<h1 class="wp-block-heading">Explore All Blogs &amp; Tech Insights</h1>
+<!-- /wp:heading -->
+
+<!-- wp:paragraph {"fontSize":"medium"} -->
+<p class="has-medium-font-size">Discover our complete collection of expert tutorials, software comparisons, AI guides, and modern engineering practices.</p>
+<!-- /wp:paragraph -->';
+
+    $blog = get_page_by_path('blog') ?: get_page_by_path('blogs');
+    if (!$blog) {
+        $blog_id = wp_insert_post(array(
+            'post_title'   => 'Blogs',
+            'post_name'    => 'blog',
+            'post_status'  => 'publish',
+            'post_type'    => 'page',
+            'post_content' => $blog_content,
+        ));
+    } else {
+        $blog_id = $blog->ID;
+        $current_content = $blog->post_content;
+        if (empty(trim($current_content)) || strpos($current_content, 'nx-hero-badge') === false) {
+            wp_update_post(array(
+                'ID'           => $blog_id,
+                'post_content' => $blog_content,
+            ));
+        }
+    }
+    if ($blog_id && !is_wp_error($blog_id)) {
+        update_post_meta($blog_id, '_wp_page_template', 'template-blog.php');
+        update_option('page_for_posts', $blog_id);
+    }
+
+    // 3. Setup About Us with Editable Blocks
+    $about_content = '<!-- wp:paragraph {"className":"nx-hero-badge"} -->
+<p class="nx-hero-badge">WHO WE ARE</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading {"level":1} -->
+<h1 class="wp-block-heading">About Nexversal</h1>
+<!-- /wp:heading -->
+
+<!-- wp:paragraph {"fontSize":"medium"} -->
+<p class="has-medium-font-size">Empowering developers, creators, and modern businesses with actionable technology insights, high-speed software reviews, and engineering excellence.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading {"level":2} -->
+<h2 class="wp-block-heading">Our Mission &amp; Philosophy</h2>
+<!-- /wp:heading -->
+
+<!-- wp:paragraph -->
+<p>Nexversal was created with a clear objective: cut through the digital noise and deliver high-impact, transparent, and technically rigorous technology journalism. We explore modern artificial intelligence, high-performance web engineering, cloud infrastructure, and modern software tools.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:columns -->
+<div class="wp-block-columns">
+<!-- wp:column -->
+<div class="wp-block-column" style="padding:20px;background:var(--nx-bg);border-radius:10px;">
+<!-- wp:heading {"level":4} -->
+<h4 class="wp-block-heading">⚡ Speed &amp; Performance</h4>
+<!-- /wp:heading -->
+<!-- wp:paragraph -->
+<p>We prioritize lightweight architecture, zero bloated dependencies, and pristine Core Web Vitals.</p>
+<!-- /wp:paragraph -->
+</div>
+<!-- /wp:column -->
+
+<!-- wp:column -->
+<div class="wp-block-column" style="padding:20px;background:var(--nx-bg);border-radius:10px;">
+<!-- wp:heading {"level":4} -->
+<h4 class="wp-block-heading">👑 Independent Editorial</h4>
+<!-- /wp:heading -->
+<!-- wp:paragraph -->
+<p>Every software comparison, AI model evaluation, and tutorial is independently verified and fact-checked.</p>
+<!-- /wp:paragraph -->
+</div>
+<!-- /wp:column -->
+
+<!-- wp:column -->
+<div class="wp-block-column" style="padding:20px;background:var(--nx-bg);border-radius:10px;">
+<!-- wp:heading {"level":4} -->
+<h4 class="wp-block-heading">🛠️ Developer-Centric</h4>
+<!-- /wp:heading -->
+<!-- wp:paragraph -->
+<p>Built by engineers for engineers, offering real reproducible benchmarks and practical architectures.</p>
+<!-- /wp:paragraph -->
+</div>
+<!-- /wp:column -->
+</div>
+<!-- /wp:columns -->';
+
+    $about = get_page_by_path('about') ?: get_page_by_path('about-us');
+    if (!$about) {
+        $sample = get_page_by_path('sample-page');
+        if ($sample) {
+            wp_update_post(array(
+                'ID'           => $sample->ID,
+                'post_title'   => 'About Us',
+                'post_name'    => 'about',
+                'post_content' => $about_content,
+            ));
+            $about_id = $sample->ID;
+        } else {
+            $about_id = wp_insert_post(array(
+                'post_title'   => 'About Us',
+                'post_name'    => 'about',
+                'post_status'  => 'publish',
+                'post_type'    => 'page',
+                'post_content' => $about_content,
+            ));
+        }
+    } else {
+        $about_id = $about->ID;
+        $current_content = $about->post_content;
+        if (empty(trim($current_content)) || strpos($current_content, 'Welcome to Nexversal') !== false || strpos($current_content, 'nx-hero-badge') === false) {
+            wp_update_post(array(
+                'ID'           => $about_id,
+                'post_content' => $about_content,
+            ));
+        }
+    }
+    if ($about_id && !is_wp_error($about_id)) {
+        update_post_meta($about_id, '_wp_page_template', 'template-about.php');
+    }
+
+    // 4. Setup Contact Page (managed seamlessly via Appearance > Customize > Contact Page Settings)
+    $contact = get_page_by_path('contact') ?: get_page_by_path('contact-us');
+    if (!$contact) {
+        $contact_id = wp_insert_post(array(
+            'post_title'   => 'Contact Us',
+            'post_name'    => 'contact',
+            'post_status'  => 'publish',
+            'post_type'    => 'page',
+            'post_content' => '',
+        ));
+    } else {
+        $contact_id = $contact->ID;
+    }
+    if ($contact_id && !is_wp_error($contact_id)) {
+        update_post_meta($contact_id, '_wp_page_template', 'template-contact.php');
+    }
+
+    // 5. Setup Primary Nav Menu with all 4 pages
+    $menu_name = 'Main Menu';
+    $menu_obj  = wp_get_nav_menu_object($menu_name);
+    $menu_id   = $menu_obj ? $menu_obj->term_id : wp_create_nav_menu($menu_name);
+
+    if ($menu_id && !is_wp_error($menu_id)) {
+        $existing_items = wp_get_nav_menu_items($menu_id);
+        if (!empty($existing_items)) {
+            $seen_titles = array();
+            foreach ($existing_items as $item) {
+                $t = trim(strtolower($item->title));
+                if (isset($seen_titles[$t]) || $t === 'sample page' || strpos((string)$item->url, 'sample-page') !== false) {
+                    wp_delete_post($item->ID, true);
+                } else {
+                    $seen_titles[$t] = true;
+                }
+            }
+            $existing_items = wp_get_nav_menu_items($menu_id);
+        }
+
+        if (empty($existing_items)) {
+            if ($home_id) {
+                wp_update_nav_menu_item($menu_id, 0, array(
+                    'menu-item-title'     => 'Home',
+                    'menu-item-object'    => 'page',
+                    'menu-item-object-id' => $home_id,
+                    'menu-item-type'      => 'post_type',
+                    'menu-item-status'    => 'publish',
+                ));
+            }
+            if ($blog_id) {
+                wp_update_nav_menu_item($menu_id, 0, array(
+                    'menu-item-title'     => 'Blogs',
+                    'menu-item-object'    => 'page',
+                    'menu-item-object-id' => $blog_id,
+                    'menu-item-type'      => 'post_type',
+                    'menu-item-status'    => 'publish',
+                ));
+            }
+            if ($about_id) {
+                wp_update_nav_menu_item($menu_id, 0, array(
+                    'menu-item-title'     => 'About Us',
+                    'menu-item-object'    => 'page',
+                    'menu-item-object-id' => $about_id,
+                    'menu-item-type'      => 'post_type',
+                    'menu-item-status'    => 'publish',
+                ));
+            }
+            if ($contact_id) {
+                wp_update_nav_menu_item($menu_id, 0, array(
+                    'menu-item-title'     => 'Contact',
+                    'menu-item-object'    => 'page',
+                    'menu-item-object-id' => $contact_id,
+                    'menu-item-type'      => 'post_type',
+                    'menu-item-status'    => 'publish',
+                ));
+            }
+        }
+
+        $locations = get_theme_mod('nav_menu_locations');
+        if (!is_array($locations)) {
+            $locations = array();
+        }
+        if (empty($locations['primary'])) {
+            $locations['primary'] = $menu_id;
+            $locations['footer']  = $menu_id;
+            set_theme_mod('nav_menu_locations', $locations);
+        }
+    }
+}
+add_action('after_switch_theme', 'nexversal_setup_default_content');
+
+/**
+ * Run setup automatically once after update to ensure Home, Blogs, About, Contact pages exist in DB.
+ */
+function nexversal_auto_setup_pages_once() {
+    if (!get_option('nexversal_v330_blocks_synced')) {
+        nexversal_setup_default_content();
+        update_option('nexversal_v330_blocks_synced', 1);
+    }
+}
+add_action('admin_init', 'nexversal_auto_setup_pages_once');
+add_action('after_setup_theme', 'nexversal_auto_setup_pages_once');
+
+/**
+ * ==========================================================================
+ * URL Resolvers & Permalinks Resiliency (About, Blogs, Contact)
+ * ==========================================================================
+ */
+
+/**
+ * Resolve the dynamic, validated URL of the About page across all configurations.
+ *
+ * @return string
+ */
+function nexversal_get_about_page_url() {
+    static $resolved_url = null;
+    if ($resolved_url !== null) {
+        return $resolved_url;
+    }
+
+    // 1. Path lookup
+    $about = get_page_by_path('about');
+    if (!$about) {
+        $about = get_page_by_path('about-us');
+    }
+
+    // 2. Page template lookup
+    if (!$about) {
+        $pages = get_posts(array(
+            'post_type'        => 'page',
+            'post_status'      => 'publish',
+            'numberposts'      => 1,
+            'meta_key'         => '_wp_page_template',
+            'meta_value'       => 'template-about.php',
+            'suppress_filters' => true,
+        ));
+        if (!empty($pages)) {
+            $about = $pages[0];
+        }
+    }
+
+    // 3. Title lookup
+    if (!$about) {
+        $pages = get_posts(array(
+            'post_type'        => 'page',
+            'post_status'      => 'publish',
+            'numberposts'      => 1,
+            'title'            => 'About Us',
+            'suppress_filters' => true,
+        ));
+        if (empty($pages)) {
+            $pages = get_posts(array(
+                'post_type'        => 'page',
+                'post_status'      => 'publish',
+                'numberposts'      => 1,
+                'title'            => 'About',
+                'suppress_filters' => true,
+            ));
+        }
+        if (!empty($pages)) {
+            $about = $pages[0];
+        }
+    }
+
+    if ($about) {
+        $resolved_url = get_permalink($about->ID);
+        return $resolved_url;
+    }
+
+    $resolved_url = home_url('/about/');
+    return $resolved_url;
+}
+
+/**
+ * Resolve the dynamic, validated URL of the Blogs page across all configurations.
+ *
+ * @return string
+ */
+function nexversal_get_blogs_page_url() {
+    static $resolved_url = null;
+    if ($resolved_url !== null) {
+        return $resolved_url;
+    }
+
+    $page = get_page_by_path('blog') ?: get_page_by_path('blogs');
+    if (!$page) {
+        $pages = get_posts(array(
+            'post_type'        => 'page',
+            'post_status'      => 'publish',
+            'numberposts'      => 1,
+            'meta_key'         => '_wp_page_template',
+            'meta_value'       => array('template-blog.php', 'template-blogs.php'),
+            'suppress_filters' => true,
+        ));
+        if (!empty($pages)) {
+            $page = $pages[0];
+        }
+    }
+
+    if ($page) {
+        $resolved_url = get_permalink($page->ID);
+        return $resolved_url;
+    }
+
+    $page_for_posts = get_option('page_for_posts');
+    if ($page_for_posts) {
+        $resolved_url = get_permalink($page_for_posts);
+        return $resolved_url;
+    }
+
+    $resolved_url = home_url('/blog/');
+    return $resolved_url;
+}
+
+/**
+ * Resolve the dynamic, validated URL of the Contact page across all configurations.
+ *
+ * @return string
+ */
+function nexversal_get_contact_page_url() {
+    static $resolved_url = null;
+    if ($resolved_url !== null) {
+        return $resolved_url;
+    }
+
+    $contact = get_page_by_path('contact') ?: get_page_by_path('contact-us');
+    if (!$contact) {
+        $pages = get_posts(array(
+            'post_type'        => 'page',
+            'post_status'      => 'publish',
+            'numberposts'      => 1,
+            'meta_key'         => '_wp_page_template',
+            'meta_value'       => 'template-contact.php',
+            'suppress_filters' => true,
+        ));
+        if (!empty($pages)) {
+            $contact = $pages[0];
+        }
+    }
+
+    if ($contact) {
+        $resolved_url = get_permalink($contact->ID);
+        return $resolved_url;
+    }
+
+    $resolved_url = home_url('/contact/');
+    return $resolved_url;
+}
+
+/**
+ * Filter nav menu objects to replace any leftover "Sample Page", broken "?page_id=2" links,
+ * and deduplicate menu items.
+ */
+function nexversal_filter_and_deduplicate_nav_menu($items) {
+    if (!is_array($items)) {
+        return $items;
+    }
+    $seen = array();
+    $clean_items = array();
+
+    foreach ($items as $item) {
+        if (!is_object($item) || !isset($item->title)) {
+            continue;
+        }
+
+        $title_raw = trim(strtolower($item->title));
+        $item_url  = isset($item->url) ? (string)$item->url : '';
+
+        // Clean up sample page or broken About link (including ?page_id=2)
+        if ($title_raw === 'sample page' || strpos($item_url, 'sample-page') !== false || strpos($item_url, 'page_id=2') !== false || $title_raw === 'about' || $title_raw === 'about us') {
+            $item->title = esc_html__('About Us', 'nexversal');
+            $item->url   = nexversal_get_about_page_url();
+        }
+
+        // Clean up Blogs link if pointing to invalid URL or plain page_id
+        if ($title_raw === 'blogs' || $title_raw === 'blog') {
+            $item->title = esc_html__('Blogs', 'nexversal');
+            $item->url   = nexversal_get_blogs_page_url();
+        }
+
+        // Clean up Contact link
+        if ($title_raw === 'contact' || $title_raw === 'contact us') {
+            $item->title = esc_html__('Contact', 'nexversal');
+            $item->url   = nexversal_get_contact_page_url();
+        }
+
+        // Clean up Home link
+        if ($title_raw === 'home') {
+            $item->title = esc_html__('Home', 'nexversal');
+            $item->url   = home_url('/');
+        }
+
+        // Deduplicate key by lowercased title
+        $title_key = trim(strtolower($item->title));
+        if (isset($seen[$title_key])) {
+            continue;
+        }
+
+        $seen[$title_key] = true;
+        $clean_items[] = $item;
+    }
+
+    return $clean_items;
+}
+add_filter('wp_nav_menu_objects', 'nexversal_filter_and_deduplicate_nav_menu', 20);
+
+/**
+ * Redirect legacy URLs, dead sample pages, ?page_id=2, and GSC 404s gracefully (301 Permanent Redirect)
+ */
+function nexversal_redirect_legacy_and_about_urls() {
+    $requested_page_id = isset($_GET['page_id']) ? (int) $_GET['page_id'] : 0;
+    $req_uri           = isset($_SERVER['REQUEST_URI']) ? $_SERVER['REQUEST_URI'] : '';
+
+    // 1. Direct interception for ?page_id=2 (old sample page default in WordPress)
+    if ($requested_page_id === 2 || strpos($req_uri, 'page_id=2') !== false || strpos($req_uri, 'sample-page') !== false) {
+        $about_url = nexversal_get_about_page_url();
+        wp_safe_redirect($about_url, 301);
+        exit;
+    }
+
+    $clean_path = parse_url($req_uri, PHP_URL_PATH);
+    $clean_path = $clean_path ? rtrim($clean_path, '/') : '';
+
+    // Direct alias for /blogs to canonical /blog/
+    if ($clean_path === '/blogs') {
+        wp_safe_redirect(nexversal_get_blogs_page_url(), 301);
+        exit;
+    }
+
+    // 2. Intercept 404s and map to 301 destinations from Persistent Master Record
+    if (is_404() || !empty($clean_path)) {
+        $blog_url = nexversal_get_blogs_page_url();
+        $redirects = array(
+            '/aboutAbout'                                              => nexversal_get_about_page_url(),
+            '/contactContact'                                          => nexversal_get_contact_page_url(),
+            '/Home'                                                    => home_url('/'),
+            '/category/comparisonsComparisons'                         => home_url('/category/comparisons/'),
+            '/sample-page'                                             => nexversal_get_about_page_url(),
+            '/blogs'                                                   => $blog_url,
+            '/kepler-vs-github-copilot'                                => home_url('/blog/kepler-ai-coding'),
+            '/gitkraken-kepler'                                        => home_url('/blog/setup-gitkraken-kepler'),
+            '/seo-in-the-age-of-answer-engines'                        => home_url('/blog/best-ai-seo-tools'),
+            '/search-marketing-course'                                 => home_url('/blog/best-ai-seo-tools'),
+            '/category/artificial-intelligence'                        => home_url('/blog'),
+            '/future-of-artificial-intelligence-2026'                  => home_url('/blog'),
+            '/the-self-taught-engineers-curriculum'                     => home_url('/blog/best-free-ai-tools-for-coding-2026'),
+            '/the-anatomy-of-a-supply-chain-attack'                    => home_url('/blog'),
+            '/the-quiet-revolution-of-agentic-llms'                    => home_url('/blog/chatgpt-vs-claude-vs-gemini-which-should-you-use'),
+            '/designing-with-restraint'                                => home_url('/blog'),
+            '/best-ai-video-generators-for-creators-in-2026'          => home_url('/blog/ai-tools-for-a-video-generator'),
+            '/category/education'                                      => home_url('/blog/best-ai-tools-for-students'),
+            '/why-pricing-is-strategy-not-a-number'                    => home_url('/blog/ai-tools-for-small-business'),
+            '/how-to-learn-seo-at-home-for-free-complete-2026-roadmap' => home_url('/blog/best-ai-seo-tools'),
+            '/key-takeaways-for-mastering-rankings'                    => home_url('/blog/best-ai-seo-tools'),
+            '/the-best-chatgpt-alternatives-worth-trying'              => home_url('/blog/chatgpt-alternatives'),
+            '/best-ai-tools-for-text-to-video-generators'              => home_url('/blog/ai-tools-for-a-video-generator'),
+            '/ai-tools-for-text-to-video-generators'                   => home_url('/blog/ai-tools-for-a-video-generator'),
+        );
+
+        if (isset($redirects[$clean_path])) {
+            wp_safe_redirect($redirects[$clean_path], 301);
+            exit;
+        }
+
+        // If request query or URL contains page_id=2 or sample-page
+        if (strpos($req_uri, 'page_id=2') !== false || strpos($req_uri, 'sample-page') !== false) {
+            wp_safe_redirect(nexversal_get_about_page_url(), 301);
+            exit;
+        }
+    }
+}
+add_action('template_redirect', 'nexversal_redirect_legacy_and_about_urls', 1);
+
+/**
+ * Auto-heal legacy menu items in database that point to ?page_id=2 or deleted sample-page
+ */
+function nexversal_heal_legacy_menu_and_pages() {
+    if (get_option('nexversal_v351_about_healed')) {
+        return;
+    }
+
+    $about = get_page_by_path('about') ?: get_page_by_path('about-us');
+    $about_id = $about ? $about->ID : 0;
+
+    $all_menu_items = get_posts(array(
+        'post_type'        => 'nav_menu_item',
+        'numberposts'      => -1,
+        'post_status'      => 'any',
+        'suppress_filters' => true,
+    ));
+
+    if (!empty($all_menu_items)) {
+        foreach ($all_menu_items as $mi) {
+            $url    = (string) get_post_meta($mi->ID, '_menu_item_url', true);
+            $obj_id = (int) get_post_meta($mi->ID, '_menu_item_object_id', true);
+            $title  = strtolower(trim($mi->post_title));
+
+            if ($obj_id === 2 || strpos($url, 'page_id=2') !== false || strpos($url, 'sample-page') !== false || $title === 'sample page' || ($about_id && ($title === 'about' || $title === 'about us') && $obj_id !== $about_id && empty($url))) {
+                if ($about_id) {
+                    update_post_meta($mi->ID, '_menu_item_object_id', $about_id);
+                    update_post_meta($mi->ID, '_menu_item_type', 'post_type');
+                    update_post_meta($mi->ID, '_menu_item_object', 'page');
+                    update_post_meta($mi->ID, '_menu_item_url', '');
+                } else {
+                    update_post_meta($mi->ID, '_menu_item_url', home_url('/about/'));
+                }
+            }
+        }
+    }
+
+    update_option('nexversal_v351_about_healed', 1);
+}
+add_action('init', 'nexversal_heal_legacy_menu_and_pages');
+
+/**
+ * ==========================================================================
+ * Newsletter Subscribers System (Storage, AJAX, Export & Admin View)
+ * ==========================================================================
+ */
+
+/**
+ * Handle AJAX newsletter subscription requests securely.
+ */
+function nexversal_handle_newsletter_subscription() {
+    if (!check_ajax_referer('nexversal_newsletter_nonce', 'nonce', false)) {
+        wp_send_json_error(array('message' => esc_html__('Security verification failed. Please refresh the page.', 'nexversal')));
+    }
+
+    $email = isset($_POST['email']) ? sanitize_email(wp_unslash($_POST['email'])) : '';
+
+    if (empty($email)) {
+        wp_send_json_error(array('message' => esc_html__('Please enter your email address.', 'nexversal')));
+    }
+
+    if (!is_email($email)) {
+        wp_send_json_error(array('message' => esc_html__('Please enter a valid email address format.', 'nexversal')));
+    }
+
+    $subscribers = get_option('nexversal_subscribers', array());
+    if (!is_array($subscribers)) {
+        $subscribers = array();
+    }
+
+    // Check if already subscribed
+    foreach ($subscribers as $sub) {
+        if (isset($sub['email']) && strtolower($sub['email']) === strtolower($email)) {
+            wp_send_json_success(array('message' => esc_html__('Already Subscribed! Thank you.', 'nexversal')));
+        }
+    }
+
+    // Append new subscriber with timestamp
+    $subscribers[] = array(
+        'email' => strtolower($email),
+        'date'  => current_time('mysql'),
+        'ip'    => sanitize_text_field(wp_unslash($_SERVER['REMOTE_ADDR'] ?? '')),
+    );
+
+    update_option('nexversal_subscribers', $subscribers);
+
+    wp_send_json_success(array('message' => esc_html__('Subscribed successfully! Thank you.', 'nexversal')));
+}
+add_action('wp_ajax_nexversal_subscribe', 'nexversal_handle_newsletter_subscription');
+add_action('wp_ajax_nopriv_nexversal_subscribe', 'nexversal_handle_newsletter_subscription');
+
+/**
+ * Filter the_content to guarantee the email input field and form wrapper are present in newsletter cards.
+ */
+function nexversal_ensure_newsletter_form_input($content) {
+    if (strpos($content, 'nx-newsletter-card') !== false) {
+        // If button exists but email input is missing, inject the email input field
+        if (strpos($content, '<input') === false && strpos($content, 'nx-newsletter-btn') !== false) {
+            $input_field = '<input type="email" name="nx_email" placeholder="' . esc_attr__('Enter your work email...', 'nexversal') . '" required class="nx-newsletter-input" autocomplete="email" />';
+            $content = preg_replace('/(<button[^>]*class=["\'][^"\']*nx-newsletter-btn[^"\']*["\'][^>]*>)/i', $input_field . "\n" . '$1', $content, 1);
+        }
+        // If form wrapper is missing, wrap the input group and privacy text in <form class="nx-newsletter-form">
+        if (strpos($content, '<form') === false && strpos($content, 'nx-newsletter-btn') !== false) {
+            $content = preg_replace('/(<div[^>]*class=["\'][^"\']*nx-newsletter-input-group[^"\']*["\'][^>]*>)/i', '<form class="nx-newsletter-form">$1', $content, 1);
+            $content = preg_replace('/(<\/div>\s*<p[^>]*class=["\'][^"\']*nx-newsletter-privacy[^"\']*["\'][^>]*>.*?<\/p>)/is', '$1</form>', $content, 1);
+        }
+    }
+    return $content;
+}
+add_filter('the_content', 'nexversal_ensure_newsletter_form_input', 12);
+
+/**
+ * Register Appearance > Subscribers page in WP-Admin.
+ */
+function nexversal_register_subscribers_admin_menu() {
+    add_theme_page(
+        esc_html__('Newsletter Subscribers', 'nexversal'),
+        esc_html__('Subscribers', 'nexversal'),
+        'manage_options',
+        'nexversal-subscribers',
+        'nexversal_render_subscribers_admin_page'
+    );
+}
+add_action('admin_menu', 'nexversal_register_subscribers_admin_menu');
+
+/**
+ * Render the Subscribers page in WP-Admin with stats, list, delete, and CSV export.
+ */
+function nexversal_render_subscribers_admin_page() {
+    if (!current_user_can('manage_options')) {
+        return;
+    }
+
+    $subscribers = get_option('nexversal_subscribers', array());
+    if (!is_array($subscribers)) {
+        $subscribers = array();
+    }
+
+    // Handle CSV Export
+    if (isset($_GET['action']) && 'export_csv' === $_GET['action'] && isset($_GET['_wpnonce']) && wp_verify_nonce(sanitize_text_field(wp_unslash($_GET['_wpnonce'])), 'nexversal_export_csv')) {
+        if (!headers_sent()) {
+            header('Content-Type: text/csv; charset=utf-8');
+            header('Content-Disposition: attachment; filename=nexversal-subscribers-' . gmdate('Y-m-d') . '.csv');
+            echo "Index,Email,Subscription Date,IP Address\r\n";
+            $idx = 1;
+            foreach ($subscribers as $sub) {
+                $email = isset($sub['email']) ? str_replace('"', '""', $sub['email']) : '';
+                $date  = isset($sub['date']) ? str_replace('"', '""', $sub['date']) : '';
+                $ip    = isset($sub['ip']) ? str_replace('"', '""', $sub['ip']) : '';
+                echo '"' . intval($idx++) . '","' . esc_attr($email) . '","' . esc_attr($date) . '","' . esc_attr($ip) . "\"\r\n";
+            }
+            exit;
+        }
+    }
+
+    // Handle Single Delete Action
+    $notice = '';
+    if (isset($_GET['action']) && 'delete' === $_GET['action'] && isset($_GET['email']) && isset($_GET['_wpnonce'])) {
+        $del_email = sanitize_email(wp_unslash($_GET['email']));
+        if (wp_verify_nonce(sanitize_text_field(wp_unslash($_GET['_wpnonce'])), 'nexversal_delete_' . $del_email)) {
+            $updated = array();
+            foreach ($subscribers as $s) {
+                if (isset($s['email']) && strtolower($s['email']) !== strtolower($del_email)) {
+                    $updated[] = $s;
+                }
+            }
+            $subscribers = $updated;
+            update_option('nexversal_subscribers', $subscribers);
+            $notice = '<div class="notice notice-success is-dismissible"><p>' . esc_html__('Subscriber removed successfully.', 'nexversal') . '</p></div>';
+        }
+    }
+
+    $total_count = count($subscribers);
+    $export_url  = wp_nonce_url(admin_url('themes.php?page=nexversal-subscribers&action=export_csv'), 'nexversal_export_csv');
+    ?>
+    <div class="wrap" style="max-width: 1000px; margin-top: 20px;">
+        <h1 style="display: flex; align-items: center; gap: 10px; font-weight: 700;">
+            <span class="dashicons dashicons-email-alt" style="font-size: 32px; width: 32px; height: 32px; color: #4f46e5;"></span>
+            <?php esc_html_e('Newsletter Subscribers', 'nexversal'); ?>
+        </h1>
+        <p style="color: #64748b; font-size: 14px;">
+            <?php esc_html_e('Manage email leads captured from the Nexversal Newsletter Dispatch boxes across your website.', 'nexversal'); ?>
+        </p>
+
+        <?php echo $notice; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>
+
+        <div style="background: #ffffff; border: 1px solid #e2e8f0; border-radius: 8px; padding: 20px 24px; margin-bottom: 24px; display: flex; align-items: center; justify-content: space-between; box-shadow: 0 1px 3px rgba(0,0,0,0.05);">
+            <div>
+                <span style="font-size: 13px; font-weight: 600; text-transform: uppercase; color: #64748b; letter-spacing: 0.05em;"><?php esc_html_e('Total Subscribers', 'nexversal'); ?></span>
+                <div style="font-size: 32px; font-weight: 800; color: #0f172a; margin-top: 2px;">
+                    <?php echo esc_html($total_count); ?>
+                </div>
+            </div>
+            <?php if ($total_count > 0) : ?>
+                <div>
+                    <a href="<?php echo esc_url($export_url); ?>" class="button button-primary" style="background: #4f46e5; border-color: #4f46e5; padding: 6px 16px; font-weight: 600;">
+                        <span class="dashicons dashicons-download" style="vertical-align: middle; margin-top: -2px;"></span>
+                        <?php esc_html_e('Download CSV List', 'nexversal'); ?>
+                    </a>
+                </div>
+            <?php endif; ?>
+        </div>
+
+        <?php if ($total_count > 0) : ?>
+            <table class="wp-list-table widefat fixed striped posts" style="border-radius: 8px; overflow: hidden; box-shadow: 0 1px 3px rgba(0,0,0,0.05);">
+                <thead>
+                    <tr>
+                        <th style="width: 60px;">#</th>
+                        <th><?php esc_html_e('Subscriber Email', 'nexversal'); ?></th>
+                        <th style="width: 220px;"><?php esc_html_e('Date & Time (UTC/Site)', 'nexversal'); ?></th>
+                        <th style="width: 100px; text-align: center;"><?php esc_html_e('Action', 'nexversal'); ?></th>
+                    </tr>
+                </thead>
+                <tbody>
+                    <?php
+                    $i = 1;
+                    $reversed = array_reverse($subscribers);
+                    foreach ($reversed as $sub) :
+                        $sub_email = $sub['email'] ?? '';
+                        $sub_date  = $sub['date'] ?? '';
+                        $del_url   = wp_nonce_url(
+                            admin_url('themes.php?page=nexversal-subscribers&action=delete&email=' . urlencode($sub_email)),
+                            'nexversal_delete_' . $sub_email
+                        );
+                        ?>
+                        <tr>
+                            <td><?php echo esc_html($i++); ?></td>
+                            <td>
+                                <strong><a href="mailto:<?php echo esc_attr($sub_email); ?>" style="color: #4f46e5; text-decoration: none;"><?php echo esc_html($sub_email); ?></a></strong>
+                            </td>
+                            <td><?php echo esc_html($sub_date); ?></td>
+                            <td style="text-align: center;">
+                                <a href="<?php echo esc_url($del_url); ?>" onclick="return confirm('<?php echo esc_js(__('Are you sure you want to delete this subscriber?', 'nexversal')); ?>');" style="color: #ef4444; text-decoration: none; font-size: 13px;">
+                                    <?php esc_html_e('Delete', 'nexversal'); ?>
+                                </a>
+                            </td>
+                        </tr>
+                    <?php endforeach; ?>
+                </tbody>
+            </table>
+        <?php else : ?>
+            <div style="background: #ffffff; border: 1px dashed #cbd5e1; border-radius: 8px; padding: 48px 24px; text-align: center; color: #64748b;">
+                <span class="dashicons dashicons-email" style="font-size: 48px; width: 48px; height: 48px; color: #94a3b8; margin-bottom: 12px;"></span>
+                <h3 style="color: #334155; margin: 0 0 8px 0; font-weight: 700;"><?php esc_html_e('No Subscribers Yet', 'nexversal'); ?></h3>
+                <p style="margin: 0; font-size: 14px; max-width: 480px; margin: 0 auto;">
+                    <?php esc_html_e('When visitors enter their email into the newsletter dispatch box on your homepage, their emails and subscription dates will appear here.', 'nexversal'); ?>
+                </p>
+            </div>
+        <?php endif; ?>
+    </div>
+    <?php
+}
+
+/**
+ * ==========================================================================
+ * Contact Page Settings (Dedicated WP-Admin Screen under Appearance)
+ * ==========================================================================
+ */
+
+/**
+ * Register Appearance > Contact Settings page in WP-Admin.
+ */
+function nexversal_register_contact_admin_menu() {
+    add_theme_page(
+        esc_html__('Contact Page Settings', 'nexversal'),
+        esc_html__('Contact Settings', 'nexversal'),
+        'manage_options',
+        'nexversal-contact',
+        'nexversal_render_contact_admin_page'
+    );
+}
+add_action('admin_menu', 'nexversal_register_contact_admin_menu');
+
+/**
+ * Render the Appearance > Contact Settings admin page.
+ */
+function nexversal_render_contact_admin_page() {
+    if (!current_user_can('manage_options')) {
+        return;
+    }
+
+    $notice = '';
+
+    // Handle Form Submission
+    if (isset($_POST['nexversal_save_contact']) && check_admin_referer('nexversal_save_contact_action', 'nexversal_contact_nonce')) {
+        $show_info   = !empty($_POST['nexversal_show_contact_info']);
+        $info_title  = sanitize_text_field(wp_unslash($_POST['nexversal_contact_title'] ?? ''));
+        $info_desc   = sanitize_textarea_field(wp_unslash($_POST['nexversal_contact_desc'] ?? ''));
+        $info_email  = sanitize_email(wp_unslash($_POST['nexversal_contact_email'] ?? ''));
+        $hq_text     = sanitize_text_field(wp_unslash($_POST['nexversal_contact_hq_text'] ?? ''));
+        $hq_url      = esc_url_raw(wp_unslash($_POST['nexversal_contact_hq_url'] ?? ''));
+        $soc_links   = sanitize_textarea_field(wp_unslash($_POST['nexversal_custom_social_links'] ?? ''));
+
+        set_theme_mod('nexversal_show_contact_info', $show_info);
+        set_theme_mod('nexversal_contact_title', $info_title);
+        set_theme_mod('nexversal_contact_desc', $info_desc);
+        set_theme_mod('nexversal_contact_email', $info_email);
+        set_theme_mod('nexversal_contact_hq_text', $hq_text);
+        set_theme_mod('nexversal_contact_hq_url', $hq_url);
+        set_theme_mod('nexversal_custom_social_links', $soc_links);
+
+        $notice = '<div class="notice notice-success is-dismissible"><p><strong>' . esc_html__('Contact page settings saved successfully!', 'nexversal') . '</strong></p></div>';
+    }
+
+    // Retrieve active values
+    $show_info   = get_theme_mod('nexversal_show_contact_info', true);
+    $info_title  = get_theme_mod('nexversal_contact_title', __('Contact Information', 'nexversal'));
+    $info_desc   = get_theme_mod('nexversal_contact_desc', __('We are dedicated to fast response times and transparent communication.', 'nexversal'));
+    $info_email  = get_theme_mod('nexversal_contact_email', get_option('admin_email', 'contact@nexversal.com'));
+    $hq_text     = get_theme_mod('nexversal_contact_hq_text', 'nexversal.com/contact');
+    $hq_url      = get_theme_mod('nexversal_contact_hq_url', home_url('/contact/'));
+    $soc_links   = get_theme_mod('nexversal_custom_social_links', "https://facebook.com/nexversal\nhttps://twitter.com/nexversal\nhttps://linkedin.com/company/nexversal\nhttps://github.com/nexversal\nhttps://youtube.com/@nexversal");
+    $customizer_url = admin_url('customize.php?autofocus[section]=nexversal_contact');
+    $contact_url    = home_url('/contact/');
+    ?>
+    <div class="wrap" style="max-width: 900px; margin-top: 20px;">
+        <div style="display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 12px; margin-bottom: 16px;">
+            <h1 style="display: flex; align-items: center; gap: 10px; font-weight: 700; margin: 0;">
+                <span class="dashicons dashicons-location-alt" style="font-size: 30px; width: 30px; height: 30px; color: #4f46e5;"></span>
+                <?php esc_html_e('Contact Page Settings', 'nexversal'); ?>
+            </h1>
+            <div style="display: flex; gap: 8px;">
+                <a href="<?php echo esc_url($contact_url); ?>" target="_blank" class="button">
+                    <span class="dashicons dashicons-external" style="vertical-align: middle; margin-top: -2px;"></span>
+                    <?php esc_html_e('View Contact Page', 'nexversal'); ?>
+                </a>
+                <a href="<?php echo esc_url($customizer_url); ?>" class="button button-secondary">
+                    <span class="dashicons dashicons-admin-appearance" style="vertical-align: middle; margin-top: -2px;"></span>
+                    <?php esc_html_e('Customize Live', 'nexversal'); ?>
+                </a>
+            </div>
+        </div>
+
+        <p style="color: #64748b; font-size: 14px; margin-bottom: 24px;">
+            <?php esc_html_e('Configure your public contact information card, support email, headquarters link, and response time displayed on the Contact Us page.', 'nexversal'); ?>
+        </p>
+
+        <?php echo $notice; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>
+
+        <form method="post" action="" style="background: #ffffff; border: 1px solid #e2e8f0; border-radius: 8px; padding: 24px 30px; box-shadow: 0 1px 3px rgba(0,0,0,0.05);">
+            <?php wp_nonce_field('nexversal_save_contact_action', 'nexversal_contact_nonce'); ?>
+
+            <table class="form-table" role="presentation">
+                <tbody>
+                    <tr>
+                        <th scope="row">
+                            <label for="nexversal_show_contact_info"><?php esc_html_e('Contact Info Card', 'nexversal'); ?></label>
+                        </th>
+                        <td>
+                            <label for="nexversal_show_contact_info" style="font-weight: 600;">
+                                <input type="checkbox" name="nexversal_show_contact_info" id="nexversal_show_contact_info" value="1" <?php checked($show_info, true); ?> />
+                                <?php esc_html_e('Display Contact Information Card alongside the contact form', 'nexversal'); ?>
+                            </label>
+                            <p class="description"><?php esc_html_e('If unchecked, only the Send Us a Message form will be displayed centered on the page.', 'nexversal'); ?></p>
+                        </td>
+                    </tr>
+
+                    <tr>
+                        <th scope="row">
+                            <label for="nexversal_contact_title"><?php esc_html_e('Card Heading', 'nexversal'); ?></label>
+                        </th>
+                        <td>
+                            <input type="text" name="nexversal_contact_title" id="nexversal_contact_title" value="<?php echo esc_attr($info_title); ?>" class="regular-text" />
+                            <p class="description"><?php esc_html_e('Default: Contact Information', 'nexversal'); ?></p>
+                        </td>
+                    </tr>
+
+                    <tr>
+                        <th scope="row">
+                            <label for="nexversal_contact_desc"><?php esc_html_e('Card Description', 'nexversal'); ?></label>
+                        </th>
+                        <td>
+                            <textarea name="nexversal_contact_desc" id="nexversal_contact_desc" rows="3" class="large-text"><?php echo esc_textarea($info_desc); ?></textarea>
+                            <p class="description"><?php esc_html_e('A short intro explaining your support commitment to visitors.', 'nexversal'); ?></p>
+                        </td>
+                    </tr>
+
+                    <tr>
+                        <th scope="row">
+                            <label for="nexversal_contact_email"><?php esc_html_e('Support Email Address', 'nexversal'); ?></label>
+                        </th>
+                        <td>
+                            <input type="email" name="nexversal_contact_email" id="nexversal_contact_email" value="<?php echo esc_attr($info_email); ?>" class="regular-text" />
+                            <p class="description"><?php esc_html_e('The public email address visitors can click to email you directly.', 'nexversal'); ?></p>
+                        </td>
+                    </tr>
+
+                    <tr>
+                        <th scope="row">
+                            <label for="nexversal_contact_hq_text"><?php esc_html_e('Headquarters / City Text', 'nexversal'); ?></label>
+                        </th>
+                        <td>
+                            <input type="text" name="nexversal_contact_hq_text" id="nexversal_contact_hq_text" value="<?php echo esc_attr($hq_text); ?>" class="regular-text" />
+                            <p class="description"><?php esc_html_e('e.g. San Francisco, CA or nexversal.com/contact', 'nexversal'); ?></p>
+                        </td>
+                    </tr>
+
+                    <tr>
+                        <th scope="row">
+                            <label for="nexversal_contact_hq_url"><?php esc_html_e('Headquarters Link / Maps URL', 'nexversal'); ?></label>
+                        </th>
+                        <td>
+                            <input type="url" name="nexversal_contact_hq_url" id="nexversal_contact_hq_url" value="<?php echo esc_attr($hq_url); ?>" class="large-text" />
+                            <p class="description"><?php esc_html_e('Link opens in a new tab when clicked (e.g. your Google Maps location or Contact URL).', 'nexversal'); ?></p>
+                        </td>
+                    </tr>
+
+                    <tr>
+                        <th scope="row">
+                            <label for="nexversal_custom_social_links"><?php esc_html_e('Follow Us Social Links', 'nexversal'); ?></label>
+                        </th>
+                        <td>
+                            <textarea name="nexversal_custom_social_links" id="nexversal_custom_social_links" rows="5" class="large-text" placeholder="https://facebook.com/yourpage&#10;https://x.com/yourhandle&#10;https://linkedin.com/in/yourprofile&#10;https://github.com/yourorg"><?php echo esc_textarea($soc_links); ?></textarea>
+                            <p class="description">
+                                <?php esc_html_e('Enter one URL per line (e.g. Facebook, X/Twitter, LinkedIn, YouTube, Instagram, GitHub, TikTok, Discord, Telegram, or personal website). Nexversal automatically detects the brand and generates its official logo icon!', 'nexversal'); ?>
+                            </p>
+                        </td>
+                    </tr>
+                </tbody>
+            </table>
+
+            <div style="margin-top: 24px; padding-top: 20px; border-top: 1px solid #e2e8f0;">
+                <input type="submit" name="nexversal_save_contact" class="button button-primary button-large" value="<?php esc_attr_e('Save Contact Settings', 'nexversal'); ?>" style="background: #4f46e5; border-color: #4f46e5; font-weight: 600; padding: 4px 20px;" />
+            </div>
+        </form>
+    </div>
+    <?php
+}
+
+/**
+ * ==========================================================================
+ * 1-Click Starter Site / Demo Onboarding Engine
+ * ==========================================================================
+ */
+
+/**
+ * Register Appearance > Starter Site page in WP-Admin
+ */
+function nexversal_register_starter_site_admin_menu() {
+    add_theme_page(
+        esc_html__('Nexversal Starter Site', 'nexversal'),
+        esc_html__('Starter Site', 'nexversal'),
+        'manage_options',
+        'nexversal-starter',
+        'nexversal_render_starter_site_page'
+    );
+}
+add_action('admin_menu', 'nexversal_register_starter_site_admin_menu');
+
+/**
+ * Execute the 1-Click Starter Site Import safely & idempotently
+ */
+function nexversal_execute_starter_import() {
+    if (!current_user_can('manage_options')) {
+        return new WP_Error('forbidden', esc_html__('Permission denied.', 'nexversal'));
+    }
+
+    $summary = array(
+        'pages'      => 0,
+        'categories' => 0,
+        'posts'      => 0,
+        'menu'       => false,
+    );
+
+    // 1. Categories
+    $categories_data = array(
+        'Artificial Intelligence' => 'Cutting-edge AI models, autonomous agents, and machine learning insights.',
+        'Cloud Computing'         => 'High-scale cloud architectures, serverless systems, and DevOps engineering.',
+        'SEO & Performance'       => 'Search optimization, Core Web Vitals, and page speed engineering.',
+        'Tech Reviews'            => 'Unbiased evaluations of development tools, SaaS, and productivity software.',
+    );
+
+    $cat_ids = array();
+    foreach ($categories_data as $cat_name => $cat_desc) {
+        $term = term_exists($cat_name, 'category');
+        if (!$term) {
+            $inserted = wp_insert_term($cat_name, 'category', array('description' => $cat_desc));
+            if (!is_wp_error($inserted)) {
+                $cat_ids[$cat_name] = $inserted['term_id'];
+                $summary['categories']++;
+            }
+        } else {
+            $cat_ids[$cat_name] = is_array($term) ? $term['term_id'] : $term;
+        }
+    }
+
+    // 2. Core Pages via nexversal_setup_default_content
+    nexversal_setup_default_content();
+
+    $home_page    = get_page_by_path('home');
+    $blog_page    = get_page_by_path('blog') ?: get_page_by_path('blogs');
+    $about_page   = get_page_by_path('about') ?: get_page_by_path('about-us');
+    $contact_page = get_page_by_path('contact') ?: get_page_by_path('contact-us');
+
+    if ($home_page) $summary['pages']++;
+    if ($blog_page) $summary['pages']++;
+    if ($about_page) $summary['pages']++;
+    if ($contact_page) $summary['pages']++;
+
+    // 3. Demo Articles
+    $demo_articles = array(
+        array(
+            'title'    => 'Top 10 AI Tools Transforming Modern Software Engineering in 2026',
+            'category' => 'Artificial Intelligence',
+            'featured' => '1',
+            'views'    => 2840,
+            'excerpt'  => 'Explore next-generation AI coding assistants, agentic frameworks, and autonomous developer tools reshaping engineering productivity this year.',
+            'content'  => '<!-- wp:paragraph {"dropCap":true} -->
+<p class="has-drop-cap">Artificial intelligence is evolving beyond simple code autocomplete widgets into autonomous, agentic pair programmers capable of analyzing large codebases, maintaining documentation integrity, and writing exhaustive automated test suites.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading {"level":2} -->
+<h2>The Rise of Autonomous Agentic Pair Programmers</h2>
+<!-- /wp:heading -->
+
+<!-- wp:paragraph -->
+<p>Modern engineering teams are rapidly adopting multimodal agents that parse git repositories, execute local sandbox commands, and verify complex edge cases before proposing pull requests. This dramatically compresses developer feedback loops and eliminates boilerplate engineering.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading {"level":3} -->
+<h3>Key Architecture Benchmarks for 2026</h3>
+<!-- /wp:heading -->
+
+<!-- wp:list -->
+<ul>
+<li><strong>Sub-second Streaming Throughput:</strong> Instantaneous generation for interactive terminal workflows.</li>
+<li><strong>1M+ Token Context Memory:</strong> Complete architectural recall across multi-service repositories.</li>
+<li><strong>Strict Compiler Verification:</strong> Zero hallucinations through automated type checking and lint validation.</li>
+</ul>
+<!-- /wp:list -->',
+        ),
+        array(
+            'title'    => 'Comparing Cloud Databases: SQL vs NoSQL for High-Scale Apps',
+            'category' => 'Cloud Computing',
+            'featured' => '0',
+            'views'    => 1940,
+            'excerpt'  => 'An architectural deep-dive into transactional ACID guarantees versus horizontal distributed scalability in modern cloud applications.',
+            'content'  => '<p>Choosing the right database architecture is one of the most critical decisions in modern systems engineering. While relational databases like PostgreSQL provide atomic ACID transactions, horizontally scalable document stores excel at high-velocity ingestion.</p><h2>Transactional Guarantees vs Read Latency</h2><p>When engineering for multi-region active-active deployments, distributed consensus protocols require deliberate trade-offs between consistency and partition tolerance.</p>',
+        ),
+        array(
+            'title'    => 'The Ultimate Guide to Core Web Vitals and Page Experience',
+            'category' => 'SEO & Performance',
+            'featured' => '0',
+            'views'    => 1680,
+            'excerpt'  => 'Master LCP, INP, and CLS optimization techniques to achieve perfect 100/100 PageSpeed scores and maximize organic Google rankings.',
+            'content'  => '<p>Google’s Core Web Vitals are foundational ranking factors that directly dictate search visibility and user retention. Achieving sub-second Largest Contentful Paint (LCP) and minimal Interaction to Next Paint (INP) requires disciplined script management and clean semantic HTML.</p><h2>Optimizing Interaction to Next Paint (INP)</h2><p>Eliminate blocking JavaScript execution on the main thread and leverage modern CSS layout containment to deliver buttery smooth 60fps mobile responsiveness.</p>',
+        ),
+        array(
+            'title'    => 'Next-Gen Web Frameworks: Architecture Comparison and Benchmarks',
+            'category' => 'Tech Reviews',
+            'featured' => '0',
+            'views'    => 1420,
+            'excerpt'  => 'Comparing server-side rendering, partial hydration, and edge-native architectures across high-performance web platforms.',
+            'content'  => '<p>Modern web development has moved past monolithic client-side JavaScript bundles toward island architectures and edge rendering. By streaming HTML directly from edge nodes, modern platforms achieve instantaneous first paint times.</p>',
+        ),
+    );
+
+    foreach ($demo_articles as $art) {
+        $existing = get_page_by_title($art['title'], OBJECT, 'post');
+        if (!$existing) {
+            $cat_id = $cat_ids[$art['category']] ?? 1;
+            $new_post_id = wp_insert_post(array(
+                'post_title'   => $art['title'],
+                'post_content' => $art['content'],
+                'post_excerpt' => $art['excerpt'],
+                'post_status'  => 'publish',
+                'post_type'    => 'post',
+                'post_category'=> array($cat_id),
+            ));
+            if ($new_post_id && !is_wp_error($new_post_id)) {
+                if (!empty($art['featured'])) {
+                    update_post_meta($new_post_id, '_nexversal_featured_in_hero', '1');
+                }
+                update_post_meta($new_post_id, '_nexversal_post_views', (int) $art['views']);
+                $summary['posts']++;
+            }
+        } else {
+            if (!empty($art['featured'])) {
+                update_post_meta($existing->ID, '_nexversal_featured_in_hero', '1');
+            }
+        }
+    }
+
+    // 4. Ensure Primary Menu is active
+    $menu_obj = wp_get_nav_menu_object('Main Menu');
+    if ($menu_obj) {
+        $locations = get_theme_mod('nav_menu_locations', array());
+        $locations['primary'] = $menu_obj->term_id;
+        set_theme_mod('nav_menu_locations', $locations);
+        $summary['menu'] = true;
+    }
+
+    return $summary;
+}
+
+/**
+ * Render Appearance > Starter Site page in WP-Admin
+ */
+function nexversal_render_starter_site_page() {
+    if (!current_user_can('manage_options')) {
+        return;
+    }
+
+    $notice = '';
+    if (isset($_POST['nexversal_run_starter_import']) && check_admin_referer('nexversal_starter_import_action', 'nexversal_starter_nonce')) {
+        $result = nexversal_execute_starter_import();
+        if (is_wp_error($result)) {
+            $notice = '<div class="notice notice-error is-dismissible"><p>' . esc_html($result->get_error_message()) . '</p></div>';
+        } else {
+            $msg = sprintf(
+                /* translators: 1: categories count, 2: posts count */
+                esc_html__('🎉 Starter Site Imported Successfully! Core Pages verified/created, %1$d Categories mapped, %2$d Demo Stories ready, and Primary Navigation Menu linked.', 'nexversal'),
+                $result['categories'],
+                $result['posts']
+            );
+            $notice = '<div class="notice notice-success is-dismissible"><p><strong>' . $msg . '</strong></p></div>';
+        }
+    }
+
+    $screenshot_url = get_template_directory_uri() . '/screenshot.png';
+    $customizer_url = admin_url('customize.php');
+    $home_link      = home_url('/');
+    $contact_set    = admin_url('themes.php?page=nexversal-contact');
+    ?>
+    <div class="wrap" style="max-width: 1040px; margin-top: 24px;">
+        <div style="display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 12px; margin-bottom: 20px;">
+            <div>
+                <h1 style="display: flex; align-items: center; gap: 12px; font-weight: 800; font-size: 26px; margin: 0; color: #0f172a;">
+                    <span class="dashicons dashicons-admin-site-alt3" style="font-size: 32px; width: 32px; height: 32px; color: #4f46e5;"></span>
+                    <?php esc_html_e('Nexversal 1-Click Starter Site', 'nexversal'); ?>
+                </h1>
+                <p style="color: #64748b; font-size: 14px; margin: 6px 0 0 0;">
+                    <?php esc_html_e('Set up a complete, jaw-dropping Tech & Magazine website in 5 seconds. Zero manual configuration required.', 'nexversal'); ?>
+                </p>
+            </div>
+            <div style="display: flex; gap: 10px;">
+                <a href="<?php echo esc_url($home_link); ?>" target="_blank" class="button button-secondary">
+                    <span class="dashicons dashicons-external" style="vertical-align: middle; margin-top: -2px;"></span>
+                    <?php esc_html_e('Visit Live Site', 'nexversal'); ?>
+                </a>
+                <a href="<?php echo esc_url($customizer_url); ?>" class="button button-secondary">
+                    <span class="dashicons dashicons-admin-appearance" style="vertical-align: middle; margin-top: -2px;"></span>
+                    <?php esc_html_e('Live Customizer', 'nexversal'); ?>
+                </a>
+            </div>
+        </div>
+
+        <?php echo $notice; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>
+
+        <div style="display: grid; grid-template-columns: 1.15fr 0.85fr; gap: 28px; margin-top: 20px; align-items: start;">
+            <!-- Left Card: Starter Demo Preview & Action -->
+            <div style="background: #ffffff; border: 1px solid #e2e8f0; border-radius: 12px; overflow: hidden; box-shadow: 0 4px 16px rgba(0,0,0,0.04);">
+                <div style="position: relative; overflow: hidden; max-height: 280px; background: #0f172a;">
+                    <img src="<?php echo esc_url($screenshot_url); ?>" alt="<?php esc_attr_e('Nexversal Demo Preview', 'nexversal'); ?>" style="width: 100%; height: auto; display: block; object-fit: cover;" />
+                    <div style="position: absolute; top: 14px; left: 14px; background: rgba(15,23,42,0.85); color: #38bdf8; padding: 4px 12px; border-radius: 20px; font-size: 11px; font-weight: 700; text-transform: uppercase; letter-spacing: 0.05em; backdrop-filter: blur(4px);">
+                        ⚡ <?php esc_html_e('Tech & Magazine Edition', 'nexversal'); ?>
+                    </div>
+                </div>
+
+                <div style="padding: 28px 30px;">
+                    <h3 style="font-size: 18px; font-weight: 800; color: #0f172a; margin: 0 0 10px 0;">
+                        <?php esc_html_e('Ready-Made Tech & Magazine Demo', 'nexversal'); ?>
+                    </h3>
+                    <p style="color: #64748b; font-size: 14px; line-height: 1.6; margin: 0 0 20px 0;">
+                        <?php esc_html_e('Clicking the button below instantly configures your entire site with our flagship Tech & Magazine structure. Perfectly pre-linked and optimized for Google Core Web Vitals.', 'nexversal'); ?>
+                    </p>
+
+                    <form method="post" action="">
+                        <?php wp_nonce_field('nexversal_starter_import_action', 'nexversal_starter_nonce'); ?>
+                        
+                        <div style="background: #f8fafc; border: 1px solid #e2e8f0; border-radius: 8px; padding: 14px 16px; margin-bottom: 22px;">
+                            <label style="display: flex; align-items: flex-start; gap: 10px; cursor: pointer; font-size: 13px; font-weight: 600; color: #1e293b;">
+                                <input type="checkbox" checked="checked" disabled="disabled" style="margin-top: 2px;" />
+                                <div>
+                                    <span><?php esc_html_e('Safe & Idempotent Onboarding Mode', 'nexversal'); ?></span>
+                                    <span style="display: block; font-size: 11px; font-weight: 400; color: #64748b; margin-top: 2px;">
+                                        <?php esc_html_e('Existing posts, pages, and media are completely safe and will never be deleted or duplicated.', 'nexversal'); ?>
+                                    </span>
+                                </div>
+                            </label>
+                        </div>
+
+                        <button type="submit" name="nexversal_run_starter_import" class="button button-primary button-hero" style="background: linear-gradient(135deg, #4f46e5 0%, #7c3aed 100%); border: none; font-weight: 700; font-size: 15px; padding: 12px 28px; height: auto; border-radius: 8px; box-shadow: 0 4px 14px rgba(79, 70, 229, 0.35); cursor: pointer; display: inline-flex; align-items: center; gap: 8px;">
+                            <span>🚀 <?php esc_html_e('Import Starter Site (1-Click)', 'nexversal'); ?></span>
+                        </button>
+                    </form>
+                </div>
+            </div>
+
+            <!-- Right Card: What Gets Imported & Features -->
+            <div style="display: flex; flex-direction: column; gap: 20px;">
+                <div style="background: #ffffff; border: 1px solid #e2e8f0; border-radius: 12px; padding: 26px; box-shadow: 0 4px 16px rgba(0,0,0,0.04);">
+                    <h3 style="font-size: 16px; font-weight: 700; color: #0f172a; margin: 0 0 16px 0; display: flex; align-items: center; gap: 8px;">
+                        <span class="dashicons dashicons-yes-alt" style="color: #10b981;"></span>
+                        <?php esc_html_e('What’s Included in This Starter Site:', 'nexversal'); ?>
+                    </h3>
+
+                    <ul style="margin: 0; padding: 0; list-style: none; display: flex; flex-direction: column; gap: 14px;">
+                        <li style="display: flex; gap: 12px; font-size: 13px; color: #334155; line-height: 1.5;">
+                            <span style="color: #4f46e5; font-size: 16px; font-weight: 700;">&#10003;</span>
+                            <div>
+                                <strong><?php esc_html_e('4 Complete Core Pages:', 'nexversal'); ?></strong><br>
+                                <?php esc_html_e('Home (2-Column Hero), Blogs (4-Column Grid), About Us, and Contact Us.', 'nexversal'); ?>
+                            </div>
+                        </li>
+                        <li style="display: flex; gap: 12px; font-size: 13px; color: #334155; line-height: 1.5;">
+                            <span style="color: #4f46e5; font-size: 16px; font-weight: 700;">&#10003;</span>
+                            <div>
+                                <strong><?php esc_html_e('2-Column Hero & Featured Story Card:', 'nexversal'); ?></strong><br>
+                                <?php esc_html_e('Main headline on the left, trending featured article card automatically pinned on the right.', 'nexversal'); ?>
+                            </div>
+                        </li>
+                        <li style="display: flex; gap: 12px; font-size: 13px; color: #334155; line-height: 1.5;">
+                            <span style="color: #4f46e5; font-size: 16px; font-weight: 700;">&#10003;</span>
+                            <div>
+                                <strong><?php esc_html_e('Pre-Mapped Navigation Menu:', 'nexversal'); ?></strong><br>
+                                <?php esc_html_e('Auto-connected to Primary Menu location with clean header links.', 'nexversal'); ?>
+                            </div>
+                        </li>
+                        <li style="display: flex; gap: 12px; font-size: 13px; color: #334155; line-height: 1.5;">
+                            <span style="color: #4f46e5; font-size: 16px; font-weight: 700;">&#10003;</span>
+                            <div>
+                                <strong><?php esc_html_e('Tech Categories & Sample Articles:', 'nexversal'); ?></strong><br>
+                                <?php esc_html_e('AI, Cloud, SEO, and Reviews categories with trending tags.', 'nexversal'); ?>
+                            </div>
+                        </li>
+                    </ul>
+                </div>
+
+                <div style="background: #f1f5f9; border: 1px solid #cbd5e1; border-radius: 12px; padding: 20px 22px;">
+                    <h4 style="font-size: 14px; font-weight: 700; color: #1e293b; margin: 0 0 8px 0;">
+                        <?php esc_html_e('Need to customize details afterwards?', 'nexversal'); ?>
+                    </h4>
+                    <p style="font-size: 12px; color: #64748b; line-height: 1.5; margin: 0 0 12px 0;">
+                        <?php esc_html_e('You can change contact emails, social links, and brand colors anytime from Appearance > Contact Settings or Appearance > Customize.', 'nexversal'); ?>
+                    </p>
+                    <a href="<?php echo esc_url($contact_set); ?>" class="button button-small" style="font-weight: 600;">
+                        <?php esc_html_e('Open Contact Settings', 'nexversal'); ?>
+                    </a>
+                </div>
+            </div>
+        </div>
+    </div>
+    <?php
+}
+
+
+/**
+ * ==========================================================================
+ * Hero Featured Article & Post Views System
+ * ==========================================================================
+ */
+
+/**
+ * Register Meta Box in Post Editor for Hero Featured Article
+ */
+function nexversal_add_featured_post_meta_box() {
+    add_meta_box(
+        'nexversal_featured_post_box',
+        esc_html__('★ Hero Featured Article', 'nexversal'),
+        'nexversal_render_featured_post_meta_box',
+        'post',
+        'side',
+        'high'
+    );
+}
+add_action('add_meta_boxes', 'nexversal_add_featured_post_meta_box');
+
+/**
+ * Render the Meta Box in post editor
+ */
+function nexversal_render_featured_post_meta_box($post) {
+    wp_nonce_field('nexversal_featured_post_nonce_action', 'nexversal_featured_post_nonce');
+    $is_featured = get_post_meta($post->ID, '_nexversal_featured_in_hero', true);
+    $views       = (int) get_post_meta($post->ID, '_nexversal_post_views', true);
+    ?>
+    <p>
+        <label for="nexversal_featured_in_hero" style="font-weight: 600; cursor: pointer; display: flex; align-items: flex-start; gap: 8px;">
+            <input type="checkbox" name="nexversal_featured_in_hero" id="nexversal_featured_in_hero" value="1" <?php checked($is_featured, '1'); ?> style="margin-top: 2px;" />
+            <span><?php esc_html_e('Feature in Homepage Hero', 'nexversal'); ?></span>
+        </label>
+    </p>
+    <p class="description" style="font-size: 12px; color: #64748b; line-height: 1.4; margin-top: 6px;">
+        <?php esc_html_e('Display this article at the top of the homepage next to the main headline. If none selected, the theme automatically displays your trending / most-viewed article.', 'nexversal'); ?>
+    </p>
+    <div style="margin-top: 12px; padding-top: 8px; border-top: 1px dashed #cbd5e1; font-size: 12px; color: #64748b; display: flex; align-items: center; justify-content: space-between;">
+        <span><?php esc_html_e('Article Views:', 'nexversal'); ?></span>
+        <strong style="color: #0f172a; font-size: 13px;"><?php echo number_format_i18n($views); ?></strong>
+    </div>
+    <?php
+}
+
+/**
+ * Save the Meta Box value
+ */
+function nexversal_save_featured_post_meta_box($post_id) {
+    if (!isset($_POST['nexversal_featured_post_nonce']) || !wp_verify_nonce(sanitize_text_field(wp_unslash($_POST['nexversal_featured_post_nonce'])), 'nexversal_featured_post_nonce_action')) {
+        return;
+    }
+    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
+        return;
+    }
+    if (!current_user_can('edit_post', $post_id)) {
+        return;
+    }
+
+    if (!empty($_POST['nexversal_featured_in_hero'])) {
+        update_post_meta($post_id, '_nexversal_featured_in_hero', '1');
+    } else {
+        delete_post_meta($post_id, '_nexversal_featured_in_hero');
+    }
+}
+add_action('save_post_post', 'nexversal_save_featured_post_meta_box');
+
+/**
+ * Track Post Views on single article visits
+ */
+function nexversal_track_post_views() {
+    if (!is_single() || is_preview()) {
+        return;
+    }
+    global $post;
+    if (!$post || !isset($post->ID)) {
+        return;
+    }
+    $views = (int) get_post_meta($post->ID, '_nexversal_post_views', true);
+    update_post_meta($post->ID, '_nexversal_post_views', $views + 1);
+}
+add_action('template_redirect', 'nexversal_track_post_views');
+
+/**
+ * Add Featured and Views columns to WP-Admin posts list
+ */
+function nexversal_add_post_columns($columns) {
+    $columns['nx_featured'] = esc_html__('Hero Card', 'nexversal');
+    $columns['nx_views']    = esc_html__('Views', 'nexversal');
+    return $columns;
+}
+add_filter('manage_posts_columns', 'nexversal_add_post_columns');
+
+function nexversal_custom_post_columns($column, $post_id) {
+    if ('nx_featured' === $column) {
+        $is_feat = get_post_meta($post_id, '_nexversal_featured_in_hero', true);
+        if ('1' === $is_feat) {
+            echo '<span style="color: #f59e0b; font-weight: 700;">&#9733; ' . esc_html__('Featured', 'nexversal') . '</span>';
+        } else {
+            echo '<span style="color: #94a3b8;">&mdash;</span>';
+        }
+    } elseif ('nx_views' === $column) {
+        $views = (int) get_post_meta($post_id, '_nexversal_post_views', true);
+        echo '<strong>' . number_format_i18n($views) . '</strong>';
+    }
+}
+add_action('manage_posts_custom_column', 'nexversal_custom_post_columns', 10, 2);
+
+/**
+ * Retrieve the Hero Featured Post:
+ * 1. Post manually checked '_nexversal_featured_in_hero'
+ * 2. Fallback: Post with highest views
+ * 3. Fallback: Sticky post
+ * 4. Fallback: Latest post
+ */
+function nexversal_get_hero_featured_post() {
+    // 1. Manually selected
+    $args_selected = array(
+        'post_type'      => 'post',
+        'post_status'    => 'publish',
+        'posts_per_page' => 1,
+        'meta_key'       => '_nexversal_featured_in_hero',
+        'meta_value'     => '1',
+        'orderby'        => 'date',
+        'order'          => 'DESC',
+    );
+    $selected_query = new WP_Query($args_selected);
+    if ($selected_query->have_posts()) {
+        $p = $selected_query->posts[0];
+        wp_reset_postdata();
+        return $p;
+    }
+
+    // 2. Fallback: Highest views
+    $args_views = array(
+        'post_type'      => 'post',
+        'post_status'    => 'publish',
+        'posts_per_page' => 1,
+        'meta_key'       => '_nexversal_post_views',
+        'orderby'        => 'meta_value_num',
+        'order'          => 'DESC',
+    );
+    $views_query = new WP_Query($args_views);
+    if ($views_query->have_posts() && (int) get_post_meta($views_query->posts[0]->ID, '_nexversal_post_views', true) > 0) {
+        $p = $views_query->posts[0];
+        wp_reset_postdata();
+        return $p;
+    }
+
+    // 3. Fallback: Sticky posts
+    $sticky = get_option('sticky_posts');
+    if (!empty($sticky)) {
+        $args_sticky = array(
+            'post_type'           => 'post',
+            'post_status'         => 'publish',
+            'posts_per_page'      => 1,
+            'post__in'            => $sticky,
+            'ignore_sticky_posts' => 1,
+        );
+        $sticky_query = new WP_Query($args_sticky);
+        if ($sticky_query->have_posts()) {
+            $p = $sticky_query->posts[0];
+            wp_reset_postdata();
+            return $p;
+        }
+    }
+
+    // 4. Fallback: Latest published post
+    $args_latest = array(
+        'post_type'      => 'post',
+        'post_status'    => 'publish',
+        'posts_per_page' => 1,
+        'orderby'        => 'date',
+        'order'          => 'DESC',
+    );
+    $latest_query = new WP_Query($args_latest);
+    if ($latest_query->have_posts()) {
+        $p = $latest_query->posts[0];
+        wp_reset_postdata();
+        return $p;
+    }
+
+    return null;
+}
+
+/**
+ * Render the Hero Featured Article Card HTML
+ */
+function nexversal_get_hero_featured_card_html() {
+    $featured_post = nexversal_get_hero_featured_post();
+    if (!$featured_post) {
+        return '';
+    }
+
+    $post_id     = $featured_post->ID;
+    $title       = get_the_title($post_id);
+    $permalink   = get_permalink($post_id);
+    $author_id   = $featured_post->post_author;
+    $author      = get_the_author_meta('display_name', $author_id);
+    $cats        = get_the_category($post_id);
+    $cat_name    = !empty($cats) ? $cats[0]->name : __('Article', 'nexversal');
+    $cat_link    = !empty($cats) ? get_category_link($cats[0]->term_id) : '#';
+    $is_manual   = ('1' === get_post_meta($post_id, '_nexversal_featured_in_hero', true));
+
+    // Calculate reading time
+    $content      = get_post_field('post_content', $post_id);
+    $word_count   = str_word_count(strip_tags($content));
+    $reading_time = max(1, ceil($word_count / 200)) . ' ' . esc_html__('min read', 'nexversal');
+
+    // Get thumbnail or high-tech fallback
+    $has_thumb  = has_post_thumbnail($post_id);
+    $thumb_html = '';
+    if ($has_thumb) {
+        $thumb_html = get_the_post_thumbnail($post_id, 'medium_large', array(
+            'class'   => 'nx-hero-card-img',
+            'loading' => 'eager',
+            'alt'     => esc_attr($title),
+        ));
+    } else {
+        $thumb_html = '<div class="nx-hero-card-img-fallback">' .
+            '<svg width="54" height="54" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><polyline points="21 15 16 10 5 21"/></svg>' .
+            '</div>';
+    }
+
+    $raw_excerpt = get_the_excerpt($post_id);
+    if (empty($raw_excerpt)) {
+        $raw_excerpt = wp_strip_all_tags($content);
+    }
+    $excerpt = wp_trim_words($raw_excerpt, 16, '...');
+
+    ob_start();
+    ?>
+    <article class="nx-hero-featured-card">
+        <div class="nx-hero-card-badge-wrap">
+            <span class="nx-hero-card-featured-tag">
+                <svg width="13" height="13" viewBox="0 0 24 24" fill="currentColor"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
+                <?php echo $is_manual ? esc_html__('Featured Story', 'nexversal') : esc_html__('Trending Story', 'nexversal'); ?>
+            </span>
+        </div>
+        <a href="<?php echo esc_url($permalink); ?>" class="nx-hero-card-thumb-wrap" tabindex="-1" aria-hidden="true">
+            <?php echo $thumb_html; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>
+        </a>
+        <div class="nx-hero-card-body">
+            <div class="nx-hero-card-meta-top">
+                <a href="<?php echo esc_url($cat_link); ?>" class="nx-hero-card-cat">
+                    <?php echo esc_html($cat_name); ?>
+                </a>
+                <span class="nx-hero-card-time"><?php echo esc_html($reading_time); ?></span>
+            </div>
+            <h3 class="nx-hero-card-title">
+                <a href="<?php echo esc_url($permalink); ?>"><?php echo esc_html($title); ?></a>
+            </h3>
+            <?php if (!empty($excerpt)) : ?>
+                <p class="nx-hero-card-excerpt"><?php echo esc_html($excerpt); ?></p>
+            <?php endif; ?>
+            <div class="nx-hero-card-footer">
+                <div class="nx-hero-card-author">
+                    <?php echo get_avatar($author_id, 24, '', '', array('class' => 'nx-hero-card-avatar')); ?>
+                    <span><?php echo esc_html($author); ?></span>
+                </div>
+                <a href="<?php echo esc_url($permalink); ?>" class="nx-hero-card-read-link">
+                    <span><?php esc_html_e('Read Story', 'nexversal'); ?></span>
+                    <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><line x1="5" y1="12" x2="19" y2="12"></line><polyline points="12 5 19 12 12 19"></polyline></svg>
+                </a>
+            </div>
+        </div>
+    </article>
+    <?php
+    return ob_get_clean();
+}
+
+/**
+ * Filter render_block to inject the Featured Card into any nx-hero-section group on Home page
+ */
+function nexversal_render_hero_block_enhancement($block_content, $block) {
+    if ('core/group' === ($block['blockName'] ?? '') && !empty($block['attrs']['className']) && strpos($block['attrs']['className'], 'nx-hero-section') !== false && strpos($block_content, 'nx-hero-grid') === false) {
+        $pos_gt    = strpos($block_content, '>');
+        $pos_close = strrpos($block_content, '</div>');
+        if ($pos_gt !== false && $pos_close !== false && $pos_close > $pos_gt) {
+            $open_tag      = substr($block_content, 0, $pos_gt + 1);
+            $inner_content = substr($block_content, $pos_gt + 1, $pos_close - ($pos_gt + 1));
+            $featured_card = nexversal_get_hero_featured_card_html();
+            if (!empty($featured_card)) {
+                $featured_col = '<div class="nx-hero-featured-col">' . $featured_card . '</div>';
+                return $open_tag . '<div class="nx-hero-grid"><div class="nx-hero-content-col">' . $inner_content . '</div>' . $featured_col . '</div></div>';
+            }
+        }
+    }
+    return $block_content;
+}
+add_filter('render_block', 'nexversal_render_hero_block_enhancement', 10, 2);
+
+/**
+ * ==========================================================================
+ * Page Flexibility: Astra-Style Per-Page Layout Settings
+ * ==========================================================================
+ */
+
+/**
+ * Check if a specific page setting is disabled for the current post/page
+ */
+function nexversal_is_meta_disabled($feature, $post_id = 0) {
+    if (!$post_id) {
+        if (is_singular()) {
+            $post_id = get_the_ID();
+        } elseif (is_front_page() && 'page' === get_option('show_on_front')) {
+            $post_id = (int) get_option('page_on_front');
+        }
+    }
+    if (!$post_id) {
+        return false;
+    }
+    $val = get_post_meta($post_id, '_nexversal_' . $feature, true);
+    return ('1' === $val);
+}
+
+/**
+ * Retrieve the active content layout for the current page
+ */
+function nexversal_get_page_layout($post_id = 0) {
+    if (!$post_id) {
+        if (is_singular()) {
+            $post_id = get_the_ID();
+        } elseif (is_front_page() && 'page' === get_option('show_on_front')) {
+            $post_id = (int) get_option('page_on_front');
+        }
+    }
+    if (!$post_id) {
+        return 'default';
+    }
+    $layout = get_post_meta($post_id, '_nexversal_content_layout', true);
+    return !empty($layout) ? $layout : 'default';
+}
+
+/**
+ * Register the Page Settings Meta Box for Pages & Posts
+ */
+function nexversal_add_page_settings_meta_box() {
+    $screens = array('page', 'post');
+    foreach ($screens as $screen) {
+        add_meta_box(
+            'nexversal_page_settings_box',
+            esc_html__('Nexversal Page Settings', 'nexversal'),
+            'nexversal_render_page_settings_meta_box',
+            $screen,
+            'side',
+            'default'
+        );
+    }
+}
+add_action('add_meta_boxes', 'nexversal_add_page_settings_meta_box');
+
+/**
+ * Render the Page Settings Meta Box in post/page editor
+ */
+function nexversal_render_page_settings_meta_box($post) {
+    wp_nonce_field('nexversal_page_settings_nonce_action', 'nexversal_page_settings_nonce');
+
+    $disable_header      = get_post_meta($post->ID, '_nexversal_disable_header', true);
+    $disable_footer      = get_post_meta($post->ID, '_nexversal_disable_footer', true);
+    $disable_title       = get_post_meta($post->ID, '_nexversal_disable_title', true);
+    $disable_breadcrumbs = get_post_meta($post->ID, '_nexversal_disable_breadcrumbs', true);
+    $disable_sidebar     = get_post_meta($post->ID, '_nexversal_disable_sidebar', true);
+    $content_layout      = get_post_meta($post->ID, '_nexversal_content_layout', true);
+    if (empty($content_layout)) {
+        $content_layout = 'default';
+    }
+    ?>
+    <div class="nx-page-meta-box-wrap" style="font-size: 13px;">
+        <p style="font-weight: 700; color: #1e293b; margin: 4px 0 8px; border-bottom: 1px solid #e2e8f0; padding-bottom: 4px;">
+            <?php esc_html_e('Content Layout', 'nexversal'); ?>
+        </p>
+        <div style="margin-bottom: 14px;">
+            <label style="display: block; margin-bottom: 6px; cursor: pointer;">
+                <input type="radio" name="nexversal_content_layout" value="default" <?php checked($content_layout, 'default'); ?> />
+                <span><?php esc_html_e('Default Theme Layout', 'nexversal'); ?></span>
+            </label>
+            <label style="display: block; margin-bottom: 6px; cursor: pointer;">
+                <input type="radio" name="nexversal_content_layout" value="full-width-contained" <?php checked($content_layout, 'full-width-contained'); ?> />
+                <span><?php esc_html_e('Full Width (Contained)', 'nexversal'); ?></span>
+            </label>
+            <label style="display: block; margin-bottom: 6px; cursor: pointer;">
+                <input type="radio" name="nexversal_content_layout" value="full-width-stretched" <?php checked($content_layout, 'full-width-stretched'); ?> />
+                <span style="font-weight: 600; color: #4f46e5;"><?php esc_html_e('Full Width Stretched (Canvas)', 'nexversal'); ?></span>
+            </label>
+            <p class="description" style="font-size: 11px; color: #64748b; margin-top: 4px; line-height: 1.4;">
+                <?php esc_html_e('Canvas is ideal for Elementor or full-screen custom landing pages.', 'nexversal'); ?>
+            </p>
+        </div>
+
+        <p style="font-weight: 700; color: #1e293b; margin: 12px 0 8px; border-bottom: 1px solid #e2e8f0; padding-bottom: 4px;">
+            <?php esc_html_e('Disable Elements', 'nexversal'); ?>
+        </p>
+        <div style="display: flex; flex-direction: column; gap: 8px;">
+            <label style="cursor: pointer; display: flex; align-items: center; gap: 8px;">
+                <input type="checkbox" name="nexversal_disable_header" value="1" <?php checked($disable_header, '1'); ?> />
+                <span><?php esc_html_e('Disable Header', 'nexversal'); ?></span>
+            </label>
+
+            <label style="cursor: pointer; display: flex; align-items: center; gap: 8px;">
+                <input type="checkbox" name="nexversal_disable_footer" value="1" <?php checked($disable_footer, '1'); ?> />
+                <span><?php esc_html_e('Disable Footer', 'nexversal'); ?></span>
+            </label>
+
+            <label style="cursor: pointer; display: flex; align-items: center; gap: 8px;">
+                <input type="checkbox" name="nexversal_disable_title" value="1" <?php checked($disable_title, '1'); ?> />
+                <span><?php esc_html_e('Disable Page Title', 'nexversal'); ?></span>
+            </label>
+
+            <label style="cursor: pointer; display: flex; align-items: center; gap: 8px;">
+                <input type="checkbox" name="nexversal_disable_breadcrumbs" value="1" <?php checked($disable_breadcrumbs, '1'); ?> />
+                <span><?php esc_html_e('Disable Breadcrumbs', 'nexversal'); ?></span>
+            </label>
+
+            <label style="cursor: pointer; display: flex; align-items: center; gap: 8px;">
+                <input type="checkbox" name="nexversal_disable_sidebar" value="1" <?php checked($disable_sidebar, '1'); ?> />
+                <span><?php esc_html_e('Disable Sidebar (Force 100% Width)', 'nexversal'); ?></span>
+            </label>
+        </div>
+    </div>
+    <?php
+}
+
+/**
+ * Save Page Settings Meta Box
+ */
+function nexversal_save_page_settings_meta_box($post_id) {
+    if (!isset($_POST['nexversal_page_settings_nonce']) || !wp_verify_nonce(sanitize_text_field(wp_unslash($_POST['nexversal_page_settings_nonce'])), 'nexversal_page_settings_nonce_action')) {
+        return;
+    }
+    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
+        return;
+    }
+    if (!current_user_can('edit_post', $post_id)) {
+        return;
+    }
+
+    $checkbox_keys = array(
+        'disable_header',
+        'disable_footer',
+        'disable_title',
+        'disable_breadcrumbs',
+        'disable_sidebar',
+    );
+
+    foreach ($checkbox_keys as $key) {
+        if (!empty($_POST['nexversal_' . $key])) {
+            update_post_meta($post_id, '_nexversal_' . $key, '1');
+        } else {
+            delete_post_meta($post_id, '_nexversal_' . $key);
+        }
+    }
+
+    if (isset($_POST['nexversal_content_layout'])) {
+        $layout = sanitize_key($_POST['nexversal_content_layout']);
+        if (in_array($layout, array('default', 'full-width-contained', 'full-width-stretched'), true)) {
+            update_post_meta($post_id, '_nexversal_content_layout', $layout);
+        }
+    }
+}
+add_action('save_post', 'nexversal_save_page_settings_meta_box');
+
+/**
+ * Filter body_class to inject layout & disabled classes for CSS hooks
+ */
+function nexversal_page_settings_body_classes($classes) {
+    $post_id = 0;
+    if (is_singular()) {
+        $post_id = get_the_ID();
+    } elseif (is_front_page() && 'page' === get_option('show_on_front')) {
+        $post_id = (int) get_option('page_on_front');
+    } elseif (is_home() && 'page' === get_option('show_on_front')) {
+        $post_id = (int) get_option('page_for_posts');
+    }
+
+    if ($post_id) {
+        $layout = nexversal_get_page_layout($post_id);
+        if ('full-width-stretched' === $layout) {
+            $classes[] = 'nx-layout-stretched';
+        } elseif ('full-width-contained' === $layout) {
+            $classes[] = 'nx-layout-contained';
+        }
+
+        if (nexversal_is_meta_disabled('disable_header', $post_id)) {
+            $classes[] = 'nx-no-header';
+        }
+        if (nexversal_is_meta_disabled('disable_footer', $post_id)) {
+            $classes[] = 'nx-no-footer';
+        }
+        if (nexversal_is_meta_disabled('disable_title', $post_id)) {
+            $classes[] = 'nx-no-title';
+        }
+        if (nexversal_is_meta_disabled('disable_breadcrumbs', $post_id)) {
+            $classes[] = 'nx-no-breadcrumbs';
+        }
+        if (nexversal_is_meta_disabled('disable_sidebar', $post_id)) {
+            $classes[] = 'nx-no-sidebar';
+        }
+    }
+
+    // Auto-detect templates or conditions without sidebar
+    if (is_page_template('template-blog.php') || is_page_template('template-full-width.php') || !is_active_sidebar('sidebar-1')) {
+        if (!in_array('nx-no-sidebar', $classes, true)) {
+            $classes[] = 'nx-no-sidebar';
+        }
+    }
+
+    return array_unique($classes);
+}
+add_filter('body_class', 'nexversal_page_settings_body_classes');
+
+
+
+
+

nexversal/3.5.9/header.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Header template for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com 
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Header template
- *
- * @package Nexversal
- */
 ?><!DOCTYPE html>
 <html <?php language_attributes(); ?>>
@@ -29 +30 @@
 <?php endif; ?>
 
+<?php if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_header')) : ?>
 <header id="masthead" class="site-header">
     <div class="container">
@@ -59 +61 @@
                     'container'      => false,
                     'fallback_cb'    => function () {
-                        echo '<ul>';
+                        echo '<ul id="primary-menu" class="menu">';
                         echo '<li><a href="' . esc_url(home_url('/')) . '">' . esc_html__('Home', 'nexversal') . '</a></li>';
-                        wp_list_pages(array(
-                            'title_li' => '',
-                            'depth'    => 1,
-                            'number'   => 5,
-                        ));
+
+                        $blog_url    = function_exists('nexversal_get_blogs_page_url') ? nexversal_get_blogs_page_url() : home_url('/blog/');
+                        $about_url   = function_exists('nexversal_get_about_page_url') ? nexversal_get_about_page_url() : home_url('/about/');
+                        $contact_url = function_exists('nexversal_get_contact_page_url') ? nexversal_get_contact_page_url() : home_url('/contact/');
+
+                        echo '<li><a href="' . esc_url($blog_url) . '">' . esc_html__('Blogs', 'nexversal') . '</a></li>';
+                        echo '<li><a href="' . esc_url($about_url) . '">' . esc_html__('About Us', 'nexversal') . '</a></li>';
+                        echo '<li><a href="' . esc_url($contact_url) . '">' . esc_html__('Contact', 'nexversal') . '</a></li>';
                         echo '</ul>';
                     },
@@ -126 +131 @@
 endif;
 ?>
+<?php endif; // End disable_header check ?>
 

nexversal/3.5.9/inc/ad-manager.php

@@ -1 +1 @@
 <?php
 /**
- * Nexversal Built-in Ad & Monetization Engine (PRO Feature - $15/year)
- *
- * Provides ready-to-use AdSense, Mediavine, and custom banner ad slots
- * with automatic in-article paragraph injection and responsive containers.
- * Integrates with Lemon Squeezy & cryptographic license verification.
+ * Nexversal Built-in Ad & Monetization Engine (v3.5.0)
+ *
+ * Beginner-Friendly & Powerful Ad Architecture:
+ * - 1-Click Google Auto-Ads (Just enter Publisher ID)
+ * - Free Plan: Up to 3 Simultaneous Active Ads (Dropdown Position Selectors)
+ * - Pro Plan ($15/yr): Unlimited Simultaneous Ads & Ad-Blocker Bypass
+ * - Automatic Worldwide Geo-Targeting (Visitors in 195+ countries see ads in their local currency)
+ * - Real-Time Impressions, Clicks & CTR Analytics Dashboard
  *
  * @package Nexversal
- * @version 2.3.0
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
+ * @version 3.5.0
  */
 
@@ -14 +21 @@
     exit;
 }
+
+/**
+ * Load AdSense Cumulative Layout Shift (CLS) Prevention Engine
+ */
+require_once get_template_directory() . '/inc/ad-cls-optimizer.php';
 
 /**
@@ -35 +47 @@
         return esc_url($custom_url);
     }
-    // Direct Lemon Squeezy Store Checkout
     return apply_filters('nexversal_pro_checkout_url', 'https://nexversal.lemonsqueezy.com/checkout/buy/nexversal-pro');
+}
+
+/**
+ * Detect visitor country code automatically using Cloudflare, Fastly, AWS, or server geo-headers.
+ * Supports all 195+ countries worldwide (US, GB, CA, AU, DE, AE, SA, PK, IN, etc.).
+ *
+ * @return string ISO 2-letter country code or 'XX'
+ */
+function nexversal_get_visitor_country() {
+    $country = '';
+
+    // 1. Cloudflare IP-Geolocation header (Cloudflare handles 195+ countries globally)
+    if (!empty($_SERVER['HTTP_CF_IPCOUNTRY'])) {
+        $country = sanitize_text_field(wp_unslash($_SERVER['HTTP_CF_IPCOUNTRY']));
+    }
+    // 2. AWS CloudFront Geolocation header
+    elseif (!empty($_SERVER['HTTP_CLOUDFRONT_VIEWER_COUNTRY'])) {
+        $country = sanitize_text_field(wp_unslash($_SERVER['HTTP_CLOUDFRONT_VIEWER_COUNTRY']));
+    }
+    // 3. Fastly / Akamai / Reverse Proxy Country header
+    elseif (!empty($_SERVER['HTTP_X_COUNTRY_CODE'])) {
+        $country = sanitize_text_field(wp_unslash($_SERVER['HTTP_X_COUNTRY_CODE']));
+    }
+    // 4. Standard GeoIP module (Apache/Nginx mod_geoip or MaxMind)
+    elseif (!empty($_SERVER['GEOIP_COUNTRY_CODE'])) {
+        $country = sanitize_text_field(wp_unslash($_SERVER['GEOIP_COUNTRY_CODE']));
+    } elseif (!empty($_SERVER['HTTP_X_GEOIP_COUNTRY'])) {
+        $country = sanitize_text_field(wp_unslash($_SERVER['HTTP_X_GEOIP_COUNTRY']));
+    }
+
+    $country = strtoupper(trim($country));
+    if (!empty($country) && strlen($country) === 2 && ctype_alpha($country)) {
+        return apply_filters('nexversal_visitor_country', $country);
+    }
+
+    return apply_filters('nexversal_visitor_country', 'XX');
 }
 
@@ -100 +147 @@
         $body = wp_remote_retrieve_body($response);
         $data = json_decode($body, true);
+
         if (isset($data['activated']) && true === $data['activated']) {
             return array(
@@ -117 +165 @@
 function nexversal_pro_admin_menu() {
     add_theme_page(
-        esc_html__('Nexversal PRO ($15/year)', 'nexversal'),
+        esc_html__('Nexversal PRO & Ad Monetization', 'nexversal'),
         esc_html__('Nexversal PRO ⚡', 'nexversal'),
         'manage_options',
@@ -127 +175 @@
 
 /**
- * Handle License Activation / Deactivation Form Submission
+ * Handle License & Analytics Form Submissions
  */
 function nexversal_handle_license_action() {
@@ -177 +225 @@
         exit;
     }
+
+    // Handle Reset Analytics
+    if (isset($_POST['nexversal_reset_ad_stats'])) {
+        delete_option('nexversal_ad_analytics');
+        wp_safe_redirect(add_query_arg(array('page' => 'nexversal-pro', 'stats_reset' => '1'), admin_url('themes.php')));
+        exit;
+    }
 }
 add_action('admin_init', 'nexversal_handle_license_action');
 
 /**
- * Render the Appearance > Nexversal PRO Admin Page
+ * ==========================================================================
+ * Virtual ads.txt Manager (Dynamic URL Interception & IAB Spec Compliance)
+ * ==========================================================================
+ */
+
+/**
+ * Sanitize ads.txt content according to IAB Tech Lab Ads.txt Specification
+ *
+ * @param string $raw_content
+ * @return string Cleaned plain-text records
+ */
+function nexversal_sanitize_ads_txt($raw_content) {
+    if (!is_string($raw_content)) {
+        return '';
+    }
+
+    // 1. Strip all HTML, XML, and PHP tags to eliminate XSS/injection risks
+    $content = wp_strip_all_tags($raw_content);
+
+    // 2. Normalize Windows (\r\n) and legacy Mac (\r) line breaks to standard Unix LF (\n)
+    $content = str_replace(array("\r\n", "\r"), "\n", $content);
+    $lines   = explode("\n", $content);
+    $clean_lines = array();
+
+    foreach ($lines as $line) {
+        $trimmed = trim($line);
+
+        // Preserve intentional blank lines for readability/formatting
+        if ($trimmed === '') {
+            $clean_lines[] = '';
+            continue;
+        }
+
+        // Restrict strictly to standard printable ASCII characters (0x20 space through 0x7E tilde)
+        // Strips any hidden control codes, binary artifacts, null bytes, or invalid UTF-8 sequences
+        $sanitized_line = preg_replace('/[^\x20-\x7E]/', '', $trimmed);
+        $clean_lines[]  = $sanitized_line;
+    }
+
+    return implode("\n", $clean_lines);
+}
+
+/**
+ * Register top-priority rewrite rule for virtual /ads.txt request
+ */
+function nexversal_ads_txt_rewrite_rule() {
+    add_rewrite_rule('^ads\.txt$', 'index.php?nexversal_ads_txt=1', 'top');
+}
+add_action('init', 'nexversal_ads_txt_rewrite_rule');
+
+/**
+ * Register query variable for virtual ads.txt handling
+ *
+ * @param array $vars
+ * @return array
+ */
+function nexversal_ads_txt_query_vars($vars) {
+    $vars[] = 'nexversal_ads_txt';
+    return $vars;
+}
+add_filter('query_vars', 'nexversal_ads_txt_query_vars');
+
+/**
+ * Intercept request early to serve virtual ads.txt dynamically without cPanel file writing
+ *
+ * @param WP|null $wp
+ */
+function nexversal_maybe_serve_virtual_ads_txt($wp = null) {
+    $is_ads_txt = false;
+
+    // 1. Check matched WordPress query var
+    if (!empty($wp) && isset($wp->query_vars['nexversal_ads_txt']) && $wp->query_vars['nexversal_ads_txt']) {
+        $is_ads_txt = true;
+    } elseif (get_query_var('nexversal_ads_txt')) {
+        $is_ads_txt = true;
+    }
+
+    // 2. Check matched WordPress request path
+    if (!$is_ads_txt && !empty($wp) && isset($wp->request) && strtolower(trim($wp->request, '/')) === 'ads.txt') {
+        $is_ads_txt = true;
+    }
+
+    // 3. Check raw REQUEST_URI for instant resolution prior to rewrite flushing
+    if (!$is_ads_txt && !empty($_SERVER['REQUEST_URI'])) {
+        $path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
+        if ($path && strtolower(trim($path, '/')) === 'ads.txt') {
+            $is_ads_txt = true;
+        }
+    }
+
+    if ($is_ads_txt) {
+        nexversal_render_virtual_ads_txt_output();
+    }
+}
+add_action('parse_request', 'nexversal_maybe_serve_virtual_ads_txt', 0);
+add_action('template_redirect', 'nexversal_maybe_serve_virtual_ads_txt', 0);
+
+/**
+ * Output virtual ads.txt content with strict HTTP headers and clear all output buffers
+ */
+function nexversal_render_virtual_ads_txt_output() {
+    $content = get_option('nexversal_ads_txt_content', '');
+
+    // Set HTTP 200 OK status
+    status_header(200);
+
+    // Send correct Content-Type: text/plain; charset=utf-8
+    header('Content-Type: text/plain; charset=utf-8');
+    header('X-Content-Type-Options: nosniff');
+    header('X-Robots-Tag: noindex, follow');
+    header('Cache-Control: public, max-age=3600');
+
+    // Discard any active output buffers to ensure zero HTML or whitespace leakage
+    while (ob_get_level() > 0) {
+        ob_end_clean();
+    }
+
+    if (!empty(trim($content))) {
+        echo trim($content) . "\n";
+    } else {
+        // Fallback placeholder comment complying with IAB Tech Lab Ads.txt spec
+        echo "# Nexversal Virtual Ads.txt Manager\n";
+        echo "# Status: Active (Zero records configured)\n";
+        echo "# Configure authorized digital sellers in WordPress Admin > Appearance > Nexversal PRO\n";
+    }
+    exit;
+}
+
+/**
+ * Handle virtual ads.txt form submissions with nonce verification and manage_options permission
+ */
+function nexversal_handle_ads_txt_action() {
+    if (!isset($_POST['nexversal_save_ads_txt'])) {
+        return;
+    }
+
+    if (!isset($_POST['nexversal_ads_txt_nonce']) || !wp_verify_nonce($_POST['nexversal_ads_txt_nonce'], 'nexversal_ads_txt_action')) {
+        wp_die(esc_html__('Security verification failed. Please refresh and try again.', 'nexversal'));
+    }
+
+    if (!current_user_can('manage_options')) {
+        wp_die(esc_html__('Sorry, you do not have permission to manage ads.txt.', 'nexversal'));
+    }
+
+    $raw_content   = isset($_POST['nexversal_ads_txt_content']) ? wp_unslash($_POST['nexversal_ads_txt_content']) : '';
+    $clean_content = nexversal_sanitize_ads_txt($raw_content);
+
+    update_option('nexversal_ads_txt_content', $clean_content);
+
+    // Soft-flush rewrite rules to ensure /ads.txt routing is active
+    flush_rewrite_rules(false);
+
+    wp_safe_redirect(add_query_arg(array('page' => 'nexversal-pro', 'ads_txt_saved' => '1'), admin_url('themes.php')));
+    exit;
+}
+add_action('admin_init', 'nexversal_handle_ads_txt_action');
+
+/**
+ * Record an ad impression or click in lightweight aggregated stats
+ *
+ * @param string $slot
+ * @param string $type 'impression' or 'click'
+ * @param string $country
+ */
+function nexversal_record_ad_event($slot, $type = 'impression', $country = '') {
+    if (empty($slot)) return;
+    if (empty($country)) {
+        $country = nexversal_get_visitor_country();
+    }
+
+    $stats = get_option('nexversal_ad_analytics', array());
+    if (!is_array($stats)) {
+        $stats = array();
+    }
+
+    if (!isset($stats['slots'][$slot])) {
+        $stats['slots'][$slot] = array('impressions' => 0, 'clicks' => 0);
+    }
+
+    if (!isset($stats['countries'][$country])) {
+        $stats['countries'][$country] = array('impressions' => 0, 'clicks' => 0);
+    }
+
+    if (!isset($stats['total'])) {
+        $stats['total'] = array('impressions' => 0, 'clicks' => 0);
+    }
+
+    if ($type === 'click') {
+        $stats['slots'][$slot]['clicks']++;
+        $stats['countries'][$country]['clicks']++;
+        $stats['total']['clicks']++;
+    } else {
+        $stats['slots'][$slot]['impressions']++;
+        $stats['countries'][$country]['impressions']++;
+        $stats['total']['impressions']++;
+    }
+
+    update_option('nexversal_ad_analytics', $stats, false);
+}
+
+/**
+ * Handle AJAX click/impression tracking beacons securely
+ */
+function nexversal_handle_ad_beacon() {
+    $slot    = isset($_POST['slot']) ? sanitize_key($_POST['slot']) : '';
+    $type    = isset($_POST['type']) && $_POST['type'] === 'click' ? 'click' : 'impression';
+    $country = nexversal_get_visitor_country();
+
+    if (!empty($slot)) {
+        nexversal_record_ad_event($slot, $type, $country);
+        wp_send_json_success(array('status' => 'recorded'));
+    }
+    wp_send_json_error(array('status' => 'invalid_slot'));
+}
+add_action('wp_ajax_nexversal_ad_beacon', 'nexversal_handle_ad_beacon');
+add_action('wp_ajax_nopriv_nexversal_ad_beacon', 'nexversal_handle_ad_beacon');
+
+/**
+ * Retrieve list of active ad slots respecting Free vs Pro plan limits.
+ * - Free Plan: Up to 3 active slots maximum.
+ * - Pro Plan: Unlimited active slots.
+ *
+ * @return array Array of slot slugs that are permitted to render
+ */
+function nexversal_get_allowed_ad_slots() {
+    $slots = array('header', 'article', 'post_bottom', 'infeed', 'sidebar');
+    $enabled_slots = array();
+
+    foreach ($slots as $slot) {
+        $slot_on = get_theme_mod("nexversal_ad_{$slot}_enabled", false);
+        $ad_code = get_theme_mod("nexversal_ad_{$slot}_code", '');
+        if ($slot_on && !empty(trim($ad_code))) {
+            $enabled_slots[] = $slot;
+        }
+    }
+
+    // Pro Plan: Unlimited
+    if (nexversal_is_pro_active()) {
+        return $enabled_slots;
+    }
+
+    // Free Plan: Limit to 3 slots
+    return array_slice($enabled_slots, 0, 3);
+}
+
+/**
+ * Count how many slots are currently configured and enabled
+ *
+ * @return int
+ */
+function nexversal_count_active_ad_slots() {
+    $slots = array('header', 'article', 'post_bottom', 'infeed', 'sidebar');
+    $count = 0;
+    foreach ($slots as $slot) {
+        $slot_on = get_theme_mod("nexversal_ad_{$slot}_enabled", false);
+        $ad_code = get_theme_mod("nexversal_ad_{$slot}_code", '');
+        if ($slot_on && !empty(trim($ad_code))) {
+            $count++;
+        }
+    }
+    return $count;
+}
+
+/**
+ * Global Page Ad Execution Counter & Free Plan Limit Enforcer
+ *
+ * Implements a strict, immutable ceiling of exactly 3 ads per page for the Free version.
+ * - Free Version: Maximum 3 ads rendered per page across all sources:
+ *   structural slots, in-article injector, and shortcodes.
+ * - PRO Version: Unlimited ad impressions per page.
+ *
+ * @return int Number of ads rendered on the current request
+ */
+function nexversal_get_page_ad_count() {
+    if (!isset($GLOBALS['nexversal_page_ad_count'])) {
+        $GLOBALS['nexversal_page_ad_count'] = 0;
+    }
+    return (int) $GLOBALS['nexversal_page_ad_count'];
+}
+
+/**
+ * Determine if another ad is allowed to render on the current page
+ *
+ * @return bool True if ad is permitted to render, false if Free limit is reached.
+ */
+function nexversal_can_render_ad() {
+    // PRO plan allows unlimited ads
+    if (nexversal_is_pro_active()) {
+        return true;
+    }
+    // Free plan strictly allows up to 3 ads per page
+    return nexversal_get_page_ad_count() < 3;
+}
+
+/**
+ * Increment the global page ad execution tracker
+ *
+ * @return int Updated ad count
+ */
+function nexversal_increment_page_ad_count() {
+    if (!isset($GLOBALS['nexversal_page_ad_count'])) {
+        $GLOBALS['nexversal_page_ad_count'] = 0;
+    }
+    $GLOBALS['nexversal_page_ad_count']++;
+    return $GLOBALS['nexversal_page_ad_count'];
+}
+
+/**
+ * Reset the global page ad execution tracker (useful for testing and sub-requests)
+ */
+function nexversal_reset_page_ad_count() {
+    $GLOBALS['nexversal_page_ad_count'] = 0;
+}
+
+/**
+ * Determine whether the current visitor is an authenticated administrator or editor
+ * who must be shielded from live Google AdSense ads to prevent invalid clicks and account suspensions.
+ *
+ * @return bool True if current visitor is an admin or editor, false otherwise.
+ */
+function nexversal_is_ad_shielded_user() {
+    if (!function_exists('is_user_logged_in') || !is_user_logged_in()) {
+        return false;
+    }
+
+    // Strict validation checks for Administrator or Editor roles / capabilities
+    $is_shielded = (
+        current_user_can('administrator') ||
+        current_user_can('manage_options') ||
+        current_user_can('editor') ||
+        current_user_can('edit_others_posts')
+    );
+
+    /**
+     * Filter whether the current user should be shielded from live AdSense ads.
+     *
+     * @param bool $is_shielded
+     */
+    return (bool) apply_filters('nexversal_is_ad_shielded_user', $is_shielded);
+}
+
+/**
+ * Production-grade WordPress PHP wrapper function to conditionalize Google AdSense code output within theme templates.
+ *
+ * Implements strict user validation checks using current_user_can('administrator') and editor checks.
+ * - Authenticated administrators & editors: Intercepts real AdSense publisher scripts and replaces
+ *   them entirely with a safe local HTML placeholder block containing developer diagnostics,
+ *   or maps them to Google's official demo test ad parameters (data-ad-test="on").
+ * - Standard web visitors: Outputs genuine production ad code completely unmodified.
+ *
+ * @param string $raw_ad_code Raw ad snippet or AdSense script/ins tags.
+ * @param string $slot        Optional slot slug (e.g. 'header', 'article', 'post_bottom', 'infeed', 'sidebar').
+ * @param string $slot_name   Optional human-readable slot name (e.g. 'Header Leaderboard').
+ * @param string $mode        Optional mode override: 'placeholder' (default) or 'test_ad'.
+ * @return string Genuine production ad code for visitors, or safe developer diagnostic block for admin/editor.
+ */
+function nexversal_wrap_adsense_code($raw_ad_code, $slot = '', $slot_name = '', $mode = '') {
+    if (empty(trim($raw_ad_code))) {
+        return '';
+    }
+
+    // 1. Strict user validation: Standard visitors always get genuine unmodified production ad code
+    if (!nexversal_is_ad_shielded_user()) {
+        return $raw_ad_code;
+    }
+
+    // 2. Resolve shielding mode ('placeholder' by default, or 'test_ad')
+    if (empty($mode)) {
+        /**
+         * Filter to toggle between safe local HTML placeholder block or Google official demo test ads.
+         *
+         * @param string $mode 'placeholder' (default) or 'test_ad'
+         * @param string $slot Ad slot slug
+         */
+        $mode = (string) apply_filters('nexversal_adsense_shield_mode', 'placeholder', $slot);
+    }
+
+    // 3. Option B: Map to Google's Official Demo Test Ad Slot Parameters (data-ad-test="on")
+    if ($mode === 'test_ad') {
+        if (stripos($raw_ad_code, 'adsbygoogle') !== false) {
+            if (stripos($raw_ad_code, 'data-ad-test') === false) {
+                $test_code = preg_replace('/<ins\b([^>]*)>/i', '<ins$1 data-ad-test="on">', $raw_ad_code);
+                if (!empty($test_code)) {
+                    return "<!-- [AdSense Shield] Google Official Demo Test Ad Active (data-ad-test=\"on\") -->\n" . $test_code;
+                }
+            }
+        }
+        return $raw_ad_code;
+    }
+
+    // 4. Option A (Default): Safe Local HTML Placeholder Block with Developer Diagnostics
+    // Extract metadata from the raw ad code for diagnostics
+    $detected_pub = '';
+    if (preg_match('/(?:client|data-ad-client)=["\'](ca-pub-[0-9]+|pub-[0-9]+)["\']/i', $raw_ad_code, $m)) {
+        $detected_pub = $m[1];
+    } elseif (preg_match('/ca-pub-[0-9]+/i', $raw_ad_code, $m)) {
+        $detected_pub = $m[0];
+    }
+
+    $detected_slot_id = '';
+    if (preg_match('/data-ad-slot=["\']([0-9]+)["\']/i', $raw_ad_code, $m)) {
+        $detected_slot_id = $m[1];
+    }
+
+    // Resolve human-friendly slot label
+    if (empty($slot_name)) {
+        if (!empty($slot) && function_exists('nexversal_get_ad_slot_specs')) {
+            $specs = nexversal_get_ad_slot_specs($slot);
+            $slot_name = !empty($specs['name']) ? $specs['name'] : ucfirst(str_replace('_', ' ', $slot));
+        } else {
+            $slot_name = !empty($slot) ? ucfirst(str_replace('_', ' ', $slot)) : __('Ad Placement', 'nexversal');
+        }
+    }
+
+    // Identify user role for diagnostic display
+    $current_user = wp_get_current_user();
+    $roles_list   = !empty($current_user->roles) ? implode(', ', array_map('ucfirst', $current_user->roles)) : 'Administrator';
+
+    ob_start();
+    ?>
+    <div class="nx-ad-admin-shield" data-shield-slot="<?php echo esc_attr($slot); ?>" role="region" aria-label="<?php echo esc_attr(sprintf(__('Ad Slot: %s - Hidden for Admin', 'nexversal'), $slot_name)); ?>">
+        <div class="nx-shield-inner">
+            <div class="nx-shield-header">
+                <div class="nx-shield-title">
+                    <svg class="nx-shield-icon" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                        <path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/>
+                        <path d="m9 12 2 2 4-4"/>
+                    </svg>
+                    <span><strong>Ad Slot Active:</strong> <?php echo esc_html($slot_name); ?></span>
+                </div>
+                <span class="nx-shield-badge"><?php esc_html_e('ADMIN SHIELD ACTIVE', 'nexversal'); ?></span>
+            </div>
+            <p class="nx-shield-desc">
+                <?php esc_html_e('Hidden for Admin to Prevent Invalid Clicks & AdSense Policy Violations. Standard visitors receive genuine production ads.', 'nexversal'); ?>
+            </p>
+            <div class="nx-shield-meta">
+                <span class="nx-shield-chip"><strong>Role:</strong> <?php echo esc_html($roles_list); ?></span>
+                <?php if (!empty($detected_pub)) : ?>
+                    <span class="nx-shield-chip"><strong>Client:</strong> <?php echo esc_html($detected_pub); ?></span>
+                <?php endif; ?>
+                <?php if (!empty($detected_slot_id)) : ?>
+                    <span class="nx-shield-chip"><strong>Slot ID:</strong> <?php echo esc_html($detected_slot_id); ?></span>
+                <?php endif; ?>
+                <span class="nx-shield-chip nx-shield-chip-status">&#10003; 0 External Ad Requests</span>
+            </div>
+        </div>
+    </div>
+    <?php
+    return trim(ob_get_clean());
+}
+
+/**
+ * Output Google AdSense Auto-Ads script in head if Publisher ID is entered
+ * Intercepted strictly with type="text/plain" until GDPR cookie consent is verified.
+ * Suppressed completely for authenticated administrators and editors to prevent invalid traffic.
+ */
+function nexversal_render_adsense_auto_script() {
+    $pub_id = get_theme_mod('nexversal_adsense_pub_id', '');
+    if (!empty($pub_id)) {
+        // Suppress Auto-Ads if current singular post has disabled ads via Monetization Controls
+        if (is_singular() && function_exists('nexversal_is_ad_disabled_for_post') && nexversal_is_ad_disabled_for_post()) {
+            echo "<!-- [AdSense Shield] Auto Ads script suppressed for post #" . esc_attr(get_the_ID()) . " via Monetization Controls -->\n";
+            return;
+        }
+
+        // Prevent Auto-Ads execution for logged-in Administrator/Editor
+        if (function_exists('nexversal_is_ad_shielded_user') && nexversal_is_ad_shielded_user()) {
+            echo "<!-- [AdSense Shield] Auto Ads script suppressed for logged-in Administrator/Editor to prevent invalid clicks and policy violations -->\n";
+            return;
+        }
+
+        $pub_id = trim($pub_id);
+        // Guarantee ca-pub- prefix
+        if (strpos($pub_id, 'ca-pub-') === false && strpos($pub_id, 'pub-') === 0) {
+            $pub_id = 'ca-' . $pub_id;
+        } elseif (strpos($pub_id, 'ca-pub-') === false) {
+            $pub_id = 'ca-pub-' . $pub_id;
+        }
+
+        $script_src = 'https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=' . esc_attr($pub_id);
+
+        // Strict Free Plan Limit: Instruct Google crawler to cap Auto Ads to max 3 on Free version
+        $is_pro       = nexversal_is_pro_active();
+        $max_ads_attr = !$is_pro ? ' data-max-ads-per-page="3"' : '';
+
+        if (function_exists('nexversal_has_cookie_consent') && !nexversal_has_cookie_consent()) {
+            ?>
+            <!-- Google AdSense 1-Click Auto Ads (GDPR Intercepted: Inert Until Consent Granted<?php echo !$is_pro ? ' | Free Plan Max 3 Ads' : ''; ?>) -->
+            <script type="text/plain" data-nx-consent="adsense" data-src="<?php echo esc_url($script_src); ?>"<?php echo $max_ads_attr; ?> async crossorigin="anonymous"></script>
+            <?php
+        } else {
+            ?>
+            <!-- Google AdSense 1-Click Auto Ads (Active<?php echo !$is_pro ? ' | Free Plan Max 3 Ads' : ''; ?>) -->
+            <script async src="<?php echo esc_url($script_src); ?>"<?php echo $max_ads_attr; ?> crossorigin="anonymous"></script>
+            <?php
+        }
+    }
+}
+add_action('wp_head', 'nexversal_render_adsense_auto_script', 5);
+
+/**
+ * Render the Appearance > Nexversal PRO Admin Page (v3.5.0)
  */
 function nexversal_pro_admin_page() {
@@ -188 +744 @@
     $plan_name    = get_option('nexversal_pro_license_plan', 'Nexversal PRO ($15/year)');
     $activated_at = get_option('nexversal_pro_license_activated_at', '');
+    $stats        = get_option('nexversal_ad_analytics', array());
+
+    $total_imp    = isset($stats['total']['impressions']) ? (int) $stats['total']['impressions'] : 0;
+    $total_clicks = isset($stats['total']['clicks']) ? (int) $stats['total']['clicks'] : 0;
+    $total_ctr    = $total_imp > 0 ? round(($total_clicks / $total_imp) * 100, 2) : 0;
+    $active_slots = nexversal_count_active_ad_slots();
     ?>
-    <div class="wrap" style="max-width: 900px; margin: 30px auto; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;">
+    <div class="wrap" style="max-width: 1050px; margin: 25px auto; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;">
         
         <?php if (isset($_GET['activated'])) : ?>
             <div class="notice notice-success is-dismissible" style="padding: 14px 18px; border-radius: 6px; border-left-color: #10b981;">
-                <p style="font-size: 14px; margin: 0;"><strong>🎉 <?php esc_html_e('Nexversal PRO Activated Successfully! All 5 Ad Slots & Monetization features are now unlocked.', 'nexversal'); ?></strong></p>
+                <p style="font-size: 14px; margin: 0;"><strong>🎉 <?php esc_html_e('Nexversal PRO Activated Successfully! Unlimited ad slots, Ad-Blocker Bypass, and real-time Analytics are now unlocked.', 'nexversal'); ?></strong></p>
             </div>
         <?php elseif (isset($_GET['error']) && $_GET['error'] === 'invalid_key') : ?>
             <div class="notice notice-error is-dismissible" style="padding: 14px 18px; border-radius: 6px;">
-                <p style="font-size: 14px; margin: 0;"><strong>❌ <?php esc_html_e('Invalid License Key. Please enter the valid key received from Lemon Squeezy after purchasing the $15/year plan.', 'nexversal'); ?></strong></p>
+                <p style="font-size: 14px; margin: 0;"><strong>❌ <?php esc_html_e('Invalid License Key. Please enter the valid key received from Lemon Squeezy ($15/year).', 'nexversal'); ?></strong></p>
             </div>
         <?php elseif (isset($_GET['deactivated'])) : ?>
             <div class="notice notice-info is-dismissible" style="padding: 14px 18px; border-radius: 6px;">
-                <p style="font-size: 14px; margin: 0;"><?php esc_html_e('Nexversal PRO License has been deactivated.', 'nexversal'); ?></p>
+                <p style="font-size: 14px; margin: 0;"><?php esc_html_e('Nexversal PRO License has been deactivated. Free Ad Engine (up to 3 ads) remains active.', 'nexversal'); ?></p>
             </div>
         <?php elseif (isset($_GET['url_saved'])) : ?>
             <div class="notice notice-success is-dismissible" style="padding: 14px 18px; border-radius: 6px; border-left-color: #10b981;">
-                <p style="font-size: 14px; margin: 0;"><strong>✓ <?php esc_html_e('Lemon Squeezy Checkout URL updated successfully! All buttons now link to your live checkout.', 'nexversal'); ?></strong></p>
+                <p style="font-size: 14px; margin: 0;"><strong>✓ <?php esc_html_e('Lemon Squeezy Checkout URL updated successfully!', 'nexversal'); ?></strong></p>
+            </div>
+        <?php elseif (isset($_GET['stats_reset'])) : ?>
+            <div class="notice notice-success is-dismissible" style="padding: 14px 18px; border-radius: 6px; border-left-color: #10b981;">
+                <p style="font-size: 14px; margin: 0;"><?php esc_html_e('Ad Analytics statistics have been reset.', 'nexversal'); ?></p>
+            </div>
+        <?php elseif (isset($_GET['ads_txt_saved'])) : ?>
+            <div class="notice notice-success is-dismissible" style="padding: 14px 18px; border-radius: 6px; border-left-color: #10b981;">
+                <p style="font-size: 14px; margin: 0;"><strong>✓ <?php esc_html_e('ads.txt updated successfully! Served dynamically at /ads.txt without cPanel file editing.', 'nexversal'); ?></strong></p>
             </div>
         <?php endif; ?>
 
         <!-- Brand Header Card -->
-        <div style="background: linear-gradient(135deg, #1e1b4b 0%, #0f172a 100%); color: #fff; padding: 36px 40px; border-radius: 12px; box-shadow: 0 10px 25px rgba(0,0,0,0.15); margin-bottom: 28px;">
+        <div style="background: linear-gradient(135deg, #090d16 0%, #1e1b4b 60%, #312e81 100%); color: #fff; padding: 36px 40px; border-radius: 14px; box-shadow: 0 10px 30px rgba(0,0,0,0.25); margin-bottom: 28px;">
             <div style="display: flex; justify-content: space-between; align-items: center; flex-wrap: wrap; gap: 16px;">
                 <div>
-                    <span style="display: inline-block; background: rgba(99, 102, 241, 0.3); border: 1px solid rgba(165, 180, 252, 0.4); color: #c7d2fe; font-size: 11px; font-weight: 800; letter-spacing: 0.1em; text-transform: uppercase; padding: 4px 12px; border-radius: 999px; margin-bottom: 12px;">
-                        Lemon Squeezy Verified • $15 / Year
+                    <span style="display: inline-block; background: rgba(99, 102, 241, 0.35); border: 1px solid rgba(165, 180, 252, 0.4); color: #c7d2fe; font-size: 11px; font-weight: 800; letter-spacing: 0.1em; text-transform: uppercase; padding: 4px 12px; border-radius: 999px; margin-bottom: 12px;">
+                        Version 3.5.0 • Monetization Engine
                     </span>
                     <h1 style="font-size: 28px; font-weight: 900; margin: 0 0 8px 0; color: #fff; letter-spacing: -0.02em;">
-                        Nexversal PRO — Ad & Monetization Engine
+                        Nexversal Monetization & Ad Suite
                     </h1>
-                    <p style="font-size: 15px; color: #cbd5e1; margin: 0; line-height: 1.6; max-width: 580px;">
-                        Built-in AdSense, In-Article & Sticky Sidebar Ad Engine. Save $50/year on external ad plugins while maximizing organic blog earnings.
+                    <p style="font-size: 14.5px; color: #cbd5e1; margin: 0; line-height: 1.6; max-width: 620px;">
+                        Free Plan allows <strong>up to 3 simultaneous ads</strong> with automatic location detection. PRO Plan ($15/yr) unlocks <strong>unlimited simultaneous ads</strong>, Ad-Blocker Bypass, and CTR analytics.
                     </p>
                 </div>
                 <div style="text-align: right;">
                     <?php if ($is_active) : ?>
-                        <div style="background: #10b981; color: #fff; font-size: 14px; font-weight: 800; padding: 8px 18px; border-radius: 999px; display: inline-flex; align-items: center; gap: 6px; box-shadow: 0 4px 12px rgba(16,185,129,0.35);">
-                            <span>✓</span> <?php esc_html_e('PRO Plan Active', 'nexversal'); ?>
+                        <div style="background: #10b981; color: #fff; font-size: 14px; font-weight: 800; padding: 8px 18px; border-radius: 999px; display: inline-flex; align-items: center; gap: 6px; box-shadow: 0 4px 14px rgba(16,185,129,0.4);">
+                            <span>✓</span> <?php esc_html_e('PRO Plan Active (Unlimited Ads)', 'nexversal'); ?>
                         </div>
                     <?php else : ?>
-                        <div style="background: #ef4444; color: #fff; font-size: 13px; font-weight: 800; padding: 6px 14px; border-radius: 999px; display: inline-flex; align-items: center; gap: 6px;">
-                            <span>🔒</span> <?php esc_html_e('PRO Locked (Free Plan)', 'nexversal'); ?>
+                        <div style="background: rgba(255, 255, 255, 0.12); color: #cbd5e1; font-size: 13px; font-weight: 700; padding: 6px 14px; border-radius: 999px; display: inline-flex; align-items: center; gap: 6px; border: 1px solid rgba(255,255,255,0.2);">
+                            <span>⚡</span> <?php printf(esc_html__('Free Plan: %d of 3 Slots Active', 'nexversal'), esc_html($active_slots)); ?>
                         </div>
                     <?php endif; ?>
@@ -237 +807 @@
         </div>
 
+        <!-- 3-Column Plan Breakdown -->
+        <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 20px; margin-bottom: 28px;">
+            <div style="background: #fff; border: 1px solid #e2e8f0; border-radius: 12px; padding: 22px; box-shadow: 0 2px 6px rgba(0,0,0,0.03);">
+                <span style="font-size: 11px; font-weight: 800; color: #10b981; background: #ecfdf5; padding: 3px 8px; border-radius: 6px; text-transform: uppercase;">Free Plan (Lifetime)</span>
+                <h3 style="font-size: 17px; font-weight: 800; margin: 10px 0 6px 0; color: #0f172a;">Run 3 Active Ads</h3>
+                <p style="font-size: 13px; color: #64748b; line-height: 1.5; margin: 0;">Run any 3 ads of your choice (Header, In-Article, Bottom, Sidebar, or Grid). Includes 1-click Google Auto Ads and automatic country detection.</p>
+            </div>
+            <div style="background: #fff; border: 1px solid #e2e8f0; border-radius: 12px; padding: 22px; box-shadow: 0 2px 6px rgba(0,0,0,0.03);">
+                <span style="font-size: 11px; font-weight: 800; color: #8b5cf6; background: #f3e8ff; padding: 3px 8px; border-radius: 6px; text-transform: uppercase;">PRO Feature</span>
+                <h3 style="font-size: 17px; font-weight: 800; margin: 10px 0 6px 0; color: #0f172a;">Ad-Blocker Bypass</h3>
+                <p style="font-size: 13px; color: #64748b; line-height: 1.5; margin: 0;">Detects active ad blockers and replaces blank space with custom affiliate banners or sponsor notices that ad blockers cannot touch.</p>
+            </div>
+            <div style="background: #fff; border: 1px solid #e2e8f0; border-radius: 12px; padding: 22px; box-shadow: 0 2px 6px rgba(0,0,0,0.03);">
+                <span style="font-size: 11px; font-weight: 800; color: #4f46e5; background: #eef2ff; padding: 3px 8px; border-radius: 6px; text-transform: uppercase;">PRO Feature</span>
+                <h3 style="font-size: 17px; font-weight: 800; margin: 10px 0 6px 0; color: #0f172a;">Unlimited Ads & Analytics</h3>
+                <p style="font-size: 13px; color: #64748b; line-height: 1.5; margin: 0;">Run 4, 5 or all slots at the same time without limits. Track real-time impressions, clicks, and CTR % to maximize blog revenue.</p>
+            </div>
+        </div>
+
+        <!-- Real-Time Monetization Analytics Dashboard -->
+        <div style="background: #fff; border: 1px solid #e2e8f0; border-radius: 12px; padding: 28px; box-shadow: 0 4px 6px -1px rgba(0,0,0,0.05); margin-bottom: 28px;">
+            <div style="display: flex; justify-content: space-between; align-items: center; flex-wrap: wrap; gap: 12px; margin-bottom: 20px;">
+                <div>
+                    <h3 style="font-size: 18px; font-weight: 800; margin: 0 0 4px 0; color: #0f172a;">
+                        📊 <?php esc_html_e('Ad Performance & CTR Analytics', 'nexversal'); ?>
+                        <?php if (!$is_active) : ?>
+                            <span style="font-size: 11px; font-weight: 800; color: #6366f1; background: #eef2ff; padding: 2px 8px; border-radius: 4px; vertical-align: middle; margin-left: 6px;">PRO Preview</span>
+                        <?php endif; ?>
+                    </h3>
+                    <p style="font-size: 13px; color: #64748b; margin: 0;">
+                        <?php esc_html_e('Real-time tracking of impressions, clicks, click-through rates (CTR), and visitor countries.', 'nexversal'); ?>
+                    </p>
+                </div>
+                <div>
+                    <form method="post" action="" style="display: inline-block;">
+                        <?php wp_nonce_field('nexversal_license_action', 'nexversal_license_nonce'); ?>
+                        <input type="submit" name="nexversal_reset_ad_stats" class="button" value="<?php esc_attr_e('Reset Stats', 'nexversal'); ?>" onclick="return confirm('<?php echo esc_js(__('Are you sure you want to reset all ad statistics?', 'nexversal')); ?>');" style="font-size: 12px;">
+                    </form>
+                    <a href="<?php echo esc_url(admin_url('customize.php?autofocus[section]=nexversal_monetization')); ?>" class="button button-primary" style="background: #4f46e5; border-color: #4f46e5; font-size: 12px; padding: 0 14px; height: 30px; line-height: 28px; margin-left: 6px;">
+                        <?php esc_html_e('Configure Ads in Customizer ➔', 'nexversal'); ?>
+                    </a>
+                </div>
+            </div>
+
+            <!-- Stats KPI Cards -->
+            <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 16px; margin-bottom: 24px;">
+                <div style="background: #f8fafc; border: 1px solid #e2e8f0; border-radius: 10px; padding: 18px;">
+                    <div style="font-size: 12px; font-weight: 700; color: #64748b; text-transform: uppercase;"><?php esc_html_e('Total Impressions', 'nexversal'); ?></div>
+                    <div style="font-size: 26px; font-weight: 900; color: #0f172a; margin-top: 4px;"><?php echo number_format_i18n($total_imp); ?></div>
+                </div>
+                <div style="background: #f8fafc; border: 1px solid #e2e8f0; border-radius: 10px; padding: 18px;">
+                    <div style="font-size: 12px; font-weight: 700; color: #64748b; text-transform: uppercase;"><?php esc_html_e('Total Clicks', 'nexversal'); ?></div>
+                    <div style="font-size: 26px; font-weight: 900; color: #4f46e5; margin-top: 4px;"><?php echo number_format_i18n($total_clicks); ?></div>
+                </div>
+                <div style="background: #f8fafc; border: 1px solid #e2e8f0; border-radius: 10px; padding: 18px;">
+                    <div style="font-size: 12px; font-weight: 700; color: #64748b; text-transform: uppercase;"><?php esc_html_e('Avg. Click-Through Rate (CTR)', 'nexversal'); ?></div>
+                    <div style="font-size: 26px; font-weight: 900; color: #10b981; margin-top: 4px;"><?php echo esc_html($total_ctr); ?>%</div>
+                </div>
+            </div>
+
+            <!-- Slot Breakdown Table -->
+            <table class="widefat striped" style="border: 1px solid #e2e8f0; border-radius: 8px; overflow: hidden;">
+                <thead>
+                    <tr>
+                        <th style="padding: 10px 14px; font-weight: 700;"><?php esc_html_e('Ad Slot', 'nexversal'); ?></th>
+                        <th style="padding: 10px 14px; font-weight: 700;"><?php esc_html_e('Impressions', 'nexversal'); ?></th>
+                        <th style="padding: 10px 14px; font-weight: 700;"><?php esc_html_e('Clicks', 'nexversal'); ?></th>
+                        <th style="padding: 10px 14px; font-weight: 700;"><?php esc_html_e('CTR %', 'nexversal'); ?></th>
+                    </tr>
+                </thead>
+                <tbody>
+                    <?php
+                    $slots = array(
+                        'header'      => __('Header Banner (728x90)', 'nexversal'),
+                        'article'     => __('In-Article Mid-Content', 'nexversal'),
+                        'post_bottom' => __('Below Post Content', 'nexversal'),
+                        'infeed'      => __('Homepage In-Feed Grid', 'nexversal'),
+                        'sidebar'     => __('Sticky Sidebar', 'nexversal'),
+                    );
+                    foreach ($slots as $s_key => $s_name) :
+                        $s_imp    = isset($stats['slots'][$s_key]['impressions']) ? (int) $stats['slots'][$s_key]['impressions'] : 0;
+                        $s_clicks = isset($stats['slots'][$s_key]['clicks']) ? (int) $stats['slots'][$s_key]['clicks'] : 0;
+                        $s_ctr    = $s_imp > 0 ? round(($s_clicks / $s_imp) * 100, 2) : 0;
+                        ?>
+                        <tr>
+                            <td style="padding: 10px 14px; font-weight: 600; color: #1e293b;"><?php echo esc_html($s_name); ?></td>
+                            <td style="padding: 10px 14px;"><?php echo number_format_i18n($s_imp); ?></td>
+                            <td style="padding: 10px 14px;"><?php echo number_format_i18n($s_clicks); ?></td>
+                            <td style="padding: 10px 14px;"><span style="background: #eef2ff; color: #4f46e5; font-weight: 700; padding: 2px 6px; border-radius: 4px;"><?php echo esc_html($s_ctr); ?>%</span></td>
+                        </tr>
+                    <?php endforeach; ?>
+                </tbody>
+            </table>
+        </div>
+
+        <!-- License Management & Upsell Box -->
         <div style="display: grid; grid-template-columns: 1.25fr 1fr; gap: 24px; align-items: start;">
             
@@ -242 +908 @@
             <div style="background: #fff; border: 1px solid #e2e8f0; border-radius: 12px; padding: 30px; box-shadow: 0 4px 6px -1px rgba(0,0,0,0.05);">
                 <h3 style="font-size: 18px; font-weight: 800; margin-top: 0; margin-bottom: 14px; color: #0f172a;">
-                    <?php esc_html_e('License Key Activation', 'nexversal'); ?>
+                    <?php esc_html_e('PRO License Activation', 'nexversal'); ?>
                 </h3>
 
@@ -264 +930 @@
                         <input type="submit" name="nexversal_deactivate_license" class="button" value="<?php esc_attr_e('Deactivate License', 'nexversal'); ?>" onclick="return confirm('<?php echo esc_js(__('Are you sure you want to deactivate your PRO license?', 'nexversal')); ?>');" style="color: #b91c1c; border-color: #fca5a5;">
                         <a href="<?php echo esc_url(admin_url('customize.php?autofocus[section]=nexversal_monetization')); ?>" class="button button-primary" style="margin-left: 10px; background: #4f46e5; border-color: #4f46e5; height: auto; padding: 4px 14px;">
-                            <?php esc_html_e('Manage Ad Slots in Customizer ➔', 'nexversal'); ?>
+                            <?php esc_html_e('Configure Ads in Customizer ➔', 'nexversal'); ?>
                         </a>
                     </form>
@@ -270 +936 @@
                 <?php else : ?>
                     <p style="font-size: 14px; color: #64748b; line-height: 1.6; margin-bottom: 20px;">
-                        <?php esc_html_e('Purchase your license via Lemon Squeezy ($15/year) to automatically receive your instant license key.', 'nexversal'); ?>
+                        <?php esc_html_e('Upgrade to PRO ($15/year) to unlock unlimited simultaneous ads, Ad-Blocker Bypass, and real-time analytics.', 'nexversal'); ?>
                     </p>
 
@@ -303 +969 @@
                 </h4>
                 <ul style="margin: 0 0 20px 0; padding-left: 0; list-style: none; font-size: 13.5px; color: #334155; line-height: 1.85;">
-                    <li>✓ <strong>Auto In-Article AdSense:</strong> Automatically inserts after paragraph 3</li>
-                    <li>✓ <strong>Sticky Sidebar Ad (300×600):</strong> Floating ad as user scrolls down</li>
-                    <li>✓ <strong>In-Feed Post Grid Ad:</strong> Blends natively into your articles grid</li>
-                    <li>✓ <strong>Header 728×90 Leaderboard:</strong> High-impact top banner visibility</li>
-                    <li>✓ <strong>Post Bottom Banner:</strong> Captures readers right when finishing reading</li>
+                    <li>✓ <strong>Unlimited Active Ads:</strong> Run all 5 ad placements at the same time</li>
+                    <li>✓ <strong>Ad-Blocker Bypass:</strong> Forces fallback banners when AdSense is blocked</li>
+                    <li>✓ <strong>Automatic Geo-Targeting:</strong> Visitors see ads based on real-time location</li>
+                    <li>✓ <strong>CTR Analytics:</strong> Live impressions, clicks & conversion tracking</li>
                     <li>✓ <strong>Google Policy Compliant:</strong> Auto "Advertisement" label</li>
                     <li>✓ <strong>Save $50/Year:</strong> Zero external ad plugins required</li>
@@ -335 +1000 @@
             </form>
         </div>
+
+        <!-- Automated Virtual ads.txt Manager -->
+        <div style="margin-top: 28px; background: #fff; border: 1px solid #e2e8f0; border-radius: 12px; padding: 26px; box-shadow: 0 4px 6px -1px rgba(0,0,0,0.05);">
+            <div style="display: flex; justify-content: space-between; align-items: flex-start; flex-wrap: wrap; gap: 12px; margin-bottom: 12px;">
+                <div>
+                    <h3 style="margin: 0 0 6px 0; font-size: 17px; font-weight: 800; color: #0f172a; display: flex; align-items: center; gap: 8px;">
+                        <span>📄</span> <?php esc_html_e('Automated Ads.txt Manager', 'nexversal'); ?>
+                        <span style="font-size: 11px; font-weight: 700; background: #ecfdf5; color: #059669; border: 1px solid #a7f3d0; padding: 3px 8px; border-radius: 20px;">
+                            <?php esc_html_e('Virtual Engine Active', 'nexversal'); ?>
+                        </span>
+                    </h3>
+                    <p style="font-size: 13.5px; color: #64748b; margin: 0; line-height: 1.5;">
+                        <?php esc_html_e('Declare your authorized digital ad sellers (Google AdSense, AdX, Magnite, PubMatic). Served dynamically at your domain root with proper text/plain headers — zero cPanel file creation needed!', 'nexversal'); ?>
+                    </p>
+                </div>
+                <div>
+                    <a href="<?php echo esc_url(home_url('/ads.txt')); ?>" target="_blank" rel="noopener noreferrer" class="button" style="display: inline-flex; align-items: center; gap: 6px; font-size: 12px; font-weight: 600;">
+                        <span>🔗</span> <?php esc_html_e('View Live ads.txt', 'nexversal'); ?> ↗
+                    </a>
+                </div>
+            </div>
+
+            <?php
+            $has_physical_file = file_exists(ABSPATH . 'ads.txt');
+            if ($has_physical_file) :
+            ?>
+                <div style="background: #fffbeb; border: 1px solid #fde68a; border-radius: 8px; padding: 12px 16px; margin-bottom: 18px; font-size: 13px; color: #92400e; display: flex; align-items: center; gap: 10px;">
+                    <span style="font-size: 18px;">⚠️</span>
+                    <div>
+                        <strong><?php esc_html_e('Physical ads.txt file detected on your server root (cPanel/public_html):', 'nexversal'); ?></strong><br>
+                        <?php esc_html_e('In Apache/cPanel, a physical file on disk takes priority over virtual dynamic URLs. If you want this dashboard to manage your ads.txt dynamically, please delete or rename the physical ads.txt file in cPanel File Manager.', 'nexversal'); ?>
+                    </div>
+                </div>
+            <?php else : ?>
+                <div style="background: #f0fdf4; border: 1px solid #bbf7d0; border-radius: 8px; padding: 10px 14px; margin-bottom: 18px; font-size: 12.5px; color: #166534; display: flex; align-items: center; gap: 8px;">
+                    <span>✓</span>
+                    <span><strong><?php esc_html_e('Zero cPanel File Editing:', 'nexversal'); ?></strong> <?php esc_html_e('No physical file exists on disk. Requests to /ads.txt are intercepted dynamically by the theme and served from your database with optimal caching and 200 OK headers.', 'nexversal'); ?></span>
+                </div>
+            <?php endif; ?>
+
+            <form method="post" action="">
+                <?php wp_nonce_field('nexversal_ads_txt_action', 'nexversal_ads_txt_nonce'); ?>
+                
+                <div style="margin-bottom: 14px;">
+                    <div style="display: flex; justify-content: space-between; align-items: center; margin-bottom: 8px; flex-wrap: wrap; gap: 8px;">
+                        <label for="nexversal_ads_txt_content" style="font-size: 13px; font-weight: 700; color: #334155;">
+                            <?php esc_html_e('ads.txt Records (IAB Tech Lab Format):', 'nexversal'); ?>
+                        </label>
+                        <button type="button" id="nx-insert-adsense-btn" class="button button-small" style="font-size: 11px;">
+                            + <?php esc_html_e('Insert Google AdSense Template', 'nexversal'); ?>
+                        </button>
+                    </div>
+
+                    <textarea id="nexversal_ads_txt_content" name="nexversal_ads_txt_content" rows="10" spellcheck="false" placeholder="# Example:&#10;google.com, pub-XXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0" style="width: 100%; font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; font-size: 13px; line-height: 1.6; background: #0f172a; color: #38bdf8; border: 1px solid #1e293b; border-radius: 8px; padding: 14px; box-sizing: border-box;"><?php echo esc_textarea(get_option('nexversal_ads_txt_content', '')); ?></textarea>
+                    
+                    <p style="font-size: 12px; color: #64748b; margin: 6px 0 0 0;">
+                        <?php esc_html_e('Format: <Domain>, <Publisher ID>, <Relationship (DIRECT|RESELLER)>, <Certification Authority ID (Optional)>. Comments start with #.', 'nexversal'); ?>
+                    </p>
+                </div>
+
+                <div style="display: flex; justify-content: space-between; align-items: center; flex-wrap: wrap; gap: 10px;">
+                    <input type="submit" name="nexversal_save_ads_txt" class="button button-primary" value="<?php esc_attr_e('Save & Deploy ads.txt', 'nexversal'); ?>" style="background: #4f46e5; border-color: #4f46e5; font-weight: 700; padding: 7px 22px; height: auto;">
+                    <span style="font-size: 12px; color: #94a3b8;">
+                        <?php
+                        $saved_ads  = get_option('nexversal_ads_txt_content', '');
+                        $line_count = !empty(trim($saved_ads)) ? count(array_filter(explode("\n", trim($saved_ads)))) : 0;
+                        printf(esc_html__('Currently deployed: %d active line(s)', 'nexversal'), $line_count);
+                        ?>
+                    </span>
+                </div>
+            </form>
+
+            <script>
+            document.addEventListener('DOMContentLoaded', function() {
+                var btn = document.getElementById('nx-insert-adsense-btn');
+                var txt = document.getElementById('nexversal_ads_txt_content');
+                if (btn && txt) {
+                    btn.addEventListener('click', function() {
+                        var snippet = "google.com, pub-XXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0\n";
+                        if (txt.value.indexOf('google.com') === -1) {
+                            txt.value = (txt.value.trim() ? txt.value.trim() + "\n" : "") + snippet;
+                        } else {
+                            alert('<?php echo esc_js(__('Google AdSense entry already present in editor.', 'nexversal')); ?>');
+                        }
+                    });
+                }
+            });
+            </script>
+        </div>
     </div>
     <?php
@@ -340 +1094 @@
 
 /**
- * Register Monetization & Ad Manager Section in WordPress Customizer
- *
- * CRITICAL RULE:
- * If the user has NOT activated PRO ($15/year), DO NOT SHOW ANY AD SLOTS OR INPUTS!
- * Show only the sleek PRO Lock Card.
+ * Register Monetization & Ad Manager Section in WordPress Customizer (v3.5.0)
+ *
+ * Beginner-Friendly & Clean UX:
+ * 1. Quick Setup (1-Click Google Auto-Ads)
+ * 2. Active Ads Plan Counter (Free: 3 Ads Limit | PRO: Unlimited)
+ * 3. Position Dropdown Selectors (Instead of manual numbers)
+ * 4. Automatic Geo-Targeting (Zero manual typing)
  */
 function nexversal_ads_customize_register($wp_customize) {
-    $is_pro = nexversal_is_pro_active();
-
-    // Section title
-    $section_title = $is_pro 
-        ? esc_html__('💰 Monetization & Ad Engine [PRO Active]', 'nexversal')
-        : esc_html__('💰 Monetization & Ad Engine [PRO Locked]', 'nexversal');
-
-    $section_desc = $is_pro
-        ? esc_html__('Nexversal PRO is active! Configure your automated Google AdSense, in-article, and banner slots below.', 'nexversal')
-        : esc_html__('🔒 PRO FEATURE ($15/year): Monetization & Ad Engine is locked. Upgrade to PRO to unlock automated in-article AdSense, sticky sidebar ads, and in-feed units.', 'nexversal');
+    $is_pro       = nexversal_is_pro_active();
+    $active_count = nexversal_count_active_ad_slots();
 
     $wp_customize->add_section('nexversal_monetization', array(
-        'title'       => $section_title,
-        'description' => $section_desc,
+        'title'       => esc_html__('💰 Monetization & Ad Engine', 'nexversal'),
+        'description' => esc_html__('Manage your blog advertisements. Free plan allows up to 3 active ads with automatic country detection. PRO unlocks unlimited ads and Ad-Blocker bypass!', 'nexversal'),
         'priority'    => 28,
     ));
 
-    // =========================================================================
-    // IF NOT PRO: SHOW ONLY PRO LOCK CARD AND STOP! NO AD INPUTS VISIBLE!
-    // =========================================================================
-    if (!$is_pro) {
-        $wp_customize->add_setting('nexversal_pro_lock_info', array(
-            'default'           => '',
-            'sanitize_callback' => 'wp_kses_post',
-        ));
-
-        $lock_html = '
-        <div style="background: #ffffff; border: 1px solid #e2e8f0; border-radius: 10px; padding: 22px 16px; text-align: center; margin-top: 8px; box-shadow: 0 4px 10px rgba(0,0,0,0.04);">
-            <div style="font-size: 34px; margin-bottom: 8px;">🔒</div>
-            <h4 style="margin: 0 0 8px 0; font-size: 16px; font-weight: 800; color: #0f172a;">
-                ' . esc_html__('Ad Engine is Locked in Free Plan', 'nexversal') . '
-            </h4>
-            <p style="font-size: 12.5px; color: #64748b; line-height: 1.55; margin-bottom: 18px;">
-                ' . esc_html__('Unlock 5 automated AdSense slots, in-article paragraph injection, and sticky sidebar monetization for just $15/year via Lemon Squeezy.', 'nexversal') . '
-            </p>
-            <a href="' . esc_url(nexversal_get_checkout_url()) . '" target="_blank" rel="noopener noreferrer" class="button button-primary" style="background: #10b981; border-color: #10b981; font-weight: 800; width: 100%; text-align: center; padding: 7px 0; height: auto; margin-bottom: 10px; box-shadow: 0 4px 10px rgba(16,185,129,0.3);">
-                ⚡ ' . esc_html__('Buy PRO Plan ($15/year)', 'nexversal') . '
-            </a>
-            <a href="' . esc_url(admin_url('themes.php?page=nexversal-pro')) . '" class="button" style="width: 100%; text-align: center; font-weight: 600; padding: 5px 0; height: auto;">
-                🔑 ' . esc_html__('Enter License Key', 'nexversal') . '
-            </a>
-        </div>';
-
-        $wp_customize->add_control(new WP_Customize_Control($wp_customize, 'nexversal_pro_lock_info', array(
-            'label'       => esc_html__('PRO Feature Required', 'nexversal'),
-            'description' => $lock_html,
-            'section'     => 'nexversal_monetization',
-            'type'        => 'hidden',
-        )));
-
-        // Exit immediately so ZERO ad checkboxes or textareas are registered for free users!
-        return;
-    }
-
-    // =========================================================================
-    // ONLY REACHED IF PRO IS ACTIVE ($is_pro === true)
-    // =========================================================================
-
-    // Master Toggle
+    // Plan Status Badge
+    $status_badge_html = $is_pro 
+        ? '<div style="background:#ecfdf5;border:1px solid #a7f3d0;color:#065f46;padding:10px 12px;border-radius:8px;font-size:12px;margin-bottom:12px;"><strong>✓ PRO Plan Active:</strong> Unlimited simultaneous ads unlocked!</div>'
+        : '<div style="background:#f8fafc;border:1px solid #cbd5e1;color:#1e293b;padding:10px 12px;border-radius:8px;font-size:12px;margin-bottom:12px;"><strong>⚡ Free Plan:</strong> Up to <strong>3 active ads</strong> allowed (Currently: <strong>' . intval($active_count) . '/3 Active</strong>).</div>';
+
+    $wp_customize->add_setting('nexversal_plan_status_info', array('default' => '', 'sanitize_callback' => 'wp_kses_post'));
+    $wp_customize->add_control(new WP_Customize_Control($wp_customize, 'nexversal_plan_status_info', array(
+        'label'       => '',
+        'description' => $status_badge_html,
+        'section'     => 'nexversal_monetization',
+        'type'        => 'hidden',
+    )));
+
+    // Master Switch
     $wp_customize->add_setting('nexversal_ads_enabled', array(
         'default'           => true,
@@ -411 +1131 @@
     ));
     $wp_customize->add_control('nexversal_ads_enabled', array(
-        'label'       => esc_html__('Enable Built-in Ad Engine', 'nexversal'),
-        'description' => esc_html__('Master switch to display or hide all theme ad placements.', 'nexversal'),
+        'label'       => esc_html__('Enable All Ads', 'nexversal'),
+        'description' => esc_html__('Turn this ON to display ads on your website.', 'nexversal'),
         'section'     => 'nexversal_monetization',
         'type'        => 'checkbox',
     ));
 
-    // Sponsored Label Toggle (Google AdSense Policy Compliance)
+    // Show Advertisement Label
     $wp_customize->add_setting('nexversal_ads_show_label', array(
         'default'           => true,
@@ -424 +1144 @@
     $wp_customize->add_control('nexversal_ads_show_label', array(
         'label'       => esc_html__('Show "Advertisement" Label', 'nexversal'),
-        'description' => esc_html__('Recommended for Google AdSense & regulatory compliance.', 'nexversal'),
+        'description' => esc_html__('Required for Google AdSense compliance.', 'nexversal'),
         'section'     => 'nexversal_monetization',
         'type'        => 'checkbox',
     ));
 
-    // --- Slot 1: Header Leaderboard (Below Navigation) ---
+    // -------------------------------------------------------------------------
+    // 1-Click Shortcut: Google AdSense Publisher ID
+    // -------------------------------------------------------------------------
+    $wp_customize->add_setting('nexversal_adsense_pub_id', array(
+        'default'           => '',
+        'sanitize_callback' => 'sanitize_text_field',
+    ));
+    $wp_customize->add_control('nexversal_adsense_pub_id', array(
+        'label'       => esc_html__('⚡ 1-Click Google Auto-Ads (Optional Shortcut)', 'nexversal'),
+        'description' => esc_html__('Paste your AdSense Publisher ID (e.g. ca-pub-xxxxxxxxxxxxxxxx). Google will automatically run ads and auto-detect visitor country without configuring individual slots!', 'nexversal'),
+        'section'     => 'nexversal_monetization',
+        'type'        => 'text',
+        'input_attrs' => array('placeholder' => 'ca-pub-XXXXXXXXXXXXXXXX'),
+    ));
+
+    // Divider: Manual Slot Settings
+    $wp_customize->add_setting('nexversal_slots_heading', array('default' => '', 'sanitize_callback' => 'sanitize_text_field'));
+    $wp_customize->add_control(new WP_Customize_Control($wp_customize, 'nexversal_slots_heading', array(
+        'label'       => esc_html__('📍 Individual Ad Slots (Pick Your 3 Free Slots)', 'nexversal'),
+        'description' => esc_html__('Turn ON up to 3 slots for Free, or unlimited with PRO. Country targeting is automatic!', 'nexversal'),
+        'section'     => 'nexversal_monetization',
+        'type'        => 'hidden',
+    )));
+
+    // --- Slot 1: Header Banner (728x90) ---
     $wp_customize->add_setting('nexversal_ad_header_enabled', array(
         'default'           => false,
@@ -435 +1179 @@
     ));
     $wp_customize->add_control('nexversal_ad_header_enabled', array(
-        'label'    => esc_html__('[Slot 1] Enable Header Banner Ad (728x90)', 'nexversal'),
+        'label'    => esc_html__('1. Top Header Banner (728x90)', 'nexversal'),
         'section'  => 'nexversal_monetization',
         'type'     => 'checkbox',
@@ -444 +1188 @@
     ));
     $wp_customize->add_control('nexversal_ad_header_code', array(
-        'label'       => esc_html__('Header Ad Code / HTML / AdSense', 'nexversal'),
-        'description' => esc_html__('Appears directly beneath the top header across all pages.', 'nexversal'),
+        'label'       => '',
+        'description' => esc_html__('Paste Top Header ad code / HTML / AdSense.', 'nexversal'),
         'section'     => 'nexversal_monetization',
         'type'        => 'textarea',
-    ));
-
-    // --- Slot 2: Auto In-Article Mid-Content Ad ---
+        'input_attrs' => array('rows' => 3, 'placeholder' => '<!-- Paste header ad code here -->'),
+    ));
+
+    // --- Slot 2: In-Article Mid-Content Ad (With Dropdown Menu) ---
     $wp_customize->add_setting('nexversal_ad_article_enabled', array(
         'default'           => false,
@@ -456 +1201 @@
     ));
     $wp_customize->add_control('nexversal_ad_article_enabled', array(
-        'label'    => esc_html__('[Slot 2] Enable In-Article Mid-Content Ad', 'nexversal'),
+        'label'    => esc_html__('2. In-Article Content Ad', 'nexversal'),
         'section'  => 'nexversal_monetization',
         'type'     => 'checkbox',
     ));
     $wp_customize->add_setting('nexversal_ad_article_pos', array(
-        'default'           => 3,
-        'sanitize_callback' => 'absint',
+        'default'           => '3',
+        'sanitize_callback' => 'sanitize_text_field',
     ));
     $wp_customize->add_control('nexversal_ad_article_pos', array(
-        'label'       => esc_html__('Insert after paragraph #', 'nexversal'),
-        'description' => esc_html__('Default is after paragraph 3 (optimal viewability).', 'nexversal'),
+        'label'       => esc_html__('In-Article Ad Position (Dropdown)', 'nexversal'),
+        'description' => esc_html__('Choose where inside the article narrative to display the ad.', 'nexversal'),
         'section'     => 'nexversal_monetization',
-        'type'        => 'number',
-        'input_attrs' => array('min' => 1, 'max' => 20, 'step' => 1),
+        'type'        => 'select',
+        'choices'     => array(
+            '2'  => esc_html__('Early — After 2nd Paragraph', 'nexversal'),
+            '3'  => esc_html__('Optimal — After 3rd Paragraph (Recommended)', 'nexversal'),
+            '4'  => esc_html__('Midway — After 4th Paragraph', 'nexversal'),
+            '5'  => esc_html__('Deep — After 5th Paragraph', 'nexversal'),
+            '50' => esc_html__('Center — Exact Middle of Article (Auto)', 'nexversal'),
+        ),
     ));
     $wp_customize->add_setting('nexversal_ad_article_code', array(
@@ -476 +1227 @@
     ));
     $wp_customize->add_control('nexversal_ad_article_code', array(
-        'label'       => esc_html__('In-Article Ad Code / AdSense', 'nexversal'),
-        'description' => esc_html__('Automatically injected inside post body narrative.', 'nexversal'),
+        'label'       => '',
+        'description' => esc_html__('Paste in-article ad code / HTML.', 'nexversal'),
         'section'     => 'nexversal_monetization',
         'type'        => 'textarea',
+        'input_attrs' => array('rows' => 3, 'placeholder' => '<!-- Paste in-article ad code here -->'),
     ));
 
@@ -488 +1240 @@
     ));
     $wp_customize->add_control('nexversal_ad_post_bottom_enabled', array(
-        'label'    => esc_html__('[Slot 3] Enable Post Bottom Ad', 'nexversal'),
+        'label'    => esc_html__('3. Below Post Content Ad', 'nexversal'),
         'section'  => 'nexversal_monetization',
         'type'     => 'checkbox',
@@ -497 +1249 @@
     ));
     $wp_customize->add_control('nexversal_ad_post_bottom_code', array(
-        'label'       => esc_html__('Post Bottom Ad Code', 'nexversal'),
-        'description' => esc_html__('Appears right after post content before author box.', 'nexversal'),
+        'label'       => '',
+        'description' => esc_html__('Paste post bottom ad code / HTML.', 'nexversal'),
         'section'     => 'nexversal_monetization',
         'type'        => 'textarea',
-    ));
-
-    // --- Slot 4: Homepage In-Feed Ad (Between Cards) ---
+        'input_attrs' => array('rows' => 3, 'placeholder' => '<!-- Paste post bottom ad code here -->'),
+    ));
+
+    // --- Slot 4: Homepage In-Feed Ad (With Dropdown Menu) ---
     $wp_customize->add_setting('nexversal_ad_infeed_enabled', array(
         'default'           => false,
@@ -509 +1262 @@
     ));
     $wp_customize->add_control('nexversal_ad_infeed_enabled', array(
-        'label'    => esc_html__('[Slot 4] Enable In-Feed Ad (Post Grid)', 'nexversal'),
+        'label'    => esc_html__('4. Homepage In-Feed Grid Ad', 'nexversal'),
         'section'  => 'nexversal_monetization',
         'type'     => 'checkbox',
     ));
     $wp_customize->add_setting('nexversal_ad_infeed_pos', array(
-        'default'           => 3,
-        'sanitize_callback' => 'absint',
+        'default'           => '3',
+        'sanitize_callback' => 'sanitize_text_field',
     ));
     $wp_customize->add_control('nexversal_ad_infeed_pos', array(
-        'label'       => esc_html__('Display In-Feed Ad after card #', 'nexversal'),
-        'description' => esc_html__('E.g., 3 means after the 3rd post card in the grid.', 'nexversal'),
+        'label'       => esc_html__('In-Feed Card Position (Dropdown)', 'nexversal'),
+        'description' => esc_html__('Choose after which article card to insert this ad.', 'nexversal'),
         'section'     => 'nexversal_monetization',
-        'type'        => 'number',
-        'input_attrs' => array('min' => 1, 'max' => 12, 'step' => 1),
+        'type'        => 'select',
+        'choices'     => array(
+            '2' => esc_html__('After 2nd Article Card', 'nexversal'),
+            '3' => esc_html__('After 3rd Article Card (Recommended)', 'nexversal'),
+            '4' => esc_html__('After 4th Article Card', 'nexversal'),
+            '6' => esc_html__('After 6th Article Card', 'nexversal'),
+        ),
     ));
     $wp_customize->add_setting('nexversal_ad_infeed_code', array(
@@ -529 +1287 @@
     ));
     $wp_customize->add_control('nexversal_ad_infeed_code', array(
-        'label'       => esc_html__('In-Feed Ad Code / AdSense In-feed Unit', 'nexversal'),
+        'label'       => '',
+        'description' => esc_html__('Paste in-feed grid ad code / AdSense unit.', 'nexversal'),
         'section'     => 'nexversal_monetization',
         'type'        => 'textarea',
+        'input_attrs' => array('rows' => 3, 'placeholder' => '<!-- Paste in-feed ad code here -->'),
     ));
 
@@ -540 +1300 @@
     ));
     $wp_customize->add_control('nexversal_ad_sidebar_enabled', array(
-        'label'    => esc_html__('[Slot 5] Enable Sticky Sidebar Ad (300x250 / 300x600)', 'nexversal'),
+        'label'    => esc_html__('5. Sticky Sidebar Ad (300x250 / 300x600)', 'nexversal'),
         'section'  => 'nexversal_monetization',
         'type'     => 'checkbox',
@@ -549 +1309 @@
     ));
     $wp_customize->add_control('nexversal_ad_sidebar_code', array(
-        'label'       => esc_html__('Sidebar Ad Code', 'nexversal'),
-        'description' => esc_html__('Floats as user scrolls down the page in the sidebar.', 'nexversal'),
+        'label'       => '',
+        'description' => esc_html__('Paste sticky sidebar ad code.', 'nexversal'),
         'section'     => 'nexversal_monetization',
         'type'        => 'textarea',
-    ));
+        'input_attrs' => array('rows' => 3, 'placeholder' => '<!-- Paste sidebar ad code here -->'),
+    ));
+
+    // -------------------------------------------------------------------------
+    // Global Worldwide Geo-Targeting & PRO Upsell Card
+    // -------------------------------------------------------------------------
+    $geo_info_html = '
+    <div style="background:linear-gradient(135deg, #f0fdf4 0%, #ecfdf5 100%);border:1px solid #a7f3d0;padding:12px 14px;border-radius:8px;font-size:12px;margin:12px 0 8px 0;line-height:1.45;">
+        <div style="display:flex;align-items:center;justify-content:space-between;gap:6px;font-weight:700;color:#065f46;margin-bottom:4px;">
+            <span style="font-size:12.5px;">🌍 ' . esc_html__('Global Smart Geo-Targeting', 'nexversal') . '</span>
+            <span style="font-size:10px;font-weight:700;background:#dcfce7;color:#15803d;border:1px solid #86efac;padding:1px 6px;border-radius:9999px;">AUTOMATIC</span>
+        </div>
+        <p style="margin:0 0 8px 0;color:#334155;font-size:11.5px;line-height:1.45;">
+            ' . esc_html__('Zero setup. Serves hyper-targeted, high-CPM ads to every visitor worldwide (195+ countries) in their local currency. Free plan is strictly capped at 3 ads.', 'nexversal') . '
+        </p>
+        <a href="' . esc_url(nexversal_get_checkout_url()) . '" target="_blank" rel="noopener noreferrer" style="display:inline-flex;align-items:center;gap:4px;font-weight:700;color:#4f46e5;text-decoration:none;font-size:11.5px;">
+            ⚡ ' . esc_html__('Upgrade to PRO for Unlimited Ads (/yr) →', 'nexversal') . '
+        </a>
+    </div>';
+
+    $wp_customize->add_setting('nexversal_auto_geo_info', array('default' => '', 'sanitize_callback' => 'wp_kses_post'));
+    $wp_customize->add_control(new WP_Customize_Control($wp_customize, 'nexversal_auto_geo_info', array(
+        'label'       => '',
+        'description' => $geo_info_html,
+        'section'     => 'nexversal_monetization',
+        'type'        => 'hidden',
+    )));
+
+    // -------------------------------------------------------------------------
+    // PRO Feature: Ad-Blocker Bypass
+    // -------------------------------------------------------------------------
+    $wp_customize->add_setting('nexversal_pro_adblock_heading', array('default' => '', 'sanitize_callback' => 'sanitize_text_field'));
+    $wp_customize->add_control(new WP_Customize_Control($wp_customize, 'nexversal_pro_adblock_heading', array(
+        'label'       => esc_html__('🛡️ PRO: Ad-Blocker Bypass Engine', 'nexversal'),
+        'description' => $is_pro 
+            ? esc_html__('When an ad blocker (uBlock, AdBlock, Brave) blocks an ad, your fallback banner displays automatically!', 'nexversal')
+            : esc_html__('🔒 PRO FEATURE ($15/yr): Force ads and affiliate banners to show even when visitors use AdBlockers. Boosts earnings by 25-35%.', 'nexversal'),
+        'section'     => 'nexversal_monetization',
+        'type'        => 'hidden',
+    )));
+
+    if ($is_pro) {
+        $wp_customize->add_setting('nexversal_adblock_bypass_enabled', array(
+            'default'           => false,
+            'sanitize_callback' => 'nexversal_sanitize_checkbox',
+        ));
+        $wp_customize->add_control('nexversal_adblock_bypass_enabled', array(
+            'label'       => esc_html__('Enable Ad-Blocker Bypass', 'nexversal'),
+            'description' => esc_html__('Automatically render fallback message/banner when ads are blocked.', 'nexversal'),
+            'section'     => 'nexversal_monetization',
+            'type'        => 'checkbox',
+        ));
+
+        $wp_customize->add_setting('nexversal_adblock_fallback_code', array(
+            'default'           => '',
+            'sanitize_callback' => 'nexversal_sanitize_ad_code',
+        ));
+        $wp_customize->add_control('nexversal_adblock_fallback_code', array(
+            'label'       => esc_html__('Fallback Affiliate Banner / Custom Message HTML', 'nexversal'),
+            'description' => esc_html__('Enter custom HTML or an affiliate banner that AdBlockers cannot detect.', 'nexversal'),
+            'section'     => 'nexversal_monetization',
+            'type'        => 'textarea',
+            'input_attrs' => array('rows' => 3, 'placeholder' => '<!-- Paste fallback banner HTML or affiliate code here -->'),
+        ));
+    }
+
+    // Upgrade Callout if Free
+    if (!$is_pro) {
+        $wp_customize->add_setting('nexversal_pro_upgrade_banner', array('default' => '', 'sanitize_callback' => 'wp_kses_post'));
+        $upgrade_html = '
+        <div style="background: #f8fafc; border: 1px dashed #cbd5e1; border-radius: 8px; padding: 14px; text-align: center; margin-top: 14px;">
+            <div style="font-weight: 800; font-size: 13.5px; color: #0f172a; margin-bottom: 4px;">⚡ ' . esc_html__('Run More than 3 Ads? Get PRO!', 'nexversal') . '</div>
+            <p style="font-size: 12px; color: #64748b; line-height: 1.45; margin-bottom: 12px;">' . esc_html__('Free plan is capped at 3 simultaneous ads. Upgrade to PRO ($15/year) to run unlimited ads, unlock Ad-Blocker Bypass, and view live CTR analytics.', 'nexversal') . '</p>
+            <a href="' . esc_url(nexversal_get_checkout_url()) . '" target="_blank" rel="noopener noreferrer" class="button button-primary" style="background: #10b981; border-color: #10b981; width: 100%; font-weight: 800; text-align: center;">' . esc_html__('Unlock Unlimited Ads ($15/yr) ➔', 'nexversal') . '</a>
+        </div>';
+
+        $wp_customize->add_control(new WP_Customize_Control($wp_customize, 'nexversal_pro_upgrade_banner', array(
+            'label'       => '',
+            'description' => $upgrade_html,
+            'section'     => 'nexversal_monetization',
+            'type'        => 'hidden',
+        )));
+    }
 }
 add_action('customize_register', 'nexversal_ads_customize_register', 40);
+
+/* ==========================================================================
+   Post-by-Post Ad Exclusion Framework (Gutenberg & Classic Meta Boxes)
+   ========================================================================== */
+
+/**
+ * Register post meta key for REST API & Gutenberg Sidebar Component
+ */
+function nexversal_register_monetization_meta() {
+    $post_types = array('post', 'page');
+    foreach ($post_types as $pt) {
+        register_post_meta($pt, '_nexversal_disable_ads', array(
+            'show_in_rest'      => true,
+            'single'            => true,
+            'type'              => 'boolean',
+            'auth_callback'     => function() use ($pt) {
+                return current_user_can($pt === 'page' ? 'edit_pages' : 'edit_posts');
+            },
+            'sanitize_callback' => 'rest_sanitize_boolean',
+            'description'       => __('Disable Google AdSense and theme ads for this specific post/page.', 'nexversal'),
+        ));
+    }
+}
+add_action('init', 'nexversal_register_monetization_meta');
+
+/**
+ * Register "Monetization Controls" Meta Box in Post and Page editor screens
+ */
+function nexversal_add_monetization_meta_box() {
+    $screens = array('post', 'page');
+    foreach ($screens as $screen) {
+        add_meta_box(
+            'nexversal_monetization_metabox',
+            __('Monetization Controls', 'nexversal'),
+            'nexversal_render_monetization_meta_box',
+            $screen,
+            'side',
+            'default'
+        );
+    }
+}
+add_action('add_meta_boxes', 'nexversal_add_monetization_meta_box');
+
+/**
+ * Render the Monetization Controls Meta Box
+ *
+ * @param WP_Post $post Current post object
+ */
+function nexversal_render_monetization_meta_box($post) {
+    wp_nonce_field('nexversal_save_monetization_action', 'nexversal_monetization_nonce');
+    $is_disabled = (bool) get_post_meta($post->ID, '_nexversal_disable_ads', true);
+    ?>
+    <div class="nx-meta-box-wrap" style="padding: 6px 0;">
+        <label for="nexversal_disable_ads" style="display: flex; align-items: flex-start; gap: 8px; cursor: pointer; font-weight: 600; font-size: 13px; line-height: 1.4; color: #1e293b;">
+            <input type="checkbox" name="nexversal_disable_ads" id="nexversal_disable_ads" value="1" <?php checked($is_disabled, true); ?> style="margin-top: 2px;" />
+            <span><?php esc_html_e('Disable AdSense for this post', 'nexversal'); ?></span>
+        </label>
+        <p class="description" style="margin: 8px 0 0 24px; font-size: 12px; line-height: 1.4; color: #64748b;">
+            <?php esc_html_e('When checked, all header, in-article, bottom, in-feed, sidebar ads, Auto Ads, and shortcodes are completely suppressed on this article.', 'nexversal'); ?>
+        </p>
+        <div style="margin-top: 12px; padding: 6px 10px; border-radius: 4px; font-size: 11px; font-weight: 500; <?php echo $is_disabled ? 'background: #fef2f2; color: #991b1b; border: 1px solid #fecaca;' : 'background: #f0fdf4; color: #166534; border: 1px solid #bbf7d0;'; ?>">
+            <strong><?php esc_html_e('Status:', 'nexversal'); ?></strong>
+            <?php echo $is_disabled ? esc_html__('Ads Suppressed on this Post', 'nexversal') : esc_html__('Ads Active (Inheriting Global Settings)', 'nexversal'); ?>
+        </div>
+    </div>
+    <?php
+}
+
+/**
+ * Save Monetization Meta Box Data with strict validation & sanitization
+ *
+ * @param int     $post_id Post ID
+ * @param WP_Post $post    Post object
+ */
+function nexversal_save_monetization_meta_box($post_id, $post) {
+    // 1. Verify nonce security check
+    if (!isset($_POST['nexversal_monetization_nonce']) || !wp_verify_nonce($_POST['nexversal_monetization_nonce'], 'nexversal_save_monetization_action')) {
+        return;
+    }
+
+    // 2. Prevent autosave from overwriting meta
+    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
+        return;
+    }
+
+    // 3. Prevent revisions from storing post meta
+    if (wp_is_post_revision($post_id)) {
+        return;
+    }
+
+    // 4. Verify user permissions
+    $post_type = get_post_type($post_id);
+    $cap = ($post_type === 'page') ? 'edit_page' : 'edit_post';
+    if (!current_user_can($cap, $post_id)) {
+        return;
+    }
+
+    // 5. Sanitize and save boolean flag
+    if (!empty($_POST['nexversal_disable_ads'])) {
+        update_post_meta($post_id, '_nexversal_disable_ads', true);
+    } else {
+        delete_post_meta($post_id, '_nexversal_disable_ads');
+    }
+}
+add_action('save_post', 'nexversal_save_monetization_meta_box', 10, 2);
+
+/**
+ * Check if ads are disabled on a specific post or current singular template
+ *
+ * @param int|null $post_id Optional post ID
+ * @return bool True if ads should be suppressed on this post, false otherwise.
+ */
+function nexversal_is_ad_disabled_for_post($post_id = null) {
+    if (empty($post_id)) {
+        if (is_singular()) {
+            $post_id = get_queried_object_id();
+        } elseif (in_the_loop()) {
+            $post_id = get_the_ID();
+        }
+    }
+
+    if (empty($post_id)) {
+        return false;
+    }
+
+    $disabled = (bool) get_post_meta($post_id, '_nexversal_disable_ads', true);
+
+    /**
+     * Absolute filter hook for theme's structural ad engine
+     *
+     * @param bool $disabled Whether ads are suppressed
+     * @param int  $post_id  The evaluated post ID
+     */
+    return (bool) apply_filters('nexversal_is_ad_disabled_for_post', $disabled, $post_id);
+}
+
+/**
+ * Master structural filter to suppress any ad unit evaluation dynamically
+ */
+add_filter('nexversal_should_render_ad', function($should_render, $slot = '') {
+    if (nexversal_is_ad_disabled_for_post()) {
+        return false;
+    }
+    return $should_render;
+}, 10, 2);
+
+/**
+ * Add Ads Status Column to Posts & Pages List Table
+ */
+function nexversal_add_ad_column_header($columns) {
+    $columns['nx_ad_status'] = __('Ads', 'nexversal');
+    return $columns;
+}
+add_filter('manage_post_posts_columns', 'nexversal_add_ad_column_header');
+add_filter('manage_page_posts_columns', 'nexversal_add_ad_column_header');
+
+function nexversal_render_ad_column_content($column, $post_id) {
+    if ($column === 'nx_ad_status') {
+        $disabled = (bool) get_post_meta($post_id, '_nexversal_disable_ads', true);
+        if ($disabled) {
+            echo '<span style="display:inline-block; padding: 2px 7px; border-radius: 9999px; font-size: 11px; font-weight: 700; background: #fee2e2; color: #dc2626;">' . esc_html__('Disabled', 'nexversal') . '</span>';
+        } else {
+            echo '<span style="display:inline-block; padding: 2px 7px; border-radius: 9999px; font-size: 11px; font-weight: 700; background: #dcfce7; color: #16a34a;">' . esc_html__('Active', 'nexversal') . '</span>';
+        }
+    }
+}
+add_action('manage_post_posts_custom_column', 'nexversal_render_ad_column_content', 10, 2);
+add_action('manage_page_posts_custom_column', 'nexversal_render_ad_column_content', 10, 2);
 
 /**
@@ -568 +1578 @@
 
 /**
- * Render an ad slot with compliance container and label
+ * Render an ad slot with compliance container, label, Free limit check & Ad-Blocker Bypass
  *
  * @param string $slot Slot slug (header, in_article, post_bottom, infeed, sidebar)
@@ -575 +1585 @@
  */
 function nexversal_render_ad($slot, $echo = true) {
-    // Paid PRO Check: Only render ads if PRO plan ($15/year) is active!
-    if (!nexversal_is_pro_active()) {
+    // 1. Post-by-Post Ad Exclusion Short-circuit
+    if (function_exists('nexversal_is_ad_disabled_for_post') && nexversal_is_ad_disabled_for_post()) {
+        return '';
+    }
+
+    // 2. Master structural filter
+    if (!apply_filters('nexversal_should_render_ad', true, $slot)) {
+        return '';
+    }
+
+    // 3. Strict Free Plan Limit: Exactly 3 ads per page across all sources
+    if (function_exists('nexversal_can_render_ad') && !nexversal_can_render_ad()) {
         return '';
     }
@@ -585 +1605 @@
     }
 
-    $slot_on   = get_theme_mod("nexversal_ad_{$slot}_enabled", false);
-    $ad_code   = get_theme_mod("nexversal_ad_{$slot}_code", '');
+    $slot_on = get_theme_mod("nexversal_ad_{$slot}_enabled", false);
+    $ad_code = get_theme_mod("nexversal_ad_{$slot}_code", '');
 
     if (!$slot_on || empty(trim($ad_code))) {
@@ -592 +1612 @@
     }
 
+    // Free vs PRO Active Ad Limit Check (Free: Max 3 active slots)
+    $allowed_slots = nexversal_get_allowed_ad_slots();
+    if (!in_array($slot, $allowed_slots, true)) {
+        return ''; // Exceeded Free Plan 3-ad limit
+    }
+
+    $is_pro     = nexversal_is_pro_active();
     $show_label = get_theme_mod('nexversal_ads_show_label', true);
-    $output     = '<div class="nx-ad-slot nx-ad-' . esc_attr($slot) . '">';
-    
-    if ($show_label) {
-        $output .= '<span class="nx-ad-label">' . esc_html__('ADVERTISEMENT', 'nexversal') . '</span>';
-    }
-    
-    $output .= '<div class="nx-ad-content">' . $ad_code . '</div>';
-    $output .= '</div>';
+
+    // Admin / Editor Shielding: Intercept live AdSense scripts for administrators & editors to prevent invalid traffic
+    if (function_exists('nexversal_wrap_adsense_code')) {
+        $ad_code = nexversal_wrap_adsense_code($ad_code, $slot);
+    }
+
+    // GDPR Interception: Filter ad scripts into inert type="text/plain" if user consent is pending
+    if (function_exists('nexversal_filter_ad_code_for_consent')) {
+        $ad_code = nexversal_filter_ad_code_for_consent($ad_code);
+    }
+
+    $fallback = '';
+    if ($is_pro && get_theme_mod('nexversal_adblock_bypass_enabled', false)) {
+        $fallback = get_theme_mod('nexversal_adblock_fallback_code', '');
+    }
+
+    // CLS Optimization: Generate semantic HTML skeleton wrapper container with reserved bounding box
+    if (function_exists('nexversal_render_ad_skeleton')) {
+        $output = nexversal_render_ad_skeleton($slot, $ad_code, $fallback, $show_label);
+    } else {
+        $output = '<div class="nx-ad-slot nx-ad-' . esc_attr($slot) . '" data-ad-slot="' . esc_attr($slot) . '">';
+        if ($show_label) {
+            $output .= '<span class="nx-ad-label">' . esc_html__('ADVERTISEMENT', 'nexversal') . '</span>';
+        }
+        $output .= '<div class="nx-ad-content">' . $ad_code . '</div>';
+        if (!empty(trim($fallback))) {
+            $output .= '<div class="nx-ad-blocker-bypass" style="display: none;">' . $fallback . '</div>';
+        }
+        $output .= '</div>';
+    }
+
+    // Increment global page ad execution tracker
+    if (function_exists('nexversal_increment_page_ad_count')) {
+        nexversal_increment_page_ad_count();
+    }
 
     if ($echo) {
@@ -620 +1674 @@
     }
 
-    // Paid PRO Check
-    if (!nexversal_is_pro_active()) {
+    // Post-by-Post Ad Exclusion Short-circuit
+    if (function_exists('nexversal_is_ad_disabled_for_post') && nexversal_is_ad_disabled_for_post()) {
+        return $content;
+    }
+
+    // Strict Free Plan Limit: Exactly 3 ads per page across all placements
+    if (function_exists('nexversal_can_render_ad') && !nexversal_can_render_ad()) {
         return $content;
     }
@@ -633 +1692 @@
     }
 
-    $pos = max(1, (int) get_theme_mod('nexversal_ad_article_pos', 3));
+    // Check Free vs PRO allowed slots
+    $allowed_slots = nexversal_get_allowed_ad_slots();
+    if (!in_array('article', $allowed_slots, true)) {
+        return $content;
+    }
+
     $ad_html = nexversal_render_ad('article', false);
-
     if (empty($ad_html)) {
         return $content;
@@ -643 +1706 @@
     $paragraphs = explode('</p>', $content);
     $total_p    = count($paragraphs) - 1;
+
+    $pos_setting = get_theme_mod('nexversal_ad_article_pos', '3');
+    if ($pos_setting === '50') {
+        // Automatic middle
+        $pos = max(1, (int) round($total_p / 2));
+    } else {
+        $pos = max(1, (int) $pos_setting);
+    }
 
     if ($total_p >= $pos) {
@@ -659 +1730 @@
 }
 add_filter('the_content', 'nexversal_inject_in_article_ad', 20);
-
-

nexversal/3.5.9/index.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Main Template File (Homepage / Blog Feed) for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Main Template File (Homepage / Blog Feed)
- *
- * @package Nexversal
- */
 
 get_header();
@@ -31 +32 @@
 
             <?php
-            $hero_btn_text = get_theme_mod('nexversal_hero_btn_text', 'Explore Articles');
-            $hero_btn_url  = get_theme_mod('nexversal_hero_btn_url', '#primary');
-            if (!empty($hero_btn_text)) :
-                ?>
-                <div class="nx-hero-actions" style="margin-bottom: 22px;">
-                    <a href="<?php echo esc_url($hero_btn_url); ?>" class="nx-btn nx-btn-primary nx-hero-btn">
-                        <span><?php echo esc_html($hero_btn_text); ?></span>
-                        <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" style="margin-left: 6px;"><line x1="5" y1="12" x2="19" y2="12"></line><polyline points="12 5 19 12 12 19"></polyline></svg>
-                    </a>
-                </div>
-            <?php endif; ?>
+            if (function_exists('nexversal_render_hero_button')) {
+                nexversal_render_hero_button();
+            }
+            ?>
 
             <?php
@@ -106 +100 @@
         </div>
 
-        <?php get_sidebar(); ?>
+        <?php
+        if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_sidebar')) {
+            get_sidebar();
+        }
+        ?>
     </div>
 </main>

nexversal/3.5.9/page.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Page template for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Page template
- *
- * @package Nexversal
- */
 
 get_header();
@@ -22 +23 @@
             while (have_posts()) :
                 the_post();
-
-                $raw_content    = get_the_content();
-                $page_title     = get_the_title();
-                $page_slug      = get_post_field('post_name', get_the_ID());
-                $is_sample_page = ($page_slug === 'sample-page') || 
-                                  (stripos($raw_content, 'bike messenger by day') !== false) || 
-                                  (stripos($page_title, 'Sample Page') !== false);
                 ?>
                 <article id="post-<?php the_ID(); ?>" <?php post_class('nx-single-article nx-page-card'); ?>>
-                    <?php nexversal_breadcrumbs(); ?>
+                    <?php
+                    if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_breadcrumbs')) {
+                        nexversal_breadcrumbs();
+                    }
+                    ?>
 
-                    <h1 class="nx-single-title">
-                        <?php echo $is_sample_page ? esc_html__('About Us — Nexes Agency', 'nexversal') : esc_html($page_title); ?>
-                    </h1>
+                    <?php if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_title')) : ?>
+                        <h1 class="nx-single-title">
+                            <?php the_title(); ?>
+                        </h1>
+                    <?php endif; ?>
 
                     <?php if (has_post_thumbnail()) : ?>
@@ -44 +44 @@
 
                     <div class="nx-single-content">
-                        <?php if ($is_sample_page) : ?>
-                            <div class="nx-agency-hero" style="background: linear-gradient(135deg, rgba(79, 70, 229, 0.12) 0%, rgba(6, 182, 212, 0.1) 100%); border: 1px solid var(--nx-border); border-radius: var(--nx-radius); padding: 32px 28px; margin-bottom: 32px;">
-                                <span style="display: inline-block; font-size: 0.75rem; font-weight: 700; text-transform: uppercase; letter-spacing: 0.08em; color: var(--nx-primary); background: var(--nx-primary-light); padding: 4px 12px; border-radius: 999px; margin-bottom: 12px;"><?php esc_html_e('Premier Digital Agency • Pakistan', 'nexversal'); ?></span>
-                                <h2 style="font-size: 1.85rem; font-weight: 800; margin-top: 0; margin-bottom: 12px; color: var(--nx-dark); line-height: 1.3;">
-                                    <?php esc_html_e('Welcome to Nexes — Driving Digital Dominance & Engineering Excellence', 'nexversal'); ?>
-                                </h2>
-                                <p style="font-size: 1.05rem; line-height: 1.7; color: var(--nx-text); margin-bottom: 0;">
-                                    <?php esc_html_e('We are a premier, full-scale digital agency proudly originating from Pakistan. Nexes unites elite software engineering with cutting-edge SEO and performance marketing to scale ambitious digital brands across the globe.', 'nexversal'); ?>
-                                </p>
-                            </div>
+                        <?php
+                        the_content();
 
-                            <div class="nx-profile-lead" style="display: flex; gap: 24px; align-items: flex-start; background: var(--nx-bg); border: 1px solid var(--nx-border); border-radius: var(--nx-radius); padding: 24px; margin-bottom: 32px; flex-wrap: wrap;">
-                                <div style="width: 80px; height: 80px; border-radius: 50%; background: linear-gradient(135deg, #4f46e5 0%, #06b6d4 100%); display: flex; align-items: center; justify-content: center; color: #fff; font-weight: 800; font-size: 1.8rem; flex-shrink: 0; box-shadow: var(--nx-shadow-sm);">
-                                    MS
-                                </div>
-                                <div style="flex: 1; min-width: 240px;">
-                                    <span style="font-size: 0.78rem; font-weight: 700; color: var(--nx-primary); text-transform: uppercase; letter-spacing: 0.05em;"><?php esc_html_e('Founder & Lead Specialist', 'nexversal'); ?></span>
-                                    <h3 style="font-size: 1.45rem; font-weight: 800; margin: 4px 0 8px 0; color: var(--nx-dark);">Muhammad Shahid</h3>
-                                    <p style="font-size: 0.98rem; line-height: 1.6; color: var(--nx-text); margin-bottom: 0;">
-                                        Senior <strong>SEO Specialist</strong> and organic search architect with proven experience driving millions of search impressions and high-intent organic clicks. Muhammad specializes in technical SEO, site architecture, semantic search optimization, and algorithm-resilient growth strategies.
-                                    </p>
-                                </div>
-                            </div>
-
-                            <h3 style="font-size: 1.35rem; font-weight: 800; margin-top: 32px; margin-bottom: 16px; color: var(--nx-dark);"><?php esc_html_e('Our Cross-Functional Agency Capabilities', 'nexversal'); ?></h3>
-                            <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 20px; margin-bottom: 36px;">
-                                <div style="background: var(--nx-bg); border: 1px solid var(--nx-border); border-radius: var(--nx-radius); padding: 22px;">
-                                    <div style="width: 42px; height: 42px; border-radius: 8px; background: rgba(79, 70, 229, 0.1); color: var(--nx-primary); display: flex; align-items: center; justify-content: center; margin-bottom: 14px;">
-                                        <svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><path d="m21 21-4.35-4.35"/></svg>
-                                    </div>
-                                    <h4 style="font-size: 1.1rem; font-weight: 700; margin-top: 0; margin-bottom: 8px; color: var(--nx-dark);"><?php esc_html_e('Advanced Search Engine Optimization (SEO)', 'nexversal'); ?></h4>
-                                    <p style="font-size: 0.92rem; line-height: 1.6; color: var(--nx-text); margin-bottom: 0;"><?php esc_html_e('Full-funnel technical auditing, Core Web Vitals optimization, programmatic keyword strategy, and search engine answer optimization that systematically rank websites on Page 1.', 'nexversal'); ?></p>
-                                </div>
-
-                                <div style="background: var(--nx-bg); border: 1px solid var(--nx-border); border-radius: var(--nx-radius); padding: 22px;">
-                                    <div style="width: 42px; height: 42px; border-radius: 8px; background: rgba(6, 182, 212, 0.1); color: var(--nx-accent); display: flex; align-items: center; justify-content: center; margin-bottom: 14px;">
-                                        <svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/></svg>
-                                    </div>
-                                    <h4 style="font-size: 1.1rem; font-weight: 700; margin-top: 0; margin-bottom: 8px; color: var(--nx-dark);"><?php esc_html_e('Elite Software Engineering', 'nexversal'); ?></h4>
-                                    <p style="font-size: 0.92rem; line-height: 1.6; color: var(--nx-text); margin-bottom: 0;"><?php esc_html_e('Our dedicated team of software engineers builds scalable web applications, custom WordPress themes & plugins, performant API microservices, and robust cloud platforms.', 'nexversal'); ?></p>
-                                </div>
-
-                                <div style="background: var(--nx-bg); border: 1px solid var(--nx-border); border-radius: var(--nx-radius); padding: 22px;">
-                                    <div style="width: 42px; height: 42px; border-radius: 8px; background: rgba(236, 72, 153, 0.1); color: #ec4899; display: flex; align-items: center; justify-content: center; margin-bottom: 14px;">
-                                        <svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M18 2h-3a5 5 0 0 0-5 5v3H7v4h3v8h4v-8h3l1-4h-4V7a1 1 0 0 1 1-1h3z"/></svg>
-                                    </div>
-                                    <h4 style="font-size: 1.1rem; font-weight: 700; margin-top: 0; margin-bottom: 8px; color: var(--nx-dark);"><?php esc_html_e('Social Media & Performance Marketing', 'nexversal'); ?></h4>
-                                    <p style="font-size: 0.92rem; line-height: 1.6; color: var(--nx-text); margin-bottom: 0;"><?php esc_html_e('Data-driven social media marketing campaigns, high-converting audience targeting, creative brand storytelling, and multi-channel acquisition that convert visitors into loyal clients.', 'nexversal'); ?></p>
-                                </div>
-                            </div>
-
-                            <div style="background: var(--nx-bg); border: 1px dashed var(--nx-border); border-radius: var(--nx-radius); padding: 26px; text-align: center;">
-                                <h4 style="font-size: 1.15rem; font-weight: 700; margin-top: 0; margin-bottom: 8px; color: var(--nx-dark);"><?php esc_html_e('Ready to scale your digital presence?', 'nexversal'); ?></h4>
-                                <p style="font-size: 0.95rem; color: var(--nx-text); max-width: 600px; margin: 0 auto 16px auto;"><?php esc_html_e('Partner with Nexes today and experience search excellence, reliable software development, and transformative marketing campaigns.', 'nexversal'); ?></p>
-                                <a href="<?php echo esc_url(home_url('/contact/')); ?>" class="nx-btn nx-btn-primary" style="display: inline-flex; align-items: center; gap: 8px;">
-                                    <span><?php esc_html_e('Get In Touch With Nexes', 'nexversal'); ?></span>
-                                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M5 12h14M12 5l7 7-7 7"/></svg>
-                                </a>
-                            </div>
-                        <?php else : ?>
-                            <?php the_content(); ?>
-                        <?php endif; ?>
+                        wp_link_pages(array(
+                            'before' => '<div class="page-links">' . esc_html__('Pages:', 'nexversal'),
+                            'after'  => '</div>',
+                        ));
+                        ?>
                     </div>
 
@@ -117 +63 @@
         </div>
 
-        <?php get_sidebar(); ?>
+        <?php
+        if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_sidebar')) {
+            get_sidebar();
+        }
+        ?>
     </div>
 </main>

nexversal/3.5.9/readme.txt

@@ -4 +4 @@
 Tested up to: 7.0
 Requires PHP: 7.4
-Stable tag: 2.5.2
+Stable tag: 3.5.9
 License: GNU General Public License v2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -47 +47 @@
 == Copyright ==
 
-Nexversal WordPress Theme, Copyright 2026 Nexes Agency & Muhammad Shahid.
+Nexversal WordPress Theme, Copyright (C) 2026 Nexes Agency & Muhammad Shahid.
 Nexversal is distributed under the terms of the GNU General Public License v2 or later.
 
@@ -58 +58 @@
 == Changelog ==
 
+= 3.4.0 =
+* Page Flexibility System: Astra-style per-page & per-post layout settings meta box with 1-click toggles to Disable Header, Disable Footer, Disable Page Title, Disable Breadcrumbs, and Disable Sidebar.
+* Content Layout Modes: Added Content Layout selector (Default, Full Width Contained, Full Width Stretched Canvas) for 100% compatibility with Elementor, Beaver Builder, and Gutenberg landing pages.
+* Dynamic 2-Column Hero Section: Refined, sleek hero headline typography and compact button; added dynamic Featured Article Card on desktop with automated fallback to trending/most-viewed stories.
+* Hero Featured Post Selector: Added "★ Hero Featured Article" meta box in post editor to pin any article to the homepage hero card.
+* Dedicated Contact Settings Screen: Added Appearance > Contact Settings in WP-Admin for instant live configuration without Gutenberg blocks.
+
+= 3.3.0 =
+* Fixed Home page layout grid: sidebar is now aligned cleanly on the right side next to the main content.
+* Blog page 4-column article grid: articles now render 4 per row on desktop, eliminating single full-width stretched cards.
+* Added dynamic Trending Categories tags between Hero CTA button and "Latest Insights & Articles" on Home and Blog pages.
+* Built-in AJAX Newsletter Subscription: stores email leads directly in WP-Admin with CSV export and management under Appearance > Subscribers.
+* Automatic email field protection: ensures input field and client-side/server-side validation are always present in newsletter cards.
+* Fully editable Contact Information: email, headquarters, and response time can now be edited directly in the WordPress Page Editor without design breakage.
+* Zero-overwrite architecture: automatically preserves existing posts, categories, pages, and menus for users activating the theme on existing websites.
+* Complete Block Editor visual parity for Home, Blogs, and About Us pages with enhanced editor-style.css.
+
+= 3.2.0 =
+* Full Block Editor Editing: Homepage Hero section, headline, badge, and CTA button are now fully editable native Gutenberg blocks.
+* Registered "Homepage Hero Banner" block pattern in the WordPress Block Inserter.
+* Enhanced editor-style.css to render Hero blocks in the editor matching the frontend view.
+
+= 3.1.0 =
+* Fixed menu item duplication: dynamically deduplicated all navbar links so each page appears exactly once.
+* Cleaned About Us page: removed hardcoded stat cards (200+, 100%, 100/100) and enabled clean WordPress editor content support.
+
+= 3.0.0 =
+* Major Release: Added 4 dedicated page templates (template-home.php, template-blog.php, template-about.php, template-contact.php).
+* Automated page provisioning: Automatically creates and publishes Home, Blogs, About Us, and Contact pages in WordPress database.
+* Configures static front page (Home) and posts page (Blogs) with custom layouts out of the box.
+* Front-page.php template mapping for high-performance homepage rendering.
+
+= 3.5.4 =
+* Prevented Cumulative Layout Shift (CLS = 0.00) across all dynamic Google AdSense insertions.
+* Generated semantic HTML skeleton wrapper containers (`<aside>`, `.nx-ad-bounding-box`) with exact bounding boxes for 5 ad slots (728x90, 336x280, 300x250, 1:1 In-Feed, 300x600).
+* Applied explicit `aspect-ratio`, `min-height`, and `min-width` parameters with subtle responsive CSS shimmer placeholder styling.
+
+= 3.5.3 =
+* Added GDPR and Google AdSense Privacy-Compliant Cookie Consent Banner via `wp_footer`.
+* Implemented Google Consent Mode v2 default signal integration in `<head>`.
+* Added strict backend PHP interception of Google AdSense and publisher scripts, converting scripts to inert `type="text/plain"` until verified consent is present.
+* Zero-dependency pure vanilla JavaScript engine with dynamic DOM activation and Zero Layout Shift (CLS = 0).
+
+= 3.5.2 =
+* Added Automated Virtual ads.txt Manager in Appearance > Nexversal PRO settings panel.
+* Dynamic URL interception for `/ads.txt` with strict `Content-Type: text/plain` headers and output buffer cleanup (zero cPanel file writing required).
+* Database-sanitized textarea with manage_options capability checks, nonce security, and physical file detection.
+
+= 3.5.1 =
+* Fixed About Us URL 404 issue: Added resilient URL resolution and automatic 301 redirection for legacy `?page_id=2` and `/sample-page/` queries.
+* Enhanced navigation menu filter to auto-heal broken or stale menu links in runtime and database.
+* Added fallback 301 redirect in 404.php for legacy sample-page and About URL variants.
+
+= 3.5.9 =
+* Fixed: Full WordPress.org automated theme check compliance (zero plugin-territory shortcodes, updated publisher placeholder, safe fallback attributes).
+* Added: Explicit add_theme_support() for custom-header and custom-background.
+* Improved: Cleaned CSV subscriber stream without low-level fopen/fclose calls.
+* Improved: Global smart geo-targeting monetization engine with zero frontend CLS and transparent ad reservation.
+
+= 3.5.8 =
+* Added Global Page Ad Execution Counter (nexversal_get_page_ad_count & nexversal_can_render_ad) strictly capping Free plan to 3 ads per page across all structural slots, in-article injector, and shortcodes.
+* Injected data-max-ads-per-page="3" into Google Auto-Ads script tag for Free version, preserved across GDPR consent transitions and suppressed for Admin Shield.
+* Re-crafted Customizer Geo-Targeting card with high-converting, punchy copy and direct 1-click PRO upgrade link.
+
+= 3.5.7 =
+* Added complete 301 Redirects mapping table for all 22 dead GSC 404 URLs directly into theme runtime and 404 handler.
+* Fixed /blogs to /blog/ canonical routing bug preventing 404 errors on blog archive navigation.
+* Fixed template resolution lookup in nexversal_get_blogs_page_url to accept both template-blog.php and template-blogs.php.
+
+= 3.5.6 =
+* Added Post-by-Post Ad Exclusion Framework (Gutenberg sidebar components & classic meta boxes integration).
+* Registered "Monetization Controls" meta box on post editor screens with "Disable AdSense for this post" checkbox.
+* Added absolute filter logic (nexversal_is_ad_disabled_for_post) short-circuiting all structural theme ad slots, auto-ads hooks, and shortcodes.
+* Added visual Ads status badge in WordPress admin posts and pages list table.
+
+= 3.5.5 =
+* Added production-grade Google AdSense Admin Shield wrapper function (nexversal_wrap_adsense_code).
+* Implemented strict user validation check (current_user_can('administrator') & editors) to prevent accidental self-clicks and AdSense account strikes.
+* Replaced live publisher scripts with safe local HTML developer diagnostic cards showing real-time slot details, role chips, and zero external requests.
+* Added support for Google official demo test ad parameters (data-ad-test="on").
+* Suppressed Auto-Ads head script injection for authenticated administrative and editorial visitors.
+
+= 3.5.0 =
+* Upgraded Ad & Monetization Engine to Freemium model with Google AdSense Auto Ads support and dropdown selectors.
+* Added customizable author/founder section and adaptive light/dark newsletter subscription styling.
+* Removed "Background Image" section and custom-background support from Customizer sidebar.
+
+= 2.8.0 =
+* Removed redundant Header Image and separate sidebar CTA options from Customizer.
+* Added live click-to-edit and selective refresh for the Hero CTA button in Customizer preview.
+* Added instant live color customization for all buttons site-wide (Hero, Cards, Newsletter, Forms, and Block Editor buttons).
+* Added customize-preview.js for zero-latency postMessage live updates.
+
+= 2.7.0 =
+* Fixed footer credit line formatting to render dynamic site title without trailing dot, centered on all devices.
+* Filtered legacy menu objects to guarantee "Sample Page" is never displayed in navigation.
+* Added automatic single-run page provisioning (About Us, Blogs, Contact) on theme update.
+
+= 2.6.0 =
+* Removed "Sample Page" fallback from navbar and added default Home, Blogs, About Us, Contact links.
+* Automatically configured essential pages and menu on theme activation.
+* Added built-in template-contact.php with secure email handling and anti-spam protection.
+* Dynamically output site name in centered footer copyright credit line.
+
+= 2.5.5 =
+* Added built-in template-contact.php with secure email handling and anti-spam protection.
+* Dynamically output site name in centered footer copyright credit line.
+* Linked About/Hire actions directly to official contact channel.
+
+= 2.5.4 =
+* Standardized formal GPL copyright headers across all main PHP template files.
+* Verified 100% text-domain consistency ('nexversal') across all translation calls.
+* Prepared release for official WordPress.org Theme Directory hosting.
+
+= 2.5.3 =
+* Resolved all WordPress.org automated theme check requirements.
+* Fixed dark/light mode header and body color transition synchronization.
+* Added readme.txt and official GNU GPL copyright notices.
+* Replaced hardcoded search form with standard get_search_form().
+* Removed deprecated add_shortcode from theme files.
+* Added full WordPress core alignment and caption classes.
+* Centered footer copyright and powered-by credits.
+* Added customizable button text settings in Customizer.
+
 = 2.5.2 =
-* Added complete WordPress.org Theme Handbook compliance.
 * Centered footer credits and copyright text.
 * Added custom button text controls in Customizer.
-* Fixed dark/light mode header background transition synchronization.
-* Added WordPress core alignment, caption, sticky, and bypostauthor styling.
-* Added custom-header, custom-background, and wp-block-styles theme support.
-* Replaced hardcoded search form with get_search_form().
-* Removed deprecated add_shortcode from theme files.
-* Added readme.txt with full GPL copyright documentation.
 
 = 2.5.1 =
@@ -73 +190 @@
 * Added reading progress bar and copy code snippet buttons.
 * Initial release of Nexversal.
+

nexversal/3.5.9/search.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Search results template for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Search results template
- *
- * @package Nexversal
- */
 
 get_header();
@@ -64 +65 @@
         </div>
 
-        <?php get_sidebar(); ?>
+        <?php
+        if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_sidebar')) {
+            get_sidebar();
+        }
+        ?>
     </div>
 </main>

nexversal/3.5.9/sidebar.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Sidebar template for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Sidebar template
- *
- * @package Nexversal
- */
 ?>
 <aside id="secondary" class="site-sidebar" aria-label="<?php esc_attr_e('Sidebar', 'nexversal'); ?>">

nexversal/3.5.9/single.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Single post template for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Single post template
- *
- * @package Nexversal
- */
 
 get_header();
@@ -24 +25 @@
                 ?>
                 <article id="post-<?php the_ID(); ?>" <?php post_class('nx-single-article'); ?>>
-                    <?php nexversal_breadcrumbs(); ?>
+                    <?php
+                    if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_breadcrumbs')) {
+                        nexversal_breadcrumbs();
+                    }
+                    ?>
 
                     <?php
@@ -39 +44 @@
                     <?php endif; ?>
 
-                    <h1 class="nx-single-title"><?php the_title(); ?></h1>
+                    <?php if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_title')) : ?>
+                        <h1 class="nx-single-title"><?php the_title(); ?></h1>
+                    <?php endif; ?>
 
                     <div class="nx-single-meta">
@@ -199 +206 @@
         </div>
 
-        <?php get_sidebar(); ?>
+        <?php
+        if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_sidebar')) {
+            get_sidebar();
+        }
+        ?>
     </div>
 </main>

nexversal/3.5.9/style.css

@@ -5 +5 @@
 Author URI: https://nexversal.com/about
 Description: A modern, ultra-fast, and elegant Tech & Magazine theme for WordPress engineered by Nexes Agency. Features a sleek hero section, responsive article cards, copy code buttons, reading progress bar, customizable accents, dark mode toggle, and rich SEO Schema markup.
-Version: 2.5.2
+Version: 3.5.9
 Requires at least: 6.0
 Tested up to: 7.0
@@ -14 +14 @@
 Tags: blog, news, entertainment, grid-layout, one-column, two-columns, custom-colors, custom-menu, featured-images, footer-widgets, full-width-template, theme-options, translation-ready
 
-Nexversal WordPress Theme, (C) 2026 Nexes Agency & Muhammad Shahid
+Nexversal WordPress Theme, (C) 2026 Nexes Agency & Muhammad Shahid.
 Nexversal is distributed under the terms of the GNU General Public License v2 or later.
+Copyright (C) 2026 Nexes Agency & Muhammad Shahid. All rights reserved.
 */
 
@@ -163 +164 @@
 }
 
+/* Custom Header Logo Auto-Sizing */
+.custom-logo-link {
+  display: inline-flex;
+  align-items: center;
+  line-height: 1;
+}
+
+.custom-logo-link img,
+.custom-logo {
+  max-height: 38px !important;
+  width: auto !important;
+  max-width: 200px !important;
+  object-fit: contain !important;
+  display: block;
+  transition: opacity 0.2s ease;
+}
+
+.custom-logo:hover {
+  opacity: 0.9;
+}
+
 .site-title {
   font-size: 1.4rem;
@@ -537 +559 @@
 /* Hero Section (Magazine / Tech Focus) */
 .nx-hero-section {
-  padding: clamp(24px, 5vw, 48px) 0 clamp(20px, 4vw, 36px);
+  padding: clamp(24px, 4vw, 42px) 0 clamp(20px, 3vw, 32px);
   background: linear-gradient(180deg, #ffffff 0%, var(--nx-bg) 100%);
   border-bottom: 1px solid var(--nx-border);
-  margin-bottom: clamp(24px, 4vw, 40px);
+  margin-bottom: clamp(24px, 3vw, 36px);
 }
 
 [data-theme="dark"] .nx-hero-section {
   background: linear-gradient(180deg, #111827 0%, var(--nx-bg) 100%);
+}
+
+/* 2-Column Hero Grid: Left Content + Right Featured Article Card */
+.nx-hero-grid {
+  display: grid;
+  grid-template-columns: 1.15fr 0.85fr;
+  gap: clamp(24px, 4vw, 44px);
+  align-items: center;
+  max-width: var(--nx-max-width, 1200px);
+  margin: 0 auto;
+  padding: 0 clamp(16px, 3vw, 28px);
+}
+
+.nx-hero-content-col {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  min-width: 0;
 }
 
@@ -552 +592 @@
   background: var(--nx-primary-light);
   color: var(--nx-primary);
-  font-size: clamp(0.72rem, 2.5vw, 0.8rem);
+  font-size: clamp(0.7rem, 2vw, 0.76rem);
   font-weight: 700;
   text-transform: uppercase;
   letter-spacing: 0.05em;
   border-radius: 20px;
-  margin-bottom: 14px;
+  margin-bottom: 12px;
   max-width: 100%;
   word-break: break-word;
@@ -564 +604 @@
 
 .nx-hero-title {
-  font-size: clamp(1.55rem, 5vw + 0.5rem, 2.75rem);
+  font-size: clamp(1.35rem, 2.3vw, 2.05rem);
   font-weight: 800;
-  letter-spacing: -0.03em;
-  line-height: 1.2;
-  max-width: 850px;
-  margin-bottom: 14px;
+  letter-spacing: -0.025em;
+  line-height: 1.25;
+  max-width: 680px;
+  margin-top: 0;
+  margin-bottom: 12px;
   color: var(--nx-dark);
   word-break: break-word;
@@ -575 +616 @@
 
 .nx-hero-description {
-  font-size: clamp(0.92rem, 2.5vw, 1.15rem);
+  font-size: clamp(0.9rem, 1.8vw, 1.02rem);
   color: var(--nx-text-light);
-  max-width: 680px;
+  max-width: 600px;
   line-height: 1.6;
-  margin-bottom: 20px;
-}
-
-.nx-hero-btn {
+  margin-bottom: 16px;
+}
+
+.nx-hero-actions {
+  margin: 14px 0 20px;
+  padding-left: 1px;
+}
+
+.nx-hero-btn,
+.nx-hero-actions .wp-block-button__link {
+  display: inline-flex !important;
+  align-items: center !important;
+  gap: 7px !important;
+  padding: 9px 20px !important;
+  background-color: var(--nx-btn-bg, var(--nx-primary)) !important;
+  color: var(--nx-btn-text, #ffffff) !important;
+  border: 1px solid var(--nx-btn-bg, var(--nx-primary)) !important;
+  font-weight: 600 !important;
+  font-size: 0.88rem !important;
+  border-radius: 20px !important;
+  text-decoration: none !important;
+  box-shadow: 0 3px 10px rgba(79, 70, 229, 0.28) !important;
+  transition: all 0.2s ease !important;
+  cursor: pointer;
+  line-height: 1.3 !important;
+}
+
+.nx-hero-btn:hover,
+.nx-hero-actions .wp-block-button__link:hover {
+  background-color: var(--nx-btn-hover, var(--nx-primary-hover)) !important;
+  border-color: var(--nx-btn-hover, var(--nx-primary-hover)) !important;
+  color: var(--nx-btn-text, #ffffff) !important;
+  transform: translateY(-2px) !important;
+  box-shadow: 0 5px 16px rgba(79, 70, 229, 0.42) !important;
+}
+
+/* Hero Featured Article Card */
+.nx-hero-featured-col {
+  display: flex;
+  justify-content: center;
+  width: 100%;
+  min-width: 0;
+}
+
+.nx-hero-featured-card {
+  width: 100%;
+  max-width: 440px;
+  background: var(--nx-card-bg);
+  border: 1px solid var(--nx-border);
+  border-radius: var(--nx-radius, 14px);
+  box-shadow: 0 6px 24px rgba(0, 0, 0, 0.07);
+  overflow: hidden;
+  transition: transform 0.25s ease, box-shadow 0.25s ease, border-color 0.25s ease;
+  position: relative;
+  display: flex;
+  flex-direction: column;
+}
+
+.nx-hero-featured-card:hover {
+  transform: translateY(-4px);
+  box-shadow: 0 14px 34px rgba(0, 0, 0, 0.12);
+  border-color: var(--nx-primary-light, #c7d2fe);
+}
+
+[data-theme="dark"] .nx-hero-featured-card {
+  box-shadow: 0 6px 24px rgba(0, 0, 0, 0.4);
+}
+
+[data-theme="dark"] .nx-hero-featured-card:hover {
+  box-shadow: 0 14px 34px rgba(0, 0, 0, 0.6);
+}
+
+.nx-hero-card-badge-wrap {
+  position: absolute;
+  top: 12px;
+  left: 12px;
+  z-index: 2;
+}
+
+.nx-hero-card-featured-tag {
   display: inline-flex;
   align-items: center;
-  gap: 6px;
-  padding: 10px 22px;
-  background: var(--nx-primary);
-  color: #ffffff !important;
+  gap: 5px;
+  padding: 4px 10px;
+  background: rgba(15, 23, 42, 0.88);
+  color: #fbbf24;
+  font-size: 0.72rem;
   font-weight: 700;
-  font-size: 0.92rem;
-  border-radius: var(--nx-radius-sm);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  border-radius: 16px;
+  backdrop-filter: blur(6px);
+  box-shadow: 0 2px 6px rgba(0, 0, 0, 0.2);
+}
+
+.nx-hero-card-thumb-wrap {
+  position: relative;
+  display: block;
+  width: 100%;
+  height: 200px;
+  overflow: hidden;
+  background: var(--nx-card-bg-subtle, #f1f5f9);
+}
+
+.nx-hero-card-img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+  transition: transform 0.4s ease;
+}
+
+.nx-hero-featured-card:hover .nx-hero-card-img {
+  transform: scale(1.05);
+}
+
+.nx-hero-card-img-fallback {
+  width: 100%;
+  height: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: linear-gradient(135deg, rgba(79, 70, 229, 0.12) 0%, rgba(6, 182, 212, 0.12) 100%);
+  color: var(--nx-primary);
+}
+
+.nx-hero-card-body {
+  padding: 18px 20px 20px;
+  display: flex;
+  flex-direction: column;
+  flex-grow: 1;
+}
+
+.nx-hero-card-meta-top {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin-bottom: 8px;
+  font-size: 0.76rem;
+}
+
+.nx-hero-card-cat {
+  font-weight: 700;
+  color: var(--nx-primary);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
   text-decoration: none;
-  box-shadow: 0 4px 14px rgba(79, 70, 229, 0.3);
-  transition: all 0.25s ease;
-}
-
-.nx-hero-btn:hover {
-  background: var(--nx-primary-hover);
-  transform: translateY(-2px);
-  box-shadow: 0 6px 20px rgba(79, 70, 229, 0.45);
+}
+
+.nx-hero-card-cat:hover {
+  text-decoration: underline;
+}
+
+.nx-hero-card-time {
+  color: var(--nx-text-light);
+  font-weight: 500;
+}
+
+.nx-hero-card-title {
+  font-size: 1.12rem;
+  font-weight: 800;
+  line-height: 1.35;
+  margin: 0 0 8px 0;
+  color: var(--nx-dark);
+}
+
+.nx-hero-card-title a {
+  color: inherit;
+  text-decoration: none;
+  transition: color 0.2s ease;
+}
+
+.nx-hero-card-title a:hover {
+  color: var(--nx-primary);
+}
+
+.nx-hero-card-excerpt {
+  font-size: 0.86rem;
+  line-height: 1.5;
+  color: var(--nx-text-light);
+  margin: 0 0 14px 0;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+.nx-hero-card-footer {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding-top: 12px;
+  border-top: 1px solid var(--nx-border);
+  margin-top: auto;
+  font-size: 0.8rem;
+}
+
+.nx-hero-card-author {
+  display: flex;
+  align-items: center;
+  gap: 7px;
+  color: var(--nx-dark);
+  font-weight: 600;
+}
+
+.nx-hero-card-avatar {
+  width: 22px;
+  height: 22px;
+  border-radius: 50%;
+}
+
+.nx-hero-card-read-link {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  color: var(--nx-primary);
+  font-weight: 700;
+  text-decoration: none;
+  font-size: 0.82rem;
+  transition: transform 0.2s ease;
+}
+
+.nx-hero-card-read-link:hover {
+  transform: translateX(3px);
+}
+
+@media (max-width: 900px) {
+  .nx-hero-grid {
+    grid-template-columns: 1fr;
+    gap: 28px;
+  }
+
+  .nx-hero-featured-card {
+    max-width: 100%;
+  }
+
+  .nx-hero-card-thumb-wrap {
+    height: 180px;
+  }
 }
 
@@ -648 +907 @@
 
 /* Layout Grid (Main Content + Sidebar) */
-.nx-layout-grid {
+.nx-layout-grid,
+.site-container {
   display: grid;
   grid-template-columns: 1fr;
   gap: 36px;
   margin-bottom: 60px;
+  align-items: start;
+  width: 100%;
 }
 
 @media (min-width: 992px) {
-  .nx-layout-grid {
+  .nx-layout-grid,
+  .site-container {
     grid-template-columns: 2.2fr 1fr;
   }
 }
 
-/* Post Cards Grid */
-.nx-posts-grid {
+.nx-content-area,
+.content-area {
+  min-width: 0;
+  width: 100%;
+}
+
+/* ==========================================================================
+   Article Grid System (3 Columns with Sidebar, 4 Columns without Sidebar)
+   ========================================================================== */
+
+/* 1. Default (With Sidebar Active): 1-col on mobile, 2-col on tablet, 3-col on desktop */
+.nx-posts-grid,
+.posts-grid {
   display: grid;
   grid-template-columns: 1fr;
   gap: 20px;
-}
-
-@media (min-width: 640px) {
-  .nx-posts-grid {
+  width: 100%;
+}
+
+@media (min-width: 600px) {
+  .nx-posts-grid,
+  .posts-grid {
     grid-template-columns: repeat(2, 1fr);
-  }
+    gap: 20px;
+  }
+}
+
+/* On Desktop when Sidebar is present: 3 articles in a row */
+@media (min-width: 992px) {
+  .nx-posts-grid,
+  .posts-grid {
+    grid-template-columns: repeat(3, 1fr);
+    gap: 20px;
+  }
+}
+
+/* 2. Without Sidebar (Disabled via Page Settings or no active sidebar): 4 articles in a row on Desktop! */
+@media (min-width: 1080px) {
+  .nx-no-sidebar .nx-posts-grid,
+  .nx-no-sidebar .posts-grid,
+  .nx-layout-grid:not(:has(.site-sidebar)) .nx-posts-grid,
+  .nx-layout-grid:not(:has(.site-sidebar)) .posts-grid,
+  .nx-layout-contained .nx-posts-grid,
+  .nx-layout-contained .posts-grid,
+  .nx-layout-stretched .nx-posts-grid,
+  .nx-layout-stretched .posts-grid {
+    grid-template-columns: repeat(4, 1fr) !important;
+    gap: 22px !important;
+  }
+}
+
+@media (min-width: 768px) and (max-width: 1079px) {
+  .nx-no-sidebar .nx-posts-grid,
+  .nx-no-sidebar .posts-grid,
+  .nx-layout-grid:not(:has(.site-sidebar)) .nx-posts-grid,
+  .nx-layout-grid:not(:has(.site-sidebar)) .posts-grid,
+  .nx-layout-contained .nx-posts-grid,
+  .nx-layout-contained .posts-grid,
+  .nx-layout-stretched .nx-posts-grid,
+  .nx-layout-stretched .posts-grid {
+    grid-template-columns: repeat(3, 1fr) !important;
+    gap: 20px !important;
+  }
+}
+
+@media (min-width: 520px) and (max-width: 767px) {
+  .nx-no-sidebar .nx-posts-grid,
+  .nx-no-sidebar .posts-grid,
+  .nx-layout-grid:not(:has(.site-sidebar)) .nx-posts-grid,
+  .nx-layout-grid:not(:has(.site-sidebar)) .posts-grid,
+  .nx-layout-contained .nx-posts-grid,
+  .nx-layout-contained .posts-grid,
+  .nx-layout-stretched .nx-posts-grid,
+  .nx-layout-stretched .posts-grid {
+    grid-template-columns: repeat(2, 1fr) !important;
+    gap: 18px !important;
+  }
+}
+
+/* 4-Column Post Cards Grid (for Blog page / full-width archives) */
+.nx-posts-grid-4col {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: 20px;
+  width: 100%;
+}
+
+@media (min-width: 520px) {
+  .nx-posts-grid-4col {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}
+
+@media (min-width: 768px) {
+  .nx-posts-grid-4col {
+    grid-template-columns: repeat(3, 1fr);
+  }
+}
+
+@media (min-width: 1080px) {
+  .nx-posts-grid-4col {
+    grid-template-columns: repeat(4, 1fr);
+  }
+}
+
+/* Contact Information Details */
+.nx-contact-details {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+  margin-top: 18px;
+}
+
+.nx-contact-item {
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+}
+
+.nx-contact-label {
+  font-size: 0.8rem !important;
+  font-weight: 700 !important;
+  color: var(--nx-text-light) !important;
+  text-transform: uppercase !important;
+  letter-spacing: 0.05em !important;
+  margin-bottom: 2px !important;
+}
+
+.nx-contact-val {
+  font-weight: 600;
+  font-size: 0.95rem;
+  color: var(--nx-dark);
+  margin-top: 0 !important;
+  margin-bottom: 0 !important;
+}
+
+.nx-contact-val a {
+  color: var(--nx-primary);
+  text-decoration: none;
+}
+
+.nx-contact-val a:hover {
+  text-decoration: underline;
 }
 
@@ -694 +1089 @@
   overflow: hidden;
   aspect-ratio: 16 / 9;
-  max-height: 155px;
+  max-height: 120px;
   background: #e2e8f0;
 }
@@ -708 +1103 @@
   width: 100%;
   height: 100%;
-  min-height: 135px;
+  min-height: 105px;
   background: linear-gradient(135deg, #4f46e5 0%, #06b6d4 100%);
   display: flex;
@@ -714 +1109 @@
   justify-content: center;
   color: #ffffff;
-  font-size: 1.5rem;
+  font-size: 1.4rem;
   font-weight: 800;
   letter-spacing: -0.05em;
@@ -725 +1120 @@
 
 .nx-card-body {
-  padding: 16px 18px;
+  padding: 13px 15px;
   display: flex;
   flex-direction: column;
@@ -733 +1128 @@
 .nx-category-badge {
   display: inline-block;
-  padding: 2px 8px;
+  padding: 2px 7px;
   background: var(--nx-primary-light);
   color: var(--nx-primary);
-  font-size: 0.7rem;
+  font-size: 0.68rem;
   font-weight: 700;
   text-transform: uppercase;
   letter-spacing: 0.05em;
   border-radius: 4px;
-  margin-bottom: 8px;
+  margin-bottom: 6px;
   align-self: flex-start;
 }
 
 .nx-card-title {
-  font-size: 1.05rem;
+  font-size: 0.96rem;
   font-weight: 700;
-  line-height: 1.35;
-  margin-bottom: 8px;
+  line-height: 1.32;
+  margin-bottom: 6px;
 }
 
@@ -761 +1156 @@
 
 .nx-card-excerpt {
-  font-size: 0.85rem;
+  font-size: 0.8rem;
   color: var(--nx-text-light);
-  line-height: 1.5;
-  margin-bottom: 12px;
+  line-height: 1.45;
+  margin-bottom: 8px;
   flex-grow: 1;
   display: -webkit-box;
   -webkit-line-clamp: 2;
+  line-clamp: 2;
   -webkit-box-orient: vertical;
   overflow: hidden;
@@ -777 +1173 @@
   justify-content: space-between;
   border-top: 1px solid var(--nx-border);
-  padding-top: 10px;
-  font-size: 0.75rem;
+  padding-top: 8px;
+  margin-top: auto;
+  font-size: 0.72rem;
   color: var(--nx-text-light);
 }
@@ -801 +1198 @@
 
 .nx-card-action {
-  margin-top: 10px;
-  padding-top: 8px;
-  border-top: 1px dashed var(--nx-border);
-  display: flex;
-  align-items: center;
-  justify-content: flex-end;
+  display: none !important;
 }
 
@@ -1288 +1680 @@
 }
 
-.nx-btn {
-  display: inline-block;
+/* ==========================================================================
+   Universal Buttons Styling (Site-wide, Hero, Cards, Blocks, Forms)
+   ========================================================================== */
+.nx-btn,
+.nx-hero-btn,
+.nx-btn-primary,
+.nx-card-cta,
+.nx-newsletter-btn,
+.nx-contact-submit,
+.wp-block-button__link,
+.wp-element-button,
+button[type="submit"],
+input[type="submit"],
+.comment-form .submit,
+#commentform #submit,
+.search-submit {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
   padding: 12px 28px;
-  background: var(--nx-primary);
-  color: #ffffff;
+  background-color: var(--nx-btn-bg, var(--nx-primary)) !important;
+  color: var(--nx-btn-text, #ffffff) !important;
+  border: 1px solid var(--nx-btn-bg, var(--nx-primary)) !important;
   border-radius: 30px;
   font-weight: 600;
   font-size: 0.95rem;
-  transition: background 0.2s;
-}
-
-.nx-btn:hover {
-  background: var(--nx-primary-hover);
-  color: #ffffff;
+  text-decoration: none;
+  cursor: pointer;
+  transition: all 0.25s ease;
+}
+
+.nx-btn:hover,
+.nx-hero-btn:hover,
+.nx-btn-primary:hover,
+.nx-card-cta:hover,
+.nx-newsletter-btn:hover,
+.nx-contact-submit:hover,
+.wp-block-button__link:hover,
+.wp-element-button:hover,
+button[type="submit"]:hover,
+input[type="submit"]:hover,
+.comment-form .submit:hover,
+#commentform #submit:hover,
+.search-submit:hover {
+  background-color: var(--nx-btn-hover, var(--nx-primary-hover)) !important;
+  border-color: var(--nx-btn-hover, var(--nx-primary-hover)) !important;
+  color: var(--nx-btn-text, #ffffff) !important;
+  transform: translateY(-2px);
 }
 
@@ -1442 +1868 @@
 .footer-bottom {
   padding-top: 28px;
-  display: flex;
-  flex-direction: column;
-  justify-content: center;
-  align-items: center;
-  text-align: center;
+  display: flex !important;
+  flex-direction: column !important;
+  justify-content: center !important;
+  align-items: center !important;
+  text-align: center !important;
   font-size: 0.88rem;
   gap: 12px;
   color: #64748b !important;
+  width: 100%;
 }
 
@@ -1456 +1883 @@
 .footer-bottom-content {
   color: #64748b !important;
-  margin: 0;
-  text-align: center;
+  margin: 0 auto !important;
+  text-align: center !important;
+  width: 100%;
+  display: flex;
+  justify-content: center;
+  align-items: center;
 }
 
 .nx-footer-credits {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  flex-wrap: wrap;
-  gap: 8px;
-  line-height: 1.6;
+  display: flex !important;
+  align-items: center !important;
+  justify-content: center !important;
+  flex-wrap: wrap !important;
+  gap: 8px !important;
+  line-height: 1.6 !important;
+  text-align: center !important;
+  margin: 0 auto !important;
 }
 
@@ -2161 +2594 @@
   }
 
+  .custom-logo-link img,
+  .custom-logo {
+    max-height: 30px !important;
+    max-width: 150px !important;
+  }
+
   .header-actions {
     gap: 6px;
@@ -2473 +2912 @@
 }
 
-.nx-ad-header {
-  margin: 12px auto;
+/* Bounding Box Base for Zero Cumulative Layout Shift (CLS = 0) */
+.nx-ad-slot-cls {
+  contain: layout;
+}
+
+.nx-ad-bounding-box {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  margin: 0 auto;
+  overflow: hidden;
+  border-radius: 8px;
+  background-color: transparent;
+  border: none;
+  box-sizing: border-box;
+}
+
+[data-theme="dark"] .nx-ad-bounding-box,
+body.dark-mode .nx-ad-bounding-box {
+  background-color: transparent;
+  border-color: transparent;
+}
+
+/* Ad Loaded State */
+.nx-ad-bounding-box.nx-ad-loaded {
+  background-color: transparent !important;
+  border-color: transparent !important;
+}
+
+/* Slot 1: Header Banner (728x90 Leaderboard / 320x100 Mobile) */
+.nx-ad-box-header {
+  width: 728px;
+  max-width: 100%;
+  min-height: 90px;
+  aspect-ratio: 728 / 90;
+}
+@media (max-width: 767px) {
+  .nx-ad-box-header {
+    width: 100%;
+    max-width: 320px;
+    min-height: 100px;
+    aspect-ratio: 320 / 100;
+  }
+}
+
+/* Slot 2: In-Article Mid-Content (336x280 / 300x250) */
+.nx-ad-box-article {
+  width: 336px;
+  max-width: 100%;
+  min-height: 280px;
+  aspect-ratio: 336 / 280;
+  margin: 28px auto;
+}
+@media (max-width: 767px) {
+  .nx-ad-box-article {
+    width: 300px;
+    max-width: 100%;
+    min-height: 250px;
+    aspect-ratio: 300 / 250;
+  }
+}
+
+/* Slot 3: Below Post Content (336x280 / 300x250) */
+.nx-ad-box-post_bottom {
+  width: 336px;
+  max-width: 100%;
+  min-height: 280px;
+  aspect-ratio: 336 / 280;
+  margin: 32px auto 24px auto;
+}
+@media (max-width: 767px) {
+  .nx-ad-box-post_bottom {
+    width: 300px;
+    max-width: 100%;
+    min-height: 250px;
+    aspect-ratio: 300 / 250;
+  }
+}
+
+/* Slot 4: In-Feed Grid Card (360x360 1:1 Aspect Ratio) */
+.nx-ad-box-infeed {
+  width: 100%;
+  min-height: 340px;
+  aspect-ratio: 1 / 1;
+}
+.nx-infeed-ad-card {
   padding: 16px;
-  background: var(--nx-card-bg);
-  border: 1px dashed var(--nx-border);
-  border-radius: var(--nx-radius-sm);
-}
-
-.nx-ad-article {
-  margin: 32px auto;
-  padding: 20px;
-  background: var(--nx-bg);
-  border: 1px dashed var(--nx-border);
-  border-radius: var(--nx-radius-sm);
-}
-
-.nx-ad-post_bottom {
-  margin: 32px 0 24px 0;
-  padding: 20px;
-  background: var(--nx-bg);
-  border: 1px dashed var(--nx-border);
-  border-radius: var(--nx-radius-sm);
-}
-
-.nx-infeed-ad-card {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  justify-content: center;
-  min-height: 280px;
-  padding: 24px;
-  background: var(--nx-card-bg);
-  border: 1px dashed var(--nx-border);
-  border-radius: var(--nx-radius);
-  text-align: center;
-  box-shadow: var(--nx-shadow-sm);
-}
-
-.nx-infeed-ad-card .nx-ad-slot {
-  margin: 0;
-  width: 100%;
-}
-
+  border: 1px solid var(--nx-border, #e2e8f0);
+  background: var(--nx-card-bg, #ffffff);
+  border-radius: var(--nx-radius, 12px);
+  box-shadow: var(--nx-shadow-sm, 0 1px 3px rgba(0,0,0,0.06));
+}
+@media (max-width: 767px) {
+  .nx-ad-box-infeed {
+    min-height: 280px;
+  }
+}
+
+/* Slot 5: Sticky Half-Page Sidebar (300x600 / 300x250) */
+.nx-ad-box-sidebar {
+  width: 300px;
+  max-width: 100%;
+  min-height: 600px;
+  aspect-ratio: 300 / 600;
+}
 .nx-sidebar-sticky-ad {
   position: sticky;
   top: 90px;
   z-index: 5;
-  margin-top: 24px;
-  background: var(--nx-card-bg);
+}
+@media (max-width: 767px) {
+  .nx-ad-box-sidebar {
+    width: 300px;
+    max-width: 100%;
+    min-height: 250px;
+    aspect-ratio: 300 / 250;
+  }
+}
+
+@keyframes nxAdShimmer {
+  0% { background-position: 200% 0; }
+  100% { background-position: -200% 0; }
+}
+
+.nx-ad-blocker-bypass {
+  width: 100%;
+  text-align: center;
+  padding: 18px 20px;
+  background: var(--nx-bg);
   border: 1px dashed var(--nx-border);
   border-radius: var(--nx-radius-sm);
-  padding: 16px !important;
-  text-align: center;
-}
-
-.nx-sidebar-sticky-ad .nx-ad-slot {
-  margin: 0;
-}
-
-[data-theme="dark"] .nx-ad-header,
-[data-theme="dark"] .nx-ad-article,
-[data-theme="dark"] .nx-ad-post_bottom,
-[data-theme="dark"] .nx-infeed-ad-card,
-[data-theme="dark"] .nx-sidebar-sticky-ad {
+  animation: nxFadeSlideIn 0.3s ease;
+}
+
+[data-theme="dark"] .nx-ad-blocker-bypass {
   background: #111827;
   border-color: #1f2937;
+}
+
+.nx-ad-blocker-bypass img {
+  max-width: 100%;
+  height: auto;
+  border-radius: var(--nx-radius-sm);
 }
 
@@ -2642 +3159 @@
 }
 
-
-
-
-
+/* ==========================================================================
+   Page Flexibility: Astra-Style Layouts & Element Toggles
+   ========================================================================== */
+
+/* Disable Sidebar (Force 100% Content Width) */
+.nx-no-sidebar .nx-layout-grid,
+.nx-layout-grid:not(:has(.site-sidebar)) {
+  grid-template-columns: 1fr !important;
+}
+
+.nx-no-sidebar .nx-content-area,
+.nx-layout-grid:not(:has(.site-sidebar)) .nx-content-area {
+  max-width: 100% !important;
+  width: 100% !important;
+}
+
+/* Full Width (Contained): Outer wrapper expands, content remains safely contained & padded */
+.nx-layout-contained .site-main.container,
+.nx-layout-contained .container {
+  max-width: 100% !important;
+  width: 100% !important;
+  padding-left: clamp(16px, 3.5vw, 36px) !important;
+  padding-right: clamp(16px, 3.5vw, 36px) !important;
+}
+
+.nx-layout-contained .nx-single-article,
+.nx-layout-contained .nx-page-card {
+  max-width: min(100%, var(--nx-max-width, 1200px)) !important;
+  margin-left: auto !important;
+  margin-right: auto !important;
+  padding: clamp(24px, 4vw, 44px) !important;
+}
+
+/* Full Width Stretched (Canvas / Elementor & Landing Pages) */
+/* Container expands to 100% viewport width with safe horizontal breathing gutters */
+.nx-layout-stretched .site-main.container,
+.nx-layout-stretched .container {
+  max-width: 100% !important;
+  width: 100% !important;
+  padding-left: clamp(16px, 3.5vw, 40px) !important;
+  padding-right: clamp(16px, 3.5vw, 40px) !important;
+  margin-left: auto !important;
+  margin-right: auto !important;
+}
+
+.nx-layout-stretched .site-main {
+  margin-top: 24px !important;
+  margin-bottom: 40px !important;
+}
+
+.nx-layout-stretched .nx-layout-grid {
+  grid-template-columns: 1fr !important;
+  gap: 0 !important;
+  width: 100% !important;
+}
+
+.nx-layout-stretched .nx-content-area {
+  max-width: 100% !important;
+  width: 100% !important;
+}
+
+/* Standard Posts & Pages in Stretched Mode: Keep comfortable reading container so text never smashes screen edges */
+.nx-layout-stretched .nx-single-article,
+.nx-layout-stretched .nx-page-card {
+  background: var(--nx-card-bg);
+  border: 1px solid var(--nx-border);
+  border-radius: var(--nx-radius);
+  padding: clamp(24px, 4vw, 48px) !important;
+  max-width: min(100%, var(--nx-max-width, 1200px));
+  margin-left: auto !important;
+  margin-right: auto !important;
+  box-shadow: var(--nx-shadow-sm);
+}
+
+/* Pure Page Builders (Elementor, Beaver Builder, or Gutenberg Full-Bleed Blocks) */
+/* When an Elementor section or full-bleed block exists, remove container constraints completely */
+.nx-layout-stretched .elementor,
+.nx-layout-stretched .entry-content:has(.elementor),
+.nx-layout-stretched .nx-single-article:has(.elementor),
+.nx-layout-stretched .nx-page-card:has(.elementor) {
+  background: transparent !important;
+  border: none !important;
+  border-radius: 0 !important;
+  padding: 0 !important;
+  max-width: 100% !important;
+  box-shadow: none !important;
+}
+
+.nx-layout-stretched:has(.elementor) .site-main.container,
+.nx-layout-stretched:has(.elementor) .container {
+  padding-left: 0 !important;
+  padding-right: 0 !important;
+}
+
+/* Gutenberg alignfull breakout support */
+.nx-layout-stretched .alignfull,
+.nx-layout-contained .alignfull {
+  width: 100vw !important;
+  max-width: 100vw !important;
+  margin-left: calc(50% - 50vw) !important;
+  margin-right: calc(50% - 50vw) !important;
+}
+
+/* ==========================================================================
+   Popular Categories Grid (Image 4 Design)
+   ========================================================================== */
+.nx-categories-browse-all {
+  font-size: 0.92rem;
+  font-weight: 700;
+  color: var(--nx-text-light);
+  text-decoration: none;
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  transition: color 0.2s ease, transform 0.2s ease;
+}
+
+.nx-categories-browse-all:hover {
+  color: var(--nx-primary);
+  transform: translateX(3px);
+}
+
+.nx-popular-categories-grid {
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: 18px;
+  width: 100%;
+}
+
+@media (max-width: 1080px) {
+  .nx-popular-categories-grid {
+    grid-template-columns: repeat(3, 1fr);
+  }
+}
+
+@media (max-width: 768px) {
+  .nx-popular-categories-grid {
+    grid-template-columns: repeat(2, 1fr);
+    gap: 14px;
+  }
+}
+
+@media (max-width: 480px) {
+  .nx-popular-categories-grid {
+    grid-template-columns: 1fr;
+  }
+}
+
+.nx-pop-cat-card {
+  display: flex;
+  flex-direction: column;
+  background: var(--nx-card-bg);
+  border: 1px solid var(--nx-border);
+  border-radius: var(--nx-radius);
+  padding: 22px 20px;
+  text-decoration: none;
+  transition: transform 0.2s ease, border-color 0.2s ease, box-shadow 0.2s ease;
+}
+
+[data-theme="dark"] .nx-pop-cat-card {
+  background: #111827;
+  border-color: rgba(255, 255, 255, 0.08);
+}
+
+.nx-pop-cat-card:hover {
+  transform: translateY(-3px);
+  border-color: var(--nx-primary);
+  box-shadow: var(--nx-shadow-md);
+}
+
+.nx-pop-cat-icon {
+  width: 36px;
+  height: 36px;
+  border-radius: 8px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: #ffffff;
+  font-weight: 800;
+  font-size: 1.15rem;
+  line-height: 1;
+  margin-bottom: 14px;
+}
+
+.nx-pop-cat-name {
+  font-size: 1.02rem;
+  font-weight: 800;
+  color: var(--nx-dark);
+  margin: 0 0 8px 0;
+  line-height: 1.3;
+}
+
+[data-theme="dark"] .nx-pop-cat-name {
+  color: #ffffff;
+}
+
+.nx-pop-cat-desc {
+  font-size: 0.82rem;
+  color: var(--nx-text-light);
+  line-height: 1.5;
+  margin: 0 0 14px 0;
+  flex-grow: 1;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+.nx-pop-cat-count {
+  font-size: 0.78rem;
+  font-weight: 600;
+  color: var(--nx-text-light);
+  margin-top: auto;
+}
+
+/* ==========================================================================
+   Homepage Author Box (Image 3 Design)
+   ========================================================================== */
+.nx-home-author-card {
+  display: flex;
+  align-items: center;
+  gap: 22px;
+  background: var(--nx-card-bg);
+  border: 1px solid var(--nx-border);
+  border-radius: var(--nx-radius);
+  padding: 24px 28px;
+  box-shadow: var(--nx-shadow-sm);
+}
+
+[data-theme="dark"] .nx-home-author-card {
+  background: #111827;
+  border-color: rgba(255, 255, 255, 0.08);
+}
+
+.nx-author-avatar-wrap {
+  flex-shrink: 0;
+}
+
+.nx-author-avatar-link {
+  display: block;
+  text-decoration: none;
+  cursor: pointer;
+  transition: transform 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+.nx-author-avatar-link:hover {
+  transform: scale(1.06);
+}
+
+.nx-author-avatar-circle {
+  width: 62px;
+  height: 62px;
+  border-radius: 50%;
+  background: linear-gradient(135deg, #6366f1 0%, #a855f7 100%);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: #ffffff;
+  font-size: 1.7rem;
+  font-weight: 800;
+  box-shadow: 0 4px 14px rgba(99, 102, 241, 0.35);
+  overflow: hidden;
+  position: relative;
+}
+
+.nx-author-avatar-img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  border-radius: 50%;
+  display: block;
+}
+
+.nx-author-avatar-initial {
+  line-height: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  user-select: none;
+}
+
+.nx-author-name {
+  font-size: 1.15rem;
+  font-weight: 800;
+  color: var(--nx-dark);
+  margin: 0 0 2px 0;
+}
+
+.nx-author-name-link {
+  color: inherit;
+  text-decoration: none;
+  cursor: pointer;
+  display: inline-block;
+  transition: color 0.2s ease;
+}
+
+.nx-author-name-link:hover {
+  color: var(--nx-primary, #4f46e5);
+  text-decoration: none;
+}
+
+[data-theme="dark"] .nx-author-name {
+  color: #ffffff;
+}
+
+[data-theme="dark"] .nx-author-name-link:hover {
+  color: #818cf8;
+}
+
+.nx-author-role {
+  font-size: 0.85rem;
+  font-weight: 700;
+  color: #8b5cf6;
+  margin-bottom: 6px;
+}
+
+.nx-author-role-link {
+  color: #8b5cf6;
+  text-decoration: none;
+  cursor: pointer;
+  display: inline-block;
+  transition: color 0.2s ease, opacity 0.2s ease;
+}
+
+.nx-author-role-link:hover {
+  color: #7c3aed;
+  text-decoration: underline;
+}
+
+[data-theme="dark"] .nx-author-role-link {
+  color: #a78bfa;
+}
+
+[data-theme="dark"] .nx-author-role-link:hover {
+  color: #c084fc;
+}
+
+.nx-author-bio {
+  font-size: 0.9rem;
+  color: var(--nx-text-light);
+  line-height: 1.5;
+  margin: 0;
+}
+
+@media (max-width: 600px) {
+  .nx-home-author-card {
+    flex-direction: column;
+    text-align: center;
+    padding: 24px 20px;
+    gap: 16px;
+  }
+}
+
+/* ==========================================================================
+   Newsletter Box v2 (Adaptive Theme: Light White on Sun / Sleek Dark on Moon)
+   ========================================================================== */
+.nx-newsletter-v2 {
+  background: var(--nx-card-bg, #ffffff);
+  border: 1px solid var(--nx-border, #e2e8f0);
+  border-radius: 16px;
+  padding: clamp(28px, 4vw, 42px);
+  box-shadow: var(--nx-shadow-sm, 0 1px 3px rgba(0, 0, 0, 0.05));
+  display: grid;
+  grid-template-columns: 1.1fr 0.9fr;
+  align-items: center;
+  gap: 32px;
+  transition: background 0.3s ease, border-color 0.3s ease, box-shadow 0.3s ease;
+}
+
+[data-theme="dark"] .nx-newsletter-v2 {
+  background: linear-gradient(135deg, #090d16 0%, #111827 50%, #1e1b4b 100%) !important;
+  border-color: rgba(255, 255, 255, 0.09) !important;
+  box-shadow: 0 10px 30px rgba(0, 0, 0, 0.35) !important;
+}
+
+@media (max-width: 900px) {
+  .nx-newsletter-v2 {
+    grid-template-columns: 1fr;
+    gap: 24px;
+  }
+}
+
+.nx-newsletter-badge-v2 {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 3px 10px;
+  background: var(--nx-primary-light, #eef2ff);
+  color: var(--nx-primary, #4f46e5);
+  border: 1px solid rgba(79, 70, 229, 0.15);
+  border-radius: 20px;
+  font-size: 0.72rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  margin-bottom: 12px;
+  transition: background 0.3s ease, color 0.3s ease, border-color 0.3s ease;
+}
+
+[data-theme="dark"] .nx-newsletter-badge-v2 {
+  background: rgba(255, 255, 255, 0.08) !important;
+  color: #cbd5e1 !important;
+  border-color: rgba(255, 255, 255, 0.12) !important;
+}
+
+.nx-newsletter-title-v2 {
+  font-size: clamp(1.45rem, 2.5vw, 2.1rem);
+  font-weight: 800;
+  color: var(--nx-dark, #0f172a);
+  margin: 0 0 10px 0;
+  line-height: 1.25;
+  letter-spacing: -0.02em;
+  transition: color 0.3s ease;
+}
+
+[data-theme="dark"] .nx-newsletter-title-v2 {
+  color: #ffffff !important;
+}
+
+.nx-nl-highlight {
+  color: var(--nx-primary, #4f46e5);
+  transition: color 0.3s ease;
+}
+
+[data-theme="dark"] .nx-nl-highlight {
+  color: #c084fc !important;
+}
+
+.nx-newsletter-desc-v2 {
+  font-size: 0.92rem;
+  color: var(--nx-text-light, #64748b);
+  line-height: 1.55;
+  margin: 0;
+  transition: color 0.3s ease;
+}
+
+[data-theme="dark"] .nx-newsletter-desc-v2 {
+  color: #94a3b8 !important;
+}
+
+.nx-newsletter-form-v2 {
+  width: 100%;
+}
+
+.nx-nl-input-wrap {
+  display: flex;
+  align-items: center;
+  background: #f8fafc;
+  border: 1px solid var(--nx-border, #e2e8f0);
+  border-radius: 12px;
+  padding: 6px 6px 6px 14px;
+  transition: background 0.3s ease, border-color 0.2s ease, box-shadow 0.2s ease;
+}
+
+[data-theme="dark"] .nx-nl-input-wrap {
+  background: rgba(15, 23, 42, 0.85) !important;
+  border-color: rgba(255, 255, 255, 0.14) !important;
+}
+
+.nx-nl-input-wrap:focus-within {
+  border-color: var(--nx-primary, #4f46e5);
+  box-shadow: 0 0 0 3px rgba(79, 70, 229, 0.15);
+}
+
+[data-theme="dark"] .nx-nl-input-wrap:focus-within {
+  border-color: #818cf8 !important;
+  box-shadow: 0 0 0 3px rgba(129, 140, 248, 0.25) !important;
+}
+
+.nx-nl-input-icon {
+  color: #94a3b8;
+  display: flex;
+  align-items: center;
+  margin-right: 10px;
+  flex-shrink: 0;
+  transition: color 0.3s ease;
+}
+
+[data-theme="dark"] .nx-nl-input-icon {
+  color: #64748b !important;
+}
+
+.nx-nl-email-input {
+  background: transparent !important;
+  border: none !important;
+  color: var(--nx-dark, #0f172a);
+  font-size: 0.95rem;
+  width: 100%;
+  outline: none !important;
+  padding: 8px 4px !important;
+  transition: color 0.3s ease;
+}
+
+[data-theme="dark"] .nx-nl-email-input {
+  color: #ffffff !important;
+}
+
+.nx-nl-email-input::placeholder {
+  color: #94a3b8;
+}
+
+[data-theme="dark"] .nx-nl-email-input::placeholder {
+  color: #64748b !important;
+}
+
+.nx-nl-submit-btn {
+  background: linear-gradient(135deg, #4f46e5 0%, #7c3aed 100%) !important;
+  color: #ffffff !important;
+  border: none !important;
+  border-radius: 8px !important;
+  padding: 10px 22px !important;
+  font-weight: 700 !important;
+  font-size: 0.92rem !important;
+  cursor: pointer;
+  white-space: nowrap;
+  transition: transform 0.15s ease, opacity 0.2s ease, box-shadow 0.2s ease;
+  box-shadow: 0 2px 8px rgba(79, 70, 229, 0.3);
+}
+
+.nx-nl-submit-btn:hover {
+  transform: translateY(-1px);
+  opacity: 0.95;
+  box-shadow: 0 4px 12px rgba(79, 70, 229, 0.4);
+}
+
+/* Newsletter Success State Card (When Subscribed or Logged In) */
+.nx-nl-success-card {
+  background: #f0fdf4;
+  border: 1px solid rgba(16, 185, 129, 0.35);
+  border-radius: 14px;
+  padding: 20px 24px;
+  transition: background 0.3s ease, border-color 0.3s ease, box-shadow 0.3s ease;
+  box-shadow: 0 2px 8px rgba(16, 185, 129, 0.08);
+  animation: nxFadeSlideIn 0.35s ease-out;
+}
+
+[data-theme="dark"] .nx-nl-success-card {
+  background: linear-gradient(135deg, rgba(6, 78, 59, 0.25) 0%, rgba(15, 23, 42, 0.7) 100%) !important;
+  border-color: rgba(52, 211, 153, 0.28) !important;
+  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.35) !important;
+}
+
+.nx-nl-success-title {
+  font-size: 1.1rem;
+  font-weight: 800;
+  color: #059669;
+  margin: 0 0 6px 0;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  line-height: 1.3;
+  letter-spacing: -0.01em;
+}
+
+[data-theme="dark"] .nx-nl-success-title {
+  color: #34d399 !important;
+}
+
+.nx-nl-success-desc {
+  font-size: 0.92rem;
+  color: #475569;
+  line-height: 1.5;
+  margin: 0;
+}
+
+[data-theme="dark"] .nx-nl-success-desc {
+  color: #94a3b8 !important;
+}
+
+@keyframes nxFadeSlideIn {
+  from {
+    opacity: 0;
+    transform: translateY(6px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+/* ==========================================================================
+   Smart Social Media Icon Buttons (Follow Us Online)
+   ========================================================================== */
+.nx-contact-social-icons {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+  align-items: center;
+}
+
+.nx-social-icon-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 38px;
+  height: 38px;
+  border-radius: 50%;
+  background: var(--nx-light);
+  border: 1px solid var(--nx-border);
+  color: var(--nx-dark);
+  text-decoration: none;
+  transition: all 0.25s ease;
+}
+
+[data-theme="dark"] .nx-social-icon-btn {
+  background: rgba(255, 255, 255, 0.05);
+  border-color: rgba(255, 255, 255, 0.1);
+  color: #ffffff;
+}
+
+.nx-social-icon-btn svg {
+  width: 17px;
+  height: 17px;
+  fill: currentColor;
+  transition: transform 0.2s ease;
+}
+
+.nx-social-icon-btn:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.14);
+}
+
+.nx-social-icon-btn.nx-social-facebook:hover {
+  background: #1877f2 !important;
+  border-color: #1877f2 !important;
+  color: #ffffff !important;
+}
+
+.nx-social-icon-btn.nx-social-twitter:hover {
+  background: #000000 !important;
+  border-color: #000000 !important;
+  color: #ffffff !important;
+}
+
+.nx-social-icon-btn.nx-social-linkedin:hover {
+  background: #0a66c2 !important;
+  border-color: #0a66c2 !important;
+  color: #ffffff !important;
+}
+
+.nx-social-icon-btn.nx-social-instagram:hover {
+  background: radial-gradient(circle at 30% 107%, #fdf497 0%, #fdf497 5%, #fd5949 45%, #d6249f 60%, #285AEB 90%) !important;
+  border-color: #d6249f !important;
+  color: #ffffff !important;
+}
+
+.nx-social-icon-btn.nx-social-youtube:hover {
+  background: #ff0000 !important;
+  border-color: #ff0000 !important;
+  color: #ffffff !important;
+}
+
+.nx-social-icon-btn.nx-social-github:hover {
+  background: #24292e !important;
+  border-color: #24292e !important;
+  color: #ffffff !important;
+}
+
+.nx-social-icon-btn.nx-social-discord:hover {
+  background: #5865f2 !important;
+  border-color: #5865f2 !important;
+  color: #ffffff !important;
+}
+
+.nx-social-icon-btn.nx-social-telegram:hover {
+  background: #229ed9 !important;
+  border-color: #229ed9 !important;
+  color: #ffffff !important;
+}
+
+.nx-social-icon-btn.nx-social-tiktok:hover {
+  background: #010101 !important;
+  border-color: #010101 !important;
+  color: #ffffff !important;
+}
+
+.nx-social-icon-btn.nx-social-website:hover {
+  background: var(--nx-primary) !important;
+  border-color: var(--nx-primary) !important;
+  color: #ffffff !important;
+}
+
+
+
+
+
+

nexversal/3.5.9/template-full-width.php

@@ -1 +1 @@
 <?php
-/**
- * Security: Prevent direct script access
- */
-if (!defined('ABSPATH')) {
-    exit;
-}
-
 /**
  * Template Name: Full Width (No Sidebar)
  *
  * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
+if (!defined('ABSPATH')) {
+    exit;
+}
 
 get_header();
@@ -23 +24 @@
             ?>
             <article id="post-<?php the_ID(); ?>" <?php post_class('nx-page-card'); ?>>
-                <?php nexversal_breadcrumbs(); ?>
+                <?php
+                if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_breadcrumbs')) {
+                    nexversal_breadcrumbs();
+                }
+                ?>
                 
+                <?php if (!function_exists('nexversal_is_meta_disabled') || !nexversal_is_meta_disabled('disable_title')) : ?>
                 <header class="nx-page-header" style="margin-bottom: 24px;">
                     <h1 class="nx-page-title" style="font-size: 2.2rem; font-weight: 800; letter-spacing: -0.03em;"><?php the_title(); ?></h1>
                 </header>
+                <?php endif; ?>
 
                 <?php if (has_post_thumbnail()) : ?>

nexversal/3.5.9/template-parts/content-card.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Template part for displaying an article card in Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Template part for displaying a modern article card in grids
- *
- * @package Nexversal
- */
 ?>
 <article id="post-<?php the_ID(); ?>" <?php post_class('nx-card'); ?>>
@@ -40 +41 @@
 
         <div class="nx-card-excerpt">
-            <?php echo esc_html(wp_trim_words(get_the_excerpt(), 14, '...')); ?>
+            <?php echo esc_html(wp_trim_words(get_the_excerpt(), 11, '...')); ?>
         </div>
 
         <div class="nx-card-meta">
             <div class="nx-meta-author">
-                <?php echo get_avatar(get_the_author_meta('ID'), 22); ?>
+                <?php echo get_avatar(get_the_author_meta('ID'), 20); ?>
                 <span><?php the_author(); ?></span>
             </div>
@@ -54 +55 @@
             </div>
         </div>
-
-        <?php
-        $card_btn_text = get_theme_mod('nexversal_card_btn_text', 'Read Article');
-        if (!empty($card_btn_text)) :
-            ?>
-            <div class="nx-card-action">
-                <a href="<?php the_permalink(); ?>" class="nx-card-btn">
-                    <span><?php echo esc_html($card_btn_text); ?></span>
-                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><line x1="5" y1="12" x2="19" y2="12"></line><polyline points="12 5 19 12 12 19"></polyline></svg>
-                </a>
-            </div>
-        <?php endif; ?>
     </div>
 </article>

nexversal/3.5.9/template-parts/newsletter-box.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Newsletter Subscription Component for Nexversal Theme (Image 2 Design)
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
 
-/**
- * Newsletter Subscription Component
- *
- * @package Nexversal
- */
+$nl_title         = get_theme_mod('nexversal_newsletter_title', __('New AI tool reviews,', 'nexversal'));
+$nl_highlight     = get_theme_mod('nexversal_newsletter_highlight', __('in your inbox.', 'nexversal'));
+$nl_desc          = get_theme_mod('nexversal_newsletter_desc', __('Get new reviews and comparisons in your inbox. No spam, unsubscribe anytime.', 'nexversal'));
+$nl_btn           = get_theme_mod('nexversal_newsletter_btn_text', __('Subscribe', 'nexversal'));
+$nl_success_title = get_theme_mod('nexversal_newsletter_success_title', __("You're in. ✨", 'nexversal'));
+$nl_success_desc  = get_theme_mod('nexversal_newsletter_success_desc', __("We'll email you new reviews and comparisons as we publish them.", 'nexversal'));
+
+$is_logged_in     = is_user_logged_in();
 ?>
-<section class="nx-newsletter-card">
-    <div class="nx-newsletter-content">
-        <span class="nx-newsletter-badge">
-            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 4h16c1.1 0 2 .9 2 2v12c0 1.1-.9 2-2 2H4c-1.1 0-2-.9-2-2V6c0-1.1.9-2 2-2z"></path><polyline points="22,6 12,13 2,6"></polyline></svg>
-            <?php esc_html_e('Nexversal Tech Dispatch', 'nexversal'); ?>
+<section class="nx-newsletter-v2" data-logged-in="<?php echo $is_logged_in ? 'true' : 'false'; ?>">
+    <div class="nx-newsletter-left">
+        <span class="nx-newsletter-badge-v2">
+            <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><circle cx="12" cy="12" r="3"/><line x1="12" y1="2" x2="12" y2="6"/><line x1="12" y1="18" x2="12" y2="22"/><line x1="4.93" y1="4.93" x2="7.76" y2="7.76"/><line x1="16.24" y1="16.24" x2="19.07" y2="19.07"/><line x1="2" y1="12" x2="6" y2="12"/><line x1="18" y1="12" x2="22" y2="12"/><line x1="4.93" y1="19.07" x2="7.76" y2="16.24"/><line x1="16.24" y1="7.76" x2="19.07" y2="4.93"/></svg>
+            <?php esc_html_e('Newsletter', 'nexversal'); ?>
         </span>
-        <h3 class="nx-newsletter-title"><?php esc_html_e('Stay Ahead in Tech & Modern Software', 'nexversal'); ?></h3>
-        <p class="nx-newsletter-desc">
-            <?php esc_html_e('Join developers, engineers, and digital innovators getting our weekly deep-dives on AI tools, cloud architectures, and development strategies.', 'nexversal'); ?>
+        <h3 class="nx-newsletter-title-v2">
+            <?php echo esc_html($nl_title); ?> <span class="nx-nl-highlight"><?php echo esc_html($nl_highlight); ?></span>
+        </h3>
+        <p class="nx-newsletter-desc-v2">
+            <?php echo esc_html($nl_desc); ?>
         </p>
     </div>
-    <form class="nx-newsletter-form" onsubmit="event.preventDefault(); var btn=this.querySelector('button'); btn.innerText='Subscribed!'; btn.style.background='#10b981'; this.querySelector('input').disabled=true;">
-        <div class="nx-newsletter-input-group">
-            <input type="email" placeholder="<?php esc_attr_e('Enter your work email...', 'nexversal'); ?>" required class="nx-newsletter-input" />
-            <button type="submit" class="nx-newsletter-btn">
-                <span><?php echo esc_html(get_theme_mod('nexversal_newsletter_btn_text', __('Subscribe', 'nexversal'))); ?></span>
-                <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="5" y1="12" x2="19" y2="12"></line><polyline points="12 5 19 12 12 19"></polyline></svg>
-            </button>
+
+    <div class="nx-newsletter-right">
+        <!-- Success State Card (Shown when subscribed or user is logged in) -->
+        <div class="nx-nl-success-card" style="<?php echo $is_logged_in ? 'display: block;' : 'display: none;'; ?>">
+            <div class="nx-nl-success-title"><?php echo esc_html($nl_success_title); ?></div>
+            <div class="nx-nl-success-desc"><?php echo esc_html($nl_success_desc); ?></div>
         </div>
-        <p class="nx-newsletter-privacy">
-            <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="11" width="18" height="11" rx="2" ry="2"></rect><path d="M7 11V7a5 5 0 0 1 10 0v4"></path></svg>
-            <?php esc_html_e('No spam. Unsubscribe anytime with 1-click.', 'nexversal'); ?>
-        </p>
-    </form>
+
+        <!-- Default Email Form (Hidden when logged in or already subscribed) -->
+        <form class="nx-newsletter-form-v2" method="post" style="<?php echo $is_logged_in ? 'display: none;' : 'display: block;'; ?>">
+            <div class="nx-nl-input-wrap">
+                <span class="nx-nl-input-icon">
+                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 4h16c1.1 0 2 .9 2 2v12c0 1.1-.9 2-2 2H4c-1.1 0-2-.9-2-2V6c0-1.1.9-2 2-2z"></path><polyline points="22,6 12,13 2,6"></polyline></svg>
+                </span>
+                <input type="email" name="nx_email" placeholder="<?php esc_attr_e('you@example.com', 'nexversal'); ?>" required class="nx-nl-email-input" autocomplete="email" />
+                <button type="submit" class="nx-nl-submit-btn">
+                    <span><?php echo esc_html($nl_btn); ?></span>
+                </button>
+            </div>
+            <div class="nx-newsletter-message" style="display: none; font-size: 13px; margin-top: 8px;"></div>
+        </form>
+    </div>
 </section>
 

nexversal/3.5.9/template-parts/social-share.php

@@ -1 +1 @@
 <?php
 /**
- * Security: Prevent direct script access
+ * Social Share Buttons Component for Nexversal Theme
+ *
+ * @package Nexversal
+ * @author Nexes Agency & Muhammad Shahid
+ * @copyright 2026 Nexes Agency & Muhammad Shahid
+ * @license GNU General Public License v2 or later
+ * @link https://nexversal.com
  */
+
 if (!defined('ABSPATH')) {
     exit;
 }
-
-/**
- * Social Share Buttons Component
- *
- * @package Nexversal
- */
 
 $post_url   = rawurlencode(get_permalink());