[extoc]

El primer componente básico

Vamos a crear un componente «Hola Mundo»

Parte pública

Con tu editor favorito crea un fichero yoursite/components/com_helloworld/helloworld.php que contenga:

Hello world

Puedes testear este componente básico accediendo a la dirección http://yoursite/index.php?option=com_helloworld en tu navegador (no olvides añadir antes la dirección a tu instalación Joomla!2.5) tras instalar este componente.

Gestión de Adminsitración

Con tu editor de ficheros favorito, crea un fichero yoursite/administrator/components/com_helloworld/helloworld.php que contenga:

Hello world administration

Puedes testear este componente básico visitando administrator/index.php?option=com_helloworld con tu navegador tras instalar el componente.

Empaquetando un fichero zip de instalaciñon

Si has utilizado Joomla antes de leer este tutorial, habrás notado que las extensiones se instalan utilizando un archivo comprimido conteniendo todos los recursos necesarios para instalar y desinstalar la extensión.

Con tu administrador de archivos preferido, crea un directorio (fuera del directorio de instalación de Joomla) que contenga:

• helloworld.xml
• site/helloworld.php
• site/index.html
• admin/index.html
• admin/helloworld.php
• admin/sql/index.html
• admin/sql/updates/index.html
• admin/sql/updates/mysql/index.html
• admin/sql/updates/mysql/0.0.1.sql

admin/sql/updates/mysql/0.0.1.sql es un fichero vacío que permite inicializar la versión del esquema del componente com_helloworld.

admin/sql/updates/mysql/0.0.1.sql

Ahora comprime este directorio o directamente descargalo el archivo e instalalo utilizando la «Administración de extensiones» (Extension Manager) de Joomla. Puedes testear este componente básico accediendo a la dirección index.php?option=com_helloworld o administrator/index.php?option=com_helloworld con tu navegador favorito. También te darás cuenta de que el componente Hello World! está accesible en el area de administración de tu instalación Joomla, bajo el menú Componentes.

Nota: La etiqueta <name>Hello World!</name> te puede llevar a pensar que se trata simplemente del nombre, y que podrías llamarlo ‘fluffy’ o ‘bippo’, pero esto no es así. Los nombres entre las etiquetas se transforman, convirtiendolo en minúsculas y quitando los espacios y caracteres especiales (el ! por ejemplo) y joomla comienza a buscar ficheros/directorios que respondan con ese nombre. Asi que el nombre que utilices ahí es crucial para que el componente funcione. En otras palabras, Si quieres cambiar «Hello World!» a «helloworld» todo irá bien, pero si cambiaras el nombre a «helloworld2» el componente buscaría los ficheros y directorios equivocados.

helloworld.xml

 
        Hello World!
        
        November 2009
        John Doe
        john.doe@example.org
        http://www.example.org
        Copyright Info
        License Info
        
        0.0.1
        
        Description of the Hello World component ...
 
         
                
                        sql/updates/mysql
                
        
 
        
        
        
                index.html
                helloworld.php
        
 
        
                
                Hello World!
                
                
                
                        
                        index.html
                        helloworld.php
                        
                        sql
                
        
 

site/helloworld.php

Hello World

admin/helloworld.php

Hello World administration

index.html común en todos los directorios