Acrescentar Propriedades do Site Customizadas

Pode acrescentar propriedades customizadas a sites sob a forma de pares nome/valor. Estas propriedades são armazenadas com o site e disponibilizadas para scripts e componentes nas páginas do site. Estas podem ajudar a parametrizar ou customizar o site sem ter de alterar os scripts subjacentes e o código componente.

Por exemplo, as propriedades customizadas podem ser utilizadas para alterar a cor de fundo da página, refinar resultados de pesquisa, preencher listas e controlar, de modo geral, as variáveis dependentes dos sites.

As propriedades de site customizadas são acrescentadas utilizando o painel de definições ao editar um site.

  1. Abra um site para edição.

  2. Clique em ícone Definições na barra lateral e, em seguida, clique em Propriedades do Site Propriedades do Site.

  3. Clique em Acrescentar.
  4. Introduza um nome e valor para a propriedade do site customizada. Pode acrescentar até 50 propriedades do site customizadas. Existe um limite de 200 caracteres no campo de nome e um limite de 2000 caracteres no campo de valor.

    Propriedades do Site Customizadas

  5. Clique no X junto ao par nome/valor para apagá-lo.
  6. Depois de concluir o acréscimo ou a remoção das suas propriedades de site customizadas, clique em Confirmar.

Nota:

As alterações não são fundidas com as propriedades de site customizadas existentes. A confirmação de alterações nas propriedades de site customizadas substitui todas as propriedades de site customizadas existentes no site base.

Uma vez definidas, as propriedades de site customizadas podem ser utilizadas para a criação de scripts no site e em componentes do site, por exemplo, no rodapé ou no campo Cadeia de Caracteres de Consulta Adicional em componentes que suportem expansão SCSMacro, como a lista de conteúdos ou através de tokens nos componentes de título e de parágrafo.

Estes scripts funcionam com a SCSRenderAPI durante o runtime e durante a conceção. Adicionalmente, os valores da propriedade de site customizada estão disponíveis para a disposição e código de componente no compilador do modelo através da SCSCompileAPI. Esta API dispõe de uma nova função análoga à SCSRenderAPI, getCustomSiteProperty, que permite que a disposição e o código componente leiam o valor de uma propriedade de secção customizada.

Por exemplo, imagine que pretende definir uma disposição de secção customizada que utiliza a SCSRenderAPI para chamar e obter propriedades do site customizadas para o cabeçalho, nome do contacto e endereço de correio eletrónico do contacto. O script seguinte cria uma cadeia de caracteres em HTML utilizando as propriedades de site customizadas que são anexadas ao DOM.

define([
    'jquery'
], function( $ ){
    'use strict';

    function SectionLayout( params ) {
    }
    SectionLayout.prototype = {
        render: function( parentObj ) {
            var html = '';

            try {
                html += '<div>';
                    html += '<h1>' + SCSRenderAPI.getCustomSiteProperty('SiteGreeting') + '</h1>;
                    html += '<div>For more information, contact <a href="mailto:' + SCSRenderAPI.getCustomSiteProperty('ContactEmail')
                        '"> + SCSRenderAPI.getCustomSiteProperty('ContactName') + '</a></div>';
                html += '</div>';
                $(parentObj).append( html );
            } catch( e ) {
                console.error( e );
            }
        },
    };

As propriedades customizadas são preservadas ao criar um modelo a partir de um site com propriedades de site customizadas acrescentadas e ao criar um site a partir de um modelo que tenha propriedades de site customizadas.