Eigen content met Objecten

Met de module Objecten model je content die geen product is: diensten, boekingen, projecten, teamleden, landingspagina's, alles wat je storefront nodig heeft. Je definieert een objecttype (het model: de naam en de eigenschappen) en maakt vervolgens records van dat type aan (de daadwerkelijke items). Elk type krijgt een eigen item in de zijbalk onder Content → Objecten, onder zijn meervoudsnaam, en je storefront kan de records uitlezen via de Objects API. Drie pagina's gaan dieper: Publiceren en adressen, Vertalingen en Veldsoorten en herhaalblokken.

Objecten verschijnt in de zijbalk onder de groep Content wanneer de module is ingeschakeld voor het actieve bedrijf. Elk lid van het bedrijf ziet dezelfde schermen en acties.

Een objecttype aanmaken#

1. Open Content → Objecten in de zijbalk.
2. Klik op Nieuw type. Er opent een venster met de titel Nieuw objecttype met één naamveld (placeholder: Naam (bijv. Service)). De knop Aanmaken blijft uitgeschakeld totdat je een naam typt.
3. Klik op Aanmaken. Je komt direct op de bouwpagina van het nieuwe type terecht, waar je de eigenschappen definieert.

Het Objecten-overzicht toont al je typen in een tabel:

Het tandwielicoon aan het einde van elke rij opent de typebouwer.

Een type bewerken in de typebouwer#

In de typebouwer geef je een type vorm nadat je het hebt aangemaakt. Open de bouwer via het tandwielicoon op het Objecten-overzicht, of via de knop Type op de recordlijst van het type. Vanuit de bouwer brengt Records bekijken je de andere kant op, naar de recordlijst.

Je kunt de Naam en Meervoudsnaam van het type bewerken en op Opslaan klikken (een korte "Opgeslagen." bevestigt dit). De sleutel kan niet worden gewijzigd; de bouwer toont Sleutel: {key} (kan niet worden gewijzigd).

Een eigenschap toevoegen#

1. Klik op Eigenschap toevoegen.
2. Vul het Label in (placeholder: Label (bijv. Budget)). Het veld Sleutel wordt automatisch ingevuld op basis van het label terwijl je typt, totdat je de sleutel zelf bewerkt.
3. Kies een Type (zie de tabel hieronder) en vul de eventuele typespecifieke velden in. Zet Vertaalbaar aan voor een eigenschap die je in meerdere talen wilt schrijven (zie Vertalingen).
4. Vink optioneel Verplicht aan.
5. Klik op Toevoegen. De knop blijft uitgeschakeld totdat zowel Label als Sleutel zijn ingevuld.

Eigenschapssleutels zijn, net als typesleutels, definitief zodra ze zijn aangemaakt.

Elke soort, de limieten ervan en hoe de API ze teruggeeft staan in Veldsoorten en herhaalblokken.

Secties-eigenschappen#

Een Secties-eigenschap maakt van een deel van een record een kleine paginabouwer. Bij het toevoegen vraagt het venster Welke secties mag deze pagina gebruiken? met een lijst aanvinkbare sectievormen; je moet er minstens één kiezen. Je stelt ook een Minimum (0-100) en Maximum (1-100) aantal items in; het maximum moet groter dan of gelijk aan het minimum zijn.

Sectievormen zelf beheer je niet op deze schermen. Als er nog geen bestaan, meldt het venster Er bestaan nog geen sectievormen. Maak er eerst een voordat je een secties-eigenschap toevoegt.

Secties-eigenschappen verschijnen nooit als kolommen in de recordlijst.

De ingebouwde naam-eigenschap#

Elk type heeft een name-eigenschap. Die kan niet worden gearchiveerd en de verplicht-instelling kan niet worden gewijzigd; wanneer de eigenschap verplicht is, toont hij simpelweg een verplicht-badge. De naam van het record wordt gebruikt als titel op de detailpagina en wordt vetgedrukt weergegeven in de recordlijst.

Eigenschappen herordenen, verplicht maken en archiveren#

• Herorden eigenschappen met de sleepgreep (gripicoon) of de pijltjes omhoog/omlaag per rij. De wijziging geldt direct en wordt teruggedraaid als het opslaan mislukt.
• Verplicht is een selectievakje op elke eigenschapsrij.
• Archiveer een eigenschap met het archiveericoon per rij. Archiveren is omkeerbaar: de eigenschap verdwijnt uit formulieren en lijstkolommen, maar de data die hij op bestaande records bevat, blijft bewaard. Gearchiveerde eigenschappen staan in een sectie Gearchiveerd van de bouwer, waar je ze met het herstelicoon kunt dearchiveren. Eigenschappen worden nooit individueel definitief verwijderd.

Publiceren en adressen#

De kaart Publiceren en adressen op de bouwpagina zet Publiceren voor het type aan of uit en bepaalt hoe de records een adres krijgen. Zie Publiceren en adressen.

