Drupal

Caratteristiche principali

• Modifica e visualizzazione di documenti di testo, fogli di calcolo, presentazioni e moduli PDF.
• Co-editing dei documenti in tempo reale: due modalità di co-editing (Veloce e Rigida), la modalità Traccia Modifiche, commenti e la chat integrata.
• Supporto JWT per proteggere il tuo traffico in modo che nessuno possa accedere ai tuoi documenti tranne gli utenti con i diritti appropriati.
• Anteprima dei file su 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.

Requisiti

• ONLYOFFICE Docs (Document Server) v7.1 o successiva.

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

  Si prega di fare riferimento alla pagina di documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.
• Modulo core di Drupal 10 o superiore.
• firebase/php-jwt: 6.0.0 o superiore.
• Connettore ONLYOFFICE per Drupal

Installazione tramite l'interfaccia utente di Drupal

1. Sulla pagina del progetto della barra degli strumenti Admin su drupal.org, scorri fino alla sezione Rilasci in fondo alla pagina. Clicca sul link Visualizza tutti i rilasci.
2. Scegli la versione richiesta dall'elenco.
3. Copia l'indirizzo del link tar.gz. A seconda del tuo dispositivo e browser, puoi farlo cliccando con il tasto destro e selezionando Copia indirizzo link.
4. Nel menu amministrativo Gestisci, vai su Estendi (admin/modules). Apparirà la pagina Estendi.
5. Clicca sul pulsante Aggiungi nuovo modulo. Apparirà la pagina Aggiungi nuovo modulo.
   
6. Incolla il link di download copiato nel campo Aggiungi da un URL.
   
7. Clicca su 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

Installazione tramite Composer

Inserisci il seguente comando nella radice 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 tramite l'interfaccia utente di Drupal

1. Apri la pagina Estendi (admin/modules) tramite il menu amministrativo Gestisci.
2. Trova il modulo Connettore ONLYOFFICE e seleziona la casella corrispondente.
   
3. Clicca su Installa per abilitare il modulo.

Abilitare il modulo di integrazione ONLYOFFICE tramite la riga di comando

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

   drush pm:enable onlyoffice

2. Segui le istruzioni del wizard.

Come funziona

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

I concetti principali utilizzati nella documentazione attuale sono spiegati di seguito.

Il lato client include:

• Gestore documenti - l'elenco dei documenti visualizzati nel browser dell'utente dove l'utente può selezionare il documento necessario ed eseguire alcune azioni con 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 funzionalità di modifica dei documenti più conosciute disponibili, utilizzata come mezzo tra l'utente e il servizio di modifica documenti.

Il lato server include:

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

Si noti che il Document Server di ONLYOFFICE include l'editor di documenti, il servizio di modifica documenti, il servizio di comando documenti, il servizio di conversione documenti e il servizio di creazione documenti. Il gestore documenti e il servizio di archiviazione documenti sono inclusi nel Community Server o devono essere implementati dagli integratori software che utilizzano il Document Server di ONLYOFFICE 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 è salvato solo sul lato client, quindi la trasmissione tra le parti è protetta e firmata digitalmente.

Il token è generato utilizzando lo standard JWT (JSON Web Tokens). I token sono firmati dalla chiave del server, quindi il client è in grado di 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 dai parametri principali. Se il token non è valido, il comando non viene eseguito. Per saperne di più, leggi la guida alla sicurezza 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 Estendi (admin/modules) tramite il menu amministrativo Gestisci.
2. Clicca sulla freccia nella descrizione del modulo Connettore ONLYOFFICE per aprire un elenco a discesa.
3. Scegli l'opzione Configura.
4. Inserisci la chiave segreta nel campo Chiave segreta.
   
5. Nel file di configurazione del Document Server di ONLYOFFICE, specifica la stessa chiave segreta e abilita la convalida.

Caricamento dei file su Drupal

1. Vai su Gestisci > Contenuto.
2. Clicca sul pulsante Aggiungi contenuto.
3. Clicca sul tipo di contenuto richiesto.
4. Inserisci il titolo, la lingua e il corpo, e imposta il formato del testo.
5. Nel campo Aggiungi un nuovo file, clicca sul pulsante Sfoglia e scegli il file dal tuo disco rigido del PC.
6. Seleziona o deseleziona la casella Pubblicato a seconda delle tue preferenze.
7. Clicca sul pulsante Salva.

Visualizzazione, modifica e gestione dei file in Drupal

1. Vai su Gestisci > Contenuto.
2. Passa alla scheda Media nella parte superiore dello schermo.
3. Trova il file richiesto nell'elenco o utilizza il campo di ricerca in alto.
4. Clicca sulla freccia nella colonna Operazioni per scegliere se vuoi Modificare le proprietà del file, Modificare in ONLYOFFICE o Eliminare il file.
   

Aggiungere file ai post

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

1. Vai su Struttura > Tipi di contenuto > clicca su Gestisci campi accanto al campo di contenuto richiesto. Nella pagina aperta, clicca su Aggiungi campo. Aggiungi un nuovo campo: Generale, Numero, Riferimento o Testo. Imposta l'etichetta e salva.
   
2. Per il campo File aggiunto, specifica le estensioni dei file. Vai su Struttura > Tipi di contenuto > Gestisci campi, o rimani sulla pagina aperta. Nel campo Estensioni di file consentite, specifica i formati di file che saranno mostrati negli editor (docx, xlsx, pptx).
   
3. Per il campo Media aggiunto, seleziona la casella Documento.
   
4. Vai su Struttura > Tipi di media > Documento > apri l'elenco a discesa e scegli l'opzione Gestisci visualizzazione.
   
5. Per il campo Documento, specifica il formato ONLYOFFICE Preview. Cliccando sul simbolo dell'ingranaggio, puoi specificare le dimensioni della finestra dell'editor incorporato.
   

   Quando hai terminato con le pre-impostazioni, puoi creare post nella scheda Contenuto. Clicca sul pulsante Aggiungi contenuto e seleziona il contenuto creato.

   

1. Specifica un titolo e seleziona un file (se il contenuto contiene campi File).
2. Per la sezione Media, specifica il nome del file precedentemente caricato.
3. I visitatori del tuo sito potranno anche visualizzare la pagina creata (Persone > Permessi > Visualizza contenuti pubblicati).

Lavorare con i moduli PDF

Creare/caricare un modulo PDF

1. Vai su Gestisci → Contenuto → Modulo ONLYOFFICE.
2. Clicca sul pulsante Crea & Carica.
3. Scegli l'opzione Vuoto dal menu a discesa 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 Carica dal menu a discesa Crea modulo da.
5. Il file è ora disponibile nella pagina Moduli PDF.

Pubblicare un modulo PDF

Pre-configurazione

1. Vai su Gestisci → Struttura → Tipo di contenuto.
2. Scegli l'opzione Gestisci campi vicino al tipo di contenuto richiesto.
3. Clicca sul pulsante Crea un nuovo campo nell'angolo in alto a sinistra della pagina Gestisci campi appena aperta.
4. Scegli l'opzione Modulo ONLYOFFICE.
5. Inserisci il nome richiesto nel campo Etichetta.
6. Il tipo di contenuto scelto precedentemente al passaggio 2 ora ha assegnato il tipo di modulo ONLYOFFICE.

Pubblicazione

1. Vai su Gestisci → Contenuto → Contenuto.
2. Clicca sul pulsante Aggiungi contenuto nell'angolo in alto a sinistra.
3. Scegli il tipo di contenuto a cui hai precedentemente assegnato il tipo Modulo ONLYOFFICE.
4. Inserisci il nome del modulo creato nel campo Modulo ONLYOFFICE. Se non c'è un modulo creato in precedenza, clicca sul pulsante Crea nuovo modulo ONLYOFFICE.
5. Clicca sul pulsante Salva per creare una pagina del modulo in Drupal.

Compilare un modulo PDF

1. Compila il campo del modulo.
2. Clicca sul pulsante Completa & Invia sulla barra degli strumenti in alto.
3. Puoi scaricare una copia del modulo compilato. Clicca 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 guida seguente.

Lavorare con i moduli compilati

1. Vai su Gestisci → Contenuto → Modulo ONLYOFFICE → Moduli inviati.
2. Tutti i moduli compilati sono raggruppati per nome del modello. Clicca sul nome del modello per vedere tutti i moduli associati.
3. Puoi visualizzare, scaricare o eliminare qualsiasi modulo.