Moodle

Características principales

• Edición y visualización de documentos de texto, hojas de cálculo, presentaciones y formularios.
  Para obtener más información sobre formularios, lea los artículos correspondientes para crear y rellenar formularios.
• Coedición de documentos en tiempo real: dos modos de coedición (Rápido y Estricto), el modo Control de cambios, comentarios y chat integrado.
• Soporte JWT para asegurar su tráfico de modo que nadie pueda acceder a sus documentos excepto los usuarios con los derechos adecuados.

Formatos compatibles

• Para visualización y edición: DOCX, XLSX, PPTX, PDF
• Solo para visualización: TXT, CSV
• Para rellenar formularios: PDF

Novedades en la versión 6.1.0

Agregado

• Botón Comprobar conexión en la configuración para probar la conectividad con el servidor de documentos
• Validación de configuración de administrador para campos relacionados con el servidor de documentos
• Se agregaron nuevas plantillas de idioma: ca, cs, da, hu, id, ro, sq, ur

Cambiado

• Lógica de validación de configuración de administrador para verificar solo la validez de la entrada
• Eliminadas barras diagonales finales de las URLs de configuración después de la actualización
• Corregido renombrado de archivo fallido
• Corregida carga de archivo no soportada
• Corregidos bloqueadores de aprobación: colisiones de espacios de nombres, uso de superglobales
• Corregida desactivación incorrecta de la verificación de certificado en solicitudes curl

El registro completo de cambios está disponible aquí.

Requisitos

• ONLYOFFICE Docs (Document Server) 6.1.0 o superior (versión servidor o versión en la nube)

  Necesita una instancia de ONLYOFFICE Docs que sea resoluble y conectable tanto desde Moodle como desde cualquier cliente final. Debe poder hacer POST a Moodle directamente.

  Por favor, consulte la página de documentación oficial para obtener más información sobre la instalación de ONLYOFFICE Docs.
• Moodle v4.9 o superior
• Se utiliza ONLYOFFICE Connector v4.4.0 para Moodle v4.3.0; v4.3.0 para Moodle v4 < 4.3.0; v4.2.0 para Moodle v3.9-3.11

Instalando el conector ONLYOFFICE usando la biblioteca de plugins de Moodle

1. Inicie sesión como administrador en su instancia de Moodle y vaya a Administración del sitio → Plugins → Instalar plugins.
   Si no puede encontrar esta ubicación, la instalación de plugins está deshabilitada en su sitio.
2. Haga clic en el botón Instalar plugins desde el directorio de plugins de Moodle.
3. Seleccione su versión actual de Moodle.
4. Busque el plugin documento ONLYOFFICE.
5. Haga clic en el botón Instalar, luego en Continuar.
6. Confirme la solicitud de instalación.
7. Revise el informe de validación del plugin.
   Importante Elija correctamente su versión de Moodle. Si descarga e instala por error una versión incorrecta del plugin para su servidor Moodle, esto puede causar problemas graves, incluso el bloqueo del sitio Moodle.

Instalando el conector ONLYOFFICE usando el archivo .ZIP de GitHub

1. Descargue el conector desde la página de GitHub.
2. Inicie sesión en su instancia de Moodle como administrador, vaya a la sección Administración del sitio, cambie a la pestaña Plugins y haga clic en el enlace Instalar plugins.
3. Suba el archivo moodle-mod_onlyofficeeditor-x.x.x.zip mediante el selector de archivos o arrástrelo al campo correspondiente y haga clic en el botón Instalar plugin desde el archivo ZIP.
   
4. Revise el informe de validación del plugin y haga clic en Continuar.
   Si el directorio de destino no tiene permisos de escritura, verá un mensaje de advertencia, por ejemplo, [Error] Write access check [/var/www/html/moodle/mod]. En este caso, puede hacerlo temporalmente escribible usando el siguiente comando:

   sudo chmod -R 777 /var/www/html/moodle

   Después, repita el Paso 3.

   Después de instalar el plugin, debe revertir los permisos para que el directorio ya no sea escribible. Use el siguiente comando:

   sudo chmod -R 0755 /var/www/html/moodle

5. Haga clic en Continuar en la página Información de la versión actual → Comprobaciones del servidor.
6. Haga clic en Actualizar base de datos de Moodle ahora en la página Comprobación de plugins.
   
