Esta RJ (Revisión Joomla) es sobre una herramienta, que ha despertado un interés muy grande dentro de la comunidad Joomla. No solo por el hecho de que el sitio está completamente en español, sino que su herramienta creadora de componentes Joomla brilla por su excelencia.

Component Creator es una herramienta creadora de componentes Joomla personalizados, funcionales, y listo para instalar en cuestión de minutos. Elimina aquellas tareas tediosas en el desarrollo de Joomla, ahorrando tiempo para centrarse en las cosas que importan.

¿Bonitas palabras verdad? ¿Quieres saber qué tan verídico es esto? Sí, pues comprobémoslo.

Notas Preliminares

--> Antes de comenzar, hay algunas cosas que hay que tener claras. A pesar que esta herramienta puede usarla cualquier usuario conocedor o no del desarrollo dentro de Joomla, es recomendable al menos tener un conocimiento “ligeramente” básico del mismo, para un mejor entendimiento con la herramienta. Existen algunos tutoriales que pueden ayudarte en este sentido, los cuales listo a continuación:

• Desarrollo de un componente Modelo-Vista-Controlador (MVC) para Joomla! 2.5
• Componente para Joomla! 3: Estableciendo el Escenario
• Componente para Joomla! 3: Comenzando el desarrollo
• Componente para Joomla! 3: Funcionalidades

--> Otra cosa a tener en cuenta antes de usar esta herramienta, es tener bien claro qué tipo de componente quieres crear. Es decir, que características debe tener, principales funciones que va a cumplir….es decir “Establecer el Escenario” como bien se titula uno de los artículos anteriores, para poder ser más objetivo y preciso en el uso de esta herramienta.

--> También verán que en esta revisión usaremos algunos enlaces referenciando la Wiki de esta herramienta. A pesar que esta en inglés, es bueno pasarse por ahí ya que existen algunos puntos esclarecedores en ella.

--> Las opiniones, sugerencias, criticas… que se puedan ofrecen en este artículo son de índole Personal del Autor. Es decir, todas ellas representa un criterio o evaluación personal del “Autor Testeador” de la herramienta o extensión pertinente.

--> La revisión se realizó a la parte no-comercial de la herramienta, la cual tiene como diferencia de la comercial, que solamente puedes crear una sola tabla en tu componente y la herramienta de "Importación SQL" no la puedes usar.

Creando el Componente: Información General

Bueno, ahora centrémonos en nuestro tema a tratar. Para utilizar esta herramienta lo primero que vamos a hacer es crearnos una cuenta en el sitio. Una vez creada, le aparecerá la siguiente pantalla:

Como ves, le aparece una pantalla donde se mostrará una lista de los componentes que has creado. Como no has creado ninguno aún, estará vacía.

El componente que vamos a crear a partir de este artículo su rol principal es el de una galería de imágenes y va a ser implementado sobre Joomla 3. Sí, así como lo lees. Se que piensas que puede ser difícil o hasta imposible esto, pero te demostraré qué tan sencillo puede ser. Por supuesto, nuestra galería será un “ejemplo real” para evaluar la herramienta creadora de componentes. Si todo sale bien, al final podremos ver algo como esto:

Para empezar a crear un componente, iremos al botón “Empezar ahora”, que anteriormente remarcamos en la imagen. Una vez hecho clic, te aparecerá la siguiente pantalla, la cual la dividiremos en dos imágenes (por ser un poco grande), y para resaltar algunas cosas importantes:

Como puedes ver en la imagen anterior, ya los campos están llenos. De esta forma puedo explicar mejor algunos detalles de los mismos y mostrar un ejemplo de su uso. Ten en cuenta que a ustedes les va a salir en blanco o con los valores recomendados por la herramienta.

Primero quisiera resaltar, que cada campo tiene una descripción a la derecha de su funcionalidad o el para qué de su uso. Esto lo pueden notar en la imagen anterior, resaltado con círculos rojos. Así que ante cualquier duda, pueden auxiliarse de estas descripciones. Esto nos permite también no tener que explicar cada campo. Pero no obstante, voy a hacer algunos apuntes que me parecen importantes resaltar en algunos campos. Guiándonos por la numeración de la imagen anterior:

