Как установить плагин для Mibew Messenger 2.0

Процесс установки плагина очень прост и состоит из четырёх шагов.

Шаг 1. Скачайте архив с плагином.

Если мы говорим об официально одобренном плагине, то нужно зайти на соответствующую страницу официального сайта и скачать последний доступный пакет. Не забудьте проверить целостность скаченного архива используя контрольную сумму sha256.

Например (в случае с плагином Mibew:Emoji v.1.0.0 ):

$ wget --content-disposition -q https://sourceforge.net/projects/mibew/files/plugins/emoji-plugin/1.0.0/emoji-plugin-1.0.0.zip/download
$ sha256sum emoji-plugin-1.0.0.zip
e189f535230d1909c2af73f9b0ba8e63a5dc8f96e8a95c33d615ed05e321b518  emoji-plugin-1.0.0.zip

Если мы говорим о каком-то неофициальном стороннем плагине, то, честно, мы понятия не имеем, где Вам его достать. 🙂

Шаг 2. Распакуйте архив с плагином.

Поместите архив в директорию plugins/ в корневой директории Mibew Messenger и распакуйте его.

$ mv emoji-plugin-1.0.0.zip mibew_root_directory/plugins/
$ cd mibew_root_directory/plugins/
$ unzip -q emoji-plugin-1.0.0.zip
$ rm -f emoji-plugin-1.0.0.zip

Шаг 3. Настройте плагин.

Конфигурация плагина должна быть размещена в соответствующей секции основной конфигурации системы (т.е. в файле mibew_root_directory/configs/config.yml).

Например, это актуальная секция плагинов в конфигурации официальной демо-установки Mibew Messenger (можно заметить конфигурацию других плагинов):

plugins:
    "Mibew:Emoji":
        ignore_emoticons: false
    "Mibew:GeoIp":
        database_path: "/opt/GeoIP/GeoLite2-City.mmdb"
    "Mibew:GoogleMaps":
        api_key: "Google_Maps_Javascript_v3_API_key"
    "Mibew:TitleNotification":
        new_thread: true
        new_message: "both"

Шаг 4. Включите и установите плагин.

Перейдите на страницу плагинов в административном интерфейсе (т.е. http://your_domain/your_mibew_path/operator/plugin) и найдите плагин в списке доступных плагинов.

Кликните по ссылке enable.

Всё, плагин установлен. 🙂

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

Если что-то пошло не так, не волнуйтесь.

Прежде всего, проверьте Ваш лог ошибок. Там должны быть какие-то подсказки.

Если Вы наблюдаете «Белый экран смерти», тогда, скорее всего, Вы нарушили свою системную конфигурацию.

Если плагин просто не работает и в логе ошибок ничего нет, убедитесь, что плагин правильно настроен. Также обратите внимание, что у некоторых плагинов присутствуют некоторые сторонние зависимости.

Дополнительные замечания по официально одобренным плагинам.

Каждый архив с плагином содержит инструкцию по его установке (обычно в файле README.txt или README.md).

Если ничего не помогает, можно связаться с автором плагина или (предпочтительно!) сообщить об ошибке в багтрекере соответствующего репозитория (см. подробную информацию о плагине в списке официально одобренных плагинов).