Пути для полей типа partial

В данной записи хочу показать как указываются пути для полей в форме создания/редактирования модели в системе Winter CMS.

Документация по определению полей формы Defining form fields

Для примера возьмём такую форму:

fields:
    name:
        type: partial
        path: ~/plugins/author/blog/models/post/_name_field.php

    user:
        type: partial
        path: $/author/blog/models/post/_user_field.php

    toolbar:
        type: partial
        path: post_toolbar

Нас интересует свойство path. В первых двух случаях значение начинается с символов ~ и $. Вот что это значит:

• Символ ~ указывает на путь относительно каталога приложения.
• Символ $ указывает на путь относительно каталога плагинов.
• Символ # указывает на путь относительно каталога тем.

Данные символы являются помощниками (хэлперами) путей. В документации об этом сказано вот здесь.

И есть последнее поле toolbar которое мы определили как path: post_toolbar. При такой записи файл с паршилом находится в папке контроллера под именем _post_toolbar.php

А вот так наглядно выглядит данная структура папок и файлов, где расположились файлы паршилов которые мы определили выше:

plugins/
`-- author/
    `-- blog/
        |-- controllers/
        |    |-- posts/
        |    |   `-- _post_toolbar.php
        |    `-- Posts.php
        |-- models/
        |    |-- post/
        |    |   |-- _name_field.php
        |    |   |-- _user_field.php
        |    |   `-- fields.yaml
        |    `-- Post.php
        `-- Plugin.php