Přidání vlastních vlastností webu

Do webu můžete přidat uživatelské vlastnosti v podobě párů název/hodnota. Tyto vlastnosti se uloží spolu s webem a zpřístupní se skriptům a komponentám na stránkách webu. Pomáhají parametrizovat nebo přizpůsobit si web, aniž by bylo nutné měnit základní skripty a kód komponenty.

Uživatelské vlastnosti lze například použít ke změně barvy pozadí stránky, zpřesnění výsledků vyhledávání, vyplňování seznamů a obecně k ovládání proměnných závislých na webu.

Vlastní vlastnosti webu se přidávají pomocí panelu nastavení při úpravě webu.

  1. Otevřete web pro úpravy.

  2. Na postranní liště klikněte na ikonu Ikona Nastavení a poté klikněte na volbu Vlastnosti webu Vlastnosti.

  3. Klikněte na tlačítko Přidat.
  4. Zadejte název a hodnotu pro vlastní vlastnost webu. Můžete přidat až 50 vlastních vlastností webu. Pole Název je omezeno na 200 znaků a pole Hodnota je omezeno na 2 000 znaků.

    Vlastní vlastnosti webu

  5. Kliknutím na X vedle páru název/hodnota jej odstraníte.
  6. Po skončení přidávání nebo odebírání vlastních vlastností webu klikněte na volbu Potvrdit.

Poznámka:

Změny se nesloučí s existujícími vlastními vlastnostmi webu. Po potvrzení změn vlastních vlastností webu se přepíší veškeré existující vlastní vlastnosti webu na základním webu.

Vlastní vlastnosti webu lze po definování používat při skriptování na webu a ve webových komponentách, například v zápatí nebo v poli Doplňkový řetězec dotazu v komponentách podporujících rozšíření SCSMacro, např. seznam obsahu, nebo v tokenech v názvu a komponentách odstavců.

Toto skriptování funguje s rozhraním SCSRenderAPI během běhu programu a během navrhování. Hodnoty vlastních vlastností webu jsou k dispozici také pro kód rozvržení a komponent v kompilátoru šablon prostřednictvím rozhraní SCSCompileAPI. Toto rozhraní obsahuje novou funkci analogickou funkci getCustomSiteProperty v rozhraní SCSRenderAPI, která umožňuje kódu rozvržení a komponent načíst hodnotu vlastní vlastnosti sekce.

Řekněme například, že chcete definovat vlastní rozvržení sekce, které pomocí rozhraní SCSRenderAPI volá a načítá vlastní vlastnosti webu pro záhlaví, kontaktní jméno a kontaktní e-mail. Následující skript vytvoří pomocí vlastních vlastností webu řetězec HTML, který se připojí k 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 );
            }
        },
    };

Při vytváření šablony z webu s přidanými uživatelskými vlastnostmi a při vytváření webu ze šablony obsahující uživatelské vlastnosti webu se uživatelské vlastnosti zachovají.