Difference between revisions of "Add Site"

From TMM Wiki
Jump to navigationJump to search
Line 3: Line 3:
 
}}
 
}}
  
The following steps explain how to setup a CARMA-managed site.
+
Each installation of CARMA has the ability to have multiple member and tour sites. Adding a new site to CARMA involves configuring your server so that accessing your domain will call up the scripts in either ''carma/site_scripts/'' or ''carma/tour_scripts'' and setting up the site in CARMA's Sites Admin.
  
Create a symbolic link from CARMA's files in site_scripts to the
 
document root of the members area of the site. To manage tours with
 
CARMA, create a symbolic link from CARMA's files in tour_scripts
 
to the document root of the site tour.
 
  
== Example ==
+
== Script Setup ==
 +
There are two primary ways you can setup your server so that multiple domains can access the same CARMA files.
 +
 
 +
=== Document Roots ===
 +
The easiest way to point your domain to set the domain's document root to ''carma/site_scripts/'' or ''carma/tour_scripts''.  Since you can only set the document root one folder your will either want a separate hostname for tour and members scripts or set it up for the tour scripts and then create a symbolic link called ''members'' to ''carma/site_scripts/''. 
 +
 
 +
There are some other limitations with this method.  The biggest one would be authentication.  If all your domains are set up to use the same directory as the document root then this could complicate your member's authentication, particularly with ''.htaccess' files.
 +
 
 +
=== Symbolic Link ===
 +
In order to have separate directories for each sites authentication, images, and css content you can set your domains up the normal way and then set up a hard or symbolic to files in ''carma/site_scripts/''.  This would allow you to retain the normal separation of site data and still allow all sites to access the same content.
 +
 
 +
==== Example ====
 
<pre>
 
<pre>
 
cd /path/to/site/document/root
 
cd /path/to/site/document/root
Line 16: Line 23:
 
</pre>
 
</pre>
  
Set up the site in the CARMA [[Sites Admin]].
+
 
 +
== Sites Admin ==
 +
 
 +
Click on ''Site'' from the main menu (there will be a globe icon next to it) to get to the Sites Admin.  To add the site fill in your new site's name in the blank field at the bottom left of the table.  Then click the ''Add'' button on the bottom right of the table.  After hitting the ''Add'' button you will be asked to fill in the other fields. 
 +
 
 +
* Publish Mode
 +
** You can select a different publish mode for both Tours' and Members' sections.  The publish mode controls how the content on the site is rotated.  All content is initially scheduled to your sites in the same way, based on date, but it will be displayed on the sites based on the publish modes interpretation of that date. For more information on this feature please refer to [[Publish Mode]] documentation.
 +
* Hostname
 +
** This is where you enter the hostname for the Tour and Members sections.  If your hostname is not correct then carma will not identify your site correctly.  The hostname is how the scripts in carma know what site to load up.  Each site has to have its own hostname.  The member and tour hostnames can be the same or the can be different, it depends on your setup.  The hostname does not include ''http://'' or the path to the content.  For example:
 +
*** If your members content was located at ''http://yoursite.com/members'' you would just enter ''yoursite.com''
 +
*** If your members site was located at http://members.yoursite.com/ you would enter ''members.yoursite.com''.
 +
** URLs
 +
Here you want to enter in the base URL to the Tour and Members site.  This have to include ''http://'' and should contain the entire path to the base directory of the section.  Such as  http://yoursite.com/members
 +
* Caching
 +
** Here you can choose to turn caching on or off.  Caching will greatly improve the performance of your server.  When you are in the process of developing a new site, it can be beneficial to have caching turned off so you can immediately see your changes.  However it is strongly recommended that you have it on for a production site.

Revision as of 11:56, 5 February 2009

CARMA
Setup
Setting Up CARMA
MySQL Settings
Add Site
Porting Sites to CARMA
Moving CARMA

Each installation of CARMA has the ability to have multiple member and tour sites. Adding a new site to CARMA involves configuring your server so that accessing your domain will call up the scripts in either carma/site_scripts/ or carma/tour_scripts and setting up the site in CARMA's Sites Admin.


Script Setup

There are two primary ways you can setup your server so that multiple domains can access the same CARMA files.

Document Roots

The easiest way to point your domain to set the domain's document root to carma/site_scripts/ or carma/tour_scripts. Since you can only set the document root one folder your will either want a separate hostname for tour and members scripts or set it up for the tour scripts and then create a symbolic link called members to carma/site_scripts/.

There are some other limitations with this method. The biggest one would be authentication. If all your domains are set up to use the same directory as the document root then this could complicate your member's authentication, particularly with .htaccess' files.

Symbolic Link

In order to have separate directories for each sites authentication, images, and css content you can set your domains up the normal way and then set up a hard or symbolic to files in carma/site_scripts/. This would allow you to retain the normal separation of site data and still allow all sites to access the same content.

Example

cd /path/to/site/document/root
ln -s /path/to/carma/site_scripts/* ./


Sites Admin

Click on Site from the main menu (there will be a globe icon next to it) to get to the Sites Admin. To add the site fill in your new site's name in the blank field at the bottom left of the table. Then click the Add button on the bottom right of the table. After hitting the Add button you will be asked to fill in the other fields.

  • Publish Mode
    • You can select a different publish mode for both Tours' and Members' sections. The publish mode controls how the content on the site is rotated. All content is initially scheduled to your sites in the same way, based on date, but it will be displayed on the sites based on the publish modes interpretation of that date. For more information on this feature please refer to Publish Mode documentation.
  • Hostname
    • This is where you enter the hostname for the Tour and Members sections. If your hostname is not correct then carma will not identify your site correctly. The hostname is how the scripts in carma know what site to load up. Each site has to have its own hostname. The member and tour hostnames can be the same or the can be different, it depends on your setup. The hostname does not include http:// or the path to the content. For example:
    • URLs

Here you want to enter in the base URL to the Tour and Members site. This have to include http:// and should contain the entire path to the base directory of the section. Such as http://yoursite.com/members

  • Caching
    • Here you can choose to turn caching on or off. Caching will greatly improve the performance of your server. When you are in the process of developing a new site, it can be beneficial to have caching turned off so you can immediately see your changes. However it is strongly recommended that you have it on for a production site.