Multiple Domains and Web Sites in a single Joomla! installation - Revision history

Aux105432: /* Option #2: Create a PHP Header Redirect */

2012-11-08T06:16:33Z

‎Option #2: Create a PHP Header Redirect

Benmoreassynt: /* Option #3: Create a PHP Header Redirect, for multiple domains with specific domain redirects for custom templates */

2011-08-30T17:52:02Z

‎Option #3: Create a PHP Header Redirect, for multiple domains with specific domain redirects for custom templates

Benmoreassynt: Edited to take account of headers being sent when output begins for most PHP users

2011-08-30T17:51:19Z

Edited to take account of headers being sent when output begins for most PHP users

G1smd: Code for redirect generates 302 not 301. In any case, the code cannot possibly work at all when pasted where recommnded in the article.

2011-05-07T12:14:40Z

Code for redirect generates 302 not 301. In any case, the code cannot possibly work at all when pasted where recommnded in the article.

G1smd: Using (www\.)? parses faster. Escape literal periods in patterns.

2011-03-07T17:45:32Z

Using (www\.)? parses faster. Escape literal periods in patterns.

Dagoba: Removed obsolent part ...

2011-01-22T09:11:29Z

Removed obsolent part ...

Dagoba: Option 3, enhanced text and added template setup hints.

2011-01-22T09:08:45Z

Option 3, enhanced text and added template setup hints.

Dagoba: /* Option #3: Create a PHP Header Redirect, for multiple domains and within specific domain redirects for custom default/frontpage */

2011-01-22T06:23:05Z

‎Option #3: Create a PHP Header Redirect, for multiple domains and within specific domain redirects for custom default/frontpage

Dagoba: Added Solution in PHP for different domains with different landing page with 1 webspace.

2011-01-22T06:19:03Z

Added Solution in PHP for different domains with different landing page with 1 webspace.

Cmb: Corrected spelling and punctuation. Modified heading hierarchy.

2011-01-04T18:44:14Z

Corrected spelling and punctuation. Modified heading hierarchy.

@@ Line 35: / Line 35: @@
 <?php
 $domain = $_SERVER["HTTP_HOST"];
