Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/django-cms/djangocms-bootstrap4

django CMS Bootstrap 4 is a plugin bundle for django CMS providing several components from the popular Bootstrap 4 framework.
https://github.com/django-cms/djangocms-bootstrap4

addon bootstrap bootstrap4 django django-cms python

Last synced: 5 days ago
JSON representation

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

Host: GitHub
URL: https://github.com/django-cms/djangocms-bootstrap4
Owner: django-cms
License: other
Created: 2017-09-28T06:36:03.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2024-03-02T07:50:49.000Z (9 months ago)
Last Synced: 2024-05-01T11:40:17.545Z (7 months ago)
Topics: addon, bootstrap, bootstrap4, django, django-cms, python
Language: Python
Homepage: https://www.django-cms.org/
Size: 2.13 MB
Stars: 82
Watchers: 18
Forks: 56
Open Issues: 15
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.rst
- License: LICENSE

Awesome Lists containing this project

README

        ======================

django CMS Bootstrap 4

======================

|pypi| |build| |coverage|

**django CMS Bootstrap 4** is a plugin bundle for django CMS providing several

components from the popular `Bootstrap 4 `_ library.

.. note::

        This project is endorsed by the `django 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 on `Slack `_.

.. image:: preview.gif

*******************************************

Contribute to this project and win rewards

*******************************************

Because this is a an open-source project, we welcome everyone to

`get involved in the project `_ and

`receive a reward `_ for 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 our `contribution guidelines

`_.

The project makes use of git pre-commit hooks to maintain code quality. Please follow the

installation steps to get `pre-commit `_ setup in your development environment.

We're grateful to all contributors who have helped create and maintain this package.

Contributors are listed at the `contributors `_

section.

Documentation

=============

See ``REQUIREMENTS`` in the `setup.py `_

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.

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.

Settings

~~~~~~~~

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']

    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'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/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**.

.. |pypi| image:: https://badge.fury.io/py/djangocms-bootstrap4.svg

    :target: http://badge.fury.io/py/djangocms-bootstrap4

.. |build| image:: https://travis-ci.org/divio/djangocms-bootstrap4.svg?branch=master

    :target: https://travis-ci.org/divio/djangocms-bootstrap4

.. |coverage| image:: https://codecov.io/gh/divio/djangocms-bootstrap4/branch/master/graph/badge.svg

    :target: https://codecov.io/gh/divio/djangocms-bootstrap4

.. |python| image:: https://img.shields.io/badge/python-3.5+-blue.svg

    :target: https://pypi.org/project/djangocms-bootstrap4/

.. |django| image:: https://img.shields.io/badge/django-2.2,%203.0,%203.1-blue.svg

    :target: https://www.djangoproject.com/

.. |djangocms| image:: https://img.shields.io/badge/django%20CMS-3.7%2B-blue.svg

    :target: https://www.django-cms.org/