WordPress Manager For WHMCS
(→About WordPress Manager For WHMCS) |
(→Updating the Module to Version 3.x) |
||
(325 intermediate revisions by 7 users not shown) | |||
Line 2: | Line 2: | ||
<meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The WordPress Manager For WHMCS Module."></meta> | <meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The WordPress Manager For WHMCS Module."></meta> | ||
− | <h4 style="color: #ff0000; font-weight:bold; text-align:center;"> | + | <h4 style="color: #ff0000; font-weight:bold; text-align:center;">Are you planning to update your WordPress Manager For WHMCS module to version 3.x?<br/> Follow the [[#Updating_the_Module_to_Version_3.x|instructions here]] for a smooth update. |
− | + | </h4> | |
=About [https://www.modulesgarden.com/products/whmcs/wordpress-manager WordPress Manager For WHMCS]= | =About [https://www.modulesgarden.com/products/whmcs/wordpress-manager WordPress Manager For WHMCS]= | ||
{| | {| | ||
|style="padding: 10px 0px 10px 0px;"|'''WordPress Manager For WHMCS''' is a module that enables your customers to control and freely alter their WordPress instances right inside your WHMCS. <br /> | |style="padding: 10px 0px 10px 0px;"|'''WordPress Manager For WHMCS''' is a module that enables your customers to control and freely alter their WordPress instances right inside your WHMCS. <br /> | ||
− | Your clients will be able to | + | Your clients will be able to add WordPress installations using instance images and custom scripts, perform WordPress updates, install themes and plugins, create staging instances and then push them live.<br/> All of that just next to the basic upgrade options. You will easily handle the list of services with WordPress management features. |
− | You will easily handle the list of services | + | |
|} | |} | ||
*'''Admin Area:''' | *'''Admin Area:''' | ||
Line 20: | Line 19: | ||
{| | {| | ||
|style="padding: 0px 0px 0px 30px;"|✔ Choose Supported Products: | |style="padding: 0px 0px 0px 30px;"|✔ Choose Supported Products: | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Select API To Use: | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 60px;"|✔ Softaculous Auto Installer | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 60px;"|✔ WP Toolkit | ||
|} | |} | ||
{| | {| | ||
Line 31: | Line 39: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 45px;"|✔ | + | |style="padding: 0px 0px 0px 45px;"|✔ Automatically Install: |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 45px;"|✔ Toggle Automatic Deletion Of Blocked Plugins | + | |style="padding: 0px 0px 0px 60px;"|✔ WordPress After Service Creation: |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 75px;"|✔ Based On Installation Script | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 75px;"|✔ Based On Instance Image | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 60px;"|✔ Plugin Packages | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 60px;"|✔ Theme Packages | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Toggle Blocked Plugins And Themes | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Toggle Automatic Deletion Of Blocked Plugins And Themes | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Set Scan Interval For Blacklists Cleaner | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Define Default Theme To Be Enabled After Installation | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Choose Custom Plugins And Themes Available To Clients | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Choose Instance Images Available To Clients | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Toggle Permission To Delete WordPress Auto-Installation | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Define Protocol For WordPress Auto-Installation | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Select Welcome Email Template | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Define Installation Limit Per Hosting Account | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Define Update WordPress Notification Mail Interval | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Select Update WordPress Email Template | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Toggle Debug Logs | ||
|} | |} | ||
{| | {| | ||
Line 46: | Line 105: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px | + | |style="padding: 0px 0px 0px 45px;"|✔ Add/Remove Selected Themes From Blacklist: |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px | + | |style="padding: 0px 0px 0px 60px;"|✔ Prevent Blacklisted Themes From Being Installed By Clients |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px | + | |style="padding: 0px 0px 0px 60px;"|✔ Remove Blacklisted Themes From Current Installations |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 45px;"|✔ | + | |style="padding: 0px 0px 0px 45px;"|✔ Define Client Area Features: |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 45px;"|✔ Choose Available Plugins | + | |style="padding: 0px 0px 0px 60px;"|✔ Management Options |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 60px;"|✔ Action Options | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Plugins: | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Create Plugin Packages: | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 60px;"|✔ Enter Package Name And Description | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 60px;"|✔ Choose Available Plugins | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Add Custom Plugins | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Themes: | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Create Theme Packages: | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 60px;"|✔ Enter Package Name And Description | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 60px;"|✔ Choose Available Themes | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Add Custom Themes | ||
|} | |} | ||
{| | {| | ||
Line 70: | Line 162: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 0px 30px;"|✔ Access Module Tasks List And Logs |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Provide Google API Token For PageSpeed Insights | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Define Allowed Protocols For WordPress Instances To Be Used In Client Area | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Enable Extended View Of Instances List | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Enable And Customize WHMCS Client Home Page Widget | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Customize Module Language Files With "Translations" Tool | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Control Staff Access Level To Specific Resources With ACL | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 10px 30px;"|✔ View And Manage Logs | ||
|} | |} | ||
Line 78: | Line 191: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px | + | |style="padding: 0px 0px 0px 45px;"|✔ Using Simple List Of Instances |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px | + | |style="padding: 0px 0px 0px 45px;"|✔ Using Extended View With Instances Preview Screenshots |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 30px;"|✔ Create WordPress | + | |style="padding: 0px 0px 0px 30px;"|✔ View/Create/Edit/Delete WordPress Installations On Your Resellers Accounts: |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px | + | |style="padding: 0px 0px 0px 45px;"|✔ cPanel |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 45px;"|✔ | + | |style="padding: 0px 0px 0px 45px;"|✔ DirectAdmin |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px | + | |style="padding: 0px 0px 0px 30px;"|✔ View List Of Recent WordPress Instances On WHMCS Client Home Page |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px | + | |style="padding: 0px 0px 0px 30px;"|✔ Update Selected WordPress Installations To Newest Version In One Batch |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 45px;"|✔ | + | |style="padding: 0px 0px 0px 30px;"|✔ Import WordPress Installation From Remote Server: |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ FTP Based Import | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Username/Password Based Import | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Create WordPress Installation Based On Instance Image | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Log In To Admin Panel Of WordPress Instances | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Receive Email Notifications And Get Visual Alerts When WordPress Update Is Available | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ View Installation Details: | ||
|} | |} | ||
{| | {| | ||
Line 106: | Line 237: | ||
{| | {| | ||
|style="padding: 0px 0px 0px 45px;"|✔ Product On Which Is Installed | |style="padding: 0px 0px 0px 45px;"|✔ Product On Which Is Installed | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ WordPress Version | ||
|} | |} | ||
{| | {| | ||
Line 124: | Line 258: | ||
{| | {| | ||
|style="padding: 0px 0px 0px 45px;"|✔ Instance Status | |style="padding: 0px 0px 0px 45px;"|✔ Instance Status | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ SSL Certificate Expiration Date | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ View Website Details Based On Google "PageSpeed Insights": | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Desktop And Mobile Screengrab Thumbnails Of Website | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ General Performance Information | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Page Statistics | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Opportunities | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Audit Passed Successfully | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Diagnostics | ||
|} | |} | ||
{| | {| | ||
Line 166: | Line 324: | ||
{| | {| | ||
|style="padding: 0px 0px 0px 45px;"|✔ View/Create/Edit/Delete WP Config Records | |style="padding: 0px 0px 0px 45px;"|✔ View/Create/Edit/Delete WP Config Records | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ View/Create/Edit/Delete WordPress User Accounts With Specified Privileges | ||
|} | |} | ||
{| | {| | ||
Line 172: | Line 333: | ||
{| | {| | ||
|style="padding: 0px 0px 0px 45px;"|✔ Log In To Control Panel | |style="padding: 0px 0px 0px 45px;"|✔ Log In To Control Panel | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Access Credentials Setup | ||
|} | |} | ||
{| | {| | ||
Line 205: | Line 369: | ||
{| | {| | ||
|style="padding: 0px 0px 0px 45px;"|✔ Enable/Disable SSL | |style="padding: 0px 0px 0px 45px;"|✔ Enable/Disable SSL | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Enable/Disable Debug Mode | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 45px;"|✔ Enable/Disable Maintenance Mode | ||
|} | |} | ||
{| | {| | ||
Line 210: | Line 380: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 0px 45px;"|✔ Delete |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 10px 30px;"|✔ Single Sign-On Into WordPress Panel From Product View | ||
|} | |} | ||
− | |||
*'''Supported Modules:''' | *'''Supported Modules:''' | ||
{| | {| | ||
− | |style="padding: 10px 0px 0px 30px;"|✔ cPanel | + | |style="padding: 10px 0px 0px 30px;"|✔ cPanel (Root Access Required) |
|} | |} | ||
{| | {| | ||
Line 222: | Line 394: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 30px;"|✔ DirectAdmin | + | |style="padding: 0px 0px 0px 30px;"|✔ DirectAdmin (Admin Account Required) |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 0px 30px;"|✔ [https://www.modulesgarden.com/products/whmcs/directadmin-extended DirectAdmin Extended] |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Plesk (Root Access Required) | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 10px 30px;"|✔ [https://www.modulesgarden.com/products/whmcs/plesk-extended Plesk Extended] | ||
+ | |} | ||
+ | |||
+ | *'''Supported Integrations:''' | ||
+ | {| | ||
+ | |style="padding: 10px 0px 0px 30px;"|✔ Softaculous Auto Installer - Premium (cPanel, Plesk, DirectAdmin) | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 10px 30px;"|✔ WP Toolkit (cPanel, Plesk) - View [[#WP_Toolkit_Integration|Wiki]] To See Differences In Support | ||
|} | |} | ||
*'''General Info:''' | *'''General Info:''' | ||
{| | {| | ||
− | |style="padding: 10px 0px 0px 30px;"|✔ | + | |style="padding: 10px 0px 0px 30px;"|✔ Automatic Let's Encrypt SSL Installation (DirectAdmin Only) |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 30px;"|✔ | + | |style="padding: 0px 0px 0px 30px;"|✔ Fully Integrated With [https://lagom.rsstudio.net/extensions/whmcs-modules-integration/wordpress-manager-by-modulesgarden Lagom WHMCS Client Theme] |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 30px;"|✔ Multi-Language Support | + | |style="padding: 0px 0px 0px 30px;"|✔ Multi-Language Support With Custom Translations Tool |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 30px;"|✔ Supports PHP | + | |style="padding: 0px 0px 0px 30px;"|✔ Supports PHP 8.2 Back To PHP 7.4 |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS | + | |style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS Themes "Six" And "Twenty-One" |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 0px 30px;"|✔ Supports WHMCS V8.11 Back To WHMCS V8.8 |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 0px 30px;"|✔ Requires ionCube Loader V13 Or Later | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 30px;"|✔ Easy [https://www.docs.modulesgarden.com/How_To_Upgrade_WHMCS_Module Module Upgrade] To [https://www.modulesgarden.com/products/whmcs/wordpress-manager#open-source-version Open Source Version] | ||
|} | |} | ||
=Installation and Configuration= | =Installation and Configuration= | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|'''In this short tutorial we will show you how to successfully install WordPress Manager For WHMCS.'''<br /> | + | |style="padding: 10px 0px 15px 15px;"|'''In this short tutorial we will show you how to successfully install [https://www.modulesgarden.com/products/whmcs/wordpress-manager WordPress Manager For WHMCS.]'''<br /> |
We will guide you step by step through the whole installation process. | We will guide you step by step through the whole installation process. | ||
|} | |} | ||
− | |||
{| | {| | ||
− | |style="padding: | + | |style="padding: 0px 0px 20px 15px;"|'''1. Log in to our client area and download the module.''' |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 20px 25px;"|[[File: | + | |style="padding: 0px 0px 20px 25px;"|[[File:WM1.png]] |
|} | |} | ||
+ | <!-- | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"|''' | + | |style="padding: 0px 0px 15px 15px;"|'''Previous updates of the module may contain two packages dedicated to various PHP versions.'''<br/> |
− | '' '''Note''' | + | The first one supports PHP 5.6 up to PHP 7.1, and the second one addresses PHP 7.2 up to PHP 7.4.<br/> |
+ | '''''Note:''' Keep in mind that PHP versions 5.6 up to 7.1 are no longer officially supported and their security issues are not fixed or released anymore. Find more info [http://php.net/supported-versions.php here].'' | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 20px 25px;"|[[File: | + | |style="padding: 0px 0px 20px 25px;"|[[File:PHP56_74.png]] |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 10px 15px;"| '' '''Important''': This situation does not affect [https://www.modulesgarden.com/products/whmcs/wordpress-manager#open-source-version '''the open source version'''] of this module which can be applied to any PHP from version 5.6 and later.''<br/>'' '''Note''': You can check the current PHP version in your WHMCS. To do so, proceed to ''' 'Utilities' → 'System' → 'PHP Info'.''' |
+ | |} | ||
+ | --> | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|'''2. Extract the package and upload its content into the main WHMCS directory.<br/> | ||
+ | The content of the package to upload should look like this. | ||
|} | |} | ||
{| | {| | ||
Line 275: | Line 473: | ||
==cPanel (WHM) Installation== | ==cPanel (WHM) Installation== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|'''1. Upload and extract the '' 'UploadToWHM' '' folder into the '''/root''' cPanel directory.'''<br /> | + | |style="padding: 10px 0px 20px 15px; color: #ff0000;"|'''''Important: Root access''' is required to perform the installation successfully!'' |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|'''1. Upload and extract the '' 'UploadToWHM' '' folder into the '''/root''' cPanel directory.'''<br /> | ||
Files in your cPanel ''/root/uploadToWHM/'' directory should look like these on the following screen. | Files in your cPanel ''/root/uploadToWHM/'' directory should look like these on the following screen. | ||
|} | |} | ||
Line 289: | Line 490: | ||
|style="padding: 0px 0px 30px 25px;"|[[File:WM_3.png]] | |style="padding: 0px 0px 30px 25px;"|[[File:WM_3.png]] | ||
|} | |} | ||
+ | |||
==DirectAdmin Installation== | ==DirectAdmin Installation== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|'''1. In the '' 'uploadToDirectAdmin' '' folder find the '' 'wordpress_cli.tar.gz' '' package.'''<br /> | + | |style="padding: 10px 0px 20px 15px; color: #ff0000;"|'''''Important: Admin account''' is required to perform the installation successfully!'' |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|'''1. In the '' 'uploadToDirectAdmin' '' folder find the '' 'wordpress_cli.tar.gz' '' package.'''<br /> | ||
Next, log in to your DirectAdmin panel as an administrator and go to '' 'Plugin Manager' ''. | Next, log in to your DirectAdmin panel as an administrator and go to '' 'Plugin Manager' ''. | ||
|} | |} | ||
Line 308: | Line 513: | ||
{| | {| | ||
|style="padding: 0px 0px 30px 25px;"|[[File:WM_2_3.png]] | |style="padding: 0px 0px 30px 25px;"|[[File:WM_2_3.png]] | ||
+ | |} | ||
+ | |||
+ | ==Plesk Installation== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|''' Note: ''' The current version of the module requires your Plesk server configured in WHMCS to use '''username''' and '''password''' as authentication to the Plesk API. <br/>We also recommended using Plesk version 17.8.11 at least. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px; color: #ff0000;"|'''''Important: Root access''' is required to perform the installation successfully!'' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|'''1. In the '' 'uploadToPlesk' '' folder find the '' 'wordpress-manager-cli-X.X-X.zip' '' package.'''<br /> | ||
+ | Next, log in to your Plesk panel as an administrator and go to the '' 'Extensions' '' section. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM_3_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|'''2. Once you are in the '' 'Extensions' '' section, go to the '' 'My Extensions' '' tab and select the '' 'Upload Extension' '' option.'''<br/> In the opened window choose the '' 'wordpress-manager-cli-X.X-X.zip' '' package to upload and press the '' 'OK' '' button. | ||
+ | '''Important:''' If for some reason the '' 'Upload Extension' '' button is disabled, you will need to install the free panel.ini editor extension. <br/> Next, search for 'extensionUpload' and copy it. Then, go to the editor tab and paste that setting.<br/> Finally, scroll down to the last line and set it from false to true. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM_3_2.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|'''3. Once the plugin is uploaded and successfully installed, you will see it on the plugins' list. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM_3_3.png]] | ||
|} | |} | ||
==WHMCS Installation== | ==WHMCS Installation== | ||
{| | {| | ||
− | |style="padding: 10px 0px 20px 15px;"|'''1. Extract the '' 'modules' '' catalog into the main WHMCS directory.''' | + | |style="padding: 10px 0px 20px 15px;"|'''1. Extract the '' 'modules' '' catalog into the main WHMCS directory.''' |
|} | |} | ||
{| | {| | ||
Line 319: | Line 552: | ||
{| | {| | ||
|style="padding: 0px 0px 15px 15px;"|'''2. When you install WordPress Manager For WHMCS for the first time, you have to rename the '' 'license_RENAME.php' '' file.'''<br /> | |style="padding: 0px 0px 15px 15px;"|'''2. When you install WordPress Manager For WHMCS for the first time, you have to rename the '' 'license_RENAME.php' '' file.'''<br /> | ||
− | This file is located in '' 'modules/addons/wordpress_manager/license_RENAME.php | + | This file is located in '' 'modules/addons/wordpress_manager/license_RENAME.php'.'' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. '' |
|} | |} | ||
{| | {| | ||
Line 333: | Line 566: | ||
{| | {| | ||
|style="padding: 0px 0px 15px 15px;"|'''4. In the next step, set up the '' 'storage' '' folder as recursively writable.'''<br /> | |style="padding: 0px 0px 15px 15px;"|'''4. In the next step, set up the '' 'storage' '' folder as recursively writable.'''<br /> | ||
− | This folder is available at '' 'your_whmcs/modules/addons/WordpressManager/' '' | + | This folder is available at '' 'your_whmcs/modules/addons/WordpressManager/'.'' |
|} | |} | ||
{| | {| | ||
Line 340: | Line 573: | ||
{| | {| | ||
|style="padding: 0px 0px 15px 15px;"|'''5. Now you have to activate the module in your WHMCS system.'''<br /> | |style="padding: 0px 0px 15px 15px;"|'''5. Now you have to activate the module in your WHMCS system.'''<br /> | ||
− | Log in to your WHMCS admin area. Click '' ' | + | Log in to your WHMCS admin area. Click '' 'System Settings' '', then choose '' 'Addon Modules'. ''<br /> |
Afterwards, find '' 'WordPress Manager' '' and press the '' 'Activate' '' button. | Afterwards, find '' 'WordPress Manager' '' and press the '' 'Activate' '' button. | ||
|} | |} | ||
Line 353: | Line 586: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"|'''7. Now you have to add | + | |style="padding: 0px 0px 15px 15px;"|'''7. Now you have to add cron jobs as shown below:'''<br /> |
+ | * Synchronization of WordPress installations and '' 'Enable SSL' '' action when installing new WordPress instances, set it up to run in 5-10 minute intervals. | ||
php -q /your_whmcs/modules/addons/WordpressManager/cron/cron.php Synchronize | php -q /your_whmcs/modules/addons/WordpressManager/cron/cron.php Synchronize | ||
+ | |||
+ | * Module [[#Tasks|tasks]] processing (5 minutes interval is recommended): | ||
+ | php -q /your_whmcs/modules/addons/WordpressManager/cron/cron.php queue | ||
+ | |||
Do not forget to replace 'your_whmcs' with your WHMCS root location.<br/> | Do not forget to replace 'your_whmcs' with your WHMCS root location.<br/> | ||
− | '''''Note:''' In case you wish to stop | + | '''''Note:''' In case you wish to stop the cron job then move to "your_WHMCS/modules/addons/WordpressManager/cron" directory and clear the file's content.'' |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 20px 15px;"|'''8. Good job! You have just successfully installed WordPress Manager For WHMCS! Now in your WHMCS press '' 'Addons' '' and then '' 'WordPress Manager'. '' ''' | + | |style="padding: 0px 0px 20px 15px;"|'''8. Good job! You have just successfully installed WordPress Manager For WHMCS! Now, in your WHMCS, press '' 'Addons' '' and then '' 'WordPress Manager'. '' ''' |
|} | |} | ||
{| | {| | ||
Line 376: | Line 614: | ||
===Home=== | ===Home=== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|'' 'Home' '' section is the first open when entering the addon. <br/> | + | |style="padding: 10px 0px 15px 15px;"|The '' 'Home' '' section is the first open when entering the addon. <br/> |
You will see here a quick summary of the WordPress connected elements and a list of all active WordPress installations with any details on their installation. | You will see here a quick summary of the WordPress connected elements and a list of all active WordPress installations with any details on their installation. | ||
|} | |} | ||
Line 385: | Line 623: | ||
===Product Settings=== | ===Product Settings=== | ||
{| | {| | ||
− | |style="padding: 10px 0px | + | |style="padding: 10px 0px 15px 15px;"|In the '' 'Product Settings' '' section you can see the list of compatible products present in your system that WordPress can be configured with.<br/> |
Activate the products and press the '' 'Edit' '' icon marked on the screen below. | Activate the products and press the '' 'Edit' '' icon marked on the screen below. | ||
|} | |} | ||
Line 393: | Line 631: | ||
====General==== | ====General==== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|In '' 'General' '' section you set up some specific options concerning the plugins installation. Take a look at the below notes to learn about all the possibilities.<br/> | + | |style="padding: 10px 0px 15px 15px;"|In the '' 'General' '' section you will need to set up some specific options concerning the plugins installation. Take a look at the below notes to learn about all of the possibilities.<br/> |
+ | *'''API''' - select the desired integration method for WordPress Manager. | ||
+ | ** "Softaculous" - choose to utilize Softaculous for WordPress installations | ||
+ | ** "WP Toolkit" - seamless integration with cPanel's WP Toolkit ''(available for cPanel only)''<br/> Please refer to the [[#WP_Toolkit_Integration|WP Toolkit Integration]] section to see the list of supported features | ||
*'''Debug Mode''' - if enabled, the module's activity details will be gathered in the '' 'Logs' '' subsection. | *'''Debug Mode''' - if enabled, the module's activity details will be gathered in the '' 'Logs' '' subsection. | ||
− | *'''Installation Scripts''' - allow your clients to install your pre-configured WordPress instances instead of performing a clean installation only.<br/>This feature can be useful if you already have a few WordPress installations ready, such as custom theme with | + | *'''Installation Scripts''' - allow your clients to install your pre-configured WordPress instances instead of performing a clean installation only.<br/>This feature can be useful if you already have a few WordPress installations ready, such as a custom theme with demo content or other plugins.<br/>'' '''Script Selection Requirement:''' For both WP Toolkit and Softaculous, you must select at least one script for the module to function properly. You can choose a clean installation with #26 WordPress in both cases.''<br/>'' '''Softaculous note:''' The dropdown will include various installation scripts from Softaculous, not just WordPress. Ensure you only select WordPress-based installations to avoid unpredictable errors.'' |
− | + | *'''Blocked Plugins''' - enable if you do not wish your clients to install certain plugins due to security, safety or any other reason.<br/> Define the plugins that will not be allowed for installation in the [[#Plugins Blacklist|Plugins Blacklist]] section. | |
− | *'''Blocked Plugins''' - enable if you do not wish your clients to install certain plugins due to security, safety or any other reason.<br/> Define the plugins that will not be allowed for installation in the [[#Plugins Blacklist| | + | |
*'''Delete Blocked Plugins''' - enable if you wish to automatically delete plugins that have been added to the blacklist.<br/>Remember that the pointed here plugins will also be removed from the already existing WordPress instances. | *'''Delete Blocked Plugins''' - enable if you wish to automatically delete plugins that have been added to the blacklist.<br/>Remember that the pointed here plugins will also be removed from the already existing WordPress instances. | ||
− | *'''Scan Interval [Hours]''' - the products will be scanned using a cron job in the provided time intervals, suggested time interval - every 3 hours.<br/> Please do not set it more often as the server may be overloaded during the scan. It works only if the Delete Blocked Plugins option has been enabled. | + | *'''Blocked Themes''' - enable if you do not want your clients to install particular themes due to security, safety, or any other reason. <br/> Define the themes that will not be allowed for installation in the '' 'Themes Blacklist' ''section. |
+ | *'''Delete Blocked Themes''' - enable if you wish to automatically remove themes that have been added to the blacklist. | ||
+ | *'''Scan Interval [Hours]''' - the products will be scanned using a cron job in the provided time intervals, suggested time interval - every 3 hours.<br/> Please do not set it more often as the server may be overloaded during the scan. It works only if the '' 'Delete Blocked Plugins' '' / '' 'Delete Blocked Themes' '' option has been enabled. | ||
+ | *'''Plugin Packages''' - select any packages containing a bunch of preselected plugins that can be later quickly installed, read more about them in the section [[#Plugin Packages|Plugin Packages]]. | ||
+ | *'''Auto Install Plugin Packages''' - choose which plugin packages will be installed automatically when a new WordPress instance is created by a client. | ||
+ | *'''Custom Plugins''' - if you previously prepared '' 'Custom Plugins' '', here you may define which ones will be available to your clients. | ||
+ | *'''Auto Install Theme Packages''' - choose which theme packages will be installed automatically when a client creates a new WordPress instance. | ||
+ | *'''Default Theme''' - you may select a theme that will be automatically activated once the WordPress installation is complete. | ||
+ | *'''Custom Themes''' - select which of the previously created '' 'Custom Themes' '' should be accessible to your clients. | ||
+ | *'''Instance Images''' - select which of the existing images clients will be allowed to use to add a new installation, read more about them in the section [[#Instance Images|Instance Images]]. | ||
+ | *'''Auto Install WordPress After Service Creation''' - you may here decide whether the WordPress instance should be automatically installed once the client's service is created: | ||
+ | **'''Disabled''' - select if you do not want the WordPress instance to be automatically installed after provisioning the product. | ||
+ | **'''Based On Instance Image''' - if chosen, the new dropdown will appear where you can choose the instance image based on which the WordPress will be automatically installed. | ||
+ | **'''Based On Installation Script''' - if selected, then you can choose in the new dropdown, which of the installation scripts will handle the installation of the WordPress instance after the service is created. | ||
+ | *'''Delete Auto Installed WordPress Installations''' - enable this option to allow the client to delete those WordPress installations that have been installed automatically. | ||
+ | *'''Protocol''' - select the protocol that will be used for WordPress auto installation when the client service is created. | ||
+ | *'''Welcome Email''' - select an email template that will be delivered to the customer when the WordPress installation is complete. | ||
+ | *'''Installation Limit per Hosting Account''' - define the number of max installations per hosting account. | ||
+ | *'''Send Update WordPress Notification Mail''' - enable to allow customers to receive emails informing them that there is a new update available for their WordPress installation. | ||
+ | *'''Send Update WordPress Notification Mail Interval [Hours]''' - determine the time interval to send notification emails about an available update for the client WordPress installation. | ||
+ | *'''WordPress Update Email Template''' - select an email template that will be sent to the customer with WordPress installation details when auto-installation is done. <br/>By default, the module will also create the '' '[[#Email_Templates|New WordPress Information]]' '' sample template which you can use or familiarize yourself with the available merge fields variables. | ||
+ | Keep in mind that if an instance is imported (for example when using "Based On Instance Image" automatic installation), it will overwrite the Auto Install Plugin/Theme Packages feature.<br/> If you intend to take advantage of those two functions, we recommend using the "Based On Installation Script" installation method. | ||
|} | |} | ||
{| | {| | ||
Line 406: | Line 667: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 30px 15px;"|'' '''Note:''' By default, installation script names in the client area will be displayed without their IDs. If you want to | + | |style="padding: 0px 0px 30px 15px;"|'' '''Note:''' By default, installation script names in the client area will be displayed without their IDs. If you still want to change their names to be more client-friendly, you can do it in a language file. <br/>Go to the [[#Tips|Tips]] section and look for more details in the second point.'' |
|} | |} | ||
====Plugins Blacklist==== | ====Plugins Blacklist==== | ||
{| | {| | ||
− | |style="padding: 10px 0px | + | |style="padding: 10px 0px 15px 15px;"|This section of the Product Settings includes a list of blocked plugins - those which your clients are not allowed to install. <br/> |
− | + | In order to add a plugin to the list simply start typing its name in the search field and press enter to see the results. | |
− | + | ||
− | + | ||
|} | |} | ||
{| | {| | ||
Line 420: | Line 679: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"|Add selected plugin to the blacklist.<br/> It will no longer be available for clients to install if '' "Blocked Plugins" '' option has been enabled in the ''General'' section. | + | |style="padding: 0px 0px 15px 15px;"|Add the selected plugin to the blacklist.<br/> It will no longer be available for clients to install if the '' "Blocked Plugins" '' option has been enabled in the ''General'' section. |
|} | |} | ||
{| | {| | ||
Line 426: | Line 685: | ||
|} | |} | ||
− | === | + | ====Themes Blacklist==== |
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|In the '' ' | + | |style="padding: 10px 0px 10px 15px;"|This section of the Product Settings includes a list of blocked themes - those that your clients will not be able to install. |
− | In this quick and convenient way, your clients will be given an offer with perfectly adjusted and suitable plugins to shorten the time of searching and verification. <br/> Prepare packages, enable when ready or disable when you want to withdraw them from the offer temporarily or edit their content and surely delete when | + | |} |
− | + | {| | |
+ | |style="padding: 0px 0px 15px 15px;"|If you want to add a theme to the list, simply start typing its name in the search field and press enter to see the results.<br/> Add the selected themes to the blacklist. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_13_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Your clients will not be able to install the previously added themes if the '' "Blocked Themes" '' option has been enabled in the ''General'' section. <br/> | ||
+ | If you decide to remove the preferred themes from the '' 'Blocked' '' section, you may easily do this by clicking the appropriate button. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_13_2.png]] | ||
+ | |} | ||
+ | |||
+ | ====Client Area Features==== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|In this section, you can define which options should be enabled for clients. <br/> To make it easier, the available options are divided into two parts, the '' 'Management Options' '' and '' 'Action Options' ''. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_13_3.png]] | ||
+ | |} | ||
+ | |||
+ | ===Plugins=== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|In the '' 'Plugins' '' section you may prepare ready-made packages selected by your plugins or prepare custom plugins and then offer them to install to your clients. <br/> | ||
+ | In this quick and convenient way, your clients will be given an offer with perfectly adjusted and suitable plugins to shorten the time of searching and verification. <br/> You may also use this package to automatically preinstall given plugins when a client creates a new WordPress instance. <br/>Prepare packages, enable when ready or disable when you want to withdraw them from the offer temporarily or edit their content and surely delete when no longer needed.<br/> | ||
+ | Choose '' 'Plugin Packages' '' and press '' 'Create Package' '' to compose the bundle.<br/> | ||
+ | '''''Note:''' Plugins included in the packages are always installed in their newest version available in the WordPress base.'' | ||
|} | |} | ||
{| | {| | ||
Line 436: | Line 722: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"|In '' 'General' '' part, enter the package name | + | |style="padding: 0px 0px 15px 15px;"|In the '' 'General' '' part, enter the package name and describe the package in short. Save the changes and then move to the '' 'Plugins' '' tab.<br/> In this part you will also need to enable the package once it is prepared. |
|} | |} | ||
{| | {| | ||
Line 442: | Line 728: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"|Add plugins by searching existing ones, start typing the plugin name, press enter and the results will appear | + | |style="padding: 0px 0px 15px 15px;"|Add plugins by searching through the existing ones, start typing the plugin name, press ''enter'' and the results will appear.<br/> Add a single plugin or use the mass action button to add plugins in bulk. |
|} | |} | ||
{| | {| | ||
Line 448: | Line 734: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 20px 15px;"|Added plugins will appear on the list of included immediately. You may always | + | |style="padding: 0px 0px 20px 15px;"|Added plugins will appear on the list of included immediately. You may always delete any unwanted plugins when editing the package by pressing the bin icon. |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_17.png]] |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Once you have the packages ready, move again to the [[#General|General]] configuration of a product and select which of the packages will be available to choose from by clients or be automatically preinstalled for a single product.<br/> Surely, you may assign a different set of packages to each product. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_17_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|There is also the possibility to add '' 'Custom Plugins' ''. Press the following button to do so. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_17_2.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|Now, provide a name and description of your '' 'Custom Plugin' ''. Then, complete the '' 'URL' '' and finally define a version. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_17_3.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|If you wish to modify your '' 'Custom Plugins' '', you can easily do this by pressing the '' 'Edit' '' button. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_17_4.png]] | ||
+ | |} | ||
+ | |||
+ | ===Themes=== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|In the '' 'Themes' '' section you may prepare ready-made packages selected by you themes or create your '' 'Custom Themes' '' and automatically install them along with the WordPress instance. <br/> | ||
+ | In this quick and convenient way, your clients will have quick access to preinstalled themes on their WordPress without the need of searching them on their own. <br/> Prepare packages, enable when ready or disable when you want to withdraw them from the installation temporarily or edit their content and surely delete when no longer needed.<br/> | ||
+ | Choose '' 'Theme Packages' '' and press '' 'Create Package' '' to compose the bundle.<br/> | ||
+ | '''''Note:''' Themes included in the packages are always installed in their newest version available in the WordPress base.'' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_2_14.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|In the '' 'General' '' part, enter the package name and describe the package in short. Save the changes and then move to the '' 'Themes' '' tab.<br/> In this part you will also need to enable the package once it is prepared. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_2_15.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Add themes by searching through the existing ones, start typing the theme name, press ''enter'' and the results will appear.<br/> Add a single theme or use the mass action button to add themes in bulk. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_2_16.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|Added themes will appear on the list of included immediately. You may always delete any unwanted themes when editing the package by pressing the bin icon. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_2_17.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Once you have the packages ready, move again to the [[#General|General]] configuration of a product and select which of the packages will be installed automatically for a single product.<br/> Surely, you may assign a different set of packages to each product. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_2_17_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|There is also the possibility to add '' 'Custom Themes' ''. Press the following button to do so. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_17_5.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|Now, provide a name and description of your '' 'Custom Theme' ''. Then, complete the '' 'URL' '' and finally define a version. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_17_6.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|If you wish to modify your '' 'Custom Themes' '', you can easily do this by pressing the '' 'Edit' '' button. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_17_7.png]] | ||
|} | |} | ||
===Instance Images=== | ===Instance Images=== | ||
{| | {| | ||
− | |style="padding: 10px 0px | + | |style="padding: 10px 0px 15px 15px;"|This section is dedicated to WordPress images that are used to allow clients to add WordPress installations using these very images of WordPress.<br/> To create such an image, simply press the '' 'Add Image' '' button and then follow the steps described below. |
|} | |} | ||
{| | {| | ||
Line 462: | Line 825: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 15px 15px;"|In order to properly configure a new instance image you will need to set up the below options. <br/> |
− | *Enable - enable the image when it is ready to allow | + | Please be aware that to create such an instance image you will need to deliver full access data to a server with WordPress installations that will be used to create an image.<br/> Once a client decides to use an image to add an installation, he will be connected to the server, WordPress instance downloaded and installed. <br/>The whole process may take from a few up to a dozen or so minutes, depending on the instance complexity. |
− | *Custom - if you | + | |
− | *Installation - select existing installation of WordPress to configure instance | + | * '''Enable''' - enable the image when it is ready to allow clients to use it. |
− | *Private | + | * '''Import Type''' - select the method to import files, and choose between two types: |
− | *Name - give the instance image a unique name | + | **'''FTP Based Import''' - select to get files from a remote server. |
− | *Protocol - select protocol form: '' 'FTP', 'FTPS' '' and '' 'SFTP' '' to connect | + | **'''Username/Password Based Import''' - secure access with logging credentials, like logging into a WordPress admin account. |
− | *FTP Path - define the path to the directory that is relative to the home directory of the users | + | <br/> |
− | *Server Host - host used to connect via FTP | + | For '''FTP Based Import''' provide the following data: |
− | *Server Port - port number to connect to the FTP server | + | *'''Custom''' - if you switch on the custom images, you will need to provide a custom name of the installation and domain that will be used. |
− | *FTP User - user to connect to the FTP server | + | *'''Installation''' - select the existing installation of WordPress to configure instance images. |
− | *FTP Password - password for user to connect to the FTP server | + | *'''Private''' - if disabled, the instance will be visible to all clients who own a product with an assigned instance (more details [[#General|here]]). <br/> '' 'Private' '' flag is assigned to an instance image created by a client, which is visible to the client who has created it. |
+ | *'''Name''' - give the instance image a unique name. | ||
+ | *'''Protocol''' - select protocol form: '' 'FTP', 'FTPS' '' and '' 'SFTP' '' to connect. | ||
+ | *'''FTP Path''' - define the path to the directory that is relative to the home directory of the users. | ||
+ | *'''Server Host''' - host used to connect via FTP. | ||
+ | *'''Server Port''' - port number to connect to the FTP server. | ||
+ | *'''FTP User''' - user to connect to the FTP server. | ||
+ | *'''FTP Password''' - password for the user to connect to the FTP server. | ||
+ | <br/> | ||
+ | For '''Username/Password Based Import''' provide the following data: | ||
+ | *'''Name''' - give the instance image a unique name. | ||
+ | *'''WordPress Login URL''' - designated domain for your WordPress installation, serving as a primary web address where you can log into the admin panel to manage your website. | ||
+ | *'''Username''' - the login name used to access the WP-Admin panel. | ||
+ | *'''Password''' - the password required for secure log in to the WP-Admin panel. | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_19.png]] |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Once you have the images ready, move again to the [[#General|General]] configuration of a product and select which of the images will be available for a single product.<br/> Surely, you may assign different sets of images to each product. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_19_1.png]] | ||
|} | |} | ||
Line 482: | Line 864: | ||
====Logs==== | ====Logs==== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|The module activities are recorded in the section named '' 'Logs'. '' All entries can be deleted at any time, just click the button marked on the screen below.<br/>Keep in mind that you can remove multiple logs at once. | + | |style="padding: 10px 0px 15px 15px;"|The module activities are recorded in the section named '' 'Logs'. '' You can filter the logs by clicking on the '' 'Show' '' icons. |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_20_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|All entries can be deleted at any time, just click the button marked on the screen below.<br/>Keep in mind that you can remove multiple logs at once. | ||
|} | |} | ||
{| | {| | ||
Line 498: | Line 886: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 20px 15px;"|Press the '' ' | + | |style="padding: 0px 0px 20px 15px;"|Press the '' 'Information' '' button to get a quick view on the basic information on the task and log details. |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 10px 25px;"|[[File:WM2_24.png]] |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|Logs section will include information on errors only. If a task is completed successfully, no information will be included here. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_25.png]] | ||
|} | |} | ||
{| | {| | ||
Line 507: | Line 901: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 30px 25px;"|[[File: | + | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_25_1.png]] |
+ | |} | ||
+ | ====Settings==== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|This section controls WHMCS-wide settings that you can configure to fit your client's needs. | ||
+ | * '''PageSpeed Insights''' - Enables PageSpeed Insights functions in the '' 'Website Details' '' in the client area.<br/>'''''Note:''' 'Website Details' have to be enabled on per per-product basis for clients to access this function. The toggle can be found under 'Product Settings' → 'Edit' → 'Client Area Features' → 'Management Options'. | ||
+ | * '''Google API Token''' - Required to successfully enter and use the '' 'Website Details' '' section of the WordPress instance in the client area. The section below explains where you can find the required API Key. | ||
+ | * '''Speed Test Cron Interval''' - Define the speed test cron interval. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_25_04.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"| | ||
+ | * '''Protocols''' - Select the protocols you want to enable for clients to use. | ||
+ | * '''Extended View''' - Enable to use the extended client area view with site screen thumbnails and action tools. | ||
+ | * '''Widget size''' - Decide if you would like to use the enable the client area widget and set its size. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_25_05.png]] | ||
+ | |} | ||
+ | =====Google API Token===== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|In order to get your Google API token necessary for the Website Details section to work, open the following site: ''https://developers.google.com/speed/docs/insights/v5/get-started''<br/> Scroll down to '' 'Acquiring and using an API key' '' section. There, press '' 'Get a Key' '' button: | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_25_03.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|'' 'Enable PageSpeed Insights API' '' modal will appear. Select your project or create a new one, and then press '' 'Next'.'' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_25_02.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|That's all! Your Google API key is ready, copy it and paste in the '' 'Google API Token' '' field in the WordPress For WHMCS module Settings as described in the above section. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_25_01.png]] | ||
+ | |} | ||
+ | |||
+ | ===[https://www.docs.modulesgarden.com/Translations_Tool Translations]=== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|Customizing language files is now extremely easy with the '' "Translations" '' tool that is now available directly in the addon.<br.> Its user-friendly design makes managing various language file tweaks a smooth and efficient process. <br/> | ||
+ | Prepare translations for the original English files with this handy built-in tool. For specific instructions on how to use this tool please refer to its dedicated article, you will find it [https://www.docs.modulesgarden.com/Translations_Tool here]. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WPT_1.png]] | ||
+ | |} | ||
+ | |||
+ | ===Access Control=== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 30px 15px;"|'' 'Access Control' '' allows you to specify and control exactly which sections of the module can be accessed by your administrators. <br/> | ||
+ | The way it works is that you create access control rules in which you decide if a specific admin, or admin role has full access, or is restricted to only specific sections. | ||
+ | |} | ||
+ | |||
+ | ====Rules==== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 20px 15px;"| | ||
+ | Start with creating a new rule, click on the 'Create Rule' button and a dedicated form will appear. Below you will find a description of every field required in the form. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WMAC_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Fill out the following fields to create resources access rule: | ||
+ | *'''Rule Name''' - Pick a name for your rule. | ||
+ | *'''Grant Full Access''' - Enable to grant full access to all sections of the module to the specified personnel. Disable to specify in two additional fields below, to which resources access will be granted, and to which it will be denied. | ||
+ | *'''Allow Access To''' - Designate the resources that the specified personnel will have access to. | ||
+ | *'''Restrict Access To''' - Specify the resources that the specified personnel will not have access to. | ||
+ | *'''Administrators''' - Specify which singular administrators will be subject to the new rule. If the specific administrator is already included in the group you have picked, you do not need to add him separately. <br/> '''''Note:''' All restrictions for specific administrators are summed with the restrictions on their role groups, across all rules.'' | ||
+ | *'''Administrator Roles''' - Specify which administrator role groups will be subject to the new rule.<br/> | ||
+ | '''Important:''' When picking specific sections, keep in mind that allowing a parent section '''will also allow all of its children.''' <br/> | ||
+ | For example by allowing 'Discounts' you allow 'Discounts → Create,' 'Discounts → Edit' and 'Discounts → Delete.'<br/> | ||
+ | If you would like to give access to everything about discounts, but the ability to delete them, you can pick 'Discounts' in 'Allow Access To' and then 'Discounts → Delete' in 'Restrict Access To.'<br/> '''Restrict''' takes precedence over '''Allow,''' so if a specific section is included in both, it will be restricted. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WMAC_2.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|To edit or delete existing rules, use the icons to the right. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WMAC_3.png]] | ||
+ | |} | ||
+ | |||
+ | ====Resources==== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|Use the toggles in the 'Resources' section to specify which of them should be subject to logging, found in the 'Logs' section. <br/> Every time an administrator requests a toggled resource, it will be recorded. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WMAC_4.png]] | ||
+ | |} | ||
+ | |||
+ | ====Access Control Logs==== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|The logs section includes: | ||
+ | *Log ID | ||
+ | *Name of the administrator | ||
+ | *Requested resource | ||
+ | *Applied Resource | ||
+ | *Rule Name | ||
+ | *Date | ||
+ | Use the trash bin icons to delete specific logs, or utilize the mass action function to delete multiple logs at once. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WMAC_5.png]] | ||
+ | |} | ||
+ | |||
+ | ===Email Templates=== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|By default, the module creates the '' 'New WordPress Information' '' email template You can find it in your WHMCS '' 'Setup' '' → '' '[https://docs.whmcs.com/Email_Templates Email Templates]' '' section.<br/> | ||
+ | |||
+ | This template can be used to send WordPress details to the customer when the automatic installation is enabled after the service creation. <br/>You can also modify that template, create your own, and assign it to the service in the [[#General|product general settings]]. <br/> | ||
+ | |||
+ | Additionally, you may use the merge fields variables, which will be replaced with the corresponding WordPress installation details when are sent to the customer: | ||
+ | * '''{$installation.domain}''' - WordPress installation domain | ||
+ | * '''{$installation.url}''' - WordPress installation URL | ||
+ | * '''{$installation.version}''' - WordPress version | ||
+ | * '''{$installation.path}''' - WordPress installation path | ||
+ | * '''{$admin_username}''' - generated WordPress username | ||
+ | * '''{$admin_pass}''' - generated WordPress password | ||
+ | * '''{$installation.id'''} - ID of the WordPress instance in your WHMCS. It can be used to prepare URL that will redirect customer directly to the instance in their client area. <br/>E.g. ''{$whmcs_url}/index.php?m=WordpressManager&mg-page=home&mg-action=detail&wpid={$installation.id}'' | ||
+ | * '''{$adminurl}''' - directory path to the WordPress admin control panel. It should be used with the ''{$installation.url}'' veriable. E.g. ''{$installation.url}/{$adminurl}'' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_25_2.png]] | ||
|} | |} | ||
==Client Area== | ==Client Area== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|Now that you already have the module configured, you may see the process of adding and managing the WordPress installations by your clients.<br/> | + | |style="padding: 10px 0px 15px 15px;"|Now that you already have the module configured, you may see the process of adding and managing the WordPress installations by your clients.<br/> In the client area, find and choose your product with WordPress management support and then move directly to the relative section. |
|} | |} | ||
{| | {| | ||
Line 519: | Line 1,039: | ||
===WordPress Installations=== | ===WordPress Installations=== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"| | + | |style="padding: 10px 0px 15px 15px;"|Extended view, toggled by the admin in the module addon, read more [[#Settings|here]]. |
− | The former | + | At the top of the page, you will find all WordPress installations located in dedicated segments. Every installation has its own section with screen grabs, installation details and instant access to action tools.<br/> The '' 'Reseller Accounts' '' section is visible only in case such accounts are detected in the client's cPanel, DirectAdmin or Plesk panels, otherwise, it is hidden. |
− | + | |} | |
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_27_0.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|The standard view of the WordPress Management page includes the very same information as the extended view, yet they are placed in a simple list form. Underneath the list, there is also a section dedicated to '' 'Reseller Accounts'. ''<br/> | ||
+ | The former contains a list with basic information regarding every installation, including the domain, related product, URL, etc. <br/> | ||
+ | The '' 'Reseller Accounts' '' section again is visible only in case such accounts are detected in the client's cPanel or DirectAdmin panels, otherwise, it is hidden. They are displayed in a standard manner only. | ||
|} | |} | ||
{| | {| | ||
Line 527: | Line 1,054: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: | + | |style="padding: 0px 0px 15px 15px;"|Use action buttons marked on the screen to perform actions on a single installation: |
− | * | + | *View/Edit installation details |
− | * | + | *Log into the Control Panel |
− | * | + | *Update |
+ | Additional actions include: | ||
+ | *Clear cache | ||
+ | *Clone the installation | ||
+ | *Change domain | ||
+ | *Manage auto upgrade | ||
+ | *Create staging instance | ||
+ | *Push to live the staging instance | ||
+ | *Manage SSL status | ||
+ | *Maintenance mode status | ||
+ | *Create instance image | ||
+ | *Delete installation | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_27_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Among additional actions you will find the options to: | ||
+ | *Add a new installation | ||
+ | *Import the installation from a remote server | ||
+ | *Create the installation from an instance image | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_28.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|You may also delete or update multiple WordPress instances to the newest version at once, use mass actions to do so ''(standard view only).'' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_28_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|If you wish, you may create a backup of the instances before processing the update. | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 30px 25px;"|[[File: | + | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_28_2.png]] |
|} | |} | ||
====New Installations==== | ====New Installations==== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"| | + | |style="padding: 10px 0px 15px 15px;"|As mentioned above, there are three ways to create a new WordPress Installation. The first basic way is to simply install a completely new and clean instance of WordPress.<br/> |
− | Press the button '' 'New Installation' '' marked on the screen below and read the | + | Press the button '' 'New Installation' '' marked on the screen below and read the instructions to see how to install a pure new instance. |
|} | |} | ||
{| | {| | ||
Line 545: | Line 1,104: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"| A new window | + | |style="padding: 0px 0px 15px 15px;"| A new window with two tabs will open.<br/> |
− | In the first '' '''Details''' '' tab, fill in the following fields: | + | In the first '' '''Details''' '' tab, fill in the following fields: |
− | *'''Product/Service''' - select hosting to install WordPress on it | + | *'''Product/Service''' - select hosting to install WordPress on it. |
*'''Protocol''' - select protocol from among: '' <nowiki>'https://', 'http://', 'http://www'</nowiki> '' and '' <nowiki>'https://www'</nowiki> '' | *'''Protocol''' - select protocol from among: '' <nowiki>'https://', 'http://', 'http://www'</nowiki> '' and '' <nowiki>'https://www'</nowiki> '' | ||
*'''Domain''' - provide a domain the software will be installed on. | *'''Domain''' - provide a domain the software will be installed on. | ||
− | *'''Installation Script''' - here you can select any custom installation script that you want to install.<br/>Note that this field will be displayed only for domains | + | *'''Installation Script''' - here you can select any custom installation script that you want to install.<br/>Note that this field will be displayed only for domains which products have installation scripts configured in the [[#Product Settings|Products Settings]].<br/>If it is not displayed then the clean WordPress installation will be applied. |
− | *'''Plugin Packages''' - select plugin packages to install on WordPress | + | *'''Plugin Packages''' - select plugin packages to install on WordPress, more about their configuration can be found [[#Plugin Packages|here]]. |
− | *'''Administrator Password''' - generate an administrator password for this new installation of WordPress | + | *'''Administrator Password''' - generate an administrator password for this new installation of WordPress. |
− | *'''Site | + | *'''Site Title''' - the name of a site created for the installation. |
*'''Language''' - choose a language for the installation. | *'''Language''' - choose a language for the installation. | ||
− | *'''Administrator Username''' | + | *'''Administrator Username''' - enter the administrator account username for this installation. |
− | *'''Administrator Email''' | + | *'''Administrator Email''' - enter the administrator account email address for this installation. |
− | '' '''Note''' that only those fields marked with '''*''' (e.g. 'Site | + | <!-- '' '''Note''' that only those fields marked with '''*''' (e.g. 'Site Title') are required to complete the creation.'' --> |
|} | |} | ||
{| | {| | ||
Line 563: | Line 1,122: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"|Complete the configuration by switching to the '' '''Other''' '' tab and enter the remaining fields: | + | |style="padding: 0px 0px 15px 15px;"|Complete the configuration by switching to the '' '''Other''' '' tab and enter the remaining fields ''(optional)'': |
*'''Description''' - describe the installation site shortly. | *'''Description''' - describe the installation site shortly. | ||
− | *'''Directory''' - provided here directory is relative to your domain, leave empty to install on your domain or enter e.g. '' 'dir' '' to install on ''<nowiki>http:// | + | *'''Directory''' - provided here directory is relative to your domain, leave empty to install on your domain or enter e.g. '' 'dir' '' to install on ''<nowiki>http://mydomain/dir/</nowiki>''. |
− | *'''Database Name''' - the name of a newly created database | + | *'''Overwrite Directory''' - if enabled, the contents of the directory will be overwritten. |
+ | *'''Database Name''' - the name of a newly created database that will be created during the installation. | ||
*'''Database Prefix''' - the table prefix for the tables created by the app (optionally). | *'''Database Prefix''' - the table prefix for the tables created by the app (optionally). | ||
*'''Multisite''' - if enabled, your blog will have the '' 'Multisite' '' option. Note that your server must support '' 'Apache mod_rewrite'.'' | *'''Multisite''' - if enabled, your blog will have the '' 'Multisite' '' option. Note that your server must support '' 'Apache mod_rewrite'.'' | ||
− | *'''Auto Upgrade''' - | + | *'''Auto Upgrade''' - define the WordPress installation updates automatization method: |
+ | **'''Disable Auto Upgrades''' | ||
+ | **'''Upgrade to the latest version available (Major or Minor)''' | ||
+ | **'''Upgrade to Minor upgrades only''' | ||
*'''Auto Upgrade Plugins''' - if enabled, all active WordPress plugins installed for this installation will be automatically updated to the latest versions when available. | *'''Auto Upgrade Plugins''' - if enabled, all active WordPress plugins installed for this installation will be automatically updated to the latest versions when available. | ||
− | *'''Auto Upgrade Themes''' - if enabled, the active WordPress theme for this installation will be automatically updated to the latest version when available. | + | *'''Auto Upgrade Themes''' - if enabled, the active WordPress theme for this installation will be automatically updated to the latest version when available.<br/> |
− | If you have entered all the data correctly, you can now press the '' 'Create' '' button to complete the installation. | + | If you have entered all the data correctly, you can now press the '' 'Create' '' button to complete the installation.<br/> |
+ | '''''Note:''' data in 'Other' section are not required to create the instance successfully, it can be simply skipped.'' | ||
|} | |} | ||
{| | {| | ||
Line 580: | Line 1,144: | ||
=====Import From Remote Server===== | =====Import From Remote Server===== | ||
{| | {| | ||
− | |style="padding: 10px 0px | + | |style="padding: 10px 0px 20px 15px;"|The second way to add a new installation is by importing an existing installation from a remote FTP server. Press the additional actions button to find the redirection. |
|} | |} | ||
{| | {| | ||
Line 587: | Line 1,151: | ||
{| | {| | ||
|style="padding: 0px 0px 15px 15px;"|First of all, fill out the data on the source server: | |style="padding: 0px 0px 15px 15px;"|First of all, fill out the data on the source server: | ||
− | *'''Domain''' where the source script is located | + | *'''Import Type''' - select between two import types: |
− | *'''Server Host''' used as a host to connect via FTP | + | **'''FTP Based Import''' - select to get files from a remote server. |
− | *'''Protocol''' used for connection to the domain | + | **'''Username/Password Based Import''' - secure access with logging credentials, like logging into a WordPress admin account. |
− | *'''Server Port''' port number to connect to the FTP server | + | |
− | *'''FTP User''' user to connect to the FTP server | + | For '''FTP Based Import''' provide: |
− | *'''FTP Password''' user password | + | *'''Domain''' - domain name where the source script is located |
− | *'''FTP Path''' path to the directory relative to the home directory of a user for installations | + | *'''Server Host''' - used as a host to connect via FTP |
− | *'''Installed Path''' directory under the domain where your script is installed, leave empty if installed in the root directory | + | *'''Protocol''' - the protocol used for connection to the domain |
+ | *'''Server Port''' - port number to connect to the FTP server | ||
+ | *'''FTP User''' - user used to connect to the FTP server | ||
+ | *'''FTP Password''' - user password to connect to the FTP server | ||
+ | *'''FTP Path''' - path to the directory relative to the home directory of a user for installations | ||
+ | *'''Installed Path''' - directory under the domain where your script is installed, leave empty if installed in the root directory | ||
|} | |} | ||
{| | {| | ||
Line 600: | Line 1,169: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"|Then move to the other tab, to provide any data on the destination. | + | |style="padding: 0px 0px 15px 15px;"|For '''Username/Password Based Import''' provide: |
− | *'''Product/Service''' - choose a hosting to install WordPress on it | + | *'''WordPress Login URL''' - designated domain for your WordPress installation, serving as a primary web address where you can log into the admin panel to manage your website. |
− | *'''Protocol''' - | + | *'''Username''' - the login name used to access the WP-Admin panel. |
− | *'''Domain''' - destination domain where the script will be imported | + | *'''Password''' - the password required for secure log in to the WP-Admin panel. |
− | *'''Directory''' - directory under the domain where the script will be imported. Leave blank to import to the root directory of your domain | + | |} |
− | *'''Database''' - database name for the script | + | {| |
− | Press '' 'Import' '' button to finalize the process | + | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_33_0.png]] |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Then move to the other tab, to provide any data on the '''destination'''. | ||
+ | *'''Product/Service''' - choose a hosting to install WordPress on it. | ||
+ | *'''Protocol''' - select the protocol that will be used. | ||
+ | *'''Domain''' - destination domain where the script will be imported. | ||
+ | *'''Directory''' - directory under the domain where the script will be imported. Leave blank to import to the root directory of your domain. | ||
+ | *'''Database''' - database name for the script. | ||
+ | *'''Site Title''' - enter the name to be displayed as the website title in WordPress.<br/> | ||
+ | Press the '' 'Import' '' button to finalize the process.<br/> | ||
+ | '''''Note:''' the process may take from a few up to a dozen or so minutes for the instance to appear on the list, depending on the instance size or external server connection speed.'' | ||
|} | |} | ||
{| | {| | ||
Line 612: | Line 1,192: | ||
|} | |} | ||
− | ===== | + | =====Instance Image===== |
{| | {| | ||
|style="padding: 10px 0px 20px 15px;"|It is also possible to use an existing instance image. | |style="padding: 10px 0px 20px 15px;"|It is also possible to use an existing instance image. | ||
Line 621: | Line 1,201: | ||
{| | {| | ||
|style="padding: 0px 0px 15px 15px;"|Provide the below enumerated and described details, then press '' 'Create' '' to complete: | |style="padding: 0px 0px 15px 15px;"|Provide the below enumerated and described details, then press '' 'Create' '' to complete: | ||
− | *'''Product/Service''' - choose hosting to install WordPress on | + | *'''Product/Service''' - choose hosting to install WordPress on. |
− | *'''Instance Image''' - select WordPress instance image from | + | *'''Instance Image''' - select WordPress instance image from client ''[[#Instance Image|private instances]]'' and ''[[#Instance Images|public images]]'' created by the admin. |
− | *'''Protocol''' | + | *'''Protocol''' - select the protocol that will be used. |
− | *'''Domain''' | + | *'''Domain''' - destination domain to which the new instance will be imported. |
− | *'''Directory''' | + | *'''Directory''' - directory under the domain, leave blank if you want to install WordPress instance in the root directory. |
− | *'''Database''' | + | *'''Database''' - type in the database name for the script. |
+ | *'''WordPress Username''' - enter the admin user name established for the new WordPress installation. | ||
+ | *'''WordPress Password''' - enter the password established for the new WordPress installation. | ||
+ | *'''Site Title''' - enter the name displayed as the website name in WordPress. <br/> | ||
+ | '''''Note:''' the process may take from a few up to a dozen or so minutes for the instance to appear on the list, depending on the instance size or complexity.'' | ||
|} | |} | ||
{| | {| | ||
Line 634: | Line 1,218: | ||
====Installation Management==== | ====Installation Management==== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|Once you have successfully created a new installation, you can edit its advanced options or simply remove it in case you no longer need it.<br/> Let us view the management options and available actions now. | + | |style="padding: 10px 0px 15px 15px;"|Once you have successfully created a new installation, you can edit its advanced options or simply remove it in case you no longer need it.<br/> Let us view the management options and available actions now.<br/> |
+ | |||
+ | '''''Note:''' Please be aware that deleting installations "(3)" is not possible from this section for the '''WP Toolkit for Plesk API'''. To delete an instance, you need to log into the Plesk panel.<br/> Once deleted there, please wait until the next cron execution for the instance to be removed from this management section. For more information, refer to the [[#WP_Toolkit_Integration|WP Toolkit integration]] section.'' | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_27.png]] |
|} | |} | ||
=====Installation Details===== | =====Installation Details===== | ||
{| | {| | ||
− | |style="padding: 10px 0px | + | |style="padding: 10px 0px 15px 15px;"|On the very first page, when you enter the edit section, there is an exemplary configuration of your installation in the '' 'Management' '' section. <br/>You will find there all the basic information, such as domain and database details, available at hand. |
|} | |} | ||
{| | {| | ||
|style="padding: 0px 0px 30px 25px;"|[[File:WM2_38.png]] | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_38.png]] | ||
|} | |} | ||
+ | |||
+ | =====Website Details===== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|Desktop and mobile website details based on Google "PageSpeed Insights" statistics. This section requires to previously generate and provide the '' 'Google API Token'.''<br/> Follow [[#Settings|this instructions]] to learn how to do that. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_38_1.png]] | ||
+ | |} | ||
+ | |||
=====Backups===== | =====Backups===== | ||
{| | {| | ||
Line 654: | Line 1,249: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 20px 15px;"|Surely you can delete multiple backups at once. Take a look at the screenshot below. |
|} | |} | ||
{| | {| | ||
Line 660: | Line 1,255: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"|When creating a backup installation, decide whether to backup directory only, data directory or database. Select location and then confirm the action.<br/> | + | |style="padding: 0px 0px 15px 15px;"|When creating a backup installation, decide whether to the backup directory only, the data directory, or the database. Select location and then confirm the action.<br/> |
'''''Note:''' Keep in mind that creating a backup might take a longer while. Backup will appear on the list when it is ready.'' | '''''Note:''' Keep in mind that creating a backup might take a longer while. Backup will appear on the list when it is ready.'' | ||
|} | |} | ||
Line 669: | Line 1,264: | ||
=====Themes===== | =====Themes===== | ||
{| | {| | ||
− | |style="padding: 10px 0px 20px 15px;"|Here you are enabled to activate, disable, update and delete the existing theme. Add new themes to your WordPress installation in the '' 'Add New' '' tab. | + | |style="padding: 10px 0px 20px 15px;"|Here you are enabled to activate, disable, update, and delete the existing theme. Add new themes to your WordPress installation in the '' 'Add New' '' tab. |
|} | |} | ||
{| | {| | ||
Line 675: | Line 1,270: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"|In order to add a new theme, start typing in the desired theme's name in the search box, press enter to see the actual results.<br/> | + | |style="padding: 0px 0px 15px 15px;"|In order to add a new theme, start typing in the desired theme's name in the search box, and press enter to see the actual results.<br/> You may press the theme thumbnail to preview the on wp-themes.com. Afterwards, press the icon marked on the screenshot below to continue. |
− | Afterwards, press the icon marked on the screenshot below. | + | |
|} | |} | ||
{| | {| | ||
Line 686: | Line 1,280: | ||
{| | {| | ||
|style="padding: 0px 0px 20px 25px;"|[[File:WM2_44.png]] | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_44.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|If there are any '' 'Custom Themes' '' accessible for adding, they will be located here. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_44_1.png]] | ||
|} | |} | ||
{| | {| | ||
Line 707: | Line 1,307: | ||
{| | {| | ||
|style="padding: 0px 0px 20px 25px;"|[[File:WM_S_1811.png]] | |style="padding: 0px 0px 20px 25px;"|[[File:WM_S_1811.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM_S_1812.png]] | ||
|} | |} | ||
{| | {| | ||
Line 715: | Line 1,318: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 20px 15px;"|In case the plugin seems interesting, just press the '' 'Install' '' button. |
|} | |} | ||
{| | {| | ||
|style="padding: 0px 0px 20px 25px;"|[[File:WM_S_1811_1.png]] | |style="padding: 0px 0px 20px 25px;"|[[File:WM_S_1811_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|There is also an option to add your custom plugins, simply press the adequate icon and confirm the action. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM_S_1811_3.png]] | ||
|} | |} | ||
{| | {| | ||
Line 729: | Line 1,338: | ||
=====Plugin Packages===== | =====Plugin Packages===== | ||
{| | {| | ||
− | |style="padding: 10px 0px | + | |style="padding: 10px 0px 15px 15px;"|Plugin Packages allow to install a bunch of pre-organized plugins at once. Information on how to prepare such packages can be found [[#Plugin Packages|here]].<br/> |
+ | Simply press the '' '+' '' button to install the package with plugins that seems especially attractive to you.<br/> | ||
+ | '''''Note:''' Plugins included in the packages are always installed in their newest version available in the WordPress base.'' | ||
|} | |} | ||
{| | {| | ||
Line 738: | Line 1,349: | ||
{| | {| | ||
|style="padding: 10px 0px 15px 15px;"|In this section you can directly alter the records from the '' '''wp-config.php''' '' file.<br/>This file is located in the root of your WordPress file directory and contains your website's configuration details such as database connection information.<br/>You are allowed to edit or delete already existing config records as well as create new ones.<br/> | |style="padding: 10px 0px 15px 15px;"|In this section you can directly alter the records from the '' '''wp-config.php''' '' file.<br/>This file is located in the root of your WordPress file directory and contains your website's configuration details such as database connection information.<br/>You are allowed to edit or delete already existing config records as well as create new ones.<br/> | ||
− | '' '''Important:''' Be particularly careful when editing these config records! You can find more information about | + | '' '''Important:''' Be particularly careful when editing these config records! You can find more information about editing the 'wp-config.php' file [https://wordpress.org/support/article/editing-wp-config-php/ here].'' |
|} | |} | ||
{| | {| | ||
Line 744: | Line 1,355: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 20px 15px;"|When creating a new config record, enter its proper name, value and | + | |style="padding: 0px 0px 20px 15px;"|When creating a new config record, enter its proper name, and value and choose one of the two available types ''('Constant' or 'Variable')''. |
|} | |} | ||
{| | {| | ||
|style="padding: 0px 0px 30px 25px;"|[[File:WM_21.png]] | |style="padding: 0px 0px 30px 25px;"|[[File:WM_21.png]] | ||
+ | |} | ||
+ | |||
+ | ====Users==== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|Enter this section to manage existing users and create new ones. You are allowed to perform the following actions on a single user: | ||
+ | *edit the existing user details (1) ''(change role, change display name, change the email address)'' | ||
+ | *change its password (2) | ||
+ | *delete the user(3) | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_21_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|When creating a new user, you will have to provide the following data to complete: | ||
+ | *enter the username | ||
+ | *provide its email address for communication | ||
+ | *type in the display name | ||
+ | *enter the user password | ||
+ | *select the role from the dropdown menu | ||
+ | *decide whether to send a notification email about creating the account | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_21_2.png]] | ||
|} | |} | ||
Line 755: | Line 1,389: | ||
*'''Control Panel''' - log in to your WordPress panel directly any time you like. | *'''Control Panel''' - log in to your WordPress panel directly any time you like. | ||
*'''Clear Cache''' - remove the cache of your installation. | *'''Clear Cache''' - remove the cache of your installation. | ||
− | *'''Update''' - after selecting this option, your WordPress will be updated to the latest version if any is available | + | *'''Update''' - after selecting this option, your WordPress will be updated to the latest version if any is available. |
− | *'''Delete''' - immediately remove the complete installation along with its settings or selected parts of it<br/> | + | *'''Delete''' - immediately remove the complete installation along with its settings or selected parts of it. <br/> |
− | Underneath you can find detailed description of all the remaining actions. Please take a look. | + | '''''Important:''' Please refer to the [[#WP_Toolkit_Integration|WP Toolkit Integration]] section for the list of troublesome features and make sure they are supported by the API you are using.''<br/> |
+ | |||
+ | Underneath you can find a detailed description of all the remaining actions. Please take a look. | ||
|} | |} | ||
{| | {| | ||
Line 770: | Line 1,406: | ||
*Provide a domain where the cloned WordPress instance will be installed | *Provide a domain where the cloned WordPress instance will be installed | ||
− | *Enter a directory - note that provided directory is relative to your domain, type in e.g. | + | *Enter a directory - note that the provided directory is relative to your domain, type in e.g. ‘’dir’’ or leave empty |
− | * | + | *Type in the database name<br/> |
The cloned installation will appear on the list of installations after a while. | The cloned installation will appear on the list of installations after a while. | ||
Line 779: | Line 1,415: | ||
|style="padding: 0px 0px 30px 25px;"|[[File:WM2_56.png]] | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_56.png]] | ||
|} | |} | ||
+ | |||
=====Change Domain===== | =====Change Domain===== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|If you want to change the domain of your WordPress installation, simply provide here a new one.<br/> Decide whether to create backup at the same time and enable/disable SSL for the new domain. | + | |style="padding: 10px 0px 15px 15px;"|If you want to change the domain of your WordPress installation, simply provide here a new one.<br/> Decide whether to create a backup at the same time and enable/disable SSL for the new domain. |
|} | |} | ||
{| | {| | ||
Line 789: | Line 1,426: | ||
=====Manage Auto Upgrades===== | =====Manage Auto Upgrades===== | ||
{| | {| | ||
− | |style="padding: 10px 0px | + | |style="padding: 10px 0px 15px 15px;"|Set up the automatic upgrades rules. Here you may enable or disable automatic upgrades: |
− | * | + | *Of the installation |
*Plugins | *Plugins | ||
*Themes | *Themes | ||
Line 800: | Line 1,437: | ||
=====Staging===== | =====Staging===== | ||
{| | {| | ||
− | |style="padding: 10px 0px 20px 15px;"|Create staging instances from an application to test the upgrades or changes before using them in the live environment. | + | |style="padding: 10px 0px 20px 15px;"|Create staging instances from an application to test the upgrades or changes before using them in the live environment. |
|} | |} | ||
{| | {| | ||
Line 806: | Line 1,443: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 15px 15px;"|Please be patient, as the whole process may take a few minutes. The staging instance will appear on the list of your installations after the first cron synchronization.<br/> |
+ | Push the staging installation to the live environment once you are sure it works fine and changes suit your needs. | ||
|} | |} | ||
− | |||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_60.png]] |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|In case you need to customize the installation before pushing it live simply toggle the '' 'Customize' '' option. <br/> Then define the specification and confirm to finish. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_60_1.png]] | ||
|} | |} | ||
− | |||
=====SSL===== | =====SSL===== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|Turn on or off SSL for the installation. Remember that enabling SSL will result in changes being made in your WordPress database configuration, it is advised to back up your installation. <br/>Toggle the '' 'Create Backup' '' option | + | |style="padding: 10px 0px 15px 15px;"|Turn on or off SSL for the installation. Remember that enabling SSL will result in changes being made in your WordPress database configuration, it is advised to back up your installation. <br/> |
+ | Along with enabling SSL, a free [https://letsencrypt.org/ Let's Encrypt] SSL will be installed on ''DirectAdmin'' products ''(note that this feature is not available for 'cPanel').''<br/> | ||
+ | Toggle the '' 'Create Backup' '' option and then confirm the actions. | ||
|} | |} | ||
{| | {| | ||
|style="padding: 0px 0px 30px 25px;"|[[File:WM2_61.png]] | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_61.png]] | ||
+ | |} | ||
+ | =====Debug Mode===== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 20px 15px;"|Check whether the debug mode is currently enabled or disabled. Change the mode by pressing the '' 'Change' '' button. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_61_2.png]] | ||
+ | |} | ||
+ | |||
+ | =====Maintenance Mode===== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 20px 15px;"|Check the current status of the website, turn off/on maintenance mode according to your needs by pressing the '' 'Change' '' button. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_61_1.png]] | ||
|} | |} | ||
=====Instance Image===== | =====Instance Image===== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|Turn on instance image on the WordPress installation. Simply, toggle '' 'Mark As Image' '' option and then fill in the below options.<br/> | + | |style="padding: 10px 0px 15px 15px;"|Turn on instance image on the WordPress installation. Simply, toggle the '' 'Mark As Image' '' option and then fill in the below options.<br/> |
− | '''''Note:''' The 'FTP Password' input is encoded in the database, which makes | + | '''''Note:''' The 'FTP Password' input is encoded in the database, which makes it completely safe and secure.'' |
|} | |} | ||
{| | {| | ||
|style="padding: 0px 0px 30px 25px;"|[[File:WM2_63.png]] | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_63.png]] | ||
+ | |} | ||
+ | |||
+ | ====Dashboard Widget==== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|WordPress Manager For WHMCS comes with a built-in widget displayed in the client area home page. | ||
+ | This allows the client to see their installations at a glance. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_63_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|The widget visibility can be configured in the admin area.<br/> | ||
+ | Navigate to '' 'Addons' '' → ' ''WordPress Manager' '' → '' 'Other' '' → '' 'Settings' '' and find the '' 'Widget Size' '' option.<br/> | ||
+ | *Disabled - Disable the widget altogether. | ||
+ | *Small - Make the widget small (like on the screen above). | ||
+ | *Full Size - Make the widget as wide as possible. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_63_2.png]] | ||
|} | |} | ||
===Reseller Accounts=== | ===Reseller Accounts=== | ||
{| | {| | ||
− | |style="padding: 10px 0px 15px 15px;"|Existing Reseller's Accounts with number of WordPress installations. | + | |style="padding: 10px 0px 15px 15px;"|Existing Reseller's Accounts with the number of WordPress installations. Keep in mind that this section is visible only when such accounts exist in the client's cPanel or DirectAdmin panels.<br/> In case no such accounts have been detected, this section is hidden.<br/> |
+ | '' '''Note:''' Plesk resellers accounts are not yet currently supported.''<br/> ''Make sure to disable Softaculus' 'Multisite (WPMU)' feature in the panel if you intend to use the reseller's accounts, as the two functions may conflict during instance import. '' | ||
+ | |||
+ | The table includes the name of the product, reseller's account name on which the instances are installed as well as their number. | ||
|} | |} | ||
{| | {| | ||
Line 841: | Line 1,522: | ||
|style="padding: 0px 0px 15px 15px;"|Press the edit icon to view the list of existing installations. Among other allowed actions there are: | |style="padding: 0px 0px 15px 15px;"|Press the edit icon to view the list of existing installations. Among other allowed actions there are: | ||
*Add New Installation | *Add New Installation | ||
− | *Import From Remote | + | *Import From Remote Server |
− | *Instance Image | + | *Use Instance Image |
|} | |} | ||
{| | {| | ||
Line 848: | Line 1,529: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 15px 15px;"|The only difference is the need to select a customer when adding new installation.<br/> All the remaining options are | + | |style="padding: 0px 0px 15px 15px;"|The only difference is the need to select a customer when adding a new installation.<br/> If there is no username available here to choose, the reseller must create an extra account in the cPanel or DirectAdmin panels. <br/> |
+ | All the remaining options are the same as in the case of standard WordPress installations described in the above sections. | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_66.png]] |
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Using mass actions you may also update multiple WordPress instances to the newest version at once or delete them. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_66_1.png]] | ||
+ | |} | ||
+ | |||
+ | ===WP Toolkit Integration=== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 5px 15px;"|As an alternative to the Softaculous auto-installer, you have the option to benefit from the WP Toolkit integration available for cPanel/WHM or Plesk.<br/> | ||
+ | Please note that if you are using the '''free version of WP Toolkit''', certain features may '''not be accessible or fully functional''' within the WordPress Manager module.<br/> For a detailed comparison of features '''not supported''' by Softaculous and the WP Toolkit API, please refer to the table below. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 10px 15px;"|'''Important!''' <br/> | ||
+ | By default, all three APIs support all features enumerated on the product [[#About_WordPress_Manager_For_WHMCS|features list]], available at the top of this documentation.<br/> Yet some options are limited to Softaculous or WP Toolkit API, or are only partially supported by any of them. <br/> | ||
+ | If you do not see a feature you are interested in here it means that '''all three available APIs support it.''' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|'''List of troublesome features with API compatibility status:''' | ||
+ | |} | ||
+ | {|class="wikitable" style="margin-left: 15px; margin-bottom: 20px; margin-top: 0px; text-align: center;" | ||
+ | |- text-align:center; | ||
+ | ! | ||
+ | ! style="text-align:left;" |'''Feature Name''' | ||
+ | ! '''Softaculous''' | ||
+ | ! '''WP Toolkit for Plesk''' | ||
+ | ! '''WP Toolkit for cPanel/WHM''' | ||
+ | |- style="text-align:center;" | ||
+ | | style="text-align:left;" | 1. | ||
+ | | style="text-align:left;" | Clone an instance | ||
+ | | ✔️ | ||
+ | | ✔️ | ||
+ | | ❌ | ||
+ | |- style="text-align:center;" | ||
+ | | style="text-align:left;" | 2. | ||
+ | | style="text-align:left;" | Delete an instance | ||
+ | | ✔️ | ||
+ | | ❌ | ||
+ | | ✔️ | ||
+ | |- style="text-align:center;" | ||
+ | | style="text-align:left;" | 3. | ||
+ | | style="text-align:left;" | Download backups | ||
+ | | ✔️ | ||
+ | | ❌ | ||
+ | | ✔️ | ||
+ | |- style="text-align:center;" | ||
+ | | style="text-align:left;" | 4. | ||
+ | | style="text-align:left;" | Push staging to live environment | ||
+ | | ✔️ | ||
+ | | ❌ | ||
+ | | ❌ | ||
+ | |- style="text-align:center;" | ||
+ | | style="text-align:left;" | 5. | ||
+ | | style="text-align:left;" | Create staging | ||
+ | | ✔️ | ||
+ | | ❌ | ||
+ | | ❌ | ||
+ | |- style="text-align:center;" | ||
+ | | style="text-align:left;" | 6. | ||
+ | | style="text-align:left;" | Use instance image | ||
+ | | ✔️ | ||
+ | | ❌ | ||
+ | | ❌ | ||
+ | |- style="text-align:center;" | ||
+ | | style="text-align:left;" | 7. | ||
+ | | style="text-align:left;" | Access setup section<br/> ''(Installation Details → Actions → Setup)'' | ||
+ | | ❌ | ||
+ | | ✔️ | ||
+ | | ✔️ | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 15px;"|Depending on your API selection, be sure to customize the [[#Client_Area_Features|Client Area Features]] in your product configuration.<br/> This ensures that your clients have access only to the supported functionalities while disabling any unsupported ones.<br/> | ||
+ | |} | ||
+ | |||
+ | =Use Cases= | ||
+ | {| | ||
+ | |style="padding: 10px 0px 30px 15px;"|'''In this section, you will find real-life examples of using the module. We'll show you how the module's features can be put to work in different situations.'''<br/> | ||
+ | See the scenarios below to see how the module can be used in practice. | ||
+ | |} | ||
+ | ==Automatic WordPress Installation== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|'''Products in WordPress Manager For WHMCS can be set up to install new WordPress instances after service creation automatically'''.<br/> There are two basic methods for that purpose: | ||
+ | *'' 'Based On Installation Script' '' and | ||
+ | *'' 'Based On Instance Image' ''<br/> | ||
+ | Navigate to '' 'Addons' '' → '' 'WordPress Manager' '' → '' 'Product Settings' '' → your product '' 'Details' '' page.<br/> | ||
+ | |||
+ | '''For script-based installation:''' in the '' 'Auto Install WordPress After Service Creation' '' field, select the '' 'Based On Installation Script' '' option and pick a script from the dropdown field below.<br/> | ||
+ | '''''Note:''' The scripts are fetched from your WordPress panel script list and can be edited there.'' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_70_7.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|'''For image-based installation:''' in the '' 'Auto Install WordPress After Service Creation' '' field, select the '' 'Based On Instance Image' '' option and pick an image from the dropdown field below.<br/> | ||
+ | '''''Note:''' If you do not have any instance image created yet, you can learn how to do that in the [[#Instance_Images|Instance Images]] section.'' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_70_8.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Once the client orders the configured product, WordPress will be automatically installed according to the selected method.<br/> | ||
+ | Furthermore, you may include custom fields that will allow users to set their own WordPress username, password, and site title. | ||
+ | wp_username|Username or wp_user_id| User ID | ||
+ | wp_password|Password or wp_user_password|Password | ||
+ | wp_site_title|Site Title | ||
+ | See [[#Tips|tips]] (point 5) for more information on custom fields. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_70_10.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|If the custom fields are left empty, the credentials will be generated automatically for the client. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_70_9.png]] | ||
+ | |} | ||
+ | |||
+ | ==Instance Import During Order== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|'''While ordering products with WordPress Manager For WHMCS clients can migrate their WordPress installations seamlessly.''' <br/>To take advantage of this option you need to include import-related custom fields in the order form of your product.<br/> | ||
+ | Navigate to '' 'System Settings' '' → '' 'Products/Services','' edit your product, move to the '' 'Custom Fields' '' tab, and include the following custom fields. | ||
+ | *wp_url|WordPress Import URL | ||
+ | *wp_user_id|WordPress Import Username | ||
+ | *wp_user_password|WordPress Import Password | ||
+ | You can change the display name of the field after the '' '|' '' sign.<br/> | ||
+ | Remember to check the '' 'Show on Order Form' '' option for each custom field.<br/> | ||
+ | '''''Note:''' Use the 'Text Box' file type, even for the URL. The module's in-build validation already covers the WHMCS 'Link/URL' field type validation and more. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_70_11.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Clients will be able to fill those fields during the order with their WordPress credentials, enabling the module to migrate their WordPress after the order is accepted (during the cron job run).<br/> | ||
+ | Additionally, you may combine import-related custom fields with other custom fields found in point 5 of the [[#Tips|Tips]] section. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_70_12.png]] | ||
+ | |} | ||
+ | |||
+ | ==Migrating Existing Instances Via FTP== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|'''WordPress instances located on other servers can easily be migrated to your server through FTP.'''<br/> All it takes is a few simple steps.<br/> | ||
+ | First, open the WordPress Manager in the client area and select '' 'Import From Remote Server'.'' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_67_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Select the FTP Based Import Type and provide the information necessary for the import: | ||
+ | *'''Domain''' - the domain of the source WordPress installation. | ||
+ | *'''Server Host''' - FTP connection host. | ||
+ | *'''Protocol''' - the protocol that will be used during the connection. | ||
+ | *'''Server Port''' - number of the port used for the FTP connection. | ||
+ | *'''FTP User''' - username used for the FTP connection. | ||
+ | *'''FTP Password''' - user password used for the FTP connection. | ||
+ | *'''FTP Path''' - path to the directory relative to the home directory of a user for installations. | ||
+ | *'''Installed Path''' - directory under the domain where your script is installed, leave empty if installed in the root directory. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_67_2.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Move to the '' 'Destination' '' tab and fill in the desired details of the migrated instance: | ||
+ | *'''Product/Service''' - the hosting to be used for the migrating instance. | ||
+ | *'''Protocol''' - the protocol to be used for the instance. | ||
+ | *'''Domain''' - destination domain to which the instance will be migrated. | ||
+ | *'''Directory''' - directory under the domain where the script will be ported to, the root directory will be used if left empty. | ||
+ | *'''Database''' - database name for the script. | ||
+ | *'''Site Title''' - title of the website visible in WordPress. | ||
+ | |||
+ | Click on '' 'Import' '' to start the process. The instance should be migrated after the cron run. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_67_3.png]] | ||
+ | |} | ||
+ | |||
+ | ==Migrating Existing Instances Using WordPress Credentials== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|'''WordPress instances from third-party servers can also be migrated with just the WordPress account credentials.'''<br/>See the steps described below to see how easy it is.<br./> | ||
+ | Start by opening the WordPress Manager in the client area and select '' 'Import From Remote Server'.'' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_67_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Select the Username/Password Based Import Type and provide your WordPress credentials: | ||
+ | *'''WordPress Login URL''' - primary address of your existing WordPress installation. | ||
+ | *'''Username''' - the username used to log in to your WordPress administrative dashboard. | ||
+ | *'''Password''' - the password used to log in to your WordPress administrative dashboard. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_68_2.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Next, open the '' 'Destination' '' tab and provide details regarding your desired installation after migration: | ||
+ | *'''Product/Service''' - the hosting to be used for the migrating instance. | ||
+ | *'''Protocol''' - the protocol to be used for the instance. | ||
+ | *'''Domain''' - destination domain to which the instance will be migrated. | ||
+ | *'''Directory''' - directory under the domain where the script will be ported to, the root directory will be used if left empty. | ||
+ | *'''Database''' - database name for the script. | ||
+ | *'''Site Title''' - title of the website visible in WordPress. | ||
+ | Click on '' 'Import' '' to start the process. The instance should be migrated after the cron run. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_68_3.png]] | ||
+ | |} | ||
+ | |||
+ | ==Employing Instance Images== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|'''WordPress Manager For WHMCS allows you to prepare ready-made WordPress instance images for your clients to use during or after an order.'''<br/> | ||
+ | First, prepare instance images as described in the [[#Instance_Images|Instance Images]] section. Clients can also prepare their own instance images in the client area under '' 'Actions' '' → '' 'Instance Image'.''<br/> | ||
+ | Remember to include the images in the product settings for the desired product. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_69_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|After the instance images are prepared, clients with active services will be able to set up their WordPress installation from the included images in their client area.<br/> | ||
+ | They can do that by clicking on the '' 'Use Instance Image' '' button. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_69_2.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|A new window will be displayed, fill in the necessary fields and click on '' 'Create' '' to set up the instance. | ||
+ | *'''Product/Service''' - the hosting to be used for the instance. | ||
+ | *'''Instance Image''' - the instance image to be used as the template for the instance. | ||
+ | *'''Protocol''' - the protocol to be used for the instance. | ||
+ | *'''Domain''' - destination domain to which the instance will be migrated. | ||
+ | *'''Directory''' - directory under the domain where the script will be set to, the root directory will be used if left empty. | ||
+ | *'''Database''' - database name for the script. | ||
+ | *'''WordPress Username''' - a new username that will be created for a fresh WordPress setup. | ||
+ | *'''WordPress Password''' - a password for the administrative account that will be created, you can use the function button to generate a random password. | ||
+ | *'''Site Title''' - title of the website visible in WordPress. | ||
+ | Click on 'Create' to start the process. The instance should be created after the cron run. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_69_3.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|The option to set up an instance from an image can also be selected from the order form if set beforehand.<br/> | ||
+ | Three conditions need to be met for the instance images to be used during the order.<br/> | ||
+ | 1. In the module addon, the given product settings need to include at least one item in the '' 'Instance Images' '' field.<br/> | ||
+ | 2. The '' 'Auto Install WordPress After Service Creation' '' field has to be set to '' 'Based on Instance Image'.''<br/> | ||
+ | 3. In WHMCS → Product/Service configuration → Custom Fields: the '' 'wp_instance_image_id' '' custom field has to be present.<br/>The select options should include the IDs of the instance images that can be found in the '' 'Instance Images' '' tab of the addon. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_69_4.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|If all conditions are met, clients will be able to order instances to be set up from a range of images. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_69_5.png]] | ||
+ | |} | ||
+ | |||
+ | ==Introducing Custom Software== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 15px 15px;"|'''With WordPress Manager For WHMCS you can introduce your clients to custom plugins and themes.'''<br/>This can be handy if you do not want to make your software public on the Marketplace, but still need to distribute it to your clients in a seamless way.<br/> | ||
+ | We will install a custom plugin in the example, but the process also looks the same for custom themes.<br/>Once you have your software ready, open the module addon, and navigate to '' 'Plugins' '' → '' 'Custom Plugins' '' (or '' 'Themes' '' → '' 'Custom Themes' '') to begin.<br/> | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_70_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|Prepare a name and description of the module for your clients, include the URL to the plugin, and designate its version. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_70_2.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|Make sure your custom plugin is enabled. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_70_3.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|Next, move to '' 'Product Settings' '' and edit the product that you want to include the plugin for.<br/> | ||
+ | Under the '' 'General' '' tab find the '' 'Custom Plugins' '' (or '' 'Custom Themes' '') field and select your plugin.<br/> | ||
+ | Be sure to save the change. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_70_4.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|From now on, your clients will be able to find the custom plugin you have included in their client area.<br/> | ||
+ | All they have to do to install it is to click on the '' '+' '' icon. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_70_5.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|The plugin should be visible on the '' 'Installed' '' list and can be activated or deactivated any time. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_70_6.png]] | ||
|} | |} | ||
Line 861: | Line 1,840: | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px 5px 15px;"|2. If you wish to change the names of your WordPress | + | |style="padding: 0px 0px 5px 15px;"|2. If you wish to change the names of your WordPress installation scripts to be more friendly in the client area, you can do this in a [https://www.docs.modulesgarden.com/General#How_To_Change_WHMCS_Module_Language language file].<br/>Simply open your default '' 'english.php'' ' file located in '' '/yourWHMCS/modules/addons/WordpressManager/langs' '' directory and add a new language record in the following format: |
$_LANG['WordPress Script Name']="WordPress Friendly Name"; | $_LANG['WordPress Script Name']="WordPress Friendly Name"; | ||
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 5px 15px;"|3. When using the WordPress Manager module with cPanel, you will also need to whitelist '' 'phar' '' support in your ''php.ini'' on the WHM server.<br/> You can do this by adding or editing the below record: |
suhosin.executor.include.whitelist = phar | suhosin.executor.include.whitelist = phar | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 5px 15px;"|4. It is possible to set language for WordPress auto-installation. In the Product Custom Fields section you should complete: | ||
+ | *Field Name - '''wpmanager_language|Language''' | ||
+ | *Field Type - choose '' 'Drop Down' '' | ||
+ | *Select Options -decide which languages should be available to choose from the dropdown menu.<br/> If your language is not on the following list (but is supported by WordPress) then use the same formula by providing the two-letter country code as shown below: | ||
+ | <pre>en|English,ar|Arabic,zh_CN|Chinese,fr_FR|French,de_DE|German,el|Greek,it_IT|Italian,ja|Japanese,ko_KR|Korean,pl_PL|Polish,ru_RU|Russian, | ||
+ | sl_SI|Slovenian,sk_SK|Slovak,es_ES|Spanish,tr_TR|Turkish,uk|Ukrainian,vi|Vietnamese </pre> | ||
+ | *Do not forget to mark the '' 'Show on Order Form' '' option. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|5. '''Custom Fields''' used in the instance creation process:<br/> | ||
+ | You can set a username and password for the administrator panel in WordPress and the Site Title of the installation using the following product custom fields. <br/> Remember that this method works only when the '' 'Auto Install WordPress After Service Creation' '' option is set to '' 'Based on Installation Script'.'' List of supported custom fields: | ||
+ | *<code>wp_installation_type|Installation Type </code> | ||
+ | For '''WordPress Quick Installation:''' | ||
+ | *<code>wp_username|Username</code> or <code>wp_user_id| User ID</code> | ||
+ | *<code>wp_password|Password </code> or <code> wp_user_password|Password</code> | ||
+ | *<code> wp_site_title|Site Title</code> | ||
+ | <br/> | ||
+ | For WordPress Installation '''Based On Instance Image''': | ||
+ | *<code> wp_instance_image_id|Instance Image ID</code> | ||
+ | *<code> wp_username|Username </code> or <code> wp_user_id| User ID</code> | ||
+ | *<code> wp_password|Password </code> or <code> wp_user_password|Password </code> | ||
+ | <br/> | ||
+ | For WordPress Installation '''Based On Username/Password''': | ||
+ | *<code> wp_url|URL</code> | ||
+ | *<code> wp_username|Username </code> or <code> wp_user_id| User ID</code> | ||
+ | *<code> wp_password|Password </code> or <code> wp_user_password|Password </code> | ||
+ | <br/> | ||
+ | |||
+ | If a client completes the username and password, then the account will be created on the basis of the provided data. <br/> If left empty, then '' 'admin' '' will be set as '' 'Username' '', and a new password will be automatically generated. <br/> Do not forget to mark the '' 'Show on Order Form' '' option. | ||
+ | |} | ||
+ | ==Language Overrides== | ||
+ | {| | ||
+ | |style="padding: 10px 0px 30px 15px;"|'''Incorporating language customizations - the module readily accommodates language overrides, allowing you to tailor the language files to your preferences.'''<br/> The language file english.php remains unencoded and can be modified to suit your needs. However, it's recommended to avoid altering the core file itself, and instead, leverage the capability of using overrides.<br/> | ||
+ | |||
+ | Here's how to apply language overrides: | ||
+ | * Navigate to the ''~/langs/'' directory located within the following ''yourWHMCS/modules/servers/moduleName/langs/'' path. | ||
+ | * Within this directory, create a new file or duplicate the language file you intend to modify. For instance, if you wish to create an override for the English language, establish the following directory structure: | ||
+ | ''~/langs/overrides/english.php''. | ||
+ | * Open the newly created override file to edit its contents. | ||
+ | * At the beginning of the file, indicate the used code, for instance, you can use: '''<?php''' for PHP code. | ||
+ | * Adapt the file content according to your requirements. You can either selectively modify specific variables or opt to revise the entire content of the language file. | ||
+ | |||
+ | For example: | ||
+ | |||
+ | '''Original yourWHMCS/modules/servers/moduleName/langs/english.php:''' | ||
+ | |||
+ | $_LANG['Search'] = 'Search'; | ||
+ | |||
+ | '''Override yourWHMCS/modules/servers/moduleName/langs/overrides/english.php:''' | ||
+ | |||
+ | $_LANG['Search'] = 'Look for'; | ||
+ | |||
+ | By following these steps, you can seamlessly implement language customizations without altering the core language file, ensuring your changes will not be lost after every module update.<br/> | ||
+ | |||
+ | Remember that some of the modules have more than one language file, located under ''/addons'' and ''/servers'' paths. You may create the override files for both of them.<br/> Note that you do not need to paste all the original content of the lang file into the override file. Enter there only the lines that you wish to change, every other line will be fetched from the original module lang file.<br/> Consequently, the override lang file might include only one or just a few lines. | ||
+ | |} | ||
+ | ==Test Installation (up to version 1.7.1)== | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"| | ||
+ | If you are still using WordPress Manager For WHMCS up to version 1.7.1, a test installation is required.<br/> | ||
+ | Follow the instructions below to prepare a test installation. | ||
+ | |||
+ | |||
+ | '''To fully take advantage of what the module offers, it is necessary to set up the '' 'Test Installation' '' first before you start completing the rest of module configuration.''' <br/> | ||
+ | In order to make the module start using WordPress API requests, it is required to have at least one WordPress instance installed. <br/> Otherwise, the features like searching '' 'Plugins' '' or '' 'Themes' '' in the admin area will not work. Thanks to the '' 'Test Installation' '' option, the module will use the WordPress instance as a gateway to WordPress API to make such requests possible. <br/> If you already have such WordPress instances in your system, you can skip this step and go back to the [[#Product Settings|Product Settings]] section where you can choose the existing instance from your system. <br/> If you do not have any instance you need to either install it on your own directly from the '' 'Softaculous' '' auto-installer (and then choose it from [[#Product Settings|Product Settings]]) or you need to install it by using the module itself as presented below. | ||
+ | |||
+ | '''Note: The below steps should be possible if you have already made the basic [[#Product Settings|Product Settings]] configuration. ''' <br/> | ||
+ | |||
+ | So, to start, proceed to the '' 'WordPress Management' '' section of the product in the [[#Client Area|Client Area]] on any of your test accounts. Next, click on the '' 'New Installation' '' button.<br/> | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_8_1.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|There are two sections to complete. Firstly, provide the details of your installation. <br/> Remember to enter your domain properly. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_8_2.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"| Now, go to the '' 'Other' '' section of your installation and fill in the details. You may also decide which options should be enabled for your installation. <br/> Remember to click '' 'Create' '' and wait until the '' 'New Installation' '' is ready. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM2_8_3.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"| Finally, you can come back to '' 'WordPress Manager'.'' Go to '' 'Product Settings' '' and click on the '' 'Edit' '' icon next to the preferred product. <br/> You will find the '' 'Test Installation' '' option here. <br/> As presented below, start typing your domain name that was provided in the previous step of creating '' 'New Installation' ''. <br/> Choose your '' 'Test Installation' '' and save changes. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 25px;"|[[File:WM2_8_4.png]] | ||
|} | |} | ||
=Update Instructions= | =Update Instructions= | ||
{| | {| | ||
− | |style="padding: 10px 0px 30px 15px;"| | + | |style="padding: 10px 0px 30px 15px;"| An essential guidance through the process of updating the module is offered '''[https://www.docs.modulesgarden.com/How_To_Update_WHMCS_Module here]'''.<br/><br/> |
− | '''Important:''' If you are performing an update from a previous version of WordPress Manager with cPanel, you have to also update the files and run again the installation script on your WHM server.<br/>Simply go [https://www.docs.modulesgarden.com/WordPress_Manager_For_WHMCS#cPanel_.28WHM.29_Installation here] and repeat the following instructions. | + | '''Important:''' If you are performing an update from a previous version of WordPress Manager with cPanel, you have to also update the files and run again the installation script on your WHM server.<br/>Simply go [https://www.docs.modulesgarden.com/WordPress_Manager_For_WHMCS#cPanel_.28WHM.29_Installation here] and repeat the following instructions. <br/> |
− | <br/><br/> | + | If you are updating WordPress Manager For WHMCS, '''it is highly recommended''' to perform an update of the plugins that are used. |
− | + | |} | |
− | + | ==Updating the Module to Version 3.x== | |
+ | {| | ||
+ | |style="padding: 10px 0px 30px 15px;"|Before updating to module version 3.x, ensure that '''there are no pending tasks in the queue''' to avoid migration issues.<br/> | ||
+ | Follow the steps to ensure a smooth transition to version 3.x of the module: | ||
+ | * '''Complete all tasks''' currently in the queue before initiating the update. This step is crucial to prevent the loss of unexecuted tasks. | ||
+ | * Please note that after the update, '''the queue database tables will be reset'''. Any tasks that were not executed may be lost, leading to an incomplete update. | ||
+ | <!-- * Be aware that the '''logs will also be cleared''' during the update process.--> | ||
+ | |} | ||
+ | |||
+ | =Upgrade Guide= | ||
+ | {| | ||
+ | |style="padding: 10px 0px 30px 15px;"|Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability?<br/> There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment.<br/> | ||
+ | |||
+ | Opt for the [https://www.modulesgarden.com/products/whmcs/wordpress-manager#open-source-version Open Source version] of your WordPress Manager For WHMCS module to unlock these benefits.<br/> Simply click on either the '''Get Source Code''' or '''Upgrade To Lifetime''' button found on the product's page in our client area to complete the one-step upgrade process, with a '''dedicated discount''' already applied.<br/> | ||
+ | |||
+ | Follow a [https://www.docs.modulesgarden.com/How_To_Upgrade_WHMCS_Module comprehensive guide] covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized. | ||
|} | |} | ||
=Common Problems= | =Common Problems= | ||
{| | {| | ||
− | |style="padding: 10px 0px | + | |style="padding: 10px 0px 10px 15px;"|'''1. When you have problems with connection, check whether your SELinux or firewall does not block ports.''' |
|} | |} | ||
{| | {| | ||
− | |style="padding: 0px 0px | + | |style="padding: 0px 0px 5px 15px;"|2. If you do not see the [https://www.docs.modulesgarden.com/WordPress_Manager_For_WHMCS#Config config] records, make sure that you have also [https://www.docs.modulesgarden.com/WordPress_Manager_For_WHMCS#Update_Instructions updated] the WHM files to the latest version. |
|} | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 10px 15px;"|3. Installation of ''[https://letsencrypt.org/ Let's Encrypt]'' SSL is available only for DirectAdmin products. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 5px 15px;"|4. Native integration with [https://www.docs.modulesgarden.com/CPanel_Extended_For_WHMCS#WordPress_Manager cPanel Extended] module works seamlessly except for one aspect, specifically access via '' 'Manage Account → WordPress Manager','' where an issue is encountered.<br/> You may smoothly enter the WordPress Manager via: '' 'Actions → WordPress Management'.'' | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 15px 15px;"|5. The module supports two APIs: Softaculus and WP Toolkit.<br/> | ||
+ | If you are changing the API '''from WP Toolkit to Softaculous''', when there are already existing installations, you must remember to synchronize the instances.<br/> Otherwise, errors will occur when trying to manage the instance from the WHMCS client area. <br/> | ||
+ | |||
+ | '''Solution:''' Proceed to cPanel → Softaculous and press the ''"Scan"'' button. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM_66_2.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|When changing the API '''from Softaculous to WP Toolkit''', trigger the scanning in cPanel → WP Toolkit: | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 25px;"|[[File:WM_66_3.png]] | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 20px 15px;"|After the scan is successfully complete, wait until the data is synchronized in the module by running the following cron command: | ||
+ | |||
+ | php -q /yourWHMCS/modules/addons/WordpressManager/cron/cron.php Synchronize | ||
+ | |||
+ | That is all, the installations can now be managed via target API. | ||
+ | |} | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 15px;"|6. If you experience issues with the proper functionality of a Plesk-based module, one potential cause might be difficulties in retrieving the accurate external WHMCS IP address.<br/> | ||
+ | To eliminate this as a factor, we recommend configuring the variable '''ipServerWhmcs''' with a specific IP address in the configuration file located at: '''''app/config/configuration.yml'''''. <br/>The assigned IP address will overwrite the WHMCS-provided IP address: | ||
+ | |||
+ | ipServerWhmcs: '123.456.78.910' | ||
+ | |} | ||
+ | |||
+ | |||
+ | <!-- Na razie tego niet | ||
+ | {| | ||
+ | |style="padding: 0px 0px 30px 15px;"|5. The current version of the module does not support authentication with Plesk using '' 'API Key' ('Access Hash')''.<br/> | ||
+ | If you want to connect your WHMCS with Plesk API we recommended to use '' 'Username' '' and '' 'Password' ''as authentication method in the configuration of WHMCS server. | ||
+ | |} | ||
+ | --> |
Latest revision as of 11:31, 21 October 2024
Are you planning to update your WordPress Manager For WHMCS module to version 3.x?
Follow the instructions here for a smooth update.
Contents
|
[edit] About WordPress Manager For WHMCS
WordPress Manager For WHMCS is a module that enables your customers to control and freely alter their WordPress instances right inside your WHMCS. Your clients will be able to add WordPress installations using instance images and custom scripts, perform WordPress updates, install themes and plugins, create staging instances and then push them live. |
- Admin Area:
✔ View Active WordPress Installations, Clients And Products Summary |
✔ View WordPress Installations List |
✔ Choose Supported Products: |
✔ Select API To Use: |
✔ Softaculous Auto Installer |
✔ WP Toolkit |
✔ Select Available Installation Scripts |
✔ Select Available Plugin Packages |
✔ Select Available Instance Images |
✔ Automatically Install: |
✔ WordPress After Service Creation: |
✔ Based On Installation Script |
✔ Based On Instance Image |
✔ Plugin Packages |
✔ Theme Packages |
✔ Toggle Blocked Plugins And Themes |
✔ Toggle Automatic Deletion Of Blocked Plugins And Themes |
✔ Set Scan Interval For Blacklists Cleaner |
✔ Define Default Theme To Be Enabled After Installation |
✔ Choose Custom Plugins And Themes Available To Clients |
✔ Choose Instance Images Available To Clients |
✔ Toggle Permission To Delete WordPress Auto-Installation |
✔ Define Protocol For WordPress Auto-Installation |
✔ Select Welcome Email Template |
✔ Define Installation Limit Per Hosting Account |
✔ Define Update WordPress Notification Mail Interval |
✔ Select Update WordPress Email Template |
✔ Toggle Debug Logs |
✔ Add/Remove Selected Plugins From Blacklist: |
✔ Prevent Blacklisted Plugins From Being Installed By Clients |
✔ Remove Blacklisted Plugins From Current Installations |
✔ Add/Remove Selected Themes From Blacklist: |
✔ Prevent Blacklisted Themes From Being Installed By Clients |
✔ Remove Blacklisted Themes From Current Installations |
✔ Define Client Area Features: |
✔ Management Options |
✔ Action Options |
✔ Plugins: |
✔ Create Plugin Packages: |
✔ Enter Package Name And Description |
✔ Choose Available Plugins |
✔ Add Custom Plugins |
✔ Themes: |
✔ Create Theme Packages: |
✔ Enter Package Name And Description |
✔ Choose Available Themes |
✔ Add Custom Themes |
✔ Create Instance Images: |
✔ From Local Or External Installation Source |
✔ Public Or Private |
✔ Access Module Tasks List And Logs |
✔ Provide Google API Token For PageSpeed Insights |
✔ Define Allowed Protocols For WordPress Instances To Be Used In Client Area |
✔ Enable Extended View Of Instances List |
✔ Enable And Customize WHMCS Client Home Page Widget |
✔ Customize Module Language Files With "Translations" Tool |
✔ Control Staff Access Level To Specific Resources With ACL |
✔ View And Manage Logs |
- Client Area:
✔ View/Create/Edit/Delete WordPress Installations |
✔ Using Simple List Of Instances |
✔ Using Extended View With Instances Preview Screenshots |
✔ View/Create/Edit/Delete WordPress Installations On Your Resellers Accounts: |
✔ cPanel |
✔ DirectAdmin |
✔ View List Of Recent WordPress Instances On WHMCS Client Home Page |
✔ Update Selected WordPress Installations To Newest Version In One Batch |
✔ Import WordPress Installation From Remote Server: |
✔ FTP Based Import |
✔ Username/Password Based Import |
✔ Create WordPress Installation Based On Instance Image |
✔ Log In To Admin Panel Of WordPress Instances |
✔ Receive Email Notifications And Get Visual Alerts When WordPress Update Is Available |
✔ View Installation Details: |
✔ Domain And URL |
✔ Product On Which Is Installed |
✔ WordPress Version |
✔ Site Name |
✔ Creation Date |
✔ Directory Path |
✔ Database Access Details |
✔ Debug Status |
✔ Instance Status |
✔ SSL Certificate Expiration Date |
✔ View Website Details Based On Google "PageSpeed Insights": |
✔ Desktop And Mobile Screengrab Thumbnails Of Website |
✔ General Performance Information |
✔ Page Statistics |
✔ Opportunities |
✔ Audit Passed Successfully |
✔ Diagnostics |
✔ Manage Installation: |
✔ Create/Restore/Download/Delete WordPress Backups |
✔ Browse/Install/Manage Themes |
✔ Search And Install Themes Directly From WordPress.com Base |
✔ Preview Theme Before Installation |
✔ Activate/Deactivate Installed Themes |
✔ Update Installed Themes |
✔ Browse, Install And Manage Plugins |
✔ Search And Install Plugins Directly From WordPress.com Base |
✔ Activate/Deactivate Installed Plugins |
✔ Update Installed Plugins |
✔ Browse And Install Plugin Packages |
✔ Perform Bulk Changes On Themes, Plugins, And Backups |
✔ View/Create/Edit/Delete WP Config Records |
✔ View/Create/Edit/Delete WordPress User Accounts With Specified Privileges |
✔ Perform Actions: |
✔ Log In To Control Panel |
✔ Access Credentials Setup |
✔ Clear Cache |
✔ Clone To New Domain |
✔ Update To Newest Version |
✔ Change Domain |
✔ Toggle Auto Upgrade Of: |
✔ WordPress Installation |
✔ WordPress Plugins |
✔ WordPress Themes |
✔ Create Staging |
✔ Push Staging To Live Environment |
✔ Enable/Disable SSL |
✔ Enable/Disable Debug Mode |
✔ Enable/Disable Maintenance Mode |
✔ Create Instance Image |
✔ Delete |
✔ Single Sign-On Into WordPress Panel From Product View |
- Supported Modules:
✔ cPanel (Root Access Required) |
✔ cPanel Extended - With Complete Integration |
✔ DirectAdmin (Admin Account Required) |
✔ DirectAdmin Extended |
✔ Plesk (Root Access Required) |
✔ Plesk Extended |
- Supported Integrations:
✔ Softaculous Auto Installer - Premium (cPanel, Plesk, DirectAdmin) |
✔ WP Toolkit (cPanel, Plesk) - View Wiki To See Differences In Support |
- General Info:
✔ Automatic Let's Encrypt SSL Installation (DirectAdmin Only) |
✔ Fully Integrated With Lagom WHMCS Client Theme |
✔ Multi-Language Support With Custom Translations Tool |
✔ Supports PHP 8.2 Back To PHP 7.4 |
✔ Supports WHMCS Themes "Six" And "Twenty-One" |
✔ Supports WHMCS V8.11 Back To WHMCS V8.8 |
✔ Requires ionCube Loader V13 Or Later |
✔ Easy Module Upgrade To Open Source Version |
[edit] Installation and Configuration
In this short tutorial we will show you how to successfully install WordPress Manager For WHMCS. We will guide you step by step through the whole installation process. |
1. Log in to our client area and download the module. |
2. Extract the package and upload its content into the main WHMCS directory. The content of the package to upload should look like this. |
[edit] cPanel (WHM) Installation
Important: Root access is required to perform the installation successfully! |
1. Upload and extract the 'UploadToWHM' folder into the /root cPanel directory. Files in your cPanel /root/uploadToWHM/ directory should look like these on the following screen. |
2. Once the module is uploaded, enter the /root/uploadToWHM/ catalog and run the following command in the console:sh install.sh After a brief moment you should see a confirmation that the plugin has been successfully installed. |
[edit] DirectAdmin Installation
Important: Admin account is required to perform the installation successfully! |
1. In the 'uploadToDirectAdmin' folder find the 'wordpress_cli.tar.gz' package. Next, log in to your DirectAdmin panel as an administrator and go to 'Plugin Manager' . |
2. Once in the 'Add Plugin' , select the 'File' option and choose the 'wordpress_cli.tar.gz' package to upload. Additionally, mark the 'Install after upload' option and press the 'Add Plugin' button. |
3. Once the plugin is uploaded and successfully installed, you should see it on the plugins list. |
[edit] Plesk Installation
Note: The current version of the module requires your Plesk server configured in WHMCS to use username and password as authentication to the Plesk API. We also recommended using Plesk version 17.8.11 at least. |
Important: Root access is required to perform the installation successfully! |
1. In the 'uploadToPlesk' folder find the 'wordpress-manager-cli-X.X-X.zip' package. Next, log in to your Plesk panel as an administrator and go to the 'Extensions' section. |
2. Once you are in the 'Extensions' section, go to the 'My Extensions' tab and select the 'Upload Extension' option. In the opened window choose the 'wordpress-manager-cli-X.X-X.zip' package to upload and press the 'OK' button. Important: If for some reason the 'Upload Extension' button is disabled, you will need to install the free panel.ini editor extension. |
3. Once the plugin is uploaded and successfully installed, you will see it on the plugins' list. |
[edit] WHMCS Installation
1. Extract the 'modules' catalog into the main WHMCS directory. |
2. When you install WordPress Manager For WHMCS for the first time, you have to rename the 'license_RENAME.php' file. This file is located in 'modules/addons/wordpress_manager/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'. |
3. In order to configure your license key, you have to edit the previously renamed 'license.php' file. Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'. |
4. In the next step, set up the 'storage' folder as recursively writable. This folder is available at 'your_whmcs/modules/addons/WordpressManager/'. |
5. Now you have to activate the module in your WHMCS system. Log in to your WHMCS admin area. Click 'System Settings' , then choose 'Addon Modules'. |
6. Then, you need to permit access to this module. To do so, click on the 'Configure' button, choose 'Full Administrator' and press 'Save Changes'. |
7. Now you have to add cron jobs as shown below:
php -q /your_whmcs/modules/addons/WordpressManager/cron/cron.php Synchronize
php -q /your_whmcs/modules/addons/WordpressManager/cron/cron.php queue Do not forget to replace 'your_whmcs' with your WHMCS root location. |
8. Good job! You have just successfully installed WordPress Manager For WHMCS! Now, in your WHMCS, press 'Addons' and then 'WordPress Manager'. |
[edit] Management
This section has been divided into two main parts to allow full and, at the same time, easy understanding of the functionality of the whole module. In the first part 'Management of Addon' you will see a general outlook of the module's basic configuration, through the product management from the admin area. The second part describes additional settings and tools concerning WordPress installations that can be used while working in the client area. |
[edit] Admin Area
Now that your module is already configured, you may access it at 'Addons' → 'WordPress Manager'. |
[edit] Home
The 'Home' section is the first open when entering the addon. You will see here a quick summary of the WordPress connected elements and a list of all active WordPress installations with any details on their installation. |
[edit] Product Settings
In the 'Product Settings' section you can see the list of compatible products present in your system that WordPress can be configured with. Activate the products and press the 'Edit' icon marked on the screen below. |
[edit] General
In the 'General' section you will need to set up some specific options concerning the plugins installation. Take a look at the below notes to learn about all of the possibilities.
Keep in mind that if an instance is imported (for example when using "Based On Instance Image" automatic installation), it will overwrite the Auto Install Plugin/Theme Packages feature. |
Note: By default, installation script names in the client area will be displayed without their IDs. If you still want to change their names to be more client-friendly, you can do it in a language file. Go to the Tips section and look for more details in the second point. |
[edit] Plugins Blacklist
This section of the Product Settings includes a list of blocked plugins - those which your clients are not allowed to install. In order to add a plugin to the list simply start typing its name in the search field and press enter to see the results. |
Add the selected plugin to the blacklist. It will no longer be available for clients to install if the "Blocked Plugins" option has been enabled in the General section. |
[edit] Themes Blacklist
This section of the Product Settings includes a list of blocked themes - those that your clients will not be able to install. |
If you want to add a theme to the list, simply start typing its name in the search field and press enter to see the results. Add the selected themes to the blacklist. |
Your clients will not be able to install the previously added themes if the "Blocked Themes" option has been enabled in the General section. If you decide to remove the preferred themes from the 'Blocked' section, you may easily do this by clicking the appropriate button. |
[edit] Client Area Features
In this section, you can define which options should be enabled for clients. To make it easier, the available options are divided into two parts, the 'Management Options' and 'Action Options' . |
[edit] Plugins
In the 'Plugins' section you may prepare ready-made packages selected by your plugins or prepare custom plugins and then offer them to install to your clients. In this quick and convenient way, your clients will be given an offer with perfectly adjusted and suitable plugins to shorten the time of searching and verification. |
In the 'General' part, enter the package name and describe the package in short. Save the changes and then move to the 'Plugins' tab. In this part you will also need to enable the package once it is prepared. |
Add plugins by searching through the existing ones, start typing the plugin name, press enter and the results will appear. Add a single plugin or use the mass action button to add plugins in bulk. |
Added plugins will appear on the list of included immediately. You may always delete any unwanted plugins when editing the package by pressing the bin icon. |
Once you have the packages ready, move again to the General configuration of a product and select which of the packages will be available to choose from by clients or be automatically preinstalled for a single product. Surely, you may assign a different set of packages to each product. |
There is also the possibility to add 'Custom Plugins' . Press the following button to do so. |
Now, provide a name and description of your 'Custom Plugin' . Then, complete the 'URL' and finally define a version. |
If you wish to modify your 'Custom Plugins' , you can easily do this by pressing the 'Edit' button. |
[edit] Themes
In the 'Themes' section you may prepare ready-made packages selected by you themes or create your 'Custom Themes' and automatically install them along with the WordPress instance. In this quick and convenient way, your clients will have quick access to preinstalled themes on their WordPress without the need of searching them on their own. |
In the 'General' part, enter the package name and describe the package in short. Save the changes and then move to the 'Themes' tab. In this part you will also need to enable the package once it is prepared. |
Add themes by searching through the existing ones, start typing the theme name, press enter and the results will appear. Add a single theme or use the mass action button to add themes in bulk. |
Added themes will appear on the list of included immediately. You may always delete any unwanted themes when editing the package by pressing the bin icon. |
Once you have the packages ready, move again to the General configuration of a product and select which of the packages will be installed automatically for a single product. Surely, you may assign a different set of packages to each product. |
There is also the possibility to add 'Custom Themes' . Press the following button to do so. |
Now, provide a name and description of your 'Custom Theme' . Then, complete the 'URL' and finally define a version. |
If you wish to modify your 'Custom Themes' , you can easily do this by pressing the 'Edit' button. |
[edit] Instance Images
This section is dedicated to WordPress images that are used to allow clients to add WordPress installations using these very images of WordPress. To create such an image, simply press the 'Add Image' button and then follow the steps described below. |
In order to properly configure a new instance image you will need to set up the below options. Please be aware that to create such an instance image you will need to deliver full access data to a server with WordPress installations that will be used to create an image.
|
Once you have the images ready, move again to the General configuration of a product and select which of the images will be available for a single product. Surely, you may assign different sets of images to each product. |
[edit] Other
[edit] Logs
The module activities are recorded in the section named 'Logs'. You can filter the logs by clicking on the 'Show' icons. |
All entries can be deleted at any time, just click the button marked on the screen below. Keep in mind that you can remove multiple logs at once. |
[edit] Tasks
This section gives you the view on module tasks to enable SSL in two scenarios:
|
Press the 'Information' button to get a quick view on the basic information on the task and log details. |
Logs section will include information on errors only. If a task is completed successfully, no information will be included here. |
All tasks can be deleted separately. To do that, just click the button marked on the screen below. Keep in mind that you can remove multiple tasks at once. |
[edit] Settings
This section controls WHMCS-wide settings that you can configure to fit your client's needs.
|
|
[edit] Google API Token
In order to get your Google API token necessary for the Website Details section to work, open the following site: https://developers.google.com/speed/docs/insights/v5/get-started Scroll down to 'Acquiring and using an API key' section. There, press 'Get a Key' button: |
'Enable PageSpeed Insights API' modal will appear. Select your project or create a new one, and then press 'Next'. |
That's all! Your Google API key is ready, copy it and paste in the 'Google API Token' field in the WordPress For WHMCS module Settings as described in the above section. |
[edit] Translations
Customizing language files is now extremely easy with the "Translations" tool that is now available directly in the addon. Its user-friendly design makes managing various language file tweaks a smooth and efficient process. Prepare translations for the original English files with this handy built-in tool. For specific instructions on how to use this tool please refer to its dedicated article, you will find it here. |
[edit] Access Control
'Access Control' allows you to specify and control exactly which sections of the module can be accessed by your administrators. The way it works is that you create access control rules in which you decide if a specific admin, or admin role has full access, or is restricted to only specific sections. |
[edit] Rules
Start with creating a new rule, click on the 'Create Rule' button and a dedicated form will appear. Below you will find a description of every field required in the form. |
Fill out the following fields to create resources access rule:
Important: When picking specific sections, keep in mind that allowing a parent section will also allow all of its children. |
To edit or delete existing rules, use the icons to the right. |
[edit] Resources
Use the toggles in the 'Resources' section to specify which of them should be subject to logging, found in the 'Logs' section. Every time an administrator requests a toggled resource, it will be recorded. |
[edit] Access Control Logs
The logs section includes:
Use the trash bin icons to delete specific logs, or utilize the mass action function to delete multiple logs at once. |
[edit] Email Templates
By default, the module creates the 'New WordPress Information' email template You can find it in your WHMCS 'Setup' → 'Email Templates' section. This template can be used to send WordPress details to the customer when the automatic installation is enabled after the service creation. Additionally, you may use the merge fields variables, which will be replaced with the corresponding WordPress installation details when are sent to the customer:
|
[edit] Client Area
Now that you already have the module configured, you may see the process of adding and managing the WordPress installations by your clients. In the client area, find and choose your product with WordPress management support and then move directly to the relative section. |
[edit] WordPress Installations
Extended view, toggled by the admin in the module addon, read more here.
At the top of the page, you will find all WordPress installations located in dedicated segments. Every installation has its own section with screen grabs, installation details and instant access to action tools. |
The standard view of the WordPress Management page includes the very same information as the extended view, yet they are placed in a simple list form. Underneath the list, there is also a section dedicated to 'Reseller Accounts'. The former contains a list with basic information regarding every installation, including the domain, related product, URL, etc. |
Use action buttons marked on the screen to perform actions on a single installation:
Additional actions include:
|
Among additional actions you will find the options to:
|
You may also delete or update multiple WordPress instances to the newest version at once, use mass actions to do so (standard view only). |
If you wish, you may create a backup of the instances before processing the update. |
[edit] New Installations
As mentioned above, there are three ways to create a new WordPress Installation. The first basic way is to simply install a completely new and clean instance of WordPress. Press the button 'New Installation' marked on the screen below and read the instructions to see how to install a pure new instance. |
A new window with two tabs will open. In the first Details tab, fill in the following fields:
|
Complete the configuration by switching to the Other tab and enter the remaining fields (optional):
If you have entered all the data correctly, you can now press the 'Create' button to complete the installation. |
[edit] Import From Remote Server
The second way to add a new installation is by importing an existing installation from a remote FTP server. Press the additional actions button to find the redirection. |
First of all, fill out the data on the source server:
For FTP Based Import provide:
|
For Username/Password Based Import provide:
|
Then move to the other tab, to provide any data on the destination.
Press the 'Import' button to finalize the process. |
[edit] Instance Image
It is also possible to use an existing instance image. |
Provide the below enumerated and described details, then press 'Create' to complete:
Note: the process may take from a few up to a dozen or so minutes for the instance to appear on the list, depending on the instance size or complexity. |
[edit] Installation Management
Once you have successfully created a new installation, you can edit its advanced options or simply remove it in case you no longer need it. Let us view the management options and available actions now. Note: Please be aware that deleting installations "(3)" is not possible from this section for the WP Toolkit for Plesk API. To delete an instance, you need to log into the Plesk panel. |
[edit] Installation Details
On the very first page, when you enter the edit section, there is an exemplary configuration of your installation in the 'Management' section. You will find there all the basic information, such as domain and database details, available at hand. |
[edit] Website Details
Desktop and mobile website details based on Google "PageSpeed Insights" statistics. This section requires to previously generate and provide the 'Google API Token'. Follow this instructions to learn how to do that. |
[edit] Backups
As the name suggests, this section provides you with an ability to create backups. You are allowed to download, restore and delete a particular backup. |
Surely you can delete multiple backups at once. Take a look at the screenshot below. |
When creating a backup installation, decide whether to the backup directory only, the data directory, or the database. Select location and then confirm the action. Note: Keep in mind that creating a backup might take a longer while. Backup will appear on the list when it is ready. |
[edit] Themes
Here you are enabled to activate, disable, update, and delete the existing theme. Add new themes to your WordPress installation in the 'Add New' tab. |
In order to add a new theme, start typing in the desired theme's name in the search box, and press enter to see the actual results. You may press the theme thumbnail to preview the on wp-themes.com. Afterwards, press the icon marked on the screenshot below to continue. |
Confirm the installation. |
If there are any 'Custom Themes' accessible for adding, they will be located here. |
Use 'Mass Action' buttons to update or delete numerous themes with a single click. |
[edit] Plugins
Here you are enabled to activate, deactivate, delete or update the already existing plugins. You can also add new plugins to your WordPress installation in the 'Add New' tab. |
To add a new plugin, you are required to type in at least the initial letters of the desired plugin's name into the search field to see the actual results. Afterwards, press the symbol marked on the screenshot below, and confirm your choice in the window that should be visible on your screen. |
Press the info icon to read its short description. |
In case the plugin seems interesting, just press the 'Install' button. |
There is also an option to add your custom plugins, simply press the adequate icon and confirm the action. |
The 'Mass Action' feature is also present in this section, so you will be able to handle multiple plugins more efficiently and at the same time. |
[edit] Plugin Packages
Plugin Packages allow to install a bunch of pre-organized plugins at once. Information on how to prepare such packages can be found here. Simply press the '+' button to install the package with plugins that seems especially attractive to you. |
[edit] Config
In this section you can directly alter the records from the wp-config.php file. This file is located in the root of your WordPress file directory and contains your website's configuration details such as database connection information. You are allowed to edit or delete already existing config records as well as create new ones. Important: Be particularly careful when editing these config records! You can find more information about editing the 'wp-config.php' file here. |
When creating a new config record, enter its proper name, and value and choose one of the two available types ('Constant' or 'Variable'). |
[edit] Users
Enter this section to manage existing users and create new ones. You are allowed to perform the following actions on a single user:
|
When creating a new user, you will have to provide the following data to complete:
|
[edit] Available Actions
In the 'Actions' area you can find the following options to:
Important: Please refer to the WP Toolkit Integration section for the list of troublesome features and make sure they are supported by the API you are using. Underneath you can find a detailed description of all the remaining actions. Please take a look. |
[edit] Clone
This action will result in cloning the installation to another domain. To clone the installation you need to:
The cloned installation will appear on the list of installations after a while. |
[edit] Change Domain
If you want to change the domain of your WordPress installation, simply provide here a new one. Decide whether to create a backup at the same time and enable/disable SSL for the new domain. |
[edit] Manage Auto Upgrades
Set up the automatic upgrades rules. Here you may enable or disable automatic upgrades:
|
[edit] Staging
Create staging instances from an application to test the upgrades or changes before using them in the live environment. |
Please be patient, as the whole process may take a few minutes. The staging instance will appear on the list of your installations after the first cron synchronization. Push the staging installation to the live environment once you are sure it works fine and changes suit your needs. |
In case you need to customize the installation before pushing it live simply toggle the 'Customize' option. Then define the specification and confirm to finish. |
[edit] SSL
Turn on or off SSL for the installation. Remember that enabling SSL will result in changes being made in your WordPress database configuration, it is advised to back up your installation. Along with enabling SSL, a free Let's Encrypt SSL will be installed on DirectAdmin products (note that this feature is not available for 'cPanel'). |
[edit] Debug Mode
Check whether the debug mode is currently enabled or disabled. Change the mode by pressing the 'Change' button. |
[edit] Maintenance Mode
Check the current status of the website, turn off/on maintenance mode according to your needs by pressing the 'Change' button. |
[edit] Instance Image
Turn on instance image on the WordPress installation. Simply, toggle the 'Mark As Image' option and then fill in the below options. Note: The 'FTP Password' input is encoded in the database, which makes it completely safe and secure. |
[edit] Dashboard Widget
WordPress Manager For WHMCS comes with a built-in widget displayed in the client area home page.
This allows the client to see their installations at a glance. |
The widget visibility can be configured in the admin area. Navigate to 'Addons' → ' WordPress Manager' → 'Other' → 'Settings' and find the 'Widget Size' option.
|
[edit] Reseller Accounts
Existing Reseller's Accounts with the number of WordPress installations. Keep in mind that this section is visible only when such accounts exist in the client's cPanel or DirectAdmin panels. In case no such accounts have been detected, this section is hidden. Note: Plesk resellers accounts are not yet currently supported. The table includes the name of the product, reseller's account name on which the instances are installed as well as their number. |
Press the edit icon to view the list of existing installations. Among other allowed actions there are:
|
The only difference is the need to select a customer when adding a new installation. If there is no username available here to choose, the reseller must create an extra account in the cPanel or DirectAdmin panels. All the remaining options are the same as in the case of standard WordPress installations described in the above sections. |
Using mass actions you may also update multiple WordPress instances to the newest version at once or delete them. |
[edit] WP Toolkit Integration
As an alternative to the Softaculous auto-installer, you have the option to benefit from the WP Toolkit integration available for cPanel/WHM or Plesk. Please note that if you are using the free version of WP Toolkit, certain features may not be accessible or fully functional within the WordPress Manager module. |
Important! By default, all three APIs support all features enumerated on the product features list, available at the top of this documentation. |
List of troublesome features with API compatibility status: |
Feature Name | Softaculous | WP Toolkit for Plesk | WP Toolkit for cPanel/WHM | |
---|---|---|---|---|
1. | Clone an instance | ✔️ | ✔️ | ❌ |
2. | Delete an instance | ✔️ | ❌ | ✔️ |
3. | Download backups | ✔️ | ❌ | ✔️ |
4. | Push staging to live environment | ✔️ | ❌ | ❌ |
5. | Create staging | ✔️ | ❌ | ❌ |
6. | Use instance image | ✔️ | ❌ | ❌ |
7. | Access setup section (Installation Details → Actions → Setup) |
❌ | ✔️ | ✔️ |
Depending on your API selection, be sure to customize the Client Area Features in your product configuration. This ensures that your clients have access only to the supported functionalities while disabling any unsupported ones. |
[edit] Use Cases
In this section, you will find real-life examples of using the module. We'll show you how the module's features can be put to work in different situations. See the scenarios below to see how the module can be used in practice. |
[edit] Automatic WordPress Installation
Products in WordPress Manager For WHMCS can be set up to install new WordPress instances after service creation automatically. There are two basic methods for that purpose:
Navigate to 'Addons' → 'WordPress Manager' → 'Product Settings' → your product 'Details' page. For script-based installation: in the 'Auto Install WordPress After Service Creation' field, select the 'Based On Installation Script' option and pick a script from the dropdown field below. |
For image-based installation: in the 'Auto Install WordPress After Service Creation' field, select the 'Based On Instance Image' option and pick an image from the dropdown field below. Note: If you do not have any instance image created yet, you can learn how to do that in the Instance Images section. |
Once the client orders the configured product, WordPress will be automatically installed according to the selected method. Furthermore, you may include custom fields that will allow users to set their own WordPress username, password, and site title. wp_username|Username or wp_user_id| User ID wp_password|Password or wp_user_password|Password wp_site_title|Site Title See tips (point 5) for more information on custom fields. |
If the custom fields are left empty, the credentials will be generated automatically for the client. |
[edit] Instance Import During Order
While ordering products with WordPress Manager For WHMCS clients can migrate their WordPress installations seamlessly. To take advantage of this option you need to include import-related custom fields in the order form of your product. Navigate to 'System Settings' → 'Products/Services', edit your product, move to the 'Custom Fields' tab, and include the following custom fields.
You can change the display name of the field after the '|' sign. |
Clients will be able to fill those fields during the order with their WordPress credentials, enabling the module to migrate their WordPress after the order is accepted (during the cron job run). Additionally, you may combine import-related custom fields with other custom fields found in point 5 of the Tips section. |
[edit] Migrating Existing Instances Via FTP
WordPress instances located on other servers can easily be migrated to your server through FTP. All it takes is a few simple steps. First, open the WordPress Manager in the client area and select 'Import From Remote Server'. |
Select the FTP Based Import Type and provide the information necessary for the import:
|
Move to the 'Destination' tab and fill in the desired details of the migrated instance:
Click on 'Import' to start the process. The instance should be migrated after the cron run. |
[edit] Migrating Existing Instances Using WordPress Credentials
WordPress instances from third-party servers can also be migrated with just the WordPress account credentials. See the steps described below to see how easy it is. Start by opening the WordPress Manager in the client area and select 'Import From Remote Server'. |
Select the Username/Password Based Import Type and provide your WordPress credentials:
|
Next, open the 'Destination' tab and provide details regarding your desired installation after migration:
Click on 'Import' to start the process. The instance should be migrated after the cron run. |
[edit] Employing Instance Images
WordPress Manager For WHMCS allows you to prepare ready-made WordPress instance images for your clients to use during or after an order. First, prepare instance images as described in the Instance Images section. Clients can also prepare their own instance images in the client area under 'Actions' → 'Instance Image'. |
After the instance images are prepared, clients with active services will be able to set up their WordPress installation from the included images in their client area. They can do that by clicking on the 'Use Instance Image' button. |
A new window will be displayed, fill in the necessary fields and click on 'Create' to set up the instance.
Click on 'Create' to start the process. The instance should be created after the cron run. |
The option to set up an instance from an image can also be selected from the order form if set beforehand. Three conditions need to be met for the instance images to be used during the order. |
If all conditions are met, clients will be able to order instances to be set up from a range of images. |
[edit] Introducing Custom Software
With WordPress Manager For WHMCS you can introduce your clients to custom plugins and themes. This can be handy if you do not want to make your software public on the Marketplace, but still need to distribute it to your clients in a seamless way. We will install a custom plugin in the example, but the process also looks the same for custom themes. |
Prepare a name and description of the module for your clients, include the URL to the plugin, and designate its version. |
Make sure your custom plugin is enabled. |
Next, move to 'Product Settings' and edit the product that you want to include the plugin for. Under the 'General' tab find the 'Custom Plugins' (or 'Custom Themes' ) field and select your plugin. |
From now on, your clients will be able to find the custom plugin you have included in their client area. All they have to do to install it is to click on the '+' icon. |
The plugin should be visible on the 'Installed' list and can be activated or deactivated any time. |
[edit] Tips
1. In case you wish to remove one of your plugins from WHM, make sure you delete the additional content too:
/usr/local/cpanel/Cpanel/API/Wordpress.pm /usr/local/cpanel/share/WordPressManager/wp |
2. If you wish to change the names of your WordPress installation scripts to be more friendly in the client area, you can do this in a language file. Simply open your default 'english.php ' file located in '/yourWHMCS/modules/addons/WordpressManager/langs' directory and add a new language record in the following format: $_LANG['WordPress Script Name']="WordPress Friendly Name"; |
3. When using the WordPress Manager module with cPanel, you will also need to whitelist 'phar' support in your php.ini on the WHM server. You can do this by adding or editing the below record: suhosin.executor.include.whitelist = phar |
4. It is possible to set language for WordPress auto-installation. In the Product Custom Fields section you should complete:
en|English,ar|Arabic,zh_CN|Chinese,fr_FR|French,de_DE|German,el|Greek,it_IT|Italian,ja|Japanese,ko_KR|Korean,pl_PL|Polish,ru_RU|Russian, sl_SI|Slovenian,sk_SK|Slovak,es_ES|Spanish,tr_TR|Turkish,uk|Ukrainian,vi|Vietnamese
|
5. Custom Fields used in the instance creation process: You can set a username and password for the administrator panel in WordPress and the Site Title of the installation using the following product custom fields.
For WordPress Quick Installation:
If a client completes the username and password, then the account will be created on the basis of the provided data. |
[edit] Language Overrides
Incorporating language customizations - the module readily accommodates language overrides, allowing you to tailor the language files to your preferences. The language file english.php remains unencoded and can be modified to suit your needs. However, it's recommended to avoid altering the core file itself, and instead, leverage the capability of using overrides. Here's how to apply language overrides:
~/langs/overrides/english.php.
For example: Original yourWHMCS/modules/servers/moduleName/langs/english.php: $_LANG['Search'] = 'Search'; Override yourWHMCS/modules/servers/moduleName/langs/overrides/english.php: $_LANG['Search'] = 'Look for'; By following these steps, you can seamlessly implement language customizations without altering the core language file, ensuring your changes will not be lost after every module update. Remember that some of the modules have more than one language file, located under /addons and /servers paths. You may create the override files for both of them. |
[edit] Test Installation (up to version 1.7.1)
If you are still using WordPress Manager For WHMCS up to version 1.7.1, a test installation is required.
Note: The below steps should be possible if you have already made the basic Product Settings configuration. So, to start, proceed to the 'WordPress Management' section of the product in the Client Area on any of your test accounts. Next, click on the 'New Installation' button. |
There are two sections to complete. Firstly, provide the details of your installation. Remember to enter your domain properly. |
Now, go to the 'Other' section of your installation and fill in the details. You may also decide which options should be enabled for your installation. Remember to click 'Create' and wait until the 'New Installation' is ready. |
Finally, you can come back to 'WordPress Manager'. Go to 'Product Settings' and click on the 'Edit' icon next to the preferred product. You will find the 'Test Installation' option here. As presented below, start typing your domain name that was provided in the previous step of creating 'New Installation' . Choose your 'Test Installation' and save changes. |
[edit] Update Instructions
An essential guidance through the process of updating the module is offered here. Important: If you are performing an update from a previous version of WordPress Manager with cPanel, you have to also update the files and run again the installation script on your WHM server. |
[edit] Updating the Module to Version 3.x
Before updating to module version 3.x, ensure that there are no pending tasks in the queue to avoid migration issues. Follow the steps to ensure a smooth transition to version 3.x of the module:
|
[edit] Upgrade Guide
Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability? There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment. Opt for the Open Source version of your WordPress Manager For WHMCS module to unlock these benefits. Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized. |
[edit] Common Problems
1. When you have problems with connection, check whether your SELinux or firewall does not block ports. |
2. If you do not see the config records, make sure that you have also updated the WHM files to the latest version. |
3. Installation of Let's Encrypt SSL is available only for DirectAdmin products. |
4. Native integration with cPanel Extended module works seamlessly except for one aspect, specifically access via 'Manage Account → WordPress Manager', where an issue is encountered. You may smoothly enter the WordPress Manager via: 'Actions → WordPress Management'. |
5. The module supports two APIs: Softaculus and WP Toolkit. If you are changing the API from WP Toolkit to Softaculous, when there are already existing installations, you must remember to synchronize the instances. Solution: Proceed to cPanel → Softaculous and press the "Scan" button. |
When changing the API from Softaculous to WP Toolkit, trigger the scanning in cPanel → WP Toolkit: |
After the scan is successfully complete, wait until the data is synchronized in the module by running the following cron command:
php -q /yourWHMCS/modules/addons/WordpressManager/cron/cron.php Synchronize That is all, the installations can now be managed via target API. |
6. If you experience issues with the proper functionality of a Plesk-based module, one potential cause might be difficulties in retrieving the accurate external WHMCS IP address. To eliminate this as a factor, we recommend configuring the variable ipServerWhmcs with a specific IP address in the configuration file located at: app/config/configuration.yml. ipServerWhmcs: '123.456.78.910' |