Common Problems
This article outlines common issues that may occur when using WPComplete, along with quick checks and solutions. Many problems are related to user roles, theme conflicts, or shortcode formatting.
1. No Stats in Admin Area
If statistics are not appearing in the admin area while testing a button:
- Check the user role. For example, if WPComplete is tracking authors but the test is being done as an administrator, the activity may not be recorded.
2. Button Doesn’t Show Automatically
If WPComplete is set to automatically display completion buttons but none appear:
- Confirm that the correct content type is selected (e.g., posts, pages, or custom post types).
3. No Buttons Are Visible
If no WPComplete buttons are visible at all:
- Make sure the user is logged into WordPress. Buttons are only shown to logged-in users.
4. Theme Conflicts
If buttons or progress bars are not showing:
- Some themes or builders may block WPComplete from working correctly.
- Known incompatible themes include:
- OptimizePress
- Beaver Builder
These are not supported by WPComplete.
5. Caching Plugin Issues
If caching is preventing WPComplete shortcodes from displaying correctly:
- Add the
async="true"attribute to shortcodes. This helps bypass caching conflicts.
6. Curly Quote Errors in Shortcodes
WordPress requires straight quotes for shortcode attributes. Using curly quotes will cause shortcodes to fail.
Correct:
[wpc_button name="name"]
Incorrect:
[wpc_button name=“name”]
This rule applies to all WordPress plugins, not just WPComplete.
Conclusion
Most WPComplete issues can be resolved by confirming the correct settings, avoiding incompatible themes, and ensuring shortcode formatting is accurate. If problems persist after checking these common issues, further troubleshooting may be required based on the specific site setup.
