thehustle/silverstripe-element-container

A SilverStripe module providing container and column blocks.

1.0.0 2024-02-05 09:48 UTC

Requires

• php: ^7.1 || ^8.0
• dnadesign/silverstripe-elemental: ^4 || ^5
• dnadesign/silverstripe-elemental-list: ^2.0@beta
• silverstripe/cms: ^4 || ^5
• silverstripe/framework: ^4 || ^5

Requires (Dev)

• phpunit/phpunit: ^5 || ^9

MIT

• Billy Joel Ranario

README

Install the module via Composer:

composer require thehustle/silverstripe-element-container

This command installs its dependencies as well, including the dnadesign/silverstripe-elemental module and dnadesign/silverstripe-elemental-list module so you don't have to install them separately.

After installation, you will need to run http://yourdomain.com/dev/build or http://yourdomain.com/dev/build?flush=all to create the database tables and flush the cache.

Running Tasks

We need to run a task to copy a modified template from DNADesign's Elemental module to our module. This is to override the default layout of the Container Block and Column Block.

http://yourdomain.com/dev/tasks/TheHustle-Tasks-PublishTemplate

Most importantly, don't forget to run dev/build or dev/build?flush=all after running the task.

Overriding Layouts

To override Container Block and Column Block layouts, you can create a new template file in your app/templates directory.

Make sure to follow the Namespace and Directory structure of the original template file.

mkdir app/templates/TheHustle/Layout/
touch ColumnBlock.ss
touch ContainerBlock.ss

Don't forget to run dev/build or dev/build?flush=all after creating the new template files.

http://yourdomain.com/dev/build

or

http://yourdomain.com/dev/build?flush=all

Styling

After running the tasks, there will be files being copied to your root directory.

/assets/css/layout.css

Move the file to your theme's css directory and include it in your theme's Page.ss file.