Drupal

Características principales

• Edición y visualización de documentos de texto, hojas de cálculo, presentaciones y formularios PDF.
• Coedición de documentos en tiempo real: dos modos de coedición (Rápido y Estricto), el modo Control de Cambios, comentarios y el chat incorporado.
• Soporte JWT para asegurar tu tráfico de modo que nadie pueda acceder a tus documentos excepto los usuarios con los derechos adecuados.
• Vista previa de archivos en páginas públicas.

Formatos compatibles

• Para edición: DOCX, XLSX, PPTX, formularios PDF.
• Solo para visualización: 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.

Requisitos

• ONLYOFFICE Docs (Servidor de documentos) v7.1 o posterior.

  Necesitas una instancia de ONLYOFFICE Docs que sea resoluble y conectable tanto desde Drupal como desde cualquier cliente final. Debe poder realizar POST a Drupal directamente.

  Por favor, consulta la página de documentación oficial para obtener más información sobre la instalación de ONLYOFFICE Docs.
• Módulo central de Drupal 10 o superior.
• El firebase/php-jwt: 6.0.0 o superior.
• Conector de ONLYOFFICE para Drupal

Instalación a través de la interfaz de usuario de Drupal

1. En la página del proyecto de la barra de herramientas de Admin en drupal.org, desplázate hasta la sección de Releases al final de la página. Haz clic en el enlace View all releases.
2. Elige la versión requerida de la lista.
3. Copia la dirección del enlace tar.gz. Dependiendo de tu dispositivo y navegador, puedes hacerlo haciendo clic derecho y seleccionando Copy link address.
4. En el menú administrativo Manage, navega a Extend (admin/modules). Aparecerá la página Extend.
5. Haz clic en el botón Add new module. Aparecerá la página Add new module.
   
6. Pega el enlace de descarga copiado en el campo Add from a URL.
   
7. Haz clic en Install para cargar y descomprimir el nuevo módulo en el servidor. Los archivos se descargan en el directorio de módulos.
8. Para aplicar la configuración de localización, por favor ejecuta los siguientes comandos:

   drush locale-check

   drush locale-update

Instalación a través de Composer

Introduce el siguiente comando en la raíz de tu sitio Drupal:

composer require onlyoffice/onlyoffice-drupal

Si el directorio de instalación es web/modules/contrib/drupal, por favor ejecuta los siguientes comandos para aplicar la configuración de localización:

drush locale-check

drush locale-update

Activando el módulo de integración de ONLYOFFICE a través de la interfaz de usuario de Drupal

1. Abre la página Extend (admin/modules) a través del menú administrativo Manage.
2. Localiza el módulo Conector de ONLYOFFICE y marca la casilla correspondiente.
   
3. Haz clic en Install para activar el módulo.

Activando el módulo de integración de ONLYOFFICE a través de la línea de comandos

1. Ejecuta el siguiente comando de Drush, dando el nombre del proyecto como parámetro:

   drush pm:enable onlyoffice

2. Sigue las instrucciones del asistente.

Cómo funciona

La interacción usuario-documento se realiza tanto en el lado del cliente como en el lado del servidor.

Las nociones principales utilizadas a lo largo de la documentación actual se explican a continuación.

El lado del cliente incluye:

• Gestor de documentos - la lista de documentos mostrada en el navegador del usuario donde el usuario puede seleccionar el documento necesario y realizar algunas acciones con él (dependiendo de los derechos proporcionados, el usuario puede abrir el documento para verlo o editarlo, compartir el documento con otros usuarios).
• Editor de documentos - la interfaz de visualización y edición de documentos con todas las características de edición de documentos más conocidas disponibles, utilizada como un medio entre el usuario y el servicio de edición de documentos.

El lado del servidor incluye:

• Servicio de almacenamiento de documentos - el servicio del servidor que almacena todos los documentos disponibles para los usuarios con los derechos de acceso apropiados. Proporciona los IDs de los documentos y enlaces a estos documentos al gestor de documentos que el usuario ve en el navegador.
• Servicio de edición de documentos - el servicio del servidor que permite realizar la visualización y edición de documentos (en caso de que el usuario tenga los derechos apropiados para hacerlo). La interfaz del editor de documentos se utiliza para acceder a todas las características del servicio de edición de documentos.
• Servicio de comandos de documentos - el servicio del servidor que permite realizar comandos adicionales con el servicio de edición de documentos.
• Servicio de conversión de documentos - el servicio del servidor que permite convertir el archivo de documento en el formato Office Open XML apropiado (docx para documentos de texto, xlsx para hojas de cálculo y pptx para presentaciones) para su edición o descarga.
• Servicio de creación de documentos - el servicio del servidor que permite construir un documento fácilmente sin la necesidad de ejecutar un editor de procesamiento de documentos.

