Voxel Multi Admin Notifications
The {CODICTS} Voxel Multi Admin Notifications plugin extends the Voxel Theme’s notification system so that admin notifications — both emails and in-app — are delivered to multiple users and/or user roles, not just the single site administrator.
Installation & Activation
Start by downloading the plugin from the Downloads page on your dashboard on the CoDicts website.
After downloading, install and activate the plugin in WordPress by navigating to “Plugins” > “Add New” > “Upload Plugin” and selecting the downloaded zip file. Click “Install Now” and then “Activate”.
Once activated, navigate to “Multi Admin Notifications” in the WordPress admin sidebar to configure your recipients.
What This Plugin Solves
Voxel’s built-in notification system can send admin notifications when events happen on your site — such as a new listing being created, an order being placed, or a message being sent. However, these admin notifications only go to one person: the site’s primary administrator.
If you have a team of moderators, managers, or support staff who also need to receive these notifications, Voxel doesn’t provide a way to do that out of the box.
This plugin solves that by automatically sending copies of every admin notification (both email and in-app) to additional users you choose — either by selecting entire user roles or by picking individual accounts.
Key Features
| Feature | Description |
|---|---|
| Role-Based Targeting | Select entire user roles (e.g., Editor, Shop Manager, custom roles) — all users with that role receive admin notification copies. |
| Individual User Targeting | Search and select specific user accounts via a live searchable dropdown. |
| Email Notifications | Sends email copies using Voxel’s async email queue with full dynamic tag rendering. |
| In-App Notifications | Creates in-app notification records so recipients see notifications in their Voxel dashboard. |
| Duplicate Prevention | The original admin recipient is automatically skipped, so they don’t get a double notification. |
| Zero Configuration per Event | Works automatically for every Voxel event that has admin notifications enabled — no per-event setup needed. |
How It Works
The plugin monitors every Voxel app event that has admin notifications enabled (either email, in-app, or both). When one of those events fires, the plugin:
1. Resolves the full list of additional recipients from your settings (roles + individual users).
2. Skips any recipient whose email matches the original admin, to prevent duplicates.
3. For each remaining recipient, sends an in-app notification (if in-app is enabled for the event) and queues an email notification (if email is enabled for the event).
The email subject and message use the same templates and dynamic tags as the original admin notification — so your additional recipients receive exactly the same content the primary admin would see.
Note: You don’t need to configure anything on a per-event basis. Once you set your recipient roles and users, the plugin automatically applies to every Voxel event that has admin notifications turned on.
Before You Start
This plugin sends copies of Voxel’s existing admin notifications. For it to work, you need to have admin notifications already enabled in Voxel:
1. In the Voxel admin, go to your app event settings.
2. For each event where you want multi-admin notifications, ensure the admin notification destination is configured and that email and/or in-app notifications are enabled for that destination.
If no admin notifications are enabled for an event in Voxel, the plugin has nothing to copy and won’t fire for that event.
Configuring Recipients
Navigate to “Multi Admin Notifications” in the WordPress admin sidebar.
Option 1: Select User Roles
Under “User Roles”, check the roles whose members should receive admin notification copies. All users belonging to the selected roles will be included.
The list shows all editable WordPress roles on your site, including default roles (Administrator, Editor, Author, etc.) and any custom roles (e.g., Shop Manager, Listing Manager).
Example: If you check “Editor” and your site has 3 editors, all 3 will receive copies of every admin notification.
Option 2: Select Individual Users
Under “User Accounts”, use the searchable dropdown to find and select specific users. Type at least 2 characters to search by name or email address.
You can select as many users as needed. Each selected user appears as a tag in the dropdown.
Using Both Options Together
You can use roles and individual users at the same time. The plugin merges both lists and removes duplicates automatically. If a user appears in a selected role and is also individually selected, they’ll only receive one copy of each notification.
Example setup:
| Selection | Result |
|---|---|
| Roles: Editor, Shop Manager | All editors and shop managers receive notifications. |
| Individual users: Jane (Subscriber) | Jane also receives notifications, even though she’s not in a selected role. |
Save
Click “Save Changes”. The plugin is now active — no further configuration is needed per event.
Duplicate Prevention
The plugin automatically prevents the original admin from receiving double notifications. If the primary admin’s email matches one of the additional recipients, that recipient is skipped for that notification.
This means it’s safe to select the “Administrator” role if you have multiple admins — the primary admin who already receives the original notification won’t get a duplicate, but other administrators will receive their copies.
What Gets Sent
The plugin sends copies of both notification types that Voxel supports for admin destinations:
| Type | Description |
|---|---|
| An HTML email with the same subject and message as the original admin notification, rendered with Voxel’s dynamic tags (e.g., post title, author name, site name). Sent via Voxel’s async email queue so it doesn’t slow down page loads. | |
| In-App | A notification record that appears in the recipient’s Voxel notification center, with the unread count updated immediately. |
If an event only has admin email enabled (not in-app), only emails are sent to the additional recipients. If only in-app is enabled, only in-app notifications are created. If both are enabled, both are sent.
Troubleshooting
“Voxel Theme Not Detected” Error
Ensure the Voxel Theme is installed and set as the active theme. Go to Appearance → Themes to verify.
Additional Users Not Receiving Notifications
| Cause | Solution |
|---|---|
| No roles or users selected | Navigate to the plugin settings and select at least one role or individual user. |
| Admin notification not enabled in Voxel | The plugin only works for Voxel events that have admin email and/or in-app notifications enabled. Check your Voxel event notification settings. |
| Recipient has same email as original admin | The plugin intentionally skips recipients whose email matches the original admin to prevent duplicates. This is expected behavior. |
| Emails delayed or missing | Email notifications are dispatched via Voxel’s async queue, which relies on WP-Cron. Ensure WP-Cron is functional. If DISABLE_WP_CRON is set to true, set up a server-side cron job. |
User Search Not Working in Settings
| Cause | Solution |
|---|---|
| Too few characters typed | Type at least 2 characters to trigger the search. |
| CDN blocked | The search dropdown uses Select2, loaded from a CDN. Check that your server or browser isn’t blocking requests to cdnjs.cloudflare.com. |
| Session expired | Refresh the settings page to regenerate the security token, then try searching again. |
Duplicate Notifications
The plugin prevents duplicates in two ways: it skips the original admin recipient by email comparison, and it deduplicates the recipient list so users who appear in multiple selected roles only receive one notification. If you’re still seeing duplicates, check whether another plugin is also hooking into the same Voxel events and sending its own notifications.
For further support, visit codicts.com or contact us at support@codicts.com.