No Description

Yannick Warnier dda2dc532f Add local server changes all at once 8 years ago
app dda2dc532f Add local server changes all at once 8 years ago
bin 3d24dc0ae3 Adding doctrine cli, to generate migrations, create/update schema. 9 years ago
certificates aa6364a738 Minor - format code. 9 years ago
custompages baba1a056e Format code. 9 years ago
documentation c169d7fcac Attempt at Nginx and Apache config examples in installation guide (Spanish only for now). Still presenting issues with file uploads under Nginx - refs BT#10045 9 years ago
main dda2dc532f Add local server changes all at once 8 years ago
plugin dda2dc532f Add local server changes all at once 8 years ago
src c9acd1f54a Add class method for get user from course by status - refs #7768 9 years ago
tests f3518fc502 Rename function, fix variables 9 years ago
.gitattributes e8cf17bfed Minor - updating .gitattributes .gitignore 9 years ago
.gitignore c73bbbc449 Replace css files from main/css to app/Resources/public/css see #7522 9 years ago
.htaccess a7f2c5f677 Add RewriteRule to get files in course directories - refs BT#10175 9 years ago
.scrutinizer.yml 7e580a87ce Changing paths see #7522 9 years ago
.travis.yml 19f42c313d Update README and travis.yml about version of assets require process 9 years ago
404.php d575fa47a3 Move survey, gradebook, wiki, learnpath, tracking, document, exercice, help and admin language files to trad4all - refs #4467 9 years ago
CONTRIBUTING.md a1429e93dc Add section about testing with Docker in CONTRIBUTING.md 9 years ago
README.md e1be9c9864 Update fxp version requirement in README 9 years ago
apple-touch-icon.png 4116a6b100 merge 10 years ago
cli-config.php 5aee71c6f9 Add migrations.yml in order to call correctly migrations command lines. 9 years ago
composer.json 5331084f62 Add mathajax lib see #7792 9 years ago
favicon.ico 4116a6b100 merge 10 years ago
index.php a5fdc99fca Additional fix to prevent useless redirection in SSO for Drupal - refs BT#10145 9 years ago
license.txt 4116a6b100 merge 10 years ago
news_list.php 608f9a6b60 Format code, remove require_once 9 years ago
robots.txt f36a285e11 Move searchdb inside app/upload/plugins/xapian/searchdb 9 years ago
user.php 608f9a6b60 Format code, remove require_once 9 years ago
user_portal.php a9d9df7654 Remove require 9 years ago
webchatdeny.php 652c6ecf19 Move index language file to trad4all - refs #4467 9 years ago
whoisonline.php 3837899029 Format code. 9 years ago
whoisonlinesession.php 0fe954e854 Switch all session.date_start and date_end to session.access_start_date and access_end_date - refs #7719 9 years ago

README.md

Chamilo 1.10.x

Build Status Scrutinizer Code Quality Code Coverage Bountysource

Installation

This installation guide is for development environments only.

Install PHP, a web server and MySQL/MariaDB

To run Chamilo, you will need at least a web server (we recommend Apache2 for commodity reasons), a database server (we recommend MariaDB but will explain MySQL for commodity reasons) and a PHP interpreter (and a series of libraries for it). If you are working on a Debian-based system (Debian, Ubuntu, Mint, etc), just type

sudo apt-get install libapache2-mod-php mysql-server php5-gd php5-intl php5-curl php5-json

Install Git

The development version 1.10.x requires you to have Git installed. If you are working on a Debian-based system (Debian, Ubuntu, Mint, etc), just type

sudo apt-get install git

Install Composer

To run the development version 1.10.x, you need Composer, a libraries dependency management system that will update all the libraries you need for Chamilo to the latest available version.

Make sure you have Composer installed. If you do, you should be able to launch "composer" on the command line and have the inline help of composer show a few subcommands. If you don't, please follow the installation guide at https://getcomposer.org/download/

Download Chamilo from GitHub

Clone the repository

sudo mkdir chamilo-1.10
sudo chown -R `whoami` chamilo-1.10
git clone -b 1.10.x --single-branch https://github.com/chamilo/chamilo-lms.git chamilo-1.10

Checkout branch 1.10.x

cd chamilo-1.10
git checkout --track origin/1.10.x
git config --global push.default current

Update dependencies using Composer

From the Chamilo folder (in which you should be now if you followed the previous steps), launch:

composer global require "fxp/composer-asset-plugin:1.0.3"
composer update

Change permissions

On a Debian-based system, launch:

sudo chown -R www-data:www-data app main/default_course_document/images main/lang  

Start the installer

In your browser, load the Chamilo URL. You should be automatically redirected to the installer. If not, add the "main/install/index.php" suffix manually in your browser address bar. The rest should be a matter of simple OK > Next > OK > Next...

Upgrade from 1.9.x

1.10.x is a major version. As such, it contains a series of new features, that also mean a series of new database changes in regards with versions 1.9.x. As such, it is necessary to go through an upgrade procedure when upgrading from 1.9.x to 1.10.x.

Although 1.10.x is not beta yet (and as such is NOT ready for production and does NOT contain all database changes yet - DO NOT UPGRADE A PRODUCTION SYSTEM to 1.10.x yet, PLEASE!), the upgrade procedure works to get you up and running with the latest development code of 1.10.x with data from an 1.9.x system, so feel free to test it out, but keep a backup of your database from 1.9.x as you will need to do the upgrade again each time you are updating the 1.10.x code from Git.

The upgrade procedure is relatively straightforward. If you have a 1.9.x initially installed with Git, here are the steps you should follow (considering you are already inside the Chamilo folder):

git fetch --all
git checkout origin 1.10.x

Then load the Chamilo URL in your browser, adding "main/install/index.php" and follow the upgrade instructions. Select the "Upgrade from 1.9.x" button to proceed.

For developers and testers only

This section is for developers only (or for people who have a good reason to use a development version of Chamilo), in the sense that other people will not need to update their Chamilo portal as described here.

Updating code

To update your code with the latest developments in the 1.10.x branch, go to your Chamilo folder and type:

git pull origin 1.10.x

If you have made customizations to your code before the update, you will have two options:

  • abandon your changes (use "git stash" to do that)
  • commit your changes locally and merge (use "git commit" and then "git pull")

You are supposed to have a reasonable understanding of Git in order to use Chamilo as a developer, so if you feel lost, please check the Git manual first: http://git-scm.com/documentation

Updating your database from new code

Since the 2015-05-27, Chamilo offers the possibility to make partial database upgrades through Doctrine migrations.

To update your database to the latest version, go to your Chamilo root folder and type

php bin/doctrine.php migrations:migrate --configuration=app/config/migrations.yml

If you want to proceed with a single migration "step" (the steps reside in src/Chamilo/CoreBundle/Migrations/Schema/V110/), then check the datetime of the version and type the following (assuming you want to execute Version20150527120703)

php bin/doctrine.php migrations:execute 20150527120703 --up --configuration=app/config/migrations.yml

Contributing

If you want to submit new features or patches to Chamilo, please follow the Github contribution guide https://guides.github.com/activities/contributing-to-open-source/ and our CONTRIBUTING.md file. In short, we ask you to send us Pull Requests based on a branch that you create with this purpose into your repository forked from the original Chamilo repository.

Documentation

For more information on Chamilo, visit https://stable.chamilo.org/documentation