Passa al contenuto principale

Drupal

Informazioni sull'integrazione di ONLYOFFICE e Drupal​

Drupal è un sistema di gestione dei contenuti open source utilizzato per creare siti web e API. ONLYOFFICE offre un modulo ufficiale per integrare ONLYOFFICE Docs con Drupal e modificare documenti di office nella tua libreria multimediale di Drupal. Puoi ottenere il modulo di integrazione ONLYOFFICE dal sito web ufficiale di Drupal scegliendo la versione richiesta, oppure aggiungerlo con Composer, oppure consultare la pagina GitHub. Il modulo è distribuito con la GNU General Public License v.2.0.

note

Per saperne di più sul funzionamento del connettore ONLYOFFICE per Drupal, visita la nostra pagina della documentazione API.

Funzionalità principali​

  • Modifica e visualizzazione di documenti di testo, fogli di calcolo, presentazioni e moduli PDF.
  • Co-modifica dei documenti in tempo reale: due modalità di co-modifica (Veloce e Rigorosa), la modalità Revisione delle modifiche, i commenti e la chat integrata.
  • Supporto JWT per proteggere il tuo traffico in modo che nessuno possa accedere ai tuoi documenti, ad eccezione degli utenti con i diritti appropriati.
  • Anteprima dei file nelle pagine pubbliche.

Formati supportati​

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

Collegare ONLYOFFICE Docs a Drupal​

Requisiti​

Installare il modulo di integrazione ONLYOFFICE per Drupal​

Ci sono due modi per installare il modulo di integrazione ONLYOFFICE per Drupal: tramite l'interfaccia utente di Drupal oppure usando Composer.

Installare tramite l'interfaccia utente di Drupal​

  1. Nella pagina del progetto della barra degli strumenti Admin su drupal.org, scorri fino alla sezione Releases in fondo alla pagina. Fai clic sul link View all releases (Visualizza tutte le release).

  2. Scegli la versione richiesta dall'elenco.

  3. Copia l'indirizzo del link tar.gz. A seconda del tuo dispositivo e del tuo browser, puoi farlo facendo clic con il pulsante destro del mouse e selezionando Copy link address (Copia indirizzo del link).

  4. Nel menu amministrativo Manage (Gestisci), vai a Extend (admin/modules). Viene visualizzata la pagina Extend.

  5. Fai clic sul pulsante Add new module (Aggiungi nuovo modulo). Viene visualizzata la pagina Add new module.

    ONLYOFFICE Drupal

  6. Incolla il link di download copiato nel campo Add from a URL (Aggiungi da un URL).

    ONLYOFFICE Drupal

  7. Fai clic su Install (Installa) per caricare e decomprimere il nuovo modulo sul server. I file vengono scaricati nella directory dei moduli.

  8. Per applicare le impostazioni di localizzazione, esegui i seguenti comandi:

    drush locale-check
    drush locale-update
note

Non è più possibile caricare nuovi moduli tramite l'interfaccia web di Drupal. Consulta le seguenti istruzioni per caricare i moduli in Drupal.

Installare tramite Composer​

Inserisci il seguente comando nella root del tuo sito Drupal:

composer require onlyoffice/onlyoffice-drupal

Se la directory di installazione è web/modules/contrib/drupal, esegui i seguenti comandi per applicare le impostazioni di localizzazione:

drush locale-check
drush locale-update

Abilitare il modulo di integrazione ONLYOFFICE per Drupal​

Ci sono due modi per abilitare il modulo di integrazione ONLYOFFICE per Drupal: tramite l'interfaccia utente di Drupal oppure da riga di comando.

Abilitare il modulo di integrazione ONLYOFFICE tramite l'interfaccia utente di Drupal​

  1. Apri la pagina Extend (admin/modules) tramite il menu amministrativo Manage.

  2. Individua il ONLYOFFICE Connector module e seleziona la casella corrispondente.

    ONLYOFFICE Drupal

  3. Fai clic su Install (Installa) per abilitare il modulo.

Abilitare il modulo di integrazione ONLYOFFICE da riga di comando​

  1. Esegui il seguente comando Drush, indicando il nome del progetto come parametro:

    drush pm:enable onlyoffice

  2. Segui le istruzioni della procedura guidata.

Configurare il modulo di integrazione ONLYOFFICE per Drupal​

In Drupal, apri la pagina ~/config/system/onlyoffice-settings con le impostazioni amministrative per la sezione ONLYOFFICE. In alternativa, segui questi passaggi:

  1. Apri la pagina Extend (admin/modules) tramite il menu amministrativo Manage.

  2. Fai clic sulla freccia nella descrizione del ONLYOFFICE Connector module per aprire un elenco a discesa.

  3. Scegli l'opzione Configure (Configura).

  4. Inserisci l'indirizzo nel campo Document Editing Service address (Indirizzo del Document Editing Service) per collegare ONLYOFFICE Document Server:

    https://documentserver/

ONLYOFFICE Drupal

