Щоб знайти сторінку конфігурації Magento 2, перейдіть до Панель адміністратора Magento 2 > Магазини > Конфігурація.

Налаштування Magento 2

Усі вкладки та форми на цій сторінці налаштовано за допомогою цього файлу

etc/adminhtml/system.xml

, який містить більшість Basic модулі в Magento .

Додайте наступний код до файлу system.xml у вашому модулі, щоб створити власний розділ:

<?xml version="1.0"?>

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
     <system>
         <tab id="tab_id" translate="label" sortOrder="110">
             <label>My Tab</label>
         </tab>
         <section id="section_id" translate="label" type="text" sortOrder="1" showInDefault="1" showInWebsite="1" showInStore="1">
             <class>separator-top</class>
             <label>My Section</label>
             <tab>tab_id</tab>
             <resource>VendorName_ModuleName::acl_path</resource>
             <group id="group_id" translate="label" type="text" sortOrder="10" showInDefault="1" showInWebsite="1" showInStore="1">
                 <label>My Group</label>
                 <attribute type="expanded">1</attribute>
                 <field id="field_id" translate="label comment" type="select" sortOrder="10" showInDefault="1" showInWebsite="1" showInStore="1">
                     <label>My YesNo Field</label>
                     <source_model>Magento\Config\Model\Config\Source\Yesno</source_model>
                 </field>
             </group>
             <group id="group_id2" translate="label" type="text" sortOrder="20" showInDefault="1" showInWebsite="1" showInStore="1">
                 <label>My Group2</label>
                 <attribute type="expanded">1</attribute>
                 <field id="field_id" translate="label comment" type="select" sortOrder="10" showInDefault="1" showInWebsite="1" showInStore="1">
                     <label>My YesNo Field</label>
                     <source_model>Magento\Config\Model\Config\Source\Yesno</source_model>
                 </field>
             </group>
        </section>
     </system>
</config>

Очистіть кеш конфігурації Magento 2 (через Система > Керування кешем). Оновіть сторінку конфігурації. Ви побачите нову вкладку:

Кастомна секція в налаштуваннях Magento 2

Використовуйте елемент XML під час створення нової вкладки. Примітка: tab_id має бути унікальним.

  • використовується для розмежування прав доступу до цього розділу. Ви можете дізнатися більше про них у ця стаття .
  • 1 вказує на те, що розгорнуто групу за замовчуванням.
  • визначає модель, яка відповідає за дані в полі. Модель джерела, зокрема, використовується для розкривних списків.
  • showInStore вказує, чи можна редагувати елемент на рівні перегляду магазину, showInWebsite - на рівні веб-сайту, showInDefault - на глобальному рівні. Ви можете перемикати рівні конфігурації за допомогою розкривного списку «Вигляд магазину» у верхньому лівому куті, під заголовком сторінки.
  • type вказує тип елемента, sortOrder - позиція, translate вказує, які властивості можна перекласти іншими мовами. Ми рекомендуємо використовувати sortOrder з кроком 10 у ваших модулях.

Розширення існуючих розділів

За допомогою файлу sytem.xml ви можете не лише створювати нові розділи, але й розширювати існуючі. Все, що вам потрібно зробити, це відтворити структуру розділів та груп без використання атрибутів чи міток та додати до них нові поля.

Під час створення сторінки конфігурації Magento 2 збирає файли system.xml з усіх модулів та об'єднує їх.

У прикладах ми створюємо модуль для часто задаваних питань (FAQ). Змінений код модуля можна переглянути на GitHub.

Читайте більше, щоб дізнатися, як налаштувати значення за замовчуванням для поля сторінки конфігурації Magento 2.