Cool Solution - Joomla
From Univention Wiki
This article briefly describes how to install Joomla 3.x, and focuses on how to configure the included LDAP plugin against a UCS LDAP server.
Joomla can be installed on any Linux distribution meeting the requirements, like Debian or Ubuntu.
The Joomla version used to create this article is 3.4.5, and the full package was used (not an update archive).
The following software must be installed in order to run Joomla:
To connect to the MySQL database using PHP, the following PHP extension must be available:
When Joomla is installed on a UCS system, all dependencies can be installed from the standard UCS repository:
univention-install mysql-server php5-mysql
In order to log in as a user using the LDAP connection, the mapped attribute for e-mail (see LDAP connection table below) must contain a valid e-mail address.
In this article it is assumed that Joomla will be installed in
/var/www/joomla, so the directory must be created first and the ownership must be corrected so the webserver can access the installation folder:
mkdir -p /var/www/joomla chown -R www-data:www-data /var/www/joomla
Download the latest Joomla version from the Joomla website, and extract it into the newly created directory:
unzip Joomla_3.4.5-Stable-Full_Package.zip -d /var/www/joomla
The complete configuration of Joomla is managed through the web interface. Please refer to the Joomla manual for assistance.
Navigate to https://<SERVER>/joomla/administrator and follow the instructions in the web interface.
Hint: Please note that the administrative user, which is created as first user, is not to be confused with the default UCS administrative user "Administrator".
Hint: Please note that during the configuration, an FTP connection can be configured. The installation and configuration of an FTP is not part of this article.
Login is the Joomla administrative user and activate the LDAP plugin by navigating to "Extensions" -> "Manage". A list of available plugins is shown. Activate the LDAP plugin by simply clicking on the button next to "Authentication - LDAP".
Next, navigate to "Extensions" -> "Plugins" and click on "Authentication - LDAP" and configure the plugin accordingly:
|Host||<LDAP server FQDN or IP>|
|Authorisation Method||Bind and Search|
|Base DN||<Base DN>|
|User's DN||uid=[username],cn=users,<Base DN>|
|Connect Username||<Search user's DN>|
|Connect Password||<Search user's password>|
|Map: Full Name||displayName|
|Map: User ID||uidNumber|
Hint: To obtain the base DN, run
ucr get ldap/base on any UCS system in the domain.
Hint: It is advised to create a new user for connecting to the LDAP instead of the UCS Administrator user.
To add Joomla to the UCS overview site, set the following UCR variables:
ucr set \ ucs/web/overview/entries/service/joomla/description/de="Joomla CMS." \ ucs/web/overview/entries/service/joomla/description="Joomla CMS." \ ucs/web/overview/entries/service/joomla/label/de="Joomla" \ ucs/web/overview/entries/service/joomla/label="Joomla" \ ucs/web/overview/entries/service/joomla/link="/joomla"
Hint: When Joomla is not installed on the UCS system, change the UCR variable