semente / django-snippets forked from zerok/django-flatblocks
- Source
- Commits
- Network (3)
- Issues (0)
- Downloads (3)
- Graphs
-
Branch:
master
Dynamic template snippets for Django.
| name | age | message | |
|---|---|---|---|
 |
.gitignore | Tue Oct 27 19:05:11 -0700 2009 | |
| |
AUTHORS.txt | Sun Feb 01 20:55:42 -0800 2009 | |
| |
LICENSE.txt | Loading commit data...  |
|
| |
MANIFEST.in | Tue Jan 20 08:25:03 -0800 2009 | |
| |
README.rst | Tue Oct 27 12:50:34 -0700 2009 | |
| |
ez_setup.py | Tue Oct 27 18:34:50 -0700 2009 | |
| |
setup.py | Tue Oct 27 18:57:10 -0700 2009 | |
 |
snippets/ |
django-snippets
django-snippets provides a templatetag acting as an {% include %}, that loads a template and renders it with the current context, but the template content comes from database.
django-snippets is a fork of django-flatblocks, and the main difference is that django-snippets render the content as a Django template.
Usage
Once you've created some instances of the snippets.models.Snippet model, you can load it it using the snippets templatetag-library:
{% load snippets ... %}
...
{% get_comment_list for entry as comment_list %}
{% if comment_list %}
<h2>Comments</h2>
<ol>{% include_snippet "comment_list" %}</ol>
{% endif %}
This way you can include a snippet with the name "comment_list". If you have the name of a snippet in a template variable, leave out the quotes.
comment_list will be rendered as a Django template. This mean that you can use {% for %}, {% if %} and others template tags.
This tag also accepts an optional argument where you can specify the number of seconds, the that snippet should be cached:
{% include_snippet "comment_list" 3600 %}
If you use a snippet that doesn't exist, ``include_snippet`` will insert the value of the SNIPPET_STRING_IF_INVALID setting, which is '' (the empty string) by default.
License
django-snippets is available free software under the New BSD license. See the file LICENSE.txt for more information.
