silverstripe/elemental-blocks

A collection of CMS blocks for the silverstripe-elemental module

Installs: 8 649

Dependents: 3

Suggesters: 1

Stars: 3

Watchers: 12

Forks: 6

Open Issues: 0

Type:silverstripe-vendormodule

1.0.0 2018-04-05 23:20 UTC

README

Build Status Scrutinizer Code Quality codecov SilverStripe supported module

This repository contains a base set of CMS content blocks for the silverstripe-elemental module.

Warning: deprecated!

For SilverStripe 4.2 or newer, please use one or both of the following modules instead:

This module will only be accepting patch fixes to the 1.0 branch from now on.

Installation

Install using Composer:

composer require silverstripe/elemental-blocks 1.0.x-dev

Once complete, run dev/build from your browser, or command line via vendor/bin/sake dev/build.

Requirements

  • SilverStripe CMS ^4.0
  • Elemental ^2.0

Documentation

An in-depth overview of using the blocks in this module will be added shortly.

Customising templates

The blocks in this module follow the BEM (Block Element Modifier) CSS class naming system, and should provide a WCAG 2.0 compliant template markup for your project's accessibility standard.

If you do need to modify the templates, copy the appropriate template into mysite/templates or your custom theme, and adjust as necessary. If doing so, ensure that you match the folder structure (PHP class namespace) to ensure that your customised template is given priority over the defaults.

For more information see templates in the developer documentation.

Translations

The translations for this project are managed via Transifex and are updated automatically during the release process. To contribute, please head to the link above and get translating!

Versioning

This library follows Semver. According to Semver, you will be able to upgrade to any minor or patch version of this library without any breaking changes to the public API. Semver also requires that we clearly define the public API for this library.

All methods, with public visibility, are part of the public API. All other methods are not part of the public API. Where possible, we'll try to keep protected methods backwards-compatible in minor/patch versions, but if you're overriding methods then please test your work before upgrading.

Reporting Issues

Please create an issue for any bugs you've found.