Manifest files
m (Made miscellaneous improvements) |
|||
| Line 3: | Line 3: | ||
=General information= | =General information= | ||
{{RightTOC}} | {{RightTOC}} | ||
| − | Within Joomla there are manifest files for all of the extensions. These files include the general installation information as well as parameters for the configuration of the [[extension]] itself. | + | Within Joomla there are manifest files for all of the extensions. These files include the general installation information as well as parameters for the configuration of the [[extension]] itself. Since Joomla! 1.6 {{JVer|1.6}}, there are very few differences between the manifest file formats for the different [[Extension types (technical definitions)|types of extensions]], allowing each type to access the full power of the Joomla! installer. |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
==Naming conventions== | ==Naming conventions== | ||
The file must be named manifest.xml or <extension_name>.xml and located in the root directory of the installation package. | The file must be named manifest.xml or <extension_name>.xml and located in the root directory of the installation package. | ||
| + | ==Syntax== | ||
| + | |||
| + | === Root element === | ||
The primary tag of the installation file is: | The primary tag of the installation file is: | ||
<source lang=xml><extension></extension></source> | <source lang=xml><extension></extension></source> | ||
| Line 43: | Line 38: | ||
| <free name> | | <free name> | ||
| "Applicable for plugins" The group name specifies for which group of plugins the new plugin is available. The existing groups are the folder names within the directory /plugins. The installer will create new folder names for group names that do not exist yet. | | "Applicable for plugins" The group name specifies for which group of plugins the new plugin is available. The existing groups are the folder names within the directory /plugins. The installer will create new folder names for group names that do not exist yet. | ||
| − | |} | + | |} |
| + | |||
| + | === Configuration === | ||
| + | The <code><config></code> element, a child of the root, describes the configuration options for the extension. If applicable, the options will be shown by the appropriate Manager (Plugin Manager, Module Manager or Template Manager). | ||
| + | |||
| + | {{:XML JForm form definitions}} | ||
| − | |||
== Contributors == | == Contributors == | ||
*[[User:akede|Alex Kempkens]] | *[[User:akede|Alex Kempkens]] | ||
Revision as of 14:20, 10 June 2011
Please note that the content on this page is currently incomplete. Please treat it as a work in progress.
- This article was last edited by Mvangeest (talk| contribs) 22 months ago. (Purge)
 |
This article is actively undergoing a major edit for a short while. As a courtesy, please do not edit this page while this message is displayed. The user who added this notice will be listed in the page history. This message is intended to help reduce edit conflicts; please remove it between editing sessions to allow others to edit the page. If this page has not been edited for several hours, please remove this template, or replace it with {{underconstruction}}. |
General information
Contents |
Within Joomla there are manifest files for all of the extensions. These files include the general installation information as well as parameters for the configuration of the extension itself. Since Joomla! 1.6 
, there are very few differences between the manifest file formats for the different types of extensions, allowing each type to access the full power of the Joomla! installer.
Naming conventions
The file must be named manifest.xml or <extension_name>.xml and located in the root directory of the installation package.
Syntax
Root element
The primary tag of the installation file is:
<extension></extension>This starting and closing tags are now valid for all extensions. The new tag <extension> replaces the old <install></install> from Joomla 
. The following attributes are allowed within the tag:
| Attribute | Values | Description |
|---|---|---|
| type | component module plugin template |
This attribute describes the type of the extension for the installer. Based on this type further requirements to sub-tags apply. |
| version | 1.6 | String that identifies the version of Joomla for which this extension is developed. For Joomla 1.6 a version higher than 1.5 is required. |
| method | new upgrade |
The default value install will be also used if the method attribute is not used. In these cases the installer will gracefully stop if he finds any existing file/folder of the new extension |
| client | site administrator |
Applicable for modules The client allows to specify for which application client the new module is available. |
| group | <free name> | "Applicable for plugins" The group name specifies for which group of plugins the new plugin is available. The existing groups are the folder names within the directory /plugins. The installer will create new folder names for group names that do not exist yet. |
Configuration
The <config> element, a child of the root, describes the configuration options for the extension. If applicable, the options will be shown by the appropriate Manager (Plugin Manager, Module Manager or Template Manager).
Under the <config> element, one or more <fieldset> elements may appear, each representing a HTML <fieldset>, a group of form fields visually grouped together. The optional name attribute can be used on the <fieldset> to define the name of the fieldset, as in <fieldset name="params">.
Each fieldset must contain one or more <field> elements, each representing a single form field with a label. See Standard form field types for a list of allowed form field types and example XML form field definitions.
