Appearance
Pending Posts Badge
The Pending Posts Badge function displays a count of pending posts in the WordPress admin menu. Quickly see how many posts await review without navigating to each post type.
Overview
Stay on top of pending content with visual badges that show exactly how many posts need attention. Similar to the comments badge WordPress shows, but for any post type you choose.
Key Features
- Visual pending count badges in admin menu
- Configurable per post type
- Customizable badge colors
- Auto-updating counts (every 30 seconds)
- Works with all post types including Voxel custom types
- Animation on count changes
Setup Instructions
Step 1: Enable the Function
- Navigate to Voxel Toolkit → Functions in your WordPress admin
- Find Pending Posts Badge in the list
- Toggle the switch to enable the function
- Click Save Changes
Step 2: Select Post Types
- In the Post Types section, check which post types should show pending badges
- Common selections: Posts, Pages, and Voxel custom post types (places, events, etc.)
- Click Save Changes
Step 3: Customize Colors (Optional)
- Set Background Color for the badge (default: #d63638 – red)
- Set Text Color for the count number (default: #ffffff – white)
- Click Save Changes
How It Works
Badge Display
Badges appear next to the post type name in the admin menu:
- Posts 5
- Places 12
- Events 3
Automatic Updates
- Badges update automatically every 30 seconds via AJAX
- When count changes, the badge briefly animates (pulse effect)
- Badge disappears when count reaches zero
Color Customization
Choose colors that fit your admin color scheme or stand out appropriately:
| Color Purpose | Suggested Colors |
|---|---|
| Urgent (default) | Red (#d63638) |
| Warning | Orange (#dba617) |
| Information | Blue (#2271b1) |
| Subtle | Gray (#646970) |
Use Cases
Content Moderation
Instantly see how many listings, posts, or submissions need review.
Editorial Workflow
Editors can quickly identify which content types have pending items.
Directory Management
For Voxel directory sites, see pending places, events, or other listing types at a glance.
Troubleshooting
Badge Not Appearing
- Ensure the function is enabled for the post type
- Verify there are actually pending posts (check the post list)
- Clear browser cache
- Check if another plugin is modifying the admin menu
Wrong Count Showing
- Count updates every 30 seconds – wait for refresh
- Refresh the page manually to get immediate count
- Check if posts are actually in “pending” status (not draft or other)
Badge Styling Issues
- Custom admin themes may override badge styles
- Adjust your custom colors if visibility is poor
- Check for CSS conflicts with other admin plugins