dpezer/ss-bs

Bootstrap 4 starter theme for SilverStripe > 4.2

dev-dependabot/npm_and_yarn/path-parse-1.0.7 2021-08-12 21:35 UTC

Requires

• composer/installers: *
• dpezer/ss-bs: dev-master
• silverstripe/framework: >=4.2

BSD-3-Clause

• Darjan Pezer

• theme
• bootstrap
• sass
• scss
• silverstripe
• gulp
• bootstrap 4

README

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

Version: 2.3

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

• Bootstrap v4.5.2 (Sass source files)
• jQuery 3.5.1
• Popper.js 1.16.1

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