Aldryn Bootstrap 3 is a plugin bundle for django CMS providing several components from the popular Bootstrap 3 framework.
This addon is compatible with Divio Cloud and is also available on the django CMS Marketplace for easy installation.
Contributing
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.
One of the easiest contributions you can make is helping to translate this addon on Transifex.
Documentation
See REQUIREMENTS in the setup.py file for additional dependencies:
Python 2.7, 3.3 or higher
Django 1.6 or higher
Django Filer 1.2.4 or higher
Django Text CKEditor 3.1.0 or higher
Make sure django Filer and django CMS Text CKEditor are installed and configured appropriately.
Installation
For a manual install:
run pip install aldryn-bootstrap3
add aldryn_bootstrap3 to your INSTALLED_APPS
run python manage.py migrate aldryn_bootstrap3
Configuration
Aldryn Bootstrap 3 replaces the following django CMS plugins:
django CMS Link: Link and Button
django CMS Picture: Image
django CMS File: File
It provides the following standard Bootstrap 3 components:
It also provides the following 3rd party components:
These components need to be manually configured in order to work properly inside your project. See this gist for additional information on a recommended spacer configuration.
Settings
This addon provides a standard template for Carousels. You can provide additional style choices by adding a ALDRYN_BOOTSTRAP3_CAROUSEL_STYLES setting:
ALDRYN_BOOTSTRAP3_CAROUSEL_STYLES = [
('feature', _('Featured Version')),
]
You’ll need to create the feature folder inside templates/aldryn_bootstrap/plugins/carousel/ otherwise you will get a template does not exist error. You can do this by copying the standard folder inside that directory and renaming it to feature.
In addition you can set or extend your own icon fonts using ALDRYN_BOOTSTRAP3_ICONSETS:
ALDRYN_BOOTSTRAP3_ICONSETS = [
('glyphicons', 'glyphicons', 'Glyphicons'),
('fontawesome', 'fa', 'Font Awesome'),
# custom iconsets have to be JSON
('{"iconClass": "icon", "iconClassFix": "icon-", "icons": [...]}', 'icon', 'Custom Font Icons'),
('{"svg": true, "spritePath": "sprites/icons.svg", "iconClass": "icon", "iconClassFix": "icon-", "icons": [...]}', 'icon', 'Custom SVG Icons'),
]
The default grid size is set to 24 when validating the column input, you can override this by setting:
ALDRYN_BOOTSTRAP3_GRID_SIZE = 12
Running Tests
You can run tests by executing:
virtualenv env source env/bin/activate pip install -r tests/requirements.txt python setup.py test
Release files for aldryn-bootstrap3 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aldryn-bootstrap3-1.3.0.tar.gz | 665.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aldryn_bootstrap3-1.3.0-py2-none-any.whl | Python 2 | none | any | Details |
Total release size: 1.4 MB
Release files / aldryn-bootstrap3-1.3.0.tar.gz
| Download URL | aldryn-bootstrap3-1.3.0.tar.gz |
|---|---|
| Size | 665.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d54a7461d7f1609f03afa6345af39c295843d0fac5ceee43dda0a3be260a5c38
|
|
BLAKE2b-256 checksum How to use checksums |
2c6f992836b6545052b4fd4b02f77868d6b432ba2f48843042c0a484970c85e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / aldryn_bootstrap3-1.3.0-py2-none-any.whl
| Download URL | aldryn_bootstrap3-1.3.0-py2-none-any.whl |
|---|---|
| Size | 723.3 kB |
| Tags | Python 2 |
|
SHA-256 checksum How to use checksums |
bad8b7fe321e3cb216d72189342798c434c3c7b94a1f06338cbb6a3b3f9f4433
|
|
BLAKE2b-256 checksum How to use checksums |
44ec66e729988f1ad8d7a1f60d939fe0e722e44d395ee4bd00c0f6872fa93411
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
