Skip to main content

Want to optionally use a template tag library? Use this!

Project description

Use templatetag libraries in Django templates to optionally support features.

This app provides three template tags {% friendly_load %}, {% if_has_tag %} and {% ifnot_has_tag %}.

Used together you can built templates that have optional support for certain template tags. You can use them if they are available and do something else if they are not.

Installation

Add friendlytagloader to INSTALLED_APPS

Usage

{% load friendly_loader %} in your template

Load some optional taglib {% friendly_load comments %}

Or load a specific tag {% friendly_load cycle from future %}

Conditionally use its tag:

{% if_has_tag render_comment_list %}
    {% render_comment_list for obj %}
{% else %}
    Comment support is not available
{% endif_has_tag %}

{% friendly_load %} takes multiple arguments, so loading multiple optional template tag libraries at once is supported:

{% friendly_load comments webdesign website_tags %}

{% if_has_tag %} and {% ifnot_has_tag %} can also handle multiple arguments.

In the case of if_has_tag this means that all given tags should be available, so this will render nothing even though now is a built-in tag:

{% if_has_tag now nonexisting_tag %}
  {% now 'Y' %}
{% endif_has_tag %}

The ifnot_has_tag condition will trigger if any of the given tags is unavailable. For example this will render the message since, even though now is a built-in tag, nonexisting_tag is not available:

{% ifnot_has_tag now nonexisting_tag %}
  Some tags are unavailable.
{% endifnot_has_tag %}

Credits

Original Author: Jaap Roes

Current Maintainer: Adam Taylor

Changes

1.3.1 (2018-08-14)

  • Added support for Django 2.1

1.3 (2018-06-21)

  • Dropped support for Django < 1.11
  • Added support for Django 1.11 and 2.0

1.2.1 (2015-07-01)

  • Django 1.8 support

1.2 (2014-09-29)

  • Dropped support for Django < 1.4
  • Verified Django support up to 1.7
  • Added Python 3 support
  • Support friendly_load tag from taglib syntax

1.1 (2012-06-01)

  • Django 1.4 compatible

1.0 (2011-10-21)

  • Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-friendly-tag-loader-1.3.1.tar.gz (9.8 kB) Copy SHA256 hash SHA256 Source None Aug 15, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page