Skip to content
This repository was archived by the owner on Mar 29, 2023. It is now read-only.

Installation and Configuration

Jump to bottom
Johan Strydom edited this page Aug 5, 2021 · 4 revisions

The following are required for Tsama to work properly:

  • PHP (preferably v8+ but should work on older versions as well)
  • Apache configured with .htaccess ( AllowOverride All )
  • mod_headers and mod_rewrite enabled for Apache.
  • A Database like MariaDB (MySql). Install server and client with secure installation

Example VirtualHost Apache config

<VirtualHost *:80>
        ServerName tsama.local
        ServerAdmin webmaster@localhost
        DocumentRoot /var/www/html/tsama.local/Tsama/src/php

        ErrorLog ${APACHE_LOG_DIR}/tsama.local-error.log
        CustomLog ${APACHE_LOG_DIR}/tsama.local-access.log combined
        <Directory /var/www/html/tsama.local/Tsama/src/php>
            Options Indexes FollowSymLinks MultiViews
            AllowOverride All
            Require all granted
        </Directory>
</VirtualHost>

How to enable mod_headers and mod_rewrite

To enable mod_headers and mod_rewrite on Ubuntu, do the following

sudo a2enmod headers

sudo a2enmod rewrite

sudo service apache2 restart

Tsama Installation

Extract or Clone the files into your website root folder.

You should see a folder and file structure as follows:

conf
content
core
services
.htaccess
favicon.ico
index.php
server.php

The conf folder contains the main site and database configs for your website. You will have to edit it in order to configure your site.

The content folder is where you will add your custom content such as forms, media such as images, navigations for catalogs, article catalogs, themes and layouts reside.

The core folder contains the core services and should only be by advanced developers.

The services folder is where the page and navigation services are. This is also where developers will place their own custom services.

.htaccess is used by apache for mod_rewrite

index.php load the Tsama framework and is the default entry point for your website. It should also not be touched.

server.php load most of the global variuables available for php and Tsama. It should also not be touched.

How to change .htacess for your environment

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

NEXT » Configuring your website «

Clone this wiki locally