.. only:: html

.. _capi-templates:

Шаблоны расширяемых Python-модулей
=========================================


Для расширения возможностей  приложения используются
четыре Python-модуля:
    
* :ref:`event <capi-event>` -- обработка событий;
* :ref:`menu <capi-menu>` -- добавление пользовательских меню;
* :ref:`logon <capi-logon-off>` -- вход в Cerebro;
* :ref:`logoff <capi-logon-off>` -- завершение сеанса в Cerebro.

Шаблоны этих модулей находятся в папке :ref:`py-frontend <capi-paths>`
и называются соответственно:
    
* action.py.template
* event.py.template
* logon.py.template
* logoff.py.template

Для того, чтобы использовать то или иное расширение, нужно
переименовать  файл в {name}.py. 
Например::
    
    action.py.template -> action.py

Шаблоны модулей содержат функции, которые вызываются
из приложения в определенный момент.
В телах этих функций и пишется код, который будет исполняться
при вызове этих функций из приложения.

Например, в шаблоне action.py.template есть функция def :py:func:`action.init_actions`.
Для добавления пользовательского меню, вам нужно:
    
#. Переименовать  action.py.template в action.py
#. Подключить пользовательские модули, если это необходимо
#. В теле функции init_actions написать требуемый код
    
action.py::
    
    import examples # Import examples package
	 
    def init_actions():
        # Call function to adding user-defined menus
        examples.action.main()