Een type verwijderen#

Klik op Type verwijderen in de bouwer. De bevestiging luidt: "{pluralName}" en de bijbehorende {count} record(s) verwijderen? Dit kan niet ongedaan worden gemaakt. Anders dan bij het archiveren van een eigenschap is het verwijderen van een type definitief en worden alle bijbehorende records mee verwijderd.

Werken met records#

Klik op een type in het Objecten-overzicht (of op het item in de zijbalk) om de recordlijst te openen. De kolommen worden gegenereerd uit de actieve eigenschappen van het type (Secties-eigenschappen uitgezonderd), waarbij lege waarden worden getoond als -. Een type met Publiceren aan heeft ook een kolom Status met de badges Concept, Gepubliceerd en Ingepland.

Vanuit de lijst kun je:

• Zoeken in de tabel.
• Filteren met de automatisch gegenereerde filters: een filterknop per Keuzelijst-eigenschap (kies een van de opties van die eigenschap) en een datumfilter per Datum-eigenschap, dat een kalender opent. Een type met Publiceren aan heeft ook een filter Status (Concept of Gepubliceerd).
• Sorteren op elke kolom, behalve op Lange tekst- en Klant-eigenschappen.
• Bulksgewijs verwijderen: selecteer rijen met de selectievakjes en gebruik daarna de bulkactie Verwijderen (vraagt om bevestiging).
• Klik op Nieuw(e) {name} om een record aan te maken, of klik op een rij om het record te openen.

Een record aanmaken#

1. Klik op Nieuw(e) {name} op de recordlijst.
2. Vul het formulier in. Het wordt gegenereerd uit de eigenschappen van het type; verplichte velden tonen een rood sterretje. Bijzondere invoervelden:
   • Geld: typ het bedrag met een punt of komma als decimaalteken, bijv. 4950.00. Ongeldige invoer blokkeert het opslaan met Ongeldige prijs "{price}". Gebruik een punt of komma voor decimalen: 4950.00.
   • Vertaalbare eigenschappen: heeft het bedrijf meer dan één contenttaal, dan verschijnen er taaltabbladen boven het formulier. Zie Vertalingen.
   • Afbeelding: Kies afbeelding opent een kiezer over je mediabibliotheek; Afbeelding wijzigen en Afbeelding verwijderen bewerken haar daarna.
   • Herhaalblok: rijen toevoegen, herordenen en verwijderen. Zie Veldsoorten en herhaalblokken.
   • Keuzelijst: een dropdown met de placeholder Kiezen..., plus een optie Geen wanneer de eigenschap niet verplicht is.
   • Klant: zoeken terwijl je typt (minimaal 2 tekens), met naam en e-mailadres; klik op Wijzigen om een andere klant te kiezen.
   • Secties: een sectiecanvas. Klik op Sectie toevoegen om de kiezer Sectie toevoegen met vorm- en weergavetegels te openen; herorden secties door te slepen of met de pijlknoppen; dupliceer, verwijder of verberg/toon elke sectie; klap een sectiekaart uit om de velden te bewerken. Wanneer meer dan één contenttaal is ingeschakeld, kun je met een taalschakelaar de content per taal bewerken.
3. Klik op Aanmaken. Bij succes kom je op de detailpagina van het nieuwe record terecht. Bij een type met Publiceren aan is het nieuwe record een Concept tot je het publiceert. Validatiefouten van een mislukte opslag verschijnen onder de betreffende velden; een ongeldige sectie krijgt een badge Bevat een fout en klapt automatisch uit.

Een record bewerken of verwijderen#

De detailpagina van een record toont hetzelfde gegenereerde formulier. Bewerk een veld en klik op Opslaan (een korte "Opgeslagen." bevestigt dit). Verwijderen vraagt: "{title}" verwijderen? Dit kan niet ongedaan worden gemaakt.

Bij een type met Publiceren aan staat boven het formulier de kaart Gepubliceerd op met Publiceren, Depubliceren en Datum bijwerken, en een type met adressen toont ook de kaart Adressen. Zie Publiceren en adressen.

Als gearchiveerde eigenschappen nog een waarde op het record bevatten, staan ze alleen-lezen in een paneel Gearchiveerde eigenschappen (gearchiveerde Secties-eigenschappen worden niet getoond).

Records importeren en exporteren#

Elke recordlijst heeft de knoppen CSV exporteren en CSV importeren. Exporteren downloadt de lijst als CSV-bestand, vernoemd naar de sleutel van het type. Importeren opent een venster met de titel {pluralName} importeren: upload één .csv-bestand met een kopregel. Rijen worden onafhankelijk van elkaar verwerkt: geldige rijen worden geïmporteerd, ook als andere mislukken, en het resultaat toont aantallen aangemaakte, bijgewerkte en mislukte rijen plus een foutmelding per mislukt rijnummer. De lijst wordt na een geslaagde import ververst.