Pubblicare su BaseHub

Collega il tuo repository BaseHub una sola volta e GrowWriter aggiunge una riga a una collection per ogni articolo che pubblichi, con commit e online subito. Ti servono circa dieci minuti e un token admin per il repository.

Cosa ti serve

• Accesso al repository BaseHub da cui legge il tuo sito.
• Un Admin Token per quel repository, creato nella prossima sezione.
• Una collection per i post, con i campi già definiti.

Se BaseHub per il tuo sito lo ha configurato qualcun altro, mandagli questa sezione. Il token è l'unica cosa che deve consegnarti.

Crea il token

1. Apri il repository su basehub.com.
2. Vai nelle impostazioni del repository, poi API Tokens.
3. Crea un Admin Token. Deve avere accesso in scrittura; un token di sola lettura non può pubblicare.
4. Copialo. BaseHub lo mostra una sola volta.

Connetti in GrowWriter

Apri la pagina Canali, cerca BaseHub sotto Siti web & CMS e fai clic su Connetti.

1. Admin Token: incolla il token.
2. Fai clic su Testa connessione. Connessione riuscita significa che GrowWriter può leggere il repository e scriverci.

Due impostazioni facoltative stanno sotto Opzioni avanzate:

• URL della dashboard (facoltativo): l'indirizzo del repository, come https://basehub.com/your-team/your-repo. Con questo, il link Vedi articolo dopo la pubblicazione apre la riga in BaseHub.
• Lingue: i codici delle varianti lingua del tuo repository, separati da virgola, come en, es. Lascia en se non usi varianti.

Scegli la collection

Il passaggio 2 elenca le collection del repository. Scegli quella che il tuo sito usa per i post e fai clic su Continua.

Se l'elenco dice Nessuna collection su cui pubblicare, crea prima una collection in BaseHub, poi fai clic su Indietro e Continua per ricaricare.

Mappa i campi

Il passaggio 3 abbina ogni campo GrowWriter a un campo della collection: titolo, slug, contenuto, meta descrizione, immagine di copertina, data di pubblicazione, data di modifica e autore. GrowWriter abbina quello che può in base al nome e ti dice quanti ne ha trovati; imposta gli altri dai menu a tendina oppure scegli Salta.

Due dettagli utili da sapere:

• Il contenuto arriva come testo ricco scritto a partire dal Markdown, quindi scegli un campo di testo ricco per riceverlo.
• Mappa Data di modifica a un campo data, se ne hai uno. GrowWriter la aggiorna a ogni ripubblicazione mentre la data di pubblicazione resta ferma.

Fai clic su Salva connessione. La riga nella pagina Canali mostra Connesso.

Pubblica il tuo primo articolo

Apri la tua Libreria, scegli un articolo finito e fai clic su Pubblica. Spunta BaseHub, scegli un autore se la tua mappatura ne ha uno, e fai clic su Pubblica. GrowWriter aggiunge la riga e ne fa il commit, così l'articolo è online appena il tuo sito si ricostruisce o ricarica i dati.

Pubblicare di nuovo più tardi aggiorna la stessa riga al suo posto. Il flusso completo, con le schermate, è su Scegli dove pubblicare.

Risoluzione dei problemi

• Il token BaseHub non è valido o non ha accesso in scrittura: crea un nuovo Admin Token, Disconnetti e collega di nuovo.
• La collection BaseHub non è stata trovata: la collection è stata eliminata o rinominata. Disconnetti, ricollega e sceglila di nuovo.
• BaseHub ha rifiutato l'aggiornamento: un campo mappato non accetta il valore, di solito un campo obbligatorio lasciato su Salta o un tipo di campo sbagliato. Ricollega e correggi la mappatura.
• L'autore selezionato non esiste più nel CMS: scegli un altro autore nella finestra di pubblicazione.