Passa al contenuto principale

WordPress

Informazioni sull'integrazione di ONLYOFFICE e WordPress​

Il plugin di integrazione ONLYOFFICE consente agli amministratori di WordPress di aprire documenti, fogli di calcolo e presentazioni per la modifica collaborativa utilizzando ONLYOFFICE Docs. Negli articoli pubblicati, gli editor sono visibili a tutti i visitatori del sito WordPress (sia autorizzati che non autorizzati) solo in modalità incorporata. Per ulteriori informazioni, consulta la pagina GitHub del connettore ONLYOFFICE per WordPress. Il plugin è distribuito con licenza GPL-2.0.

note

Per saperne di più su come funziona il connettore ONLYOFFICE per WordPress, visita la pagina della nostra documentazione API.

Caratteristiche principali​

  • Creazione, modifica e visualizzazione di documenti di testo, fogli di calcolo e presentazioni.
  • Co-editing dei documenti in tempo reale: due modalità di co-editing (Rapido e Rigoroso), la modalità Revisioni, i commenti e la chat integrata.
  • Supporto JWT per proteggere il traffico in modo che nessuno possa accedere ai tuoi documenti, ad eccezione degli utenti con i diritti appropriati.

Formati supportati​

  • Per la creazione, la modifica e la visualizzazione: DOCX, PPTX, XLSX
  • Solo per la visualizzazione: XLS, XLSX, XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP, DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, XML, PDF, DJVU, FB2, EPUB, XPS, OXPS
  • Per la compilazione di moduli: PDF

Connessione di ONLYOFFICE Docs a WordPress​

Requisiti​

  • ONLYOFFICE Document Server v6.1.0 (versione server o cloud) o successiva

    Hai bisogno di un'istanza di ONLYOFFICE Docs che sia risolvibile e raggiungibile sia da WordPress che da qualsiasi client finale. Deve essere in grado di inviare richieste POST direttamente a WordPress.

    note

    Consulta la pagina della documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.

  • WordPress versione 5.7 o superiore

  • ONLYOFFICE Connector 2.3.0 per WordPress

Installazione del plugin ONLYOFFICE per WordPress​

Per iniziare a utilizzare ONLYOFFICE Docs con WordPress, usa uno dei tre metodi di installazione: tramite archivio .zip, clonando il branch master o utilizzando il marketplace di WordPress:

  1. Utilizzando l'archivio .zip:
    • Scarica il plugin in formato compresso.
    • Vai alla sezione Plugin nella bacheca di amministrazione di WordPress.
    • Vai a Plugin → Aggiungi nuovo.
    • Fai clic su Carica plugin.
    • Fai clic su Scegli file, seleziona il file ZIP scaricato e caricalo.
    • Dopo l'installazione, fai clic su Attiva.
  2. Clonando il branch master:

    • Clona il branch master:

      cd wp-content/plugins git clone https://github.com/ONLYOFFICE/onlyoffice-wordpress

    • Attiva il plugin dalla bacheca di amministrazione di WordPress.

  3. Utilizzando il marketplace di WordPress:
    • Installa il plugin dalla pagina ufficiale sul marketplace.
    • Dopo l'installazione, fai clic su Attiva.

Configurazione di ONLYOFFICE Docs in WordPress​

Dopo aver installato il plugin, configura le impostazioni di connessione:

  1. Vai a bacheca di amministrazione di WordPress → ONLYOFFICE → Impostazioni.
  2. Specifica l'URL per le impostazioni del connettore:

    • Indirizzo del servizio di modifica dei documenti - specifica l'indirizzo URL in cui è installato il servizio di modifica dei documenti.

      note

      L'indirizzo di ONLYOFFICE Docs deve essere accessibile da WordPress, così come l'indirizzo di WordPress deve essere accessibile da ONLYOFFICE Docs.

    • Chiave segreta - specifica il segreto utilizzato per firmare i dati.

      note

      A partire da ONLYOFFICE Docs v7.2, JWT è abilitato per impostazione predefinita e la chiave segreta viene generata automaticamente. Devi abilitarlo anche sul lato WordPress: trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specifica la stessa chiave segreta nelle impostazioni del connettore. Per maggiori dettagli, consulta la sezione Abilitazione di JWT per l'integrazione di ONLYOFFICE e WordPress di questo articolo.

    • Intestazione di autorizzazione - (lascia vuoto per utilizzare l'intestazione predefinita) - l'intestazione JWT di autorizzazione utilizzata in ONLYOFFICE è AuthorizationJwt. Nel caso in cui questa intestazione sia in conflitto con la tua configurazione, puoi sostituirla con una personalizzata.

configura

Come funziona​

L'interazione utente-documento avviene sia lato client che lato server.

I principali concetti utilizzati in questa documentazione sono spiegati di seguito.

Il lato client comprende:

  • Gestore dei documenti - l'elenco dei documenti visualizzato nel browser dell'utente, in cui l'utente può selezionare il documento necessario ed eseguire alcune azioni su di esso (a seconda dei diritti forniti, l'utente può aprire il documento per visualizzarlo o modificarlo, condividere il documento con altri utenti).
  • Editor di documenti - l'interfaccia di visualizzazione e modifica dei documenti con tutte le più note funzionalità di modifica disponibili, utilizzata come tramite tra l'utente e il servizio di modifica dei documenti.

