Archived

Managing Component Updates (Manifest file)

From Joomla! Documentation

This page has been archived. This page contains information for an unsupported Joomla! version or is no longer relevant. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.

Quill icon.png
Content is Incomplete

This article or section is incomplete, which means it may be lacking information. You are welcome to assist in its completion by editing it as well. If this article or section has not been edited in several days, please consider helping complete the content.
This article was last edited by Sm990 (talk| contribs) 12 years ago. (Purge)

This tutorial is for Joomla Joomla 1.6

Articles in this series[edit]

Manifest File (mytest.xml)[edit]

The manifest file in this example is very similar to that of normal components. Important contents for this example include:

sql folder[edit]

Note the inclusion of the SQL folder in the administration files section. This tells Joomla to copy the contents of this folder to the web site during install or update. The SQL folder contains individual SQL files for each incremental update.

<administration>
	<files folder="admin"> 
		<folder>sql</folder> 
	</files>
</administration>

name[edit]

This is the name of the component. The 'getParam($key)' method in the script.php file uses this value to identify the correct row in the extensions table. The manifest_cache field in the extensions table has the version string for the currently installed component.

<name>COM_MYTEST</name>

version[edit]

Joomla stores this value in the manifest_cache field of the extensions table. The extensions table is where the custom code in the script.php file reads the version string of the currently installed component, and compares it to the version string of the update. The custom component code uses this comparison to abort an update, if the version sequence is not allowed. Joomla also compares this string to the SQL update file names, to determine which SQL commands to execute.

<version>1.0</version>

updates[edit]

This defines the directory that contains SQL files for component incremental database updates. You may choose to put the SQL files somewhere else in your component release, but make sure their location is documented here.

<update> 
	<schemas> 
		<schemapath type="mysql">sql/updates</schemapath> 
	</schemas> 
</update>