From Tlalokes

Contents 1 Requeriments 2 Download 3 Install 3.1 Framework 3.2 Application 3.3 Public area 3.4 Web Installer

Requeriments

• Apache web server with mod_rewrite.
• PHP 5.2.x or higher
• The following RDBMS are actually supported (you must have the right binary extension installed):
  • PostgreSQL
  • MySQL
  • SQLite
  • ODBC
  • Oracle
  • MS SQL Server

Download

Download the framework.

• The stable version is available from the Tlalokes's web site in ZIP or BZIP2.
• The development version is available from gitorious:

$ git clone http://git.gitorious.org/tlalokes/framework.git TlalokesFramework

Install

Before installing is important to know that Tlalokes distributes its work in three areas or directories: framework, application and public area.

Framework

Contains the Tlalokes files.

1. Uncompress the framework in your preferred location.
2. Structure.

example - Contains the example files that are needed in the public area of any site that uses the framework.
tlalokes - Contains the framework's core functions and classes.
lib - Contains the third party libraries used in the framework.
builders - Contains the PHP scripts used to generate application's code.

Application

This is the area where your application's code is located.

1. Create your application's directory naming it as you prefer, avoiding white spacing, using lower case and underscores instead.
2. If you are using some GNU/Linux distribution or any other operating system UNIX-like continue as follows:

If your are allowed to, assign the web server's user as the owner of your application's directory

# chown www-data application_directory

if your are not, change your permissions as follows

$ chmod 757 application_directory

Public area

Public area is the assigned directory in the web server's configuration to publish content, by example the htdocs in the Apache web server.

1. Create your public directory in your assigned web server's public area.
2. Copy in your recently created directory, the content of the example directory located in the framework's structure.
3. Open the index.php file
   1. Edit the three variables of the index.php file
      • $tlalokes. Set the current absolute path of the framework.
      • $application. Set the current absolute path of your application.
      • $uri. Set the relative path of your web site. Example: /your_site/
   2. Save the file.
4. Open your web site's relative path in your web browser. Firefox is highly recommended Mozilla Firefox.

Web Installer

Once loaded your web site in the web browser you can use the Tlaloke's installer:

1. License. Read carefully the license, and only if you agree with it's terms, accept them by clicking the Accept button.
2. Essential configuration.
   1. Key or application's password. Set your application's configuration key and confirm it. This key will allow you to execute the builders.
   2. Database. If your application will connect to a database, activate this configuration area and set the form' required data, such as the RDBMS, host name, database name, username and password.
   3. Finally click the Save button.
3. If everything is OK, the basic structure of your application will be generated, at that moment you can start to manually configure your application.