Difference between revisions of "Moving the site among directories/sub-directories"

From Joomla! Documentation

m ($live_site variable rarely needs to be given a value ... edited accordingly)
(Remove outdated and dangerous advice about declaring $live_site with a non-empty value. $ftp_root is unused in J! 4.x)
 
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Many times you install Joomla in a sub-directory and then want to move it to a higher level directory, here's a short tutorial on how to do it.  
+
<noinclude><languages /></noinclude>
 +
<translate><!--T:1-->
 +
Many times you install Joomla in a subdirectory and then want to move it to a higher level directory. Here's a short tutorial on how to do it.</translate>
  
Say you have installed Joomla in the following folder: public_html/tryjoomla.
+
<translate><!--T:2-->
Now that you are satisfied with the site, you'll want to move to public_html.
+
Say you have installed Joomla in the ''public_html/tryjoomla'' folder.</translate>
 +
<translate><!--T:3-->
 +
Now that you are satisfied with the site, you'll want to move to ''public_html''.</translate>
  
1. Move all the files from the sub-directory (i.e., public_html/tryjoomla) to the upper level directory (i.e., public_html). You can use your favourite FTP client or the control panel that your hosting service provides.
+
<translate><!--T:4-->
 +
1. Move all the files from the subdirectory (i.e., ''public_html/tryjoomla'') to the upper level directory (i.e., ''public_html''). You can use your favourite FTP client or the control panel file manager that your hosting service provides.</translate>
  
2. Download and open the configuration.php file in a text editor.
+
<translate><!--T:5-->
 +
2. Download and open the ''configuration.php'' file in a text editor.</translate>
  
3. Simply remove the tryjoomla folder name from the path. Look for the following lines
+
<translate><!--T:6-->
<source lang="php">
+
3. Simply remove the ''tryjoomla'' folder name from the path. Look for these lines:</translate>
var $live_site = '';
+
 
var $log_path = '/home/username/public_html/tryjoomla/logs';
+
<syntaxhighlight lang="php">
 +
var $log_path = '/home/username/public_html/tryjoomla/administrator/logs';
 
var $tmp_path = '/home/username/public_html/tryjoomla/tmp';
 
var $tmp_path = '/home/username/public_html/tryjoomla/tmp';
var $ftp_root = 'public_html/tryjoomla';
+
</syntaxhighlight>
</source>
+
 
 +
<translate><!--T:7-->
 +
Change to:</translate>
  
Change to:
+
<syntaxhighlight lang="php">
<source lang="php">
+
var $log_path = '/home/username/public_html/administrator/logs';
var $live_site = '';
 
var $log_path = '/home/username/public_html/logs';
 
 
var $tmp_path = '/home/username/public_html/tmp';
 
var $tmp_path = '/home/username/public_html/tmp';
var $ftp_root = 'public_html';
+
</syntaxhighlight>
</source>
 
  
 +
<translate><!--T:8-->
 +
N.B. The ''$live_site'' variable should not be given a value. If it was given a value during installation, edit that path as well, for example:</translate>
  
N.B.
+
<syntaxhighlight lang="php">
The $live_site variable rarely needs to be given a value.  But if it was given a value during installation then edit that path as well.
+
var $live_site = 'http://www.example.com';
<source lang="php">
+
</syntaxhighlight>
var $live_site = 'http://www.yoursite.com/tryjoomla';
+
<translate><!--T:9-->
</source>
+
Change to:</translate>
Change to:
+
<syntaxhighlight lang="php">
<source lang="php">
+
var $live_site = '';
var $live_site = 'http://www.yoursite.com';
+
</syntaxhighlight>
</source>
 
 
 
  
+
<translate><!--T:10-->
 +
4. Check your site's ''.htaccess'' file. The subfolder should be removed as well. The RewriteBase directive should be commented out. Check for a RewriteRule that contains the old subdirectory.</translate>
  
4. Check your .htaccess. The subfolder should be removed there as well.
+
<translate><!--T:11-->
 +
5. Verify that no redirect orders to the old subdirectory are in place in your hosting control panel.</translate>
  
If you have cache enabled, login to the administrator backend (which will now be at http://www.yoursite.com/administrator and not http://www.yoursite.com/tryjoomla/administrator). Go to Tools -> Clean Cache and delete all cache files.
+
<translate><!--T:12-->
 +
If you have cache enabled, login to the Backend (which will now be at ''<nowiki>http://www.example.com/administrator</nowiki>'' and not ''<nowiki>http://www.example.com/tryjoomla/administrator</nowiki>''). Go to {{rarr|Tools,Clean Cache}} and delete all cache files.</translate>
  
 
<noinclude>
 
<noinclude>
 +
<translate>
 +
<!--T:13-->
 
[[Category:Administration FAQ]]
 
[[Category:Administration FAQ]]
 
[[Category:Installation FAQ]]
 
[[Category:Installation FAQ]]
 +
[[Category:Update Working Group]]
 +
</translate>
 
</noinclude>
 
</noinclude>

Latest revision as of 02:46, 10 May 2023

Other languages:
English • ‎Nederlands • ‎español

Many times you install Joomla in a subdirectory and then want to move it to a higher level directory. Here's a short tutorial on how to do it.

Say you have installed Joomla in the public_html/tryjoomla folder. Now that you are satisfied with the site, you'll want to move to public_html.

1. Move all the files from the subdirectory (i.e., public_html/tryjoomla) to the upper level directory (i.e., public_html). You can use your favourite FTP client or the control panel file manager that your hosting service provides.

2. Download and open the configuration.php file in a text editor.

3. Simply remove the tryjoomla folder name from the path. Look for these lines:

var $log_path = '/home/username/public_html/tryjoomla/administrator/logs';
var $tmp_path = '/home/username/public_html/tryjoomla/tmp';

Change to:

var $log_path = '/home/username/public_html/administrator/logs';
var $tmp_path = '/home/username/public_html/tmp';

N.B. The $live_site variable should not be given a value. If it was given a value during installation, edit that path as well, for example:

var $live_site = 'http://www.example.com';

Change to:

var $live_site = '';

4. Check your site's .htaccess file. The subfolder should be removed as well. The RewriteBase directive should be commented out. Check for a RewriteRule that contains the old subdirectory.

5. Verify that no redirect orders to the old subdirectory are in place in your hosting control panel.

If you have cache enabled, login to the Backend (which will now be at http://www.example.com/administrator and not http://www.example.com/tryjoomla/administrator). Go to Tools  Clean Cache and delete all cache files.