Third Set Mautic Timing Bundle

Abstract

1. Introduction

The ThirdSetMauticTimingBundle is a Mautic plugin that allows you to set a cron timing expression on any Campaign action event (such as a "Send Email" action).

For example, you could add a cron expression that only allows sending on weekdays during working hours in New York.

2. Objective

Mautic plugin for setting the timing (hours of the day, days of the week, etc) for when to trigger campaign events.

This project demonstrates how PHP can be applied to a real-world Digital Marketing & SEO problem.

3. Key Features / Modules

• Adds the full ability of cron syntax to your campaign actions allowing you to only send emails at certain times.
• Use different cron expressions on different campaign actions.
• Enter a timezone to use when evaluating the cron expression (this allows you to send an email during working hours in your own timezone, for example).
• Use different time zones for different cron expressions/campaign actions.
• Use the Contact's time zone (if available) to evaluate the cron expression. It will fall back to use any time zone you specify (or the System Default time zone) if the Contact's time zone isn't known.

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• PHP 7.4+ with a web server (XAMPP / WAMP / LAMP)
• MySQL / MariaDB
• phpMyAdmin (optional)
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/thirdset/ThirdSetMauticTimingBundle.git
cd ThirdSetMauticTimingBundle

1. Download or clone this bundle into your Mautic /plugins folder.
2. Manually delete your cache (var/cache/prod for Mautic 3.x+ and app/cache/prod for Mautic 2.x).
3. In the Mautic GUI, go to the icon in the top right and then to Plugins.
4. Click the "Install/Upgrade Plugins" button in the top right. Note: if you are on an older version of Mautic, click the drowpdown arrow in the top right and then choose "Install/Upgrade Plugins".
5. You should now see the Timing plugin in your list of plugins.
6. Run the following console commands to update the database:

php bin/console doctrine:schema:update --dump-sql
php bin/console doctrine:schema:update --force

apk update && apk add ca-certificates && update-ca-certificates && apk add openssl
/usr/bin/wget https://phar.phpunit.de/phpunit.phar -O /usr/bin/phpunit && chmod 755 /usr/bin/phpunit

curl https://phar.phpunit.de/phpunit.phar -L -o /usr/bin/phpunit && chmod 755 /usr/bin/phpunit

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Export reports to Google Sheets or PDF
• Schedule weekly automated reports
• Add competitor comparison

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which marketing or SEO problem does this tool solve?
2. Which data sources or APIs does it use (Search Console, Analytics, social platforms)?
3. Which metrics or KPIs does it report and how are they calculated?
4. How could the output help a business make decisions?
5. How would you schedule it to run automatically?

9. Source Code & License

This project is developed by thirdset and published on GitHub under the GNU General Public License v3.0. Please follow the license terms and credit the original author when you use or modify this code.