Block theme folder structure

[lukecarbis]

This PR adds support for structuring blocks inside directories like so:

• /theme
  • /blocks
    • /block_one
      • preview.php
      • block.php
      • block.css
    • /block_two
      • preview.php
      • block.php
      • block.css

Note that it does not auto-enqueue javascript files, as suggested in the original issue (we should open a separate issue for that, if one doesn't already exist).

Block templates are expected to load in the following order:

1. blocks/{name}/preview.php (if in the editor)
2. blocks/preview-{name}.php (if in the editor)
3. blocks/preview.php (if in the editor)
4. blocks/{name}/block.php
5. blocks/block-{name}.php
6. blocks/block.php

Block styles are expected to load in the following order:

1. blocks/{name}/preview.css (if in the editor)
2. blocks/css/preview-{name}.css (if in the editor)
3. blocks/preview-{name}.css (if in the editor)
4. blocks/{name}/block.css
5. blocks/css/block-{name}.css
6. blocks/preview-{name}.css

Closes #301.

[lukecarbis]

Here's my testing:

Theme folder structure:

In the editor:

On the frontend:

The correct template was loaded.

[kienstra]

Looks Good!

Hi @lukecarbis,
The code looks good, and this works for both the child theme and the parent theme.

Child Theme

Parent Theme

Nice documentation here on the order of the template and stylesheet loading, like:

Block templates are expected to load in the following order:

[lukecarbis]

@RobStino Think you could add those docs to the wiki?

[martinszeltins]

Hi, is this already in production? Because I'm still not able to put my blocks in folders... Version 1.3.5

[lukecarbis]

@martinszeltins Yes! It's in production, and seems to be working well for me. What structure do you have?