├── resources
    └── img
    │   └── blocky.png
├── phpstan.neon
├── renovate.json
├── .github
    ├── linters
    │   └── .markdown-lint.yml
    ├── workflows
    │   ├── linter.yml
    │   ├── create-release.yml
    │   └── php-review.yml
    └── ISSUE_TEMPLATE
    │   ├── feature_request.md
    │   └── bug_report.md
├── config
    └── blocks.php
├── phpcs.xml.dist
├── .gitignore
├── src
    ├── exceptions
    │   ├── InvalidBlockException.php
    │   └── BlockTransformerNotFoundException.php
    ├── BlockInterface.php
    ├── variables
    │   └── BlockParserVariable.php
    ├── twig
    │   ├── BlocksTwigExtension.php
    │   ├── nodes
    │   │   ├── BlocksLoopNode.php
    │   │   └── BlocksNode.php
    │   └── tokenparsers
    │   │   └── BlocksTokenParser.php
    ├── Block.php
    ├── Blocky.php
    ├── BlockParser.php
    └── icon.svg
├── LICENSE
├── composer.json
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
└── README.md


/resources/img/blocky.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wrux/blocky/HEAD/resources/img/blocky.png


--------------------------------------------------------------------------------
/phpstan.neon:
--------------------------------------------------------------------------------
1 | parameters:
2 |   paths:
3 |     - src
4 |   bootstrapFiles:
5 |     - vendor/craftcms/cms/bootstrap/console.php
6 | 


--------------------------------------------------------------------------------
/renovate.json:
--------------------------------------------------------------------------------
1 | {
2 |   "$schema": "https://docs.renovatebot.com/renovate-schema.json",
3 |   "extends": [
4 |     "config:base"
5 |   ]
6 | }
7 | 


--------------------------------------------------------------------------------
/.github/linters/.markdown-lint.yml:
--------------------------------------------------------------------------------
1 | # Linter rules doc:
2 | # - https://github.com/DavidAnson/markdownlint
3 | #
4 | 
5 | MD024: false # Changelog contains multiple Added and Changed headings.
6 | 


--------------------------------------------------------------------------------
/config/blocks.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  *  Each block must have a block parser or it cannot be rendered.
 5 |  *
 6 |  * Array key must correspond to the block handle and the value, the
 7 |  * parser namespace.
 8 |  *
 9 |  * Example:
10 |  * ```
11 |  * return [
12 |  *   'heading' => 'app\blocks\HeadingBlock',
13 |  *   'wysiwyg' => 'app\blocks\TextBlock',
14 |  * ];
15 |  * ```
16 |  *
17 |  */
18 | 
19 | return [];
20 | 


--------------------------------------------------------------------------------
/phpcs.xml.dist:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0"?>
 2 | <ruleset name="Blocky">
 3 |   <description>PSR2 with 2 spaces indentation.</description>
 4 |   <arg name="tab-width" value="2"/>
 5 |   <rule ref="PSR2">
 6 |   </rule>
 7 |   <rule ref="Generic.WhiteSpace.ScopeIndent">
 8 |     <properties>
 9 |       <property name="indent" value="2"/>
10 |       <property name="ignoreIndentationTokens" type="array" value="T_COMMENT,T_DOC_COMMENT_OPEN_TAG,T_CASE" />
11 |     </properties>
12 |   </rule>
13 | </ruleset>
14 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # CRAFT ENVIRONMENT
 2 | .env.php
 3 | .env.sh
 4 | .env
 5 | 
 6 | # COMPOSER
 7 | /vendor
 8 | 
 9 | # BUILD FILES
