Whitelabelling, Access and Domain Control

Whitelabelling, Access and Domain Control allow you to:

Change the name of the Plugin
Hide and prevent editing of your License Key
Define bespoke Documentation and Support URLs
Choose which Menu items to display in the WordPress Administration interface
Define which WordPress Users always have access to the Plugin
Define which sites have access to the Plugin

Purchase an Agency License

If you don’t already have an Agency License, you’ll need to purchase a new license, or upgrade an existing license.

To purchase a new license, visit the applicable Plugin Page
- Page Generator Pro
- WordPress to Buffer Pro
- WordPress to Hootsuite Pro
- WordPress to SocialPilot Pro
To upgrade an existing license, login to your Account and click Upgrade beside your existing license

You cannot sell the Plugin to your clients, however you are free to install it on your client’s WordPress sites if you are offering paid services in conjunction with the Plugin – such as web design, web development, content generation, SEO etc. Please review the full Terms and Conditions here.

Enable Whitelabelling, Access Control and Domain Control

Once you have an Agency license, you’ll need to manage its settings by:

Logging to your Account
Click on the License Keys tab
Click the Manage button beside the Agency License
Set Enable Whitelabelling, Access Control and Domain Control = Yes
Click the Save Changes button

Page Generator Pro: Whitelabelling and Access Control: Enable

Configure Whitelabelling

On the Manage License Key screen, several options are displayed. When defined, they will be used by the Plugin in place of the Plugin’s Default Value:

Setting	Accepted Value(s)	Default Value
Product Display Name The name that you want to display throughout the Plugin	`string`	Page Generator Pro WordPress to Buffer Pro WordPress to Hootsuite Pro WordPress to SocialPilot Pro
`Author Name` The author name that you want to display on the Plugins screen, replacing “WP Zinc”	`string`	WP Zinc
`Support URL` The URL to take the user to when they click on a Support link or button	`url` or `mailto:email@somewhere.com`	https://www.wpzinc.com/support
`Documentation URL` The URL to take the user to when they click on a Documentation link or button	`url` or `mailto:email@somewhere.com`	The WP Zinc Documentation URL for the applicable Plugin
`Changelog URL` The URL to take the user to when they click on a Changelog link or button	`url`	The WP Zinc Changelog URL for the applicable Plugin

Click Save Changes when done.

Configure Access Control

On the Manage License Key screen, several options are displayed. When defined, they will be used by the Plugin in place of the Plugin’s Default Value:

Values must be in lowercase.

Setting	Accepted Value(s)	Default Value
Show Main Menu Must be enabled for other settings to take effect.	`boolean`	`true`
Show Sub Menus Define the Product Submenus that Users have access to. If “Show Main Menu” is disabled, no Sub Menus will display. One value per line.	Page Generator Pro: `settings keywords generate logs import_export support`WordPress to Buffer, Hootsuite, SocialPilot Pro: `settings bulk_publish logs import_export support`	`null`
`Permitted Users` Define any WordPress Users who will always have access to all of the Product, regardless of any other Access Control settings. WordPress User IDs, WordPress Usernames and WordPress Username’s Registered Email Addresses are accepted. One value per line.	`string`	`null`

Click Save Changes when done.

Changes can take up to 24 hours to propagate. To force a refresh on the site(s) in question, deactivate and re-activate the Plugin and then either navigate to to the Plugin’s Licensing screen and/or Dashboard > Updates

Configure Domain Control

If you only want to permit Domains / Site URLs listed in the Domains section of the Manage License Key screen to be able to use this Agency License Key, you’ll need to enable the Only Permit Below Domains option:
Page Generator Pro: Whitelabelling and Access Control: Domain Control

If this option is not enabled, installation and activation of the Plugin with your Agency License Key will work on any site.

Configure Domains

On the Manage License Key screen, you can:

View current domains your license has been used on
Change domain / site URL’s
Remove domains / site URL’s
Add domains / site URL’s

Configure Domains: Add Domain

