V7 Smart Modal

=== V7 Smart Modal === Contributors: thevaibhaw Tags: modal, popup, modal popup, age verification, woocommerce modal, cta modal, custom html modal Requires at least: 5.6 Tested up to: 6.5 Stable tag: 1.0.0 Requires PHP: 7.4 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html

A premium-grade modal and popup builder for WordPress & WooCommerce. Build high-converting popups, age verifications, redirections, and custom HTML gates with advanced targeting, zero-flicker block-gate options, and scheduling.

== Description ==

V7 Smart Modal is an all-in-one modal popup solution designed for website owners, store administrators, and developers. Whether you need to show simple notice alerts, restrict access to content with a solid Age Verification gate, redirect users based on consent, or inject custom registration and newsletter forms via HTML/Shortcodes, V7 Smart Modal provides a robust, lightweight, and professional framework.

Unlike generic popup builders that cause annoying layout flashes (FOUC) or load slowly, V7 Smart Modal uses server-side pre-locking technology. When a gate modal is active, the plugin blocks the background page content from rendering at all until the user makes a selection.

Developed and maintained by Vaibhaw Kumar. Visit vaibhawkumar.in for more information and updates.

== Features ==

• Five Dynamic Modal Types:
  1. Message / Notice: Show announcements, discounts, or cookie policies with a standard close button.
  2. Age Verification: Force users to confirm their age (e.g. 21+) before accessing restricted posts, pages, or store products.
  3. Redirection Confirmation: Warn users they are leaving a page or redirect them instantly with customized "Continue" and "Cancel" buttons.
  4. Custom CTA: Insert custom Call-to-Action buttons with customizable URLs, targets (new tab/same tab), and styles.
  5. Custom HTML & Shortcode Support: Build highly custom layouts by pasting form scripts, shortcodes (like Gravity Forms, WooCommerce Product grids), or videos.
• Zero-Flicker Block-Gate Security: Completely blocks and hides the underlying page content before the browser parses or displays it. The visitor cannot bypass the gate by disabling JavaScript or blocking scripts.
• Dual-Layer Redirection: Redirects returning users who previously declined an age verification gate instantly at the browser header level, minimizing load times.
• Granular Targeting Engine:
  • Sitewide: Show the modal across the entire website.
  • Specific Pages: Target chosen WordPress pages or blog posts.
  • WooCommerce Products: Target single products in your store.
  • WooCommerce Categories: Target entire product lines or collections.
• Intelligent Cookie & Storage Scheduling:
  • Every Visit: Prompts the modal every time a page is loaded (great for strict age verifications).
  • Once / Permanent: Save the interaction for 10 years so returning users are never bothered again.
  • Session Only: Retain the selection until the browser tab is closed.
  • Interval (Hours/Days/Minutes): Set custom durations (e.g., show again after 1 week).
  • Fixed Expiration Date: Keep the modal active until a specific calendar date (perfect for holiday promotions or limited-time events).
• Automatic Cache Clearing: Automatically purges active cache files for WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed Cache, and Autoptimize whenever you save your campaign.

== Installation ==

1. Log in to your WordPress dashboard.
2. Navigate to Plugins > Add New and click Upload Plugin.
3. Choose the v7-smart-modal.zip file and click Install Now.
4. Activate the plugin through the Plugins menu.
5. You will see a new V7 Smart Modal menu in your WordPress sidebar.

== Step-by-Step Guide ==

1. Creating Your First Modal popup

1. Go to V7 Smart Modal > Add New.
2. Enter a title for your campaign (e.g., "Holiday Sale Alert" or "Age Gate 21+").
3. In the Modal Configurations box under the editor, select your Modal Type.
4. Customize your headings, text, button labels, and configure the redirect targets or logos if needed.
5. Publish the modal.

2. Setting Up an Age Verification Gate (Zero-Flicker Content Block)

1. Create a new modal and select Age Verification as the type.
2. Configure the Yes Button Label (e.g., "Yes, I am 21+") and No Button Label (e.g., "No, I am not").
3. Provide a Fail Redirect URL (e.g., https://google.com or your store's terms page). If a user clicks "No", they are redirected here immediately.
4. In the Targeting Rules tab, add a rule to target your restricted pages or products.
5. In the Cookies & Schedule tab, choose Display Expiration to specify how long to remember that a user accepted (e.g., 1 week or permanent).
6. Note: To enforce the gate strictly: if they click "No", no cookies are saved, meaning they will remain blocked and prompted again if they attempt to return.

3. Targeting Specific WooCommerce Products

1. Inside your modal campaign editor, click the Targeting Rules tab.
2. Click Add Targeting Rule.
3. Select WooCommerce Products or WooCommerce Product Categories from the dropdown.
4. Use the search bar that appears to type in the name of your product or category, and select it from the list.
5. Save/Update the modal.

4. Customizing Styles (Colors, Sizes & Animations)

1. Open your modal campaign and click the Design Options tab.
2. Adjust the width (in pixels) and padding.
3. Select an overlay color (with transparency support, e.g. rgba(0,0,0,0.6)), background color, text color, and button colors.
4. Choose a premium animation style (e.g., Fade In, Slide Up, Zoom In, or Bounce) and speed.

== Frequently Asked Questions ==

= The modal styling or changes are not showing on my website. Why? = Your site is likely using a caching plugin. V7 Smart Modal automatically attempts to clear the cache of popular plugins like WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed, and Autoptimize when you save the modal. If you still don't see changes, manually purge your website cache (e.g. click "Clear Cache" in WP Rocket) and refresh your browser.

= Can I use shortcodes inside the modal? = Yes! Select the Custom HTML modal type. You can paste any shortcodes (e.g., Contact Form 7, WooCommerce checkout/cart shortcodes, or page builder codes) directly into the textarea, and they will render perfectly.

= How does the Block-Gate feature prevent users from seeing my page? = As soon as the plugin detects a targeted modal is active on the current page, it adds the class v7-sm-locked to the <html> tag at the server level. The plugin head stylesheet sets visibility: hidden on the page body. This prevents the browser from displaying any page content while loading. Only when the user clicks "Yes" or confirms does the JavaScript remove the lock class, instantly revealing the page.

= Does this work on Mobile devices? = Yes! Under the Device Visibility tab, you can choose to show or hide the modal on specific screen sizes (Desktop, Tablet, or Mobile). The layouts are fully responsive and touch-friendly.

= What happens if a user clicks "No" on the Age Verification popup? = If the user clicks "No", they are instantly redirected to the configured "Fail Redirect URL". The plugin intentionally does not write any "interacted" cookies for users who reject the modal. If they attempt to visit the page again later, they will remain blocked by the gate and must verify again.

== Changelog ==

= 1.0.0 =

• Initial stable release.
• Enforce server-side content locking class v7-sm-locked to prevent layout flashes.
• Fixed external URL redirection validation in admin metaboxes.
• Added WP Rocket, W3TC, WP Super Cache, LiteSpeed Cache, and Autoptimize automatic cache flushing on modal save.
• Added loop redirection prevention logic for relative & absolute URLs.
• Added Fixed Date Expiry option with a datepicker calendar interface.