Fără Descriere

Angel Fernando Quiroz Campos 52e3a414bf Fix export gradebook results to docx - refs #8218 8 ani în urmă
app e79d2fc2bf Revert "Fix issue setting PRIMARY KEY to possible NULL in migration from 1.9 to 1.10 - refs CT#8200" 8 ani în urmă
bin 3d24dc0ae3 Adding doctrine cli, to generate migrations, create/update schema. 9 ani în urmă
certificates aa6364a738 Minor - format code. 9 ani în urmă
custompages b402c0f3f1 Fix auth/inscription.php url see #8221 8 ani în urmă
documentation 91ebd4677b Add section about PHP limits to optimization guide - refs CT#8225 8 ani în urmă
main 52e3a414bf Fix export gradebook results to docx - refs #8218 8 ani în urmă
plugin 6ee2856479 Minor - format code, update comments 8 ani în urmă
src 12c7e7eccb Use custom CKEditor - refs #8175 9 ani în urmă
tests 123d3dc396 Remove unused function 8 ani în urmă
.bowerrc 2f290e9e6f Add bower.json, remove assets calls in composer.json 9 ani în urmă
.gitattributes e8cf17bfed Minor - updating .gitattributes .gitignore 10 ani în urmă
.gitignore c73bbbc449 Replace css files from main/css to app/Resources/public/css see #7522 10 ani în urmă
.htaccess 7eff7b8c25 fix course access with no final '/' in URL -refs CT#7976 9 ani în urmă
.scrutinizer.yml 61870687f6 Remove fxp from scrutinizer config 9 ani în urmă
.travis.yml ce73dd169b Disable testing in PHP 5.4 for now - Added a comment line 9 ani în urmă
404.php d575fa47a3 Move survey, gradebook, wiki, learnpath, tracking, document, exercice, help and admin language files to trad4all - refs #4467 10 ani în urmă
CONTRIBUTING.md 19f48187a6 Fix jQuery path issues again after finding the real problem behind the two different versions downloaded between two servers. See 338595984c9d07ff778ef0a4c867d543d5b7d53a for the initial (reverse) fix 9 ani în urmă
README.md c36a9c3088 Add info to README about upgrading Chamilo to Git-based from a package-based installation 9 ani în urmă
apple-touch-icon.png 4116a6b100 merge 10 ani în urmă
cli-config.php 5aee71c6f9 Add migrations.yml in order to call correctly migrations command lines. 9 ani în urmă
composer.json 7b00cc61c2 Require PHPWord - refs #8218 8 ani în urmă
favicon.ico 4116a6b100 merge 10 ani în urmă
index.php 69a9d25c07 Minor - Code style and NOTICE avoidance - refs CT#7909 9 ani în urmă
license.txt 4116a6b100 merge 10 ani în urmă
news_list.php 608f9a6b60 Format code, remove require_once 10 ani în urmă
robots.txt f36a285e11 Move searchdb inside app/upload/plugins/xapian/searchdb 10 ani în urmă
user.php 608f9a6b60 Format code, remove require_once 10 ani în urmă
user_portal.php f8e8ec98a2 Fix twig view 8 ani în urmă
webchatdeny.php 652c6ecf19 Move index language file to trad4all - refs #4467 10 ani în urmă
whoisonline.php 4543a909f3 Fix whoisonline 9 ani în urmă
whoisonlinesession.php 0fe954e854 Switch all session.date_start and date_end to session.access_start_date and access_end_date - refs #7719 9 ani în urmă

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 update

If you face issues related to missing JS libraries, you might need to ensure that your web/assets folder is completely re-generated. Use this set of commands to do that:

rm composer.lock
rm -rf web/ vendor/
composer clear-cache
composer update

This will take several minutes in the best case scenario, but should definitely generate the missing files.

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.0 is a major version. 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.

When we published 1.10.0, we didn't catch a series of important upgrade errors. We released a warning a few days later asking people not to upgrade from 1.9.x to 1.10.0 for the time being. Version 1.10.2 fixed that, and you can now safely upgrade from any 1.9.x version to any 1.10.x version higher than 1.10.0.

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.

If you have previously updated database rows manually, you might face issue with FOREIGN KEYS during the upgrade process. Please make sure your database is consistent before upgrading. This usually means making sure that you have to delete rows from tables referring to rows which have been deleted from the user or access_url tables. Typically:

DELETE FROM access_url_rel_course WHERE access_url_id NOT IN (SELECT id FROM access_url);

Upgrading from non-Git Chamilo 1.10

In the very unlikely case of upgrading a "normal" Chamilo 1.10 installation (done with the downloadable zip package) to a Git-based installation, make sure you delete the contents of a few folders first. These folders are re-generated later by the composer update command. This is likely to increase the downtime of your Chamilo portal of a few additional minutes (plan for 10 minutes on a reasonnable internet connection).

rm composer.lock
rm -rf web/*
rm -rf vendor/*

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

You can also print the differences between your database and what it should be by issuing the following command from the Chamilo base folder:

php bin/doctrine.php orm:schema:update --dump-sql

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