Etherpad¶

Etherpad Lite is an application external to the control panel that enables real-time, multi-user collaborative editing of documents (Pads).

In addition, the servers created with MaadiX include by default, along with this application, an extension that enables private work areas. Thus, you can choose for the created documents to be accessible to the general public or only to users who have an activated account.

Installation¶

From the Control Panel, go to the “Install Applications” section, where you will see all the applications available for installation, including Etherpad. Just check the “Select” box and specify:

A domain or subdomain where you want to install it. This domain has to be pointing to the IP address of the server, for this you will have to add an A record in the DNS zone editor of your domain (external operation to MaadiX). Remember that this domain or subdomain does not have to be added in the “Domains” section.
A password to assign to the Etherpad administration account. Keep it somewhere safe as it will not be mailed for security reasons.

Once you have specified these two parameters, you can click on the button ‘Install’ button.

After a few minutes you will receive an email (to the address you have configured for the Control Panel administration account) confirming that the installation was successfully completed.

Change of domain name¶

If you need to change the domain or subdomain of Etherpad just go to the Control Panel and in “My applications” > “Etherpad” > “Settings” to indicate the new domain. This domain has to be pointing to the IP address of the server, for this you will have to add an A record in the DNS zone editor of your domain (external operation to MaadiX). Remember that this domain or subdomain does not have to be added in the ‘Domains’ section.

Change of Etherpad domain¶

Using Etherpad publicly¶

To use Etherpad publicly, you will have to go to the domain or subdomain you specified during installation. You can also access it through the Control Panel, under “My Applications” > “Etherpad” > “Go to application”.

Creating public pads.¶

Etherpad admin¶

The Etherpad Lite application includes its own administration panel that allows to:

Edit preferences.
Install or uninstall plugins.
Re-start the application.

The administration area of this application is available at the address: subdomain.indicated.org/admin/

“In order to access this area, you will need to insert the admin account and the password you specified during installation.”

Access to the administration area.¶

Only the admin user can access this area, where he or she has access to all groups and users created in the system. The password is not valid for operating from the front-end.

Change the admin’s password¶

If you need to change the administration account password you can follow the steps below. Click on the ‘Settings’ tab in the left menu. When you do so, a plain text file will open containing all the settings for your installation. Scroll to the end of this file, where you will find lines similar to the following:

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

Change the value of the password to your new password, being careful to put it between quotation marks.
Click ‘Save Settings’.
Click ‘Restart Etherpad’.

Change of admin’s password.¶

Etherpad Private Area¶

MaadiX has developed an Etherpad Lite plugin, ep_maadix, that enables you to create private workspaces, and which is installed by default along with the application. From the Etherpad Lite administration area (subdomain.indicated.org/admin/) you can set configuration preferences for the installation. Clicking on the ‘Users and groups’ tab in the left column, the following options will appear:

Allow users to recover lost password: Enabling this option will allow users to retrieve their password. In general, it is advisable to leave it on, as this allows users to reset their password themselves, avoiding having to send it by mail or another channel.
Allow users to register: If this option is activated, anyone can create an account without receiving an invitation. Otherwise, only users with a valid invitation will be able to access the application. If a user registers, he or she will not be able to access the groups already created until receiving an invitation, but to create new groups, and new Pads and to invite users to his or her group.
Allow public pads: allows the creation of public Pads without the need to have a user activated or to belong to any group. Private groups and pads are still available even if this option is enabled. If you want to avoid that anyone can create new Pads, you can deactivate this option. You have to restart the service to apply this new setting, go to ‘Settings’ and click ‘Restart Etherpad’.

Users and groups settings.¶

Create users¶

Desde el área de administración (subdominio.indicado.org/admin/) puedes crear grupos e invitar personas. Si has elegido no permitir que las personas se registren sin invitación, tendrás que crear 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 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).

To create groups and invite users from the administrator area, click on the ‘Manage Groups’ or ‘Manage User’ tabs, which you can find in the header of the ‘Users and groups’ section on the left column (main page of the plugin).

Creation of new accounts.¶

Etherpad front-end¶

Users with an activated account can manage groups, invite other users and create and edit documents (Pads) from the front-end. The front-end of the application is available at subdomain.indicated.org.

To access the private area, you must identify yourself by clicking on ‘Login’ at the top right of the page.

Front-end access.¶

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.

Registro desde el front-end (paso 1).¶

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.

Registro desde el front-end (paso 2).¶

Groups¶

Private Pads and users must be associated with a group. The same user can belong to one or several groups and can create its own groups. If a user does not belong to any group, he or she will have to create one before being able to create documents or invite new users. You can check the groups you have access to or create new ones by clicking on ‘My groups’, once inside the application (Login).

How to create a private group?¶

On ‘Create a new private group’ insert a group name (this name must not yet exist in the system) and click the ‘Create’ button. The new group will appear on the same page. Once this is done, you can start inviting other users or creating new documents.

Invite Users¶

To add users to a group, click “View / Add Users” from the table on the “My groups” page. In the field “Invite user to this group” insert a valid email address of the user you want to create. If the inserted address is not yet registered in the system, a confirmation email will be sent to the new user with instructions on how to activate the account. You must also choose the role you want to assign to the new user for this group.

Roles¶

The role assigned to a user only applies to a certain group. A user can have access to several groups with different roles in each of them. If a user creates a new group, his role for that group will always be ‘Admin’.

A user can never assign a role higher than his own role within a group.

The roles available are:

Group Author: can create and edit Pads.

Group Manager: can create / edit / delete Pads and invite / remove Users.

Group Admin: can create / edit / delete Pads, invite / delete Users and delete the whole group

The new guest user will appear in the table below. The role assigned to the user can be changed and edited later.

How to create a private Pad?¶

Pads must be created from a specific group’s Pad list page, as each Pad can only belong to a certain group. To create a new Pad, click “View / Add Pads” in the table on the “My groups” page. On the new page that opens, insert the name of the Pad you want to create in the “Add a Private Pad to this Group” field and click the “Create” button. The new Pad will appear in the table below.

The name of the Pad must be unique to each group.

Visiting existing Pads¶

To open a Pad that has already been created, click on “View / Add Pads” in the table on the “My groups” page, on the line corresponding to the group in which the document was created. You will find a list of all the Pads sorted by the last edit date of the selected group. You can reverse this order so that the oldest editions are shown first, or reorder the list in alphabetical order using the arrows in the corresponding columns.

For further information follow this link to find the official documentation of the Etherpad Lite application in full.