Free Rotator Script Launch Kit
Free Rotator Script is a dependency-free PHP website and 468×60 banner rotator bundled with a double-opt-in lead funnel. It runs from a domain root or subfolder on ordinary PHP hosting.
Included
- Weighted website and banner selection
- Full-page sandboxed website frame under a compact top bar
- Visitor reporting with privacy-preserving IP hashes
- Admin area for sites, weights, status, banners, leads, reports, and backup export/restore
- Validated banner uploads (JPG, PNG, GIF, WebP; 2 MB maximum)
- Lead homepage, expiring branded email confirmation, safe resend, suppression/unsubscribe, and protected ZIP delivery
- First-party funnel events for homepage views, form submissions, confirmations, downloads, demo clicks, and upgrade/contact clicks
- Locked JSON storage in the free core—no database or package manager
- Customer MOD Manager for signed optional extensions purchased or claimed from Home Base
- One-time browser installer plus a styled guide center for every shipped instruction and the license
Public entry points are / (canonical lead homepage), /demo/ (live rotator), /admin/ (management), /guide.php (styled package help), and /install.php (one-time browser setup). landing.php permanently redirects to /.
Start with START_HERE.md, open install.php in your browser, and record the result in FRESH_DOMAIN_ACCEPTANCE.md. No terminal is required for a normal installation.
Requirements
The free core requires PHP 8.1+ with sessions, JSON, and file uploads. Image inspection support is strongly recommended for banner validation. Production email mode also needs a working PHP mail() configuration. Apache is easiest because the included .htaccess files protect private data; Nginx needs the rules in the installation guide.
Optional MODs may add requirements such as PDO SQLite, cURL, OpenSSL, or outbound HTTPS. The MOD Manager checks declared compatibility before installation.
License
See LICENSE. The package may be customized, distributed, or sold.
Operator notes
Complete FRESH_DOMAIN_ACCEPTANCE.md before sending production traffic. Repository and Home Base engineering documents are intentionally excluded from the public ZIP.
Use the Admin backup panel before upgrades or host moves. Preserve config.php, the complete storage/ directory, uploads/, and keys/. Installed MODs may maintain additional files or SQLite databases under storage/mods/.
The public rotator top bar includes a call to action that links back to /#get-it, so visitors who arrive through /demo/ can request the free kit.
Security setup notes
On a fresh upload, install.php creates config.php, hashes the chosen password, stores the Admin username, and disables itself. Run it immediately: until configuration exists, the first visitor to the installer could create the Admin account.
After installation, install.php returns 404. An experienced operator can temporarily reopen its read-only environment check with enable_install, a private setup_token, and the matching token URL. It never overwrites an existing config.php.
Backups exported by current versions use free-rotator-script-admin-backup.