Criar um controlo de suplemento

Os suplementos de apresentação são referenciados utilizando o controlo de suplemento. Seleccione a partir de suplementos de composição pré-instalados ou seleccione os seus próprios suplementos personalizados.

[plugin:pluginname paramKey="paramVal" compute=" " htmlencode=" " start=" " end=" "]
Tag Body Content
[/plugin:pluginname]

1. Faça clique em Inserir um controlo a partir de um campo de concepção de elemento, componente ou modelo de apresentação. É apresentada a caixa de diálogo Ajuda de controlos.
2. Seleccione Componente de suplemento como tipo de controlo.
3. Seleccione um tipo de suplemento.
4. Seleccione o suplemento ao qual pretende fazer referência. As informações sobre o suplemento, e os parâmetros válidos, são apresentadas.
5. Seleccione se pretende incluir secções iniciais e finais. Pode introduzir texto adicional entre as secções inicial e final do controlo, bem como outros controlos de conteúdo da Web, tais como um controlo de componente ou elemento.
6. Faça clique em OK para adicionar o controlo à concepção do navegador.
7. Em seguida, pode adicionar parâmetros personalizados à concepção do controlo. Após ter adicionado o controlo à concepção, também pode adicionar os seguintes parâmetros ao controlo:

   Tabela 1. Parâmetros de controlo adicionais. Esta tabela apresenta os parâmetros adicionais que podem ser adicionados manualmente a este controlo.

   Parâmetros de controlos	Detalhes
   compute=" "	Se não especificada, a predefinição é "sempre", o que significa que o valor do controlo de suplemento é avaliado sempre que o controlo é apresentado numa lista, como, por exemplo, um componente de menu ou navegador. Utilize compute="once" para avaliar o controlo apenas uma vez.
   htmlencode=" "	Se htmlencode="true", os caracteres HTML reservados são convertidos em entidades de caracteres. Por exemplo, '<' é convertido em '&lt;'. Este parâmetro é útil se pretender impedir que os utilizadores adicionem código malicioso ou que alterem a concepção do respectivo texto utilizando HTML. Se não for especificado, a predefinição especificada pela propriedade cmpnt.htmlEncodeDefault no serviço WCM WCMConfigService é utilizada. Por predefinição, esta propriedade está definida como true.
   start=" " end=" "	Os atributos de início e fim são utilizados para translinear dados devolvidos por um controlo dentro de outros controlos, tais como HTML. Estes atributos não são obrigatórios.

   Controlo simples

   Para fazer referência a um suplemento sem especificar parâmetros ou conteúdo do corpo do controlo:

   [plugin:pluginname]

   Controlo abreviado

   Pode simplificar o controlo do suplemento para o seguinte: [pluginname]

   O controlo de suplemento abreviado não pode substituir um controlo de conteúdo da Web existente. Por exemplo, se tiver criado um suplemento denominado "Property", tem de utilizar o controlo completo: [Plugin:Property]. O controlo [Property] é considerado como um controlo de propriedade e não como um controlo de suplemento.

   Controlo simples com parâmetros

   Para fazer referência a um suplemento com parâmetros, mas sem conteúdo do corpo do controlo:

   [plugin:pluginname paramKey1="paramVal" paramKey2="paramVal" paramKey2="paramVal2"]

   Controlo de suplemento com controlo de conteúdo da Web como parâmetro

   [plugin:pluginname paramKey1="[IDCmpnt context='current' type='sitearea' field='id']"]

   Nota: Tem de utilizar plicas dentro do controlo de conteúdo da Web que está a ser utilizado como um valor de parâmetro.

   Controlo de suplemento com conteúdo do corpo

   Para referenciar um suplemento com parâmetros e conteúdo que incluem uma referência a um componente:

   [plugin:pluginname paramKey1="paramVal" paramKey2="paramVal" paramKey2="paramVal2"]
   This is the tag body content.
   <br>
   [component name="test"]
   <br>
   More content.
   [/plugin:pluginname]