Coming Soon Premium

Theme Documentation – version 1.0.0

1. Overview 2. Installation 3. Quick Start Setup 3. Requirements 4. Files & Structure 5. Templates 6. Customizer Settings 7. Launch Date & Countdown 8. Email Subscribe Form 9. Subscribers Admin & Export 10. Styles & Classes 11. Header & Footer 12. Troubleshooting 13. FAQ 14. Changelog

1. Overview

Coming Soon Premium is a light classic WordPress theme for launch/under‑construction pages with a live countdown, email collection, and a simple CSV export for subscribers.

2. Installation

Copy the theme folder coming-soon-premium to wp-content/themes/.
In Dashboard → Appearance → Themes, activate “Coming Soon Premium”.
Set a static front page (optional) or rely on front-page.php template.

3. Quick Start Setup

Dashboard → Appearance → Themes → Activate “Coming Soon Premium”.
Dashboard → Appearance → Customize → Coming Soon Settings.
Content: set Headline and Subheadline.
Launch Date:
- Either set Launch Timestamp (seconds). If you paste milliseconds, it auto-fixes.
- Or leave it 0 and set Launch Date & Time (e.g., 2025-12-31 23:59).
Background: choose Solid Color or upload a Background Image.
Subscription Form: tick Show Email Form and edit GDPR Consent Text if needed.
Social Links: add URLs you want visible.
Click Publish. Visit your homepage to see the countdown and form.

Example values

Headline: We’re Launching Soon
Subheadline: Sign up to get notified when we go live.
Launch Timestamp: 1767225540 (UTC seconds) – or Launch Date & Time: 2025-12-31 23:59
Background Color: #0f172a

Launch checklist

Countdown decreasing every second (not stuck at 00:00:00:00).
Email form accepts a valid email and shows success message.
Dashboard → Subscribers shows the new entry.
Export CSV works and downloads a file.
Header is centered and logo appears (if set in Customize → Site Identity).
Background looks correct on desktop and mobile.

4. Requirements

WordPress 5.8+
PHP 7.4+ (recommended 8.0+)

5. Files & Structure

coming-soon-premium/
├─ assets/
│  ├─ css/
│  │  └─ style.css        ← main styles
│  └─ js/
│     └─ main.js          ← countdown + ajax subscribe
├─ inc/
│  └─ customizer.php      ← Customizer panels/controls
├─ front-page.php         ← main landing template
├─ functions.php          ← setup, assets, AJAX, CPT, export
├─ header.php             ← theme header (wp_head)
├─ footer.php             ← theme footer (wp_footer)
├─ index.php              ← fallback template
└─ style.css              ← theme header (metadata)

6. Templates

front-page.php: renders logo, headline, subheadline, countdown, form, socials, footer.
header.php / footer.php: base HTML and WordPress hooks.
index.php: generic fallback if no other template matches.

7. Customizer Settings

Content

Headline – main title
Subheadline – supporting text

Launch Date

Launch Timestamp (seconds). Milliseconds are auto-corrected.
Launch Date & Time – human text (site timezone), used when timestamp is 0.

Background

Background Type – color or image
Background Color
Background Image

Subscription Form

Show Email Form – toggle form visibility
GDPR Consent Text – checkbox label

Social Links

Add URLs for Facebook, Twitter, Instagram, LinkedIn.

8. Launch Date & Countdown

The countdown reads a UNIX timestamp (seconds) from Customizer. If you paste a millisecond value, it is divided by 1000 automatically. Alternatively, leave timestamp as 0 and fill the human‑readable “Launch Date & Time” (e.g., 2025-12-31 23:59), which is parsed in the site timezone.

JS updates the counters every second using assets/js/main.js.

9. Email Subscribe Form

User enters email + checks consent.
AJAX request is sent to admin-ajax.php with action csp_subscribe.
Server validates and saves as a csp_subscriber post.
Success/error message is shown inline; duplicates are ignored gracefully.

Endpoints and logic live in functions.php (enqueue + AJAX handler). Frontend behavior is in assets/js/main.js.

10. Subscribers Admin & Export

Dashboard → Subscribers: view stored emails.
Dashboard → Subscribers → Export CSV: download all emails with timestamp and IP.

11. Styles & Classes

.csp-site – main area; background image/color
.csp-container – centered container
.csp-logo, .csp-headline, .csp-subheadline
.csp-countdown with #csp-days, #csp-hours, #csp-mins, #csp-secs
.csp-form, #csp-form, #csp-email, #csp-gdpr, #csp-message
.csp-social – social icons list
.site-header, .site-branding – header layout (centered)

13. Troubleshooting

Countdown not moving

Ensure Launch Timestamp is a valid seconds value (not 0). If milliseconds, it now auto-corrects.
Or set Launch Date & Time and leave Timestamp as 0.
Hard refresh the page (Ctrl/Cmd + Shift + R).

Email not saving

Check Dashboard → Subscribers for entries.
Console errors? Ensure jQuery is loaded and no plugin blocks AJAX.
Security plugins may block admin-ajax.php; whitelist it.

“Broken theme” message

Theme requires style.css header, index.php, and preferably header.php/footer.php.

14. FAQ

Can I send emails to admin on subscribe? Yes. Add a wp_mail() call in the AJAX handler or integrate with a service (Mailchimp, Brevo). SMTP plugins improve deliverability.

How to change fonts/colors? Edit assets/css/style.css. You can enqueue extra styles via a child theme if needed.

Make the page private? Use a maintenance/coming‑soon plugin, or restrict access via server rules. This theme itself does not gate content.

15. Changelog

1.0.0: Initial release. Countdown, subscribe, CSV export, centered header.

Open this file anytime at wp-content/themes/coming-soon-premium/documentation.html.