Popup Generator
Documentation

Complete guide to installing, configuring, and getting the most out of Popup Generator - the powerful popup builder for your website.

v1.0Current Version
PHP 7.4+Requirement
3 TypesLicense Plans
8Popup Designs

NeonStat Popup Generator is a self-hosted PHP popup builder that creates modal popups, notification bars, and slide-in widgets on any website. It includes exit intent triggers, scroll depth targeting, page-level rules, and a WordPress plugin — with a one-time lifetime license from $39. No monthly fees, no external dependencies.

01 - INTRODUCTION

What is Popup Generator?

Popup Generator is a self-hosted, PHP-based popup builder that lets you create, customize, and deploy beautiful popup notifications on any website. No monthly fees, no external dependencies - you own it.

Self-Hosted

Runs entirely on your server. No external APIs required after activation. Your data stays yours.

License Protected

Domain-locked licensing system prevents unauthorized sharing. One license, one domain.

Fully Customizable

Control every visual aspect - colors, fonts, animations, position, timing, and more.

Mobile Ready

Responsive popups that look great on every screen size, from desktop to smartphone.

Popup Generator requires a valid license key to activate. Your license key was sent to your email along with your download link after purchase.
02 - REQUIREMENTS

System Requirements

Requirement Minimum Recommended Status
PHP Version 7.4 8.1+ Required
Web Server Apache / Nginx Apache with mod_rewrite Required
PHP Extensions json, curl, session Same Required
File Permissions 755 (folders), 644 (files) Same Required
SSL Certificate Optional HTTPS Strongly Recommended Recommended
Internet Access Required for activation only Same For Activation
PHP Session Support: Your server must support PHP sessions. Most shared hosting providers (DreamHost, cPanel hosts) support this by default.
03 - INSTALLATION

Installing Popup Generator

1

Download Your Package

Click the download link in your purchase confirmation email. The link is valid for 2 downloads only — save the ZIP file to your computer immediately.

Do not share your download link. It expires after 2 uses and is tied to your license.
2

Extract the ZIP File

Extract the downloaded Pop_Package.zip to your local computer. You will see the following folder structure:

[DIR] Popup-Generator/
  [DIR] popup-temp/ - auto-created on first run
  [FILE] popup-auth.php - login & activation page
  [FILE] popup-generator.php - main generator dashboard
  [FILE] popup-preview.php - live preview engine
  [FILE] popup.js - embed script for your website
  [FILE] .htaccess - security rules
  [FILE] README.txt
3

Upload to Your Server

Upload the entire extracted folder to your web server using FTP (FileZilla recommended) or your hosting control panel's File Manager.

Recommended Upload Location

# Option A - In a subdirectory (recommended) yourwebsite.com/popup/ # Option B - In root (if dedicated to popup) yourwebsite.com/
4

Set Folder Permissions

Ensure the following permissions are set via your FTP client or File Manager:

Item Permission
All folders 755
All .php files 644
popup-temp/ folder 755 (must be writable)
5

Access the Installation Page

Open your browser and navigate to where you uploaded the files:

https://yourwebsite.com/popup/popup-auth.php

You should see the System Activation screen. If you see a blank page or error, check your file permissions (Step 4).

04 - ACTIVATION

License Activation

Popup Generator requires a one-time license activation. Your server must have internet access during this step to communicate with the license server.

1

Enter Your License Key

Find your license key in your purchase email. It follows this format:

pop-XXX-YYMMDD-#####

Copy and paste it exactly - do not type it manually to avoid errors.

2

Create Your Admin Password

Choose a strong password for your dashboard. Minimum 4 characters. This is the password you will use every time you log in.

3

Set Your Master Recovery Key

This is a separate key used to reset your admin password if you forget it. Write this down and store it safely - it cannot be recovered if lost.

Your Master Recovery Key is stored encrypted on your server only. We do not have access to it. If you lose it and forget your password, you will need to reinstall.
4

