Assistência ao utilizador para autores de conteúdo

Utilizar o controlo do suplemento de apresentação de dados de análise

Utilize o controlo do suplemento de apresentação de dados de análise para injectar microformatos para Análise do sítio activo no seu conteúdo da Web.

Sobre esta tarefa

Os microformatos recolhem informações sobre os itens de conteúdo que são apresentados nas páginas do portal. Pode inserir mais do que um controlo no conteúdo.

Procedimento

Adicione o controlo do suplemento de dados de análise à concepção dos modelos de conteúdo ou apresentação. Cada controlo pode conter apenas um atributo. Utilize a seguinte sintaxe:

[Plugin:AnalyticsData property="" | element="" | value= "" 
                      css-class = ""]

Para seleccionar um valor utilizado no microformato para Análise do sítio activo, utilize um dos seguintes atributos:

property

Utilize este atributo para seleccionar uma das propriedades suportadas do item de conteúdo da Web. Este atributo pode suportar os seguintes valores:

id: O identificador exclusivo do conteúdo.
title: O título de apresentação do conteúdo.
path: O caminho exclusivo do conteúdo na biblioteca.
lastmodified: A data em que o conteúdo foi modificado pela última vez.
autores: O autor ou autores do conteúdo. Se o conteúdo tiver mais do que um autor, é gravado um controlo de microformato para cada autor.

element

Utilize este atributo para seleccionar um elemento a partir do conteúdo. O elemento tem de ser do tipo texto ou elemento de short text. Para o valor deste atributo, especifique o nome do elemento que pretende que seja seleccionado.

value

Utilize este atributo para transmitir um valor de texto para o suplemento. Se definir este atributo, também tem de definir o valor da classe de CSS, utilizando o atributo css-class. Consulte a seguinte descrição deste atributo para obter detalhes.

Nota: Numa única referência a um controlo, apenas pode utilizar um dos atributos anteriores. Se pretender utilizar mais do que um atributo, adicione outra referência ao controlo.

css-class: Utilize este atributo para controlar qual a classe de CSS utilizada para os controlos de microformato. Este atributo é obrigatório ao especificar o atributo value. O atributo é opcional ao utilizar o atributo property ou o atributo element. Se não especificar este atributo com o atributo property ou o atributo element, a classe de CSS é determinada a partir do valor do atributo property ou do atributo element. Neste caso, a classe de CSS é gerada adicionando o prefixo asa.wcm.content_item. e o valor do atributo property ou do atributo element.

Exemplos

[Plugin:AnalyticsData property="title"]

Esta definição selecciona o título de apresentação do item de conteúdo. É inserido na página o seguinte microformato:

<span style="display:none" class="asa.wcm.content_item.title">Display title</span>

[Plugin:AnalyticsData property="authors" css-class="com.acme.content.authors"]

Esta definição selecciona os autores do item de conteúdo. Se utilizar esta definição e uma classe de CSS personalizada, são inseridos os seguintes microformatos na página:

<span style="display:none" class="com.acme.content.authors">Author 1</span>
<span style="display:none" class="com.acme.content.authors">Author 2</span>

[Plugin:AnalyticsData element="element1"]

Esta definição seleccione o valor de texto do elemento no item de conteúdo. É inserido na página o seguinte microformato:

<span style="display:none" class="asa.wcm.content_item.element1">Value of element with name element1</span>

[Plugin:AnalyticsData element="element1" css-class="asa.wcm.content_item.path"]

Esta definição seleccione o valor de texto do elemento no item de conteúdo. É inserido na página o seguinte microformato:

<span style="display:none" class="asa.wcm.content_item.path">Value of element with name element1</span>

[Plugin:AnalyticsData value="Some text" css-class="asa.wcm.content_item.title"]

Esta definição utiliza o texto especificado pelo atributo value. É inserido na página o seguinte microformato:

<span style="display:none" class="asa.wcm.content_item.title">Some text</span>

[Plugin:AnalyticsData css-class="asa.wcm.content_item.title" value="[Property context='current' type='content' field='title']"]

Esta definição transmite o valor do controlo [Property] imbricado para o suplemento. É inserido na página o seguinte microformato:

<span style="display:none" class="asa.wcm.content_item.title">Display title from nested property tag</span>

[Plugin:AnalyticsData css-class="asa.tag.SitePromotion" value="Halloween2012"]

Esta definição cria uma etiqueta de promoção do sítio com o valor transmitido ao suplemento. É inserido na página o seguinte microformato:

<span style="display:none" class="asa.tag.SitePromotion">Halloween2012</span>