Skip to content

Поправил ссылки #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rigin wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Поправил ссылки #6

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions plugin-registration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@
- [Регистрация файла](#registration-file)
- [Роутинг и инициализация](#routing-initialization)
- [Регистрация компонента](#component-registration)
- [Extending Twig](#extending-twig)
- [Расширение Twig](#extending-twig)
- [Регистрация виджета](#widget-registration)
- [Навигация и ограниченияNavigation and permissions](#navigation-permissions)
- [Настройки Бекэнда](#backend-settings)
- [Миграции и история версий](#migrations-version-history)

Плагины - это основа для расширения функционала CMS. Процесс регистрации плагина позволяет определить функции плагина, такие как [components](components) или менюшки и страницы бек энда. Некоторые примеры того, что можно сделать с помощью плагинов:
Плагины - это основа для расширения функционала CMS. Процесс регистрации плагина позволяет определить функции плагина, такие как [компоненты](./cms-components.md) или менюшки и страницы бек энда. Некоторые примеры того, что можно сделать с помощью плагинов:

- Определить [components](components).
- Определить [компоненты](./cms-components.md).
- Определить ограничения пользователя.
- Добавить в бек энд страницы, менюхи и формы.
- Создать структуру базы данных и внести в нее данные.
Expand All @@ -35,15 +35,15 @@
...
Plugin.php <=== Регистрационный файл плагина

Но не для всех плагинов требуется такая структура. Только те плагины, в которых используется **Plugin.php** нуждаются в такой структуре. Если же Ваш плагин предусматривается только еденичный [component](components), то тогда, структура для такого плагина должна быть гораздо проще, например:
Но не для всех плагинов требуется такая структура. Только те плагины, в которых используется **Plugin.php** нуждаются в такой структуре. Если же Ваш плагин предусматривается только еденичный [компонент](./cms-components.md), то тогда, структура для такого плагина должна быть гораздо проще, например:

plugins/
acme/ <=== Имя автора
blog/ <=== Имя плагина
components/
Plugin.php <=== Регистрационный файл плагина

> **Помните**: если вы являетесь разработчиком плагина для [Marketplace](../help/marketplace), наличие файла [updates/version.yaml](#migrations-version-history) обязательно.
> **Помните**: если вы являетесь разработчиком плагина для [Marketplace](http://octobercms.com/help/site/marketplace), наличие файла [updates/version.yaml](#migrations-version-history) обязательно.

<a name="namespaces" class="anchor" href="#namespaces"></a>
### Символы в имени плагина
Expand Down Expand Up @@ -133,7 +133,7 @@
<a name="component-registration" class="anchor" href="#component-registration"></a>
## Регистрация компонента

[Components](components) должен быть зарегистрирован в [Файле регистрации плагина](#registration-file). Это укажет CMS о компоненте и предоставит **short name** для использования. Пример регистрации компонента:
[Компонент](./cms-components.md) должен быть зарегистрирован в [Файле регистрации плагина](#registration-file). Это укажет CMS о компоненте и предоставит **short name** для использования. Пример регистрации компонента:

public function registerComponents()
{
Expand All @@ -142,7 +142,7 @@
];
}

Этот код регистрирует класс компонента ТуДу с именем алиаса **demoTodo** по умолчанию. Больше информации по созданию компонентов Вы можете найти на страницах [Создание компонентов](components).
Этот код регистрирует класс компонента ТуДу с именем алиаса **demoTodo** по умолчанию. Больше информации по созданию компонентов Вы можете найти на страницах [Создание компонентов](./cms-components.md).

<a name="extending-twig" class="anchor" href="#extending-twig"></a>
## Расширения Twig
Expand Down Expand Up @@ -177,7 +177,7 @@
<a name="widget-registration" class="anchor" href="#widget-registration"></a>
## Регистрация виджета

Плагины могут регистрировать [формы виджетов](../backend/widgets#form-widgets) путем переопределения метода `registerFormWidgets()` в классе регистрации плагина. Этот метод должен возвращать массив, содержащий классы виджетов в ключах, имена виджетов и контекст в значениях. Например:
Плагины могут регистрировать [формы виджетов](./backend-widgets.md#form-widgets) путем переопределения метода `registerFormWidgets()` в классе регистрации плагина. Этот метод должен возвращать массив, содержащий классы виджетов в ключах, имена виджетов и контекст в значениях. Например:

public function registerFormWidgets()
{
Expand All @@ -189,7 +189,7 @@
];
}

Плагины могут регистрировать [отчет виджетов](../backend/widgets#report-widgets) путем переопределения метода `registerReportWidgets()` в классе регистрации плагина. Этот метод должен возвращать массив, содержащий классы виджетов в ключах, а также имя виджета и контекст в значениях. Пример:
Плагины могут регистрировать [отчет виджетов](./backend-widgets.md#report-widgets) путем переопределения метода `registerReportWidgets()` в классе регистрации плагина. Этот метод должен возвращать массив, содержащий классы виджетов в ключах, а также имя виджета и контекст в значениях. Пример:

public function registerReportWidgets()
{
Expand Down Expand Up @@ -241,9 +241,9 @@
];
}

При регистрации навигации в бек энде, можно пользовать строки локализации для значения `ярлыков`. Локализация описана в статье [плагин локализации](localization).
При регистрации навигации в бек энде, можно пользовать строки локализации для значения `ярлыков`. Локализация описана в статье [плагин локализации](./plugin-localization.md).

В следующем примере показано, как зарегистрировать элементы доступа в бек энде. Разрешения определяются с ключом разрешения и описанием. В бек энде для пользователя, который управляет доступом это показано в виде чекбоксов. Контроллеры бек энда могут использовать ограничения, определенные плагином, для ограничения [доступа пользователей](../backend/users) к страницам или функциям.
В следующем примере показано, как зарегистрировать элементы доступа в бек энде. Разрешения определяются с ключом разрешения и описанием. В бек энде для пользователя, который управляет доступом это показано в виде чекбоксов. Контроллеры бек энда могут использовать ограничения, определенные плагином, для ограничения [доступа пользователей](./backend-users.md) к страницам или функциям.

public function registerPermissions()
{
Expand Down Expand Up @@ -272,7 +272,7 @@
];
}

А этот пример покажет Вам как создать линк на настройки модели. Настройки модели это часть настроек API, которая описывается в статье [Настройки и Конфигурация](settings).
А этот пример покажет Вам как создать линк на настройки модели. Настройки модели это часть настроек API, которая описывается в статье [Настройки и Конфигурация](./plugin-settings.md).

public function registerSettings()
{
Expand Down Expand Up @@ -302,7 +302,7 @@
seed_the_database.php <=== Миграционный файл
create_another_table.php <=== Миграционный файл

Файл **version.yaml** названный как *Файл версии плагина*, содержит комментарии к версии и четкий порядок вызова скриптов базы данных. Пожалуйста, прочтите [структура Базы Данных](../database/structure) для ознкомления с информацией по миграционным файлам. Также этот файл необходим если Вы собрались отправить плагин в [Marketplace](../help/marketplace). Пример файла версии плагина:
Файл **version.yaml** названный как *Файл версии плагина*, содержит комментарии к версии и четкий порядок вызова скриптов базы данных. Пожалуйста, прочтите [структура Базы Данных](./database-structure.mde) для ознкомления с информацией по миграционным файлам. Также этот файл необходим если Вы собрались отправить плагин в [Marketplace](http://octobercms.com/help/site/marketplace). Пример файла версии плагина:

1.0.1:
- Первая версия
Expand Down