Skip to content
Snippets Groups Projects
Commit 1228bd07 authored by Andrey Yurtaev's avatar Andrey Yurtaev
Browse files

by iamdroid: Prepared stable release.

parent aab79b14
No related branches found
Tags 8.x-2.0
No related merge requests found
Material Base v2 development changes
====================================
Not released
------------
14.11.2022 - 2.0
----------------
* Changed template for textarea fields because of accessibility reasons. In case of any issues, see `themes/material_base_mdc/templates/form/form-element--textarea.html.twig` for reverting options.
* Moved subthemes to "themes" folder for proper twig template discovery working.
* #3316638 Fixed password field issues.
* #3316643 Improved support of layout builder.
* #3316641 Changed base theme from "Stable" to "Stable 9" (using own copy made from Drupal code 9.4.8).
* Moved subthemes to `themes` folder for proper Twig template discovery work.
* [#3316638](https://www.drupal.org/project/material_base/issues/3316638) Fixed password field issues.
* [#3316643](https://www.drupal.org/project/material_base/issues/3316643) Improved support of layout builder.
* [#3316641](https://www.drupal.org/project/material_base/issues/3316641) Changed base theme from "Stable" to "Stable 9" (using own copy made from Drupal code 9.4.8).
06.08.2022
----------
06.08.2022 - 2.0-beta5
----------------------
* Updated MDC library from 7.0.0 to 14.0.0.
Important change: MDC list implementation is in transition state to the new implementation and all usage of `mdc-list` (including `mdc-list-item` and `mdc-list-item-*`) should be replaced by `mdc-deprecated-list`.
......@@ -22,7 +22,7 @@ Not released
* Fixed bug with multiple form submit button
* Compatibility with Drupal 10
28.08.2020
----------
28.08.2020 - 2.0-beta1
----------------------
* First beta release.
Material Base v2
================
**Material Base** — is a base theme for Drupal 7, 8, 9 and 10.
**Material Base** — is a base theme for Drupal 9 and 10.
It implements Material Design concept by Google.
Read **[documentation](docs/index.md)** to get started.
......
......@@ -9,7 +9,7 @@ Installing dependencies
For installing build tools and it's dependences you needs to have [Yarn](https://yarnpkg.com/) globally installed. Using Yarn is recommended but NPM also should work.
1. Make sure you have all files copied from `material_base_subtheme` folder to your custom theme folder.
1. Make sure you have all files copied from `themes/material_base_subtheme` folder to your custom theme folder.
2. Optional: adjust values in `webpack.config.js`.
3. From your custom theme folder run:
......
......@@ -34,10 +34,36 @@ It is not recommended to use Material Base theme as a site theme, the best pract
Just enable it and make it default via Appearance settings or Drush, as usual.
Upgrate from v2 beta to stable version
--------------------------------------
Upgrate from 2.x-beta to 2.0 version
------------------------------------
In 2.x beta versions, Material Base used "Stable" as a base theme but in 2.0 it was changed to "Stable 9". The copy of "Stable 9" from Drupal Core 9.4.8 was added to Material Base as "Material Stable 9". Following the new approach of subtheming, Material Base using own copy of the base theme instead of referring to it.
Switching from "Stable" to "Stable 9" shouldn't make big difference but in case of regression issues, it will be the first place to check. Don't forget to run the update script after the update.
In 2.0 child themes were moved to the `themes` folder, to make the template discovery work correctly. If you created a subtheme based on the `material_base_subtheme` template, most likely you will need to update the path for `material_base_mdc/mdc` library files in `YOURTHEME.info.yml`, from `../dist/` to `../../dist/`.
**Before:**
```
libraries-override:
material_base_mdc/mdc:
css:
theme:
../dist/css/mdc.css: false
```
**After:**
```
libraries-override:
material_base_mdc/mdc:
css:
theme:
../../dist/css/mdc.css: false
```
In 2.0 default template for the Textarea field was changed. Alternative version with no floating label used by default due to compatibility with CKEditor. Original MDC implementation still available, see `themes/material_base_mdc/templates/form/form-element--textarea.html.twig` for reverting options.
In v2 beta versions, Material Base used "Stable" as a base theme but in 2.0 it was changed to "Stable 9". The copy of "Stable 9" from Drupal Core 9.4.8 was added to Material Base as "Material Stable 9". Following the new approach of subtheming, we are using our own copy of the base theme instead of referring to it.
Full documentation
------------------
......
......@@ -13,3 +13,11 @@ composer require 'drupal/material_base:^2.0'
For more information see this [page](https://www.drupal.org/docs/develop/using-composer/using-composer-to-install-drupal-and-manage-dependencies).
For other install options see this [page](https://www.drupal.org/docs/extending-drupal/installing-themes).
Recommended patches
-------------------
The patch from [this issue](https://www.drupal.org/node/2752443) is required for proper working of:
* Image/file upload field;
* Layout builder "off canvas" form fields.
......@@ -65,7 +65,7 @@ CSS part of this library intended to be overridden by implementation in your cus
More information about MDC in Material Base [here](mdc.md).
**`THEMENAME/theme`** (library template from `material_base_subtheme` folder)
**`THEMENAME/theme`** (library template from `themes/material_base_subtheme` folder)
Contains scaffolding for main library of your custom theme.
......
......@@ -11,7 +11,7 @@ For more information info about subtheming see this [page](https://www.drupal.or
You could create your subtheme from scratch or use a template included in MB (recommended).
Folder `material_base_subtheme` contains the template for creating your custom theme.
Folder `themes/material_base_subtheme` contains the template for creating your custom theme.
For detailed information about how to create subtheme from template see [Custom subtheme template](subtheme-template.md).
......
......@@ -6,7 +6,7 @@ Subtheme template structure
Subtheme template is placed in `themes/material_base_subtheme` folder.
Subtheme template uses pretty much the same file [structure](folder-structure.md) as a base theme (excluding itself, MDC subtheme, docs, and some other files).
Subtheme template uses pretty much the same file [structure](folder-structure.md) as a base theme (excluding `themes` and `docs` folders, and some other files).
Creating subtheme from template
-------------------------------
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment