README.txt in Block Theme 8

== Description ==
BlockTheme allows an admin to define tpl files for standard block templates
and provides a select box on the block configure form so the user can select
a tpl file to use as opposed to having to override the templates by block ID.

== Installation ==

1. Enable the module

2. Go to admin/config/blocktheme and add entries like:
customtemplate|My Custom Template
mysupertemplate|My SuperTemplate
Where the first name is the machine-readable name of your template which may contain only
alphanumerical characters, -, or _ . The second name is the user-friendly name that appears
in the selectionbox on the block edit form.

3. Choose from either step 4. or 5.

4. Create twig files in your theme directory like: (Note: filenames must be preceded by block--blocktheme--)
 block--blocktheme--customtemplate.html.twig
 block--blocktheme--mysupertemplate.html.twig

5. Alternatively use the extra provided variable $blocktheme to customize your
 block.html.twig or block-*.html.twig files. The $blocktheme will typically be
 used as a css class name in you template and contains the machine-readable name of
 your template.

6. In your custom block templates, you can also use values from the
 $blocktheme_vars variable. This array contains custom variables defined in the
 block edit form, right below the block theme selection.

== Usage ==

Go to the edit form for any block and select the appropriate template.