The key to successfully developing in Joomla 1.5 (and it’s significant advantages over 1.0) is the Joomla Framework. While other frameworks such as Zend, phpCake and others attempt to be general frameworks on which you can build an application, the Joomla Framework is specifically targeted at being suitable to build a web-based Content Management System (although it is certainly possible to build other types of applications).
The framework is found in the /libraries/
folder. Each folder under /libraries/` represents a group of packages by an author. The top level package groups are:
Used for VCard support for the Contacts component and also has an RSS class used by Joomla 1.0.
DOMIT provides support for reading and manipulating XML documents. However, even its “lite” class is fairly heavy and JSimpleXML should be used for reading XML documents. For DOM based manipulation it is advised to use PHP 5 and its built-in DOMDocument class. DOMIT is not included after version 1.5.
Geshi is a code beautifying class used by the Geshi plugin. It is moved out of the Framework into the Geshi content plugin after version 1.5.
This is the Joomla provided framework (discussed later).
The is the API for using the Open ID authentication plugin. It is moved out of the Framework into the OpenID plugin after version 1.5.
patTemplate is an XML based templating engine. Although the Joomla installation application renders with patTemplate, it lacks the robustness needed for most components (very weak on support for nested loops). It has been dropped from the Framework after version 1.5.
A small amount of the PEAR framework is included to support the Archive_Tar class. Unfortunately it presents a license conflict with the GNU General Public License and this group is removed after version 1.5.
This is a very powerful access control class. Joomla 1.5 supports a simplified subset of the capabilities of this class but custom development can harness the full API. It forms the inspiration of the new, native access control system used after version 1.5.
This is not used in the core 1.5 distribution. It, however, forms the inspiration for the native JFilterInput class in the Framework.
The Framework mail handling classes (JMail) are derived from phpMailer.
This package provides support for UTF8 string manipulation where the support does not exist natively in PHP.
This package supports the web services protocol for XML-RPC used in the XML-RPC application.
This package supports the syndication features if required for extensions.
This package supports the generation of PDF files in the Articles component.
The Joomla Framework
The Joomla Framework, found in
/libraries/joomla/, are suite of natively built or derived classes that support the applications and extensions that form the Joomla CMS.
The framework is built upon a number of umbrella classes. The JLoader class and jimport function are used to physically load the files required for the Framework. JFactory is a static factory class that is used to get key system information (the current User, the database connector, the Application, and so on). JRoute is used heavily to support SEF URLs and JText is the mainstay for outputing translated text (see methods.php). JVersion defines the currently installed version of the Joomla Framework and CMS.
The Framework is built up of the following packages:
This packages supports the building of Joomla Applications (for example, the “Frontend” and the “Backend” Administrator). It also includes support and helper classes for building components and modules including the MVC classes, routing, menu and pathway support.
This package contains several base classes used by the Framework.
JObject forms the basis of almost all Framework classes.
JObservable are used to support the plugin architecture.
JNode are used to support menu generation.
This package provides support for different caching handlers such as file based, APC, eAccelerator, MemCache and XCache.
This package include classes to support different network protocols such as FTP and LDAP.
This package is fundamental to the supporting database connectivity for Joomla. It includes connector classes for MySQL and MySQLi database engines and all of the core database tables (via
This package supports the Joomla Document types. Each component renders out as a “document”. Types of HTML, Raw, PDF, Feed and Error are supported.
This package supports browser detection, request and response handling (via
JResponse) and URI processing (via
This package support the error handling classes
JException. It also contains the logging (JLog) and profiling (
This package supports the plugin architecture (
This package supports the file handling features in the Framework via
JPath. It also supports archive handling via
This package support input filtering (
JFilterInput) and output filtering (
This package supports many output related features. JHTML is a mainstay of output “widgets” that are available to developers. JEditor supports the plugable WYSIWYG editors.
JPagination supports the pagination links used in list views.
JPane supports the tabbed and accordion style screen elements.
JToolbar supports the Administator application toolbar.
This package supports the extensions installation features in Joomla (not to be confused with the Joomla installation application - that’s where you install Joomla as a whole).
This package supports in the localisation of Joomla text into other languages.
JLanguage processes language files. Help sites are also supported in this package.
This package supports the mail handling features in the Framework via
This package supports the plugin architecture.
This package supports the registry class.
JRegistry is used to hold and input from and output to various formats (
This packages supports the session handling (via
JSession) in an application. Different storage mechanisms are supported for file based storage, database, APC, eAccelerator, MemCache and XCache.
This package support user authentication (
JAuthentication), permissions control (
JAuthorization) and general user support (
This package holds several general support clasess.
JArrayHelper is used to retrieve data out of arrays and convert array from and to objects. JBuffer is a general stream handling class. JDate handles basic date conversions and formatting.
JSimpleCrypt supports simple encryption.
JSimpleXML is used to read and traverse XML documents. JString is used to perform UTF8 safe operations on strings.
JUtility has several general utility methods (getToken and getHash are the most commonly used).