Wordpress manager feature (PRO PACK)

Wordpress manager allows users to manage the Wordpress installations from the control panel web interface.

The feature can be accessed on user level via Advanced Features -> Wordpress Manager.

Usage

Wordpress manager facilitates the management of Wordpress installations.

It provides an easy way to create a new Wordpress installation. To do so, click on Create Wordpress installation in Actions section of Wordpress manager. The installation consists of 3 steps:

  1. Installation info. A Directory and a Title are required to be entered. Directory is the location of the installation under the domain and is optional. Title is the title of Wordpress installation itself.

  2. Admin info. This step requires credentials for the admin of Wordpress installation. A Name, Password and Email must be entered.

  3. Database. New Wordpress installation requires valid MySQL database credentials. Before creating a Wordpress installation, a new MySQL user and database must be created. It can be done using MySQL Management in Related Pages section of Wordpress manager. After the database was created, it should appear in the dropdown list of Database Name field. That is the name of a desired database for Wordpress installation to use. Database User Name field contains the dropdown list of all MySQL users, make sure to select the one that belongs to selected database. Database User Password is the password of the database user. Table Prefix field is for the table names that Wordpress uses.

If all of the information above was entered, Install button should appear active.

Keep in mind that either one installation straight under public_html directory or many installations each in its own subdirectory can be created and managed in Wordpress manager.

Each created installation can later be deleted using the right-hand side tooltip. Keep in mind that it clears the database that installation uses and deletes everything under the installation directory.

If there already are Wordpress installations under your domain, they can be added to Wordpress manager by using the Scan button. It scans the filesystem for existing installations and adds them to the manager if they pass validation rules.

Sometimes Wordpress installations get broken. Such installations are indicated by Error column in the main screen of Wordpress manager, meaning there are problems retrieving information about these installations. Common causes of it include changed database credentials, broken plugins or themes, etc.

Example

Installation

Let's install a brand new Wordpress installation under public_html directory.

First of all, Installation info must be entered. We keep the Directory empty to install it straight under public_html directory.

Wordpress Create Installation Info

Secondly, Admin info of new Wordpress installation admin user must be entered.

Wordpress Create Admin Info

Lastly, Database credentials must be selected.

Wordpress Create Database

If all of the requirements were fullfilled, Install button should appear active. If the installation was successful it should appear in the main Wordpress manager page.

Scan

Let's assume that the Wordpress manager is empty but there are 3 installations under subdirectories of public_html directory:

> john@directadmin:~/domains/example.com/public_html$ ls -l
total 12
drwxr-xr-x 5 john john 4096 Nov 29 07:01  first_installation
drwxr-xr-x 5 john john 4096 Nov 29 07:02  second_installation
drwxr-xr-x 5 john john 4096 Nov 29 07:05  third_installation!
1
2
3
4
5

To add them to the Wordpress manager simply press Scan button:

Wordpress Scan

If the Scan has completed without errors, installations should appear in the Wordpress manager. If any of the installations in filesystem were ignored, a table of Warnings pops up, explaining why the installations were excluded.

Wordpress Scan Result

In this example third_installation! is an invalid directory name thus it was not added to Wordpress manager.

Technical

In order for Wordpress manager to work, wp-cli must be installed on the server. It can be done by using /usr/local/directadmin/custombuild/build wp command.

Each installation is placed under public_html directory of selected domain. Metadata about Wordpress installations is stored in a per-user SQLite at /usr/local/directadmin/data/users/USER/user.db

Only one installation straight under public_html directory or many installations each in its own subdirectory can be created and managed in Wordpress manager. Scan prioritizes public_html installation.

Scan scans filesystem for Wordpress installations with the maximum depth of 1, i.e. only public_html and its subdirectories non-recursively are scanned.

Last Updated: 11/29/2021, 2:25:29 PM