Dopo aver installato il plugin WP Discourse, è necessario collegarlo al tuo Discourse. Quando sei pronto, guarda questo breve video o segui le istruzioni qui sotto.
Prossimo Passo
Una volta collegato il plugin, vai all’argomento che descrive la funzionalità che desideri configurare:
- Pubblica post su Discourse
- Usa Discourse per i commenti di WordPress
- Accedi a Discourse con WordPress (DiscourseConnect)
Istruzioni
Passaggi
Quando ti trovi nella scheda “Connessione” delle impostazioni del plugin WP Discourse, ci sarà sempre un avviso nella parte superiore della pagina che ti dirà se è connesso al tuo Discourse. Per stabilire una connessione, inserisci:
-
Inserisci l’URL del tuo forum nel campo delle impostazioni “URL Discourse”.
-
Rivedi l’impostazione “Nome utente di pubblicazione”. A meno che tu non abbia un motivo specifico per cambiarlo, lascialo come “system”. Se lo cambi, deve essere il nome utente di un utente amministratore sul tuo Discourse. Puoi trovare il nome utente di un utente sotto il suo nome quando fai clic sul suo avatar.
-
Crea una chiave API di Discourse per WordPress:
-
Vai al tuo pannello di amministrazione di Discourse (nel tuo forum Discourse) e fai clic su “API”.
-
Crea una nuova chiave con le seguenti impostazioni:
- Descrizione: inserisci un’etichetta che chiarisca lo scopo di questa chiave
- Livello utente: seleziona “Tutti gli utenti”
- Ambito: seleziona “Globale”
-
Copia la chiave che appare sullo schermo e fai clic su “Continua”.
-
-
Incolla la chiave API nell’impostazione “Chiave API” in WP Discourse.
Una volta compilate queste impostazioni, assicurati di fare clic sul pulsante “Salva opzioni”. Se tutto è configurato correttamente, dovresti vedere un avviso che dice “Sei connesso a Discourse” nella parte superiore della pagina.
Multisite
Il plugin WP Discourse ha un’opzione di configurazione Multisite per il caso in cui un forum Discourse sia collegato a una rete di più WordPress. Questa opzione è disponibile nella scheda delle impostazioni di connessione del sito principale di una rete.
Selezionandola, alcune delle impostazioni del plugin possono essere utilizzate sull’intera rete (tutte le opzioni di connessione, le opzioni Webhook, la chiave segreta di DiscourseConnect e l’impostazione Abilita DiscourseConnect). L’abilitazione di questa impostazione creerà una tabella di database aggiuntiva utilizzata per associare gli ID argomento di Discourse agli ID blog di WordPress quando i post vengono pubblicati da WordPress a Discourse.
Funzionalità non supportate in Multisite
L’uso di WordPress come client DiscourseConnect non è supportato su WordPress Multisite.
Chiave API granulare (nuovo
)
Ora puoi creare una chiave API granulare per il plugin WP Discourse. Le chiavi API granulari diventeranno il modo standard per connettere WP Discourse a Discourse nel prossimo futuro.
Come usare una chiave granulare
Ecco come puoi usare una chiave granulare:
-
Innanzitutto, assicurati di utilizzare la versione
2.4.3del plugin e la versione più recente di Discourse sul ramotests-passed. Le chiavi API granulari di WP Discourse non sono ancora supportate su Discoursestable. -
Vai al pannello API nella dashboard di amministrazione di Discourse e crea una nuova chiave “Tutti gli utenti”, ma con un ambito “Granulare”.
-
In fondo all’elenco degli ambiti troverai gli ambiti di WordPress. Seleziona l’ambito “Pubblicazione” (attualmente richiesto) e gli ambiti per qualsiasi altra funzionalità che stai utilizzando nel plugin WP Discourse, quindi fai clic su “Salva”.
-
Ora sostituisci la tua vecchia chiave nell’impostazione “Chiave API” in WP Discourse con la tua nuova chiave granulare e salva le tue impostazioni.
Quando salvi le impostazioni di WP Discourse, dovresti vedere il normale messaggio “Sei connesso a Discourse!”.
Se vedi “Non sei connesso a Discourse…”, potrebbe essere dovuto a un ambito errato. Il plugin confronta gli ambiti della tua chiave API con le funzionalità che hai attualmente abilitato. Se hai ambiti insufficienti, ti considererà non connesso. Puoi vedere quali ambiti mancano abilitando i log di connessione e guardando i messaggi di errore nel visualizzatore di log.
Ambiti WP Discourse
Ci sono quattro ambiti per il plugin WP Discourse:
-
Pubblicazione. Questo ambito ti consente di pubblicare post da WordPress a Discourse. Questo ambito è richiesto, anche se non stai pubblicando post (ad esempio, stai solo usando DiscourseConnect), poiché include funzionalità che tutte le funzionalità utilizzano. Questo verrà disaccoppiato in futuro, rendendo tutti gli ambiti facoltativi.
-
Commenti. Questo ambito consente di mostrare le risposte ai post pubblicati su Discourse in WordPress come commenti.
-
DiscourseConnect. Questo ambito consente di utilizzare DiscourseConnect (in qualsiasi configurazione).
-
Utilità. Questo ambito è necessario per alcune funzioni di utilità disponibili nel plugin. Se hai codice personalizzato che interagisce con il plugin, dovresti abilitare questo ambito, a meno che tu non sia sicuro di non averne bisogno.
Perché usare una chiave granulare?
Il motivo principale per utilizzare una chiave granulare è la sicurezza. Una chiave API globale consente a chiunque abbia la chiave di agire come amministratore sul tuo Discourse. Ciò significa che la sicurezza del tuo Discourse dipende dalla sicurezza del tuo WordPress. Una chiave granulare è molto meno potente, essendo limitata agli ambiti che abiliti per essa.