Everything is on WooCommerce → Private Store (capability manage_woocommerce). Both editions use two options:
gmpv_settings— the switches below;gmpv_rules— the list of protection rules.
The free edition edits one rule, stored in gmpv_rules under the fixed id private-store. It never touches other rules in the list.
Protection
Enforce the rules below / Only signed-in customers may see the shop
- Key:
enabled· Default: off (no) - The master switch. Off, nothing is protected and no page is affected.
- Full edition: protection also needs at least one rule.
- Free edition: the label is Only signed-in customers may see the shop. With it on, the free edition's rule applies (the whole shop unless you chose categories).
Hide protected products and categories from listings, search and menus
- Key:
hide· Default: on (yes) - On: protected products leave shop, category, tag and search queries; WooCommerce is told they are not visible; protected categories are left out of category lists and menus.
- Off: protected products stay listed, but their pages are refused and they cannot be bought.
When someone is refused — Full edition
- Key:
refused· Default: Show them the reason (and the password box) (message)
| Choice | Key value | What a refused visitor gets |
|---|---|---|
| Show them the reason (and the password box) | message |
The "This area is private" page with the reason and either a Sign in button or a password box |
| Send them to sign in | login |
Redirected to the sign-in page, then back. For a password rule, the password page is shown instead, because signing in cannot lift a password |
| Show "not found" | 404 |
A 404 page. For a password rule, the password page is shown instead, because a 404 has no box to type the password into |
Free edition: always the first choice, with a Sign in button.
Sign-in page — Full edition
- Key:
login_url· Default: empty — your WooCommerce My Account page (or the WordPress login page if there is none) - Where the Sign in button and the Send them to sign in mode go. The visitor's page is added as
redirect_to. - Free edition: always your My Account page.
A password stays unlocked for — Full edition
- Key:
unlock_ttl· Default:86400seconds (one day) - Range: one hour (3600) to one year. Values outside are clamped.
- How long the browser remembers a correct password. Changing a rule's password closes every unlock already handed out, whatever this says.
The free edition's rule
Protect
- Key: the rule's
scope· Default: The whole shop (store) - The whole shop or These categories.
Category ids
- Key: the rule's
terms· Default: empty - Comma-separated product-category ids. Sub-categories are included.
- If you choose These categories and leave this empty, the rule is saved as The whole shop: a category rule naming nothing would look protected and protect nothing.
If the rule was written by the full edition with a password or roles, the free edition shows a note instead of these controls and leaves the rule untouched. It reads that rule the strictest way: the area stays protected from everybody except people who can edit products.
Rules — Full edition
Each row under Rules is one rule. Add a rule adds a row; Remove this rule deletes it on save.
| Field | Key | What it does |
|---|---|---|
| Name | label |
For you. Also the source of the rule's id |
| Covers | scope |
store (the whole shop), categories or products |
| Category ids | terms |
Comma-separated; sub-categories included |
| Product ids | products |
Comma-separated; a variable product's variations follow it |
| Who may see it | access |
login (anyone signed in), roles, password |
| Roles | roles |
Comma-separated role slugs, for example wholesale_customer, customer. guest means visitors who are not signed in |
| Password | password |
Type to set or change. Stored hashed; the box stays empty and says "Set — type to change it" |
| What a refused visitor reads | message |
Empty uses a sentence matching the reason |
Rules that would do nothing are corrected or dropped on save:
- a category or product rule with no ids is not saved;
- a role rule with no roles becomes Anyone signed in;
- a password rule with no password becomes Anyone signed in;
- an unknown scope becomes The whole shop, an unknown access becomes Anyone signed in — the strictest reading, never the loosest.
Two rules never share an id; a repeated name gets -2, -3 and so on.
About page caches
Not a setting. While protection is on, every storefront page is sent with no-cache headers and DONOTCACHEPAGE is defined. See How it works.
License & updates — Full edition
Enter the GM-XXXXX-… key from your gatemi.com account and press Activate. If a check cannot reach gatemi.com, the licence state is left unchanged. Without a key the plugin makes no external requests.
