MyListing Super Admin Dashboard
The {CODICTS} MyListing Super Admin Dashboard plugin gives site administrators a site-wide, aggregated view of all listing statistics directly on the frontend MyListing dashboard. By default, MyListing’s dashboard only shows stats for the logged-in user’s own listings. This plugin overrides that for admins, allowing them to see global stats across all listings and all users — published counts, pending counts, promotions, engagement tracking, referrers, devices, browsers, countries, and more — all from a single dashboard page.
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”.
That’s it — the plugin is zero-configuration. On activation, the dashboard templates are automatically copied to your child theme. Navigate to your frontend dashboard to see the enhanced admin stats immediately.
Key Features
| Feature | Description |
|---|---|
| Global Listing Stats | Admins see aggregated counts for all listings site-wide — published, pending, expired, and more — instead of only their own. |
| Promotion Overview | View the total number of active promoted listings across the entire site. |
| Engagement Tracking | Aggregated engagement metrics (phone clicks, website clicks, direction clicks, etc.) grouped by listing type. |
| Full Analytics Widgets | Site-wide views, unique views, devices, countries, referrers, platforms, browsers, and visit charts — all enhanced with global data. |
| All-Listings Filter | The listing filter dropdown shows all listings from all users, letting admins drill down into any listing’s stats. |
| Zero Configuration | No settings page or options to configure. Activate and it works automatically. |
| Non-Destructive | Regular users continue to see only their own stats. The admin enhancement is additive — it doesn’t change anything for non-admin users. |
How It Works
The plugin enhances the existing MyListing frontend dashboard — it doesn’t add new pages or widgets. Instead, it changes where the data comes from for admin users.
Admin vs Regular User
| Aspect | Regular User | Admin User |
|---|---|---|
| Stats scope | Own listings only | All listings, all users |
| Stat card data | Personal counts | Site-wide aggregated counts |
| Listing filter dropdown | Shows only own listings | Shows all listings from all users |
| Track/engagement stats | Own listing tracks | All tracks, grouped by listing type |
| Promotion count | Own promotions | All promotions site-wide |
Note: Admin detection is based on the
manage_optionsWordPress capability, which is held by Administrator-level users. Other roles (Editor, Subscriber, etc.) continue to see only their own stats.
Dashboard Stats Provided
When an admin user visits the frontend dashboard, the following sections display site-wide aggregated data:
Stat Cards
The top row shows four summary cards with global counts:
| Card | What It Shows |
|---|---|
| Published Listings | Total published listings across all users and all listing types. |
| Pending Listings | Total pending listings (includes both “pending approval” and “pending payment”). |
| Active Promotions | Total active promoted listing packages site-wide. |
| Visits This Week | Total listing page views in the last 7 days. |
Analytics Widgets
Below the stat cards, the existing MyListing analytics widgets display site-wide data:
| Widget | Description |
|---|---|
| Total Views | Aggregated page views across all listings. |
| Unique Views | Aggregated unique visitor counts. |
| Tracks by Type | Engagement metrics (phone clicks, website clicks, direction clicks, etc.) grouped by listing type — e.g., “Places: 2,450 phone clicks, 5,120 website clicks.” |
| Devices | Device breakdown (mobile, desktop, tablet) across all listing visitors. |
| Countries | Visitor country breakdown. |
| Visits Chart | Graphical visits chart over time. |
| Referrers | Traffic source breakdown. |
| Platforms | Operating system breakdown. |
| Browsers | Browser breakdown. |
Note: All dashboard widgets are controlled by MyListing’s built-in stats settings. If a widget is disabled in MyListing’s settings, it won’t appear on the dashboard even with this plugin active. The plugin enhances the data displayed — it doesn’t add new widgets.
Listing Filter Dropdown
The listing filter dropdown at the top of the dashboard is also enhanced for admins. Regular users see only their own listings in the dropdown, but admins see all listings from all users, allowing them to select any listing on the site and view its individual stats.
Example Usage
1. Activate the plugin with the MyListing theme and a child theme active. The dashboard templates are automatically copied.
2. Log in as an Administrator and navigate to the frontend My Account / Dashboard page.
3. The stat cards now show site-wide counts — for example, “Published Listings: 342” (all users’ listings combined) instead of just your personal listings.
4. Scroll down to the analytics widgets. The “Tracks by Type” section shows engagement metrics grouped by listing type. For example, under “Places” you see aggregated phone clicks, website clicks, and direction clicks across all place listings from all users.
5. Use the listing filter dropdown at the top to select any specific listing from any user on the site. The dashboard updates to show stats for that individual listing.
6. Log out and log in as a regular user (e.g., Subscriber). The dashboard shows only that user’s own listing stats — the plugin’s admin enhancement is invisible to non-admin users.
Frequently Asked Questions
Does this require a child theme?
Yes. The plugin copies dashboard template files into the child theme to override MyListing’s default dashboard behavior. Without a child theme, the plugin cannot install its templates.
Is there a settings page?
No. This is a zero-configuration plugin. It works automatically once activated. The only requirement is that MyListing and a child theme are active, and the logged-in user is an Administrator.
Which users see the enhanced dashboard?
Only users with the manage_options capability (WordPress Administrators). All other user roles continue to see only their own listing stats — the plugin changes nothing for them.
Does this add new widgets to the dashboard?
No. The plugin enhances the existing MyListing dashboard widgets with site-wide data instead of per-user data. If a widget is disabled in MyListing’s stats settings, it won’t appear even with this plugin active.
Can admins still view stats for a single listing?
Yes. The listing filter dropdown at the top of the dashboard shows all listings from all users. Select any listing to view its individual stats.
Does this affect regular users’ dashboards?
No. Regular users (non-administrators) continue to see only their own listing stats. The admin enhancement is completely additive and invisible to other users.
Why are stats not updating immediately?
MyListing has its own internal caching for statistics. After making changes (publishing/unpublishing listings, changing promotions), the dashboard stats may take a few moments to reflect the updated data. There is no manual cache purge for this system.
What happens when I deactivate the plugin?
The dashboard template files are removed from the child theme and MyListing’s original dashboard behavior is fully restored — all users see only their own stats again.
Does the plugin create any database tables?
No. The plugin stores only a single value in the options table to track the installed template version. No custom database tables, user meta, or other persistent data is created.
Troubleshooting
Dashboard Still Shows Personal Stats for Admin
| Cause | Solution |
|---|---|
| Templates not installed | Deactivate and reactivate the plugin to force-reinstall the dashboard templates. Verify that templates/dashboard/dashboard.php exists in your child theme. |
| Conflicting template override | Another plugin or child theme customization may be overriding the same dashboard.php template. Check for conflicting template files in your child theme. |
| User is not an Administrator | The plugin checks for the manage_options capability. Verify the user’s role is Administrator in Users → All Users. |
| Plugin not activated | Go to Plugins → Installed Plugins and verify the plugin is active. |
Stats Not Updating
| Cause | Solution |
|---|---|
| MyListing stats caching | MyListing caches statistics internally. Wait a few moments for the cache to refresh. There is no manual purge for this system. |
Listing Filter Dropdown Not Showing All Listings
| Cause | Solution |
|---|---|
| Template not installed | The stats/select-listing.php template must be installed in the child theme. Deactivate and reactivate the plugin to re-copy templates. |
| Not an Administrator | Only Administrator-level users see all listings in the dropdown. Other roles see only their own. |
Template Overwrite Warning
The following template files in your child theme are managed by this plugin and will be overwritten on activation and updates:
templates/dashboard/dashboard.php
templates/dashboard/stats/select-listing.php
If you’ve customized these files, back up your changes before updating the plugin or deactivating/reactivating it.
“MyListing Theme Not Detected” or “Child Theme Not Detected” Error
The MyListing theme and a child theme must both be installed and active. Go to Appearance → Themes to verify.
For further support, visit codicts.com or contact us at support@codicts.com.