Installation


Installing the engine is a quick and painless process. To run the engine all you need is a server running PHP 5 and a MySQL database.

Steps


To install you will need to:

  • 1: Upload TextSide to your Server

  • 2: Update the Configuration File

  • 3: Update .htaccess File (only needed if running in subfolder/subfolder)



Step 1: Upload TextSide to your Server


The TextSide release will have 3 main folders: config, site, and core. You will need to upload all three of these folders to your server using the FTP Client of your choice.

If you intend to use TextSide for your entire site (Example: www.textside.com) , you will upload all 3 folders to your webserver's root directory. If you intend to use TextSide in subfolder or subdomain only (Example: www.mysite.com/test or test.mysite.com) you will need to create the desired subfolder and upload all 3 folders to it. Note that if you run the engine in a subfolder, you will need to do step 3 as well


Step 2: Update the Configuration File


The next step is to update the Engine's configuration file. Here you must provide some basic information about your server and the database in order for TextSide to work.

You can find the configuration file at config\config.php. Opening this file on your computer, you'll want to change 4 main values for now: SiteRoot, DatabaseName, DatabaseUsername, and DatabasePassword. After you've updated this file, go ahead and upload it to your server. 


<?php
//The root of the website that the Engine is being run on.
//If you are running it in a subdomain, it might look like: http://subdomain.textside.com/
//If you are running it in a subfolder, it might look like: http://www.textside.com/subfolder/
$GLOBALS["SiteRoot"]              = "http://www.textside.com/";

//The name of the database to connect to. The Engine will use this to store information 
$GLOBALS["DatabaseName"]          = "database_name";

//The name of a user who has access to the database
$GLOBALS["DatabaseUsername"]      = "username";

//The password to access the database
$GLOBALS["DatabasePassword"]      = "password";

?>

Step 3 Update .htaccess File


Note: You only need to do this step if you are running the site in a subdomain or subfolder
If you are running the Engine in your site root, you can skip this step.

You will need to open up the .htaccess file at: site\webroot\.htaccess.

At the top of the file you will see:

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /    
    ...
    ...
</IfModule>

Change "RewriteBase /" to show the subfolder that the engine was placed in. For example, if you placed it in http://www.textside.com/mysubsite you would would change it to "RewriteBase /mysubsite/"


Enjoy!


The Engine is now setup and ready to go. Just browse to your site and the TextiSide Engine will automatically set itself up and welcome you.

Next: Creating a Page