Pubblicare su Ghost

Nolorem pubblica gli articoli del blog direttamente sul tuo sito Ghost tramite la Ghost Admin API. Non è richiesto alcun plugin, perché Ghost dispone di un'API nativa che gestisce autenticazione, pubblicazione e caricamento dei media.

Collega il tuo sito Ghost

1. Vai in Impostazioni, poi Pubblicazione.
2. Seleziona Ghost come piattaforma CMS.
3. Inserisci l'URL del tuo sito Ghost (per esempio https://yourblog.ghost.io). Non includere una barra finale né alcun percorso come /ghost/.
4. Inserisci la tua Admin API Key. La trovi nel pannello Ghost Admin sotto Settings, poi Integrations, poi Add custom integration. Il formato della chiave è {id}:{secret}.
5. Fai clic su Verifica connessione per confermare.

Usa l'Admin API Key, non la Content API Key. La Content API Key è di sola lettura e non può pubblicare articoli.

Invia un articolo

1. Apri un articolo del blog nell'editor.
2. Fai clic su Invia al CMS tra le azioni dell'articolo.
3. Nolorem formatta il contenuto come una Lexical HTML card (il formato nativo di Ghost), carica le immagini e crea l'articolo tramite la Ghost Admin API.
4. In caso di successo, nell'editor compare un link all'articolo Ghost online.

Nolorem racchiude i tuoi contenuti nel formato Lexical HTML card di Ghost, così titoli, citazioni, immagini, link e stili vengono tutti visualizzati correttamente senza problemi di conversione.

Aggiornare un articolo esistente

Se modifichi un articolo già inviato, facendo clic su Invia al CMS aggiorni l'articolo Ghost esistente. Ghost utilizza il controllo di concorrenza ottimistico, quindi Nolorem legge sempre lo stato attuale dell'articolo prima di aggiornarlo.

Sincronizzazione dello stato

Ghost supporta tre stati: bozza, pubblicato e pianificato.

• Impostare lo stato su Pubblica crea o aggiorna l'articolo come pubblicato.
• Impostare una data futura crea un articolo pianificato.
• Rimuovere la pubblicazione in Nolorem riporta l'articolo Ghost allo stato di bozza.

I webhook di Ghost avvisano Nolorem quando gli articoli cambiano stato sul lato Ghost. I campi SEO (meta title, meta description, OG title, OG description) vengono inviati direttamente come proprietà native di Ghost, quindi non serve alcun plugin SEO.

La connessione non funziona

Se la verifica della connessione fallisce:

• Controlla l'URL del sito. Usa solo l'URL radice, senza percorso /ghost/ e senza barra finale.
• Verifica di aver usato l'Admin API Key, non la Content API Key di sola lettura. La chiave Admin è il valore più lungo che contiene un separatore due punti ({id}:{secret}).
• Assicurati di usare Ghost v5.0 o versione successiva. Le versioni precedenti potrebbero usare endpoint API diversi.
• Se Ghost si trova dietro un reverse proxy o un firewall, assicurati che l'Admin API su /ghost/api/admin/ sia raggiungibile via HTTPS.

La pubblicazione non funziona

Se un invio fallisce, l'editor mostra l'errore restituito da Ghost. Cause comuni:

• Sito irraggiungibile: verifica che il sito sia online e che l'URL sia corretto. Nolorem applica un timeout di 30 secondi alle chiamate verso Ghost.
• Chiave non valida o eliminata: se hai rimosso la custom integration in Ghost, creane una nuova e aggiorna l'Admin API Key in Impostazioni, poi Pubblicazione.
• Conflitto di concorrenza: se qualcuno ha modificato l'articolo direttamente in Ghost, invialo di nuovo. Nolorem legge lo stato più recente prima di ogni aggiornamento.
• Caricamento immagine fallito: Ghost impone un limite di dimensione dei file. Un errore HTTP 413 indica che un'immagine è troppo grande. Usa JPG, PNG, GIF o WebP.
• Pianificazione: la data pianificata deve essere nel futuro, altrimenti Ghost pubblica immediatamente.