Publiceren naar je eigen site

Nolorem publiceert naar WordPress, Ghost en Webflow via hun eigen API's. Als je site geen van die drie is, hoeft dat ook niet. Verklaar hem als je eigen site, en Nolorem wordt een volwaardige publicatiebestemming ervoor, net als elke andere koppeling.

Dit artikel doorloopt de installatie vanaf dag één, van begin tot eind. Er wordt niets aangenomen over de techniek achter je site, alleen dat hij een HTTP-verzoek kan ontvangen.

Wat deze afspraak precies inhoudt

Lees dit eerst, want het bepaalt hoe je de andere kant bouwt.

Nolorem belt nooit naar je site. Er is geen webhook, geen push, geen callback. Jouw site roept Nolorem aan, op het schema dat jij kiest. De Public Content API is een alleen-lezen feed: je site vraagt hem op, en al het overige, inclusief hoe vaak, is jouw beslissing.

Nolorem laat je weten wanneer je eigen instelling niet klopt. Als je site is verklaard maar niets haalt de feed op, of iets haalt hem wel op en krijgt niets terug, dan zie je dat op de pagina Publicatie-instellingen in plaats van dat het onzichtbaar blijft. Het onderdeel hieronder over controleren of je site daadwerkelijk ophaalt is geen bijzaak; het bestaat omdat een feed die stil, voor altijd, met niets antwoordt precies het probleem is waar deze afspraak tegen is gebouwd.

Stap 1: voer het adres van je site in

Open Publicatie in de instellingen van je blog en voer het adres van je website in. Klik op Vind mijn platform.

Nolorem controleert of je adres op WordPress of Ghost draait. Als dat zo is, krijg je meteen het eigen verbindingsformulier van dat platform aangeboden in plaats van de stappen hieronder, omdat daar al een echte koppeling voor bestaat.

Wordt er niets herkend, dan is dat een normale, verwachte uitkomst en geen fout. De meeste sites op maat, en elke site gebouwd op een platform waar Nolorem geen koppeling voor heeft, komen hier terecht. Je krijgt een kort bericht dat dit bevestigt en gaat meteen door naar het verklaren van je eigen site, met het adres dat je net typte al ingevuld.

Stap 2: bevestig het adres en het URL-patroon

Twee velden beschrijven je site: het siteadres (bevestigd op basis van wat je invulde) en het URL-patroon voor berichten, de vorm van de URL van één bericht op je site, bijvoorbeeld /{slug} of /blog/{slug}.

Nolorem probeert één echte artikel-URL van je site te lezen en er een patroon uit voor te stellen. Wordt er een gevonden, dan toont het patroonveld een badge Voorstel met een toelichting op welke pagina het patroon is gelezen; controleer dit tegen een URL waarvan je weet dat hij klopt, en bevestig dan. Wordt er niets gevonden, dan begint het veld leeg en vul je het zelf in.

Dit veld is verplicht, en er wordt nooit stilzwijgend iets geraden. Een eerdere versie van deze afspraak vulde automatisch een standaardpatroon in wanneer een klant het veld onaangeroerd liet, en dat standaardpatroon was vaak genoeg fout om lezers naar een 404 te sturen. Nolorem staat nu op een echt antwoord, uit herkenning of van jou, voordat er ook maar één link naar een bericht op je site wordt opgebouwd.

Sla op. Je site is nu verklaard als bestemming.

Stap 3: maak een Content API-sleutel aan

Publiceren naar je eigen site vereist een actieve Content API-sleutel, zodat je site zich ergens mee kan authenticeren. Ga naar Instellingen, API Keys en maak er een aan, gekoppeld aan deze blog. Zie Public Content API voor de volledige uitleg over sleutelbereiken, authenticatie en elk eindpunt dat de feed aanbiedt; dit artikel herhaalt dat niet.

De Content API is beschikbaar op elk betaald abonnement, inclusief een proefperiode. Een actief abonnement ontgrendelt de functie, geen specifiek niveau.

Stap 4: wijs je site naar de feed

Je site haalt GET /api/v1/posts op met de sleutel als bearer-token en pagineert vanaf daar. Hoe je dit precies gebruikt, inclusief goedkoop pollen met If-None-Match en het kopiëren van afbeeldingen naar je eigen opslag in plaats van die van Nolorem te hotlinken, wordt volledig uitgewerkt in een uitvoerbaar Node-script zonder afhankelijkheden: sync.mjs (met de bijbehorende README). Download het en gebruik het als startpunt.

Stap 5: controleer of je site daadwerkelijk ophaalt

Terug op de pagina Publicatie-instellingen laat het onderdeel onder je verklaarde site zien of er echt verzoeken binnenkomen:

• Nog geen aanvragen betekent dat de sleutel bestaat maar nog niet is gebruikt. Normaal in de minuten na het instellen; een probleem als het zo blijft.
• Een recente aanvraag toont wanneer de feed voor het laatst is opgehaald en door welke sleutel.
• De waarschuwing verschijnt wanneer je sleutel herhaaldelijk heeft opgehaald en steeds een lege feed terugkreeg. Dit is precies de situatie die vroeger onzichtbaar bleef: een site die vraagt om content die nooit komt, stilzwijgend, zonder dat iemand het wist. Zie je dit, controleer dan of de sleutel is gekoppeld aan de blog waarop je daadwerkelijk publiceert, en of je al iets hebt gepubliceerd.

Als je in meer dan één taal publiceert

Vraag elke taal apart op. GET /api/v1/posts?locale=nl geeft dezelfde posts terug die je al kreeg, maar in het Nederlands waar een volledige Nederlandse vertaling bestaat, en onveranderd waar er geen is. Het is geen filter: er verdwijnt geen enkele post omdat je een taal vraagt. Gebruik ?language= wanneer je wél wilt filteren op de taal waarin een post geschreven is.

Elke post vertelt zelf welke talen hij heeft. available_locales somt ze op en locale_slugs geeft de slug die elke taal draagt. Die slugs verschillen echt per taal, want elke slug is rond het zoekwoord van díé taal gekozen. Bouw je URL per taal dus op uit locale_slugs in plaats van de slug zelf te vertalen of die van de brontaal te hergebruiken.

De details, inclusief wat er gebeurt met een vertaling die nog niet af is, staan in Public Content API.

Wat "gepubliceerd" hier betekent

Een bericht dat naar je eigen site is gepubliceerd, toont overal waar de status van een bericht verschijnt in Nolorem als Beschikbaar voor je site in plaats van "Gepubliceerd". Dit is geen mindere status: het bericht staat live in de feed, precies zoals bij elke andere bestemming. De formulering weerspiegelt alleen dat Nolorem zelf nooit bevestigt dat het bericht ergens is weergegeven; die bevestiging ligt tussen jouw site en wat die met de feed doet.

Later van gedachten veranderen

Verandert je site van platform, of stap je over van een site op maat naar WordPress of een andere ondersteunde CMS, gebruik dan Bestemming wijzigen op dezelfde pagina Publicatie-instellingen. Dat leidt je door dezelfde migratiestroom als elke andere platformwissel.