# Управление модулями

Дополнительные модули позволяют расширить возможности функционала основной системы. В данной инструкции вы сможете найти информацию про управление модулями, а так же про установку приложений с помощью встроенного Marketplace.

{% hint style="info" %}
Для использования платных и бесплатных модулей, необходимо зарегистрировать копию MikoPBX и бесплатно получить лицензионный ключ. Инструкцию по тому, как это сделать - вы можете найти [здесь](/mikopbx/manual/modules/licensing.md).
{% endhint %}

Подробные инструкции по настройке и эксплуатации каждого модуля вы можете найти [здесь](/mikopbx/modules/miko.md).

Найти раздел Управления модулями вы можете в **"Модули"** -> **"Маркетплейс модулей".**

<figure><img src="/files/31oQXgU4OrQPYNsHOQWv" alt=""><figcaption><p>Раздел "Маркетплейс модулей"</p></figcaption></figure>

## Установленные модули

В данном разделе происходит основное управление модулями: их подключение, настройка, а так же загрузка своих, "кастомных" модулей. Документацию по разработке своих модулей вы можете найти [здесь](https://docs.mikopbx.com/mikopbx-development).

Все установленные модули находятся в списке, в одноимённой вкладке:

<figure><img src="/files/wt9aQ5iLok1Mmua95amf" alt=""><figcaption><p>Все установленные модули</p></figcaption></figure>

Есть возможность загрузить свой модуль, используя кнопку **"Загрузить новый модуль"**. Необходимо загружать файлы .zip. После загрузки модуль появится в списке на вкладке "**Установленные модули**"

<figure><img src="/files/CH871om2t83D2VcohAN5" alt=""><figcaption><p>Кнопка "Загрузить новый модуль"</p></figcaption></figure>

Так же есть возможность перейти в настройки любого модуля для дальнейшей его конфигурации:

<figure><img src="/files/QDFQZzfbNebaiTLDXNly" alt=""><figcaption><p>Переход в настройки модуля</p></figcaption></figure>

Помимо этого, можно включить/отключить модуль.

<figure><img src="/files/sDszoqLFiUhOL2ZHMGtk" alt=""><figcaption><p>Включение/отключение модуля</p></figcaption></figure>

Из интерфейса установленного модуля можно быстро перейти к его документации, нажав на знак вопроса справа от короткого описания модуля:

<figure><img src="/files/cd6Qqf74cV6O0M6Ln0YP" alt=""><figcaption><p>Быстрый переход к документации по модулю</p></figcaption></figure>

## Быстрый доступ к модулю

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

<figure><img src="/files/lZcO1ngQrFBxJTVLDxTb" alt=""><figcaption><p>Модули в быстром доступе</p></figcaption></figure>

Для того, чтобы это сделать - выполните дальнейшую инструкцию:

1. Перейдите в настройки модуля, который Вы хотите вывести в боковое меню, нажав на элемент редактирования справа от версии модуля:

<figure><img src="/files/NRd1AReYvz6zv7KGMbLy" alt=""><figcaption><p>Переход в настройки модуля</p></figcaption></figure>

2. Нажмите на значок настроек справа от статуса состояния модуля для перехода к настройкам отображения модуля в боковом меню:

<figure><img src="/files/oWH9v5dKFxngdL8izekH" alt=""><figcaption><p>Параметры модуля</p></figcaption></figure>

3. В данном разделе вы можете:

* Переключить отображение модуля в боковом меню - "**Показывать модуль в боковом меню**".
* Выбрать раздел в котором он будет отображаться - в примере выбран раздел "**Модули**".
* Так же можно указать произвольное название модуля.

После завершения настройки - нажмите "**Сохранить**".

<figure><img src="/files/RoT7GMUZ7mdKiiFyxq75" alt=""><figcaption><p>Параметры отображения модуля в боковом меню</p></figcaption></figure>

## Маркетплейс модулей

В данном разделе вы можете установить модули от MIKO, а так же от производителей-партнеров.

<figure><img src="/files/DafFJ0Ix9JMvtgcAHOJM" alt=""><figcaption><p>Раздел "Маркетплейс"</p></figcaption></figure>

Напротив каждого модуля есть кнопка для его скачивания и установки. Так же здесь отображена базовая информация по модулю с коротким описанием каждого модуля.

<figure><img src="/files/Lmetae641QyoYQM0iLpy" alt=""><figcaption><p>Кнопка для установки модуля</p></figcaption></figure>

Слева от названия модуля вы можете найти значок, по которому можно понять платный ли он или бесплатный. Например, на изображении выше модуль "**REST API Автоинформатор**" - платный, а модуль "**Генератор SSL сертификатов через Let's Encrypt**" - бесплатный.

{% hint style="info" %}
У каждого платного модуля есть испытательный период - 2 недели. За этот период вы можете попробовать функционал модуля и принять решение о покупке. Для покупки модуля - напишите на почту <sale@mikopbx.com>
{% endhint %}

## Карточка модуля

Существует возможность перейти в карточку модуля, нажав на его название в интерфейсе маркетплейса.

<figure><img src="/files/fTrOG8IqrnB3okzo4g3p" alt=""><figcaption><p>Карточка модуля</p></figcaption></figure>

Здесь вы можете найти версию актуального релиза, информацию про разработчика, платный ли модуль или бесплатный. Тут же находятся 3 раздела:

#### Описание модуля

Здесь вы можете найти изображения про функционал и настройки модуля. Помимо этого - базовое описание модуля, а так же раздел "**Полезные ссылки**", где располагается ссылка на подробную документацию по настройке и эксплуатации модуля.

#### История версий

<figure><img src="/files/SbsdOkVIJ2KLpePw6uhr" alt=""><figcaption><p>Раздел "История версий"</p></figcaption></figure>

В данном разделе вы можете найти историю версий модуля, с подробным описанием изменений, а также минимально совместимой версии MikoPBX для корректной его работы. Так же вы можете установить конкретную версию модуля, нажав на синий элемент под общим ее описанием.

#### Лицензионное соглашение

Здесь вы можете ознакомиться с пользовательским лицензионным соглашением для каждого модуля расширения.

## Активация купонов

В случае покупки модуля, вам будет выдан купон. Для его активации перейдите в Модули -> Маркетплейс модулей:

<figure><img src="/files/hcl9zKSaukfZqj4ndKfb" alt=""><figcaption><p>Раздел "Модули" -> "Маркетплейс модулей"</p></figcaption></figure>

Далее перейдите в раздел "**Управление лицензией**"

В поле "**Активация купона**" введите ваш купон, далее нажмите "**Активировать купон**"

{% hint style="info" %}
Ключ защиты всегда начинается с MIKO-. Купон для изменения состава продуктов всегда начинается с MIKOUPD-
{% endhint %}

<figure><img src="/files/QhZbsSx4YRObl2PY5W0i" alt=""><figcaption><p>Активация купона</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/manual/modules/pbx-extension-modules.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
