Template Tags

This package includes some template tags that are designed to add some useful features to any project.

To use any of the following template tags you first need to load them at the top of your template.

{% load adminlte_tags %}

render_form_error_summary

Determine if the context contains forms or formsets that should be checked for errors, and then add any found errors to the context so they can be rendered out at the top of the page.

Type:

inclusion

Template:

adminlte2/partials/_form_error_summary.html

Example:

{% render_form_error_summary %}

render_fields

Render given fields with optional labels vertically.

param fields_to_render:

List or tuple of fields to render out.

param labels:

Whether to use labels for fields. Defaults to True.

param media:

Media that needs to be used in the form. Defaults to None.

return:

Context for the template.

Tag Type:

inclusion

Template:

adminlte2/partials/_form.html

Example:

{% render_fields fields %}

render_form

Render a vertical form where fields are always below the label.

param form:

Form to render.

param labels:

Whether to use labels for fields. Defaults to True.

param media:

Media that needs to be used in the form. Defaults to None.

return:

Fields to render.

Type:

inclusion

Template:

adminlte2/partials/_form.html

Example:

{% render_form form %}

render_horizontal_fields

Render given fields with optional labels horizontally.

param fields_to_render:

List or tuple of fields to render.

param labels:

Whether to use labels for fields. Defaults to True.

param media:

Media that needs to be used in the form. Defaults to None.

return:

Context for the template.

Type:

inclusion

Template:

adminlte2/partials/_horizontal_form.html

Example:

{% render_horizontal_fields field %}

render_horizontal_form

Render a horizontal form.

param form:

The form to render.

param labels:

Whether to use labels for fields. Defaults to True.

param media:

Media that needs to be used in the form. Defaults to None.

return:

Context for the template.

Type:

inclusion

Template:

adminlte2/partials/_horizontal_form.html

Example:

{% render_horizontal_form form %}

render_horizontal_formset

Render a horizontal formset.

param formset:

The formset to render.

param section_heading:

The section header to render.

return:

Context for the template.

Type:

inclusion

Template:

adminlte2/partials/_horizontal_formset.html

Example:

{% render_horizontal_formset formset section_heading %}

get_logout_url

Get the logout URL from the settings.

Type:

simple

Example:

{% get_logout_url %}

get_home_url

Get the home URL from the settings and default to the adminlte2_pdq home.

Type:

simple

Example:

{% get_home_url %}

get_logo_text

Get the Logo Text from the settings and default to <b>Admin</b>LTE. Used internally by the package.

Type:

simple

Example:

{% get_logo_text %}

get_logo_text_small

Get the Small Logo Text from the settings and default to <b>A</b>LTE. Used internally by the package.

Type:

simple

Example:

{% get_logo_text_small %}

get_skin_class

Get the AdminLTE2 skin-class from the settings and default to skin-blue. Used internally by the package.

Type:

simple

Example:

{% get_skin_class %}

get_datetime_widget

Get the HTML5 / JS datetime widget from the settings and default to ‘native’ This will get the widget to use when showing a DateTime field in a form. Used internally by the package.

Type:

simple

Example:

{% get_datetime_widget %}

get_date_widget

Get the HTML5 / JS date widget from the settings and default to ‘native’ This will get the widget to use when showing a DateTime field in a form. Used internally by the package.

Type:

simple

Example:

{% get_date_widget %}

get_time_widget

Get the HTML5 / JS time widget from the settings and default to ‘native’ This will get the widget to use when showing a DateTime field in a form. Used internally by the package.

Type:

simple

Example:

{% get_time_widget %}

get_avatar_url

Get a gravatar image URL. If no image is found, gravatar will return an image based on the ‘default’ keyword. See http://en.gravatar.com/site/implement/images/ for more info.

This function will get the profile email in this order:

  1. The ‘email’ argument,

  2. The ‘user’ argument if it has an ‘email’ attribute.

param context:

Context that is not used.

param user:

User that may have an email that can be used for gravatar.

param email:

Email that can be used for gravatar.

param size:

Size if it needs to be overridden.

param default:

The default gravatar that will be used if no email.

Type:

simple

Example:

{% get_avatar_url %}

user_image_initials

Show user gravatar, initials, or gravatar default mystery person as the image

Attempt to use/create initials of the user in the style of a profile picture. Overlay with the user’s gravatar image or a blank one if the user does not exist. If initials can not be created, change the gravatar default from blank to the standard mystery person.

If the user is passed in, the user will be used for the base information. Information can be overridden by other keyword arguments. If the user is NOT passed in, keyword arguments for each piece of information should be used.

param context:

Context for the template.

param user:

The user to use for information.

param email:

The email to use for information.

param initials:

The initials to use in place of generated ones.

param first_name:

The first name to use in place of the users.

param last_name:

The last name to use in place of the users.

param size:

Size if it needs to be overridden. Default is 25x25.

return:

Context for template.

Type:

inclusive

Template:

adminlte2/partials/_user_image_initials.html

Example:

{% user_image_initials %}