Sulu: Где разместить XML-файл для пользовательского объекта?

Я следую документации по добавлению пользовательских объектов в Sulu:

https://docs.sulu.io/en/2.2/book/extend-admin.html#list-configuration-and-controller

и он описывает, как создать файл XML, который дополнительно описывает мой пользовательский тип объекта, но не упоминается, где разместить этот файл и как его назвать?

<?xml version="1.0" ?>
<list xmlns="http://schemas.sulu.io/list-builder/list">
    <key>events</key>

    <properties>
        <property name="id" visibility="no" translation="sulu_admin.id">
            <field-name>id</field-name>
            <entity-name>App\Entity\Event</entity-name>
        </property>

...

Итак, как назвать и где разместить этот файл XML, пожалуйста?


person MilanG    schedule 10.05.2021    source источник


Ответы (1)


Теоретически вы можете размещать такие файлы где угодно, если вы настроите пути к этим каталогам, чтобы sulu знал, где он может их найти. Но sulu автоматически настраивает config/forms/ как каталог для поиска форм и config/lists/ для списков. Поэтому в большинстве случаев вы должны использовать эти каталоги. Использование других каталогов просто необходимо, если вы хотите создавать формы или списки в пользовательском комплекте.

Что касается именования, рекомендуется называть файл так же, как ключ списка, в вашем случае events.xml

person Luca Rath-Heel    schedule 10.05.2021
comment
Большой. Я также нашел ваш пример здесь: github.com/sulu /sulu-demo/blob/master/config/lists/albums.xml, так что я понял это сам, но в целом было бы полезно иметь такие вещи как часть документации. - person MilanG; 10.05.2021
comment
Спасибо за ваш отзыв! Да, я полностью согласен, есть некоторые части сулу, которые можно было бы лучше задокументировать. Мы знаем это, и мы всегда очень рады рассмотреть запросы на включение от нашего сообщества, чтобы исправить такие вещи ???? - person Luca Rath-Heel; 10.05.2021
comment
Одно из предложений заключается в том, что всякий раз, когда вы предоставляете какой-либо код, вы также должны предоставить правила (или подсказки), как назвать файл и где его разместить. Еще одно предложение — использовать в своих примерах переменные/метки, состоящие как минимум из двух слов. т.е. если ваша переменная - это событие, а моя - новостное событие, я не знаю, назвать ли ее новостным событием, новостным_событием или новостным событием или как-то еще. Возможно, для кого-то это очевидно, но не для всех. - person MilanG; 11.05.2021