Django app to manage and display editos
1.5
- Django >= 1.8
<= 1.4.1
- Django >= 1.6 <= 1.8
Using PyPI
pip install django-editos
From source
python setup.py install
Preparing test env
virtualenv ./virtualenv
source virtualenv/bin/activate
pip install django>=1.8
Runing unit tests
python setup.py test
Add geelweb.django.editos
to INSTALLED_APPS
in your settings.
Create the db with python manage.py migrate editos
Load the editos tags in your templates with {% load editos %}
editos.models.Edito
object have the following fields
title
Required. 100 characters or fewer.
link
Required. Url to redirect
button_label
Optional. 20 characters or fewer.
image
Required. Uploaded image.
text_content
Required. 400 characters or fewer.
display_from
Required. A date field to represent the date from which the item is active.
display_until
Required. A date field to represent the date by which the item is active.
active
Optional. Default to True. Define if the item is active.
text_theme
Required. A theme to apply to the item in the template rendering. Can be "light" or "dark". text_theme field use EDITOS_THEMES and EDITOS_DEFAULT_THEME settings.
editos
Render the editos. Example
{% editos path/to/a/template.html %}
The first argument is the path to a template to use to render the editos. If omited the default editos/carousel.html
template is used.
editos/carousel.html
The default template. Render a Bootstrap 3 Carousel
The editos will be assign to the template in the editos
variable. Example
{% for edito in editos %}
{{ edito.title }}
{% endfor %}
EDITOS_THEMES
Default
(
('light', 'Light'),
('dark', 'Dark'),
)
A tuple of (value, label) choices
EDITOS_DEFAULT_THEME
Default: "light"
The default theme to use
EDITOS_HELP_TEXTS
Default: {}
This sets the mapping of help text to model field. Example
EDITOS_HELP_TEXTS = {
'image': '150 x 300px',
}
django-editos is released under MIT License. See LICENSE.txt file for details.