SW Group Dealership Landing Pages + Automotive Lead CRM

1. What is in this package

2. Server requirements

• PHP 8.0 or newer (tested on PHP 8.4) with pdo_mysql, mbstring, openssl, json, filter
• MySQL 5.7+ / MariaDB 10.3+ (tested on MariaDB 11.4)
• Apache with mod_rewrite (standard on cPanel)
• An SMTP mailbox on your domain (cPanel → Email Accounts)
• No Composer, no shell access and no Node.js required

3. Installation on cPanel (about 15 minutes)

Step 1 — Upload the files

1. cPanel → File Manager → open public_html (or the document root of the add-on domain).
2. Upload swgroup_v1.zip.
3. Select the file → Extract.
4. Open the extracted swgroup_v1 folder, select all items, and Move them into the document root so that index.php sits directly in public_html. Then delete the empty folder and the ZIP.

Step 2 — Create the database

1. cPanel → MySQL® Database Wizard.
2. Database name: swgroup (cPanel will prefix it, e.g. cpuser_swgroup).
3. Create a user, e.g. swuser, with a strong password. Save both values.
4. Grant ALL PRIVILEGES to that user on the database.

Step 3 — Import the SQL

1. cPanel → phpMyAdmin → select your new database.
2. Import → choose database/schema.sql → Go.
3. Import again → choose database/demo_data.sql → Go.

Step 4 — Configure the database connection

Edit config/database.php:

return [
    'host'     => 'localhost',
    'name'     => 'cpuser_swgroup',
    'user'     => 'cpuser_swuser',
    'password' => 'your-database-password',
    'charset'  => 'utf8mb4',
];

Step 5 — Configure email (SMTP)

Create a mailbox in cPanel → Email Accounts (for example leads@yourdomain.co.za), then edit config/mail.php:

return [
    'host'        => 'mail.yourdomain.co.za',
    'port'        => 465,
    'encryption'  => 'ssl',          // 'ssl' for 465, 'tls' for 587
    'username'    => 'leads@yourdomain.co.za',
    'password'    => 'mailbox-password',
    'from_email'  => 'leads@yourdomain.co.za',
    'from_name'   => 'SW Group Automotive',
    'admin_email' => 'sales@yourdomain.co.za',
];

Step 6 — Set the site basics

Edit config/app.php: site URL, dealership phone numbers, WhatsApp numbers, opening hours and the Google Analytics / Meta Pixel IDs if you have them.

Step 7 — Log in to the CRM

Visit https://yourdomain.co.za/admin/

Step 8 — Finish the SEO files

Replace example.co.za with your real domain in robots.txt and sitemap.xml.

4. Removing the demo data before going live

Run this in phpMyAdmin → SQL when you are ready for real customers. It keeps the dealerships, vehicles, staff and your admin user, and clears only the demo leads.

SET FOREIGN_KEY_CHECKS = 0;
TRUNCATE TABLE lead_notes;
TRUNCATE TABLE lead_activity;
TRUNCATE TABLE test_drives;
TRUNCATE TABLE finance_applications;
TRUNCATE TABLE service_bookings;
TRUNCATE TABLE campaign_recipients;
TRUNCATE TABLE email_campaigns;
TRUNCATE TABLE customers;
TRUNCATE TABLE leads;
SET FOREIGN_KEY_CHECKS = 1;

5. How the system works

Lead capture

Every form on every landing page posts to forms/submit.php over AJAX with a CSRF token. That endpoint validates the input, saves the lead with a reference (SW-00001), records the source page, UTM parameters, gclid / fbclid, referrer and device, assigns a salesperson round-robin, scores the lead, writes the matching booking record (test drive / finance / service), upserts the customer, then sends the confirmation and notification emails.

Lead types handled

• GENERAL — general enquiry
• TEST_DRIVE — creates a test drive booking
• FINANCE — creates a finance application
• SERVICE — creates a workshop booking
• TRADE_IN, PARTS, PROMOTION, VIRTUAL_TEST_DRIVE

CRM modules

Email campaigns on shared hosting

Campaigns send in batches with a short pause between messages so you stay inside your host's hourly mail limit. Leave the sending page open until it reports Completed; it resumes safely if interrupted. Only customers who granted marketing consent and have not unsubscribed are included.

6. Security notes

• Passwords are stored with password_hash(); login attempts are rate limited.
• All output is escaped; all database access uses prepared statements.
• Every form is CSRF protected and validated server-side as well as in the browser.
• .htaccess blocks direct web access to config/, includes/, database/ and vendor/.
• Keep HTTPS enabled (cPanel → SSL/TLS Status → AutoSSL).

7. Troubleshooting

8. Demo credentials summary

All vehicle photography in this package is generated for demonstration purposes. Replace it with official manufacturer imagery before commercial use, and confirm all pricing with the dealership before publishing.