Crear modulos en el back-end de joomla 1.

5
El api de Joomla! nos provee de unos objetos especficos para operar con bases de datos.Siempre que se pueda es recomendable usar estos objetos, en lugar de conectar directamente con las funciones de mysql que tiene php, ya que el API de Joomla! hace mucho trabajo por debajo, como proteccin contra inyeccin Sql, optimizacin, etc En ocasiones , necesitaremos un acceso a datos mas profundo, y no nos podremos conformar con lo que nos ofrece el api de Joomla!, en estos casos no queda mas remedio que utilizar el acceso a datos de toda la vida. En este tutorial el componente se va llamar prueba. Por lo tanto accederemos a el mediante la URL /administrator/index?option=com_prueba. Nuestro componente es muy simple: muestra una lista con los mensajes existentes y un formulario de introduccin de datos en el que se presenta un campo de texto y un botn para enviar el formulario. Al enviarse el formulario se introduce en una tabla de la base de datos que hemos creado previamente el mensaje y nos lleva a la misma pagina que muestra todos los mensajes insertados y te da la opcin de seguir insertando mensajes. Vamos a crear la base de datos, esta es la sentencia SQL que yo he usado:
CREATE TABLE 'jos_prueba' ( `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY , `mensaje` VARCHAR( 30 ) NOT NULL DEFAULT 'mensaje' ) ENGINE = innodb;

Como puedes observar son dos campos; una tabla muy simple. Vamos a crear la estructura principal de nuestro componente como en el tutorial anterior, si tienes dudas, pgale un vistazo . La estructura principal del componente es esta:

A continuacin puedes observar el diagrama del componente que vamos a crear:

La vista Prueba Admin es la que se muestra por defecto en nuestro componente, en ella se har un listado de todos los mensajes creados en la base de datos, y al fina pondr un enlace que redirija a la vista IntroduceNuevo. En la vista IntroduceNuevo, se presenta un formulario con una caja de texto y un botn de submit. Este boton de submit redirige al task IntroduceMensaje, donde introduciremos el mensaje en la base de datos y redirigiremos a la vista PruebaAdmin de nuevo para que se muestren todos los mensajes insertados y te da la opcin de seguir insertando. Lo primero que necesitamos es un modelo para nuestra vista PruebaAdmin, creamos la carpeta models, y dentro un archivo con nombre pruebaAdmin.php , dentro de este archivo crearemos la clase que contiene el modelo. El modelo tiene que recuperar todos los datos de la base de datos y devolverlos para que la vista pueda mostrarlos. Dentro de la carpeta models crea el fichero pruebaAdmin.php . De momento vamos a agregar el cdigo necesario para recuperar los datos de la tabla. Este es el cdigo que he usado:
defined('_JEXEC') or die(); jimport( 'joomla.application.component.model' ); class PruebaAdminModelPruebaAdmin extends JModel { var $datos; function getData() { if (empty( $this->datos )) { $query = ' SELECT * ' . ' FROM #__prueba ';

} } }

$this->datos = $this->_getList( $query );

return $this->datos;

Como siempre la primera lnea hace una comprobacin para ver si se esta accediendo desde Joomla! o se esta haciendo un acceso directo, esta medida de seguridad debe de estar siempre presente. La segunda lnea se utiliza la funcin jimport del api de Joomla!, esta funcin importa la clase abstracta para el modelo. Observa que la nomenclatura sigue la norma descrita: Nombre de la Vista Model Nombre del modelo Al tener este nombre , el controaldor PruebaAdminController podra acceder directamente a los mtodos de este modelo. La funcin getData() comprueba si la variable $datos esta vacia, y si lo esta, entonces almacena en ella los datos de la tabla jos_prueba en la variable.Para ello utiliza el metodo getList() . Este mtodo es heredado por la clase padre y lo que hace es devolver una lista de objetos con los resultados de la consulta. Cada objeto de la lista tendr tantas propiedades como campos tenga la tabla consultada.Por lo tanto en la variable $datos se almacena una lista de objetos con los resultados de la consulta. Lo siguiente es mostrar estos datos en la vista PruebaAdmin. Introduce el siguiente cdigo en el fichero views/pruebaAdmin/view.html.php :
defined( '_JEXEC' ) or die( 'Restricted access' ); jimport( 'joomla.application.component.view'); class PruebaAdminViewPruebaadmin extends JView { function display($tpl = null) { $model =& $this->getModel(); $datos = $model->getData(); $this->assignRef( 'mensajes', $datos ); parent::display($tpl); } }

Las dos primeras lneas ya no necesitan explicacin. La nomenclatura de la Vista sigue el patrn descrito. Se sobrescribe el mtodo display() , lo primero es obtener el modelo, al seguir las nombras de nombrado no hace falta especificar el nombre del modelo en el mtodo getModel(). Almacenamos en la variable $datos la lista de objetos que devuelve el mtodo que hemos creado anteriormente en el modelo, y se la pasamos al layout mediante el mtodo assignRef.

Cdigo para el layout default.php de la vista :

<table class="adminlist"> <thead> <tr> <th width="5">ID </th> <th>Mensaje </th> </tr> </thead> <tbody> <?php $n =count( $this->mensajes ); for ($i=0; $i < $n; $i++) { $row =& $this->mensajes[$i]; ?> <tr> <td> <?php echo $row->id; ?> </td> <td><?php echo $row->mensaje; ?> </td> </tr> <?php } ?> <tr> <td>&#160;</td> <td><a href="<?php echo JURI::base();?> index.php? option=com_prueba&view=introduceNuevo">Nuevo Mensaje </a></td> </tr> </tbody> </table>

Recorremos la lista de objetos "mensajes" y creamos un elemento "tr" por cada mensaje, observa que estamos accediendo a la propiedad id y mensaje de cada objeto de la lista, esto es por que como he explicado antes se crea tantas propiedades como campos tenga el resultado de la consulta. Al final de la tabla, he agregado un enlace que redirige a la vista que crearemos luego y que permitir introducir un nuevo mensaje. El mtodo esttico JURI::base() devuelve la url base del sitio, para realizar la peticin correctamente. Introduce algunos datos en tu tabla y comprueba que todo funciona correctamente. Vamos a crear la vista introduceNuevo. Crea el directorio introduceNuevo dentro de la carpeta views , crea el directorio tmpl y los archivos view.html.php y tmpl/default.php correspondientes . Introduce el siguiente cdigo en view.html.php:
defined( '_JEXEC' ) or die( 'Restricted access' ); jimport( 'joomla.application.component.view'); class PruebaAdminViewIntroduceNuevo extends JView { function display($tpl = null) { parent::display($tpl); }

No se realiza ningn acceso a datos , simplemente se ejecuta el mtodo display() y se visualiza el layout por defecto (tmpl/default.php) .La nomenclatura de la vista ha de seguir el patrn que ya se ha explicado anteriormente : Nombre componente View Nombre de la vista . Ahora vamos a ver el cdigo del layout :
<form action="index.php" method="post"> <table border="0"> <tbody> <tr> <td>ID</td> <td>Mensaje</td> </tr> <tr> <td><input disabled size="3" name="id" /></td> <td><input maxlength="30" size="30" name="mensaje" /></td> </tr> <tr> <td>&#160;</td> <td><input type="submit" value="Enviar" /></td> </tr> </tbody> </table> <input type="hidden" value="com_prueba" name="option" /> <input type="hidden" value="introduceMensaje" name="task" /> </form>

Como puedes observar, he creado un formulario que enva la informacin a index.php , y le he puesto una caja de texto para introducir el mensaje y otra para el id, la del id permanece bloqueada ya que se trata de un campo autoincremental y se ira incrementando automticamente en la base de datos. Esta informacin la tiene que procesar el task introduceMensaje . La forma de indicar que la informacin ha de ser procesada por este task es poniendo un input de tipo hidden con atributo name igual a task y un valor igual al nombre del task que deseamos que procese el formulario. En el otro input de tipo hidden se se indica el option para indicar a Joomla! que el task se encuentra dentro del componente com_prueba. Los nombre de los campos input deben de coincidir con los nombres de los campos de la tabla en la que introduciremos los datos. Vamos a crear el task introduceMensaje : En la clase controlador PruebaAdminController que debes haber creado anteriormente introduce el siguiente mtodo:
function introduceMensaje(){ $option = JRequest::getCmd('option'); $modelo = $this->getModel('pruebaAdmin'); $res = $modelo->introduce(JRequest::get('post'));

if($res == 1){ $this->setMessage('Mensage introducido!'); $this->setRedirect('index.php?option=' . $option. '&view=pruebaAdmin'); }else{ $this->setMessage('Error al introducir!'); $this->setRedirect('index.php?option=' . $option. '&view=Error'); } }

Al pulsar submit en el formulario anterior , los datos son enviados a index.php, el marco de trabajo Joomla! lee los parmetros de entrada y detecta que hay un parmetro que indica el componente de destino , el componente com_prueba recibe la peticin y el controlador detecta que existe un parmetro task, este parmetro es un parmetro especial que se usa en Joomla! para procesar acciones de formularios, Joomla! buscara en la clase controlador un metodo que tenga el mismo nombre que el valor del parmetro task y le concedera el control. Es por eso que el nombre del mtodo ha de coincidir con el nombre del task que pusimos en el formulario. Se pueden mapear tasks a mtodos diferentes, pero esto queda pendiente para otro articulo. En este task volvemos a utilizar el API de Joomla! para acceder a datos, pero en este caso vamos a usar el objeto JTable, para introducir datos. Podramos utilizar funciones como mysql_query() para realizar consultas de tipo insert y update, sin embargo estas funciones son mas difciles de generar, requieren de conocimientos de lenguaje SQL y probablemente nos dejemos huecos de seguridad que dan lugar a inyecciones SQL y otros fallos. El API de Joomla! proporciona el objeto JTable para crear, leer , actualizar y borrar registros de una tabla. Crea la carpeta tables, y dentro de esta carpeta crea el archivo Mensajes.php , El nombre del archivo a de ser igual que el nombre de la clase JTable, es decir si el archivo se llama Mensajes.php, la clase se llamara TableMensajes. Si no se hace as, Joomla! tendra problemas para encontrar el objeto JTable. Introduce el siguiente cdigo en el archivo:
defined( '_JEXEC' ) or die( 'Restricted access' ); class TableMensajes extends JTable { var $id = null; var $mensaje = null; function __construct(&$db) { parent::__construct( '#__prueba', 'id', $db ); } }

Se declaran tantas propiedades como campos tenga la tabla sobre la que se quiere trabajar, el nombre de las propiedades debe ser igual que el nombre de los campos. En el constructor se le pasa como primer parmetro el nombre de la tabla, como segundo parmetro la clave primaria y en el tercer parmetro la referencia al objeto base de datos del marco de trabajo Joomla!, el nombre de este tercer parmetro es siempre igual.

Ya tenemos el objeto JTable necesario para utilizar desde el modelo pruebaAdmin, por lo tanto cuando ejecutemos el task introduceMensaje, se instanciara el modelo pruebaAdmin y se ejecutara el mtodo introduce de este. Es en el mtodo introduce del modelo pruebaAdmin donde se usa el objeto JTable que acabamos de crear. Vamos a implementar el mtodo introduce del modelo pruebaAdmin , introduce el siguiente mtodo en el modelo:
function introduce($post){ $row =& JTable::getInstance('Mensajes', 'Table'); if (!$row->bind($post)) { return JError::raiseWarning(500, $row->getError()); } if (!$row->store()) { return JError::raiseWarning(500, $row->getError()); } return 1; }

Observa que acepta como parmetro una variable a la que llama $post. En esta variable almacenaremos la peticin entera que previamente hemos obtenido en el controlador mediante la instruccin : JRequest::get(post) Esta instruccin recoge los parmetros de entrada de la peticin, es como acceder al array $_POST de php, pero mediante el API de Joomla!, lo que nos provee de proteccin contra inyeccin de cdigo, etc Es importante saber que si se intenta pasar el valor de los parmetros post mediante el objeto JRequest desde otro sitio que no sea el controlador, por ejemplo desde una vista, el objeto JTable no recibir los parmetros correctamente y generar un error al intentar obtener los valores de la peticin. En la primera lnea del mtodo se obtiene una instancia del objeto TableMensajes que hemos creado antes , si no pones los nombre correctamente no se instanciar el objeto. Despus se ejecuta el mtodo bin() del objeto TableMensajes que lo que hace es buscar en los parmetros post de entrada parmetros con el mismo nombre que los campos de la tabla y enlazarlos, por eso es importante que en el formulario hayamos escrito correctamente los nombres de los inputs. Acto seguido se ejecuta el mtodo store() , que almacena en la base de datos los datos provenientes del formulario. Busca la clave primaria, y si ya existe un un registro con la misma clave primaria ejecuta una consulta update, si aun no esta creada la clave primaria, ejecuta una consulta insert. Si alguno de estos dos mtodos no se ejecuta correctamente se lanza un error el mtodo mediante el cdigo : return JError::raiseWarning(500, $row->getError()) . De vuelta al task introduce mensaje, obtenemos la devolucin del metodo introduce y la procesamos con este cdigo :
if($res == 1){ $this->setMessage('Mensage introducido!'); $this->setRedirect('index.php?option=' . $option. '&view=pruebaAdmin'); }else{ $this->setMessage('Error al introducir!'); $this->setRedirect('index.php?option=' . $option. '&view=Error'); }

Este cdigo ya lo hemos introducido antes en el task introduceMensaje. Si todo ha funcionado correctamente , se redireccin a la vista pruebaAdmin mediante el mtodo de controlador setRedirect(),en la cual se volvern a mostrar todos los mensajes insertados y un enlace para insertar mas mensajes. Si no, se redirecciona a una vista con nombre error en la cual crearemos un mensaje de error a gusto de cada cual. El mtodo del controlador setMessage() establece el mensaje que aparecer en la parte superior izquierda de la pantalla por defecto, o donde este definido en el template de back-end, y hace que se muestre como en la foto :

Si has leido todo, enhorabuena. Proximamente hablar sobre como usar el editor wysiwyg de Joomla, sobre como usar AJAX en nuestros componentes y tambin Google Maps. Tambin escribir algo de mdulos.