Tilføj tilpassede siteegenskaber

Du kan føje tilpassede egenskaber til sites i form af navne-/værdipar. Disse egenskaber gemmes sammen med sitet og gøres tilgængelige for scripts og komponenter på sitets sider. Disse kan hjælpe med at parameterisere eller tilpasse sitet, uden at det er nødvendigt at ændre de underliggende scripts og den underliggende komponentkode.

Tilpassede egenskaber kan for eksempel bruges til at ændre sidens baggrundsfarve, indsnævre søgeresultater, udfylde lister og generelt styre siteafhængige variabler.

Tilpassede siteegenskaber tilføjes ved hjælp af panelet Indstillinger under redigering af et site.

1. Åbn et site til redigering.

2. Klik på i sidepanelet, og klik derefter på Egenskaber for site.

3. Klik på Tilføj.
4. Indtast et navn på og en værdi for den tilpassede siteegenskab. Du kan tilføje op til 50 tilpassede siteegenskaber. Der er en grænse på 200 tegn for navnefeltet og en grænse på 2000 tegn for værdifeltet.

   

5. Klik på X ud for et navne-/værdipar for at slette det
6. Klik på Bekræft, når du er færdig med at tilføje eller fjerne tilpassede egenskaber for sitet.

Når de tilpassede siteegenskaber er defineret, kan de bruges i scripting på hele sitet og i alle sitekomponenter, for eksempel i sidefoden eller i feltet Yderligere forespørgselsstreng i komponenter, der understøtter SCSMacro-udvidelse, herunder indholdslisten, eller via tokens i titel- og afsnitskomponenter.

Denne scripting fungerer sammen med SCSRenderAPI under runtime og design. Værdierne for tilpassede siteegenskaber er desuden tilgængelige for layout- og komponentkode i skabelon-compileren via SCSCompileAPI. Denne API har en ny funktion, som kan sammenlignes med SCSRenderAPI og getCustomSiteProperty, som gør det muligt for layout- og komponentkode at læse værdien for en tilpasset sektionsegenskab.

Lad os for eksempel antage, at du vil definere et tilpasset sektionslayout, der bruger SCSRenderAPI til at kalde og hente tilpassede siteegenskaber for overskriften, kontaktens navn og kontaktens e-mail. Følgende script bygger en HTML-streng ved hjælp af tilpassede siteegenskaber, der føjes til DOM'en.

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 );
            }
        },
    };

Tilpassede egenskaber bevares, når der oprettes en skabelon fra et site med tilføjede tilpassede siteegenskaber, og når der oprettes et site fra en skabelon med tilpassede siteegenskaber.