部分

<section>-Tag參照到系統組態中的現有或新區段。

區段屬性參考

<section> — 標籤可以有下列屬性:

屬性說明型別必填
id定義參考區段所使用的識別碼。typeId必填
translate定義應可翻譯的欄位。 提供label讓標籤可翻譯。string可選
type定義轉譯HTML元素的輸入型別。 預設為textstring可選
sortOrder定義區段的排序順序。 高數字會將區段推送至頁面底部;低數字會將區段推送至頁面頂部。float可選
showInDefault定義區段是否顯示在預設設定範圍中。 指定1以顯示區段,指定0隱藏區段。int可選
showInStore定義區段是否顯示在存放區層級。 指定1以顯示區段,指定0隱藏區段。int可選
showInWebsite定義區段是否會顯示在網站層級。 指定1以顯示區段,指定0隱藏區段。int可選
canRestore定義區段是否可還原成預設值。int可選
advanced自100.0.2起已棄用。bool可選
extends透過提供另一個區段的識別碼,此節點的內容將擴充您參考的區段。string可選

區段節點參考

<section> — 標籤可以有下列子系:

節點說明型別
label定義顯示在前端中的標籤。string
class將定義的CSS類別新增至演算後的區段HTML元素。string
tab參考關聯的索引標籤。 必須是索引標籤的ID。typeTabId
header_css撰寫本文時既未使用也未評估。string
resource參考ACL資源以提供此區段的許可權設定。typeAclResourceId
group定義一或多個子群組。typeGroup
frontend_model指定不同的前端模型來變更彩現並修改輸出。typeModel
include用於包含其他system_include.xsd個相容的檔案。 通常用於建構大型system.xml檔案。includeType

範例:建立區段並將其指派給標籤

下列程式碼片段示範建立新區段的基本用法。

<?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="A_UNIQUE_ID" translate="label" class="a-custom-css-class-to-style-this-tab" sortOrder="10">
            <label>A meaningful label</label>
        </tab>

        <section id="A_UNIQUE_SECTION_ID" showInDefault="1" showInWebsite="0" showInStore="1" sortOrder="10" translate="label">
            <label>A meaningful section label</label>
            <tab>A_UNIQUE_ID</tab>
            <resource>VENDOR_MODULE::path_to_the_acl_resource</resource>
        </section>
    </system>
</config>

上述章節定義識別碼A_UNIQUE_SECTION_ID,在預設設定檢視和存放區內容中可見。 label節點是可翻譯的。 區段與ID為A_UNIQUE_ID的索引標籤相關聯。 只有在ACL VENDOR_MODULE::path_to_the_acl_resource中定義許可權的使用者才能存取區段。

群組

<group> — 標籤用於將欄位分組在一起。

群組屬性參考

<group> — 標籤可以有下列屬性:

屬性說明型別必填
id定義用於參考群組的識別碼。typeId必填
translate定義應可翻譯的欄位。 提供label讓標籤可翻譯。 多個欄位應以空格分隔。string可選
type定義轉譯HTML元素的輸入型別。 預設為textstring可選
sortOrder定義區段的排序順序。 高數字會將區段推送至頁面底部;低數字會將區段推送至頁面頂部。float可選
showInDefault定義群組是否顯示在預設設定範圍中。 指定1以顯示群組,指定0隱藏群組。int可選
showInStore定義群組是否顯示在存放區層級。 指定1以顯示群組,指定0隱藏群組。int可選
showInWebsite定義群組是否顯示在網站層級。 指定1以顯示群組,指定0隱藏群組。int可選
canRestore定義群組是否可還原成預設值。int可選
advanced自100.0.2起已棄用。bool可選
extends藉由提供另一個群組的識別碼,此節點的內容將會擴充您參考的區段。string可選

群組節點參考

<group> — 標籤可以有下列子系:

節點說明型別
label定義顯示在前端中的標籤。string
fieldset_css將一或多個CSS類別新增至群組欄位集。string
frontend_model指定不同的前端模型來變更彩現並修改輸出。typeModel
clone_model指定指定模型以複製欄位。typeModel
clone_fields啟用或停用欄位複製。int
help_url無法擴充。 請參閱下文。typeUrl
more_url無法擴充。 請參閱下文。typeUrl
demo_link無法擴充。 請參閱下文。typeUrl
comment在群組標籤下方新增註解。 使用<![CDATA[//]]>可套用HTML。string
hide_in_single_store_mode群組是否應該在單一存放區模式中可見。 1隱藏群組;0顯示群組。int
field定義此群組下應可使用的一或多個欄位。field
group定義一或多個子群組。unbounded
depends可用於宣告對其他欄位的相依性。 只有在指定欄位的值為1時,才會用來顯示特定欄位/群組。 此節點需要section/group/field字串。depends
attribute前端模型可使用自訂屬性。 通常用於讓指定的前端模型更動態。attribute
include用於包含其他system_include.xsd個相容的檔案。 通常用於建構大型system.xml檔案。includeType
警告
節點more_urldemo_urlhelp_url是由只使用一次的PayPal前端模型所定義。 這些節點無法重複使用。

範例:為指定區段建立群組

下列程式碼片段示範建立新群組的基本用法。

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
    <system>
        <tab id="A_UNIQUE_ID" translate="label" class="a-custom-css-class-to-style-this-tab" sortOrder="10">
            <label>A meaningful label</label>
        </tab>

        <section id="A_UNIQUE_SECTION_ID" showInDefault="1" showInWebsite="0" showInStore="1" sortOrder="10" translate="label">
            <label>A meaningful section label</label>
            <tab>A_UNIQUE_ID</tab>
            <resource>VENDOR_MODULE::path_to_the_acl_resource</resource>

            <group id="A_UNIQUE_GROUP_ID" translate="label comment" sortOrder="10" showInDefault="1" showInWebsite="0" showInStore="1">
                <label>A meaningful group label</label>
                <comment>An additional comment helping users to understand the effect when configuring the fields defined in this group.</comment>
                <!-- Add your fields here. -->
            </group>
        </section>
    </system>
</config>

上述群組定義識別碼A_UNIQUE_GROUP_ID,可在預設設定檢視和存放區內容中看到。 labelcomment都標示為可翻譯。