J1.5

Difference between revisions of "Components:xml installfile"

From Joomla! Documentation

(dtd new path)
(12 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
<source lang="xml">
 
<?xml version="1.0" encoding="utf-8"?>
 
<?xml version="1.0" encoding="utf-8"?>
<pre>
+
<!DOCTYPE install SYSTEM "http://www.joomla.org/xml/dtd/1.5/component-install.dtd">
<!DOCTYPE install SYSTEM "http://dev.joomla.org/xml/1.5/component-install.dtd">
 
 
<install type="component" version="1.5.0">
 
<install type="component" version="1.5.0">
<name>hello_world</name>
+
<!--  The extension commercial name: make it different form others at JED http://extensions.joomla.org/-->
<!-- The following elements are optional and free of formatting conttraints -->
+
<name>Hello World</name>
<creationDate>2007 01 17</creationDate>
+
<!-- The following elements are optional and free of formatting constraints -->
 +
<!-- Original creation date. Recommended: YYYY-MM-DD -->
 +
<creationDate>2007-01-17</creationDate>
 
<author>John Doe</author>
 
<author>John Doe</author>
 
<authorEmail>john.doe@example.org</authorEmail>
 
<authorEmail>john.doe@example.org</authorEmail>
 
<authorUrl>http://www.example.org</authorUrl>
 
<authorUrl>http://www.example.org</authorUrl>
 
<copyright>Copyright Info</copyright>
 
<copyright>Copyright Info</copyright>
<license>License Info</license>
+
<license>License Info with link</license>
 
<!--  The version string is recorded in the components table -->
 
<!--  The version string is recorded in the components table -->
<version>Component Version String</version>
+
<version>1.0.1</version>
 +
<!--  The date for the actual version release -->
 +
<releaseDate>2010-05-14</releaseDate>
 +
<!--  Type of release: Bug fix, Security Fix, Minor update, Major update -->
 +
<releaseType>Major update</releaseType>
 +
<downloadUrl>http://www.example.org/downloads/myjoomlaextensions/</downloadUrl>
 
<!-- The description is optional and defaults to the name -->
 
<!-- The description is optional and defaults to the name -->
 
<description>Description of the component ...</description>
 
<description>Description of the component ...</description>
  
 
<!-- Custom Install Script to execute -->
 
<!-- Custom Install Script to execute -->
<installfile>install.eventlist.php</installfile>
+
<!-- Note: This will be copied from the root of the installation package to the administrator directory automatically -->
 +
<installfile>install.helloworld.php</installfile>
 
 
 
<!-- Custom Uninstall Script to execute -->
 
<!-- Custom Uninstall Script to execute -->
<uninstallfile>uninstall.eventlist.php</uninstallfile>
+
<!-- Note: This will be copied from the root of the installation package to the administrator directory automatically -->
 +
<uninstallfile>uninstall.helloworld.php</uninstallfile>
  
 
<!-- Install Database Section -->
 
<!-- Install Database Section -->
Line 41: Line 50:
 
<files>
 
<files>
 
<filename>index.html</filename>
 
<filename>index.html</filename>
<filename>test.php</filename>
+
<filename>helloworld.php</filename>
 +
                <folder>views</folder>
 
</files>
 
</files>
 
 
Line 52: Line 62:
 
 
 
<!-- Site Main Media File Copy Section -->
 
<!-- Site Main Media File Copy Section -->
<media destination="com_test">
+
<media destination="com_helloworld">
 
<filename>image.png</filename>
 
<filename>image.png</filename>
 
<filename>flash.swf</filename>
 
<filename>flash.swf</filename>
Line 60: Line 70:
 
 
 
<!-- Administration Menu Section -->
 
<!-- Administration Menu Section -->
<menu img="components/com_test/assets/test-16.png">EventList</menu>
+
                <!-- Name to display at the component menu. Should be the same as the extension commercial name -->
 +
<menu img="components/com_helloworld/images/helloworld_icon.png">Hello World</menu>
 
<submenu>
 
<submenu>
 
<!-- Note that all & must be escaped to &amp; for the file to be valid XML and be parsed by the installer -->
 
<!-- Note that all & must be escaped to &amp; for the file to be valid XML and be parsed by the installer -->
<menu link="option=com_helloworld&amp;task=hello&amp;who=world">Hello World!</menu>
+
<menu link="option=com_helloworld&amp;controller=config">Configuration</menu>
 
<!-- Instead of link you can specify individual link attributes -->
 
<!-- Instead of link you can specify individual link attributes -->
 
<menu img="icon" task="hello" controller="z" view="a" layout="b" sub="c">Hello Again!</menu>
 
<menu img="icon" task="hello" controller="z" view="a" layout="b" sub="c">Hello Again!</menu>
Line 75: Line 86:
 
<files folder="admin">
 
<files folder="admin">
 
<filename>index.html</filename>
 
<filename>index.html</filename>
<filename>admin.test.php</filename>
+
<filename>admin.helloworld.php</filename>
 
</files>
 
</files>
 
 
 
<!-- Administration Language File Copy Section -->
 
<!-- Administration Language File Copy Section -->
 
<languages folder="admin">
 
<languages folder="admin">
<language tag="en-GB">en-GB.com_test.ini</language>
+
<language tag="en-GB">en-GB.com_helloworld.ini</language>
<language tag="de-DE">de-DE.com_test.ini</language>
+
<language tag="de-DE">de-DE.com_helloworld.ini</language>
<language tag="nl-NL">nl-NL.com_test.ini</language>
+
<language tag="nl-NL">nl-NL.com_helloworld.ini</language>
 
</languages>
 
</languages>
 
 
 
<!-- Administration Main Media File Copy Section -->
 
<!-- Administration Main Media File Copy Section -->
<media folder="admin" destination="com_test">
+
<media folder="admin" destination="com_helloworld">
 
<filename>admin-image.png</filename>
 
<filename>admin-image.png</filename>
 
<filename>admin-flash.swf</filename>
 
<filename>admin-flash.swf</filename>
Line 92: Line 103:
 
</administration>
 
</administration>
 
</install>
 
</install>
</pre>
+
</source>
 +
{{notice|
 +
Put this xml file, also called manifest, in the root of your package (because the installer will take its path as the root path for all other files). Don't include itself under <files>...}}
 +
 
 +
[[Category:Development]][[Category:Extensions]][[Category:JED]]
 +
[[Category:References]][[Category:Component Development]]

Revision as of 03:31, 23 August 2011

The "J1.5" namespace is an archived namespace. This page contains information for a Joomla! version which is no longer supported. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install SYSTEM "http://www.joomla.org/xml/dtd/1.5/component-install.dtd">
<install type="component" version="1.5.0">
	<!--  The extension commercial name: make it different form others at JED http://extensions.joomla.org/-->
	<name>Hello World</name>
	<!-- The following elements are optional and free of formatting constraints --> 
	<!-- Original creation date. Recommended: YYYY-MM-DD -->
	<creationDate>2007-01-17</creationDate>
	<author>John Doe</author>
	<authorEmail>john.doe@example.org</authorEmail>
	<authorUrl>http://www.example.org</authorUrl>
	<copyright>Copyright Info</copyright>
	<license>License Info with link</license>
	<!--  The version string is recorded in the components table -->
	<version>1.0.1</version>
	<!--  The date for the actual version release -->
	<releaseDate>2010-05-14</releaseDate>
	<!--  Type of release: Bug fix, Security Fix, Minor update, Major update -->
	<releaseType>Major update</releaseType>
	<downloadUrl>http://www.example.org/downloads/myjoomlaextensions/</downloadUrl>
	<!-- The description is optional and defaults to the name -->
	<description>Description of the component ...</description>

	<!-- Custom Install Script to execute -->
	<!-- Note: This will be copied from the root of the installation package to the administrator directory automatically -->
	<installfile>install.helloworld.php</installfile>
	
	<!-- Custom Uninstall Script to execute -->
	<!-- Note: This will be copied from the root of the installation package to the administrator directory automatically -->
	<uninstallfile>uninstall.helloworld.php</uninstallfile>

	<!-- Install Database Section -->
	<install>
		<sql>
			<file driver="mysql" charset="utf8">install.mysql.utf8.sql</file>
			<file driver="mysql">install.mysql.nonutf8.sql</file>
		</sql>
	</install>
	
	<!-- Uninstall Database Section -->
	<uninstall>
		<sql>
			<file driver="mysql" charset="utf8">uninstall.mysql.utf8.sql</file>
			<file driver="mysql">uninstall.mysql.nonutf8.sql</file>
		</sql>
	</uninstall>

	<!-- Site Main File Copy Section -->
	<files>
		<filename>index.html</filename>
		<filename>helloworld.php</filename>
                <folder>views</folder>
	</files>
	
	<!-- Site Main Language File Copy Section -->
	<languages>
		<language tag="en-GB">en-GB.com_test.ini</language>
		<language tag="de-DE">de-DE.com_test.ini</language>
		<language tag="nl-NL">nl-NL.com_test.ini</language>
	</languages>
	
	<!-- Site Main Media File Copy Section -->
	<media destination="com_helloworld">
		<filename>image.png</filename>
		<filename>flash.swf</filename>
	</media>

	<administration>
	
		<!-- Administration Menu Section -->
                <!-- Name to display at the component menu. Should be the same as the extension commercial name -->
		<menu img="components/com_helloworld/images/helloworld_icon.png">Hello World</menu>
		<submenu>
			<!-- Note that all & must be escaped to &amp; for the file to be valid XML and be parsed by the installer -->
			<menu link="option=com_helloworld&amp;controller=config">Configuration</menu>
			<!-- Instead of link you can specify individual link attributes -->
			<menu img="icon" task="hello" controller="z" view="a" layout="b" sub="c">Hello Again!</menu>
			<menu view="test" layout="foo">Testing Foo Layout</menu>
		</submenu>
		
		<!-- Administration Main File Copy Section -->
		<!-- Note the folder attribute: This attribute describes the folder
			to copy FROM in the package to install therefore files copied
			in this section are copied from /admin/ in the package -->
		<files folder="admin">
			<filename>index.html</filename>
			<filename>admin.helloworld.php</filename>
		</files>
		
		<!-- Administration Language File Copy Section -->
		<languages folder="admin">
			<language tag="en-GB">en-GB.com_helloworld.ini</language>
			<language tag="de-DE">de-DE.com_helloworld.ini</language>
			<language tag="nl-NL">nl-NL.com_helloworld.ini</language>
		</languages>
		
		<!-- Administration Main Media File Copy Section -->
		<media folder="admin" destination="com_helloworld">
			<filename>admin-image.png</filename>
			<filename>admin-flash.swf</filename>
		</media>
	</administration>
</install>
Info non-talk.png
General Information

Put this xml file, also called manifest, in the root of your package (because the installer will take its path as the root path for all other files). Don't include itself under <files>...