How To: Install Wordpress in InterWorx
======================================

`Wordpress <https://wordpress.com/>`__ is a software that can be used to make building a website easier and user 
friendly. While InterWorx does not provide or directly support Wordpress, it can be easily installed and used on 
InterWorx servers.

Wordpress can be installed manually via the CLI, or from the SiteWorx interface using Softaculous, if enabled. 

In order to use Softaculous to install Wordpress, the plugin must be enabled in NodeWorx under 
**NodeWorx > Plugins**. The SiteWorx account must also have that permission set to Yes on the account's edit
form in NodeWorx, under **SiteWorx > Accounts**. These tasks can only be completed by a Server Administrator. 

The full, paid license for Softaculous is also required, as Wordpress is not included with the free version of
Softaculous that comes with InterWorx. Full licenses can be purchased from `Softaculous' website <https://softaculous.com/pricing/>`__. 

SiteWorx users who would like to install Wordpress via Softaculous, and who do not see that option listed in SiteWorx, 
should contact their hosting provider. 

.. note:: 
  
   `Softaculous <https://softaculous.com/>`__ is a third party plugin. InterWorx does not directly support or 
   maintain this plugin. Any questions or issues that may arise should be directed to `Softaculous' helpdesk <https://softaculous.deskuss.com/>`__. 

.. contents::

To Install Wordpress using Softaculous
--------------------------------------

.. note::

   InterWorx ships with the standard license for Softaculous. As Wordpress is part of their premium packages,
   a premium Softaculous license is needed. Softaculous licenses may be purchased `from their website <https://www.softaculous.com/softaculous/pricing>`__. 

#. Log into SiteWorx from the browser (https://ip.ad.dr.ess:2443/siteworx)
#. In SiteWorx, navigate to **Hosting Features > Softaculous**, either from the side menu or SiteWorx home 
 
   .. image:: /images/sw-softaculous-wp-button.png
      :alt: wordpress button

#. Click the **Wordpress** button. This opens the Wordpress installation page

   .. image:: /images/sw-wordpress-install-button.png
      :alt: wordpress install now button

#. Click **Install Now**. This opens the Wordpress Software Setup page 
#. Update the **desired fields**, if making any setting changes from the default

   .. image:: /images/sw-wordpress-software-settings.png
      :alt: wordpress software setup install button  

#. At the bottom of the page, click **Install**. This refreshes the page to show the installation status. 
#. When the installation is complete, a page with the account settings will be provided

   .. image:: /images/sw-wordpress-account-info.png

To Manually Install Wordpress
-----------------------------

.. note::

   Installing Wordpress via the CLI requires the ability to SSH into the server from a terminal. SiteWorx users who do 
   not have shell access should contact their hosting provider. Information on adding SSH shell users can be found
   :doc:`here </nodeworx/server_management/ssh/manage-ssh-shell-users>`.

Setting up the Database
^^^^^^^^^^^^^^^^^^^^^^^

#. Log into SiteWorx from the browser (https://ip.ad.dr.ess:2443/siteworx)
#. In SiteWorx, navigate to **Hosting Features > MySQL > Databases**, either from the side menu or SiteWorx home 
#. Click **+**. This opens the Add a MySQL Database from
#. Update the desired fields: 
   
   - **Database Name**: The name of the database. SiteWorx will automatically append the  unix username of the SiteWorx 
     to the database name provided
   - **Create User**: Checking this box will expand the form to include database user options. Creating a database user for
     the new wordpress database is recommended
   - **Password/Confirm Password**: The password for the database user. Clicking the **Magic Wand** will automatically 
     generate a secure password
   - **MySQL User Permissions**: The permissions the database user should have
   - **When Connecting From**: The host the database user will connect from. % is the default, which is a wildcard

     .. image:: /images/sw-wordpress-create-db.png
        :alt: create wordpress database

#. Click **Add**

Downloading the Wordpress Config Files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

#. Log in to the server at the CLI as the SiteWorx user, either via SSH or from the terminal
#. From the CLI, navigate to ``/home/unixuser/domain/html``

   .. code-block::

      cd /home/mywebsit/mywebsite.com/html/

#. Download the latest Wordpress version with wget. The latest version can be found on `the Wordpress website <https://wordpress.org/download/>`__.
   The link in the example below should also work
  
   .. code-block::

      wget https://wordpress.org/latest.tar.gz

#. Untar the package with ``tar -zxvf``. This extracts the files into a new folder named ``wordpress```

   .. code-block::

      tar xfz latest.tar.gz

#. Move all of the files in the newly created ``wordpress`` folder into the current directory

   .. code-block::

      mv wordpress/* ./

#. Delete the empty wordpress folder

   .. code-block::

      rmdir ./wordpress/

Installing Wordpress
^^^^^^^^^^^^^^^^^^^^

#. In the browser, navigate to the domain. It will automatically redirect to the Wordpress Setup page


   .. image:: /images/wordpress-setup-config.png
      :alt: wordpress setup config page  

#. Choose the default language
#. Click **Continue**. This opens the database connection details page

   .. image:: /images/wordpress-db-info.png
      :alt: wordpress database info 

#. Provide the credentials for the database 
#. Click **Submit**. This opens the installer page

   .. image:: /images/wordpress-installer.png
      :alt: wordpress install button

#. Click **Run the Installation**. This opens the Welcome page

   .. image:: /images/wordpress-welcome.png
      :alt: wordpress welcome page

#. Update the required fields
#. Click **Install Wordpress**. When the installer is finished, it will open a page stating that the installation was a 
   success, and provide the the user login information  

   .. image:: /images/wordpress-success.png
      :alt: wordpress install success page