Widget: SelectResourcesByTypeWidget

Nuevo widget para nuestros recursos de OpenCms que nos permite mostrar en un select todos los recursos de un tipo concreto, pertenecientes a una categoría o de una carpeta concreta.

Descripción general

Este widget está dentro de nuestro móduo SagaSuiteCore a partir de la versión 0.9.6.

Su finalidad es ofrecer al usuario editor de contenidos un campo select (lista desplegable) con una lista de recursos de OpenCms. El editor verá la propiedad Title del recurso mientras que internamente lo que estamos guardando es directamente el path completo al recurso.

Este widget se puede utilizar tanto para campos del tipo OpenCmsString como para campos OpenCmsVfsFile. En este último casa se generará una relación interna de OpenCms entre los recursos.

El widget tiene 3 opciones de configuración:

  • type: Podemos indicar el nombre del tipo de recurso de OpenCms por el que queremos filtrar.
  • folder: Podemos filtrar solo los recursos que cualgan de una carpeta concreta del VFS
  • category: Filtraremos todos los recursos que pertenecen a la categoría indicada.

El filtro por tipo de recurso es combinable con los otros dos, de forma que podemos filtrar los recursos de un tipo concreto que estén en una carpeta o pertenezcan a una categoría. Lo que no es posible combinar las opciones folder y categoría, prevaleciendo la configuración por categoría.

Ejemplo de uso

<xsd:element name="Normativa" type="OpenCmsVfsFile" minOccurs="1" maxOccurs="unbounded"/>

 

Filtrar los recursos de un tipo concreto:

<layout element="Normativa" widget="com.saga.sagasuite.core.widget.SelectResourcesByTypeWidget" 
configuration="type=palnormativa" />

Filtrar los recursos de un tipo concreto situados en una carpeta:

<layout element="Normativa" widget="com.saga.sagasuite.core.widget.SelectResourcesByTypeWidget" 
configuration="type=palnormativa|folder=/.content/" />

Filtrar los recursos de un tipo concreto pertenecientes a una categoría:

<layout element="Normativa" widget="com.saga.sagasuite.core.widget.SelectResourcesByTypeWidget" 
configuration="type=palnormativa|category=normativa/seguridad/" />