Además del tipo text
del que ya hablamos en Creación de módulos para Joomla! existen muchos otros tipos de parámetros que podemos utilizar a la hora de desarrollar los distintos tipos de extensiones que existen en Joomla (no solo en los módulos). Estos son:
calendar
Muestra una caja de texto en la que introducir una fecha junto con un icono sobre el que se puede pulsar para mostrar un calendario de tipo pop-up con el que seleccionar la fecha de forma más cómoda. Las distintas opciones disponibles para este tipo son las siguientes:
- name: nombre del parámetro. Es la cadena que se utiliza a la hora de recuperar el valor del parámetro
- label: etiqueta. Es el texto que acompañará al widget en la página de opciones del parámetro
- description: descripción del campo. Este texto se muestra al usuario cuando mantiene el cursor del ratón un cierto tiempo sobre el widget
- default: valor por defecto
- class: clase CSS a utilizar para la etiqueta
- format: formato de fecha a utilizar (usando los especificadores de fecha de PHP)
<param name="calendario" type="calendar" label="Fecha" description="Fecha en la que comienza el evento" format="%d-%m-%Y" />
category
Muestra una lista con las distintas categorías de una sección. Además de name, label, description, default y class otra opción interesante es section, cuyo valor será el identificador de la sección de la que queremos recuperar las categorías (si no se da ningún valor a este campo se recuperarán todas las categorías de todas las secciones).
<param name="categoria" type="category" label="Categoria" description="Categoria a mostrar en el modulo" />
editors
Muestra una lista con los distintos editores WYSIWYG instalados. Las únicas opciones para este parámetro son name, label, description y default.
filelist
Muestra una lista con los archivos contenidos en el directorio especificado. Además de name, label, description y default otras opciones útiles son:
- directory: directorio para el cuál se listarán los archivos. Si no se especifica ningún valor se asume la raíz de Joomla!
- filter: una expresión regular con la que filtrar los archivos mostrados en la lista.
- exclude: una expresión regular que especifica archivos a excluir de la lista.
- stripext: booleano que indica si deben ocultarse las extensiones de los archivos
- hide_none: booleano con el que indicar que no queremos que se muestre la opción ‘- No utilizar -‘
- hide_default: booleano con el que indicar que no queremos que se muestre la opción ‘- Usar el predeterminado -‘
<param name="archivo" type="filelist" label="Archivo a borrar" directory="directorio"/>
folderlist
Muestra una lista con las distintas carpetas contenidas en el directorio especificado. Cuenta con las mismas opciones que filelist.
imagelist
Muestra una lista con las imágenes contenidas en un cierto directorio. Cuenta con las mismas opciones que filelist y folderlist.
helpsites
Muestra una lista con los distintos sitios de ayuda de Joomla.
hidden
Crea un campo oculto.
languages
Muestra una lista con los idiomas instalados para una cierta aplicación.
list
Muestra una lista con distintas opciones entre las que elegir. Esta etiqueta contendrá una o más etiquetas option con las opciones.
<param name="ssoo" type="list" label="Sistema operativo"> <option value="windows">Windows</option> <option value="linux">Linux</option> <option value="mac">Mac OS</option> </param>
menu
Muestra una lista con los distintos menús disponibles en el sitio web.
menuitem
Muestra una lista con las distintas entradas de menú disponibles en el sitio web.
password
Muestra una caja de texto en la que se puede introducir una contraseña.
radio
Muestra un grupo de botones de opción. Como list, esta etiqueta contendrá una o más etiquetas option con las opciones.
<param name="ssoo" type="radio" label="Sistema operativo"> <option value="windows">Windows</option> <option value="linux">Linux</option> <option value="mac">Mac OS</option> </param>
section
Muestra una lista con las secciones disponibles en el sitio web.
spacer
Muestra un separador. Por defecto esto se traducirá en un <hr />. Si se da algún valor a default se mostrará este texto.
sql
Muestra una lista con los valores obtenidos al ejecutar una consulta SQL sobre la base de datos de Joomla. La consulta irá en la opción query y debe devolver un par de valores por tupla, uno con el texto a mostrar en la lista (con nombre title) y otro con el valor de la opción (con nombre value)
<param name="usuario" type="sql" default="Administrator" label="Selecciona el usuario" query="SELECT name AS title, username AS value FROM #__users" />
text
Muestra un campo de texto. Con la opción size se puede limitar el ancho del widget.
textarea
Muestra un área de texto. Las opciones cols y rows determinan, respectivamente, el número de columnas y filas de caracteres que ocupará el widget.
timezones
Muestra una lista de zonas horarias.
usergroup
Muestra una lista con los grupos de usuarios del sitio.
Pingback: Creación de módulos en Joomla!
Joomla! me da varias ideas para una web, a ver si cuando tenga un poco de tiempo libre desarrollo algo
Pingback: 100 programas gratis « Bichotoblog
Gracias Zootropo, me encargaron un proyecto que esta en Joomla! y me va a ser de utilidad tu articulo. ASR.
Excelente Tutorial.
Pingback: » Tipos de parámetros para las extensiones de Joomla!
que honda cbuena hobda
Hola ZooTropo gracias por compartir la información de manera sencilla, práctica, pero no por eso sin importancia, al contrario. Y felicidades!.
buen tutorial
Excelente, gracias!
Pingback: 100 programas gratis | Bichotoblog
Gracias por la info me sirve de mucho para los proyectos que realizo. Sigue adelante.
Estube buscando como hacer parametros para joomla 1.7 joomla 2.5 y joomla 3 y esta pagina me servio mucho para terminar mi componente de integracion de joomla con OpenKM
http://docs.joomla.org/Standard_form_field_and_parameter_types1