README

Allows you to add global layout update files to be selected from admin, by using 0 instead of a category_id / sku / url_path.

Compatible with Magento 2.3.4 and higher, since cms-page/product/category specific layouts where introduced in this version.

Purpose

In Magento 2.3.4, xml layout updates were removed from the Magento Admin, for security reasons. Previously this textfield allowed you to add XML Layout updates to any given Category, Product or CMS Page. After the update, this textfield is no longer available, but you can select custom layout updates which are defined in xml layout files in the filesystem.

After uploading/deploying selectable layout files onto your project's filesystem, these layouts can be selected from the admin under the Design section. The field is called Custom Layout Update.

Usage:

Replace identifiers in selectable layouts with a 0 (zero). Add layout file to themes/modules using:

catalog_category_view_selectable_0_.xml for Categories
catalog_product_view_selectable_0_.xml for Products
cms_page_view_selectable_0_.xml for Cms pages

These files can go anywhere where you'd normally put layout files. For example: app/design/frontend/[Theme_Vendor]/[Theme_Name]/Magento_Theme/layout/catalog_category_view_0_customchanges.xml

You can now select the layout update at any given Category/Product/Page, under Custom layout update field of Design.

More info on default behaviour of selectable layouts: Magento DevDocs: Create cms-page/product/category-specific layouts

Installation

Install via composer

composer require integer-net/magento2-global-custom-layout

Enable module
```
bin/magento setup:upgrade
```

Configuration

Zero configuration needed.

Change log

Please see CHANGELOG for more information on what has changed recently.

Testing

Magento Integration Tests

Configure test database in dev/tests/integration/etc/install-config-mysql.php. Read more in the Magento docs.
Copy Test/Integration/phpunit.xml.dist from the package to dev/tests/integration/phpunit.xml in your Magento installation.
In that directory, run
```
../../../vendor/bin/phpunit
```

Contributing

Please see CONTRIBUTING for details.

Known issues

Does not work with the homepage (cms_index_index). But hey, it doesn't in the default Magento implementation either.

Security

If you discover any security related issues, please email ww@integer-net.de instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.

integer-net / magento2-global-custom-layout

Maintainers

Details