Click Activate Popup Generator

The system will verify your license with our server and automatically redirect you to the dashboard upon success.

Domain Locked: Your license is now registered to this domain. To move to a different domain, contact support to release your domain slot.
05 - FEATURES

Complete Feature List

Visual Popup Builder

Design popups visually without touching code. Real-time preview updates as you configure.

Trigger Controls

Show popups on page load, exit intent, scroll depth, time delay, or click events.

Page Targeting

Display popups only on specific pages, categories, or URLs using simple rules.

Display Frequency

Control how often a visitor sees a popup — once, per session, or every visit.

Device Targeting

Show popups on desktop only, mobile only, or all devices.

Full Style Control

Customize colors, fonts, borders, shadows, size, position, and animations.

License Kill Switch

Admin can instantly revoke any license remotely. Popup stops working immediately.

Embed Code Generator

One-click copy of the embed code to paste into any website or CMS.

07 - CUSTOMIZATION

Customization Options

SettingOptionsDefault
Background ColorAny hex color or gradient#ffffff
Text ColorAny hex color#000000
Border Radius0px - 50px8px
AnimationFade, Slide, Bounce, ZoomFade
PositionCenter, Top, Bottom, Left, Right, CornersCenter
Width200px - 100%500px
OverlayOn / Off, OpacityOn, 50%
Close ButtonShow / Hide, StyleShown
08 - TARGETING

Targeting & Trigger Rules

Time-Based Triggers

  • Delay: Show after X seconds on page
  • Time on Site: Show after visitor has been on site for X minutes
  • Scheduled: Show only between specific dates/times

Behavior Triggers

  • Exit Intent: Show when cursor moves toward browser tab/close button
  • Scroll Depth: Show after visitor scrolls X% down the page
  • Click Trigger: Show when a specific button or link is clicked

Frequency Controls

  • Once per session - resets when browser is closed
  • Once per visitor - uses cookie, never shows again
  • Every visit - shows on each page load
  • Every X days - custom cooldown period
09 - FILE STRUCTURE

File & Folder Structure

[DIR] your-domain.com/popup/
  [DIR] popup-temp/
    [FILE] config.json - encrypted credentials (auto-created)
    [FILE] active_popup.json - your saved popup config
    [FILE] templates.json - saved templates
    [FILE] .htaccess - blocks direct access to config.json
  [FILE] popup-auth.php - login and activation page
  [FILE] popup-generator.php - main admin dashboard
  [FILE] popup-preview.php - live preview renderer
  [FILE] popup.js - paste this script tag in your website header
  [FILE] .htaccess - disables directory browsing
Never delete popup-temp/config.json - this stores your license activation. Deleting it will require re-activation.
10 - SETTINGS

Dashboard Settings

Change Admin Password

You can change your admin password from inside the dashboard under Settings. You will need your current password to do this.

Embed Code

Copy the generated embed code and paste it into the <head> or before the closing </body> tag of any webpage where you want the popup to appear.

Example embed code
<script src="https://yoursite.com/popup/popup.js"></script>
11 - LICENSE MANAGEMENT

License Plans & Management

PlanDomainsValidityPriceAction
Basic 1 Domain Lifetime $19 Buy Now
Agency 10 Domains Lifetime $27 Buy Now
Business 25 Domains Lifetime $45 Buy Now

WordPress Integration - Plugin

If your website runs on WordPress, you do not need to edit any theme files. A ready-made WordPress plugin is included in your package inside the plugin/ folder.

Package Structure
[DIR] Your Download Package/
  [ZIP] popup.zip - upload and extract to your root directory
  [DIR] plugin/
    [ZIP] popup-wp.zip - WordPress plugin, install via WP Admin
  [FILE] index.html - this documentation