-if (($domain == "redjohnsoncandy.com") ||
+$uri = $_SERVER["REQUEST_URI"];
-    ($domain == "www.redjohnsoncandy.com")) {
+$url = $domain . $uri;
     header("Status: 301 Moved Permanently");
     header("Location: http://www.redjohnsoncandy.com/index.php?option=com_content&view=category&layout=blog&id=3&Itemid=12");
@@ Line 43: / Line 46: @@
 </source>
 Here's the benefit: The visitor will now be redirected to the appropriate ''Red Site'' page, that has the ''Red Template'' assigned to it '''only''' in the case where they have arrived at the 'red site' domain name. Otherwise, the conditional PHP rule is ignored, and the Yellow Site loads.
 ====Option #3: Create a PHP Header Redirect, for multiple domains with specific domain redirects for custom templates====

@@ Line 46: / Line 46: @@
 ====Option #3: Create a PHP Header Redirect, for multiple domains with specific domain redirects for custom templates====
-Solution for single webspace, with different domains, one Joomla install and depending on the user landing domain, redirects to a different default page. Paste following PHP code AS THE VERY FIRST THING in the maind index.php. To assign another domain, just copy/past the "if" function and edit it with the values of the other domain in the same fashion. Further to setup the template views, you will have to assign different module item/link alias and setup template views within the Joomla! template manager. The alias setting is needed when you use SEF settings.
+Solution for single webspace, with different domains, one Joomla install and depending on the user landing domain, redirects to a different default page. Paste following PHP code AS THE VERY FIRST THING in the install's primary index.php file. To assign another domain, just copy/past the "if" function and edit it with the values of the other domain in the same fashion. Further to setup the template views, you will have to assign different module item/link alias and setup template views within the Joomla! template manager. The alias setting is needed when you use SEF settings.
 <source lang='php'>
 <?php

@@ Line 31: / Line 31: @@
 This solution has the benefit of keeping the illusion of separate domains/web sites apparent to the visitor. Instead of using .htaccess (Apache) for our redirect, we use one of the templates on the site.
-In this example, the base domain is www.redjohnsoncandy.com. You have created a template for that area named ''Red Template''. The trick is to open 'Red Template's' index.php file and add the following to the head area.
+In this example, the base domain is www.redjohnsoncandy.com. You have created a template for that area named ''Red Template''. The trick is to open 'Red Template's' index.php file and add the following AS THE VERY FIRST LINES of the install's primary index.php.
 <source lang='php'>
 <?php
@@ Line 46: / Line 46: @@
 ====Option #3: Create a PHP Header Redirect, for multiple domains with specific domain redirects for custom templates====
-Solution for single webspace, with different domains, one Joomla install and depending on the user landing domain, redirects to a different default page. Paste following PHP code after the <head> of your Joomla template. To assign another domain, just copy/past the "if" function and edit it with the values of the other domain in the same fashion. Further to setup the template views, you will have to assign different module item/link alias and setup template views within the Joomla! template manager. The alias setting is needed when you use SEF settings.
+Solution for single webspace, with different domains, one Joomla install and depending on the user landing domain, redirects to a different default page. Paste following PHP code AS THE VERY FIRST THING in the maind index.php. To assign another domain, just copy/past the "if" function and edit it with the values of the other domain in the same fashion. Further to setup the template views, you will have to assign different module item/link alias and setup template views within the Joomla! template manager. The alias setting is needed when you use SEF settings.
 <source lang='php'>
 <?php
@@ Line 58: / Line 58: @@
 ?>
 </source>
 [[Category:Tips and tricks]]
 [[Category:Tips and tricks 1.5]]

@@ Line 37: / Line 37: @@
 if (($domain == "redjohnsoncandy.com") ||
     ($domain == "www.redjohnsoncandy.com")) {
-    header("location: http://www.redjohnsoncandy.com/index.php?option=com_content&view=category&layout=blog&id=3&Itemid=12");
+    header("Status: 301 Moved Permanently");
+}
 ?>
@@ Line 45: / Line 46: @@
 ====Option #3: Create a PHP Header Redirect, for multiple domains with specific domain redirects for custom templates====
-Solution for single webspace, with different domains, 1 joomla install and depending on the user landing domain, redirects to a different default page. Past following PHP code after the <head> of your joomla template. To assign another domain, just copy/past the "if" function and edit it with the values of the other domain in the same fashion. Further to setup the template views, you will have to assign different module item/link alias and setup template views within the joomla! template manager. The alias setting is needed when you use SEF settings.
+Solution for single webspace, with different domains, one Joomla install and depending on the user landing domain, redirects to a different default page. Paste following PHP code after the <head> of your Joomla template. To assign another domain, just copy/past the "if" function and edit it with the values of the other domain in the same fashion. Further to setup the template views, you will have to assign different module item/link alias and setup template views within the Joomla! template manager. The alias setting is needed when you use SEF settings.
 <source lang='php'>
 <?php
@@ Line 52: / Line 53: @@
 if (($domain == "www.example.de" && $requri == "/" ||
     $domain == "example.de"))  {
-    header("location: http://www.example.de/index.php?option=com_content&view=article&id=6");
+    header("Status: 301 Moved Permanently");
+}
 ?>
 </source>
 [[Category:Tips and tricks]]
 [[Category:Tips and tricks 1.5]]

@@ Line 23: / Line 23: @@
 <source lang='apache'>
 #The following rule works, but it changes which domain name displays.
-RewriteCond %{HTTP_HOST} ^redjohnsoncandy.com$ [OR]
+RewriteCond %{HTTP_HOST} ^(www\.)?redjohnsoncandy\.com$
-RewriteCond %{HTTP_HOST} ^www.redjohnsoncandy.com$
+RewriteRule (.*) http://www.yellowjohnsoncandy.com/index.php?option=com_content&view=category&layout=blog&id=3&Itemid=12 [R=301,L]
-RewriteRule ^(.*)$ http://www.yellowjohnsoncandy.com/index.php?option=com_content&view=category&layout=blog&id=3&Itemid=12 [R=301,L]
 </source>
 Well, that works - but you can see the drawback immediately. Although the user is successfully viewing the Red Candy site, they will still see the Yellow Candy domain name. Unfortunately, if you are using both .htaccess and domain-parking (technically a redirect) - this is necessary in order to avoid creating a LOOP.
 ====Option #2: Create a PHP Header Redirect====
 This solution has the benefit of keeping the illusion of separate domains/web sites apparent to the visitor. Instead of using .htaccess (Apache) for our redirect, we use one of the templates on the site.

@@ Line 43: / Line 43: @@
 Here's the benefit: The visitor will now be redirected to the appropriate ''Red Site'' page, that has the ''Red Template'' assigned to it '''only''' in the case where they have arrived at the 'red site' domain name. Otherwise, the conditional PHP rule is ignored, and the Yellow Site loads.
-====Option #3: Create a PHP Header Redirect, for multiple domains and within specific domain redirects for custom default/frontpage====
+====Option #3: Create a PHP Header Redirect, for multiple domains with specific domain redirects for custom templates====
-Solution for single webspace, with different domains, 1 joomla install and depending on the user landing domain, redirects to a different default page. Past following PHP code after the <head> of your joomla template. With the template manager you can then assign different templates to the different pages, to have the look of another webpage within 1 joomla install. To assign another domain, just copy/past the "if" function and edit it with the values of the other domain in the same fashion.
+Solution for single webspace, with different domains, 1 joomla install and depending on the user landing domain, redirects to a different default page. Past following PHP code after the <head> of your joomla template. With the template manager you can then assign different templates to the different pages, to have the look of another webpage within 1 joomla install. To assign another domain, just copy/past the "if" function and edit it with the values of the other domain in the same fashion. Further to setup the template views, you will have to assign different module item/link alias and setup template views within the joomla! template manager.
 <source lang='php'>
 <?php

@@ Line 1: / Line 1: @@
-==Overview==
+Although it's a best-practice to give every Website its own domain, Joomla! installation and database there can be special conditions in which a multi-site solution under a single Joomla! install is warranted.
-Although it's a best-practice to give every Website it's own domain, Joomla! installation and database there can be special conditions in which a multi-site solution under a single Joomla! install is warranted.
-Although this article is oriented toward developers working on a site with Linux and Apache, it should work for most of the popular web hosting configurations.
+==An Example Application==
-===Example of Conditions where This Multi-Site Solution Makes Sense===
+A small business, 'Johnson Candies', has two separate but related brands: ''Red Candy'' and ''Yellow Candy''. They require a single Joomla!-based Website where both candy types are visible, each with its own home page on the Joomla! site which corresponds to the domains ''www.redjohnsoncandy.com'' and ''www.yellowjohnsoncandy.com''.
-A small business 'Johnson Candies' has two separate but related brands; ''Red Candy'' and ''Yellow Candy''.  They require a single Joomla!-based Website where both candy types are visible, each with its own '''home page''' on the Joomla! site which corresponds to a given domain:
-http://www.redjohnsoncandy.com  (example only)
+Additionally, each brand and site '''requires its own design''': a yellow template for one; a red template, for the other.
-http://www.yellowjohnsoncandy.com (example only)
-−
-Additionally, each brand and site ''requires its own design'', a yellow template for one, a red template, for the other.
 ==Benefits==
-By including both brands into a single Joomla! web installation, Johnson Candies is able to save editing-time (only one login), to share articles and data across both brands (or mini-sites) and to use a single feature, such as a Contact Us form, for both brands.
+By including both brands in a single Joomla! web installation, Johnson Candies is able to save editing time (only one login), share articles and data across both brands (or sites) and use a single feature, such as a Contact Us form, for both brands.
-==Getting Started==
+==Implementation Procedure==
-===Step One: Prepare Your Domains===
+===Prepare Your Domains===
-Use a single domain for your hosting account, as normal. Park any additional domains on top of that account domain (as in cPanel). For the purpose of this tutorial, we will park ''redjohnsoncandy.com'' on top of the base ''yellowjohnsoncandy.com'' domain name.
+Use a single domain for your hosting account, as normal. Create the required add-on domains in the control panel of your hosting account. For the purpose of this tutorial, we will use ''www.redjohnsoncandy.com'' in addition to the base ''www.yellowjohnsoncandy.com'' domain name.
-===Step Two: Install and Setup Joomla! Normally===
+===Install and Setup Joomla!===
-Install and setup Joomla! normally.
+Install and setup Joomla! normally. Then develop articles, menus and modules for each site.
 ===Create Templates===
-Develop articles, menus and modules for each mini-site.
+Next develop and install the necessary templates - one for each site that you wish to have. In the above example, you would create a template for ''red candy'' named ''Red Template'' and a template for ''yellow candy'' named ''Yellow Template''. Once the templates are installed, assign them to the relevant menu items, using the Joomla! template manager in the Joomla! Administrator area.
-===Step Three: Create Templates===
+===Add a Redirect===
-Next develop and install (2+) templates to Joomla! - one for each 'mini-site' that you wish to have. In the above example, you would create a template for ''red candy'' named ''Red Template'' and a template for ''yellow candy'' named ''Yellow Template''. Once the templates are installed to the site, assign them to the relevant menu items, using the Joomla! template manager in the Joomla! Administrator area.
+====Option #1: Create an .htaccess (Apache) redirect====
-==Adding a Redirect==
 ===Option #1: Create an htaccess (Apache) redirect===
 '''Note''' ''Enable SEF URLs in Joomla! First''
-One option is to use htaccess (Apache) to redirect inquiries to a given domain to a specific Joomla! page.
+One option is to use .htaccess (Apache) to redirect inquiries to a given domain to a specific Joomla! page.
-Our goal is to redirect any inquries to the Red Candy domain name to a given page on the Joomla! site. In this example, we redirect any inquiries to redjohnsoncandy.com to a category-blog page. You would have previously assigned the 'red candy' template to this menu item, to create the illusion of a separate site.
+Our goal is to redirect any inquries to the Red Candy domain name to a given page on the Joomla! site. In this example, we redirect any inquiries to www.redjohnsoncandy.com to a category-blog page. You would have previously assigned the 'red candy' template to this menu item, to create the illusion of a separate site.
 <source lang='apache'>
 #The following rule works, but it changes which domain name displays.
@@ Line 34: / Line 27: @@
 RewriteRule ^(.*)$ http://www.yellowjohnsoncandy.com/index.php?option=com_content&view=category&layout=blog&id=3&Itemid=12 [R=301,L]
 </source>
-Well, that works - but you can see the drawback immediately. Although the user is successfully viewing the Red Candy site, they will still see the Yellow Candy domain name. Unfortunately, if you are using both htaccess and domain-parking (technically a redirect) - this is necessary in order to avoid creating a LOOP.
+Well, that works - but you can see the drawback immediately. Although the user is successfully viewing the Red Candy site, they will still see the Yellow Candy domain name. Unfortunately, if you are using both .htaccess and domain-parking (technically a redirect) - this is necessary in order to avoid creating a LOOP.
-===Option #2: Create a PHP Header Redirect===
+====Option #2: Create a PHP Header Redirect====
-This solution has the benefit of keeping the illusion of separate domains/web sites apparent to the visitor. Instead of using htaccess (Apache) for our redirect, we use one of the templates on the site.
+This solution has the benefit of keeping the illusion of separate domains/web sites apparent to the visitor. Instead of using .htaccess (Apache) for our redirect, we use one of the templates on the site.
-In this example, the base domain is redjohnsoncandy.com. You have created a template for that area named ''Red Template''. The trick is to open 'Red Template's' index.php file and add the following to the head area.
+In this example, the base domain is www.redjohnsoncandy.com. You have created a template for that area named ''Red Template''. The trick is to open 'Red Template's' index.php file and add the following to the head area.
 <source lang='php'>
 <?php
@@ Line 48: / Line 41: @@
 ?>
 </source>
-Here's the benefit: The visitor will now be redirected to the appropriate ''Red Site'' page, that has the ''Red Template'' assigned to it '''only''' in the case where they have arrived at the 'red site' domain name. Otherwise, the conditional PHP rule is ignored, and the base Yellow Site loads.
+Here's the benefit: The visitor will now be redirected to the appropriate ''Red Site'' page, that has the ''Red Template'' assigned to it '''only''' in the case where they have arrived at the 'red site' domain name. Otherwise, the conditional PHP rule is ignored, and the Yellow Site loads.
-==Summary==
-'''Please Note:'''
-This tip is only useful in specific circumstances.
 [[Category:Tips and tricks]]
 [[Category:Tips and tricks 1.5]]