7. Haga clic en Continuar en la página Actualizando a la nueva versión.

Instalando el plugin Moodle Assign Submission ONLYOFFICE Integration

1. Inicie sesión como administrador en su instancia de Moodle y vaya a Administración del sitio > Plugins > Instalar plugins.
   Si no puede encontrar esta ubicación, la instalación de plugins está deshabilitada en su sitio.
2. Haga clic en el botón Instalar plugins desde el directorio de plugins de Moodle.
3. Seleccione su versión actual de Moodle.
4. Busque el plugin ONLYOFFICE Assign Submission.
5. Haga clic en el botón Instalar, luego en Continuar.
6. Confirme la solicitud de instalación.
7. Revise el informe de validación del plugin.
   Importante Elija correctamente su versión de Moodle. Si descarga e instala por error una versión incorrecta del plugin para su servidor Moodle, esto puede causar problemas graves, incluso el bloqueo del sitio Moodle.

Alternativamente, puede descargar el plugin desde la página de GitHub e instalarlo desde el archivo ZIP.

Cómo funciona

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

A continuación, se explican los conceptos principales usados en esta documentación.

El lado cliente incluye:

• Administrador de documentos — la lista de documentos mostrada en el navegador del usuario donde puede seleccionar el documento necesario y realizar algunas acciones con él (dependiendo de los derechos otorgados, el usuario puede abrir el documento para verlo o editarlo, compartirlo con otros usuarios).
• Editor de documentos — la interfaz para visualizar y editar documentos con todas las funciones conocidas de edición disponibles, usada como medio entre el usuario y el servicio de edición de documentos.

El lado 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 ID y enlaces de los documentos al administrador de documentos que el usuario ve en el navegador.
• Servicio de edición de documentos — el servicio del servidor que permite a los usuarios ver y editar documentos (si tienen los derechos adecuados). La interfaz del editor de documentos se usa para acceder a todas las funciones del servicio de edición de documentos.
• Servicio de comandos de documentos — el servicio del servidor que permite a los usuarios realizar comandos adicionales con el servicio de edición de documentos.
• Servicio de conversión de documentos — el servicio del servidor que permite a los usuarios convertir el archivo de documento al 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 necesidad de ejecutar un editor de procesamiento de documentos.

Tenga en cuenta que ONLYOFFICE Document Server 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 administrador de documentos y el servicio de almacenamiento de documentos están incluidos en Community Server o deben ser implementados por los integradores de software que usan ONLYOFFICE Document Server en su propio servidor.

Habilitar JWT para la integración de ONLYOFFICE y Moodle

Para proteger los documentos del acceso no autorizado, los editores ONLYOFFICE usan JSON Web Token (JWT). El token se añade en la configuración cuando se inicializa el Editor de Documentos y durante el intercambio de comandos entre los servicios internos de ONLYOFFICE Docs. La clave secreta se usa para firmar el token web JSON y validar el token al hacer la solicitud a ONLYOFFICE Docs.

A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. Debe encontrar su clave secreta en el archivo de configuración de ONLYOFFICE Docs y luego especificar la misma clave secreta en la configuración del conector.

Paso 1: Encuentre su clave secreta en el archivo de configuración de ONLYOFFICE Docs

1. Abra el archivo local.json con cualquier editor de texto disponible.
   • Para Linux — /etc/onlyoffice/documentserver/local.json
   • Para Windows — %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Para Docker – ingrese al contenedor ONLYOFFICE Docs usando el comando docker exec -it <containerID> bash y abra /etc/onlyoffice/documentserver/local.json

   El archivo local.json debería verse así:

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

2. El valor true está especificado en tres secciones. Significa que la validación del token está habilitada.
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. La clave secreta generada automáticamente está especificada en tres secciones. Puede reemplazar el valor secreto predeterminado por su propia clave secreta. La clave secreta debe ser la misma en las tres secciones.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Si realiza cambios, guárdelos y reinicie los servicios para que los cambios de configuración tengan efecto.
   • Para Linux:

     sudo supervisorctl restart all

   • Para Docker:

     docker exec <containerID> supervisorctl restart all

     o reinicie todo el contenedor:

     docker restart <containerID>

Paso 2: Especifique la misma clave secreta en la configuración del conector

