🛠️ AI Featured Image Replacer – Troubleshooting Guide (v1.2.6)
Version: 1.2.6
Developed by: MtradeIntl & Copilot
🔍 1. Enable WordPress Debug Mode (Advanced Users)
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);This creates a debug.log file inside /wp-content/ where errors are recorded.
📁 2. Locate Error Logs
/wp-admin/error_log/error_login the site’s root directory- Plugin’s internal log file (future versions may include this)
🧪 3. Test Plugin Functionality
- Select a provider: OpenRouter, Replicate, or Pexels
- Enter the correct API key
- Choose a category with published posts
- Set replacement mode: “Only if missing” or “Replace all”
- Use the “Run AI Image Replacement Now” button to test manually
Note: The plugin only processes posts with Published status. Drafts are skipped to avoid replacing images prematurely.
⏱️ 4. Cron Job Verification
- If the cron toggle is ON, images will be replaced hourly
- Disable cron by deactivating the plugin or using a cron manager plugin
🧼 5. Common Issues & Fixes
| Issue | Cause | Solution |
|---|---|---|
| No images replaced | Missing API key, empty category, or all posts are drafts | Check settings and ensure posts are published |
| Error in log | API timeout or invalid key | Verify API key and try again |
| Images have unwanted text | Prompt formatting issue | Plugin adds “no text on image” to prompts automatically |
| Plugin not working with theme | Theme conflict | Try switching to a default theme (e.g., Twenty Twenty-Four) |
📣 Support Tips
If you encounter issues, please check your site’s error logs or enable WP_DEBUG. You can also contact support with your log file and plugin settings.