Package: djangocms-bootstrap4
django CMS Bootstrap 4is a plugin bundle for django CMS providing several
components from the popularBootstrap 4library.NoteThis project is endorsed by thedjango CMS Association.
That means that it is officially accepted by the dCA as being in line with our roadmap vision and development/plugin policy.
Join us onSlack.Contribute to this project and win rewardsBecause this is a an open-source project, we welcome everyone toget involved in the projectandreceive a rewardfor their contribution.
Become part of a fantastic community and help us make django CMS the best CMS in the world.We’ll be delighted to receive your
feedback in the form of issues and pull requests. Before submitting your
pull request, please review ourcontribution guidelines.The project makes use of git pre-commit hooks to maintain code quality. Please follow the
installation steps to getpre-commitsetup in your development environment.We’re grateful to all contributors who have helped create and maintain this package.
Contributors are listed at thecontributorssection.DocumentationSeeREQUIREMENTSin thesetup.pyfile for additional dependencies:Django Filer 1.7 or higherDjango Text CKEditor 3.1 or higherMake suredjango Fileranddjango CMS Text CKEditorare installed and configured appropriately.InstallationFor a manual install:runpip installdjangocms-bootstrap4add the following entries to yourINSTALLED_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',runpython manage.py migrateThe 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 usedjangocms-bootstrap4[static-ace]instead ofdjangocms-bootstrap4in your
requirements or with pip. Make the static files fore the ace code editor available
to your project by addingdjangocms_static_aceto your project’sINSTALLED_APPS.Configurationdjango CMS Bootstrap 4utilisesthe following django CMS plugins:django CMS Link:Linkdjango CMS Picture:Picturedjango CMS Icon:IconIt provides the followingstandardBootstrap 4 components:AlertsBadgeCardCarouselCollapseContent (Blockquote, Code, Figure)Grid (Container, Row, Column)JumbotronLink / ButtonList groupMediaPicture / ImageTabsUtilities (Spacing)django CMS Bootstrap 4does notadd the styles or javascript files to your
frontend, these need to be added at your discretion.SettingsThere 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']

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')),
)Please be aware that this package does not support djangocms-text-ckeditor’sDrag & Drop Imagesso be sure to setTEXT_SAVE_IMAGE_FUNCTION = None.Running TestsYou 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 testTo run the frontend make sure to usenode 10.x.