Getting Started

Configuration

The module has no global settings, no site settings and no permission rules of its own. Everything is configured per block in the page editor, and anyone who can edit a site page can add and edit the blocks.

What the module registers

Registration Value
Block layouts cardSlider, itemSlider, tabs, tabsGroup, tab
View helper override pageLayout is replaced by BlockSuite\View\Helper\PageLayout
View templates view/common/block-layout/*.phtml (added to the template path stack)

The pageLayout override is what renders Tabs (Blocks) containers. It extends the core helper and keeps everything else unchanged: the page_layout.classes and page_layout.inline_styles events, the grid page layout, and core block groups. If another module also overrides pageLayout and wins, Tabs (Blocks) containers degrade gracefully: the container renders nothing and the blocks inside it render in normal page order, without tabs.

Per-block defaults

The table lists the defaults a block starts with and the range the module enforces on save.

Block Setting Default Allowed
Card Slider, Item Slider Cards visible 3 1 to 6
Card Slider, Item Slider Autoplay off
Card Slider, Item Slider Autoplay interval 4000 ms 1000 ms minimum (the form offers up to 15000 in steps of 500)
Item Slider Selection mode Choose specific items curated or query
Item Slider Max items 12 1 to 50
Item Slider Display properties Title, Description any of the ten listed Dublin Core properties
Item Slider Link to item on
Item Slider Link label View Item
Tabs (HTML) Default tab first tab
Tab Default tab off

Theme overrides

A theme can override any of the public templates by copying it to the same path inside the theme:

themes/<theme>/view/common/block-layout/card-slider.phtml
themes/<theme>/view/common/block-layout/item-slider.phtml
themes/<theme>/view/common/block-layout/tabs.phtml
themes/<theme>/view/common/block-layout/tabs-group.phtml

Keep the class names and ARIA attributes if you want the bundled JavaScript to keep working. See Theming and Markup.

Assets

The public stylesheet asset/css/card-slider-tabs.css and script asset/js/card-slider-tabs.js are appended to the page head only when a page contains at least one BlockSuite block, through each block's prepareRender(). There is no way to disable them from the admin; override the templates or the CSS in your theme instead.

Log in for Support