This repository provides the basic application structure of the Claroline platform. It doesn't contain the sources nor the third-party libraries required to make the application fully functional. Those sources have to be installed following the procedure described below.
If you want to contribute or directly browse the sources of the project, here is a (non-exhaustive) list of their dedicated repositories:
- CoreBundle
- KernelBundle
- InstallationBundle
- MigrationBundle
- ForumBundle
- AnnouncementBundle
- RssReaderBundle
- ...
- PHP >= 5.4.1
- PHP extensions:
- A RDBMS like MySQL (>=5.0, recommended) or PostgreSQL (>= 8.0)
- A web server like Apache or Nginx
- A global installation of composer (for dependency management)
- Clone this repository
- Create an app/config/parameters.yml file based on app/config/parameters.yml.dist and fill at least the main db parameters (database doesn't have to exist, but if it exists, it must be empty)
- Make the following directories (and their children) writable from the command
line and the web server (for further explanation on common permissions issues and
solutions with Symfony2, read this):
- app/cache
- app/logs
- app/config
- files
- templates
- test
- web/uploads
- web/themes
- web/thumbnails
- Run the following commands:
$ composer require claroline/bundle-recorder "~2.1"
$ cp composer.dist.json composer.json
$ composer update --prefer-source
$ php app/console claroline:update
$ php app/console claroline:refresh
You can then create a first admin user with:
$ php app/console claroline:user:create -a
The application is accessible in your browser via:
- [site]/web/app_dev.php (development environment)
- [site]/web/app.php (production environment)
To update your installation to the last stable state, use:
$ composer update --prefer-source
$ php app/console claroline:update
$ php app/console claroline:refresh
You can install or uninstall a plugin by adding or removing the package in the require section of your composer.json and running:
$ composer update vendor/plugin-name
If the plugin package is already present in your project and if you simply want to install or uninstall it locally, you can use one the following commands:
$ php app/console claroline:plugin:install FooBarBundle
$ php app/console claroline:plugin:uninstall FooBarBundle
In order to run the test suite you must have phpunit installed on your system.
Run the complete test suite with:
$ phpunit -c app
Run the tests for a single directory with:
$ phpunit -c app src/core/Claroline/CoreBundle
The app/build/tools directory gathers configuration files for various analysis and build tools (PHPMD, PHPCS, JSHint, Ant, etc.).
You can install and use them locally (see their respective documentation for usage) or visit our continuous integration server here.
For development documentation, see Claroline/CoreBundle/Resources/doc/index.md.