|
Asistencia al usuario para autores de contenido |
|---|
Plug-ins de usuario
Los plug-ins de usuario se utilizan con el contexto de usuario actual. Este tema contiene información adicional para algunos de estos plug-ins.
Plug-in de representación de entorno local
Utilice el plug-in de representación de Locale para añadir información de entorno local al contenido web o para insertar la marcación en el contenido web, en función del entorno local actual. Este plugin determina el entorno local soportado preferido en el contexto actual.
El plug-in de representación de Locale
utiliza los siguientes atributos:
- acceptLanguage
- Define uno o varios entornos locales preferidos que seleccionar el portal en un determinado contexto. Los valores de atributo deben cumplir con
la especificación de sintaxis del campo de cabecera Accept-Language
del protocolo HTTP/1.1. Para obtener detalles sobre el campo de cabecera,
consulte la sección Accept-Language de la
especificación RFC2616.
Si no se define el atributo acceptLanguage, el portal tiene en cuenta todos los entornos locales a los que da soporte al determinar el entorno local soportado preferido para el contexto seleccionado.
- pattern
- Define el formato de salida para el entorno local que imprime el plug-in Locale.Los valores de atributo especifican un patrón que pueden incluir los siguientes marcadores de posición:
- {language}: Marcador para las minúsculas, código de idioma de dos letras de un entorno local tal como se define en la norma ISO-639.
- {country}: Marcador para las mayúsculas, código de país de dos letras de un entorno local tal como se define en la norma ISO-3166.
- {variant}: Marcador para la variante específica de proveedor o de navegador de un entorno local.
Si el atributo pattern no se ha definido, se utilizará el siguiente patrón: {language}-{country}-{variant}.
- printLocale
- Define si el entorno local soportado que viene determinado por el plug-in Locale se inserta en el contenido web. El atributo puede tener los valores siguientes:
- true: el entorno local soportado preferido se grabará en la marcación de la página.
- false: el entorno local soportado preferido no se grabará en la marcación de la página.
Al combinar el atributo con el atributo acceptLanguage, los usuarios pueden definir el contenido que se representará sólo en las siguientes situaciones:- Si un entorno local es aplicable en el contexto actual
- Si un entorno local de un determinado conjunto de entornos locales es aplicable en el contexto actual
Si no se ha definido el atributo printLocale, se utiliza un valor de true.
key- Como alternativa a los atributos listados anteriormente, puede utilizar el atributo clave para recuperar datos del entorno local alternativos. Los valores admitidos son:
- direction: escribe la dirección del texto de base para el entorno local preferido de la solicitud para el contenido web. Por ejemplo: "ltr".
- xmlLocale: escribe la representación de serie del entorno local admitido preferido de la solicitud tal como se define en IETF BCP 47 para el contenido web. Por ejemplo: "en".
Si el plug-in Locale especifica contenido para el cuerpo, la marcación entre los códigos de inicio y de finalización se representa sólo si viene determinado el entorno local soportado. Si no se aplica ningún entorno local soportado en el contexto actual, el plug-in Locale no inserta código de marcación en el contenido.
Ejemplos:
- Al añadir el plug-in Locale
sin definir más atributos adicionales, el entorno local soportado preferido en
el contexto actual se inserta en el contenido web. Se utiliza el formato predeterminado de {language}-{country}-{variant}
(por ejemplo, es-ES-WIN):
[Plugin:Locale] - El atributo pattern define
el formato de salida del entorno local soportado. El ejemplo siguiente representa el entorno local con un formato personalizado y omite el elemento de variante (por ejemplo, es_ES):
[Plugin:Locale pattern="{language}_{country}"] - El ejemplo siguiente representa el código de idioma del entorno local soportado preferido en el contexto actual (por ejemplo, da). Sólo se aceptan idiomas de países nórdicos. Si ninguno de los entornos locales especificados tiene soporte en el contexto actual, no se imprimirá nada en su contenido web. Por ejemplo, si el usuario configura el navegador web o el perfil de usuario del portal para utilizar sólo el idioma inglés (en),
el plug-in Locale no devuelve
ningún entorno local.
[Plugin:Locale acceptLanguage="da,fo;q=0.8,fi;q=0.6,is;q=0.4,no;q=0.2,sv;q=0.2" pattern="{language}"] - Puede evitar que se represente el entorno local soportado preferido con el atributo printLocale.
En este ejemplo se inserta el cuerpo del código Plugin
en el contenido web sólo si el entorno local soportado preferido coincide con uno de los idiomas nórdicos especificados. El entorno local determinado no se añade al contenido web.
[Plugin:Locale acceptLanguage="da,fo;q=0.8,fi;q=0.6,is;q=0.4,no;q=0.2,sv;q=0.2" printLocale="false"] <div>This markup is displayed only if the current context supports a locale that represents one of the specified Nordic languages.</div> [/Plugin:Locale] - También puede combinar el plug-in Locale
con otros plug-ins. El ejemplo siguiente muestra cómo puede utilizar el plug-in Matches con el plug-in Locale.
La marcación del cuerpo del plug-in Matches
se representa en el contenido sólo si el entorno local admitido
representa el idioma español.
[Plugin:Matches pattern="es(.*)" text="[Plugin:Locale]"] <div>This markup appears only if the preferred supported locale in the current context represents a Spanish language. Neither the country code nor the variant are important as long as the language code of the locale is "es".</div> [/Plugin:Matches] - Para escribir la dirección del texto de base para el entorno local admitido preferido de la solicitud para el contenido web, como "ltr", utilice el atributo clave con la dirección del valor:
[Plugin:Locale key="direction"] - Para escribir la representación de serie del entorno local admitido preferido de la solicitud tal como lo define IETF BCP 47 para el contenido web, como "en", utilice el atributo clave con el valor xmlLocale:
[Plugin:Locale key="xmlLocale"]
Plug-ins If Device y If Not Device
Utilice los plug-ins If Device y If Not Device para representar contenido de forma selectiva, en función de la clase de dispositivo de Portal del usuario. Puede utilizar estos plug-ins para cambiar a componentes móviles, como por ejemplo una presentación o un carrusel optimizados para dispositivos móviles, cuando un usuario visita el sitio a través de un smartphone o tablet.El atributo de clase se define mediante las clasificaciones de dispositivos para los clientes admitidos en IBM® WebSphere Portal. Inicie la sesión en WebSphere Portal como administrador y pulse en el icono menú Administración de la barra de herramientas. A continuación, haga clic en los . Edite un cliente seleccionado para ver las clases que ya están asociadas con él. Puede añadir o eliminar clases a través de esta página.
Puede comprobar que un determinado dispositivo está en uso con el formato siguiente:
[Plugin:ifDevice class="DEVICE1" class="DEVICE2"] Text to render if current device is DEVICE1 or DEVICE2. [/Plugin:ifDevice]
Puede comprobar que un determinado dispositivo no está en uso con el formato siguiente:
[Plugin:ifNotDevice class="DEVICE1" class="DEVICE2"] Text to render if current device is not DEVICE1 or DEVICE2. [/Plugin:ifDevice]
Se utiliza para representar el texto si no se ha establecido ningún dispositivo:
[Plugin:ifDevice class=""] Text to render if the device is not set. [/Plugin:ifDevice]
Para especificar un dispositivo u otro, utilice esta sintaxis:
[Plugin:ifDevice class="DEVICE1|DEVICE2"] Text to render if current device is DEVICE1 or DEVICE2. [/Plugin:ifDevice]
Para especificar un dispositivo
y otro, utilice esta sintaxis:
[Plugin:ifDevice class="DEVICE1+DEVICE2"] Text to render if current device is DEVICE1 and DEVICE2. [/Plugin:ifDevice]
Para especificar un dispositivo
pero no otro, utilice esta sintaxis:
[Plugin:ifDevice class="DEVICE1+!DEVICE2"] Text to render if current device is DEVICE1 but not DEVICE2. [/Plugin:ifDevice]