Перейти к содержанию

etherpad-logo.png Etherpad

Установка плагинов

Для установки плагинов или изменения конфигурации воспользуйтесь панелью адмнистратора /admin.

Полный перечень доступных плагинов можно найти здесь.

Администратор

Первый вошедший в Etherpad пользователь будет считаться администратором. Дополнительные пользователи с правами администратора могут быть добавлены в раздел ep_cloudron.admins файла /app/data/settings.json при помощи Файлового менеджера.

 "ep_cloudron": {
    "admins": [
      "username1",
      "username2"
    ]
  }

После изменения настроек в файле /app/data/settings.json приложение должно быть перезапущено. Пользователю с изменённой ролью, в свою очередь, необходимо перезайти в приложение.

Прочие настройки

Используйте Терминал для редактирования файла /app/data/settings.json.

После изменения настроек в файле /app/data/settings.json приложение должно быть перезапущено.

Сделать документы общедоступными

По умолчанию Etherpad всегда требует авторизацию пользователя для просмотра и редактирования документа. Чтобы открыть доступ сторонним пользователям, добавьте следующую строку в /app/data/settings.json при помощи Файлового менеджера:

"requireAuthentication": false,

Кастомизирование CSS

CCS и Javascript могут настраиваться через редактирование файлов в /app/data/custom/. Для подробной информации, обратитесь к документации Etherpad.

Тёмная тема

Etherpad по умолчанию поставляется с темой colibris. Данная тема поддерживает тёмную тему через skinVariants. Для активации тёмного режима отредактируйте app/data/settings.json:

"skinVariants": "super-dark-toolbar super-dark-editor dark-background",

API Access

Получить доступ к Etherpad API можно при помощи APIKEY. Для получения ключа воспользуйтесь Терминалом и откройте файл /app/data/APIKEY.txt.

curl https://etherpad.domain/api/1.2.7/listAllPads?apikey=c5513793f24a6fbba161e4497b26c734ff5b2701fad0f1211097ccb405ea65c7

Решение проблем

Если Etherpad не хочет запускаться (особенно после обновления), обычно проблема кроется к несовместимых плагинах. Для исправления возникших ошибок, включите режим восстановления и откройте Терминал. После чего получите список установленных плагинов через команду:

npm ls 2> /dev/null | grep ep_

Два обязательных плагина ep_cloudron и ep_etherpad-lite не могут вызвать ошибок, в свою очередь остальные плагины вполне могут вызывать ошибки несовместимости. Вы можете удалять ненужные плагины один за другим при помощи команды:

npm rm <pluginname>

Чтобы убедиться, что приложение работает, запустите /app/pkg/start.sh. Если Etherpad успешно запустился, отключите режим восстановления и продолжайте пользоваться приложением. Если этого не произошло, продолжайте удаление плагинов.

Плагины, которые не вызывают проблем могут быть установлены повторно через команду:

npm i <pluginname>