Soms wil je een stukje eigen code in je pagina’s, bijvoorbeeld een link naar een stylesheet of een paar regels CSS. Eigen codes bewaart die fragmenten op één plek. Je voegt een fragment één keer toe en het platform plaatst het voor je in je pagina’s, zodat je nooit een sjabloon hoeft te bewerken.
Voordat je begint
Eigen codes staat in het blok Integraties en API van het instellingenmenu. Drie dingen bepalen of je ermee kunt werken:
- Je rol heeft naast Platforminstellingen bijwerken ook Aangepaste code beheren nodig. Zonder dat recht kan de pagina geen fragmenten laden of opslaan.
- Aangepaste code beheren is nooit beschikbaar voor een aangepaste rol. De ingebouwde rollen Eigenaar en Beheerder hebben het.
- Je pakket moet eigen code bevatten. Is dat niet zo, dan wordt het aanmaken of opslaan van een fragment geweigerd.
Een fragment wordt precies zo in je pagina’s geplaatst als je het schrijft. Niets controleert of schoont de code eerst op, dus een kapotte tag kan elke pagina raken die het fragment laadt.
Een fragment toevoegen
Klik op Eigen code toevoegen boven de lijst, of op Nieuw zolang de lijst nog leeg is. Het venster heeft links drie onderdelen: Algemeen, Code en Toestemming.
- Algemeen bevat de Naam en een optionele Beschrijving, elk tot 255 tekens. Kies een naam die je later herkent, zoals de dienst waar het fragment bij hoort.
- Code bevat de Positie en de code-editor. De code zelf is verplicht.
- Toestemming bevat de Toestemmingscategorie, die hieronder wordt uitgelegd.
Klik op Aanmaken om op te slaan. Ontbreekt een verplicht veld, dan markeert een rode stip het onderdeel dat je aandacht nodig heeft.
Head of body
Positie bepaalt waar het fragment terechtkomt:
<head>plaatst het in de head van de pagina, waar stylesheets horen. Nieuwe fragmenten beginnen met deze keuze.<body>voegt het toe aan het eind van de body van de pagina.
Op een platform dat de standaardinstelling Zijbalk (links) gebruikt onder Vormgeving > Lay-out > Positie van de navigatie, worden fragmenten toegevoegd aan de pagina’s achter de login. Leden en je team laden ze allebei, omdat ze in dezelfde lay-out werken. De fragmenten worden toegevoegd nadat de pagina is geladen. Dat past bij HTML en CSS, zoals een style-blok of een link naar een stylesheet.
Toestemmingscategorie
De Toestemmingscategorie bepaalt of een fragment op cookietoestemming wacht. Noodzakelijk laadt zonder toestemming, en nieuwe fragmenten beginnen hier. De andere categorieën, Statistieken, Marketing en Voorkeuren, zijn bedoeld voor code die toestemming nodig heeft. De pagina’s achter de login vragen niet om toestemming, en een fragment in een van deze categorieën laadt daar niet. Houd de fragmenten die je nodig hebt dus in Noodzakelijk, en gebruik die categorie alleen voor code die volgens je privacyregels zonder toestemming mag.
Fragmenten vinden, bewerken en verwijderen
De lijst toont elk fragment met Naam, Positie en Beschrijving. Zodra er twee fragmenten zijn, verschijnt er een zoekveld boven de lijst. Dat vindt fragmenten op naam of beschrijving.
Wil je een fragment wijzigen, klik er dan op in de lijst of gebruik Bewerken, het potloodpictogram in de rij. De titel van het venster verandert in Code bewerken, en Opslaan wordt beschikbaar zodra je iets wijzigt.
Wil je een fragment verwijderen, gebruik dan Verwijderen, het prullenbakpictogram in de rij, of Verwijderen in het geopende venster, en bevestig. Het fragment wordt definitief verwijderd en laadt niet meer op je pagina’s.