Il lato server comprende:

  • Servizio di archiviazione dei documenti - il servizio del server che archivia tutti i documenti disponibili agli utenti con i diritti di accesso appropriati. Fornisce gli ID dei documenti e i collegamenti a questi documenti al gestore dei documenti che l'utente vede nel browser.
  • Servizio di modifica dei documenti - il servizio del server che consente di visualizzare e modificare i documenti (nel caso in cui l'utente disponga dei diritti appropriati per farlo). L'interfaccia dell'editor di documenti viene utilizzata per accedere a tutte le funzionalità del servizio di modifica dei documenti.
  • Servizio di comando dei documenti - il servizio del server che consente di eseguire comandi aggiuntivi con il servizio di modifica dei documenti.
  • Servizio di conversione dei documenti - il servizio del server che consente di convertire il file del documento nel formato Office Open XML appropriato (docx per i documenti di testo, xlsx per i fogli di calcolo e pptx per le presentazioni) per la modifica o il download.
  • Servizio di creazione dei documenti - il servizio del server che consente di creare facilmente un documento senza dover eseguire un editor di elaborazione dei documenti.

Tieni presente che ONLYOFFICE Document Server include l'editor di documenti, il servizio di modifica dei documenti, il servizio di comando dei documenti, il servizio di conversione dei documenti e il servizio di creazione dei documenti. Il gestore dei documenti e il servizio di archiviazione dei documenti sono inclusi in Community Server oppure devono essere implementati dagli integratori software che utilizzano ONLYOFFICE Document Server sul proprio server.

Abilitazione di JWT per l'integrazione di ONLYOFFICE e WordPress​

Per proteggere i documenti da accessi non autorizzati, gli editor ONLYOFFICE utilizzano il JSON Web Token (JWT). Il token viene aggiunto alla configurazione quando l'editor di documenti viene inizializzato e durante lo scambio di comandi tra i servizi interni di ONLYOFFICE Docs. La chiave segreta viene utilizzata per firmare il token web JSON e convalidare il token alla richiesta a ONLYOFFICE Docs.

A partire da ONLYOFFICE Docs v7.2, JWT è abilitato per impostazione predefinita e la chiave segreta viene generata automaticamente. Devi trovare la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specificare la stessa chiave segreta nelle impostazioni del connettore.

Passaggio 1: Trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs

  1. Apri il file local.json con qualsiasi editor di testo disponibile.

    • Per Linux - /etc/onlyoffice/documentserver/local.json

    • Per Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

    • Per Docker – accedi al container di ONLYOFFICE Docs con il comando docker exec -it <containerID> bash e apri /etc/onlyoffice/documentserver/local.json

      In alternativa, puoi usare il seguente comando per trovare la chiave segreta predefinita senza aprire local.json:

      sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

    Il file local.json dovrebbe avere il seguente aspetto:

    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }

  2. Il valore true è specificato in tre sezioni. Significa che la convalida del token è abilitata.

    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox

  3. La chiave segreta generata automaticamente è specificata in tre sezioni. Puoi sostituire il valore segreto predefinito con la tua chiave segreta. La chiave segreta deve essere la stessa in tutte e tre le sezioni.

    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string

  4. Se apporti modifiche, salvale e riavvia i servizi affinché le modifiche alla configurazione abbiano effetto.

    supervisorctl restart all

Passaggio 2: Specifica la stessa chiave segreta nelle impostazioni del connettore

Nelle impostazioni del connettore, specifica lo stesso segreto nel campo Chiave segreta e salva le impostazioni.

Come iniziare a usare ONLYOFFICE Docs in WordPress​

Visualizzazione dei documenti​

Per visualizzare tutti i documenti, vai a bacheca di amministrazione di WordPress > ONLYOFFICE > File.

visualizza

Aggiunta del blocco ONLYOFFICE​

Per aggiungere il blocco ONLYOFFICE per un uso futuro:

  1. Apri la finestra Crea un articolo.
  2. Fai clic sull'icona ONLYOFFICE nel pannello sottostante.

aggiungi_blocco

Caricamento e incorporamento di un file​

Per caricare un file nel blocco ONLYOFFICE e incorporarlo in un nuovo articolo:

  1. Apri la finestra Crea un articolo.

  2. Scegli il blocco ONLYOFFICE.

  3. Fai clic sul pulsante Carica per caricare un file dal tuo computer nel blocco ONLYOFFICE
    oppure
    Fai clic sul pulsante Libreria multimediale per selezionare un file dalla tua libreria e caricarlo nel blocco ONLYOFFICE.

    carica

    incorpora

Il documento verrà incorporato nell'articolo creato.

incorporato

note

Per saperne di più sui problemi più comuni e sui modi per risolverli, visita la nostra guida alla risoluzione dei problemi.