How To: Manage Subdomains
=========================

Subdomains are domains with the format sub.mydomain.com. 

By default, a subdomain's docroot is set to use 
``/home/{unixuser}/{domain.com}/html/{sub}``, replacing ``{sub}`` with the corresponding subdomain prefix. Subdomains
also inherit the PHP version of the parent domain. The docroot and PHP version for the subdomain can be customized 
after creation. 

.. contents::

To Add a Subdomain
------------------

#. Log into SiteWorx from the browser (https://ip.ad.dr.ess:2443/siteworx)
#. In SiteWorx, navigate to **Hosting Features > Domains > Subdomain**, either from the side menu or SiteWorx home

   .. image:: /images/sw-subdomain-page.png
      :alt: subdomain page 

#. Click **+** or **Add a Subdomain**. This opens the Add a Subdomain form

   .. image:: /images/sw-add-subdomain.png
      :alt: siteworx add subdomain form 

#. Select the **desired domain** from the dropdown and update the Subdomain field 
#. Click **Add**

To Edit a Subdomain 
-------------------

#. Log into SiteWorx from the browser (https://ip.ad.dr.ess:2443/siteworx)
#. In SiteWorx, navigate to **Hosting Features > Domains > Subdomain**, either from the side menu or SiteWorx home

   .. image:: /images/sw-subdomain-page.png
      :alt: subdomain page 

#. Click the **pencil** next to the subdomain. This opens the Edit Subdomain form 

   .. image:: /images/sw-subdomain-edit.png
      :alt: subdomain edit form 

#. Update the desired fields 

   - **Document Root**: The custom docroot for the subdomain
   - **Use Parent PHP Version**: Determines whether the subdomain uses the parent domain's PHP version 
   - **PHP Version**: The custom PHP version for the subdomain, if not using the parent domain's PHP version 

#. Click **Save**

To Delete a Subdomain
---------------------

From the Subdomain List 
^^^^^^^^^^^^^^^^^^^^^^^

#. Log into SiteWorx from the browser (https://ip.ad.dr.ess:2443/siteworx)
#. In SiteWorx, navigate to **Hosting Features > Domains > Subdomain**, either from the side menu or SiteWorx home

   .. image:: /images/sw-subdomain-page.png
      :alt: subdomain page 
  
#. Next to Existing Subdomains, select the **desired domain** that the subdomain is under.  By default, the subdomains 
   for the master domain are shown. Selecting a secondary domain will refresh the page to show the subdomains for that
   secondary domain  
#. Click the **Trashcan** next to the subdomain. This opens the Confirmation form 

   .. image:: /images/sw-delete-subdomain.png
      :alt: siteworx subdomain delete form 

#. Click **Delete**

From the With Selected Dropdown 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

#. Log into SiteWorx from the browser (https://ip.ad.dr.ess:2443/siteworx)
#. In SiteWorx, navigate to **Hosting Features > Domains > Subdomain**, either from the side menu or SiteWorx home

   .. image:: /images/sw-subdomain-page.png
      :alt: subdomain page 
  
#. Select the **checkbox** next to the domain(s) 

   - Selecting the **checkbox** next to the With Selected dropdown will automatically select all domains

#. Select **Delete** from the With Selected dropdown
#. Click **Go**. This opens the Confirm Deletion form

   .. image:: /images/sw-delete-subdomain.png
      :alt: siteworx delete secondary domain form

#. Click **Delete**