Etherpad

Etherpad Lite es una aplicación externa al panel de control que permite la edición colaborativa de documentos online (Pads) en tiempo real y entre múltiples personas.

Además, existe una extensión, ep_maadix, que permite habilitar áreas de trabajo privadas, de manera que se puede elegir si los documentos creados son accesibles al público en general o solamente a las personas que tengan una cuenta activada. Esta extensión ya no se instala por defecto: si quieres utilizarla, tendrás que instalarla manualmente, como se explica en el apartado Área Privada de Etherpad.

Instalación

Desde el Panel de Control, ve al apartado “Instalar Aplicaciones”, ahí podrás ver todas las aplicaciones disponibles para instalar, entre ellas Etherpad. Solo tienes que marcar la casilla “Seleccionar” e indicar:

Un dominio o subdominio donde lo quieres instalar. Este dominio tiene que estar apuntando a la dirección IP del servidor, para ello tendrás que añadir un registro A en el editor de zonas DNS de tu dominio (operación externa a MaadiX). Recuerda que este dominio o subdominio no lo tienes que añadir en la sección “Dominios”.
Una contraseña para asignarle a la cuenta de administración de Etherpad. Guárdala en algún lugar seguro ya que no será enviada por correo por razones de seguridad.

Una vez indicados estos dos parámetros puedes darle al botón de “Instalar”.

Después de unos minutos te llegará un email (a la dirección que tengas configurada para la cuenta administración del Panel de Control) confirmando que la instalación terminó correctamente.

Cambio de dominio

Si necesitas cambiar el dominio o subdominio de Etherpad solo tienes que ir al Panel de Control y en “Mis aplicaciones” > “Etherpad” > “Configurar” para indicar el nuevo dominio. Este dominio tiene que estar apuntando a la dirección IP del servidor, para ello tendrás que añadir un registro A en el editor de zonas DNS de tu dominio (operación externa a MaadiX). Recuerda que este dominio o subdominio no lo tienes que añadir en la sección “Dominios”.

Usar Etherpad público

Para hacer uso de Etherpad de forma pública tendrás que ir al dominio o subdominio que indicaste durante la instalación. También puedes acceder a través del Panel de Control, en “Mis Aplicaciones” > “Etherpad” > “Ir a la aplicación”.

Etherpad admin

La aplicación Etherpad Lite incluye un panel propio de administración que permite:

Editar preferencias.
Instalar o desinstalar plugins.
Reiniciar la aplicación.

El área de administración de esta aplicación está disponible en la dirección: subdominio.indicado.org/admin/

Para poder acceder a esta área, tendrás que insertar la cuenta admin y la contraseña que indicaste durante la instalación.

Login in the administration area — Acceso al área de administración.

Solamente la cuenta admin puede acceder a esta área, en la que tiene acceso a todos los grupos y cuentas creadas en el sistema. Su contraseña no es válida para operar desde el front-end.

Cambiar contraseña de admin

Si necesitas cambiar la contraseña de la cuenta de administración, tendrás que acceder por SSH al servidor con la cuenta Superusuarix, ya que es necesario editar el archivo como root.

Edita el archivo /var/www/etherpad/etherpad-lite/credentials.json, donde encontrarás unas líneas parecidas a las siguientes:

"users": {
  "admin": {
  "password": "yourpasswordhere",
  "is_admin": true
  }
}

Cambia el valor del password por tu nueva contraseña, teniendo cuidado de ponerlo entre las comillas.
Guarda el archivo.
Reinicia Etherpad ejecutando service etherpad restart.

Área Privada de Etherpad

MaadiX ha desarrollado un plugin de Etherpad Lite, ep_maadix, que permite crear espacios privados de trabajo. Este plugin ya no se instala por defecto junto con la aplicación: si quieres utilizarlo, tendrás que instalarlo manualmente desde el área de administración de Etherpad Lite, en la pestaña “Gestor de complementos”. Busca ep_maadix en la lista de complementos disponibles y haz clic en “Instalar”.

Para acceder a la configuración del plugin, una vez iniciada sesión en el área de administración de Etherpad Lite (subdominio.indicado.org/admin/), accede al front-end de la aplicación (subdominio.indicado.org): arriba a la derecha aparecerá un icono de ajustes (una ruedecita), que te llevará a la administración del plugin ep_maadix.

Icono de ajustes de ep_maadix en el front-end.

En la pestaña “General settings” encontrarás las siguientes opciones:

Allow users to register: si esta opción está activada, cualquier persona podrá crearse una cuenta sin necesidad de recibir una invitación. De lo contrario, solo las personas con una invitación válida podrán acceder a la aplicación. Si una persona se registra, no podrá acceder a los grupos ya creados hasta que no reciba una invitación. Solamente podrá crear nuevos grupos, nuevos pads e invitar personas a su grupo.
Allow users to recover lost password: activar esta opción permitirá a las personas recuperar su contraseña. De forma general, es aconsejable dejarla activada, ya que esto permite a las personas restablecer por sí mismas su contraseña si la pierden, evitando tener que enviarla por correo u otro canal.
Allow public pads: permite crear pads públicos sin necesidad de tener una cuenta activada ni pertenecer a ningún grupo. Los grupos y pads privados siguen estando disponibles aunque esta opción esté activada. Si se quiere evitar que cualquier persona pueda crear nuevos pads, se puede desactivar. Para que se apliquen los cambios hay que reiniciar el servicio: ve al área de administración (subdominio.indicado.org/admin/), a la pestaña “Configuración” (en el menú izquierdo), y haz clic en el botón “Restart Etherpad” al final de la página.

Crear cuentas

