Email Reports for Bricks Builder Form Submissions

Açıklama

Email Reports for Bricks Builder Form Submissions reads submissions already saved by Bricks Builder and sends them as CSV email attachments.

The plugin does not create forms or replace the Bricks Builder submissions screen. It adds scheduled and manual email reporting for existing saved submissions.

Features

• Automatically discovers every Bricks Builder form represented in the saved submissions table.
• Sends weekly reports on the weekday and time selected by an administrator.
• Supports manual reports for an inclusive date range and administrator-selected recipients.
• Creates one CSV attachment per discovered form.
• Sends all per-form CSV files in one email.
• Uses human-readable Bricks Builder form names and field labels when their metadata is available.
• Tracks scheduled exports independently for each form so submissions are not skipped.
• Advances scheduled checkpoints only after WordPress accepts the complete email through wp_mail().
• Allows empty scheduled reports to be enabled or disabled.
• Leaves Bricks Builder submissions unchanged.

Requirements

• WordPress 6.0 or newer.
• PHP 7.4 or newer.
• The Bricks theme with forms that use the Save submission action.
• A working WordPress mail configuration.

Scheduled reports

Scheduled reports include new submissions from all discovered Bricks Builder forms. Each form has its own checkpoint containing the highest successfully exported submission ID.

When empty-report sending is disabled, forms without new submissions are omitted. If every form is empty, the run completes without sending an email. When empty-report sending is enabled, the email contains one CSV for every discovered form, including empty CSV files.

Scheduling uses WP-Cron in the WordPress site’s configured timezone. WP-Cron is traffic-driven, so a report can run later than its configured time when the site receives no requests near that time.

Manual reports

Manual reports include every discovered Bricks Builder form for the selected inclusive date range. Each form receives its own CSV, including forms with no submissions in that period.

Manual reports never read, change, or advance scheduled checkpoints.

CSV attachments

CSV files use UTF-8 with a byte-order mark for spreadsheet compatibility. Each CSV starts with the submission ID and submission date, followed by the fields discovered for that form.

The plugin uses Bricks Builder field labels when possible, leaves missing values blank, formats array values with a readable separator, and includes file URLs, filenames, or attachment references for file fields.

Temporary files receive real .csv basenames before they are attached and are deleted after wp_mail() returns.

Privacy and data handling

Form submissions can contain personal data, including names, email addresses, telephone numbers, messages, uploaded-file references, and other information configured by the site owner.

This plugin reads submission data from the site’s Bricks Builder submissions table and temporarily writes CSV files on the WordPress server. Those temporary files are deleted after the mail operation finishes.

Reports are sent only to email addresses entered by a user with the manage_options capability. Delivery uses the site’s existing wp_mail() configuration and may pass through an SMTP or email service configured by the site owner.

The plugin does not send submission data to the plugin author and does not provide its own external mail or tracking service. Site owners are responsible for selecting authorized report recipients and complying with applicable privacy requirements.