1. Este icono, es el que vamos a usar en la lista que se despliega cuando damos clic en “Componentes” en la administración de Joomla, junto con el nombre del componente. Como pueden ver tienen dos opciones, o escogen uno por defecto, o pueden subir uno personalizado, siempre respetando las medidas que le indican ahí.
2. La versión del componente puede ser cualquiera que usted escoja. Generalmente, se usan tres valores para indicar diferentes actualizaciones de la extensión, pero pueden usar el metodo que ustedes consideren conveniente.
3. A pesar que indiquemos varios idiomas, el componente estará en inglés. Pero, el archivo de idioma correspondiente, al idioma que escojamos en ese campo, estará listo para ser traducido en su respectiva carpeta en el directorio de Joomla. Por ello es que en la imagen ven la descripción en inglés, ya que poniéndola así, solo es después traducir y tendremos listo el componente en dos idiomas. Característica poco encontrada en muchas extensiones, que sin lugar a duda hace que tu extensión llegue a más lugares.

Con esta imagen, completamos la pantalla completa. Aquí es trivial los datos a insertar, pero cualquier duda, siempre acuda a las descripciones de los campos.

Creando el Componente: Generar las Tablas

Una vez listo todo, presionamos el botón “Guardar Componente”, para empezar a crear el mismo. Al guardar, te va a salir una pantalla como esta diciéndote que todo el proceso se realizó correctamente:

En este panel, tenemos todo lo necesario para crear nuestro componente. Guiándonos por la numeración de la imagen anterior tenemos:

1. En este “cuadrante” tendremos toda la información relacionada a nuestro componente, qué tablas se han creado y con cuales campos. Más adelante lo verán mejor.
2. “Importación SQL” es algo realmente útil de esta herramienta. Supongamos que tenemos el archivo .sql de nuestras tablas ya creado. Con esta opción, podremos importar dentro del componente las diferentes tablas con sus respectivos campos, y ahorrarnos el proceso de crearlo todo manualmente con la herramienta, a pesar de que no es nada difícil de hacerlo, vale aclarar. Pero recuerden que esta opción esta solo disponible para cuentas "premium".
3. Esta opción es para crear nuestras tablas manualmente, como bien le decía anteriormente, y es la opción que vamos a usar en esta revisión que estamos haciéndole a la herramienta.
4. Esta opción sirve para agregar una vista o “view” vacía en el componente. (Las vistas provienen del patrón MVC, para más información de que es esto, puede empezar por aquí). Agregar una vista vacía al componente tiene su sentido, y en la wiki de la herramienta nos lo explica (Inglés).

Visto esto, vamos a crear nuestra tabla. Para ello damos clic en la opción “Agregar manualmente una tabla” la cual nos conducirá a la siguiente pantalla que la dividiremos en dos imágenes:

Guiándonos por la numeración de arriba, tenemos:

1. Aquí como bien se lo explican en la descripción del campo, es el nombre de la tabla que vamos a tener en nuestra base de datos una vez instalemos el componente.
2. Esta opción es mejor dejarla por defecto si no eres muy ducho en estos temas. Así como está funciona como es debido.
3. En esta hacemos lo mismo que la anterior, para no causar problemas innecesarios.
4. La “Vista del Administrador” se refiere a cuando accedemos al componente en la administración del sitio. A partir de ahí, tenemos dos vistas, una, que es la parte del “Listado” de los “elementos creados”, y otra vista, que es cuando accedemos a uno de los elementos.
   
   Por ejemplo, supongamos que estamos dentro del “Gestor de Artículos” de Joomla. La vista en donde se ve el listado de los artículos creados en Joomla, es la vista “De listado en la administración”. Y la vista que aparece cuando accedemos a un artículo para editarlo en la administración, es la vista “De formulario de la administración”.
   
   Entonces, si marcamos la casilla de verificación en donde dice “Agregar una vista de listado en la administración” nos aparecerá esta vista en nuestro componente, listando en este caso, las imágenes de las distintas galerías.
   
   El campo “Nombre para mostrar” es el nombre que vamos a mostrar en la administración para esta vista. Por ejemplo, cuando uno esta en el Gestor de Artículos de Joomla 3, en la vista del listado de artículos, a la parte izquierda aparece un sub-menú que dice Artículos, Categorías y Artículos Destacados. Estos son los nombres que queremos que aparezcan ahí. En este caso, vamos a poner “Images” ya que ahí se mostrarán todas las imágenes. (recuerden que al principio explicaba el porqué de las palabras en inglés).
   
   Lo otro es el icono, que es la imagen que representa a esta vista. Al igual que el otro, puede ser uno predeterminado o personalizado.
5. Esta parte es lo que le explicaba en el punto 4. Esta vista es la perteneciente a cuando accedemos a un artículo para editarlo, pero en este caso, es la vista cuando accedemos a una de las imágenes de una de las galerías, para editar sus datos.
   
   El campo “Nombre a mostrar” aquí, cumple el mismo rol que el anterior.