If Only Permit Below Domains is enabled, you must specify the domain(s) / site URL(s) that are permitted to use the Agency license.

Page Generator Pro: Manage Domains

To add a Domain that can use this License:

Click the Add Domain button
Define the Domain
- Domains must match the URL at the given WordPress site’s WordPress Admin > Settings > General > WordPress Address (URL), excluding http:// or https://
- For example, if a site is installed at https://www.example.com, use www.example.com
- If a site is installed at https://somesite.example.com, use somesite.example.com
- If a site is installed at https://www.example.com/site, use www.example.com/site
Repeat for any other Domains you want to add
Click the Save Changes button

Configure Domains: Edit Domain

If Only Permit Below Domains is not enabled, changing a domain on an Agency license will not prevent that WordPress installation from subsequently re-registering.

Page Generator Pro: Manage Domains

To edit/change an existing Domain that can use this License:

Find the domain in the list
Change the domain as necessary
- Domains must match the URL at the given WordPress site’s WordPress Admin > Settings > General > WordPress Address (URL), excluding http:// or https://
- For example, if a site is installed at https://www.example.com, use www.example.com
- If a site is installed at https://somesite.example.com, use somesite.example.com
- If a site is installed at https://www.example.com/site, use www.example.com/site
Repeat for any other Domains you want to change
Click the Save Changes button

Configure Domains: Delete Domain

If Only Permit Below Domains is not enabled, deleting a domain on an Agency license will not prevent that WordPress installation from subsequently re-registering.

Page Generator Pro: Manage Domains

To remove an existing Domain that can use this License:

Find the domain in the list
Click the Remove Domain button
Repeat for any other Domains you want to remove
Click the Save Changes button

Configure Whitelabelling: wp-config.php

Whitelabelling can be configured on a site’s wp-config.php file, by adding the following lines above /* That's all, stop editing! Happy blogging. */

Replace PRODUCT-NAME in the below constants with the applicable Plugin Name:

Plugin Name	Constant Prefix
Page Generator Pro	`PAGE-GENERATOR-PRO`
WordPress to Buffer Pro	`WP-TO-BUFFER-PRO`
WordPress to Hootsuite Pro	`WP-TO-HOOTSUITE-PRO`
WordPress to SocialPilot Pro	`WP-TO-SOCIALPILOT-PRO`

define( 'PRODUCT-NAME-LICENSE_KEY', 'your license key here' );
define( 'PRODUCT-NAME_DISPLAY_NAME', 'Your Whitelabelled Name' );
define( 'PRODUCT-NAME_AUTHOR_NAME', 'Your Company Name' );
define( 'PRODUCT-NAME_SUPPORT_URL', 'http://www.your-support-url.com' );
define( 'PRODUCT-NAME_DOCUMENTATION_URL', 'http://your-documentation-url.com' );
define( 'PRODUCT-NAME_CHANGELOG_URL', 'http://your-changelog-url.com' );

Where a constant is specified in your wp-config.php file, it will replace the Default Value listed below.

Constant	Accepted Value(s)	Default Value
`PRODUCT-NAME-LICENSE_KEY` Your license key	`string`	`null`
`PRODUCT-NAME_DISPLAY_NAME` The name that you want to display throughout the Plugin	`string`	Page Generator Pro WordPress to Buffer Pro WordPress to Hootsuite Pro WordPress to SocialPilot Pro
`PRODUCT-NAME_AUTHOR_NAME` The author name that you want to display on the Plugins screen, replacing “WP Zinc”	`string`	WP Zinc
`PRODUCT-NAME_SUPPORT_URL` The URL to take the user to when they click on a Support link or button	`url` or `mailto:email@somewhere.com`	https://www.wpzinc.com/support
`PRODUCT-NAME_DOCUMENTATION_URL` The URL to take the user to when they click on a Documentation link or button	`url` or `mailto:email@somewhere.com`	The WP Zinc Documentation URL for the applicable Plugin
`PRODUCT-NAME_CHANGELOG_URL` The URL to take the user to when they click on a Changelog link or button	`url`	The WP Zinc Changelog URL for the applicable Plugin

