Pubblicare sul tuo sito personale

Nolorem pubblica su WordPress, Ghost e Webflow tramite le rispettive API. Se il tuo sito non è nessuno dei tre, non è un problema. Dichiaralo come tuo sito personale, e Nolorem diventa per esso una destinazione di pubblicazione a pieno titolo, come qualsiasi altro connettore.

Questo articolo ripercorre l'installazione dal primo giorno, dall'inizio alla fine. Non presuppone nulla sulla tecnologia del tuo sito, solo che possa ricevere una richiesta HTTP.

Cosa comporta davvero questo accordo

Leggi prima questa parte, perché determina come costruisci l'altro lato.

Nolorem non chiama mai il tuo sito. Non esiste alcun webhook, push o callback. È il tuo sito a chiamare Nolorem, con la frequenza che scegli tu. L'API pubblica dei contenuti è un feed di sola lettura: il tuo sito lo interroga, e tutto il resto, compresa la frequenza, spetta a te.

Nolorem ti avvisa quando la tua configurazione sembra sbagliata. Se il tuo sito è dichiarato ma nulla lo interroga, oppure qualcosa lo interroga e non riceve nulla, questo compare nella pagina delle impostazioni di pubblicazione invece di restare invisibile. La sezione più avanti su come verificare che il tuo sito stia davvero effettuando richieste non è un dettaglio secondario; esiste perché un feed che risponde in silenzio, per sempre, con nulla, è esattamente il guasto che questo accordo è pensato per intercettare.

Passo 1: inserisci l'indirizzo del tuo sito

Apri Pubblicazione nelle impostazioni del tuo blog e inserisci l'indirizzo del tuo sito web. Fai clic su Trova la mia piattaforma.

Nolorem verifica se il tuo indirizzo funziona con WordPress o Ghost. Se è così, ti viene proposto direttamente il modulo di connessione di quella piattaforma al posto dei passaggi seguenti, dato che per essa esiste già un connettore reale.

Se non viene riconosciuto nulla, è un risultato normale e atteso, non un errore. La maggior parte dei siti realizzati su misura, e qualsiasi sito costruito su una piattaforma per cui Nolorem non ha un connettore, finisce qui. Ti viene mostrato un breve messaggio che lo conferma e passi subito a dichiarare il tuo sito personale, con l'indirizzo appena digitato già compilato.

Passo 2: conferma l'indirizzo e il modello di URL

Due campi descrivono il tuo sito: l'indirizzo (confermato in base a quanto hai inserito) e il modello di URL degli articoli, la forma che assume l'URL di un singolo articolo sul tuo sito, ad esempio /{slug} oppure /blog/{slug}.

Nolorem prova a leggere un vero URL di articolo dal tuo sito e a proporne un modello. Se lo trova, il campo del modello mostra un badge Proposto con una nota sulla pagina da cui è stato letto; verificalo rispetto a un URL che sai essere corretto, poi conferma. Se non lo trova, il campo parte vuoto e lo compili tu stesso.

Questo campo è obbligatorio e non viene mai indovinato in silenzio. Una versione precedente di questo accordo compilava automaticamente un modello predefinito quando un cliente lasciava il campo intatto, e quel modello predefinito era sbagliato abbastanza spesso da mandare i lettori su un 404. Ora Nolorem richiede una risposta vera, dal rilevamento o da te, prima di comporre anche un solo link verso un articolo del tuo sito.

Salva. Il tuo sito è ora dichiarato come destinazione.

Passo 3: crea una chiave dell'API pubblica dei contenuti

Pubblicare sul tuo sito personale richiede una chiave attiva dell'API pubblica dei contenuti, così che il tuo sito abbia con cosa autenticarsi. Vai su Impostazioni, Chiavi API e creane una, associata a questo blog. Consulta API pubblica dei contenuti per il percorso completo su ambiti delle chiavi, autenticazione e ogni endpoint esposto dal feed; questo articolo non lo ripete.

L'API pubblica dei contenuti è disponibile su qualsiasi piano a pagamento, compresa una prova. È un abbonamento attivo a sbloccarla, non un livello specifico.

Passo 4: indirizza il tuo sito verso il feed

Il tuo sito effettua la richiesta GET /api/v1/posts con la chiave come token bearer, e da lì impagina. Come consumarla esattamente, compreso il polling economico con If-None-Match e la copia delle immagini nel tuo spazio di archiviazione invece di collegarle direttamente a quello di Nolorem, è illustrato dall'inizio alla fine in uno script Node eseguibile e privo di dipendenze: sync.mjs (con il relativo README). Scaricalo e usalo come punto di partenza.

Passo 5: verifica che il tuo sito stia davvero effettuando richieste

Tornando alla pagina delle impostazioni di pubblicazione, la sezione sotto il tuo sito dichiarato mostra se stanno effettivamente arrivando richieste:

• Ancora nessuna richiesta significa che la chiave esiste ma non è ancora stata usata. Normale nei minuti successivi alla configurazione; un problema se la situazione persiste.
• Una richiesta recente mostra quando il feed è stato interrogato l'ultima volta e da quale chiave.
• L'avviso compare quando la tua chiave ha effettuato richieste ripetute ricevendo ogni volta un feed vuoto. È esattamente la situazione che prima restava invisibile: un sito che chiede contenuti che non arrivano mai, in silenzio, senza che nessuno lo sappia. Se lo vedi, verifica che la chiave sia associata al blog su cui pubblichi davvero e che tu abbia già pubblicato qualcosa.

Se pubblichi in più di una lingua

Richiedi ogni lingua separatamente. GET /api/v1/posts?locale=nl restituisce gli stessi post che ricevevi già, ma in neerlandese dove esiste una traduzione neerlandese completa, e invariati dove non ce n'è una. Non è un filtro: nessun post sparisce perché hai chiesto una lingua. Usa ?language= quando vuoi davvero filtrare in base alla lingua in cui un post è stato scritto.

Ogni post dice da sé quali lingue ha. available_locales le elenca e locale_slugs indica lo slug che ciascuna lingua porta. Quegli slug differiscono davvero da una lingua all'altra, perché ognuno è scelto attorno alla parola chiave di quella lingua. Costruisci quindi l'URL per lingua a partire da locale_slugs, invece di tradurre lo slug per conto tuo o di riutilizzare quello di origine.

I dettagli, compreso cosa succede a una traduzione non ancora finita, sono in Public Content API.

Cosa significa "pubblicato" in questo caso

Un articolo pubblicato sul tuo sito personale mostra, ovunque compaia lo stato di un articolo in Nolorem, Disponibile per il tuo sito invece di "Pubblicato". Non è uno stato inferiore: l'articolo è attivo nel feed, esattamente come per qualsiasi altra destinazione. La dicitura riflette solo il fatto che Nolorem stesso non conferma mai che l'articolo sia stato effettivamente mostrato da qualche parte; quella conferma resta tra il tuo sito e ciò che fa del feed.

Cambiare idea in seguito

Se il tuo sito cambia piattaforma, oppure passi da un sito su misura a WordPress o a un altro CMS supportato, usa Cambia destinazione nella stessa pagina delle impostazioni di pubblicazione. Ti guida attraverso lo stesso percorso di migrazione di qualsiasi altro cambio di piattaforma.