sterivein/Readme.md

Readme

Thelia

Thelia is an open source tool for creating e-business websites and managing online content. This software is published under GPL.

Here is the most recent developed code for the next major version (v2). You can download this version for testing or having a look on the code (or anything you wish, respecting GPL). See http://thelia.net/v2 web site for more information.

Most part of the code can possibly change, a large part will be refactor soon, graphical setup does not exist yet.

Requirements

• php 5.4
  • Required extensions :
    • PDO_Mysql
    • mcrypt
    • intl
    • gd
    • curl
  • safe_mode off
  • memory_limit at least 128M, preferably 256.
  • post_max_size 20M
  • upload_max_filesize 2M
• apache 2
• mysql 5

If you use Mac OSX, it still doesn't use php 5.4 as default php version... There are many solutions for you :

• use phpbrew
• use last MAMP version and put the php bin directory in your path:

export PATH=/Applications/MAMP/bin/php/php5.4.x/bin/:$PATH

• configure a complete development environment : http://php-osx.liip.ch/
• use a virtual machine with vagrant and puppet : https://puphpet.com/

As of MySQL 5.6, default configuration sets the sql_mode value to

STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION

This 'STRICT_TRANS_TABLES' configuration results in SQL errors when no default value is defined on NOT NULL columns and the value is empty or invalid.

You can edit this default config in /etc/my.cnf and change the sql_mode to remove the STRICT_TRANS_TABLES part

[mysqld]
sql_mode=NO_ENGINE_SUBSTITUTION

Assuming your sql_mode is the default one, you can change the value directly on the run by running the following SQL Command

SET @@GLOBAL.sql_mode='NO_ENGINE_SUBSTITUTION', @@SESSION.sql_mode='NO_ENGINE_SUBSTITUTION'

Installation

$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar create-project thelia/thelia path/ 2.0.0-RC1

Finish the installation using cli tools :

$ php Thelia thelia:install

You just have to follow all instructions.

Documentation

Thelia documentation is available at http://doc.thelia.net

The documentation is also in beta version and some part can be obsolete cause to some refactor.

Contribute

see the documentation : http://doc.thelia.net/en/documentation/contribute.html

Usage

Consult the page : http://localhost/thelia/web/index_dev.php

You can create a virtual host and choose web folder for root directory.

To run tests (phpunit required) :

$ phpunit

We still have lot of work to achieve but enjoy this part.