Este documento presenta los pasos para desarrollar tres tipos de extensiones en Joomla: módulos, componentes y plugins. Explica la estructura básica de cada uno, incluyendo archivos, código y convenciones. También provee ejemplos de código para crear un módulo simple, un componente básico siguiendo el patrón MVC y un plugin que muestra un mensaje antes de cada artículo.

1. Por David Noguera Cifuentes JoomlaDay 2008, Madrid Desarrollo de extensiones con Joomla! 1.5

7. Estructura de un módulo:

8. - mod_Prueba.php : fichero php con el mismo nombre que el módulo, tomará en control del módulo cuando este sea llamado - helper.php : clase helper , sirve para separar la lógica de la presentación. - directorio tmpl : aquí guardaremos las plantillas que usaremos para la presentación -Por defecto, se usa el template default.php - mod_prueba.xml : fichero xml necesario para generar un instalable y donde especificaremos los parametros del módulo.

10. Código del punto de entrada mod_prueba.php <?php // no permitir acceso directo defined ( ‘_JEXEC’ ) or die ( ‘Restricted access’ ); // incluir al helper que devolverá los datos, solo una vez require_once( dirname (__FILE__).DS.‘helper.php’ ); $mensaje = modPruebaHelper::getMensaje( $params ); require( JModuleHelper::getLayoutPath( ‘mod_prueba’,‘default’) ); ?>

11. Código del helper: <?php class modPruebaHelper { function getMensaje( $params ) { return “Hola Mundo”; } } ?> La clase helper ha de llamarse con el nombre del modulo sin “_” seguido de helper: Nombre del módulo sin “_” + Helper

12. Código del template: default.php <?php echo $mensaje; ?>

13. Fichero XML del módulo <?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?> <install type=&quot;module&quot; version=&quot;1.5.0&quot;> <name>Prueba</name> <author>David Noguera</author> <version>1.0</version> <creationDate>02-04-2008</creationDate> <description>Modulo que muestra un mensaje de Hola Mundo</description> <authorEmail>david@nosolocodigo.com</authorEmail> <files> <filename module=&quot;mod_prueba&quot;>mod_prueba.php</filename> <filename>helper.php</filename> <filename>mod_prueba.xml</filename> <filename>tmpl/default.php</filename> </files> </install>

14. Resultado final

22. Comenzamos con el desarrollo..

23. Punto de Entrada <?php defined ( ‘_JEXEC’ ) or die ( ‘Restricted access’ ); require_once( JPATH_COMPONENT.DS.‘controller.php’ ); if($controller = JRequest::getWord(‘controller’)) { $path = JPATH_COMPONENT.DS.‘controllers’.DS.$controller.‘.php’; if ( file_exists ($path)) { require_once $path; } else { $controller = “”; } } $classname = ‘PruebaController’.$controller; $controller = new $classname( ); $controller->execute( JRequest::getVar( ‘task’ ) ); $controller->redirect(); ?>

25. Controlador <?php defined ( ‘_JEXEC’ ) or die ( ‘Restricted access’ ); jimport(’joomla.application.component.controller’); class PruebaController extends JController { function display() { parent::display(); } } ?>

26. com_prueba/views/prueba/view.html.php <?php defined ( ‘_JEXEC’ ) or die ( ‘Restricted access’ ); jimport( ‘joomla.application.component.view’); class PruebaViewPrueba extends JView { function display($tpl = null) { $model =& $this->getModel(); $mensaje= $model->getMensaje() $this->assignRef( ‘mensaje’, $mensaje ); parent::display($tpl); } } ?>

27. com_prueba/views/prueba/tmpl/default.php <h1><?php echo $this->mensaje ?></h1>

28. Modelo <?php defined (’_JEXEC’) or die (); jimport( ‘joomla.application.component.model’ ); class PruebaModelPrueba extends JModel { function getMensaje(){ //Aquí se obtienen datos de la BD return “Hola soy un valor que ha devuelto el modelo”; } } ?>

29. Fichero XML del componente <?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?> <!DOCTYPE install SYSTEM &quot;http://dev.joomla.org/xml/1.5/component- install.dtd&quot;> <install type=&quot;component&quot; version=&quot;1.5&quot;> <name>My Extension</name> <creationDate>MonthName Year</creationDate> <author>Author's Name</author> <authorEmail>Author's Email</authorEmail> <authorUrl>Author's Website</authorUrl> <copyright>Copyright Notice</copyright> <license>Component License Agreement</license> <version>Component Version</version> <description>Component Description</description>

30. <administration> <menu>My Extension</menu> <submenu> <menu task=&quot;view&quot;>Items</menu> <menu link=&quot;option=com_categories&section=com_wfaqs;&quot;>Categories</menu> </submenu> <files folder=&quot;administration&quot;> <filename>index.html</filename> <filename>admin.myextension.php</filename> <filename>install.sql</filename> <filename>install.noutf8.sql</filename> <filename>uninstall.sql</filename> <folder>models</folder> <folder>views</folder> <folder>controllers</folder> <folder>tables</folder> </files>

31. <languages folder=&quot;administration&quot;> <language tag=&quot;en-GB&quot;>en-GB.com_myextension.ini</language> <language tag=&quot;de-DE&quot;>de-DE.com_myextension.ini</language> </languages> <media destination=&quot;com_myextension&quot;> <filename>logo.jpg</filename> <filename>index.html</filename> </media> </administration> <install> <sql> <file driver=&quot;mysql&quot; charset=&quot;utf8&quot;>install.sql</file> <file driver=&quot;mysql&quot; charset=&quot;&quot;>install.noutf8.sql</file> </sql> </install> <uninstall> <sql> <file driver=&quot;mysql&quot;>uninstall.sql</file> </sql> </uninstall>

32. <installfile>install.myextension.php</installfile> <uninstallfile>uninstall.myextension.php</uninstallfile> <files> <filename>index.html</filename> <filename>myextension.php</filename> <folder>models</folder> <folder>views</folder> <folder>controllers</folder> <folder>tables</folder> </files> <languages> <language tag=&quot;en-GB&quot;>en-GB.com_myextension.ini</language> <language tag=&quot;de-DE&quot;>de-DE.com_myextension.ini</language> </languages> <media destination=&quot;com_myextension&quot;> <filename>logo.jpg</filename> <filename>index.html</filename> </media> </install>

33. Resultado Final URL: index.php?option=com_prueba&view=prueba

39. Estructura del plugin

40. Fichero XML del plugin

41. <?xml version=”1.0″ encoding=”utf-8″ ?> <install version=”1.5″ type=”plugin” group=”content”> <name>Content - Prueba</name> <author>David Noguera</author> <creationDate>15-02-2008</creationDate> <authorEmail>david@nosolocodigo.com</authorEmail> <authorUrl>www.nosolocodigo.com</authorUrl> <version>1.0</version> <description>Muestra un mensaje antes de mostrar el contenido</description> <files> <filename plugin=”Prueba”>Prueba.php</filename> <filename>Prueba.xml</filename> </files> </install>

42. Fichero holaMundo.php <?php defined ( ‘_JEXEC’ ) or die ( ‘Acceso Restringido’ ); jimport( ‘joomla.plugin.plugin’ ); // Convención : Nombre de la clase (plg + tipo plugin + nombre del plugin) class plgContentPrueba extends JPlugin { function plgContentPrueba( &$subject ) { parent::__construct( $subject ); } function onBeforeDisplayContent(&$article, &$params, $limitstart=0) { $salidaPantalla = ‘<h2>Hola Mundo</h2>’; return $salidaPantalla; } } ?>

43. Resultado final

44. Fin de la presentación