Tipos de parámetros para las extensiones de Joomla!

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.

13 comentarios en «Tipos de parámetros para las extensiones de Joomla!»

  1. Pingback: Creación de módulos en Joomla!

  2. Pingback: 100 programas gratis « Bichotoblog

  3. Pingback: » Tipos de parámetros para las extensiones de Joomla!

  4. Pingback: 100 programas gratis | Bichotoblog

Responder a Roberto Azrael Cancelar respuesta

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.