https://github.com/bennylope/django-addendum

: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.
https://github.com/bennylope/django-addendum

content contenteditable django python snippets

Last synced: about 1 month ago
JSON representation

: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.

• Host: GitHub
• URL: https://github.com/bennylope/django-addendum
• Owner: bennylope
• License: bsd-2-clause
• Created: 2013-03-28T22:15:36.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2020-04-22T18:14:11.000Z (over 4 years ago)
• Last Synced: 2024-11-01T02:22:26.156Z (about 2 months ago)
• Topics: content, contenteditable, django, python, snippets
• Language: Python
• Homepage: https://wellfire.co/learn/snippet-editing-with-django-addendum/
• Size: 248 KB
• Stars: 69
• Watchers: 3
• Forks: 16
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: LICENSE

Awesome Lists containing this project

README

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

Django Addendum

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

.. 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!

Usage

=====

Just add `addendum_tags` to your templates::

    {% load addendum_tags %}

    {% snippet 'home:greeting' %}Hi!{% endsnippet %} {{ user.first_name }}

    

      {% snippet 'home:footer' %}© 2011 by Acme Corp.{% endsnippet %}

    

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 `_

Installation

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

Install the package from PyPI::

    pip install django-addendum

Add it to your `INSTALLED_APPS` tuple::

    INSTALLED_APPS += ('addendum')

Contributing

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

Contributions are welcome but should follow some basic guidelines to make life

easier:

- Pull requests should be made from distinct branches that include only the requested changes branched from the canonical master branch.

- Include tests for bug fixes and new features. Ensure that your Travis build is passing before submitting the pull request.

- Include documentation for any new features.

- For multi-commit updates please squash commits so the packager maintainer only has at most a few commits to review.

- Please limit changes to your specific pull request (excluding extraneous changes and please do not bump the version for your own changes).

License

=======

BSD licensed.

Testing

=======

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.