Admin Notifications

The Admin Notifications function extends Voxel’s notification system to send admin notifications to multiple users based on roles and individual selection. This ensures important site events reach all relevant administrators.

Overview

By default, Voxel sends admin notifications to a single designated admin user. This function allows you to configure multiple recipients for all Voxel app events, either by role or by selecting specific user accounts.

Key Features

• Send admin notifications to multiple users
• Role-based recipient selection
• Individual user selection
• Works with all Voxel app events
• Includes email and in-app notifications
• Integrates with SMS Notifications (if enabled)

Setup Instructions

Step 1: Enable the Function

1. Navigate to Voxel Toolkit → Functions in your WordPress admin
2. Find Admin Notifications in the list
3. Toggle the switch to enable the function
4. Click Save Changes

Step 2: Configure Recipients

You can configure recipients in two ways:

By User Role

1. In the User Roles section, select which roles should receive admin notifications
2. All users with the selected roles will receive notifications
3. Common selections: Administrator, Editor, Shop Manager

By Individual User

1. In the Selected Users section, search for and select specific users
2. These users will receive notifications regardless of their role
3. Useful for including specific team members or managers

Note

The default Voxel admin user (set in Voxel Settings) will continue to receive notifications as usual. This function adds additional recipients without affecting the default behavior.

How It Works

Event Processing

When any Voxel app event fires (post submission, order placed, user registration, etc.):

1. Voxel processes the event normally (default admin receives notification)
2. This function identifies additional configured recipients
3. Each additional recipient receives the same notification (email and/or in-app)
4. If SMS Notifications is enabled, SMS is also sent to additional recipients

Notification Types

Type	Description
Email	Uses Voxel’s email templates with dynamic tags
In-App	Appears in user’s notification center
SMS	Sent if SMS Notifications is enabled and configured

Supported Events

This function works with all Voxel app events, including:

• Post submitted for review
• Post approved/published
• New user registration
• User login
• Order placed
• Order status changes
• Booking requests
• Review submissions
• Message notifications
• And all other Voxel app events

Use Cases

Multiple Administrators

Ensure all site administrators are notified of important events like new submissions or orders.

Department-Specific Notifications

Send notifications to specific team members based on their role (e.g., shop managers for orders).

Backup Notification Recipients

Add backup recipients to ensure notifications are seen even if the primary admin is unavailable.

SMS Integration

When the SMS Notifications function is also enabled:

• Additional admin recipients can also receive SMS notifications
• SMS is sent based on the same event triggers
• Recipients must have a phone number configured in their profile

Troubleshooting

Notifications Not Being Received

• Verify the function is enabled in Voxel Toolkit → Functions
• Check that users are properly selected (by role or individually)
• Ensure the event has admin notifications enabled in Voxel App Events
• Check email deliverability (spam folders, SMTP configuration)

Duplicate Notifications

If a user is both the default Voxel admin AND in your additional recipients list, they will only receive one notification (duplicates are filtered).

Some Events Not Triggering

• Ensure the event has admin notification enabled in Voxel’s App Events settings
• Check that the event is actually being triggered (use test scenarios)
• Verify Voxel theme is fully active and configured