Readme

Thelia

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

This is the new major version of Thelia.

You can download this version and have a try or take a look at the source code (or anything you wish, respecting LGPL). See http://thelia.net/ web site for more information.

A repository containing all thelia modules is available at this address : https://github.com/thelia-modules

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.5.x/bin/:$PATH

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

MySQL 5.6

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'

For more information on sql_mode you can consult the MySQL doc

Archive builders

Thelia's archive builder's needs external libraries. For zip archives, you need PECL zip. See PHP Doc

For tar archives, you need PECL phar. Moreover, you need to deactivate php.ini option "phar.readonly":

phar.readonly = Off

For tar.bz2 archives, you need tar's dependencies and the extension "bzip2". See PHP Doc

For tar.gz archives, you need tar's dependencies and the extension "zlib". See PHP Doc

Download Thelia 2 and install its dependencies

You can get the sources from git and then let composer install dependencies, or use composer to install the whole thelia project into a specific directory

Using git for download and composer for dependencies

$ git clone --recursive https://github.com/thelia/thelia path
$ cd path
$ git checkout 2.0.3
$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar install

Using composer for both download and dependencies

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

Install it

You can install Thelia by two different way

Using install wizard

Installing thelia with the web install wizard allow to create an administrator, add some informations about your shop, etc

First of all, you have to configure a vhost as describe in configuration section.

The install wizard in accessible with your favorite browser :

http://yourdomain.tld/[/subdomain_if_needed]/install

For example, I have thelia downloaded at http://thelia.net and my vhost is correctly configured, I have to reach this address :

http://thelia.net/install

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.

Roadmap

The Roadmap is available at http://thelia.net/community/roadmap

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.