Setup Part 5: Installing on sub-domains and add-on domains
While SetupBOT does its best to figure out your hosting environment so that it can guess the correct paths for your installation, it needs a helping hand with some sub-domain and add-on domain configurations.
Sub-domain:
A sub-domain is something like subdomain.YourDomain.com. Most web hosts let you have multiple or unlimited sub-domains like go.YourDomain.com, which goes to a different web site than www.YourDomain.com or my.YourDomain.com. Many hosts also limit the number of sub-domains you can add.
Here are a few examples of how sub-domains might appear in your folders, depending on your web host. The example folder “public_html” might be named “httpdocs” or something else.
Example 1:
/ (Root of your account.)
/public-html/ (Folder containing yourdomain.com HTML files.)
/subdomains/ (Folder containing all sub-domains.)
/subdomains/go/public_html/ (Folder containing go.YourDomain.com HTML files.)
/subdomains/my/public_html/ (Folder containing my.YourDomain.com HTML files.)
Example 2:
/ (Root of your account.)
/public-html/ (Folder containing YourDomain.com HTML files.)
/public_html/go/ (Folder containing go.YourDomain.com HTML files.)
/public_html/my/ (Folder containing my.YourDomain.com HTML files.)
With this setup, to install GoTryTHIS you would put the following into SetupBOT:
FTP DETAILS:
FTP Host: ftp.yourdomain.com (Your main domain for the account.)
FTP User: XXXXX (Username for ftp.yourdomain.com.)
FTP Pass: XXXXX (Password for ftp.yourdomain.com.)
INSTALL LOCATION:
Physical Path: /public_html/my/
Installation Folder: /gotrythis/
Domain Name: my.YourDomain.com
After, on the last page of the installation, please make sure to put in your sub-domain.
Add-on domain:
An add-on domain is a way some web hosts deal with you having multiple domain names (web sites) within one account. Not all web hosts do this and instead have separate accounts.
Your first or primary domain name with the web host is the one under which you have an account, and then all your other domains are folders within your primary domain as opposed to unique accounts on their own.
Similarly to sub-domains, different web hosts deal with this differently. Here are examples of how add-on might appear in your folders. In your system, the folder “public_html” might be something different, such as “httpdocs” or something else.
Example 1:
/ (Root of your account for one domain)
/public-html/ (Folder containing YourDomain.com HTML files.)
/ (Root of your account for a different domain, with unique FTP details.)
/public-html/ (Folder containing YourOtherDomain.com HTML files.)
If your site matches this example, you can ignore this section and install normally.
Example 2:
/ (Root of your account for multiple domains, sharing the same FTP details.)
/public-html/ (Folder containing yourdomain.com HTML files.)
/public_html/yourotherdomain.com/ (Folder containing YourOtherDomain.com HTML files.)
/public_html/somethingelse.com/ (Folder containing SomethingElse.com HTML files.)
With this setup, to install GoTryTHIS you would put the following into SetupBOT:
FTP DETAILS:
FTP Host: ftp.yourdomain.com (Your main domain for the account.)
FTP User: XXXXX (Username for ftp.yourdomain.com.)
FTP Pass: XXXXX (Password for ftp.yourdomain.com.)
INSTALL LOCATION:
Physical Path: /public_html/yourotherdomain.com/
Installation Folder: /gotrythis/
Domain Name: yourotherdomain.com
After, on the last page of the installation, please make sure to put in your add-on domain.
Sub-domains on add-on domains:
You can also create sub-domains on add-on domains, such as go.YourOtherDomain.com, continuing from the above section. This only applies if your web host sets up multiple domains as add-on domains as described in the section above. Please read the section above first.
If the sub-domain doesn’t exist, look for a section called “Sub Domains” in your control panel and create the sub-domain, such as go.YourOtherDomain.com. It will probably store the files in the structure /public_html/addondomain.com/subdomain/. With some control panels you can specify that location yourself.
In our example the files will be in:
/public_html/yourotherdomain.com/go/
With this setup, to install GoTryTHIS you would put the following into SetupBOT:
FTP DETAILS:
FTP Host: ftp.yourdomain.com (Your main domain for the account.)
FTP User: XXXXX (Username for ftp.yourdomain.com.)
FTP Pass: XXXXX (Password for ftp.yourdomain.com.)
INSTALL LOCATION:
Physical Path: /public_html/yourotherdomain.com/go
Installation Folder: /gotrythis/
Domain Name: go.yourotherdomain.com
Possible Problem Areas
On some hosts, you create add-on domains in your hosting account’s control panel, and they use internal mechanisms to forward all incoming traffic to that add-on domain rather than giving the domain its own separated file area (for example, this is the case with 1&1 Internet’s add-on domains).
While this works fine for your domain and your GoTryTHIS installation, it can affect the operation of your GoTryTHIS links. When you use a GoTryTHIS link on such add-on domains, the additional link information required is not forwarded to the GoTryTHIS script and the links will not work. There is no workaround for this.