Räätälöityjen sivustojen ominaisuuksien lisäys

Voit lisätä sivustoihin räätälöityjä ominaisuuksia nimi-arvoparien muodossa. Kyseiset ominaisuudet tallennetaan sivustoon, ja ne ovat komentosarjojen ja komponenttien käytettävissä sivuston sivuilla. Näin sivustolle voidaan määrittää parametreja tai sitä voidaan räätälöidä muuttamatta perustana olevia komentosarjoja ja komponenttikoodia.

Räätälöityjen ominaisuuksien avulla voidaan esimerkiksi muuttaa sivun taustaväriä, tarkentaa hakutuloksia, täyttää listoja ja ylipäänsä ohjata sivustokohtaisia muuttujia.

Räätälöityjä sivuston ominaisuuksia lisätään käyttämällä Asetukset-paneelia sivuston muokkauksen yhteydessä.

Avaa sivusto muokattavaksi.
Valitse sivupalkista ja valitse sitten Sivuston ominaisuudet.
Valitse Lisää.
Syötä nimi ja arvo räätälöidylle sivuston ominaisuudelle. Voit lisätä enintään 50 räätälöityä sivuston ominaisuutta. Nimikentällä on 200 merkin ja arvokentällä 2 000 merkin rajoitus.
Voit poistaa nimi-arvoparin napsauttamalla sen nimen vieressä olevaa X-painiketta.
Kun olet lisännyt tai poistanut räätälöidyn sivuston ominaisuudet, valitse Vahvista.

Huomautus::

Muutoksia ei yhdistetä olemassa olevien räätälöityjen sivuston ominaisuuksien kanssa. Kun räätälöityihin sivuston ominaisuuksiin tehdyt muutokset vahvistetaan, kaikki perussivuston olemassa olevat räätälöidyt sivuston ominaisuudet korvataan.

Kun räätälöidyt sivuston ominaisuudet on määritetty, niitä voidaan käyttää koko sivuston ja kaikkien sivustokomponenttien komentosarjoissa, kuten alatunnisteessa tai sisältölistan kaltaisten, SCSMacro-laajennusta tukevien komponenttien Lisäkyselymerkkijono-kentässä. Tunnisteiden avulla niitä voidaan käyttää myös otsikko- ja kappalekomponenteissa.

Tämä komentosarja käyttää SCSRenderAPI-funktiota ajon ja suunnittelun aikana. SCSCompileAPI-funktion kautta myös räätälöidyn sivuston ominaisuusarvot ovat käytettävissä asettelu- ja komponenttikoodia varten mallipohjan kääntäjässä. Tällä API-liittymällä on uusi funktio getCustomSiteProperty, joka vastaa SCSRenderAPI-funktiota. Sen avulla asettelu- ja komponenttikoodi voi lukea räätälöidyn osan ominaisuuden arvon.

Oletetaan vaikka, että haluat määrittää räätälöidyn osan asettelun, joka käyttää SCSRenderAPI-funktiota kutsumaan ja hakemaan räätälöityjä sivuston ominaisuuksia otsikolle, yhteyshenkilön nimelle ja yhteyshenkilön sähköpostiosoitteelle. Seuraava komentosarja muodostaa HTML-merkkijonon käyttäen räätälöityjä sivuston ominaisuuksia, jotka liitetään DOMiin.

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

Räätälöidyt ominaisuudet säilytetään luotaessa mallipohjaa sivustosta, johon on lisätty räätälöityjä sivuston ominaisuuksia, ja luotaessa sivustoa mallipohjasta, joka sisältää räätälöityjä sivuston ominaisuuksia.