How to install the WordPress plugin:
  1. First upload and extract popup.zip to your server root directory as usual
  2. Log in to your WordPress Admin
  3. Go to Plugins → Add New → Upload Plugin
  4. Click Choose File and select popup-wp.zip from the plugin/ folder
  5. Click Install Now then Activate Plugin
  6. Go to Settings → Popup Generator
  7. Enter your popup.js full URL. Example:
https://yourwebsite.com/popup/popup.js
  1. Check Enable Popup Generator
  2. Click Save Settings
  3. Your popup is now live on every page of your WordPress site - no theme editing required
The WordPress plugin automatically injects the script into your site header. You do not need to touch any theme files, functions.php, or use any other plugin.
Non-WordPress users (plain HTML, Joomla, Wix, Squarespace, etc.) should manually add the script tag to their site header instead. See Section 10 for the embed code.

Moving to a New Domain

Your license is locked to the domain it was activated on. To move to a different domain:

  1. Contact support with your license key and new domain
  2. We will release your domain slot from the old domain
  3. Re-install and activate on the new domain

Revoked Licenses

If your license is revoked (e.g. chargeback, violation of terms), the popup will stop loading on your website immediately at the next verification check. You will see a "License revoked" message when trying to log in.

12 - TROUBLESHOOTING

Troubleshooting

"Could not connect to licensing server"

  • Check your server has outbound internet access (cURL)
  • Ensure allow_url_fopen is enabled in PHP
  • Check your server firewall is not blocking outbound HTTPS (port 443)
  • Try again - the license server may have had a brief timeout

Blank Page or 500 Error

  • Check PHP version is 7.4 or higher
  • Ensure popup-temp/ folder has write permissions (755)
  • Enable PHP error display temporarily: add ini_set('display_errors',1); to top of file
  • Check your server's PHP error log

Forgot Admin Password

  • Click "Forgot password? Use Master Key" on the login page
  • Enter your Master Recovery Key that you saved during setup
  • Set a new admin password
  • If you lost your Master Key too - contact support for manual reset

"This license is already activated on another domain"

  • This means your license is currently registered to a different domain
  • If you moved your site, contact support to release the old domain
  • Basic licenses only allow 1 domain - upgrade to Business or Agency for more

Download Link Not Working

  • Each download link is valid for 2 downloads only
  • If both uses are spent, contact support with your order details for a new link
  • Do not share your download link with others
13 - FAQ

Frequently Asked Questions

Can I use this on a localhost or development server?
Yes, you can install on localhost for testing. However, the license will be registered to your localhost domain. You will need to contact support to release the localhost domain before activating on your live site.
Does it work with WordPress?
Yes. Simply paste the embed code into your WordPress theme's header.php or use a plugin like "Insert Headers and Footers" to add the script tag to all pages.
What happens if I delete the files from my server?
If you delete the installation files, the popup will stop loading on your website. Your license domain slot will still be occupied. Contact support to release it before reinstalling.
Can I resell or redistribute this software?
No. Popup Generator is licensed for use only by the original purchaser on the number of domains specified in their license plan. Redistribution, reselling, or sharing of the software or license key is strictly prohibited.
Is there a subscription or renewal fee?
No. All license plans are lifetime - you pay once and use it forever. There are no annual renewal fees.
Will the popup slow down my website?
Popup Generator loads asynchronously, meaning it will not block your page from loading. The embed script is lightweight and has minimal impact on page speed.
How do I update to a newer version?
When a new version is released, you will receive an email. Upload the new files over your existing installation - do not delete the popup-temp/ folder as it contains your license config.
14 - CHANGELOG

Version History

v1.0.0 - Initial Release

  • Visual popup builder with real-time preview
  • Domain-locked license activation system
  • 3 popup types: Modal, Notification Bar, Slide-In
  • Full trigger and targeting controls
  • Embed code generator
  • Admin password with master recovery key
  • Remote license kill switch
  • Mobile responsive popup output

Popup Interface Gallery

Popup Generator
Documentation v1.0 | © NeonStat | All Rights Reserved
For support: license@neonstat.com