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.

Comentarios
  1. […] Lo primero que tenemos que hacer es modificar el archivo XML y añadir una nueva etiqueta params. Dentro de esta etiqueta tendremos una etiqueta param por cada opción de configuración que requiera el módulo. En nuestro caso sólo necesitaremos un parámetro, de tipo text (una caja de texto) para más señas. Podéis consultar el resto de tipos disponibles en Parámetros para las extensiones de Joomla!. […]

    Responder

  2. Joomla! me da varias ideas para una web, a ver si cuando tenga un poco de tiempo libre desarrollo algo

    Responder

  3. […] publicado varios artículos sobre desarrollo para este CMS, como Creación de módulos en Joomla!, Tipos de parámetros para las extensiones de Joomla! y Bases de datos en […]

    Responder

  4. Gracias Zootropo, me encargaron un proyecto que esta en Joomla! y me va a ser de utilidad tu articulo. ASR.

    Responder

  5. Genaro

    Excelente Tutorial.

    Responder

  6. Anónimo

    que honda cbuena hobda

    Responder

  7. Hola ZooTropo gracias por compartir la información de manera sencilla, práctica, pero no por eso sin importancia, al contrario. Y felicidades!.

    Responder

  8. buen tutorial

    Responder

  9. Car.

    Excelente, gracias!

    Responder

  10. […] publicado varios artículos sobre desarrollo para este CMS, como Creación de módulos en Joomla!, Tipos de parámetros para las extensiones de Joomla! y Bases de datos en […]

    Responder

  11. Yer

    Gracias por la info me sirve de mucho para los proyectos que realizo. Sigue adelante.

    Responder

  12. 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

    Responder

Deja un comentario