Skip to main content

Adds Bootstrap 4 components as plugins.

Project description

pypi build coverage

django CMS Bootstrap 4 is a plugin bundle for django CMS providing several components from the popular Bootstrap 4 library.

This addon is compatible with Divio Cloud and is also available on the django CMS Marketplace for easy installation.



This is a an open-source project. We’ll be delighted to receive your feedback in the form of issues and pull requests. Before submitting your pull request, please review our contribution guidelines.

We’re grateful to all contributors who have helped create and maintain this package. Contributors are listed at the contributors section.

One of the easiest contributions you can make is helping to translate this addon on Transifex.


See REQUIREMENTS in the file for additional dependencies:

python django djangocms

  • Django Filer 1.7 or higher
  • Django Text CKEditor 3.1 or higher

Make sure django Filer and django CMS Text CKEditor are installed and configured appropriately.


For a manual install:

  • run pip install djangocms-bootstrap4

  • add the following entries to your INSTALLED_APPS:

  • run python migrate


django CMS Bootstrap 4 utilises the following django CMS plugins:

It provides the following standard Bootstrap 4 components:

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


There are various settings possible on django CMS Bootstrap 4, to restrict them for now only the following can be changed:

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

    ('default', _('Default')),

    ('container', _('Container')),
    ('container-fluid', _('Fluid container')),
    ('col', _('Column')),
    ('w-100', _('Break')),
    ('', _('Empty'))


    ('default', _('Default')),

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

    (16, 9),

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

Please be aware that this package does not support djangocms-text-ckeditor’s Drag & Drop Images so be sure to set TEXT_SAVE_IMAGE_FUNCTION = None.

Running Tests

You can run tests by executing:

virtualenv env
source env/bin/activate
pip install -r tests/requirements.txt
python test

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

djangocms-bootstrap4-2.0.0.tar.gz (117.1 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page