MailMarquee - Dynamic Newsletter Ad Manager

MailMarquee is a self-hosted ad manager built for email newsletters.

MailMarquee does not send emails. It manages the ads inside the newsletters you already send with Mailchimp, MailerLite or any platform that accepts HTML.

Paste one embed code per ad slot into your template once. From then on, MailMarquee shows the right campaign automatically, based on the start and end dates you set in the dashboard. Ads can change even in newsletters that were sent weeks ago.

BUILT FOR EMAIL, NOT WEBSITES Website ad servers use JavaScript or iframes, which Gmail, Outlook and Apple Mail block. MailMarquee serves each ad as a plain image link, so it works in any email client.

HOW IT WORKS 1. Create an ad slot and copy its embed code. 2. Paste the code into your newsletter template. 3. Create campaigns with an image, a link and a date range. 4. MailMarquee shows the active campaign and tracks views and clicks.

BUILT FOR SHARED HOSTING Install it from your browser with the built-in web installer. No Docker, no Redis, no Node.js, no Composer and no command line needed on your server. A single cron line runs everything.

BILINGUAL The dashboard, emails and documentation are available in English and Spanish.

Mailchimp and MailerLite are trademarks of their respective owners. MailMarquee is not affiliated with or endorsed by them.

Features

- Date-based campaigns: each ad runs between its start and end date - Priority rules when several campaigns overlap - Manual override: pin any campaign to a slot instantly - One campaign in many slots, many campaigns per slot - Upload images or use an external image URL - Fallback ad when no campaign is running (or show nothing) - Campaign status at a glance: live, scheduled, ended, paused - Two click-tracking modes: MailMarquee tracking or your email platform's tracking - Reports: views, clicks, CTR, daily charts and CSV export - Automatic cleanup of old statistics (365 days by default, configurable) - Ready-to-paste embed code for Mailchimp, MailerLite and other platforms - Web installer with requirements check, database test and SMTP test email - Password reset by email, login rate limiting, security headers - No IP addresses or user agents stored - Works in a domain, subdomain or subfolder - English and Spanish included - Clean, readable source code: no encryption, no license checks

Requirements

- PHP 8.3 or higher - PHP extensions: pdo_mysql, mbstring, openssl, fileinfo, gd, curl, zip, bcmath, tokenizer, xml, ctype, json - MySQL 8.0+ or MariaDB 10.x (tested on MariaDB 10.6) - Cron job access (one line) - SMTP email account - HTTPS recommended

Instructions

1. Unzip the download. Upload the "mailmarquee" folder to your server. 2. Point your domain or subdomain to the "public" folder. If your hosting does    not allow this, the included .htaccess file handles it for you. 3. Create an empty MySQL or MariaDB database and a database user. 4. Open your site in the browser. The web installer starts automatically. 5. Follow the installer steps: requirements, database, application settings,    SMTP, admin account and installation. 6. Add the cron line shown on the last installer screen to your hosting panel. 7. Log in and create your first ad slot.

Full step-by-step documentation with screenshots (English and Spanish) is included in the "documentation" folder.