Assistência ao utilizador para autores de conteúdo

Suplementos de utilizador

Os suplementos de utilizador são utilizados com o contexto de utilizador actual. Este tópico contém informações adicionais sobre alguns destes suplementos.

Suplemento de apresentação Locale

Utilize o suplemento de apresentação Locale para adicionar informações de configuração regional ao conteúdo da Web ou para inserir marcação no conteúdo da Web, dependendo da configuração regional actual. Este suplemento determina a configuração regional suportada preferencial no contexto actual.

O suplemento de apresentação Locale utiliza os seguintes atributos:

acceptLanguage

Define uma ou mais configurações regionais que podem ser seleccionadas pelo portal num contexto específico. Os valores do atributo têm de estar em conformidade com a especificação de sintaxe do campo do cabeçalho Accept-Language do protocolo HTTP/1.1. Para obter detalhes sobre este campo do cabeçalho, consulte a secção Accept-Language da Especificação RFC2616.

Se o atributo acceptLanguage não estiver definido, o portal considera todas as configurações regionais suportadas disponíveis como igualmente aceitáveis quando a configuração regional suportada preferida for determinada para o contexto seleccionado.

pattern

Define o formato de saída para a configuração regional impressa pelo suplemento Locale.

Os valores do atributo especificam um padrão que pode incluir os seguintes marcadores de posição:

{language}: Marcador de posição para o código de idioma com dias letras em minúsculas de uma configuração regional, conforme definido pela norma ISO-639.
{country}: Marcador de posição para o código de país com duas letras em maiúsculas, conforme definido pela norma ISO-3166.
{variant}: Marcador de posição para a variante específica do fornecedor ou específica do navegador de uma configuração regional.

Se o atributo pattern não estiver definido, é utilizado o seguinte padrão: {language}-{country}-{variant}.

printLocale

Define se a configuração regional suportada favorita que é determinada pelo suplemento Locale é inserida no conteúdo da Web. O atributo pode apresentar os seguintes valores:

true: A configuração regional suportada preferencial é gravada na marcação da página.
false: A configuração regional suportada preferencial da página não é gravada na marcação da página.

Ao combinar este atributo com o atributo acceptLanguage, os utilizadores podem definir conteúdo para ser apresentado apenas nas seguintes circunstâncias:

Se uma configuração regional específica for aplicável no contexto actual
Se uma configuração regional de um conjunto específico de configurações regionais for aplicável no contexto actual

Embora o corpo do controlo Plugin seja impresso se for suportada uma configuração regional aceitável, a configuração regional suportada preferida não é apresentada quando este atributo é definido como false.

Se o atributo printLocale não estiver definido, é utilizado um valor de true.

key

Como alternativa aos atributos listados anteriormente, pode utilizar o atributo chave para obter dados de configuração regionais adicionais. Os valores suportados são:

direction: Grava a direcção do texto base para a configuração regional suportada preferida do pedido para o conteúdo da Web. Por exemplo: "ltr".
xmlLocale: Grava a representação de cadeias de configuração regional suportada preferida do pedido, conforme definido pelo IETF BCP 47 para o conteúdo da Web. Por exemplo: "en".

Se o suplemento Locale especifica conteúdo de corpo, a marcação entre os controlos de início e de fim é apresentada apenas se a configuração regional suportada preferencial for determinada. Se nenhuma configuração regional suportada for aplicável no contexto actual, o suplemento Locale não insere marcação no conteúdo.

Exemplos:

