Simplenews sending duration

Simplenews Sending Duration records when a Simplenews newsletter starts and finishes sending, so site administrators can monitor delivery times and use the timestamps for reporting.

Features

Simplenews Sending Duration records the start and end times of Simplenews newsletter delivery. It extends the existing simplenews_issue field with two additional properties:

• start_time: the Unix timestamp when newsletter sending begins.
• end_time: the Unix timestamp when newsletter sending finishes.

The module automatically updates these timestamps while Simplenews processes a newsletter:

• The start time is recorded when the first message is successfully sent or fails.
• The end time is recorded when all subscribers have been processed.
• An issue that is still being processed has a start time but no end time.

Once both timestamps are available, they can be used to calculate how long newsletter delivery took. This is useful for monitoring newsletter performance, identifying delivery delays, comparing sending times, and creating reports with Views.

Post-Installation

This module does not add a configuration page, content type, or additional user interface. After installation, it works automatically with the existing Simplenews newsletter issues.

Install the module with Composer:

composer require drupal/simplenews_sending_duration

Enable the module from the Extend page or with Drush:

drush en simplenews_sending_duration

When enabling the module on an existing site, run the database updates and rebuild the cache:

drush updatedb
drush cr

The module adds the required timestamp columns to the Simplenews issue field storage and revision tables. It also exposes the timestamps to Views as date fields and adds them to the default display of the simplenews_newsletters view:

• simplenews_issue_start_time — Sending start date.
• simplenews_issue_end_time — Sending end date.

The fields are placed immediately before the operations field when it is available. They can be configured, reordered, or removed from the view like any other Views field.

When uninstalling the module, its fields are removed from the default newsletter view display. Existing timestamp columns and values are not automatically removed from the database. Review or migrate this data before removing it if it is no longer required.

Additional Requirements

This module requires:

• Drupal 9, 10, or 11.
• Simplenews 3.x or 4.x.
• The Drupal core Node module.

Simplenews must be installed and enabled before enabling Simplenews Sending Duration.

Supporting this Module

Contributions, testing, documentation improvements, and issue reports are welcome through the Drupal.org project page and issue queue.

Community Documentation

For installation and usage information, see the project documentation and project page on Drupal.org.