README.md

Joomla! CMS™

The Joomla! 5.0 branch is under heavy development and not all links in this document are available yet

Build Status

Drone-CI	AppVeyor	PHP	Node	npm

Overview

• This is the source of Joomla! 5.x.
• Joomla's Official website.
• Joomla! 5.0 version history.
• Detailed changes are in the changelog.

What is Joomla?

• Joomla! is a Content Management System (CMS) which enables you to build websites and powerful online applications.
• It is a simple and powerful web server application which requires a server with PHP and either MySQL or PostgreSQL to run. You can find full technical requirements here.
• Joomla! is free and Open Source software distributed under the GNU General Public License version 2 or later.

Looking for an installable package?

Joomla is not installable out of the box from this repository, please use:

• For the latest stable package: https://downloads.joomla.org
• For a nightly package: https://developer.joomla.org/nightly-builds.html

How to get a working installation from the source

For detailed instructions please visit https://docs.joomla.org/Special:MyLanguage/J5.x:Setting_Up_Your_Local_Environment

You will need:

• PHP - basically the same as you need for running a Joomla Site, but you need the cli (command line interface) Version (see https://docs.joomla.org/Special:MyLanguage/Configuring_a_LAMPP_server_for_PHP_development)
• Composer - for managing Joomla's PHP Dependencies. For help installing composer please read the documentation at https://getcomposer.org/doc/00-intro.md
• Node.js - for compiling Joomla's Javascript and SASS files. For help installing Node.js please follow the instructions available on https://nodejs.org/en/
• Git - for version management. Download from here https://git-scm.com/downloads (MacOS users can also use Brew and Linux users can use the built-in package manager, eg apt, yum, etc).

Steps to setup the local environment:

• Clone the repository:

git clone https://github.com/joomla/joomla-cms.git

• Go to the joomla-cms folder:

cd joomla-cms

• Go to the 5.0-dev branch:

git checkout 5.0-dev

• Install all the needed composer packages:

composer install

• Install all the needed npm packages:

npm ci

Things to be aware of when pulling: Joomla creates a cache of the namespaces of its extensions in JOOMLA_ROOT/administrator/cache/autoload_psr4.php. If extensions are created, deleted or removed in git then this file needs to be recreated. You can simply delete the file and it will be regenerated on the next call to Joomla.

Do you want to improve Joomla?

• Where to request a feature?
• How do you report a bug on the Issue Tracker?
• Get Involved: Joomla! is community developed software. Join the community.
• Documentation for Developers.
• Documentation for Web designers.
• Provide a translation for Joomla: Joomla Crowdin Project

Copyright

• (C) 2005 Open Source Matters, Inc. https://www.joomla.org
• Distributed under the GNU General Public License version 2 or later
• See License details