When to use this
Use the official WordPress plugin when your website runs WordPress 6.4 or later with PHP 7.4 or later. It is the recommended installation method because it keeps the GDPRChecker connection separate from your theme and survives normal theme updates.
The plugin accepts the connection code shown in your GDPRChecker dashboard. It can publish the ownership-verification meta tag, extract the Site ID and Ping Token, and load the site-specific runtime on public pages without requiring you to edit header.php or footer.php.
If another consent platform already displays your cookie banner, enable monitor-only mode in the plugin's advanced settings. Do not run two consent banners on the same site.
Step-by-step instructions
- In WordPress Admin, open Plugins > Add New Plugin > Upload Plugin.
- Choose the current GDPRChecker plugin ZIP, select Install Now, and then activate GDPRChecker.
- In the GDPRChecker dashboard, create or select the WordPress site and open its ownership-verification step.
- Copy the complete verification meta tag shown by GDPRChecker.
- In WordPress Admin, open Settings > GDPRChecker, paste the code into Connection code, and select Connect site.
- Return to GDPRChecker and select Verify ownership. The WordPress plugin publishes the verification tag automatically.
- After verification succeeds, copy the complete installation script shown in Setup > Install Script.
- Paste that script into the same Connection code field in Settings > GDPRChecker and save again. The plugin stores only the values needed to connect the site.
- Remove any older manually inserted GDPRChecker snippet so the runtime loads only once.
- Open the public website in a private window, then return to GDPRChecker and re-check the connection.
Expected result
Settings > GDPRChecker displays Connected and protecting this site. On public pages, the plugin loads the GDPRChecker runtime with the correct Site ID and Ping Token, and the dashboard receives a fresh heartbeat.
The installation is independent of the active WordPress theme. Consent management, tracker blocking, and runtime verification are controlled by the configuration published from the GDPRChecker dashboard.
Troubleshooting
WordPress rejects the ZIP
Confirm you selected the plugin ZIP itself and that your hosting account permits plugin uploads. On managed WordPress hosting, an administrator may need to allow custom plugins or install it for you.
Ownership verification is not detected
Save the verification code in Settings > GDPRChecker, clear WordPress and CDN caches, and view the public page source while signed out. The gdprchecker-verification meta tag must appear in the page head.
The site remains offline after connecting
Paste the installation script after ownership is verified, confirm Enable GDPRChecker remains selected, clear optimization caches, and open the public site in a private window. Remove duplicate manual snippets and check that security tools are not blocking runtime.js.