The WordPress Toolkit feature allows you to easily install, configure, and manage WordPress®. This feature is available in both a Lite and Deluxe version. The WordPress Toolkit Lite version installs by default, while the WordPress Toolkit Deluxe version requires that you purchase a license.
After you install the WordPress Toolkit plugin, you can access this feature in WHM’s WordPress Toolkit interface (WHM >> Home >> Plugins >> WordPress Toolkit). If enabled, cPanel users can access this feature in cPanel’s WordPress Toolkit interface (cPanel >> Home >> Applications >> WordPress Toolkit).
For the most current updates and improvements to the WordPress Toolkit plugin, read Plesk’s WordPress Toolkit change log documentation.
The following table shows the differences between the WordPress Toolkit Lite and WordPress Toolkit Deluxe version features:
Feature | WordPress Toolkit Lite | WordPress Toolkit Deluxe |
---|---|---|
Customizable Installation | ||
Manage Existing Installations | ||
Website Dashboard | ||
Change Admin Password | ||
Change DB Password | ||
Restore Backups | ||
Manual Updates | ||
1-Click Login | ||
Open DB in phpMyAdmin | ||
Single Site Auto Updates | ||
Search Engine Indexing Management | ||
Automatic Hardening | ||
Password Protection | ||
Maintenance Mode | ||
Debug Management | ||
Plugin & Theme Sets Management | ||
Cloning | ||
Staging | ||
1-Click Hardening | ||
Mass Hardening | ||
Mass Updates | ||
Security Rollback | ||
Smart Updates |
For information about software versions WordPress requires to run properly, read WordPress’ Requirements documentation.
You can use the following interfaces to configure your server’s WordPress Toolkit plugin software requirements:
To update your server’s version of MySQL® to 5.7 and later, use WHM’s MySQL/MariaDB Upgrade interface (WHM >> Home >> SQL Services >> MySQL/MariaDB Upgrade).
WordPress only supports MySQL version 5.7 and later.
To update your server’s PHP version, use WHM’s EasyApache interface (WHM >> Home >> Software >> EasyApache 4).
To enable any required WordPress PHP extensions, use the PHP Extensions section of WHM’s EasyApache 4 interface (WHM >> Home >> Software >> EasyApache 4). For a list of these PHP extensions in WordPress’ Server Environment documentation.
When you upgrade a server to cPanel & WHM version 92, the nightly cPanel & WHM update process detects whether WordPress Manager is installed on the server. If WordPress Manager is installed, the update process will install WordPress Toolkit.
The WordPress Toolkit plugin is only compatible with the following operating systems and cPanel & WHM versions:
The WordPress Toolkit plugin requires a PHP memory_limit
value of 128 MB or higher. You can set this limit in WHM’s MultiPHP INI Editor interface (WHM >> Home >> Software >> MultiPHP INI Editor).
When a root
user or a root
-enabled reseller logs in to the server, the WordPress Toolkit plugin will appear in the Feature Showcase. To install the WordPress Toolkit plugin via the Feature Showcase, perform the following steps:
You must be root
-enabled to access the WHM Marketplace interface (WHM >> Home >> Server Configuration >> WHM Marketplace).
To install the WordPress Toolkit plugin in the WHM Marketplace interface (WHM >> Home >> Server Configuration >> WHM Marketplace), perform the following steps:
To install the WordPress Toolkit plugin on the command line, run the following command as the root
user:
sh <(curl https://wp-toolkit.plesk.com/cPanel/installer.sh || wget -O - https://wp-toolkit.plesk.com/cPanel/installer.sh)
To uninstall the WordPress Toolkit plugin on the command line, run the following command as the root
user:
rpm -e wp-toolkit-cpanel
To use the WordPress Toolkit Deluxe feature, you must purchase a WordPress Toolkit license in Manage2 or the cPanel Store. You can select from the following licenses:
You can manage your WordPress Toolkit license via the Manage2 dashboard.
You must have an active cPanel license to purchase a WordPress Toolkit Deluxe license.
The cPanel Store sells WordPress Toolkit Deluxe accounts as a set of one, five, 10, or multiples of 10. You may purchase a maximum of 4,000 accounts.
A service disruption will occur at the start of the next month if you reduce the account limit below the number of active users.
To purchase a WordPress Toolkit license in the cPanel Store, perform the following steps:
Navigate to the cPanel Store and click Account Log In to log in to your cPanel Store account.
Click Add a Product to display the available product types.
In the menu, select Partner Add Ons. The interface will refresh and display the Select a Product menu.
Under Product Type, select WordPress Toolkit Deluxe from the Select a Product menu. The interface will refresh and display the required WordPress Toolkit Deluxe information.
Under IP Address, enter your server’s IP address in the text box.
Enter the desired number of accounts in the Number of Accounts text box.
Click Review and Checkout. A new interface will appear.
Proceed through the checkout process.
To modify a WordPress Toolkit Deluxe license in the cPanel Store, perform the following steps:
Navigate to the cPanel Store and click Account Log In to log in to your cPanel Store account.
Navigate to the Manage License interface (My Account >> Manage Licenses).
Locate your WordPress Toolkit Deluxe license.
Under Actions, click the arrow icon () to display the menu.
Click View/Modify Account Limit. A new window will appear.
Click Yes to modify your account limit.
Enter the desired number of accounts.
Click OK. The interface will automatically add the new license count to the cart.
Navigate to the Cart interface.
Proceed through the checkout process.
After you add or make changes to a WordPress Toolkit license, the system runs the /usr/local/cpanel/bin/wpt_license
script. This script immediately retrieves and refreshes the license to apply those changes.
If the script does not apply the license changes, run the following script as the root
user:
/usr/local/cpanel/scripts/wpt_license --update
To manage account access to the WordPress Toolkit Lite or WordPress Toolkit Deluxe feature, use the following interfaces:
WHM’s Feature Manager interface (WHM >> Home >> Packages >> Feature Manager >> Feature Lists) lets you manage the features your feature lists.
Server administrators must enable the following features to allow users access the WordPress Toolkit interface:
The WordPress Toolkit Deluxe feature requires the WordPress Toolkit and WordPress Toolkit Deluxe features, as well as a valid WordPress Toolkit license.
WHM’s Edit a Package interface (WHM >> Home >> Packages >> Edit a Package) lets you manage the feature list that existing packages use.
WHM’s Add a Package interface (WHM >> Home >> Packages >> Add a Package) lets you create a new package with new feature lists. Use this interface if you plan to offer new packages to customers and resellers with these WordPress Toolkit features.
WHM’s Modify an Account interface (WHM >> Home >> Account Functions >> Modify an Account) lets you change the package that each account uses.
We recommend that you create and use a package for the WordPress Toolkit Lite feature and a similar package for the WordPress Toolkit Deluxe feature.
Some WordPress Toolkit interface features require the WordPress Toolkit Deluxe feature. Partners and server administrators can set custom URLs from which resellers and cPanel users can purchase an upgrade to the WordPress Toolkit Deluxe feature.
Partners can set custom URLs in the Sales Options section of Manage2’s Update Company Information interface (Dashboard >> Company >> Update Company Information).
This custom URL sets the WordPress Toolkit Deluxe purchase URL for all the servers in Manage2’s Update Company Information interface (Dashboard >> Company >> Update Company Information)
Server administrators can set custom URLs in the Settings section of WHM’s WordPress Toolkit interface (WHM >> Home >> Plugins >> WordPress Toolkit).
Updates to the WordPress Toolkit run nightly.
To check the system’s auto-update status, run the following command:
systemctl status wp-toolkit-scheduled-tasks
To force an auto-update run, run the following command:
su wp-toolkit --shell=/bin/bash -c `/usr/bin/sw-engine -d auto_prepend_file=/usr/local/cpanel/3rdparty/wp-toolkit scripts/scheduled-task-prepend-file.php /usr/local/cpanel/3rdparty/wp-toolkit/plib/scripts/instances-auto-update.php`
The log files for the WordPress Toolkit reside in the /usr/local/cpanel/3rdparty/wp-toolkit/var/logs/
directory.
To troubleshoot the WordPress Toolkit, run the following command, where filename
represents the log file’s name:
grep -A1 ERROR /usr/local/cpanel/3rdparty/wp-toolkit/var/logs/filename.log
You can also enable enhanced logging to debug and troubleshoot the WordPress Toolkit. To do this, add the following line to the /usr/local/cpanel/3rdparty/wp-toolkit/var/etc/config.ini
file:
logCommandsAndFileOperations = true
We strongly recommend that you only enable enhanced logging when you need to troubleshoot the WordPress Toolkit. Enhanced logging may slow down WordPress Toolkit’s performance significantly.