If you manage websites on behalf of your clients and want to promote your brand and not the fact you use MainWP, then this is the Extension for you. With the MainWP White Label Extension, you can easily change the branding of the MainWP Child plugin, remove and disable functions on child sites and offer an on-site support contact form for your clients.
White Label
The Extension allows you to alter how the plugin appears on your client’s site. You can easily display your company name, along with your explanation of what the plugin does in place of the normal MainWP credits and author information. You can even select not to allow the MainWP Child plugin to appear at all to your clients.
Remove & Disable
The Extension enables you to restrict the ability of your clients to edit and delete plugins and themes. It creates a more secure place for them to work in. You can use this as a way to prevent unwanted changes by clients with less experience. You can also prevent users from accessing the WP Admin Settings and WordPress Tools sections.
WordPress Options
The Extension allows you to easily white-label certain WordPress admin sections, from the admin bar to the dashboard and a whole lot more. It makes it quick and easy to do everything, from replacing the WordPress logo with your company logo to completely customizing the admin area, favicons, dashboard, and more.
Support Form
If your clients need support, this section will give them the fastest way to reach you. If there is anything that they need to ask you, or if your clients need any assistance, they can use this easy contact form directly from the WP Admin interface.
Important Notes:
The MainWP White Label Extension allows you to white label the MainWP Child plugin only. MainWP Dashboard plugin can’t be white labeled with this Extension.
White Label the MainWP Child Plugin
White Label the MainWP Child Plugin on All Child Sites
Login in to your MainWP Dashboard
Go to the MainWP > Extensions > White Label page
Locate the White Label tab
Enter a custom Plugin Name
Enter a custom Pugin Description
Enter a custom Plugin URI
Enter a custom Plugin Author
Enter a custom Plugin Author URI
Click the Save Settings button
If we take the following example:
Plugin Name = Demo Name
Plugin Description = Demo Description
Plugin URI = http://demo.com
Plugin Author = Demo Author
Plugin Author URI = http://demo.com
The MainWP Child plugin will look like this in the WP > Plugins page on your child sites:
White Label the MainWP Child Plugin on a Single Site
Login in to your MainWP Dashboard
Go to the MainWP > Site > Manage page
Locate a Child Site where you want to rebrand the MainWP Child plugin
Click the Edit action
Go to the White Label tab
Locate the General Settings option box
Locate the Override General Settings option
Enable it
Locate the White Label option box
Enter a custom Plugin Name
Enter a custom Pugin Description
Enter a custom Plugin URI
Enter a custom Plugin Author
Enter a custom Plugin Author URI
Click the Save Settings button
Important Notes:
You can leave text fields empty (all except for Plugin Name) if you don’t want to tweak the original info, but you don’t want to show it either. This will hide the unwanted data.
To remove applied white label settings, you can delete the Plugin Name and Save Settings. That will return the Child Plugin to its original state.
In case your child site gets disconnected from your MainWP Dashboard, and you are no longer able to remove applied white label options, please check here to resolve the issue.
Visually Hide the MainWP Child Plugin
Visually Hide the MainWP Child Plugin on All Child Sites
Login in to your MainWP Dashboard
Go to the MainWP > Extensions > White Label page
Locate the White Label tab
Locate the Visually Hide MainWP Child Plugin option
Set it to YES
Click the Save Settings button
Visually Hide the MainWP Child Plugin on a Single Site
Login in to your MainWP Dashboard
Go to the MainWP > Site > Manage page
Locate a Child Site where you want to rebrand the MainWP Child plugin
Click the Edit action
Go to the White Label tab
Locate the General Settings option box
Locate the Override General Settings option
Set it to YES
Locate the White Label section
Locate the Visually Hide MainWP Child Plugin option
Set it to YES
Click the Save Settings button
Important Notes:
In case your child site gets disconnected from your MainWP Dashboard, and you are no longer able to remove applied branding options, please check here to resolve the issue.
Remove/Disable Functions on Your Child Sites
Remove & Disable Functions
Login in to your MainWP Dashboard
Go to the MainWP > Extensions > White Label page
Locate the Remove & Disable Options tab
Disable Theme Switching – if set to YES, the current child site theme will be locked, and nobody will be able to switch the theme
Disable Theme/Plugin Changes – if set to YES, the Plugins, and Appearance menus will be removed from the WordPress Admin Menu
Remove MainWP Settings – if set to YES, the MainWP Child Settings page will be removed
Remove MainWP Server Information – if set to YES, the MainWP Child Server Information page will be removed
Remove MainWP Restore / Clone – if set to YES, the MainWP Child Restore page will be removed
Remove WP Tools – if set to YES, the Tools menu will be removed from the WordPress Admin Menu
Remove WP Settings – if set to YES, the Settings menu will be removed from the WordPress Admin Menu
Remove WP Permalinks Menu – if set to YES, the Permalinks menu will be removed from the WordPress Admin Menu
Remove & Disable Functions on a Single Child Site
Login in to your MainWP Dashboard
Go to the MainWP > Site > Manage page
Locate a Child Site where you want to rebrand the MainWP Child plugin
Click the Edit action
Go to the White Label tab
Locate the General Settings option box
Locate the Override General Settings option
Set it to YES
Locate the Remove & Disable Options option box
Disable Theme Switching – if set to YES, the current child site theme will be locked, and nobody will be able to switch the theme
Disable Theme/Plugin Changes – if set to YES, the Plugins, and Appearance menus will be removed from the WordPress Admin Menu
Remove MainWP Settings – if set to YES, the MainWP Child Settings page will be removed
Remove MainWP Server Information – if set to YES, the MainWP Child Server Information page will be removed
Remove MainWP Restore / Clone – if set to YES, the MainWP Child Restore page will be removed
Remove WP Tools – if set to YES, the Tools menu will be removed from the WordPress Admin Menu
Remove WP Settings – if set to YES, the Settings menu will be removed from the WordPress Admin Menu
Remove WP Permalinks Menu – if set to YES, the Permalinks menu will be removed from the WordPress Admin Menu
Important Notes:
In case your child site gets disconnected from your MainWP Dashboard, and you are no longer able to remove applied branding options, please check here to resolve the issue.
WordPress White Label Options
WordPress Options
Login in to your MainWP Dashboard
Go to the MainWP > Extensions > White Label page
Go to the WordPress Options tab
Custom Login Image – upload your custom image to replace the WordPress icon on the WordPress login page
Custom Favicon – upload your custom image to replace the website favicon
Remove Dashboard Widgets – select widgets that you want to remove from the WordPress Dashboard page
Hide Nag Updates – enable this option if you want to remove the WordPress update nag that appears at the top of all admin pages when a new version of WordPress is released
Hide Help Box – enable this option if you want to hide the contextual help tab from all WordPress Admin pages
Hide Post Metaboxes – select meta boxes that you want to remove from the WP > Posts > Add New page
Hide Page Metaboxes – select meta boxes that you want to remove from the WP > Pages > Add New page
Global Footer Content – add content that you want to insert into the WordPress global footer (visible on front-end)
Dashboard Footer Content – add content that you want to insert into the WordPress Admin footer. It will replace the “Thank you for creating with WordPress.”
Site Generator Options – This option allows you to tweak the Generator meta tag on your child sites to hide the WordPress version on your child sites
Custom Admin CSS – add custom CSS code to customize the WP Admin section on your child sites
Custom Login CSS – add custom CSS code to customize the WP Login page on your child sites
Text Replace – This mechanism provides you the ability to replace any word or phrase on your child sites. Simply in the Find This Text field enter a text you want to replace and in the Replace With This add a new text. After you update settings, the extension will replace the text in the Admin area of your child sites.
Click the Save Settings button
WordPress Options on a Single Child Site
Login in to your MainWP Dashboard
Go to the MainWP > Site > Manage page
Locate a Child Site where you want to rebrand the MainWP Child plugin
Click the Edit action
Go to the White Label tab
Locate the General Settings option box
Locate the Override General Settings option
Set it to YES
Locate the WordPress Options option box
Custom Login Image – upload your custom image to replace the WordPress icon on the WordPress login page
Custom Favicon – upload your custom image to replace the website favicon
Remove Dashboard Widgets – select widgets that you want to remove from the WordPress Dashboard page
Hide Nag Updates – enable this option if you want to remove the WordPress update nag that appears at the top of all admin pages when a new version of WordPress is released
Hide Help Box – enable this option if you want to hide the contextual help tab from all WordPress Admin pages
Hide Post Metaboxes – select meta boxes that you want to remove from the WP > Posts > Add New page
Hide Page Metaboxes – select meta boxes that you want to remove from the WP > Pages > Add New page
Global Footer Content – add content that you want to insert into the WordPress global footer (visible on front-end)
Dashboard Footer Content – add content that you want to insert into the WordPress Admin footer. It will replace the “Thank you for creating with WordPress.”
Site Generator Options – This option allows you to tweak the Generator meta tag on your child sites to hide the WordPress version on your child sites
Custom Admin CSS – add custom CSS code to customize the WP Admin section on your child sites
Custom Login CSS – add custom CSS code to customize the WP Login page on your child sites
Text Replace – This mechanism provides you the ability to replace any word or phrase on your child sites. Simply in the Find This Text field enter a text you want to replace and in the Replace With This add a new text. After you update settings, the extension will replace the text in the Admin area of your child sites.
Click the Save Settings button.
Important Notes:
In case your child site gets disconnected from your MainWP Dashboard, and you are no longer able to remove applied branding options, please check here to resolve the issue.
Enable the Contact Support Feature
Enable the Contact Support Feature on All Child Sites
Login in to your MainWP Dashboard
Go to the MainWP > Extensions > White Label page
Go to the Support Form tab
Set the Enable Support Button option to YES
Select where you want to display the Contact Support Button on child sites
Set the Contact Support label
Set the Intro Support Message
Set the Submit Button Title
Set the Successful Submission Message
Set the Support Email Address (support form will stay disabled if the Support Email Address is blank)
Click the Save Settings button
Enable the Contact Support Feature on Single Child Sites
Login in to your MainWP Dashboard
Go to the MainWP > Site > Manage page
Locate a Child Site where you want to rebrand the MainWP Child plugin
Click the Edit actionE
Go to the White Label tab
Locate the General Settings option section
Locate the Override General Settings option
Set it to YES
Locate the Support Form section
Set the Enable Support Button option to YES
Select where you want to display the Contact Support Button on child sites
Set the Contact Support label
Set the Intro Support Message
Set the Submit Button Title
Set the Successful Submission Message
Set the Support Email Address (support form will stay disabled if the Support Email Address is blank)
Click the Save Settings button
Important Notes:
In case your child site gets disconnected from your MainWP Dashboard, and you are no longer able to remove applied branding options, please check here to resolve the issue.
Reset White Label Extension Options
Login in to your MainWP Dashboard
Go to the MainWP > Extensions > White Label page
Locate the Reset button at the bottom of the page
Click the button,
If you are sure you want to reset all branding options, confirm by clicking the Yes button in the popup box.
Click the Save Settings button to apply reset to child sites.
White Label Master Reset
If your Child Site gets disconnected from your MainWP Dashboard and you are not able to see the MainWP Child plugin because it has been hidden by the MainWP White Label Extension or any other white label option gets “stuck”, you will need to Master Reset white label options on your child site.
MainWP Child Reset Tool
We have a tool that will reset your MainWP Child Site Plugin settings as if it was never installed.
Please find the plugin here: Reset MainWP Child Plugin setting to default.
Simply install this like a normal plugin ON THE CHILD SITE ONLY. Once activated it will do its thing and deactivate itself.
After you are finished with the tool PLEASE remove it for security reasons.
Manual Reset
If you prefer to do it manually by editing code, please follow these steps:
Access your child site server with your favorite FTP Client
Locate the class-mainwp-child.php file on your Child Site site_root/wp-content/plugins/mainwp-child/class/
Download the file
Open the file in any Code Editor
Locate the public function __construct( $plugin_file ) function around line 210
Locate this–>update(); about 2 lines lower
Directly after that line, add the following code:
delete_option('mainwp_branding_child_hide');
Save the changes in the file
Upload file back to the site_root/wp-content/plugins/mainwp-child/class/ directory on your child site. Be sure to overwrite the current file.
Completely Disable White Label Settings for a Site
To completely disable custom white label settings for a specific Child Site, please insert the following code snippet to the functions.php file of the active theme on the child site:
add_filter( 'mainwp_child_branding_init_options', 'mycustom_mainwp_child_branding_init_options'); function mycustom_mainwp_child_branding_init_options( $opts ) { if (is_array($opts) && isset($opts['hide'])) { $opts['hide'] = ''; } return $opts; }Important Note
After adding that code, you will be able to re-activate the child plugin and reconnect it to your MainWP Dashboard. After successfully reconnecting, download the file again and remove the code you added earlier. This needs to be done so the White Label Extension can be used properly again.
Remove White Label Settings for a Specific User on Child Sites
MainWP Child 4.0.3, released on October 1st, 2019, introduced one handy filter mainwp_child_branding_init_options that can be used to hide white label settings for a specific user on child sites.
Let’s see the usage example:
add_filter( 'mainwp_child_branding_init_options', 'mycustom_mainwp_child_branding_init_options' ); function mycustom_mainwp_child_branding_init_options( $option ) { $current_user_id = get_current_user_id(); if ( $current_user_id == '1' && is_array( $option ) && isset( $option[ 'cancelled_branding' ] ) ) { $option[ 'cancelled_branding' ] = true; } return $option; }In this example, all custom MainWP White Label Extension options will be applied for all users on the child site except for the user with ID 1.
Also, the filter can be used to hide white label settings for a user with a specific username.
add_filter( 'mainwp_child_branding_init_options', 'mycustom_mainwp_child_branding_init_options' ); function mycustom_mainwp_child_branding_init_options( $option ) { $current_user = wp_get_current_user(); if ( $current_user && $current_user->user_login == 'bogdan' && is_array( $option ) && isset( $option[ 'cancelled_branding' ] ) ) { $option[ 'cancelled_branding' ] = true; } return $option; }In this example, the user with the username “bogdan” won’t be affected by the white label settings.
If you use the MainWP Code Snippets Extension, you will be able to apply this snippet to all your sites at once.