Cocorico is an open source platform to create collaborative consumption marketplaces. You can find more information about this project on http://www.cocolabs.io.
This document contains information on how to download, install, and start using Cocorico.
- For Symfony 2.5.x, you need to use the 0.1.x release of the bundle
- For Symfony 2.8.x, you need to use the 0.2.x release of the bundle
Activate following modules:
- mod_headers
- mod_rewrite
Tested versions:
- php 5.4
- MongoDB 2.6.8, 3.0.3
Activate following extensions:
- apc (For php 5.5 use php native opcode cache)
- curl (>= 7.36)
- intl
- fileinfo
- openssl
- soap
- exif
- mongo
- imagick
- pdo_sqlite
Add the following lines to php.ini:
- curl.cainfo = "pathto/cacert.pem"
- xdebug.max_nesting_level = 1000
- memory_limit = 256M
- upload_max_filesize = 12M (as cocorico.user_img_max_upload_size)
- post_max_size = 13M
- [APC]
apc.enable_cli=Off
apc.enabled = 1
apc.shm_segments = 1
apc.shm_size = 64M
apc.max_file_size = 10M
apc.stat = 1
Set the same php timezone to php and php-cli php.ini file:
- date.timezone = UTC
- CREATE DATABASE IF NOT EXISTS {DB} DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
- GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES ON {DB}.* TO {DBUSER}@localhost IDENTIFIED BY '{DBUSERPWD}'
See http://docs.mongodb.org/manual/tutorial/install-mongodb-on-debian/?_ga=1.159299576.319082154.1425377029
See http://docs.mongodb.org/ecosystem/drivers/php/
On Windows:
bin\start-mongodb.bat "C:\Program Files\MongoDB\data"
On Linux:
See http://docs.mongodb.org/manual/tutorial/install-mongodb-on-debian/
Note:
Fork Cocorico Git Repository then get sources:
- Close all projects
- Menu > VCS > Checkout from VC > Git
- Git Repo: https://github.com/Cocolabs-SAS/cocorico.git
- Parent Dir: Choose parent of Symfony folder
- Dir name: Symfony
- Menu > File > Open: Symfony folder
- Change Project name
- Activate Symfony2 framework
- Configure automatically namespace root from Event log Dialog box for example
Change to your parent "Document Root" directory and clone repository:
cd /var/www/cocorico.dev/
git clone https://github.com/Cocolabs-SAS/cocorico.git Symfony
See https://www.microsoft.com/translator/getstarted.aspx
-
Go to https://developers.facebook.com/quickstarts/?platform=web
-
Click on "Skip quick start"
-
Click on "Settings" and fill in "App Domains" your domain name. (ex: xxx.com)
-
Click on "Add Platform" > "web site"
-
Fill in "Site URL" with your site url. (ex: https://www.xxx.com/)
-
Click on "save changes"
-
Click on "Advanced".
-
Fill in "Valid OAuth redirect URIs" with the urls for the concerned domain and the locales activated. Ex for xxx.com with "en" and "fr" as activated locales :
- https://www.xxx.com/en/oauth/fb-login - https://www.xxx.com/fr/oauth/fb-login -
Click on "Save changes"
-
You will then have to add your "Facebook App id" and "secret" in
cocorico.facebook.app_idandcocorico.facebook.secretparameters while composer install described in "Install Cocorico dependencies and set your application parameters" chapter below
If you don't have Composer yet, run the following command in the root folder of your Symfony project:
For Linux:
cd Symfony
curl -s http://getcomposer.org/installer | php
For Windows:
cd Symfony
php -r "readfile('https://getcomposer.org/installer');" | php
php composer.phar install
Or to speed up:
php composer.phar install --prefer-dist -vvv
Or in case of error with tarball (slower):
php composer.phar install --prefer-source -vvv
This command will ask you the values of some of your application parameters. You will find more informations on them in the following chapter.
See app/config/parameters.yml.dist
Copy and paste web/.htaccess.dist and rename it to web/.htaccess. (It's configured by default for dev environment).
For Linux:
chmod 744 bin/init-db
./bin/init-db php --env=dev
For Windows:
.\bin\init-db.bat --env=dev
For Linux:
chmod 744 bin/init-mongodb
./bin/init-mongodb php --env=dev
For Windows:
.\bin\init-mongodb.bat --env=dev
Before starting coding, make sure that your local system is properly configured for Cocorico.
Execute the check.php script to make sure that your local system is properly configured for Cocorico:
php app/check.php
The script returns a status code of 0 if all mandatory requirements are met, 1 otherwise.
Access the config.php script from a browser:
http://cocorico.dev/config.php
If you get any warnings or recommendations, fix them before moving on.
Check security dependencies:
bin/security-checker security:check composer.lock
php app/console assets:install --symlink web --env=dev
php app/console assetic:dump --env=dev
Congratulations! You're now ready to use Cocorico. http://cocorico.dev/
Admin access is here :
http://cocorico.dev/admin/dashboard
super-admin@cocorico.rocks
super-admin
Don't forget to Change your super-admin password.
Enjoy!
Cocorico follows the Semantic Versioning 2 as far as possible:
Given a version number MAJOR.MINOR.PATCH, increment the:
MAJOR version when you make incompatible API changes,
MINOR version when you add functionality in a backwards-compatible manner, and
PATCH version when you make backwards-compatible bug fixes.
CHANGELOG.md list the relevant changes done for each release.
Anyone and everyone is welcome to contribute. Please take a moment to review the guidelines for contributing.
ROADMAP list the planned features.
Cocorico is released under the MIT license.