Ao adicionar o suplemento Locale sem definir mais atributos, a configuração regional suportada preferencial no contexto actual é inserida no conteúdo da Web. É utilizado o formato predefinido de {language}-{country}-{variant} (por exemplo, es-ES-WIN):
```
[Plugin:Locale]
```
O atributo pattern define o formato de saída da configuração regional suportada favorita. O exemplo que se segue apresenta a configuração regional com um formato personalizado e omite o elemento de variante (por exemplo, es_ES):
```
[Plugin:Locale pattern="{language}_{country}"]
```
O exemplo seguinte apresenta o código de idioma da configuração regional suportada preferencial no contexto actual (por exemplo, da). Consequentemente, apenas são aceites os idiomas de países nórdicos. Se nenhuma das configurações regionais especificadas for suportada no contexto actual, nada é impresso no conteúdo da Web. Por exemplo, se o utilizador configurar o navegador da Web ou o perfil de utilizador do portal para utilizar apenas o idioma inglês (en), o suplemento Locale não devolve qualquer configuração regional.
```
[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}"]
```
Pode impedir que a configuração regional suportada preferencial seja apresentada com o atributo printLocale. Este exemplo insere o corpo do controlo Plugin no conteúdo da Web apenas se a configuração regional suportada favorita corresponder a um dos idiomas nórdicos especificados. A configuração regional determinada não é adicionada ao conteúdo da 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]
```

Pode também combinar o suplemento Locale com outros suplementos. O seguinte exemplo demonstra como utilizar o suplemento Matches com o suplemento Locale. A marcação no corpo do suplemento Matches é apresentada no conteúdo apenas se a configuração regional suportada preferencial representar um idioma espanhol.

[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 gravar a direcção do texto base para a configuração regional suportada preferida para o conteúdo da Web, tal como "ltr", utilize a chave atributo com o valor de direcção:
```
[Plugin:Locale key="direction"]
```
Para gravar a representação de cadeias da configuração regional suportada preferida do pedido, conforme definido pelo IETF BCP 47 para o conteúdo da Web, tal como "en", utilize o atributo chave com o valor xmlLocale:
```
[Plugin:Locale key="xmlLocale"]
```

Suplementos `If Device` e `If Not Device`

Utilize os suplementos If Device e If Not Device para apresentar conteúdo selectivamente com base numa classe de dispositivo do Portal de utilizador. Pode utilizar estes suplementos para mudar para componentes móveis, tais como apresentação de diapositivos ou sistema giratório optimizados para dispositivos móveis, quando um utilizador acede ao sítio através de um smartphone ou tablet.

O atributo de classe é definido pelas classificações do dispositivo para clientes suportados no IBM® WebSphere Portal. Inicie sessão no WebSphere Portal como administrador e faça clique no ícone Menu de administração na barra de ferramentas. Em seguida, faça clique em Definições do portal > Clientes suportados. Edite um cliente seleccionado para verificar as classes que já estão associadas ao mesmo. Pode adicionar ou remover classes através desta página.

Pode verificar se um dispositivo específico está a ser utilizado com o seguinte formato:

[Plugin:ifDevice class="DEVICE1" class="DEVICE2"]
Text to render if current device is DEVICE1 or DEVICE2.
[/Plugin:ifDevice]

Pode verificar se um dispositivo específico não está a ser utilizado com o seguinte formato:

[Plugin:ifNotDevice class="DEVICE1" class="DEVICE2"]
Text to render if current device is not DEVICE1 or DEVICE2.
[/Plugin:ifDevice]

É utilizado para apresentar texto, caso não esteja definido qualquer dispositivo:

[Plugin:ifDevice class=""]
Text to render if the device is not set.
[/Plugin:ifDevice]

Para especificar um dispositivo ou outro, utilize esta sintaxe:

[Plugin:ifDevice class="DEVICE1|DEVICE2"]
Text to render if current device is DEVICE1 or DEVICE2.
[/Plugin:ifDevice]

Para especificar um dispositivo e o outro, utilize esta sintaxe:

[Plugin:ifDevice class="DEVICE1+DEVICE2"]
Text to render if current device is DEVICE1 and DEVICE2.
[/Plugin:ifDevice]

Para especificar um dispositivo, mas não o outro, utilize esta sintaxe:

[Plugin:ifDevice class="DEVICE1+!DEVICE2"]
Text to render if current device is DEVICE1 but not DEVICE2.
[/Plugin:ifDevice]

Suplementos de utilizador

Suplemento de apresentação Locale

Suplementos If Device e If Not Device

Suplementos `If Device` e `If Not Device`