djangocms-bootstrap4 3.0.1

Installation

For a manual install:

• run pip install djangocms-bootstrap4

• add the following entries to your INSTALLED_APPS:

  'djangocms_icon',
  'djangocms_link',
  'djangocms_picture',
  'djangocms_bootstrap4',
  'djangocms_bootstrap4.contrib.bootstrap4_alerts',
  'djangocms_bootstrap4.contrib.bootstrap4_badge',
  'djangocms_bootstrap4.contrib.bootstrap4_card',
  'djangocms_bootstrap4.contrib.bootstrap4_carousel',
  'djangocms_bootstrap4.contrib.bootstrap4_collapse',
  'djangocms_bootstrap4.contrib.bootstrap4_content',
  'djangocms_bootstrap4.contrib.bootstrap4_grid',
  'djangocms_bootstrap4.contrib.bootstrap4_jumbotron',
  'djangocms_bootstrap4.contrib.bootstrap4_link',
  'djangocms_bootstrap4.contrib.bootstrap4_listgroup',
  'djangocms_bootstrap4.contrib.bootstrap4_media',
  'djangocms_bootstrap4.contrib.bootstrap4_picture',
  'djangocms_bootstrap4.contrib.bootstrap4_tabs',
  'djangocms_bootstrap4.contrib.bootstrap4_utilities',

• run python manage.py migrate

The Code plugin uses the ace code editor which is loaded from a CDN by default. If you want the ace code editor to be served from static files, please use djangocms-bootstrap4[static-ace] instead of djangocms-bootstrap4 in your requirements or with pip. Make the static files fore the ace code editor available to your project by adding djangocms_static_ace to your project’s INSTALLED_APPS.

Configuration

django CMS Bootstrap 4 utilises the following django CMS plugins:

• django CMS Link: Link

• django CMS Picture: Picture

• django CMS Icon: Icon

It provides the following standard Bootstrap 4 components:

• Alerts

• Badge

• Card

• Carousel

• Collapse

• Content (Blockquote, Code, Figure)

• Grid (Container, Row, Column)

• Jumbotron

• Link / Button

• List group

• Media

• Picture / Image

• Tabs

• Utilities (Spacing)

django CMS Bootstrap 4 does not add the styles or javascript files to your frontend, these need to be added at your discretion.

DJANGOCMS_BOOTSTRAP4_TAG_CHOICES = ['div', 'section', 'article', 'header', 'footer', 'aside']

DJANGOCMS_BOOTSTRAP4_CAROUSEL_TEMPLATES = (
    ('default', _('Default')),
)

DJANGOCMS_BOOTSTRAP4_GRID_SIZE = 12
DJANGOCMS_BOOTSTRAP4_GRID_CONTAINERS = (
    (_('Default'), (
        ('container', _('Container')),
        ('container-fluid', _('Fluid container')),
    )),
    (_('Custom'), (
        ('container-yours', _('Your container')),
    )),
)
DJANGOCMS_BOOTSTRAP4_GRID_COLUMN_CHOICES = (
    ('col', _('Column')),
    ('w-100', _('Break')),
    ('', _('Empty'))
)

DJANGOCMS_BOOTSTRAP4_USE_ICONS = True

DJANGOCMS_BOOTSTRAP4_TAB_TEMPLATES = (
    ('default', _('Default')),
)

DJANGOCMS_BOOTSTRAP4_SPACER_SIZES = (
    ('0', '* 0'),
    ('1', '* .25'),
    ('2', '* .5'),
    ('3', '* 1'),
    ('4', '* 1.5'),
    ('5', '* 3'),
)

DJANGOCMS_BOOTSTRAP4_CAROUSEL_ASPECT_RATIOS = (
    (16, 9),
)

DJANGOCMS_BOOTSTRAP4_COLOR_STYLE_CHOICES = (
    ('primary', _('Primary')),
    ('secondary', _('Secondary')),
    ('success', _('Success')),
    ('danger', _('Danger')),
    ('warning', _('Warning')),
    ('info', _('Info')),
    ('light', _('Light')),
    ('dark', _('Dark')),
    ('custom', _('Custom')),
)

Running Tests

You can run tests by executing:

virtualenv env
source env/bin/activate
pip install -r tests/requirements/djNN_cmsNN.txt # where NN is an available appropriate version
python setup.py test

To run the frontend make sure to use node 10.x.