Desde el área de administración del plugin puedes invitar personas. Si has elegido no permitir que las personas se registren sin invitación, tendrás que invitar al menos una cuenta aquí. También puedes crearla desde el front-end dandole a la pestaña “Registrar” arriba a la derecha, antes de eliminar la opción de registrarse. Esta cuenta podrá empezar a crear y administrar grupos desde el front-end de la aplicación.

Recuerda que las credenciales de la cuenta con permisos de administración no son válidas para operar desde el front-end (subdominio.indicado.org).

Desde la pestaña “Manage Groups” puedes consultar los grupos existentes, eliminarlos y ver las personas que pertenecen a cada uno. Los grupos no se pueden crear desde aquí; para ello, consulta ¿Cómo crear un grupo privado?.

Desde la pestaña “Manage Users” puedes invitar a una persona a crear una cuenta, así como activarla, desactivarla, eliminarla o enviarle un enlace para restablecer su contraseña.

La aplicación intentará enviar un correo a la cuenta indicada. Sin embargo, si no has configurado manualmente un método de envío por SMTP, es posible que el correo no llegue o sea rechazado. En ese caso, la mejor opción es activar manualmente la cuenta haciendo clic en el interruptor que aparece en la columna “Status”. Las cuentas activadas muestran el icono de enlace en la columna “New Password”. Al hacer clic en este icono aparecerá una ventana emergente con el enlace para restablecer la contraseña, que puedes enviar manualmente a la persona. Ten en cuenta que este enlace caduca a los 10 minutos, y que generar uno nuevo invalida el anterior.

Nueva contraseña — Enlace para restablecer la contraseña.

Etherpad front-end

Las personas que tengan una cuenta activada pueden administrar grupos, invitar a otras personas, crear y editar documentos (pads) desde el front-end. Pueden acceder al front-end de la aplicación en subdominio.indicado.org.

Para acceder al área privada, hay que identificarse haciendo clic en “Login”, en la parte superior derecha de la página.

Access front-end — Acceso al front-end.

Registrarse

Si desde el «Área privada de Etherpad» (back-end) hemos marcado la opción «Allow users to register», entonces cualquier persona podrá crearse una cuenta sin necesidad de recibir una invitación ni acceder al «Área privada».

Para registrarse solo será necesario ir a subdominio.indicado.org y hacer clic en «Register» arriba a la derecha e indicar el email para la cuenta que se quiera registrar.

Se enviará un email al correo electrónico indicado con un enlace de activación de la cuenta. Abriendo el enlace en el navegador se podrá acceder al formulario de activación de la cuenta. Completa los campos indicados para proceder a la creación de la nueva cuenta.

Grupos

Los pads privados y las cuentas deben estar asociados a un grupo. Una misma cuenta puede pertenecer a uno o más grupos, además de poder crear uno propio. Si una cuenta no pertenece a ningún grupo, tendrá que crear uno antes de poder crear documentos o invitar nuevas personas. Se pueden consultar los grupos a los que se tiene acceso o crear nuevos haciendo clic en “My groups”, una vez dentro de la aplicación (Login).

¿Cómo crear un grupo privado?

En “Create a new private group” (Crear un nuevo grupo privado) inserta un nombre de grupo (este nombre no debe existir aún en el sistema) y haz clic en el botón “Create” (Crear). El nuevo grupo aparecerá en la misma página. Una vez hecho esto, podrás empezar a invitar a otras personas o crear nuevos documentos.

Invitar personas

Para añadir personas a un grupo, haz clic en «View / Add Users» (Ver / Agregar cuentas) desde la tabla de la página «My groups». En el campo «Invite user to this group» (Invitar persona a este grupo) inserta una dirección de correo electrónico válida de la persona que quieras invitar. Si la dirección insertada no está registrada todavía en el sistema, se le enviará un correo electrónico de confirmación con las instrucciones para activar la cuenta. También deberás elegir el rol que deseas asignar para esta persona en este grupo.

Roles

El rol asignado a una cuenta solamente se aplica a un determinado grupo. Una cuenta puede tener acceso a varios grupos con diferentes roles en cada uno de ellos. Si una persona crea un nuevo grupo, su rol para dicho grupo será siempre “Admin”.

Una persona nunca puede asignar un rol más alto que su propio rol dentro de un grupo.

Los roles disponibles son:

Group Author: puede crear y editar Pads.
Group Manager: puede crear, editar y borrar pads, e invitar o quitar cuentas.
Group Admin: puede crear, editar y borrar Pads, invitar o eliminar cuentas, y borrar todo el grupo.

Esta nueva cuenta invitada aparecerá en la tabla de abajo. El rol asignado a esta cuenta se puede modificar y editar más tarde.

¿Cómo crear un Pad privado?

Los Pads se deben crear desde la página de la lista de Pads de un grupo específico, ya que cada Pad solo puede pertenecer a un grupo determinado. Para crear un nuevo Pad, haz clic en «View / Add Pads» (Ver / Agregar Pads) en la tabla de la página «My groups». En la nueva página que se abre, inserta el nombre del Pad que quieres crear en el campo «Add a Private Pad to this Group» (Crear Pad privado para este grupo) y haz clic en el botón «Create» (Crear). El nuevo pad aparecerá en la tabla de abajo.

El nombre del Pad debe ser único para cada grupo.

Visitar Pads existentes

Para abrir un Pad ya creado, haz clic en «View / Add Pads» (Ver / Agregar Pads) en la tabla de la página «My groups», en la línea correspondiente al grupo en el que el documento fue creado. Encontrarás un listado de todos los Pads ordenados por fecha de última edición del grupo seleccionado. Puedes invertir este orden para que se muestren las ediciones más antiguas primero, o reordenar el listado por orden alfabético utilizando las flechas de las columnas correspondientes.

Si te quedara alguna duda, puedes encontrar en este enlace la documentación oficial de la aplicación Etherpad Lite.