Installation and Configuration

The following are required:

• PHP 5.4+
• Apache configured with .htaccess ( AllowOverride All )
• mod_headers and mod_rewrite enabled for Apache.

To enable mod_headers and mod_rewrite on Ubuntu, do the following

sudo a2enmod headers

sudo a2enmod rewrite

sudo service apache2 restart

Installation

Extract files into your folder. Modify .htaccess and set RewriteBase to your base directory. E.g.

RewriteBase /subfolder/ mostly for dev environments such as on xampp

or

RewriteBase / mostly for domains

Configuration

Tsama will show a setup screen when you first navigate to the extracted folder.

The /conf should be writable. A chmod of 777 should make it writable. NB: Once setup is complete you should set chmod of /conf to 555 and any configuration files therein to 444

Configuration examples are also found in the conf folder.

Manual Site Configuration

Duplicate the site.conf.xmpl.php file. Rename it to site.conf.php and modify as follows:

//Example site configuration. Rename file to site.conf.php for deployed configuration

$_TSAMA_CONFIG['NAME'] = 'Your Site Name';

$_TSAMA_CONFIG['LOGO'] = 'yourlogo.png';

$_TSAMA_CONFIG['COMPRESS'] = TRUE; //Compress output or not

$_TSAMA_CONFIG['HIDE_TSAMA'] = TRUE; //Hide tsama or not

$_TSAMA_CONFIG['THEME'] = 'yourtheme'; //Your theme name

$_TSAMA_CONFIG['LAYOUT'] = 'yourlayout'; //Your custom default layout

$_TSAMA_CONFIG['PRIMARY_DOMAIN'] = 'primary_domain'; //Primary domain (Localhost = Any Domain)

$_TSAMA_CONFIG['ALTERNATE_DOMAINS'] = 'domain1,domain2'; //Optional alternate domains separated by Comma(,)

$_TSAMA_CONFIG['LANGUAGE'] = 'en'; //Site Language

$_TSAMA_CONFIG['DEBUG'] = TRUE; //Show debug info or not.

?>

Database Configuration

Duplicate the db.conf.xmpl.php file. Rename it to db.conf.php and modify as follows:

//Example db configuration. Rename file to db.conf.php for deployed configuration

$_DB['Driver'] => 'mysql'; //database driver

$_DB['Host'] => 'localhost'; //database host

$_DB['Username'] => 'Username'; //database user

$_DB['Password'] => 'Password'; //databse password

$_DB['Name'] => 'Database_Name'; //database name

?>

Table of contents

Introduction

Installation and Configuration

Predefined Constants and Globals

Creating a Layout

Creating a Theme

Creating a Service

Configuring a Service