Como habrán visto, estamos hablando de editar sus datos, pero no estamos introduciendo ninguno, o qué tipo de datos se van a mostrar, por ejemplo, el título de la imagen. Esto lo definimos más adelante cuando añadamos los distintos campos que van a estar dentro de la tabla.

Así queda configurada esta parte de esta tabla. A modo de que puede ir en cada campo, se muestra en la imagen anterior. Esta configuración es perteneciente a las opciones de la administración, pero como todos sabemos, por la parte pública del sitio o el frontend, también existe la posibilidad de editar y visualizar estos datos de las distintas vistas. Y es lo que viene más abajo en la pantalla que les salió, y que les muestro en la siguiente imagen:

Guiándonos por la numeración de la imagen anterior tenemos:

1. La primera casilla, es para lo mismo que hablamos para la administración pero para el frontend. Es decir, listaremos en este caso las distintas galerías que tenemos en nuestro componente. La segunda casilla, es para dar la posibilidad de acceder a una de estas galerías y ver las imágenes que la contienen. Un ejemplo para un mejor entendimiento, es cuando damos la opción en nuestro de sitio de listar distintas categorías de artículos.
   La tercera casilla, como bien lo indica, permite la edición frontend del elemento.
2. Esta parte es bien interesante, ya que podemos usar al alcance de un clic el potencial de las ACL (Access Control List - Lista de Control de Acceso) de Joomla. Marcando esta casilla, nos va a aparecer en la vista de edición del elemento (Vista de formulario) en la parte inferior, las opciones de los diferentes permisos de Crear, Editar, Eliminar….para cada elemento individual.

Una vez hecho esto, ya esta lista nuestra tabla para ser generada. Así que le damos al botón “Crear tabla”, para generarla y nos saldrá una pantalla indicándonos que la tabla ha sido añadida correctamente:

En este panel está todo lo necesario, para saber el contenido de nuestra tabla. Guiándonos por la numeración anterior, tenemos:

1. Este es el nombre que va a aparecer en nuestra base de datos, para el nombre de la tabla. Recuerden que “#__” se sustituirá por el prefijo que tengas en la base de datos.
2. Estos campos, son los campos que esta herramienta nos recomienda por defecto. No son de carácter obligatorios. Estos campos o estos valores, son los que la tabla va tener, y son los que vamos mostrar o no en las distintas vistas que hemos visto anteriormente. Digo mostrar o no, porque no todos los campos son necesarios mostrarlos al usuario, pero esto esta en dependencia de lo que ustedes están creando. El hecho es, que la herramienta nos permite toda esta flexibilidad, que tipos de campos queremos tener, cuales vamos a mostrar...y toda una serie de cosas, que verán ustedes en el uso de esta herramienta.

Estos campos por defectos son perfectamente eliminables y modificables. En el ejemplo que estamos siguiendo a través de este artículo, esos campos se van a usar, pero también vamos a usar otros que vamos añadir.

Creando el Componente: Generar Campos Nuevos

Para crear un campo nuevo para nuestra tabla, solo damos clic en uno de los dos botones “Agregar campo” que le señalaba en la imagen anterior y nos saldrá una pantalla que la dividiremos en dos imágenes:

Quizás aquí empieza la parte difícil y única, de esta herramienta. Como es lógico, cada campo debe ser de un tipo, y cada tipo tiene varias opciones adicionales que rellenar. La herramienta es tan buena, que te muestra todos los tipos de campo de tipo Joomla, más otros comunes o no, por nosotros. La herramienta en su wiki, nos muestra los campos con una explicación de cada uno, para un mejor entendimiento. Esta en ingles, pero es recomendable que primero le eches un vistazo a la página. En esta revisión no podemos abordarlos todos, porque son unos cuantos, pero puedes comentarnos tus dudas respecto a esto y trataremos de ayudarlos para un mejor entendimiento.

Guiándonos por la numeración de la imagen anterior, tenemos que:

