How to move Dolphin to another location in your web space or hosting account:

For 6.1x Versions

Move your website from:
yoursite.com

To:
yoursite.com/dolphin


Aside from moving the actual files and folders which I will explain in a moment there are a number of important files that need to be update to reflect the changes. You also need to update your cron jobs with the new paths in your hosting control panel. If you forget or don't make all the necessary changes your site will either not work at all or you will get errors and email error reports. So it is important that you do not miss one of these. Take your time and double check.

The files that need changes:

/inc/header.inc.php
$site['url']               = "http://www.yoursite.com/";

$dir['root']               = "/home/your-account-name/public_html/";


/periodic/cmd.php
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

/periodic/cupid.php
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

/periodic/notifies.php
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

/periodic/periodic.file
MAILTO=you@yoursite.com
0 0 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/cmd.php
*/10 * * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/notifies.php
* */1 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/cupid.php


/ray/modules/global/inc/header.inc.php
include("/home/your-account-name/public_html/inc/header.inc.php");


In your hosting control panel the cron jobs:
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/cmd.php
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/notifies.php
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/cupid.php



In the following instructions I will be using the host control panel "cpanel" to move the Dolphin files and folders. This is probably the best way to move them from one location to another. Using cpanel to move them will keep the file and folder permissions intact. All those 644, 666, 755, and 777 permissions you were asked to change during the installation process will remain if you use cpanel. However, if you move the files and folders using a ftp client such as filezilla they may reset and change to the standard permission levels determined by the host server configuration. Which means you would then need to change many of the permissions again. Which can be a long tedious task. So the better solution is to use "cpanel" to move them.

I will be moving from the main root home directory folder (public_html) http://www.yoursite.com to http://www.yoursite.com/dolphin (public_html/dolphin) which is a subfolder/subdirectory.


This example will assume that you do not have anything uploaded to your home directory (public_html).

Now login to your hosts cpanel and navigate to "File Manager"

 

 

Select "Web Root (public_html/www)" and make sure you also select "Show Hidden Files (dotfiles)" so you can see and select .htaccess files as well then click "Go"

 

 

 

First we want to create the folder/directory named dolphin (yoursite.com/dolphin) to move the files to.

Click on "New Folder" 

 

 

Enter "New Folder Name:" dolphin
"New Folder will be created in:" /public_html (this is the default location and you shouldn't need to change this).
Click Create New Folder Button

 

 

 

Next

If you only have Dolphin installed you can use the "Select all" option here to check them all at once rather than clicking each individually. If you do have other files and folders you will need to deselect them, if you don't want to move them.

 

 

After you have selected all the files and folders choose "Move File"

 

 

On this screen at the very bottom change /public_html
to:
/public_html/dolphin

And then click "Move File(s)" button.

 

 

After this, all your files in your main root home directory (public_html) should now be in public_html/dolphin or yoursite.com/dolphin

If you used this cpanel method of moving files, then all permissions should remain intact and no further permission changes should be necessary.

Now in the next steps we need to edit and update some important files to reflect the new location yoursite.com/dolphin (public_html/dolphin) so that it will work properly. We will do each one by one.

You can use the same cpanel file manager's edit file feature for this, or you may now use your ftp client like filezilla to do this.

I will continue using cpanel file manager since the above instructions to move the files used this.


First navigate to and select /inc/header.inc.php and click "Edit"

 

 

We need to change near the first part of the file:
$site['url']               = "http://www.yoursite.com/";

To:
$site['url']               = "http://www.yoursite.com/dolphin/";

(make sure there is a trailing slash (/) (dolphin/) exactly as displayed here)
(obviously the yoursite.com would really be your site name)

Then scroll down the file a little further and find:
$dir['root']               = "/home/your-account-name/public_html/";

Change to:
$dir['root']               = "/home/your-account-name/public_html/dolphin/";

(again don't forget the trailing slash (/) (dolphin/) exactly as displayed here)

Save the changes.

 

Before:

 

 

After Changes:

 

 

 

 

Save Changes Button:

 

 

 

Now on to the period folder. Navigate to /periodic folder and select /periodic/cmd.php and select "edit" again.

Near the first part of the file
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

Change it to:
require_once( '/home/your-account-name/public_html/dolphin/inc/header.inc.php' );

Save the changes.

 

Before:

 

 

 

 

After:

 

 

 

Open /periodic/cupid.php with the cpanel file manger and select "Edit"

Find near the top:
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

Change to:
require_once( '/home/your-account-name/public_html/dolphin/inc/header.inc.php' );

Save the changes.

 

Before:

 

 

 

 

After:

 

 

 

Open and "edit" /periodic/notifies.php

Find near the top:
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

Change to:
require_once( '/home/your-account-name/public_html/dolphin/inc/header.inc.php' );

Save the changes.

 

Before:

 

 

 

 

After:

 

 

Open and "edit" /periodic/periodic.file

Find:
MAILTO=you@yoursite.com
0 0 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/cmd.php
*/10 * * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/notifies.php
* */1 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/cupid.php

Change to:
MAILTO=you@yoursite.com
0 0 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/cmd.php
*/10 * * * *  /usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/notifies.php
* */1 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/cupid.php

Save the changes.

 

Before:

 

 

 

 

After:

 

 

Now one more file and then the cron jobs.

Open and "edit" /ray/modules/global/header.inc.php

Near the top of the file find:
include("/home/your-account-name/public_html/inc/header.inc.php");

Change to:
include("/home/your-account-name/public_html/dolphin/inc/header.inc.php");

Save the changes.

 

Before:

 

 

 

 

After:

 

 

 

Whooo that was a lot of work, but we are almost done.

You can close the "Cpanel file manger" now if you followed these steps correctly.

Then in your standard "cpanel" main account area scroll down until you find "Cron Jobs"

 

 

The fastest easiest way to change a cron is to select the "Advanced (Unix Style)" button / option since we just need to edit the location. So click on the "Advanced (Unix Style)" button.

 

Now in the cron command box we just need to add the folder/directory dolphin to each cron.

So in each cron command box you will find:
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/cmd.php
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/notifies.php
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/cupid.php

You need to change each to:
/usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/cmd.php
/usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/notifies.php
/usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/cupid.php

Then just click "Commit Changes" button.

 

Before:

 

 

 

 

After:

 

 

 

 

Commit Changes (Save Changes):

 

 

 

(you are just adding the location or path to the new folder dolphin basically.)

You do not need to change any of the minute-hour-day-month-weekday settings. They should all remain the same as the current settings.




OK take a deep breath. If all is well your website should now be totally moved from:
yoursite.com

To:
yoursite.com/dolphin

Your admin login would now be:
yoursite.com/dolphin/admin
or
yoursite.com/dolphin/admin/index.php

If not you missed a step, file, moved it to another location by accident, or entered/edited the paths wrong.



Notes:

You are just moving the files with cpanel filemanger to /dolphin. Then updating the files to reflect the new location or path.

 

In the above instructions you will notice paths such as:

• /home/your-account-name/public_html/inc/header.inc.php

 

Obviously your-account-name would be your actual cpanel hosting account name. It should already be filled in and you don't need to touch this. You only need to add /dolphin to the path like:

• /home/your-account-name/public_html/dolphin/inc/header.inc.php