User Guide - SparkPage

Quick Start Guide

Get your parking page live in 5 minutes!

1

Choose Your Template Files
Pick one HTML file from lps/ folder and one JSON file from config-files/ folder

2

Upload to Your Server
Upload both files to the same folder on your web server

3

Access Your Page
Visit: yoursite.com/folder/parking.html?config=template-name

✅ Done! Your parking page is now live and ready to drive traffic.

Uploading Files to Your Server

What to Upload

You need 2 files minimum:

parking.html or parkingplus.html - The page template
Your config file - Example: glp1-weight-loss-config.json

Where to Upload

Upload both files to the same folder on your web server. You also need to upload the config-files/ folder.

Example Server Structure:

Upload these files to your web server:

parking.html - Place in any folder
config-files/ folder - Must be in the same folder as the HTML file
Inside config-files/: All your JSON config files

Example: If you put parking.html at /landing-pages/parking.html, then put the config folder at /landing-pages/config-files/

File Permissions

⚠️ Important: Set file permissions to 644 for files and 755 for folders so your web server can read them.

⚠️ Don't Upload Everything!

Only upload the files needed: lps/ folder and config-files/ folder. Do not upload the tools, documentation, or start-here files - these are for your local use only.

Security & Protection

Protecting Your Config Files

The .htaccess file in your config-files folder prevents direct access to your JSON files.

1

Include the .htaccess File
Make sure the .htaccess file is uploaded inside your config-files/ folder. This file blocks direct URL access while still allowing your templates to load the configs.

2

Test the Protection
Try to access a config file directly: https://yoursite.com/config-files/diabetes-config.json
You should see "403 Forbidden" - that's good! Your pages will still work normally.

Security Best Practices

Use non-obvious folder names - Instead of "landing-pages", use generic names like resources, content, or info
Don't link to your pages from your main site - Traffic sources link directly to the landing pages
Rename template files (optional) - Change parking.html to page.html or index.html for extra security

💡 Why This Matters: If people can access your config files, they can see your entire setup, destination URLs, and system structure. The .htaccess file keeps your configs private.

Understanding File Names and URLs

ℹ️ This is important! The file name and URL parameter work together in a specific way.

How It Works

All config files follow this naming pattern:

[name]-config.json

When you access a page, you use just the [name] part in the URL:

?config=[name]

Real Examples

File Name on Server	URL Parameter to Use
`glp1-weight-loss-config.json`	`?config=glp1-weight-loss`
`diabetes-type2-config.json`	`?config=diabetes-type2`
`hair-loss-men-config.json`	`?config=hair-loss-men`

Full URL Example:

https://yoursite.com/landing-pages/parking.html?config=glp1-weight-loss

Color Themes

SparkPage includes 8 color themes you can use to match your brand or test different looks.

Available Themes

default - Blue/cyan theme
purple - Purple gradient
green - Green/emerald theme
orange - Orange/amber theme
pink - Pink theme
red - Red theme
white - White/blue theme
light - Light gray/green theme

How to Use Themes

Add &theme=name to your URL:

parking.html?config=glp1-weight-loss&theme=purple

💡 Pro Tip: Test different themes with your traffic to see which converts best!

Adding Images to Ad Units

The parkingplus.html template supports thumbnail images in ad units.

How to Add Images

In your JSON config file, add "backgroundImage" to any ad unit:

{
  "title": "Learn About GLP-1 Medications",
  "url": "https://yoursite.com/glp1-info",
  "backgroundImage": "https://yoursite.com/images/glp1-thumb.jpg"
}

Image Requirements

Dimensions: 270x180 pixels (or similar ratio)
Format: JPG, PNG, or WebP
Size: Keep under 100KB for fast loading
URL: Full https:// URL to the image

Where to Host Images

Your own web server
CDN like Cloudflare or CloudFront
Image hosting service like Imgur or imgBB

⚠️ Note: Images are optional. Ad units work perfectly fine without them!

Troubleshooting

Page Shows "Loading content..."

Check that the config file name matches the URL parameter
Verify the config file is in the config-files/ folder
Make sure file permissions are set to 644
Check browser console (F12) for error messages

Config File Not Found

Verify you uploaded the config-files/ folder
Check spelling of the config name in the URL
Remember: Remove -config from the URL parameter

Images Not Showing

Make sure you're using parkingplus.html, not parking.html
Verify the image URL is correct and accessible
Check that the image URL starts with https://
Test the image URL directly in your browser

Wrong Theme Showing

Check the &theme= parameter in your URL
Verify the theme name is spelled correctly
Clear browser cache and refresh the page

Getting 403 Errors on Pages

The .htaccess file might be too strict
Try temporarily removing .htaccess to test
Check server error logs
Verify folder permissions are set to 755

💡 Still Having Issues? Open your browser console (F12) and look for error messages. They usually point directly to the problem!