暂无描述

Julio Montoya db5984db10 Fix lp item titles when is changed to HTML see BT#15259 5 年之前
.github b72f4689a5 Add links to official documentation to contribution documentation - refs #2705 5 年之前
app 122fa1ac7a Add missing proxy.php file see BT#16041 5 年之前
bin fa3b459314 Fix Fatal error Type json already exists. 7 年之前
certificates 7dd498e8b8 Minor - use api_not_allowed() 5 年之前
custompages 6283be4a45 Minor - Fix missing semi-column in embedded PHP, reported by flint-ci 6 年之前
documentation a909572c18 Update changelog - Prepare for 1.11.12 5 年之前
main db5984db10 Fix lp item titles when is changed to HTML see BT#15259 5 年之前
plugin 9076905d7c Minor - format code 5 年之前
src 35b95f560d Merge with 1.11.x 5 年之前
tests 4957ee3f87 Add forum URL fixes see BT#15056 5 年之前
.bowerrc 2f290e9e6f Add bower.json, remove assets calls in composer.json 8 年之前
.codeclimate.yml bd7c4ffc54 Minor - disabled phan 5 年之前
.editorconfig 4b03d5aedc Minor - update setting 7 年之前
.flintci.yml 7226f078d6 Update flint settings 6 年之前
.gitattributes 16b4c3b4fa Minor - add flintci in export ignore, restore scrutinizer changes 6 年之前
.gitignore 93887d8674 Don't ignore app/courses/proxy.php 5 年之前
.htaccess 52c77b30d0 Add "block_my_files_access" config see BT#15586 5 年之前
.php_cs a1cf751b2a Add CI files 6 年之前
.php_cs.dist e8d66fb6a9 Minor - remove duplicate "exclude" 5 年之前
.scrutinizer.yml 37de23a463 Minor - format code, update CI files 5 年之前
.travis.yml 43c6b80e92 Remove PHP 5.5 support 5 年之前
.yamllint_config 5c39182f81 Update .yamllint_config 6 年之前
CODE_OF_CONDUCT.md 47bfa1f572 Added code of conduct (contributor-covenant.org) 5 年之前
CONTRIBUTING.md b72f4689a5 Add links to official documentation to contribution documentation - refs #2705 5 年之前
LICENSE 0d054f1750 Rename LICENSE.md to LICENSE 6 年之前
README.md 654400398c Minor - replace php5 calls 6 年之前
apple-touch-icon.png a5cab353c0 update icon apple-touch-icon.png 5 年之前
bower.json c4db36c9ce Update bootstrap select to version 1.13.5 5 年之前
cli-config.php ecdc2037e2 Applied fixes from FlintCI 6 年之前
codesize.xml e49f7df6d1 Minor - update CI settings 6 年之前
composer.json 6db3dffdbb Update PHP version to 5.6 in composer.json 5 年之前
favicon.ico 4116a6b100 merge 10 年之前
index.php 35df0be356 Minor - remove session id 6 年之前
license.txt ff73e2fcc5 Update credits in license file and add LICENSE.md to test repository licensing 6 年之前
news_list.php ff35e68f59 Minor - format code + fix php warning 6 年之前
robots.txt 3c4c0e45d3 Update Disallow 6 年之前
user.php ecdc2037e2 Applied fixes from FlintCI 6 年之前
user_portal.php 67a59fe873 Minor - format code, remove logs 5 年之前
web.config 091a0689f1 Add web.config for IIS, as contributed by @ullfindsmit 6 年之前
whoisonline.php d400657bfa Fix who is online access not it will check chamilo settings 6 年之前
whoisonlinesession.php 4a57d5c754 Minor - flint fixes 6 年之前

README.md

Chamilo 1.11.x

Build Status Scrutinizer Code Quality Code Coverage Bountysource Code Consistency CII Best Practices Codacy Badge

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 apache2 mysql-server php libapache2-mod-php php-gd php-intl php-curl php-json php-mysql

Install Git

The development version 1.11.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.11.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.11
sudo chown -R `whoami` chamilo-1.11
git clone -b 1.11.x --single-branch https://github.com/chamilo/chamilo-lms.git chamilo-1.11

Checkout branch 1.11.x

cd chamilo-1.11
git checkout --track origin/1.11.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 web

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.10.x

1.11.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.10.x. As such, it is necessary to go through an upgrade procedure when upgrading from 1.10.x to 1.11.x.

The upgrade procedure is relatively straightforward. If you have a 1.10.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.11.x

Then load the Chamilo URL in your browser, adding "main/install/index.php" and follow the upgrade instructions. Select the "Upgrade from 1.10.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.11.x branch, go to your Chamilo folder and type:

git pull origin 1.11.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-tool: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://1.11.chamilo.org/documentation/index.html