This documentation is for version 2.0 of the framework, which supports Adobe Commerce and Magento Open Source 2.3.x. You can find documentation for version 3.0 here. See find your version if you are unsure about which version you are using.

Merge pages

Sections can be merged into pages to cover your extension.

In this example we add a section that may be relevant to our extension to the list of sections underneath one page.

Starting page

1
2
3
4
5
6
7
8
9
10
11
12
<page name="AdminCategoryPage" url="catalog/category/" area="admin" module="Magento_Catalog">
    <section name="AdminCategorySidebarActionSection"/>
    <section name="AdminCategoryMainActionsSection"/>
    <section name="AdminCategorySidebarTreeSection"/>
    <section name="AdminCategoryBasicFieldSection"/>
    <section name="AdminCategorySEOSection"/>
    <section name="AdminCategoryProductsSection"/>
    <section name="AdminCategoryProductsGridSection"/>
    <section name="AdminCategoryModalSection"/>
    <section name="AdminCategoryMessagesSection"/>
    <section name="AdminCategoryContentSection"/>
</page>

File to merge

1
2
3
4
<page name="AdminCategoryPage" url="catalog/category/" area="admin" module="Magento_Catalog">
    <!-- myExtensionSection will simply be added to the page -->
    <section name="MyExtensionSection"/>
</page>

Resultant page

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<page name="AdminCategoryPage">
    <section name="AdminCategorySidebarActionSection"/>
    <section name="AdminCategoryMainActionsSection"/>
    <section name="AdminCategorySidebarTreeSection"/>
    <section name="AdminCategoryBasicFieldSection"/>
    <section name="AdminCategorySEOSection"/>
    <section name="AdminCategoryProductsSection"/>
    <section name="AdminCategoryProductsGridSection"/>
    <section name="AdminCategoryModalSection"/>
    <section name="AdminCategoryMessagesSection"/>
    <section name="AdminCategoryContentSection"/>
    <!-- New section merged -->
    <section name="MyExtensionSection"/>
</page>