nolimit-reminder-dist/docs/SETUP.md

Setup

Activation

Activate the plugin from Plugins → Installed Plugins → Nolimit Reminder. On activation the plugin:

1. Creates three tables: nlrem_carts, nlrem_steps, nlrem_sends.
2. Registers the WooCommerce hooks that track cart state.
3. Schedules the cron events nlrem_abandon_sweep, nlrem_send_sweep, and nlrem_retention.
4. Registers the admin menu page under the shared Nolimit family menu.

Deactivation removes the cron events but leaves the tables. Uninstall drops the tables and deletes all nlrem_ options.

First-run configuration

After activation, open Nolimit → Nolimit Reminder → Settings and set:

• Abandon threshold (minutes): how long a cart sits before it is marked abandoned. Default 30.
• Sequence length: number of emails in the reminder sequence. Default 3.
• Email interval (hours): gap between sequence steps. Default 24.
• Discount code (optional): a WooCommerce coupon code appended to the final email.
• Retention days: how long completed or expired cart records are kept before the retention sweep deletes them. Default 30.
• From name and From email: the sender identity for reminder emails. Default to the site title and admin email.

Cron

The plugin relies on WordPress cron for its three scheduled jobs:

Hook	Default frequency	Purpose
nlrem_abandon_sweep	hourly	Marks carts abandoned past the threshold.
nlrem_send_sweep	hourly	Sends the next sequence step for due carts.
nlrem_retention	daily	Deletes cart records older than the retention window.

If your site uses an external cron (WP-Cron-Disable, etc.), point it at wp-cron.php or replace these with system cron. The sweeps are idempotent: running them more often than scheduled does not duplicate sends because each send is recorded in nlrem_sends before the cart is advanced.

Email deliverability

Reminder emails use wp_mail(). No SMTP plugin is required, but if your host blocks outbound mail on port 25 you will need an SMTP relay. The unsubscribe link in each email is a plain ?nlrem_unsub=... query argument on the shop front; no JavaScript, no account, no tracking pixel.

Multi-site

The plugin is network-agnostic: each site in a network has its own tables and options. The shared menu appears on each site's admin separately.

Troubleshooting

• No emails sent: check that wp_mail() works on your host (send a test from Settings → General → site admin email). Check the Activity tab for failed sends and their error string.
• Carts not marked abandoned: verify the threshold is not set to 0 and that the nlrem_abandon_sweep cron has run (Activity tab shows the last sweep timestamp).
• Duplicate emails: should not happen; the nlrem_sends table is checked before each send. If you see duplicates, check for a second installation of this plugin (e.g. a stale mu-plugin copy).