Appearance
Suggest Edits
The Suggest Edits Widget allows visitors to suggest corrections or updates to post data. Version 1.6.1 adds a comment field for users to provide context with their suggestions.
What’s New in 1.6.1
- Comment Field: New optional field for users to explain their suggestion
- Comment Display: Admin review shows the suggester’s comment
Overview
This feature enables crowdsourced data maintenance by allowing users to suggest corrections to post fields. Site administrators can review, approve, or reject suggestions, keeping your directory data accurate and up-to-date.
Key Features
- Crowdsourced data corrections
- Configurable fields per post type
- Proof image uploads
- Comment field for context (NEW)
- “Don’t know” checkbox option
- “Permanently closed” option
- Admin review interface
- App event notifications
- Guest and logged-in user support
Comment Field (New)
The new comment field allows users to provide additional context or explanation with their suggestions.
Benefits
- Users can explain why the data is incorrect
- Provide source information for the correction
- Add details that help administrators verify the suggestion
- Reduces back-and-forth communication
Widget Settings
| Setting | Description | Default |
|---|---|---|
| Show Comment Field | Enable the comment input field | Yes |
| Comment Label | Label text for the comment field | “Additional Comments” |
| Comment Placeholder | Placeholder text for the field | “Tell us more about this suggestion…” |
Admin Display
When reviewing suggestions in the admin panel, the suggester’s comment appears in the suggestion detail view, helping administrators make informed decisions about accepting or rejecting changes.
Setup Instructions
Step 1: Enable the Function
- Navigate to Voxel Toolkit → Functions
- Find Suggest Edits in the list
- Toggle the switch to enable
- Click Save Changes
Step 2: Configure Post Types
- Click the settings icon next to Suggest Edits
- Select which post types allow suggestions
- Configure fields available for suggestions
- Set user permissions
- Save your changes
Step 3: Add Widget to Template
- Edit your post type template in Elementor
- Search for Suggest Edits (VT)
- Drag the widget to your desired location
- Configure widget options including the new comment field
- Save the template
Widget Settings
Display Settings
| Setting | Description | Default |
|---|---|---|
| Button Text | Text on the trigger button | “Suggest an Edit” |
| Button Icon | Icon for the button | Edit icon |
| Modal Title | Title in the suggestion modal | “Suggest an Edit” |
| Fields to Show | Which fields users can suggest edits for | All enabled |
Form Options
| Setting | Description | Default |
|---|---|---|
| Show Comment Field | Enable comment input (NEW) | Yes |
| Show “Don’t Know” Checkbox | Allow marking data as incorrect without replacement | Yes |
| Show “Permanently Closed” | Option to report business as closed | Yes |
| Enable Photo Upload | Allow proof images | Yes |
| Max Photos | Maximum proof images allowed | 5 |
Supported Field Types
- Title
- Description
- Taxonomy fields (single/multi-term)
- Select/Multiselect
- Work hours
- Location/Address
- Custom text fields
- Featured image
Admin Review
Review pending suggestions from the WordPress admin:
- Navigate to the post type menu
- Click Suggested Edits submenu
- View pending suggestions (badge shows count)
- Click a suggestion to see details including the new comment field
- Review current vs. suggested values
- View proof images and suggester comment
- Accept, reject, or delete the suggestion
Bulk Actions
- Accept selected suggestions
- Reject selected suggestions
- Delete selected suggestions
Use Cases
Business Directory
Let users report outdated business information like changed hours, addresses, or phone numbers. The comment field helps them explain when they noticed the change.
Community-Maintained Data
Enable community members to help keep listings accurate, with comments providing verification details.
Permanently Closed Businesses
Users can report when businesses have closed permanently, helping keep your directory current.
App Events
The Suggest Edits function integrates with Voxel’s app event system:
Event: voxel_toolkit/suggestion:submitted
Available Data:
- Post information
- Author details
- Suggester information
- Suggestion details including comment
Use this to send notifications to post authors when suggestions are submitted.
Troubleshooting
Widget Not Showing
- Verify Suggest Edits function is enabled
- Check post type is enabled for suggestions
- Ensure user meets permission requirements
- Team members don’t see widget on their own posts
Comment Not Saving
- Check that “Show Comment Field” is enabled in widget settings
- Verify database table has the suggester_comment column
- Clear any caching
Suggestions Not Appearing in Admin
- Check you’re looking at the correct post type’s submenu
- Verify suggestions were submitted successfully
- Check status filter in the admin view
Requirements
- Voxel Theme (active)
- Voxel Toolkit plugin (enabled)
- Elementor (for widget)
- Post type configured for suggestions