A library of reusable blocks for use in GovPress projects.
- Install the package in your theme:
composer require dxw/govpress-blocks
- Use the factory to create the blocks you want to use, and pass them any configuration, e.g.
To create a card block with default config:
To create a card block that renders a custom template:
\Dxw\GovPressBlocks\Factory::create('card');
For dxw projects, the recommended approach is to add this code to your theme's\Dxw\GovPressBlocks\Factory::create('card', [ 'template' => '\the\full\path\to\your\custom\template.php` ]);
app/di.php
, if the theme uses Iguana. - If you want to use the default styles for a block, import them into your main SASS file like so (where the final name in the path is the block type):
@import 'vendor/dxw/govpress-blocks/assets/scss/blocks/card'
The available blocks are documented below.
\Dxw\GovPressBLocks\Factory::create('card', array $config)
Config options:
[
'template' => string $theFullPathToYourCustomCardTemplate
]
Sass:
@import 'vendor/dxw/govpress-blocks/assets/scss/blocks/card'