Common Errors & Troubleshooting Solutions

This guide addresses the most frequent setup, display, and version update issues encountered in AdFuz and provides step-by-step diagnostic solutions.

---

1. Ads Not Showing on the Website

If your ad spaces or banners are blank or not rendering on the frontend of your site, follow this diagnostic checklist:

Cause A: Client-Side Ad Blockers

Browser extensions (such as uBlock Origin, AdBlock Plus, Brave Shield, or Privacy Badger) identify and suppress common ad-serving scripts, iframes, and CSS class names (e.g., .ad-banner, ads.js).

Resolution Steps:

1. Open your site in an Incognito / Private Window with all browser extensions disabled.
2. Temporarily pause your ad blocker for your domain and refresh the page.

---

Cause B: JavaScript Errors from Other Plugins / Themes

A syntax error or unhandled runtime exception in a 3rd-party plugin (e.g., minifiers, page builders, popups) can halt browser script execution before AdFuz’s rendering script executes.

1. Open your website in Chrome, Firefox, or Edge.
2. Right-click anywhere and select Inspect, then open the Console tab.
3. Look for red error messages (e.g., Uncaught TypeError: ...).
4. Note which file is triggering the error (e.g., wp-content/plugins/another-plugin/assets/script.js).
5. Temporarily deactivate the conflicting plugin under WordPress Admin > Plugins and test if your AdFuz ads start displaying.

Plugin Conflict Test

To isolate conflicts safely without impacting visitors, use the official WordPress Health Check & Troubleshooting plugin to test AdFuz in Troubleshooting Mode.

---

2. Recent Version Update Not Showing / Missing Columns

When updating the AdFuz plugin to a newer version (e.g., 1.2.9), new database columns, settings, or features (such as hide_link_name) might not reflect if an automated database migration was interrupted during background deployment.

How to Manually Run Database Migrations

1. Log in to your WordPress Admin Dashboard.
2. Go to AdFuz > Tools > Database Tools.
3. Switch to the Migrations tab.
4. Locate the migration corresponding to your version:
   • Version: e.g., 1.2.9
   • Description: Add hide_link_name column to ads and campaigns tables
   • Status: If it shows Pending or if schema changes are missing, click the blue Run button.
5. Once executed, the status will update to Applied and all new columns and features will immediately become active.

WordPress Admin
└── AdFuz
    └── Tools
        └── Database Tools
            ├── [Tables]
            └── [Migrations]  <-- Select this tab & click "Run"

---

Diagnostic Tools Summary

For deeper diagnostics, use our dedicated logging tools:

• File Logs Guide: Inspect raw GeoIP, system startup, and background cron logs in wp-content/uploads/ad-fuz/log/.
• Database Logs Guide: Track real-time user mutations, entity updates, and audit events stored in wp_adfuz_audit_logs.
• Database Migrations Guide: View schema upgrade history and run individual version patches.