10 | /bower_components/*
11 | /node_modules/*
12 | /build/*
13 | /yarn-error.log
14 | 
15 | # MISC FILES
16 | .cache
17 | .DS_Store
18 | .idea
19 | .project
20 | .settings
21 | *.esproj
22 | *.sublime-workspace
23 | *.sublime-project
24 | *.tmproj
25 | *.tmproject
26 | .vscode/*
27 | !.vscode/settings.json
28 | !.vscode/tasks.json
29 | !.vscode/launch.json
30 | !.vscode/extensions.json
31 | config.codekit3
32 | prepros-6.config
33 | 


--------------------------------------------------------------------------------
/.github/workflows/linter.yml:
--------------------------------------------------------------------------------
 1 | name: Lint Code Base
 2 | 
 3 | on:
 4 |   push:
 5 |     branches-ignore:
 6 |       - 'master'
 7 |       - 'main'
 8 | jobs:
 9 |   build:
10 |     name: Lint Code Base
11 |     runs-on: ubuntu-latest
12 |     steps:
13 |       - name: Checkout Code
14 |         uses: actions/checkout@v3
15 |       - name: Lint Code Base
16 |         uses: docker://github/super-linter:v4.10.1
17 |         env:
18 |           DEFAULT_BRANCH: 'main'
19 |           VALIDATE_ALL_CODEBASE: false
20 |           VALIDATE_ANSIBLE: false
21 |           VALIDATE_MD: true
22 | 


--------------------------------------------------------------------------------
/src/exceptions/InvalidBlockException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace wrux\blocky\exceptions;
 6 | 
 7 | use yii\base\Exception;
 8 | 
 9 | /**
10 |  * Error parsing the block.
11 |  *
12 |  * @package Blocky
13 |  * @since 0.0.1
14 |  */
15 | class InvalidBlockException extends Exception
16 | {
17 |   // Public Methods
18 |   // ===========================================================================
19 | 
20 |   /**
21 |    * @inheritdoc
22 |    */
23 |   public function getName(): string
24 |   {
25 |     return 'Invalid block';
26 |   }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/exceptions/BlockTransformerNotFoundException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace wrux\blocky\exceptions;
 6 | 
 7 | use yii\base\Exception;
 8 | 
 9 | /**
10 |  * Block transformer not found.
11 |  *
12 |  * @package Blocky
13 |  * @since 0.0.1
14 |  */
15 | class BlockTransformerNotFoundException extends Exception
16 | {
17 |   // Public Methods
18 |   // ===========================================================================
19 | 
20 |   /**
21 |    * @inheritdoc
22 |    */
23 |   public function getName(): string
24 |   {
25 |     return 'Block transformer not found';
26 |   }
27 | }
28 | 


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/feature_request.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | name: Feature request
 3 | about: Suggest an idea for this project
 4 | title: ''
 5 | labels: ''
 6 | assignees: ''
 7 | 
 8 | ---
 9 | 
10 | **Is your feature request related to a problem? Please describe.**
11 | A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
12 | 
13 | **Describe the solution you'd like**
14 | A clear and concise description of what you want to happen.
15 | 
16 | **Describe alternatives you've considered**
17 | A clear and concise description of any alternative solutions or features you've considered.
18 | 
19 | **Additional context**
20 | Add any other context or screenshots about the feature request here.
21 | 


--------------------------------------------------------------------------------
/src/BlockInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace wrux\blocky;
 6 | 
 7 | /**
 8 |  * Block interface.
 9 |  *
10 |  * Block Interface defines a common interface to be used for all Block classes.
11 |  *
12 |  * @package Blocky
13 |  * @since 0.0.1
14 |  */
15 | interface BlockInterface
16 | {
17 |   /**
18 |    * Return the block template.
19 |    *
20 |    * @return string
21 |    */
22 |   public function getTemplate(): string;
23 | 
24 |   /**
25 |    * Return the block type handle.
26 |    *
27 |    * @return string
28 |    */
29 |   public function getType(): string;
30 | 
31 |   /**
32 |    * Return the block context.
33 |    *
34 |    * @return array
35 |    */
36 |   public function getContext(): array;
37 | }
38 | 


--------------------------------------------------------------------------------
/src/variables/BlockParserVariable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace wrux\blocky\variables;
 6 | 
 7 | use wrux\blocky\Blocky;
 8 | 
 9 | /**
10 |  * Block Parser Variable.
11 |  *
12 |  * This class is available at `{{ craft.blocky }}` in the template.
13 |  *
14 |  * @package Blocky
15 |  * @since 0.1.0
16 |  */
17 | class BlockParserVariable
18 | {
19 |   // Public Methods
20 |   // =========================================================================
21 | 
22 |   /**
23 |    * Parse the Matrix blocks array.
24 |    *
25 |    * @param mixed $blocks
26 |    *
27 |    * @return mixed
28 |    *   Iterable block object.
29 |    */
30 |   public function parseBlocks($blocks)
31 |   {
32 |     return Blocky::$plugin->parseBlocks($blocks);
33 |   }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/twig/BlocksTwigExtension.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace wrux\blocky\twig;
 6 | 
 7 | use Twig\Extension\AbstractExtension;
 8 | use wrux\blocky\twig\tokenparsers\BlocksTokenParser;
 9 | 
10 | /**
11 |  * Blocky custom Twig functionality.
12 |  *
13 |  * @package Blocky
14 |  * @since 0.1.0
15 |  */
16 | class BlocksTwigExtension extends AbstractExtension
17 | {
18 |   // Public Methods
19 |   // =========================================================================
20 | 
21 |   /**
22 |    * Returns the Blocky token parsers.
23 |    *
24 |    * Implements the twig tag {% blocks in ... %}
25 |    *
26 |    * @return array
27 |    *   Custom Twig tag token parsers.
28 |    */
29 |   public function getTokenParsers(): array
30 |   {
31 |     return [new BlocksTokenParser()];
32 |   }
33 | }
34 | 


--------------------------------------------------------------------------------
/.github/workflows/create-release.yml:
--------------------------------------------------------------------------------
 1 | # Creates a new GitHub Release whenever the Craft Plugin Store
 2 | # is notified of a new version tag.
 3 | 
 4 | name: Create Release
 5 | run-name: Create release for ${{ github.event.client_payload.version }}
 6 | 
 7 | on:
 8 |   repository_dispatch:
 9 |     types:
10 |       - craftcms/new-release
11 | 
12 | jobs:
13 |   build:
14 |     runs-on: ubuntu-latest
15 |     permissions:
16 |       contents: write
17 |     steps:
18 |       - uses: ncipollo/release-action@v1
19 |         with:
20 |           body: ${{ github.event.client_payload.notes }}
21 |           makeLatest: ${{ github.event.client_payload.latest }}
22 |           name: ${{ github.event.client_payload.version }}
23 |           prerelease: ${{ github.event.client_payload.prerelease }}
24 |           tag: ${{ github.event.client_payload.tag }}
25 | 


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/bug_report.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | name: Bug report
 3 | about: Create a report to help us improve
 4 | title: ''
 5 | labels: ''
 6 | assignees: ''
 7 | 
 8 | ---
 9 | 
10 | **Describe the bug**
11 | A clear and concise description of what the bug is.
12 | 
13 | **To Reproduce**
14 | Steps to reproduce the behavior:
15 | 1. Go to '...'
16 | 2. Click on '....'
17 | 3. Scroll down to '....'
18 | 4. See error
19 | 
20 | **Expected behavior**
21 | A clear and concise description of what you expected to happen.
22 | 
23 | **Screenshots**
24 | If applicable, add screenshots to help explain your problem.
25 | 
26 | **Desktop (please complete the following information):**
27 |  - OS: [e.g. iOS]
28 |  - Browser [e.g. chrome, safari]
29 |  - Version [e.g. 22]
30 | 
31 | **Smartphone (please complete the following information):**
32 |  - Device: [e.g. iPhone6]
33 |  - OS: [e.g. iOS8.1]
34 |  - Browser [e.g. stock browser, safari]
35 |  - Version [e.g. 22]
36 | 
37 | **Additional context**
38 | Add any other context about the problem here.
39 | 


--------------------------------------------------------------------------------
/.github/workflows/php-review.yml:
--------------------------------------------------------------------------------
 1 | name: Code Review
 2 | 
 3 | on: pull_request
 4 | 
 5 | jobs:
 6 | 
 7 |   phpcs:
 8 |     name: PHPCS
 9 |     runs-on: ubuntu-latest
10 |     steps:
11 |     - uses: actions/checkout@v3
12 |     - name: PHPCS
13 |       uses: docker://oskarstark/phpcs-ga
14 |       with:
15 |         args: --standard=phpcs.xml.dist src
16 | 
17 |   phpstan:
18 |     name: PHPStan
19 |     runs-on: ubuntu-latest
20 |     steps:
21 |     - uses: actions/checkout@v3
22 | 
23 |     - name: Validate composer.json and composer.lock
24 |       run: composer validate
25 |     - name: Cache Composer packages
26 |       id: composer-cache
27 |       uses: actions/cache@v3
28 |       with:
29 |         path: vendor
30 |         key: ${{ runner.os }}-node-${{ hashFiles('**/composer.lock') }}
31 |         restore-keys: |
32 |           ${{ runner.os }}-node-
33 |     - name: Install dependencies
34 |       if: steps.composer-cache.outputs.cache-hit != 'true'
35 |       run: composer install --prefer-dist --no-progress --no-suggest
36 | 
37 |     - name: Create temporary storage directory
38 |       run: mkdir storage
39 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2025 Callum Bonnyman
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/src/twig/nodes/BlocksLoopNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace wrux\blocky\twig\nodes;
 6 | 
 7 | use Twig\Compiler;
 8 | use Twig\Node\Node;
 9 | 
10 | /**
11 |  * Blocks node iterator.
12 |  *
13 |  * @package Blocky
14 |  * @since 0.1.0
15 |  *
16 |  */
17 | class BlocksLoopNode extends Node
18 | {
19 |   // Public Methods
20 |   // ===========================================================================
21 | 
22 |   /**
23 |    * Instansiate the Node.
24 |    *
25 |    * @param integer $lineno
26 |    * @param string $tag
27 |    */
28 |   public function __construct(int $lineno, string $tag = null)
29 |   {
30 |     parent::__construct([], ['with_loop' => true], $lineno, $tag);
31 |   }
32 | 
33 |   /**
34 |    * Compile the loop node context.
35 |    *
36 |    * @param Compiler $compiler
37 |    */
38 |   public function compile(Compiler $compiler): void
39 |   {
40 |     $compiler
41 |       ->write("++\$context['loop']['index0'];\n")
42 |       ->write("++\$context['loop']['index'];\n")
43 |       ->write("\$context['loop']['first'] = false;\n")
44 |       ->write("if (isset(\$context['loop']['length'])) {\n")
45 |       ->indent()
46 |       ->write("--\$context['loop']['revindex0'];\n")
47 |       ->write("--\$context['loop']['revindex'];\n")
48 |       ->write("\$context['loop']['last'] = 0 === \$context['loop']['revindex0'];\n")
49 |       ->outdent()
50 |       ->write("}\n");
51 |   }
52 | }
53 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "wrux/blocky",
 3 |   "description": "Map a matrix field into an array of blocks to render in twig.",
 4 |   "type": "craft-plugin",
 5 |   "version": "1.1.2",
 6 |   "keywords": ["craft", "cms", "craftcms", "craft-plugin", "block parser"],
 7 |   "support": {
 8 |     "docs": "https://github.com/wrux/blocky/blob/master/README.md",
 9 |     "issues": "https://github.com/wrux/blocky/issues"
10 |   },
11 |   "license": "MIT",
12 |   "authors": [
13 |     {
14 |       "name": "Callum Bonnyman",
15 |       "homepage": "https://bloke.blog"
16 |     }
17 |   ],
18 |   "scripts": {
19 |     "phpstan": "vendor/bin/phpstan analyse ./src --level=5"
20 |   },
21 |   "require": {
22 |     "craftcms/cms": "^4.0.0"
23 |   },
24 |   "autoload": {
25 |     "psr-4": {
26 |       "wrux\\blocky\\": "src/"
27 |     }
28 |   },
29 |   "extra": {
30 |     "name": "Blocky",
31 |     "handle": "blocky",
32 |     "developer": "Callum Bonnyman",
33 |     "developerUrl": "https://bloke.blog",
34 |     "documentationUrl": "https://github.com/wrux/blocky/blob/master/README.md",
35 |     "changelogUrl": "https://raw.githubusercontent.com/wrux/blocky/master/CHANGELOG.md",
36 |     "class": "wrux\\blocky\\Blocky"
37 |   },
38 |   "require-dev": {
39 |     "phpstan/phpstan": "^1.0.0"
40 |   },
41 |   "config": {
42 |     "platform": {
43 |       "php": "8.0.2"
44 |     },
45 |     "allow-plugins": {
46 |       "yiisoft/yii2-composer": true,
47 |       "craftcms/plugin-installer": true
48 |     }
49 |   }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Block.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace wrux\blocky;
 6 | 
 7 | use craft\base\Element;
 8 | 
 9 | /**
10 |  * Abstract block class.
11 |  *
12 |  * The BlockParser expects a class to implement BlockInterface.
13 |  *
14 |  * Any block class that extends this just needs to define the $blockTemplate
15 |  * property and getContext() method.
16 |  *
17 |  * @package Blocky
18 |  * @since 0.0.1
19 |  */
20 | abstract class Block implements BlockInterface
21 | {
22 |   /**
23 |    * Block data.
24 |    *
25 |    * @var \craft\base\Element $block
26 |    */
27 |   protected Element $block;
28 | 
29 |   /**
30 |    * Block template.
31 |    *
32 |    * @var string $blockTtemplate
33 |    */
34 |   protected string $blockTemplate;
35 | 
36 |   /**
37 |    * Instansiate the block.
38 |    *
39 |    * @param \craft\base\Element $block
40 |    */
41 |   public function __construct(Element $block)
42 |   {
43 |     $this->block = $block;
44 |   }
45 | 
46 |   // Public Methods
47 |   // ===========================================================================
48 | 
49 |   /**
50 |    * Returns the Block type handle.
51 |    *
52 |    * @return string
53 |    *   Name of the block as defined in Craft.
54 |    */
55 |   public function getType(): string
56 |   {
57 |     return $this->block->type->handle;
58 |   }
59 | 
60 |   /**
61 |    * Returns the Block template.
62 |    *
63 |    * @return string
64 |    *   Name of the block as defined in Craft.
65 |    */
66 |   public function getTemplate(): string
67 |   {
68 |     return $this->blockTemplate;
69 |   }
70 | }
71 | 


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
 1 | # Blocky Changelog
 2 | 
 3 | All notable changes to this project will be documented in this file.
 4 | 
 5 | The format is based on [Keep a Changelog](http://keepachangelog.com/) and this
 6 | project adheres to [Semantic Versioning](http://semver.org/).
 7 | 
 8 | ## 1.0.1 - 2020-06-22
 9 | 
10 | ## Added
11 | 
12 | - Superlinter with Markdown support
13 | 
14 | ## Updated
15 | 
16 | - Set minimum PHP version to 7.4.0.
17 | 
18 | ## 1.0.0 - 2020-06-16
19 | 
20 | ### Added
21 | 
22 | - Skip empty blocks in the blocks tag using the `skip empty` keyword
23 | - Variables `context`, `template`, `type` are accessible inside the blocks tag
24 | - PHPCS PSR2 rules
25 | - PHPStan rules
26 | - Github actions to test PHPCS and PHPStan
27 | 
28 | ## 0.1.2 - 2020-07-07
29 | 
30 | ### Changed
31 | 
32 | - Fixed `block.template` not accessible in the template because Twig was trying
33 |   to access the protected `block.template` property instead of
34 |   `block.getTemplate()`
35 | - Fixed wrong order in CHANGELOG.md
36 | 
37 | ## 0.1.1 - 2020-07-07
38 | 
39 | ### Changed
40 | 
41 | - Typo in class name `InvalicBlockException`
42 | - The class Blocky is not correctly importing the exception classes
43 | 
44 | ### Removed
45 | 
46 | - Translation files, as these only contained exception translations
47 | - All instances of `Craft::t()` in exceptions
48 | 
49 | ## 0.1.0 - 2020-06-05
50 | 
51 | ### Added
52 | 
53 | - Added `{% blocks %}` Twig tag to simplify templating
54 | 
55 | ### Changed
56 | 
57 | - Moved the main block parser functionality so that it is now available at
58 |   `Blocky::$plugin->parseBlocks()`
59 |   - This is consumed by the new `{% blocks %}` Twig tag and
60 |     `{% craft.blocky.blockparser() %}`
61 | 
62 | ## 0.0.2 - 2020-06-03
63 | 
64 | ### Added
65 | 
66 | - Cleaned up plugin code and fixed some code style issues
67 | 
68 | ## 0.0.1 - 2020-06-03
69 | 
70 | ### Added
71 | 
72 | - Initial release
73 | 


--------------------------------------------------------------------------------
/src/twig/tokenparsers/BlocksTokenParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace wrux\blocky\twig\tokenparsers;
 6 | 
 7 | use Twig\Node\Node;
 8 | use Twig\TokenParser\AbstractTokenParser;
 9 | use Twig\Node\PrintNode;
10 | use Twig\Token;
11 | use wrux\blocky\twig\nodes\BlocksNode;
12 | 
13 | /**
14 |  * Implement the `{% blocks %}` Twig tag.
15 |  *
16 |  * @package Blocky
17 |  * @since 0.1.0
18 |  */
19 | class BlocksTokenParser extends AbstractTokenParser
20 | {
21 |   // Public Methods
22 |   // ===========================================================================
23 | 
24 |   /**
25 |    * Parse the Token.
26 |    *
27 |    * @param \Twig\Token $token
28 |    *
29 |    * @return \wrux\blocky\twig\nodes\BlocksNode
30 |    */
31 |   public function parse(Token $token): BlocksNode
32 |   {
33 |     $lineno = $token->getLine();
34 |     $stream = $this->parser->getStream();
35 |     $stream->expect(Token::OPERATOR_TYPE, 'in');
36 |     $blocks = $this->parser->getExpressionParser()->parseExpression();
37 | 
38 |     $skip_empty = false;
39 |     if ($stream->nextIf(Token::NAME_TYPE, 'skip')) {
40 |       $stream->expect(Token::NAME_TYPE, 'empty');
41 |       $skip_empty = true;
42 |     }
43 | 
44 |     if ($stream->nextIf(Token::BLOCK_END_TYPE)) {
45 |       $body = $this->parser->subparse([$this, 'decideBlocksEnd'], true);
46 |       if ($token = $stream->nextIf(Token::NAME_TYPE)) {
47 |         $value = $token->getValue();
48 |       }
49 |     } else {
50 |       $body = new Node(
51 |           [
52 |             new PrintNode(
53 |                 $this->parser->getExpressionParser()->parseExpression(),
54 |                 $lineno
55 |             ),
56 |           ]
57 |       );
58 |     }
59 |     $stream->expect(Token::BLOCK_END_TYPE);
60 | 
61 |     return new BlocksNode($blocks, $body, $skip_empty, $lineno, $this->getTag());
62 |   }
63 | 
64 |   /**
65 |    * @inheritDoc
66 |    */
67 |   public function getTag(): string
68 |   {
69 |     return 'blocks';
70 |   }
71 | 
72 |   /**
73 |    * Checks for the blocks closing tag.
74 |    *
75 |    * @param \Twig\Token $token
76 |    *  Twig token.
77 |    *
78 |    * @return bool
79 |    *   True if `{% endblocks %}` is found.
80 |    */
81 |   public function decideBlocksEnd(Token $token): bool
82 |   {
83 |     return $token->test('endblocks');
84 |   }
85 | }
86 | 


--------------------------------------------------------------------------------
/src/Blocky.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace wrux\blocky;
  4 | 
  5 | use Craft;
  6 | use craft\base\Element;
  7 | use craft\base\Plugin;
  8 | use craft\elements\db\MatrixBlockQuery;
  9 | use craft\web\twig\variables\CraftVariable;
 10 | use wrux\blocky\twig\BlocksTwigExtension;
 11 | use yii\base\Event;
 12 | use wrux\blocky\BlockParser;
 13 | use wrux\blocky\exceptions\BlockTransformerNotFoundException;
 14 | use wrux\blocky\variables\BlockParserVariable;
 15 | 
 16 | /**
 17 |  * Blocky plugin
 18 |  *
 19 |  * @package Blocky
 20 |  * @since 0.0.1
 21 |  *
 22 |  */
 23 | class Blocky extends Plugin
 24 | {
 25 |   // Static Properties
 26 |   // ===========================================================================
 27 | 
 28 |   /**
 29 |    * Plugin singelton instance.
 30 |    *
 31 |    * @var static \wrux\blocky\Blocky $plugin
 32 |    */
 33 |   public static Blocky $plugin;
 34 | 
 35 |   // Public Methods
 36 |   // ===========================================================================
 37 | 
 38 |   /**
 39 |    * Setup the plugin
 40 |    */
 41 |   public function init()
 42 |   {
 43 |     parent::init();
 44 |     self::$plugin = $this;
 45 | 
 46 |     if (!Craft::$app->request->getIsSiteRequest()) {
 47 |       return;
 48 |     }
 49 | 
 50 |     // Register the blocky variable.
 51 |     Event::on(
 52 |         CraftVariable::class,
 53 |         CraftVariable::EVENT_INIT,
 54 |         function (Event $event) {
 55 |           /** @var CraftVariable $variable */
 56 |           $variable = $event->sender;
 57 |           $variable->set('blocky', BlockParserVariable::class);
 58 |         }
 59 |     );
 60 | 
 61 |     // Add the `blocks` Twig tag.
 62 |     Craft::$app->view->registerTwigExtension(new BlocksTwigExtension());
 63 |   }
 64 | 
 65 |   /**
 66 |    * Parse the Matrix blocks array.
 67 |    *
 68 |    * @param array|MatrixBlockQuery $blocks
 69 |    *
 70 |    * @return mixed
 71 |    *   Iterable block object.
 72 |    */
 73 |   public function parseBlocks($blocks)
 74 |   {
 75 |     // If the matrix block was not eagar loaded then execute the query.
 76 |     if ($blocks instanceof MatrixBlockQuery) {
 77 |       $blocks = $blocks->all();
 78 |     }
 79 |     if (!$blocks || count($blocks) === 0) {
 80 |       return [];
 81 |     }
 82 |     $block_parser = new BlockParser;
 83 |     foreach ($blocks as $block) {
 84 |       if (!$block instanceof Element) {
 85 |         continue;
 86 |       }
 87 |       try {
 88 |         $block_parser->addBlock($block);
 89 |       } catch (BlockTransformerNotFoundException $e) {
 90 |         // Block found, but with no corresponding parser class.
 91 |         Craft::warning(
 92 |             sprintf('Block not found: %s', $e->getMessage()),
 93 |             __METHOD__
 94 |         );
 95 |         continue;
 96 |       } catch (\Exception $e) {
 97 |         Craft::error(
 98 |             sprintf('Block parser error: %s', $e->getMessage()),
 99 |             __METHOD__
100 |         );
101 |         return [];
102 |       }
103 |     }
104 |     return $block_parser;
105 |   }
106 | }
107 | 


--------------------------------------------------------------------------------
/CODE_OF_CONDUCT.md:
--------------------------------------------------------------------------------
 1 | # Contributor Covenant Code of Conduct
 2 | 
 3 | ## Our Pledge
 4 | 
 5 | In the interest of fostering an open and welcoming environment, we as
 6 | contributors and maintainers pledge to making participation in our project and
 7 | our community a harassment-free experience for everyone, regardless of age, body
 8 | size, disability, ethnicity, sex characteristics, gender identity and expression,
 9 | level of experience, education, socio-economic status, nationality, personal
10 | appearance, race, religion, or sexual identity and orientation.
11 | 
12 | ## Our Standards
13 | 
14 | Examples of behavior that contributes to creating a positive environment
15 | include:
16 | 
17 | * Using welcoming and inclusive language
18 | * Being respectful of differing viewpoints and experiences
19 | * Gracefully accepting constructive criticism
20 | * Focusing on what is best for the community
21 | * Showing empathy towards other community members
22 | 
23 | Examples of unacceptable behavior by participants include:
24 | 
25 | * The use of sexualized language or imagery and unwelcome sexual attention or
26 |  advances
27 | * Trolling, insulting/derogatory comments, and personal or political attacks
28 | * Public or private harassment
29 | * Publishing others' private information, such as a physical or electronic
30 |  address, without explicit permission
31 | * Other conduct which could reasonably be considered inappropriate in a
32 |  professional setting
33 | 
34 | ## Our Responsibilities
35 | 
36 | Project maintainers are responsible for clarifying the standards of acceptable
37 | behavior and are expected to take appropriate and fair corrective action in
38 | response to any instances of unacceptable behavior.
39 | 
40 | Project maintainers have the right and responsibility to remove, edit, or
41 | reject comments, commits, code, wiki edits, issues, and other contributions
42 | that are not aligned to this Code of Conduct, or to ban temporarily or
43 | permanently any contributor for other behaviors that they deem inappropriate,
44 | threatening, offensive, or harmful.
45 | 
46 | ## Scope
47 | 
48 | This Code of Conduct applies both within project spaces and in public spaces
49 | when an individual is representing the project or its community. Examples of
50 | representing a project or community include using an official project e-mail
51 | address, posting via an official social media account, or acting as an appointed
52 | representative at an online or offline event. Representation of a project may be
53 | further defined and clarified by project maintainers.
54 | 
55 | ## Enforcement
56 | 
57 | Instances of abusive, harassing, or otherwise unacceptable behavior may be
58 | reported by contacting the project team at callum@banbury.town. All
59 | complaints will be reviewed and investigated and will result in a response that
60 | is deemed necessary and appropriate to the circumstances. The project team is
61 | obligated to maintain confidentiality with regard to the reporter of an incident.
62 | Further details of specific enforcement policies may be posted separately.
63 | 
64 | Project maintainers who do not follow or enforce the Code of Conduct in good
65 | faith may face temporary or permanent repercussions as determined by other
66 | members of the project's leadership.
67 | 
68 | ## Attribution
69 | 
70 | This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
71 | available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
72 | 
73 | [homepage]: https://www.contributor-covenant.org
74 | 
75 | For answers to common questions about this code of conduct, see
76 | https://www.contributor-covenant.org/faq
77 | 


--------------------------------------------------------------------------------
/src/twig/nodes/BlocksNode.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | declare(strict_types=1);
  4 | 
  5 | namespace wrux\blocky\twig\nodes;
  6 | 
  7 | use Twig\Compiler;
  8 | use Twig\Node\Expression\AbstractExpression;
  9 | use Twig\Node\Node;
 10 | 
 11 | /**
 12 |  * Compiles the `{% blocks %}` Twig tag.
 13 |  *
 14 |  * @package Blocky
 15 |  * @since 0.1.0
 16 |  */
 17 | class BlocksNode extends Node
 18 | {
 19 |   // Private Properties
 20 |   // ===========================================================================
 21 | 
 22 |   /**
 23 |    * Loop iteration node.
 24 |    *
 25 |    * @var \wrux\blocky\twig\nodes\BlocksLoopNode
 26 |    */
 27 |   private BlocksLoopNode $loop;
 28 | 
 29 |   // Public Methods
 30 |   // ===========================================================================
 31 | 
 32 |   /**
 33 |    * Instansiate the Node
 34 |    *
 35 |    * @param \Twig\Node\Expression\AbstractExpression $blocks
 36 |    * @param \Twig\Node\Node $body
 37 |    * @param bool $skip_empty
 38 |    * @param integer $lineno
 39 |    * @param string $tag
 40 |    */
 41 |   public function __construct(AbstractExpression $blocks, Node $body, bool $skip_empty, int $lineno, string $tag = null)
 42 |   {
 43 |     $this->loop = new BlocksLoopNode($lineno, $tag);
 44 |     $body = new Node([$body, $this->loop]);
 45 |     $nodes = [
 46 |       'body' => $body,
 47 |       'blocks' => $blocks,
 48 |     ];
 49 |     parent::__construct($nodes, ['skip_empty' => $skip_empty], $lineno, $tag);
 50 |   }
 51 | 
 52 |   /**
 53 |    * Compile the node.
 54 |    *
 55 |    * @param \Twig\Compiler $compiler
 56 |    *   Twig compiler object.
 57 |    */
 58 |   public function compile(Compiler $compiler): void
 59 |   {
 60 |     $compiler
 61 |       ->addDebugInfo($this)
 62 |       ->write("\$context['_parent'] = \$context;\n")
 63 |       ->write("\$context['_blocks'] = twig_ensure_traversable(")
 64 |       ->subcompile($this->getNode('blocks'))
 65 |       ->raw(");\n");
 66 | 
 67 |     $compiler
 68 |       ->write("\$context['parsed_blocks'] = \wrux\blocky\Blocky::\$plugin->parseBlocks(\$context['_blocks']); ");
 69 | 
 70 |     $compiler
 71 |       ->write("\$context['loop'] = [\n")
 72 |       ->write("  'parent' => \$context['_parent'],\n")
 73 |       ->write("  'index0' => 0,\n")
 74 |       ->write("  'index'  => 1,\n")
 75 |       ->write("  'first'  => true,\n")
 76 |       ->write("];\n");
 77 | 
 78 |     $compiler
 79 |       ->write("if (is_array(\$context['_blocks']) || ")
 80 |       ->write("(is_object(\$context['_blocks']) && \$context['_blocks'] ")
 81 |       ->write("instanceof \Countable)) {\n")
 82 |       ->indent()
 83 |       ->write("\$length = count(\$context['_blocks']);\n")
 84 |       ->write("\$context['loop']['revindex0'] = \$length - 1;\n")
 85 |       ->write("\$context['loop']['revindex'] = \$length;\n")
 86 |       ->write("\$context['loop']['length'] = \$length;\n")
 87 |       ->write("\$context['loop']['last'] = 1 === \$length;\n")
 88 |       ->outdent()
 89 |       ->write("}\n");
 90 | 
 91 |     $compiler
 92 |       ->write("foreach (\$context['parsed_blocks'] as \$block) {\n")
 93 |       ->write("\$block_context = \$block->getContext();\n")
 94 |       ->indent();
 95 | 
 96 |     // Skip blocks that return an empty context.
 97 |     if ($this->getAttribute('skip_empty')) {
 98 |       $compiler
 99 |         ->write("if (empty(\$block_context)) {\n")
100 |           ->indent()
101 |           ->write("continue;\n")
102 |           ->outdent()
103 |         ->write("}\n");
104 |     }
105 | 
106 |     $compiler
107 |       ->write("\$context['block'] = \$block;\n")
108 |       ->write("\$context['type'] = \$block->getType();\n")
109 |       ->write("\$context['template'] = \$block->getTemplate();\n")
110 |       ->write("\$context['context'] = \$block_context;\n")
111 |       ->subcompile($this->getNode('body'), false)
112 |       ->outdent()
113 |       ->write("}\n\n");
114 |   }
115 | }
116 | 


--------------------------------------------------------------------------------
/src/BlockParser.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | declare(strict_types=1);
  4 | 
  5 | namespace wrux\blocky;
  6 | 
  7 | use ArrayIterator;
  8 | use IteratorAggregate;
  9 | 
 10 | use Craft;
 11 | use craft\base\Element;
 12 | use wrux\blocky\exceptions\BlockTransformerNotFoundException;
 13 | use wrux\blocky\exceptions\InvalidBlockException;
 14 | 
 15 | /**
 16 |  * Block parser.
 17 |  *
 18 |  * Handles the logic to parse in each of the Matrix blocks and returns a
 19 |  * mapped iterable object.
 20 |  *
 21 |  * @package Blocky
 22 |  * @since 0.0.1
 23 |  */
 24 | class BlockParser implements IteratorAggregate
 25 | {
 26 |   /**
 27 |    * Block config loaded from `app/blocks.php`.
 28 |    *
 29 |    * @var array
 30 |    */
 31 |   private array $config;
 32 | 
 33 |   /**
 34 |    * Instansiated blocks.
 35 |    *
 36 |    * @var array
 37 |    */
 38 |   private array $blocks = [];
 39 | 
 40 |   // Public Methods
 41 |   // ===========================================================================
 42 | 
 43 |   /**
 44 |    * Instansiate the class and get the block config values.
 45 |    */
 46 |   public function __construct()
 47 |   {
 48 |     $this->config = Craft::$app->config->getConfigFromFile('blocks');
 49 |   }
 50 | 
 51 |   /**
 52 |    * Returns the instansiated blocks.
 53 |    *
 54 |    * When looping over the result of `craft.blocks.parseBlocks` this method will
 55 |    * get called and return the blocks.
 56 |    *
 57 |    * In the twig template you can use the following example:
 58 |    * ```
 59 |    * {% for block in blocks %}
 60 |    *   <section class="block {{ 'block--' ~ type }}">
 61 |    *     {% include template ignore missing with context only %}
 62 |    *   </section>
 63 |    * {% endfor %}
 64 |    * ```
 65 |    *
 66 |    * @return ArrayIterator
 67 |    */
 68 |   public function getIterator(): ArrayIterator
 69 |   {
 70 |     return new ArrayIterator($this->blocks);
 71 |   }
 72 | 
 73 |   /**
 74 |    * Adds a block to the parser.
 75 |    *
 76 |    * @param \craft\base\Element $block Matrix block.
 77 |    *
 78 |    * @throws \wrux\blocky\exceptions\BlockTransformerNotFoundException
 79 |    *   If no corresponding block parser class is found.
 80 |    */
 81 |   public function addBlock(Element $block): void
 82 |   {
 83 |     $block_class = $this->getBlockClass($block->type->handle);
 84 |     if (!$block_class || !class_exists($block_class)) {
 85 |       throw new BlockTransformerNotFoundException(
 86 |           sprintf('The block %s could not be found', $block_class)
 87 |       );
 88 |     }
 89 |     $reflect = new \ReflectionClass($block_class);
 90 |     if (!$reflect->implementsInterface(BlockInterface::class)) {
 91 |       throw new InvalidBlockException(
 92 |           sprintf(
 93 |               'The block class %s does not implement BlockInterface',
 94 |               $block_class
 95 |           )
 96 |       );
 97 |     }
 98 |     $this->blocks[] = new $block_class($block);
 99 |   }
100 | 
101 |   /**
102 |    * Returns weather the block parser contains any blocks.
103 |    *
104 |    * @return bool
105 |    */
106 |   public function hasBlocks(): bool
107 |   {
108 |     return count($this->blocks) > 0;
109 |   }
110 | 
111 |   // Private Methods
112 |   // =========================================================================
113 | 
114 |   /**
115 |    * Returns the block class reference from the configuration.
116 |    *
117 |    * @param string $handle The Matrix block handle.
118 |    *
119 |    * @throws \wrux\blocky\exceptions\BlockTransformerNotFoundException
120 |    *   If no corresponding block parser is found in the config
121 |    * @return string
122 |    *   Block class namespace.
123 |    */
124 |   private function getBlockClass(string $handle): string
125 |   {
126 |     if (empty($this->config[$handle])) {
127 |       throw new BlockTransformerNotFoundException(
128 |           sprintf(
129 |               'The block handle %s could not be found in the config',
130 |               $handle
131 |           )
132 |       );
133 |     }
134 |     return $this->config[$handle];
135 |   }
136 | }
137 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | <img alt="Craft Class Variance Authority" src="resources/img/blocky.png" style="height:80px" />
  2 | 
  3 | # Blocky Plugin for Craft CMS 3.x
  4 | 
  5 | Utility plugin for Craft CMS to map Matrix fields.
  6 | 
  7 | Blocky handles the logic of parsing your Matrix blocks so you can create cleaner
  8 | Twig templates.
  9 | 
 10 | ## Requirements
 11 | 
 12 | This plugin requires Craft CMS 3.0.0 or later.
 13 | 
 14 | ## Installation
 15 | 
 16 | To install the plugin, follow these instructions.
 17 | 
 18 | 1. Open your terminal and go to your Craft project:
 19 | 
 20 |    ```bash
 21 |    cd /path/to/project
 22 |    ```
 23 | 
 24 | 2. Then tell Composer to load the plugin:
 25 | 
 26 |    ```bash
 27 |    composer require wrux/blocky
 28 |    ```
 29 | 
 30 | 3. In the Control Panel, go to Settings → Plugins and click the “Install” button
 31 |    for Blocky.
 32 | 
 33 | ## Configuring the Block Parser
 34 | 
 35 | 1. Create `config/blocks.php` inside your Craft project:
 36 | 
 37 |    ```php
 38 |    <?php
 39 | 
 40 |    return [
 41 |      'textBlock' => 'app\blocks\TextBlock',
 42 |    ];
 43 |    ```
 44 | 
 45 | 2. Somewhere in your project, create block classes for each Matrix block which
 46 |    extends `wrux\blocky\Block`
 47 | 
 48 |    Here's an example block:
 49 | 
 50 |    ```php
 51 |    <?php
 52 | 
 53 |    namespace app\blocks;
 54 | 
 55 |    use wrux\blocky\Block;
 56 | 
 57 |    class TextBlock extends Block {
 58 | 
 59 |      public string $template = 'text.twig';
 60 | 
 61 |      public function getContext(): array {
 62 |        return [
 63 |          'text' => !empty($this->block->contentHtml)
 64 |            ? $this->block->contentHtml->getParsedContent()
 65 |            : NULL,
 66 |        ];
 67 |      }
 68 |    }
 69 |    ```
 70 | 
 71 | ## Templating
 72 | 
 73 | Blocky is available at `craft.blocky` in the template or you can also use the
 74 | `{% blocks ... %}` Twig tag.
 75 | 
 76 | ### Twig Tag
 77 | 
 78 | The `{% blocks %}` tag works similarly to a Twig for loop. It expects a Matrix
 79 | field and it will handle the parsing and iteration.
 80 | 
 81 | **Example:**
 82 | 
 83 | ```twig
 84 | {% blocks in entry.blockComponents %}
 85 |   <section class="block {{ 'block--' ~ type }}">
 86 |     {% include template with context only %}
 87 |   </section>
 88 | {% endblocks %}
 89 | ```
 90 | 
 91 | **Example with skipping empty blocks:**
 92 | 
 93 | You can use `skip empty` in the opening tag. This will skip blocks that return
 94 | an empty context.
 95 | 
 96 | ```twig
 97 | {% blocks in entry.blockComponents skip empty %}
 98 |   <section class="block {{ 'block--' ~ type }}">
 99 |     {% include template with context only %}
100 |   </section>
101 | {% endblocks %}
102 | ```
103 | 
104 | ### Variables
105 | 
106 | The following variables are available inside the `{% blocks %}` tag.
107 | 
108 | | Variable       | Value                                                         |
109 | | -------------- | ------------------------------------------------------------- |
110 | | block          | The block object                                              |
111 | | template       | The data returned from the `getTemplate()` method             |
112 | | type           | The value returned from the `getType()` method                |
113 | | context        | The context returned from the `getContext()` method           |
114 | | loop.index     | The current iteration of the loop. (1 indexed)                |
115 | | loop.index0    | The current iteration of the loop. (0 indexed)                |
116 | | loop.revindex  | The number of iterations from the end of the loop (1 indexed) |
117 | | loop.revindex0 | The number of iterations from the end of the loop (0 indexed) |
118 | | loop.first     | True if first iteration                                       |
119 | | loop.last      | True if last iteration                                        |
120 | | loop.length    | The number of items in the sequence                           |
121 | 
122 | ### Manually Parsing Blocks
123 | 
124 | If you don't want to use the Twig tag, blocks can be parsed manually using
125 | `craft.blocky` service. Internally this consumes the same
126 | `Blocky::$plugin->parseBlocks()` method. This method allows you to check
127 | `blocks.hasBlocks` before the for loop.
128 | 
129 | **Example:**
130 | 
131 | ```twig
132 | {% set blocks = craft.blocky.parseBlocks(entry.blockComponents) %}
133 | {% if blocks.hasBlocks %}
134 |   <div class="blocks">
135 |     {% for block in blocks %}
136 |       <section class="block {{ 'block--' ~ block.type }}">
137 |         {% include block.template ignore missing with block.context only %}
138 |       </section>
139 |     {% endfor %}
140 |   </div>
141 | {% endif %}
142 | ```
143 | 
144 | ## Block Parser Roadmap
145 | 
146 | Some things to do, and ideas for potential features:
147 | 
148 | - Testing 🔥
149 | - Nested blocks with the release of CraftCMS 4.0.
150 | 
151 | Brought to you by [Callum Bonnyman](https://bloke.blog)
152 | 


--------------------------------------------------------------------------------
/src/icon.svg:
--------------------------------------------------------------------------------
 1 | <svg width="1024" height="1024" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg">
 2 | <rect width="1024" height="1024" fill="black"/>
 3 | <path d="M773.275 454.599H868.889V533.808H773.275V454.599ZM602.792 454.599H698.406V533.808H602.792V454.599Z" fill="#0047FF"/>
 4 | <path d="M830.77 454.599H868.888V533.808H830.77V454.599ZM660.287 454.599H698.405V533.808H660.287V454.599Z" fill="#5886FB"/>
 5 | <path d="M868.889 320.373H773.275V257.315C773.275 248.394 780.507 241.163 789.428 241.163H852.737C861.658 241.163 868.889 248.394 868.889 257.315V320.373ZM698.406 320.373H602.792V257.315C602.792 248.394 610.023 241.163 618.944 241.163H682.254C691.174 241.163 698.406 248.394 698.406 257.315V320.373ZM527.924 320.373H432.311V257.315C432.311 248.394 439.542 241.163 448.463 241.163H511.772C520.693 241.163 527.924 248.394 527.924 257.315V320.373Z" fill="#00FF1A"/>
 6 | <path d="M852.736 241.163H814.14C823.325 241.163 830.771 248.609 830.771 257.794V320.373H868.889V257.315C868.889 248.396 861.657 241.163 852.736 241.163ZM682.253 241.163H643.657C652.842 241.163 660.288 248.609 660.288 257.794V320.373H698.406V257.315C698.406 248.396 691.174 241.163 682.253 241.163ZM511.772 241.163H473.176C482.36 241.163 489.806 248.609 489.806 257.794V320.373H527.924V257.315C527.924 248.396 520.693 241.163 511.772 241.163Z" fill="#00B112"/>
 7 | <path d="M909.847 469.811H391.351C382.43 469.811 375.198 462.579 375.198 453.658V316.892C375.198 307.971 382.43 300.739 391.351 300.739H909.847C918.768 300.739 926 307.971 926 316.892V453.658C926 462.579 918.768 469.811 909.847 469.811Z" fill="#00FF1A"/>
 8 | <path d="M909.847 687.323H391.351C382.43 687.323 375.198 680.092 375.198 671.171V534.404C375.198 525.483 382.43 518.252 391.351 518.252H909.847C918.768 518.252 926 525.483 926 534.404V671.171C926 680.092 918.768 687.323 909.847 687.323Z" fill="#0047FF"/>
 9 | <path d="M909.847 300.741H878.242V405.424C878.242 414.609 870.796 422.055 861.612 422.055H375.198V453.66C375.198 462.581 382.43 469.812 391.351 469.812H909.847C918.768 469.812 926 462.581 926 453.66V316.893C926 307.972 918.768 300.741 909.847 300.741Z" fill="#00B112"/>
10 | <path d="M909.847 518.252H878.242V622.935C878.242 632.119 870.796 639.565 861.612 639.565H375.198V671.171C375.198 680.092 382.43 687.323 391.351 687.323H909.847C918.768 687.323 926 680.092 926 671.171V534.404C926 525.483 918.768 518.252 909.847 518.252Z" fill="#5886FB"/>
11 | <path d="M633.649 781.837H115.152C106.231 781.837 99 774.606 99 765.685V459.846C99 450.925 106.231 443.694 115.152 443.694H633.649C642.57 443.694 649.801 450.925 649.801 459.846V765.683C649.801 774.604 642.57 781.837 633.649 781.837Z" fill="#FF0000"/>
12 | <path d="M633.171 443.694H602.958V718.363C602.958 727.547 595.513 734.994 586.327 734.994H99V765.206C99 774.391 106.445 781.837 115.63 781.837H633.173C642.357 781.837 649.803 774.391 649.803 765.206V460.325C649.801 451.14 642.357 443.694 633.171 443.694Z" fill="#FF6868"/>
13 | <path d="M211.524 589.8C238.349 589.8 260.096 568.054 260.096 541.228C260.096 514.403 238.349 492.657 211.524 492.657C184.698 492.657 162.952 514.403 162.952 541.228C162.952 568.054 184.698 589.8 211.524 589.8Z" fill="#FF6868"/>
14 | <path d="M211.524 734.523C238.349 734.523 260.096 712.777 260.096 685.952C260.096 659.126 238.349 637.38 211.524 637.38C184.698 637.38 162.952 659.126 162.952 685.952C162.952 712.777 184.698 734.523 211.524 734.523Z" fill="#FF6868"/>
15 | <path d="M374.401 589.8C401.226 589.8 422.973 568.054 422.973 541.228C422.973 514.403 401.226 492.657 374.401 492.657C347.575 492.657 325.829 514.403 325.829 541.228C325.829 568.054 347.575 589.8 374.401 589.8Z" fill="#FF6868"/>
16 | <path d="M374.401 734.523C401.226 734.523 422.973 712.777 422.973 685.952C422.973 659.126 401.226 637.38 374.401 637.38C347.575 637.38 325.829 659.126 325.829 685.952C325.829 712.777 347.575 734.523 374.401 734.523Z" fill="#FF6868"/>
17 | <path d="M537.28 589.8C564.105 589.8 585.851 568.054 585.851 541.228C585.851 514.403 564.105 492.657 537.28 492.657C510.454 492.657 488.708 514.403 488.708 541.228C488.708 568.054 510.454 589.8 537.28 589.8Z" fill="#FF6868"/>
18 | <path d="M537.28 734.523C564.105 734.523 585.851 712.777 585.851 685.952C585.851 659.126 564.105 637.38 537.28 637.38C510.454 637.38 488.708 659.126 488.708 685.952C488.708 712.777 510.454 734.523 537.28 734.523Z" fill="#FF6868"/>
19 | <path d="M230.121 496.352C232.499 502.082 233.817 508.362 233.817 514.95C233.817 541.776 212.071 563.522 185.245 563.522C178.657 563.522 172.377 562.204 166.647 559.826C173.948 577.421 191.288 589.8 211.524 589.8C238.349 589.8 260.095 568.054 260.095 541.228C260.094 520.993 247.716 503.653 230.121 496.352Z" fill="#CE0A0A"/>
20 | <path d="M230.121 641.076C232.499 646.805 233.817 653.085 233.817 659.674C233.817 686.499 212.071 708.245 185.245 708.245C178.657 708.245 172.377 706.927 166.647 704.55C173.948 722.144 191.288 734.524 211.524 734.524C238.349 734.524 260.095 712.778 260.095 685.952C260.094 665.716 247.716 648.377 230.121 641.076Z" fill="#CE0A0A"/>
21 | <path d="M392.998 496.352C395.376 502.082 396.694 508.362 396.694 514.95C396.694 541.776 374.948 563.522 348.122 563.522C341.534 563.522 335.254 562.204 329.524 559.826C336.825 577.421 354.165 589.8 374.4 589.8C401.226 589.8 422.972 568.054 422.972 541.228C422.972 520.993 410.595 503.653 392.998 496.352Z" fill="#CE0A0A"/>
22 | <path d="M392.998 641.076C395.376 646.805 396.694 653.085 396.694 659.674C396.694 686.499 374.948 708.245 348.122 708.245C341.534 708.245 335.254 706.927 329.524 704.55C336.825 722.144 354.165 734.524 374.4 734.524C401.226 734.524 422.972 712.778 422.972 685.952C422.972 665.716 410.595 648.377 392.998 641.076Z" fill="#CE0A0A"/>
23 | <path d="M555.877 496.352C558.255 502.082 559.573 508.362 559.573 514.95C559.573 541.776 537.827 563.522 511.001 563.522C504.413 563.522 498.133 562.204 492.403 559.826C499.704 577.421 517.044 589.8 537.279 589.8C564.105 589.8 585.851 568.054 585.851 541.228C585.849 520.993 573.472 503.653 555.877 496.352Z" fill="#CE0A0A"/>
24 | <path d="M555.877 641.076C558.255 646.805 559.573 653.085 559.573 659.674C559.573 686.499 537.827 708.245 511.001 708.245C504.413 708.245 498.133 706.927 492.403 704.55C499.704 722.144 517.044 734.524 537.279 734.524C564.105 734.524 585.851 712.778 585.851 685.952C585.849 665.716 573.472 648.377 555.877 641.076Z" fill="#CE0A0A"/>
25 | </svg>
26 | 


--------------------------------------------------------------------------------