En la configuración del conector, especifique el mismo secreto en el campo Clave secreta y guarde la configuración.

Agregar actividades ONLYOFFICE

Para crear una nueva actividad ONLYOFFICE:

1. Abra la sección Mis cursos y cambie al curso necesario.
2. Active el Modo de edición usando el interruptor en la esquina superior derecha.
3. Haga clic en Agregar una actividad o recurso.
4. Seleccione la actividad documento ONLYOFFICE en la ventana emergente.
   
5. Escriba el nombre de la actividad, cree, cargue o arrastre el documento necesario desde su PC y haga clic en el botón Guardar y mostrar.
   

   La actividad puede ser un archivo vacío .docx, .xlsx, .pptx o .pdf.

El documento se abrirá en el editor ONLYOFFICE Docs.

Visualización y edición de archivos

Las actividades ONLYOFFICE se marcarán con el icono en sus páginas de curso. Para abrir un documento en el editor ONLYOFFICE Docs, simplemente haga clic en su título.

Para abrir el editor en modo pantalla completa, haga clic en el botón Abrir pantalla completa en la esquina superior derecha encima de la ventana del editor.

Agregar entregas

Para agregar una entrega personalizada del tipo documento ONLYOFFICE en formato .pdf,

1. Abra la sección Mis cursos y cambie al curso necesario.
2. Active el Modo de edición usando el interruptor en la esquina superior derecha.
3. Haga clic en Agregar una actividad o recurso.
4. Seleccione la actividad Tarea en la ventana emergente.
5. En la pestaña Tipos de entrega, seleccione el tipo documento ONLYOFFICE. Una vez hecho esto, el creador de formularios (.pdf) estará disponible en la página de creación/edición de la tarea. Aquí puede crear un formulario que estará disponible para que los estudiantes lo completen después de guardar.
6. Haga clic en Guardar y volver al curso o Guardar y mostrar. La tarea creada aparecerá en la sección del curso.

Rellenar formularios

Para rellenar el formulario,

1. Seleccione la tarea creada y haga clic en Agregar entrega.
   
2. Se abrirá el formulario en formato .pdf (para Docs v8.0 o superior. Para versiones anteriores se usa el formato .oform). Cada estudiante obtiene su propia copia del formulario .pdf y trabaja en su propia tarea.
3. Rellene el formulario y haga clic en Guardar cambios.

Un profesor puede ver todas las entregas haciendo clic en el botón Ver todas las entregas.

Proteger archivos con contraseña

Los archivos ONLYOFFICE pueden protegerse con contraseña para evitar accesos no autorizados. Para ello,

1. Vaya a la pestaña Archivo en la barra de herramientas superior.
2. Seleccione la opción Proteger.
3. Haga clic en el botón Agregar contraseña.
4. Establezca una contraseña en el campo Contraseña y repítala en el campo Repetir contraseña debajo, luego haga clic en Aceptar.
   ImportanteLa contraseña no puede recuperarse si la pierde u olvida. Por favor, guárdela en un lugar seguro.

Para cambiar una contraseña,

1. Vaya a la pestaña Archivo en la barra de herramientas superior.
2. Seleccione la opción Proteger.
3. Haga clic en el botón Cambiar contraseña.
4. Establezca una contraseña en el campo Contraseña y repítala en el campo Repetir contraseña debajo, luego haga clic en Aceptar.

Para eliminar una contraseña,

1. Vaya a la pestaña Archivo en la barra de herramientas superior.
2. Seleccione la opción Proteger.
3. Haga clic en el botón Eliminar contraseña.

Para desactivar la opción de protección,

1. Vaya a la página de edición de la actividad.
2. Abra la sección Permisos del documento.
3. Marque la casilla Ocultar pestaña de protección.

Gestionar permisos

Los administradores/profesores pueden elegir si los documentos pueden descargarse o imprimirse desde dentro del editor ONLYOFFICE. Esto se puede hacer en la sección Permisos del documento.

Para cambiar el permiso del documento a solo lectura:

1. Abra el documento ONLYOFFICE necesario.
2. Vaya a Más > Permisos.
3. Busque la entrada Editar actividad de documento ONLYOFFICE/Ver actividad de documento ONLYOFFICE.
4. Agregue los roles requeridos en la sección Prohibidos o elimine los que estén en la sección Roles con permiso.