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:
The ‘email’ argument,
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 %}