Publiceren en adressen

Met Publiceren ingeschakeld voor een type beginnen nieuwe records als concept: er komt niets op je site of in de Objects API tot je ze publiceert. Staat het uit, dan is een record live zodra je het aanmaakt. Je kunt een type ook adressen geven, zodat elk record een leesbaar pad heeft, zoals /diensten/keukenmontage.

Publiceren aan- of uitzetten voor een type#

Nieuwe typen die je in het dashboard aanmaakt, hebben Publiceren aan. Typen die al bestonden houden het uit tot je het inschakelt.

1. Open de typebouwer (het tandwielicoon bij Content → Objecten, of Type op de recordlijst).
2. Zet in de kaart Publiceren en adressen de schakelaar Publiceren aan of uit ("Records van dit type kunnen worden gepubliceerd op je openbare site en API.").
3. Klik op Opslaan.

Aanzetten laat bestaande records live, met hun aanmaakdatum als Gepubliceerd op; alleen records die je daarna aanmaakt beginnen als concept. Uitzetten kan pas als het type geen concepten meer heeft: zolang er een is, toont Opslaan "Publiceer of verwijder eerst de concepten van dit type." Zonder Publiceren is er geen knop Publiceren, dus publiceer of verwijder de concepten en zet het daarna uit.

Concept, Gepubliceerd en Ingepland#

Een publiceerbaar type krijgt een kolom Status in de recordlijst, en de recordpagina toont dezelfde badge naast de titel:

De recordlijst krijgt ook een filter Status met Concept en Gepubliceerd (een ingepland record telt daar als gepubliceerd).

Publiceren, depubliceren en opnieuw inplannen#

Op een record van een publiceerbaar type staat boven het formulier de kaart Gepubliceerd op. Die bevat een veld voor datum en tijd en de tip "Laat leeg om de vorige publicatiedatum te behouden, of nu te publiceren als die er niet is. Een datum in de toekomst plant het item in."

• Publiceren (bij een concept): publiceert het record. Met een leeg veld gaat het nu live (of op de datum waarop het eerder was gepubliceerd); met een datum in de toekomst wordt het Ingepland.
• Datum bijwerken (bij een gepubliceerd of ingepland record, zodra je het veld wijzigt): verplaatst de datum Gepubliceerd op, bijvoorbeeld om een lancering opnieuw in te plannen.
• Depubliceren: zet het record terug op Concept. Het verdwijnt direct van je site en uit je API. De adressen blijven bewaard.

Een gepubliceerd record bewerken depubliceert het niet; je wijzigingen zijn live zodra je op Opslaan klikt. Moet je privé aan een record werken, depubliceer het dan eerst.

Heeft het type adressen, dan heeft een record een adres in de standaardtaal nodig voordat het kan worden gepubliceerd. Publiceren weigert dan met "Add an address for {language} before publishing." en toont de melding boven de kaart Adressen.

Adressen#

Een adres is het laatste deel van het pad van een record. Het type bepaalt hoe adressen worden opgebouwd; het record heeft er één per taal.

In de kaart Publiceren en adressen van de typebouwer:

• Bron van adres (slug) kiest de tekst-eigenschap waaruit het adres komt ("Elk record krijgt zijn adres van deze tekst-eigenschap."). Geen (geen adressen) zet adressen uit. Alleen tekst-eigenschappen worden aangeboden.
• Adresvoorvoegsel per taal verschijnt zodra je een bron kiest, met één veld per contenttaal. Een voorvoegsel is leeg, of begint met een schuine streep en heeft geen afsluitende schuine streep, bijvoorbeeld /diensten. Het volledige pad van een record is het voorvoegsel plus / plus het adres.
• Een voorvoegsel kan per taal maar door één type worden gebruikt. Gebruikt een ander type het al, dan mislukt het opslaan met "Another type already uses this address prefix.".
• Is er geen contenttaal ingesteld, dan zegt de kaart dat je er een instelt onder Instellingen → Bedrijf. Zie Vertalingen.

Op een record toont de kaart Adressen één rij per contenttaal, met het volledige pad (voorvoegsel plus adres) of "Nog geen adres". Klik op Bewerken om een nieuw adres te typen en op Opslaan. De wijziging geldt direct.

• Een nieuw record krijgt zijn adressen automatisch uit de bron-eigenschap, één per taal (een taal zonder eigen tekst valt terug op de standaardtaal). Adressen bestaan uit kleine letters, cijfers en koppeltekens. Is een adres in die taal al in gebruik, dan wordt er een nummer aan toegevoegd (keukenmontage-2).
• Later de titel wijzigen verandert het adres niet. Je links blijven staan, tenzij je het adres zelf bewerkt.
• Twee records van één type kunnen in een taal geen adres delen: je krijgt "This address is already used.". Een adres bestaat uit kleine letters, cijfers en koppeltekens ("Use lowercase letters, digits and hyphens.").

Redirects wanneer een adres verandert#

Wijzig je een adres en heeft de taal een voorvoegsel, dan legt Borkol een permanente redirect vast van het oude pad naar het nieuwe, zodat links en zoekresultaten blijven werken. Storefronts lezen ze met het redirects-endpoint. Een taal zonder voorvoegsel krijgt geen redirect.

Wat je storefront ziet#

Alleen gepubliceerde records die live zijn worden geleverd, met hun published_at en, voor typen met adressen, hun slugs. Concepten en ingeplande records geven "niet gevonden". Zie Records voor de exacte vorm en Webhooks voor de object_record.*-events die je site vertellen wanneer die moet bijwerken.