Por favor, ten en cuenta que el Servidor de documentos de ONLYOFFICE incluye el editor de documentos, servicio de edición de documentos, servicio de comandos de documentos, servicio de conversión de documentos y servicio de creación de documentos. El gestor de documentos y el servicio de almacenamiento de documentos están incluidos en el Servidor Comunitario o deben ser implementados por los integradores de software que utilizan el Servidor de documentos de ONLYOFFICE en su propio servidor.

Habilitando JWT para la integración de ONLYOFFICE y Drupal

JWT, o JSON Web Token, es una cadena enviada del cliente al servidor dentro de la solicitud HTTP para validar la autenticidad del cliente. JWT se guarda solo en el lado del cliente, por lo que la transmisión entre las partes está protegida y firmada digitalmente.

El token se genera usando el estándar JWT (JSON Web Tokens). Los tokens están firmados por la clave del servidor, por lo que el cliente puede verificar que el token es legítimo.

ONLYOFFICE Docs valida el token. Los datos del payload se consideran válidos y se utilizan en lugar de los datos correspondientes de los parámetros principales. Si el token no es válido, el comando no se ejecuta. Para obtener más información, por favor lee la guía de seguridad API.

Para proteger tus documentos con JWT en Drupal, abre la página ~/config/system/onlyoffice-settings con configuraciones administrativas para la sección ONLYOFFICE. Alternativamente, sigue estos pasos:

1. Abre la página Extend (admin/modules) a través del menú administrativo Manage.
2. Haz clic en la flecha en la descripción del módulo Conector de ONLYOFFICE para abrir una lista desplegable.
3. Elige la opción Configure.
4. Ingresa la clave secreta en el campo Secret key.
   
5. En el archivo de configuración del Servidor de documentos de ONLYOFFICE, especifica la misma clave secreta y habilita la validación.

Subiendo archivos a Drupal

1. Ve a Manage > Content.
2. Haz clic en el botón Add content.
3. Haz clic en el tipo de contenido requerido.
4. Ingresa el título, idioma y cuerpo, y establece el formato de texto.
5. En el campo Add a new file, haz clic en el botón Browse y elige el archivo desde el disco duro de tu PC.
6. Marca o desmarca la casilla Published dependiendo de tus preferencias.
7. Haz clic en el botón Save.

Visualizando, editando y gestionando archivos en Drupal

1. Ve a Manage > Content.
2. Cambia a la pestaña Media en la parte superior de la pantalla.
3. Encuentra el archivo requerido en la lista o usa el campo de búsqueda en la parte superior.
4. Haz clic en la flecha en la columna Operations para elegir si deseas Edit las propiedades del archivo, Edit in ONLYOFFICE o Delete el archivo.
   

Añadiendo archivos a publicaciones

Al crear una publicación, puedes añadir el nuevo elemento de ONLYOFFICE.

1. Ve a Structure > Content types > haz clic en Manage fields junto al campo de contenido requerido. En la página abierta, haz clic en Add field. Añade un nuevo campo: General, Number, Reference, o Text. Establece la etiqueta y guarda.
   
2. Para el campo File añadido, especifica las extensiones de archivo. Ve a Structure > Content types > Manage fields, o permanece en la página abierta. En el campo Allowed file extensions, especifica los formatos de archivo que se mostrarán en los editores (docx, xlsx, pptx).
   
3. Para el campo Media añadido, marca la casilla Document.
   
4. Ve a Structure > Media types > Document > abre la lista desplegable y elige la opción Manage display.
   
5. Para el campo Document, especifica el formato ONLYOFFICE Preview. Al hacer clic en el símbolo de engranaje, puedes especificar las dimensiones de la ventana del editor incrustado.
   

   Cuando hayas terminado con las preconfiguraciones, puedes crear publicaciones en la pestaña Content. Haz clic en el botón Add content y selecciona el contenido creado.

   

1. Especifica un título y selecciona un archivo (si el contenido contiene campos File).
2. Para la sección Media, especifica el nombre del archivo previamente subido.
3. Los visitantes de tu sitio también podrán ver la página creada (People > Permissions > View published content).