Dove documentserver è il nome del server su cui è installato ONLYOFFICE Document Server. L'indirizzo deve essere accessibile dal browser dell'utente e dal server Drupal. Anche l'indirizzo del server Drupal deve essere accessibile da ONLYOFFICE Document Server per garantire il corretto funzionamento.

Per limitare l'accesso a ONLYOFFICE Document Server, per motivi di sicurezza e di integrità dei dati, viene utilizzata la firma crittografata. Specifica la Secret key (Chiave segreta) nella configurazione amministrativa di Drupal. Nel file di configurazione di ONLYOFFICE Document Server, specifica la stessa chiave segreta e abilita la convalida.

Come funziona​

L'interazione tra utente e documento avviene sia lato client sia lato server.

Di seguito sono spiegate le nozioni principali utilizzate in questa documentazione.

Il lato client comprende:

  • Document manager (gestore dei documenti): l'elenco dei documenti visualizzato nel browser dell'utente, dove l'utente può selezionare il documento necessario ed eseguire alcune azioni su di esso (a seconda dei diritti concessi, l'utente può aprire il documento per visualizzarlo o modificarlo, e condividerlo con altri utenti).
  • Document editor (editor di documenti): l'interfaccia di visualizzazione e modifica dei documenti con tutte le più note funzionalità di modifica disponibili, utilizzata come mezzo tra l'utente e il document editing service.

