:scroll: Easily edit arbitrary text snippets on a site without a full-fledged CMS or issuing another site release. Like a mini-CMS for every site.
.. image:: https://api.travis-ci.org/bennylope/django-addendum.svg?branch=master :alt: Build Status :target: http://travis-ci.org/bennylope/django-addendum
.. image:: https://pypip.in/v/django-addendum/badge.svg :alt: Current PyPI release :target: https://crate.io/packages/django-addendum
.. image:: https://pypip.in/d/django-addendum/badge.svg :alt: Download count :target: https://crate.io/packages/django-addendum
Change snippets of copy on your site, on the fly, for any application, and without a full-fledged CMS.
Solving queries like:
Hey, we need to change the greeting on login from "Hi!" to "Sup?"
And:
The footer copy needs to be updated.
And:
The marketing team would really like to be able to change that message on a
monthly basis. I don't care that that's a third-party appliwhoozitz!
This is all simple stuff and it's probably coded right into your templates. Changing it is easy enough, but requires a developer and then a release. Boo!
Just add addendum_tags
to your templates::
{% load addendum_tags %}
{% snippet 'home:greeting' %}Hi!{% endsnippet %} {{ user.first_name }}
<footer>
{% snippet 'home:footer' %}© 2011 by Acme Corp.{% endsnippet %}
</footer>
Now you can edit content for these placeholders from the admin interface. If you don't add anything or you delete text, the site text will always revert to what is in the template.
Use it for small bits of user modifiable text from any template on your site, and for swapping out -lorem ipsum- text when prototyping.
Find some more information in the docs <https://django-addendum.readthedocs.org/en/latest/>
_
Install the package from PyPI::
pip install django-addendum
Add it to your INSTALLED_APPS
tuple::
INSTALLED_APPS += ('addendum')
Contributions are welcome but should follow some basic guidelines to make life easier:
BSD licensed.
To run the tests, clone the repository and install tox.::
pip install tox
Then use the command::
tox
To run the tests against specified (or all) environments.
Otherwise, install the test requirements in requirements.txt
and then run the
py.test
comand. tox
is recommended.