WordPress
Installation
How to install the AgeOnce WordPress plugin
Plugin Installation
You can start with the AgeOnce free plan. Use it to connect WordPress, test checkout protection, and verify your setup before upgrading.
Before you start
- WordPress 5.0 or newer
- PHP 7.4 or newer
- HTTPS enabled on your site
- WooCommerce installed if you want checkout protection
- AgeOnce account with a free or paid plan
Automatic installation
Log in to the WordPress admin panel
Go to Plugins → Add New
Search for "AgeOnce Verification"
Click Install Now, then Activate
Manual installation
Download the plugin ZIP file
Extract the archive to /wp-content/plugins/ageonce-verification/
Activate the plugin via the Plugins menu in WordPress
After installation
After activating the plugin:
- Go to AgeOnce in the WordPress admin sidebar
- Copy the Redirect URI shown by the plugin
- Add that Redirect URI to Dashboard Settings
- Enter your Client ID and Client Secret in WordPress
- Save changes
- Configure WooCommerce products, categories, posts, pages, or custom post types that should require verification
The plugin will not work without configured API keys. Get them from Dashboard Settings (Client ID and Client Secret).
Verify installation
After configuration:
- Log out of WordPress (or use incognito mode)
- Open a protected page or add a restricted WooCommerce product to cart
- You should see the AgeOnce verification gate
- Complete verification and confirm that you return to the protected page or checkout
Troubleshooting
Plugin won't activate
- Check PHP version (7.4+ required)
- Check WordPress version (5.0+ required)
- Check permissions for the plugins folder
Verification doesn't work
- Verify API keys are correct
- Ensure Redirect URI (
https://yoursite.com/?ageonce_callback=1) is in Dashboard Settings - Check that the site uses HTTPS
- Confirm the product, category, post, or page is actually selected in Content Rules