View Categories

Notifications, Alerts & Shortcodes

Table of Contents

This page documents the notification triggers added by the plugin, the daily failure scan (admin notice + email), the developer filter for customizing failure emails, and the available shortcodes.

Notification Triggers #

The plugin adds three event triggers you can use when configuring Gravity Forms → Notifications for a form that has a Recurring Submissions feed.

  • Successful Resubmission
    Fires when an automated resubmission completes and a new child entry is created.
  • Failed Resubmission
    Fires when an automated attempt to resubmit fails (e.g., validation failure). No entry is created and payment feeds do not run.
  • Series Completion
    Fires when the last expected resubmission for a series completes (based on your limit settings).

Configure message body, recipients, conditional logic, etc., as you would for any standard Gravity Forms notification.

Daily Failure Scan: Admin Notice & Email #

The plugin performs a once‑daily scan for failed resubmissions.

Admin Notice (Dashboard) #

  • Displays a dismissible notice listing all series with failures.
  • Each item includes the entry link and basic failure information.
  • Dismissal lasts until the next daily scan.

Failure Email #

  • Sent to the address set in GravityOps → Recurring Submissions → Settings → Error Email Recipient.
  • If blank, it sends to the Site Admin Email.
  • Contains the same failures plus additional details (timestamps, counts, links).

Filter: rfsfgf_auto_form_submissions_failed_entries #

Developers can customize the data included in the failure email using this filter.

Important: The plugin expects a specific data structure. Review the source before modifying to ensure compatibility.

Common use: Redirect email links to a custom interface (e.g., a GravityView page) instead of the default WP Admin entry screen.

Example:

add_filter( 'rfsfgf_auto_form_submissions_failed_entries', function ( $failed_entries ){
    foreach ($failed_entries as $index => $entry) {
        $gf_entry = GFAPI::get_entry( $entry['entry_id'] );
        $entry['view_entry'] = get_home_url() . "some/path/to/GravityView/view";
        $entry['invoice_number'] = $gf_entry['5'];

        $failed_entries[$index] = $entry;
    }
    return $failed_entries;
});

Shortcodes #

Overview Table #

[rfsfgf_overview]
  • Output: A front‑end table mirroring the admin overview: Entry, Form, Feed Name, Feed Label, Next Submission, Progress, Status.
  • Notes: Pair with your membership/role plugin to restrict visibility as needed.

Entry Widget #

[rfsfgf_entry_widget form_id="{form_id}" entry_id="{entry_id}"]
  • Output: The same Entry Meta Box UI shown on the entry page, including status and action buttons.
  • Parameters:
    • form_id – Required; the form containing the entry.
    • entry_id – Required; the specific entry to display/manage.
  • Usage: Ideal for client or staff portals to expose series controls on the front‑end.

Operational Notes #

  • Series with outstanding failures are not marked complete until each failure is either successfully retried or manually Marked as Fixed from the entry widget.
  • Notification triggers operate independently from the daily scan; you can use both for proactive and batched alerting.
What are your Feelings