For Multisite installations, it’s required that you specify the license key in wp-config.php where you wish to Network Activate a Plugin and not have to manually enter the license key for each Site on the Multisite Network. See Documentation

Configure Access Control: wp-config.php

Access Control can be configured on a site’s wp-config.php file, by adding the following lines above /* That's all, stop editing! Happy blogging. */

define( 'PRODUCT-NAME_SHOW_MENU', true );
define( 'PRODUCT-NAME_SHOW_MENU_SETTINGS', true );
define( 'PRODUCT-NAME_SHOW_MENU_KEYWORDS', true ); // Page Generator Pro Only
define( 'PRODUCT-NAME_SHOW_MENU_GENERATE', true ); // Page Generator Pro Only
define( 'PRODUCT-NAME_SHOW_MENU_LOGS', true );
define( 'PRODUCT-NAME_SHOW_MENU_IMPORT_EXPORT', true );
define( 'PRODUCT-NAME_SHOW_MENU_SUPPORT', true );
define( 'PRODUCT-NAME_PERMITTED_USERS',false );

Constant	Accepted Value(s)	Default Value
`PLUGIN-NAME_SHOW_MENU` Shows or hides the Plugin from the WordPress Administration menu for all Users, except those defined in `PAGE-GENERATOR-PRO_PERMITTED_USERS`	`true` (show menu) `false` (hide menu)	`true`
`PLUGIN-NAME_SHOW_MENU_SETTINGS` Shows or hides the Plugin’s Settings Submenu from the WordPress Administration menu for all Users, except those defined in `PAGE-GENERATOR-PRO_PERMITTED_USERS`	`true` (show menu) `false` (hide menu)	`true`
`PLUGIN-NAME_SHOW_MENU_KEYWORDS` Shows or hides the Plugin’s Keywords Submenu from the WordPress Administration menu for all Users, except those defined in `PAGE-GENERATOR-PRO_PERMITTED_USERS`	`true` (show menu) `false` (hide menu)	`true`
`PLUGIN-NAME_SHOW_MENU_GENERATE` Shows or hides the Plugin’s Generate Content and Generate Terms Submenus from the WordPress Administration menu for all Users, except those defined in `PAGE-GENERATOR-PRO_PERMITTED_USERS`	`true` (show menu) `false` (hide menu)	`true`
`PLUGIN-NAME_SHOW_MENU_LOGS` Shows or hides the Plugin’s Logs Submenu from the WordPress Administration menu for all Users, except those defined in `PAGE-GENERATOR-PRO_PERMITTED_USERS`	`true` (show menu) `false` (hide menu)	`true`
`PLUGIN-NAME_SHOW_MENU_IMPORT_EXPORT` Shows or hides the Plugin’s Import & Export Submenu from the WordPress Administration menu for all Users, except those defined in `PAGE-GENERATOR-PRO_PERMITTED_USERS`	`true` (show menu) `false` (hide menu)	`true`
`PLUGIN-NAME_SHOW_MENU_SUPPORT` Shows or hides the Plugin’s Support Submenu (which links to the Support URL) from the WordPress Administration menu for all Users, except those defined in `PAGE-GENERATOR-PRO_PERMITTED_USERS`	`true` (show menu) `false` (hide menu)	`true`
`PLUGIN-NAME_PERMITTED_USERS` A comma separated list of WordPress Usernames, WordPress Username’s Registered Email Addresses or WordPress User IDs, who will always have access to the Plugin, regardless of the above settings.	`Usernames` or `Email Addresses` or `User IDs`	`false`

If a setting constant is not defined, access is permitted. For example, if PLUGIN-NAME_SHOW_MENU_SETTINGS
is not defined, the Settings menu will always show.

Common Issues

Settings do not update in WordPress

Changes can take up to 24 hours to propagate.

To force a refresh on the site(s) in question:

Deactivate the Plugin
Activate the Plugin
Navigate to Dashboard > Updates
If displayed, navigate to the Plugin’s Licensing screen