WordPress Plugin

The NotiGrid WordPress plugin allows you to send notifications directly from your WordPress site for events like new user registrations, form submissions, WooCommerce orders, and more.

Installation

Method 1: WordPress Admin Dashboard

Download the plugin from notigrid.com/wordpress
Go to Plugins → Add New in your WordPress admin
Click Upload Plugin
Choose the downloaded .zip file
Click Install Now
Activate the plugin

Method 2: Manual Installation

Download and extract the plugin files
Upload the notigrid-wordpress folder to /wp-content/plugins/
Activate the plugin through the Plugins menu in WordPress

Configuration

1. Get Your API Key

Log in to your NotiGrid dashboard
Navigate to Settings → API Keys
Create a new API key with appropriate permissions
Copy the API key

2. Configure the Plugin

In WordPress admin, go to Settings → NotiGrid
Paste your API key in the API Key field
Enter your Organization ID (found in your NotiGrid dashboard)
Click Save Settings

3. Test the Connection

Click the Test Connection button to verify your settings are correct.

Supported Events

The plugin can automatically send notifications for these WordPress events:

User Events

New User Registration - When a new user signs up
Password Reset - When a user requests a password reset
User Role Change - When a user's role is updated

Post Events

New Post Published - When a post is published
Post Updated - When a post is modified
Comment Posted - When someone comments on a post

WooCommerce Events (if WooCommerce is installed)

New Order - When a customer places an order
Order Completed - When an order is marked as completed
Order Refunded - When an order is refunded
Low Stock Alert - When a product stock is low

Form Events

Contact Form 7 Submission - Form submission notifications
Gravity Forms Submission - Form submission notifications
WPForms Submission - Form submission notifications

Configuration Options

Event Settings

For each event type, you can configure:

Enable/Disable - Toggle notifications for this event
Channel - Choose email, SMS, push, or Slack
Template - Select a notification template
Recipients - Define who receives the notification
Conditions - Set rules for when to send (e.g., order value > $100)

Template Variables

Each event provides specific variables you can use in your templates:

User Registration:

{{user_email}}
{{user_name}}
{{site_name}}
{{login_url}}

New Order:

{{order_id}}
{{order_total}}
{{customer_name}}
{{customer_email}}
{{order_items}}
{{order_status}}

Form Submission:

{{form_name}}
{{submission_date}}
{{field_*}}  // Any form field (e.g., {{field_email}})

Custom Triggers

You can also send custom notifications programmatically using the NotiGrid API:

// Send a custom notification
if (function_exists('notigrid_send')) {
    notigrid_send([
        'channel' => 'email',
        'to' => 'user@example.com',
        'template' => 'welcome-email',
        'data' => [
            'name' => 'John Doe',
            'custom_field' => 'value'
        ]
    ]);
}

Hooks and Filters

Actions

notigrid_before_send - Fired before a notification is sent

add_action('notigrid_before_send', function($notification) {
    // Modify notification before sending
    error_log('Sending notification: ' . $notification['template']);
});

notigrid_after_send - Fired after a notification is sent

add_action('notigrid_after_send', function($notification, $result) {
    // Log successful sends
    if ($result['success']) {
        update_option('notigrid_last_send', time());
    }
}, 10, 2);

Filters

notigrid_notification_data - Modify notification data

add_filter('notigrid_notification_data', function($data, $event_type) {
    if ($event_type === 'new_order') {
        $data['custom_field'] = 'Additional info';
    }
    return $data;
}, 10, 2);

notigrid_should_send - Control whether to send notification

add_filter('notigrid_should_send', function($should_send, $event_type, $data) {
    // Don't send for test orders
    if ($data['order_status'] === 'test') {
        return false;
    }
    return $should_send;
}, 10, 3);

Troubleshooting

Notifications Not Sending

Check API Key - Verify your API key is correct and active
Check Organization ID - Ensure the organization ID matches your account
Review Event Settings - Confirm the event is enabled
Check Logs - View logs at Settings → NotiGrid → Logs
Test Connection - Use the test connection button

Debug Mode

Enable debug mode to log detailed information:

// Add to wp-config.php
define('NOTIGRID_DEBUG', true);

Logs will be written to /wp-content/debug.log

Requirements

WordPress 5.0 or higher
PHP 7.4 or higher
Active NotiGrid account
cURL support enabled

Support

Documentation: docs.notigrid.com
Support: support@notigrid.com
GitHub: github.com/notigrid/wordpress-plugin

WordPress Plugin

On this page