Skip to content

Email Notifications

Richard Kent Gates edited this page Mar 6, 2026 · 1 revision

Email Notifications

Scriptomatic sends plain-text notification emails whenever a change is written to the Activity Log.


Who Receives Emails

Recipient Condition
Site admin (admin_email WP option) Always — unconditionally, regardless of profile setting
Other administrators Only if they have opted in via their WordPress profile

When the acting user is the site admin, deduplication ensures only one email is sent (not two).


What Triggers a Notification

A notification is sent for every event that writes to the Activity Log:

  • Inline script saved
  • Inline script rolled back (restored)
  • External URL list saved
  • External URL list restored
  • Managed JS file saved
  • Managed JS file deleted
  • Managed JS file restored
  • Preferences saved (via Dashboard or WP-CLI)

Email Content

Each email includes:

  • Subject: describes the action and location (e.g., "Scriptomatic: Head Scripts saved")
  • Body: human-readable summary of what changed
  • Via: Dashboard, API, or CLI — showing which channel triggered the change
  • Footer: link to the admin profile page to opt out (for non-site-admin recipients)

Opting In (Other Administrators)

  1. Navigate to Users → Profile (or Users → Your Profile)
  2. Scroll to the Scriptomatic Notifications section
  3. Check "Send me email notifications for Scriptomatic script changes"
  4. Click Update Profile

The preference is stored in user meta: scriptomatic_notifications = '1'.

Only users with the manage_options capability (administrators) see this checkbox.


Opting Out

  • Site admin: cannot opt out — the site admin always receives notifications by design
  • Other administrators: uncheck the Scriptomatic Notifications checkbox on their WordPress profile page

Home

Clone this wiki locally