Suplementos de conteúdo

Os suplementos de conteúdo são utilizados com o item de conteúdo actual.

Suplemento de dados de análise

• Este suplemento grava informações adequadas para a análise do sítio activo.
• Por exemplo: [Plugin:AnalyticsData property="title" css-class="asa.wcm.content_item.title"]

Suplemento de cópia de texto

• Este suplemento grava texto uma vez ou várias vezes.
• A sintaxe do suplemento é [Plugin:CopyText text="" count="" separator="" format="trim | tolower | toupper" escape="xml | json | none"].

Suplemento Se for índice de listas

• Este suplemento grava a marcação do corpo incluída com base na contagem na qual o item actual está posicionado na apresentação de um componente Menu, Navegador, Procura, Personalization ou Taxonomia. O suplemento apresenta o corpo, se a contagem actual se encontrar entre os números especificados, sujeitos ao valor 'by'. O primeiro item na lista tem a contagem 1. Os valores 'from' e 'to' podem ser obtidos, se não for necessário qualquer associação inferior ou superior.
• Por exemplo:
  • [Plugin:ifListIndex is='2'] apresenta o corpo do segundo item.
  • [Plugin:ifListIndex from='2'] apresenta o corpo de todos os itens da partir do segundo.
  • [Plugin:ifListIndex to='3'] apresenta o corpo de todos os itens até ao terceiro.
  • [Plugin:ifListIndex from='2' to='8'] apresenta o corpo de itens do segundo ao oitavo.
  • [Plugin:ifListIndex from='1' by='2'] ou [Plugin:ifListIndex by='odd'] apresenta o corpo de todos os itens ímpares.
  • [Plugin:ifListIndex from='2' by='2'] ou [Plugin:ifListIndex by='even'] apresenta o corpo de todos os itens pares.

Suplemento Se for índice de contagem

• Este suplemento é semelhante ao Suplemento ifListIndex. Grava a marcação do corpo incluída com base na contagem na qual o item actual está posicionado na apresentação de um componente Menu, Navegador, Procura,Personalization ou Taxonomia que apresente o suplemento IfCountIndex, mas conta apenas os itens visíveis num componente Menu, Navegador, Procura, Personalization ou Taxonomia. O suplemento apresenta o corpo, se a contagem actual se encontrar entre os números especificados, sujeitos ao valor 'by'. O primeiro item na lista tem a contagem 1. Os valores 'from' e 'to' podem ser obtidos, se não for necessário qualquer associação inferior ou superior.
• Por exemplo:
  • [Plugin:ifCountIndex is='2'] apresenta o corpo do segundo item contado.
  • [Plugin:ifCountIndex from='2'] apresenta o corpo de todos os itens contados a partir do segundo item de conteúdo.
  • [Plugin:ifCountIndex to='3'] apresenta o corpo de todos os itens contados até ao terceiro item contado.
  • [Plugin:ifCountIndex from='2' to='8'] apresenta o corpo dos itens contados do segundo ao oitavo.
  • [Plugin:ifCountIndex from='1' by='2'] ou [Plugin:ifCountIndex by='odd'] apresenta o corpo de todos os itens contados ímpares.
  • [Plugin:ifCountIndex from='2' by='2'] ou [Plugin:ifCountIndex by='even'] apresenta o corpo de todos os itens contados pares.

Tabela 1.

Item	Etiqueta IfCountIndex apresentado na lista	Método de contagem utilizado pelo Suplemento Se for índice de listas	Método de contagem utilizado pelo Suplemento Índice de conteúdo
Item 1	Não	1	Nenhum
Item 2	Sim	2	1
Item 3	Sim	3	2
Item 4	Não	4	2

Suplemento Codificação de JavaScript e XML

• Este suplemento codifica JavaScript ou XML.
• Por exemplo: [Plugin:jsencode enc="js|xml|jsxml" value="myValue"]

Suplemento Avaliações

• Este suplemento fornece suporte para as opções de avaliação do item de conteúdo.
• [Plugin:ratings]

Suplemento Acção remota

• Utilizado para criar um URL para uma acção de autoria remota.
• Por exemplo: [Plugin:RemoteAction action="edit" useCurrentContext="true" dialog="true"]

Suplemento Etiquetas

• Este suplemento fornece suporte para atribuição de etiquetas para itens de conteúdo.
• [Plugin:tags]

Suplemento Fornecedor de texto

• Utilizado para gravar um valor de um fornecedor de texto.
• A sintaxe do suplemento é [Plugin:TextProvider provider="" key="" defaultValue="" param.0="" param.1="" param.X=""] em que o parâmetro "provider" tem de ser definido com o nome do fornecedor do texto e o parâmetro "key" com a chave que deve ser obtida.
• Se não tiver sido definido nenhum fornecedor, é utilizado o fornecedor de texto que está definido para o título do conteúdo actual.
• O parâmetro opcional "defaultValue" pode ser utilizado para definir um valor gravado, caso o fornecedor de texto não devolva um resultado. Caso contrário, este suplemento não grava qualquer conteúdo.
• Os marcadores de posição no texto são substituídos pelos valores de todos os parâmetros opcionais especificados na etiqueta de suplemento.
• A partir do CF09, pode também utilizar o nome alternativo de etiqueta "Localizado" para esta etiqueta. Este procedimento pode ser mais útil se utilizar esta etiqueta simplesmente para apresentar texto localizado. Por exemplo: [Plugin:Localized provider="translated" key="title"].
• 
  Se pretender utilizar a etiqueta de suplemento TextProvider mais do que uma vez numa concepção de componente ou concepção de modelo de apresentação, pode especificar o caminho do nome de fornecedor de texto predefinido numa etiqueta:

  [Plugin:TextProvider defaultProvider="library/sitearea/contentitem"]

  Em seguida, pode omitir o parâmetro de fornecedor nas etiquetas que se seguem à etiqueta de fornecedor predefinida:

  [Plugin:TextProvider defaultProvider="library/sitearea/contentitem"]
  [Plugin:TextProvider key="key1"]
  [Plugin:TextProvider key="key2"]
  [Plugin:TextProvider key="key3"]

  O fornecedor predefinido é aplicado em todas as concepções de modelo de apresentação e concepções de componentes, incluindo concepções de componentes incluídas utilizando as etiquetas, tais como a etiqueta de componente.

  Para remover o fornecedor predefinido, utilize:

  [Plugin:TextProvider defaultProvider=""]