Plugin Settings

After installing the plugin, go to AgeOnce in the WordPress admin sidebar to configure.

API Credentials

Status

Enable or disable the plugin.

• Enabled — Age verification is active
• Disabled — Plugin does not intercept content, checkout, or store signup

Client ID

Unique identifier of your client in AgeOnce.

• Get it from Dashboard Settings
• Create a new client if you don't have one yet

Client Secret

Secret key for API request authentication.

Redirect URI

The plugin automatically uses this callback URL (format ?ageonce_callback=1):

https://yoursite.com/?ageonce_callback=1

The exact URL for your site is shown in the plugin settings — copy it and add to allowed Redirect URIs in your Dashboard Settings.

For WordPress, always copy the exact URL shown by the plugin. This avoids problems with www vs non-www, HTTPS, subdirectories, or staging domains.

Test connection

After you enter the Client ID and Client Secret, click Test connection. A successful test confirms the site can reach AgeOnce with those credentials.

WooCommerce customer signup

This block appears when WooCommerce is active. It controls store customer accounts on the My Account page, not the AgeOnce merchant account.

• Require age verification before customers can sign up — off by default. When enabled, a guest must finish AgeOnce verification on the registration form before WooCommerce creates the account.
• Minimum age to create a store account — 16+, 18+, or 21+. Used only while signup verification is on.

WooCommerce must also allow account creation on My Account (woocommerce_enable_myaccount_registration). After a successful signup, the new customer stores verification status, Transaction ID, time, and the required age.

Content Rules

Content restriction is configured per post type (Pages, Posts, Products, etc.).

For each post type you can:

1. Enable/disable — Turn age verification on or off for that content type
2. Allow Manual Locking via Metabox — When enabled, you can protect individual pages, posts, or products. An AgeOnce Protection metabox will appear in the sidebar on the edit screen for each post/page/product. There you can enable protection separately for that specific item, regardless of its category.
3. Active Age Groups — Choose which age thresholds apply: 16+, 18+, 21+
4. Per-age rules — For each enabled age group (e.g. 18+ Rules), select taxonomy terms (Categories, Product Categories, etc.). Content in those terms will require verification for that age

Example

• Enable Products
• Check 18+ as active age group
• In 18+ Rules, select "Alcohol" in Product Categories
• All products in the Alcohol category, including products assigned only to a child category of Alcohol, will require 18+ verification

After Configuration

1. Save changes
2. Add the Redirect URI to Dashboard Settings
3. Test by opening a restricted page or adding an age-restricted product to cart and going to checkout

Helpful links

• AgeOnce pricing
• WordPress plugin page
• WooCommerce setup guide