Objekt SCS

JavaScript radiča používa premenné a vlastnosti definované v globálnom objekte SCS na vykreslenie webovej stránky. Globálny objekt JavaScript musí byť v súbore radiča definovaný ešte pred pridaním súboru controller.js. Existujú dve primárne vlastnosti v objekte SCS, ktoré je možné použiť na prispôsobenie:

SCS.sitePrefix

Premenná SCS.sitePrefix definuje predponu cesty online lokality. Predvolenou hodnotou je zvyčajne site/<siteName>/.

Kód JavaScript radiča pomocou tejto hodnoty určuje, ktorá webová stránka sa má zobraziť. Ak prehľadávač požaduje napríklad stránku /site/SampleSite/products/index.html, hodnota sitePrefix /site/SampleSite/ umožní, aby kód JavaScript vypočítal, že na lokalite sa má zobraziť stránka products/index.html. Upozorňujeme, že sitePrefix musí byť hodnota reťazca, ktorá sa začína a končí znakom „/“.

Ak sa používa proxy alebo iná infraštruktúra, napríklad Akamai, a pravidlá mapovania adresy URL, modifikovaním tejto premennej je možné prispôsobiť predponu lokality. Ak pre sitePrefix nastavíte napríklad hodnotu /intranet/ExampleSite/, webovú lokalitu bude možné dodať s týmto názvom cesty v prehľadávači namiesto predpony predvolenej cesty /site/SampleSite/.

Poznámka:

Predvolený kód JavaScript radiča interne použije znak lomky „/“ ako sitePrefix, ak sa adresa URL v prehľadávači nezhoduje s predponou lokality. To umožní poskytovanie lokality s použitím zjednodušenej domény bez prispôsobenia.

SCS.preInitRendering

Ak je definovaná, kód JavaScript radiča volá funkciu SCS.preInitRendering ešte pred tým, ako sa spustí ktorákoľvek z jeho výpočtových logík. Ide o užitočnú funkciu, ktorá vo vlastných súboroch radiča definuje prepisovanie základných operácií JavaScript radiča.

Ak je definovaná, SCS.preInitRendering musí byť funkcia. Volanie tejto funkcie je bez argumentov a neočakáva ani nespracuje sa žiadna návratová hodnota.

SCS.getDeviceInfo

Funkcia SCS.getDeviceInfo umožňuje prispôsobenie logiky detekcie zariadenia vnútri kódu JavaScript radiča. Táto detekcia sa používa na určenie, či sa má dodať mobilná alebo responzívna verzia stránky.

Funkcia SCS.getDeviceInfo neprijíma žiadne argumenty a vracia objekt JavaScript, ktorý má dve vlastnosti:

  • isMobile – boolovská vlastnosť označujúca, že aktuálne zariadenie je mobilným klientom, napríklad smartfónom.

  • isIOS – boolovská vlastnosť označujúca, že aktuálne zariadenie má spustený operačný systém iOS.

Ak vlastný radič neprepíše funkciu SCS.getDeviceInfo, použije sa vstavaná predvolená implementácia.