Een website koppelen

Een Sanity-website koppelen

Het schema publiceren, een token maken, koppelen.

Voor een Sanity-website verandert er niets in de code van de site. SiteHome werkt met één API-token en het schema dat je Studio publiceert.

1. Het schema publiceren

SiteHome leest welke velden er zijn uit het schema dat Sanity bewaart als je Studio wordt gepubliceerd. Wordt de Studio niet door Sanity gehost, publiceer het schema dan zelf na elke wijziging:

npx sanity schema deploy

2. Een token maken

Open in Sanity Manage het project, ga naar API → Tokens, kies Add API token, noem hem SiteHome en kies de rol Editor (met Viewer kan SiteHome content tonen maar niet publiceren). Kopieer de token.

3. Koppelen in SiteHome

In de SiteHome-app: Website koppelen → Sanity, plak de token, bevestig het websiteadres en kies de dataset en de contentsoorten. Publiceren staat eerst uit, tot een beheerder het aanzet. Een dataset die al gekoppeld is in SiteHome wordt nooit overgenomen; de beheerder ervan nodigt je uit.

Hoe SiteHome publiceert

Elke wijziging wordt eerst gecontroleerd. SiteHome schrijft een concept en publiceert dat via de Actions API van Sanity met een revisiecontrole, zodat een nieuwere wijziging of een concept van iemand anders nooit wordt overschreven. Een item van de website halen gebeurt met Sanity's unpublish; het item blijft als concept terug te halen.

Wat SiteHome bewerkt

Velden uit je gepubliceerde schema, volgens één regel: velden zonder eigen regel zijn bewerkbaar; velden met een eigen validatieregel, of die alleen onder een voorwaarde verschijnen, blijven alleen-lezen met een neutrale uitleg. Tekst, getallen, ja/nee, datums, keuzes, het adres van nieuwe items, afbeeldingen (met alt-tekst), lijsten, Portable Text en lijsten van eenvoudige objecten worden ondersteund.