Documentation Menu

1.5 Template Project

The Joomla! Documentation Working Group is running a project to develop detailed reference and tutorial material on Joomla! 1.5 templates.  There is a project page on the documentation wiki where you can see the work in progress and help us by contributing your knowledge.

Who's Online

We have 9 guests online

Help Site License

The Joomla! Help Site content is copyright © 2005 - 2008 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution NonCommercial ShareAlike 2.5. Some parts of this website may be subject to other licenses.
Home arrow Manual arrow 7. Packaging Custom Work arrow Mambot Setup File

PDF Print E-mail

Packaging Custom Work :: The Mambot Setup File

{glossarbot=disable}The XML for a Mambot installation could look like this:

<?xml version="1.0" encoding="iso-8859-1"?>
<mosinstall type="mambot" group="content" version="1.0">
  <name>Smilies converter</name>
  <creationDate>15/09/2005</creationDate>
  <author>Joomla</author>
  <copyright>(C) 2005 Open Source Matters. All rights reserved.</copyright>
  <license>http://www.gnu.org/copyleft/gpl.html GNU/GPL</license>
  <authorEmail>admin@joomla.org</authorEmail>
  <authorUrl>help.joomla.org</authorUrl>
  <description>Converts text smilies into graphic images.</description>
  <version>1.1</version>
  <files>
    <filename mambot="smilies.bot">smilies.bot.php</filename>
  </files>
</mosinstall>

The <mosinstall> element has an additional attribute called "group". This attribute places the Mambot in a sub-directory named "content".

There needs to be ONE and only one <filename> that has a "mambot" attribute.  This attribute indicates the file that is called when the Mambot is loaded. The value of the attribute should be the name of the file less the ".php" extension.

There are two special (or reserved) groups in Joomla:

  • content: The Mambots in this group perform operations on displayed content.
  • search: The Mambots in this group provide for components to plug in the results to search engine.

A Mambot may optionally have parameters associated with it.  If parameters are supported by the Mambot then exactly one <params> element should be included containing one <param> sub-element for each parameter to be defined.  Once the Mambot is installed parameters will be displayed and values may be entered in the Administrator Mambot Edit form.  If no <params> element is defined (and if this is the case then no <param> elements must be included either) then a simple text box will be provided in the Administrator Mambot Edit form.


 Please report any errors on this page to the Developer Documentation Forum.

Last Updated ( Monday, 24 April 2006 )
 
< Prev