1. Este es el nombre del campo que va a aparecer dentro de una columna en la tabla del componente en la base de datos. En nuestro caso, cada imagen pertenece a una galería, así que nuestro campo se llamará “galery”.
2. En el tipo de campo tenemos que pararnos a pensar, que es lo que queremos que el campo haga. En nuestro caso, este campo sería como una categoría para un artículos en Joomla. Es decir, un artículo en Joomla siempre tiene que pertenecer a una categoría, pues una imagen en nuestro componente, siempre tiene que pertenecer a una galería.
   
   Como las galerías, cumplen el mismo principio de funcionamiento de una categoría (agrupar elementos) pues nuestro campo ideal sería el que aparece en la imagen, “Categoría de Joomla”. Ahora, no pienses que ésta va a ser una categoría que va a estar dentro del Gestor de artículos de Joomla. A pesar que vas a tener la misma interfaz visual que tienes en el Gestor de Artículos para la parte de las categorías, estas “Categorías” o Galerías en este caso, van a estar vinculadas al componente. Es decir, cuando entras al componente, ahí verás un sub-menú a la izquierda, que te va a indicar, por ejemplo en nuestro caso, “Images” que son las imágenes que hay creadas, y las “Categorías - Galerías” que hemos creado. Ahí vas a poder administrar, estas categorías de la misma forma que lo haces en el Gestor de Artículos.
3. Esta vista ya la conocemos. Elegiremos si este campo va a aparecer en esta vista y con cuál nombre. Luego, pensaremos si este campo es necesario llenarlo. Por ejemplo, un artículo siempre debe tener un título, por lo que ese campo es obligatorio, y si no se llena pues se mostrará un error indicando que es obligatorio su llenado. Pues esta casilla lo que hace es esto.

Recuerden, cualquier duda, vean la descripción del campo. Más abajo, veremos algo como esto:

Guiándonos por la numeración de la imagen anterior, tenemos que:

1. Esta vista ya la conocemos también. Aquí decidiremos si este campo aparecerá en ella, y con nombre. Las otras dos casillas son para facilitar la busqueda en ese listado, que puede hacerse extenso.

Listo todo los parámetros del campo, le damos en “Añadir campo” como les muestro en la imagen anterior, para generar el campo. Luego nos saldrá algo como esto:

Aquí nos va a indicar, que el campo fue guardado satisfactoriamente, y veremos nuestro nuevo campo añadido a la parte de abajo, como se muestra en la imagen. Si se fijan, también podrán ver que cada campo tiene a la derecha una serie de opciones, tanto informativas, como diferentes acciones. La herramienta nos muestra, el tipo de campo que es, en cual de las dos vistas que hemos hablado se encuentra, si es obligatorio. Esta es la parte informativa, lo otro son dos acciones que puedes hacer, tanto como clonar el campo, es decir hacer uno igual, como eliminarlo.

Como ven es fácil añadir un nuevo campo, solo hay que tener bien claro todo lo que queremos. La parte más difícil hasta ahora, ha sido sin duda, el tipo de campo que hay que poner para conseguir lo que queremos. Por ejemplo, si es mostrar un campo para que el usuario añada un título, pues ese sería el tipo de campo “Campo Texto”, o si queremos que el usuario añada una imagen, pues ese tipo de campo es “Gestor Multimedia”, o si queremos que el campo almacene un valor entero, pues ese sería de tipo “INT”.....es decir, solo es tener claro lo que queremos, para poder dar con el campo adecuado.

Creando el Componente: Generando la Extensión

Cuando tengamos todos nuestros campos listos de la tabla, pues ya es hora de generar el componente para empezar a utilizarlo en nuestro sitio, así de simple. Para ello solo debemos buscar el siguiente botón en la pantalla que estemos:

Este botón en dependencia de donde estemos, puede estar de la forma que les mostré en la imagen, o en el “cuadrante” de la derecha. Una vez hecho clic en el boton, le saldrá una pantalla como ésta y podrán descargar su componente:

Revisión Joomla

Hasta aquí hemos visto de qué forma trabaja esta herramienta creadora de componentes. Quisiera añadir algunos puntos que me parecieron importantes tener en cuenta. La Wiki de la herramienta se encuentra en Inglés, sin embargo todo el sitio de la herramienta se encuentra en varios idiomas. Seria bueno ir a la par del sitio y poder tener la Wiki, en otros idiomas también, ya que hay muchos puntos que pueden ser extendidos en esta documentación, que las descripciones de los campos no la tiene.

Por lo general la herramienta es fácil de usar, pero tiene un punto de difícil compresión, este es la parte de los “Tipos de Campos”. Aquí hay varios campos que pueden traer conflictos para usuarios noveles. Por ejemplo, el tipo de campo especial “Clave Externa”. A pesar que en la wiki explica su uso, hasta con un ejemplo, creo que merece un tratamiento más amplio. Por ello es que ayuda mucho a esta parte, el tener la wiki en los idiomas que se van incorporando al sitio.

Por lo demás, la herramienta es bien fácil, flexible, y muy completa. Cumple con su función principal, y el código que arroja es bien apegado al uso del framework Joomla. Por ello, es que mi revisión para esta excelente herramienta es de: