dpezer/ss-bs

Bootstrap 4 starter theme for SilverStripe > 4.2

Maintainers

Details

github.com/dpezer/ss-bs

Source

Issues

Installs: 439

Dependents: 1

Suggesters: 0

Security: 0

Stars: 1

Watchers: 1

Forks: 0

Language:JavaScript

Type:silverstripe-theme


README

This is Bootstrap 4 starter theme for SilverStripe built by Darjan Pezer.
Version: 2.3

Bootstrap 4.5.2 theme for SilverStripe 4

Requirements

  • SilverStripe 4.x or above (both framework and cms)
  • Node and NPM (Node is used for dev tasks such as compiling sass, bundling and minifying js, etc. Npm is used for package management for node components.)
  • Gulp (install gulp with command npm install -g gulp)

Theme includes

Installation Instructions

  • Install with composer composer require dpezer/ss-bs or ...

  • ... copy the theme into the themes/ directory of your SilverStripe project. If you've named it correctly, there should be a directory called themes/ss-bs/templates.

  • Add the following to your app/_config/theme.yml file.

    ---
    Name: mytheme
    ---
    SilverStripe\View\SSViewer:
      themes:
        - '$public'
        - 'ss-bs'
        - '$default'
  • Add the following to your app/src/PageController.php file inside init() function:

    Requirements::combine_files(
      'scripts.combined.js',
      [
        'themes/ss-bs/javascript/jquery/jquery-3.5.1.js',
        'themes/ss-bs/javascript/popper/popper.js',
        'themes/ss-bs/javascript/bootstrap/bootstrap.js'
      ]
    );
  • Run composer vendor-expose to expose theme folder if needed.

Compiling CSS

  • Install all required npm plugins with npm install command
  • Run command gulp folder
  • Put your CSS/SCSS files into themes/ss-bs/app/scss and import them in themes/ss-bs/app/scss/style.scss