No Description

Julio Montoya 34b84cced9 Update symfony configuration 5 years ago
.github 761e9bf526 Add support information as per Github recommendations 6 years ago
assets 02921e34bf Fix sass image paths 5 years ago
bin c4cc6f7fd2 Use bin/console doctrine:schema 7 years ago
certificates 194c5ae446 Minor - update from 1.11.x 6 years ago
config 34b84cced9 Update symfony configuration 5 years ago
custompages 5754a14dc9 Applied fixes from FlintCI 7 years ago
documentation 6ed802b07f Fix .htaccess rule + update installation guide #2707 6 years ago
main 34b84cced9 Update symfony configuration 5 years ago
plugin 562606f618 Minor - merge from 1.11.x 5 years ago
public 34b84cced9 Update symfony configuration 5 years ago
src 5e4dd33398 Minor - update from 1.11.x 5 years ago
templates 0c6d0a5d60 fix login.html.twig 6 years ago
tests 3693bdf9ad Merge branch 'master' of github.com:chamilo/chamilo-lms 5 years ago
translations b35e01b61f Fix installation process 6 years ago
var bdb7fb3880 Minor - add .gitkeep in var/courses and var/upload 7 years ago
.codeclimate.yml f36cf60988 Remove unused config settings #2682 6 years ago
.editorconfig 4b03d5aedc Minor - update setting 7 years ago
.env 34b84cced9 Update symfony configuration 5 years ago
.env.test 34b84cced9 Update symfony configuration 5 years ago
.flintci.yml 26ea363388 Minor - fix CI path 6 years ago
.gitattributes 6038583004 Ignore files from web 7 years ago
.gitignore 34b84cced9 Update symfony configuration 5 years ago
.htaccess 34b84cced9 Update symfony configuration 5 years ago
.php_cs 12e4f6f958 Add CI files 7 years ago
.php_cs.dist 86ae289083 Fix code related to from main/default_course_document/ 6 years ago
.scrutinizer.yml edbd849ee7 Minor - update CI config files 6 years ago
.travis.yml 568d8b5eb5 Update php version to 7.2, add html sanitizer 5 years ago
.yamllint_config 79fca38f9b Minor - Ignore files in CI 7 years ago
CODE_OF_CONDUCT.md ec24504e9f Added code of conduct (contributor-covenant.org) 6 years ago
CONTRIBUTING.md 2d55481225 Minor - Format code, update docs, update tpls, remove comment 6 years ago
LICENSE 7611bf5ac9 Add LICENSE 6 years ago
README.md 317c97846f Update README.md 5 years ago
apple-touch-icon.png 4116a6b100 merge 10 years ago
composer.json 9127231218 Minor - update composer.json 5 years ago
index.php f5358a3e42 Minor - update from 1.11.x 6 years ago
license.txt cac83af385 Minor - partial merge with 1.11.x 6 years ago
package.json 02921e34bf Fix sass image paths 5 years ago
robots.txt 2eae6d6b60 Minor - update robots.txt 6 years ago
ruleset.xml 728a0a507c Minor - rename CI file, flint fixes 6 years ago
user_portal.php 7526aa89dc Minor -flint fixes 6 years ago
webpack.config.js 37857261e6 WIP: Fix js error in LP view 5 years ago
whoisonline.php 1870737398 fix block avatar social -ref #2681 6 years ago
whoisonlinesession.php cac83af385 Minor - partial merge with 1.11.x 6 years ago
yarn.lock 02921e34bf Fix sass image paths 5 years ago

README.md

Chamilo 2.x

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

Chamilo is an e-learning platform, also called "LMS" or "LCMS" published under GNU/GPLv3+. It is or has been used by more than 20M people worldwide.

Quick install

Chamilo 2.0 is still in development stage. This install procedure is for reference only. For a stable Chamilo, please install Chamilo 1.11.x. See the 1.11.x branch README.md for details.

We assume you have already installed "yarn" and "composer" and you're installing the portal in a domain, not in a sub folder inside a domain.

# on a fresh Ubuntu, you can prepare your server by issuing an apt command like the following
apt update && apt -y upgrade && apt install apache2 libapache2-mod-php mariadb-client mariadb-server php-pear php-dev php-gd php-curl php-intl php-mysql php-mbstring php-zip php-xml php-cli php-apcu php-bcmath git unzip
# otherwise, you can use the following directly:
git clone https://github.com/chamilo/chamilo-lms.git chamilo2
cd chamilo2
composer install (If composer asks to accept recipes, just press enter or "n")
php bin/console fos:js-routing:dump --format=json --target=public/js/fos_js_routes.json
yarn install
yarn run encore dev
chmod -R 777 .

Then enter the main/install/index.php and follow the UI instructions (database, admin user settings, etc).

After the web install process, change the permissions back to a reasonnably safe state:

chmod -R 755 .
chown -R www-data: public/ var/

Quick update

If you have already installed it and just want to update it from Git, do:

git pull origin master
composer update
php bin/console fos:js-routing:dump --format=json --target=public/js/fos_js_routes.json
    
yarn upgrade
yarn encore dev

This will update the JS (yarn) and PHP (composer) dependencies.

Installation guide (Dev environment, stable environment not yet available)

If you are a developer and want to contribute to Chamilo in the current development branch (not stable yet), then please follow the instructions below. Please bear in mind that the development version is NOT COMPLETE at this time, and many features are just not working yet. This is because we are working on root components that require massive changes to the structure of the code, files and database. As such, to get a working version, you might need to completely uninstall and re-install from time to time. You've been warned.

First, apply the procedure described here: Managing CSS and JavaScript in Chamilo (in particular, make sure you follow the given links to install all the necessary components on your computer).

Then make sure your database supports large prefixes (see this Stack Overflow thread if you use MySQL < 5.7 or MariaDB < 10.2.2).

Load the (your-domain)/main/install/index.php URL to start the installer (which is very similar to the installer in previous versions). If the installer is pure-HTML and doesn't appear with a clean layout, that's because you didn't follow these instructions carefully. Go back to the beginning of this section and try again.

Finally, if you are installing this development version in a subdirectory, you will need to add "the folder" in the ".env" file in the root folder:

APP_URL_APPEND=the-folder

Changes from 1.x

  • app/Resources/public/assets moved to public/assets
  • main/inc/lib/javascript moved to public/js
  • main/img/ moved to public/img
  • main/template/default moved to src/Chamilo/CoreBundle/Resources/views
  • bin/doctrine.php removed use bin/console doctrine:xyz options
  • PHPMailer replaced with Swift Mailer
  • Plugin images, css and js libs are loaded inside the public/plugins folder (composer update copies the content inside plugin_name/public inside web/plugins/plugin_name
  • Plugins templates use asset() function instead of using "_p.web_plugin"
  • bower replaced by yarn

Todo

See https://github.com/chamilo/chamilo-lms/projects/3

Contributing

If you want to submit new features or patches to Chamilo 2, 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://campus.chamilo.org/documentation/index.html

Notes

You can install Yarn on Ubuntu following the instructions at https://linuxize.com/post/how-to-install-yarn-on-ubuntu-18-04/ You can install Composer on Ubuntu following the instructions at https://getcomposer.org/download/