Archived:Developing a MVC Component/Developing a Basic Component

2010-04-25T08:28:46Z

Eeerlend: /* Packaging an installation zip file */ You will get an error if you use the "com_"-prefix in the <name>-tag...

{{underconstruction}}
{{future|1.6}}

== Articles in this series ==
{{Chunk:Developing a Model-View-Controller (MVC) Component for Joomla!1.6 - Contents}}

== Introduction ==
This tutorial is part of the [[Developing a Model-View-Controller (MVC) Component for Joomla!1.6]] tutorial.

== The first basic component ==
Let's create a ''Hello World!'' component.
=== Public display ===
With your favorite file manager and editor, create a file ''site/helloworld.php'' containing
<source lang="php">
Hello world
</source>

You can test this basic component by putting ''index.php?option=com_helloworld'' in your browser address (don't forget to prefix this address with your Joomla!1.6 installation path).

=== Administrator management ===
With your favorite file manager and editor, create a file ''admin/helloworld.php'' containing
<source lang="php">
Hello world administration
</source>

You can test this basic component by putting ''administrator/index.php?option=com_helloworld'' in your browser address.

=== Packaging an installation zip file ===
If you have used Joomla before reading this tutorial, you have noticed that extensions are installed using a compressed file containing all the things which are needed for installing and uninstalling them.

Delete the ''components/com_helloworld'' and ''administrator/components/com_helloworld'' directories of your Joomla!1.6 installation.

With your favorite file manager, create a directory (outside your Joomla!1.6 installation directory) containing
* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[#site/helloworld.php|site/helloworld.php]]''
* ''[[#index.html|site/index.html]]''
* ''[[#admin/helloworld.php|admin/helloworld.php]]''
* ''[[#index.html|admin/index.html]]''

Create a compressed file of this directory or directly download the [http://joomlacode.org/gf/download/frsrelease/11394/46139/com_helloworld-1.6-part01.zip archive] and install it using the extension manager of Joomla!1.6. You can test this basic component by putting ''index.php?option=com_helloworld'' or ''administrator/index.php?option=com_helloworld'' in your browser address. You can also notice that the ''Hello World!'' component is visible in the administrator site of your Joomla!1.6 installation under the ''Components'' menu.


''helloworld.xml''
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="1.6.0" method="install">
<name>helloworld</name>

<creationDate>November 2009</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.1</version>

<description>Description of the Hello World component ...</description>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
</files>

<administration>

<menu>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>
</files>
</administration>
</extension>
</source>



''site/helloworld.php''
<source lang="php">
Hello World
</source>



''admin/helloworld.php''
<source lang="php">
Hello World administration
</source>



''index.html''
<source lang="html4strict">
<html><body bgcolor="#FFFFFF"></body></html>
</source>


== Contributors ==
*[[User:cdemko|Christophe Demko]]

[[Category:Development]]
[[category:Joomla! 1.6]]
[[category:Manual]]

Joomla! Documentation - User contributions [en]

Archived:Developing a MVC Component/Developing a Basic Component