112 lines
3.3 KiB
Markdown
112 lines
3.3 KiB
Markdown
Readme
|
|
======
|
|
|
|
Thelia
|
|
------
|
|
[](https://travis-ci.org/thelia/thelia) [](https://packagist.org/packages/thelia/thelia) [](https://scrutinizer-ci.com/g/thelia/thelia/)
|
|
|
|
[Thelia](http://thelia.net/v2) 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](https://github.com/c9s/phpbrew)
|
|
* use last MAMP version and put the php bin directory in your path:
|
|
|
|
```bash
|
|
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/
|
|
|
|
### 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
|
|
|
|
```sql
|
|
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](http://dev.mysql.com/doc/refman/5.0/fr/server-sql-mode.html "sql Mode")
|
|
|
|
Installation
|
|
------------
|
|
|
|
``` bash
|
|
$ 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 :
|
|
|
|
``` bash
|
|
$ 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) :
|
|
|
|
``` bash
|
|
$ phpunit
|
|
```
|
|
|
|
We still have lot of work to achieve but enjoy this part.
|
|
|