Il lato server comprende:

  • Document storage service (servizio di archiviazione dei documenti): il servizio server che archivia tutti i documenti disponibili per gli utenti con i diritti di accesso appropriati. Fornisce al document manager gli ID dei documenti e i link a tali documenti, che l'utente vede nel browser.
  • Document editing service (servizio di modifica dei documenti): il servizio server che consente di visualizzare e modificare i documenti (se l'utente ha i diritti appropriati per farlo). L'interfaccia del document editor viene utilizzata per accedere a tutte le funzionalità del document editing service.
  • Document command service (servizio di comandi sui documenti): il servizio server che consente di eseguire comandi aggiuntivi con il document editing service.
  • Document conversion service (servizio di conversione dei documenti): il servizio 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.
  • Document builder service (servizio di creazione dei documenti): il servizio server che consente di creare facilmente un documento senza dover effettivamente eseguire un editor di elaborazione dei documenti.

Tieni presente che ONLYOFFICE Document Server include il document editor, il document editing service, il document command service, il document conversion service e il document builder service. Il document manager e il document storage service sono inclusi in Community Server oppure devono essere implementati dagli integratori di software che utilizzano ONLYOFFICE Document Server sul proprio server.

Abilitare JWT per l'integrazione di ONLYOFFICE e Drupal​

JWT, o JSON Web Token, è una stringa inviata dal client al server all'interno della richiesta HTTP per convalidare l'autenticità del client. JWT viene salvato solo lato client, quindi la trasmissione tra le parti è protetta e firmata digitalmente.

Il token viene generato utilizzando lo standard JWT (JSON Web Tokens). I token sono firmati con la chiave del server, quindi il client può verificare che il token sia legittimo.

ONLYOFFICE Docs convalida il token. I dati del payload sono considerati validi e vengono utilizzati al posto dei dati corrispondenti dei parametri principali. Se il token non è valido, il comando non viene eseguito. Per saperne di più, leggi la guida alla sicurezza dell'API.

Per proteggere i tuoi documenti con JWT in Drupal, apri la pagina ~/config/system/onlyoffice-settings con le impostazioni amministrative per la sezione ONLYOFFICE. In alternativa, segui questi passaggi:

  1. Apri la pagina Extend (admin/modules) tramite il menu amministrativo Manage.

  2. Fai clic sulla freccia nella descrizione del ONLYOFFICE Connector module per aprire un elenco a discesa.

  3. Scegli l'opzione Configure (Configura).

  4. Inserisci la chiave segreta nel campo Secret key (Chiave segreta).

    ONLYOFFICE Drupal

  5. Nel file di configurazione di ONLYOFFICE Document Server, specifica la stessa chiave segreta e abilita la convalida.

Iniziare a usare ONLYOFFICE Docs in Drupal​

Per modificare i documenti di office in Drupal utilizzando ONLYOFFICE Docs, carica i file in Drupal.

Caricare file in Drupal​

  1. Vai su Manage > Content (Contenuti).
  2. Fai clic sul pulsante Add content (Aggiungi contenuto).
  3. Fai clic sul tipo di contenuto richiesto.
  4. Inserisci il titolo, la lingua e il corpo del testo, e imposta il formato del testo.
  5. Nel campo Add a new file (Aggiungi un nuovo file), fai clic sul pulsante Browse (Sfoglia) e scegli il file dal disco rigido del tuo PC.
  6. Seleziona o deseleziona la casella Published (Pubblicato) in base alle tue preferenze.
  7. Fai clic sul pulsante Save (Salva).

Visualizzare, modificare e gestire i file in Drupal​

  1. Vai su Manage > Content.

  2. Passa alla scheda Media (Contenuti multimediali) nella parte superiore dello schermo.

  3. Trova il file richiesto nell'elenco oppure usa il campo di ricerca in alto.

  4. Fai clic sulla freccia nella colonna Operations (Operazioni) per scegliere se vuoi Edit (Modificare) le proprietà del file, usare Edit in ONLYOFFICE (Modifica in ONLYOFFICE) oppure Delete (Eliminare) il file.

    ONLYOFFICE Drupal

Aggiungere file ai post​

Quando crei un post, puoi aggiungere il nuovo elemento ONLYOFFICE.

  1. Vai su Structure (Struttura) > Content types (Tipi di contenuto) > fai clic su Manage fields (Gestisci campi) accanto al campo di contenuto richiesto. Nella pagina che si apre, fai clic su Add field (Aggiungi campo). Aggiungi un nuovo campo: General, Number, Reference o Text. Imposta l'etichetta e salva.

    ONLYOFFICE Drupal

  2. Per il campo File aggiunto, specifica le estensioni dei file. Vai su Structure > Content types > Manage fields, oppure rimani nella pagina aperta. Nel campo Allowed file extensions (Estensioni di file consentite), specifica i formati di file che verranno mostrati negli editor (docx, xlsx, pptx).

    ONLYOFFICE Drupal

  3. Per il campo Media aggiunto, seleziona la casella Document (Documento).

    ONLYOFFICE Drupal

  4. Vai su Structure > Media types (Tipi di media) > Document > apri l'elenco a discesa e scegli l'opzione Manage display (Gestisci visualizzazione).

    ONLYOFFICE Drupal

  5. Per il campo Document, specifica il formato ONLYOFFICE Preview (Anteprima ONLYOFFICE). Facendo clic sul simbolo dell'ingranaggio, puoi specificare le dimensioni della finestra dell'editor incorporato.

    ONLYOFFICE Drupal

    Quando hai terminato le impostazioni preliminari, puoi creare post nella scheda Content. Fai clic sul pulsante Add content e seleziona il contenuto creato.

    ONLYOFFICE Drupal

Poi:

  1. Specifica un titolo e seleziona un file (se il contenuto include campi File).
  2. Per la sezione Media, specifica il nome del file caricato in precedenza.
  3. I visitatori del tuo sito potranno anche visualizzare la pagina creata (People (Persone) > Permissions (Permessi) > View published content (Visualizza i contenuti pubblicati)).

Lavorare con i moduli PDF​

Creare/caricare un modulo PDF​

  1. Vai su Manage → Content → ONLYOFFICE form (Modulo ONLYOFFICE).
  2. Fai clic sul pulsante Create&Upload (Crea e carica).
  3. Scegli l'opzione Blank (Vuoto) dal menu a discesa Create form from (Crea modulo da) e inserisci il nome del file nel campo corrispondente per creare un nuovo file.
  4. Per caricare un file PDF esistente, scegli l'opzione Upload (Carica) dal menu a discesa Create form from.
  5. Il file è ora disponibile nella pagina PDF Forms (Moduli PDF).

Pubblicare un modulo PDF​

Configurazione preliminare

  1. Vai su Manage → Structure → Content type.
  2. Scegli l'opzione Manage fields accanto al tipo di contenuto richiesto.
  3. Fai clic sul pulsante Create a new field (Crea un nuovo campo) nell'angolo in alto a sinistra della pagina Manage fields appena aperta.
  4. Scegli l'opzione ONLYOFFICE form.
  5. Inserisci il nome richiesto nel campo Label (Etichetta).
  6. Al tipo di contenuto scelto in precedenza al passaggio 2 è ora assegnato il tipo ONLYOFFICE form.

Pubblicazione

  1. Vai su Manage → Content → Content.
  2. Fai clic sul pulsante Add content nell'angolo in alto a sinistra.
  3. Scegli il tipo di contenuto a cui hai assegnato in precedenza il tipo ONLYOFFICE form.
  4. Inserisci il nome del modulo creato nel campo ONLYOFFICE form. Se non esiste alcun modulo creato in precedenza, fai clic sul pulsante Create new ONLYOFFICE form (Crea nuovo modulo ONLYOFFICE).
  5. Fai clic sul pulsante Save per creare una pagina del modulo in Drupal.

Compilare un modulo PDF​

  1. Compila il campo del modulo.
  2. Fai clic sul pulsante Complete&Submit (Completa e invia) nella barra degli strumenti superiore.
  3. Puoi scaricare la copia del modulo compilato. Fai clic sul pulsante ⋮ nell'angolo in alto a destra e scegli se vuoi scaricarlo come file .docx o .pdf.

Per saperne di più sulla compilazione dei moduli, consulta la seguente guida.

Lavorare con i moduli compilati​

  1. Vai su Manage → Content → ONLYOFFICE form → Submitted forms (Moduli inviati).
  2. Tutti i moduli compilati sono raggruppati per nome del modello. Fai clic sul nome del modello per vedere tutti i moduli associati.
  3. Puoi visualizzare, scaricare o eliminare qualsiasi modulo.
note

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