Template Blocks¶

General¶

General template blocks:

<html> content¶

html_attribute

HTML <html> attributes.

Default:

{% block html_attribute %}lang="{% block html_lang %}{{ ADMINLTE_HTML_LANG }}{% endblock html_lang %}"{% endblock html_attribute %}

html_lang

HTML <html> lang attribute.

Default:

{{ ADMINLTE_HTML_LANG }}

<head> content¶

meta

<meta> tags in <head>.

Default:

{% block meta %}
    {% include 'adminlte2/components/_meta.html' %}
{% endblock meta %}

title: HTML <title> tag text.

stylesheets

CSS links in <head>.

Default:

{% block stylesheets %}
    {% include 'adminlte2/components/_stylesheets/bootstrap.html' %}
    {% include 'adminlte2/components/_stylesheets/fontawesome.html' %}
    {% include 'adminlte2/components/_stylesheets/adminlte.html' %}
{% endblock stylesheets %}

favicon

Favicon links in <head>:

Default:

{% block favicon %}
    <link rel="shortcut icon" href="{% block favicon_icon %}{% static 'favicon.ico' %}{% endblock favicon_icon %}">
{% endblock favicon %}

favicon_image

Favicon image path.

Default:

<link rel="shortcut icon" href="{% block favicon_icon %}{% static 'favicon.ico' %}{% endblock favicon_icon %}">

shim

HTML 5 Shim JavaScript links in <head>.

Default:

{% block shim %}
    {% if ADMINLTE_USE_SHIM %}
        {% include 'adminlte2/components/_shim.html' %}
    {% endif %}
{% endblock shim %}

javascripts

JavaScript links in <head>.

Default:

{% block javascripts %}
    {% include 'adminlte2/components/_javascripts/jquery.html' %}
    {% include 'adminlte2/components/_javascripts/bootstrap.html' %}
    {% include 'adminlte2/components/_javascripts/adminlte.html' %}
{% endblock javascripts %}

<body> content¶

body: HTML <body> tag content.

body_attribute

HTML <body> attributes.

Default:

{% block body_attribute %}class="{% block body_class %}hold-transition {{ ADMINLTE_SKIN_STYLE }}{% endblock body_class %}"{% endblock body_attribute %}

body_class

HTML <body> tag class attributes.

Default:

{% block body_class %}hold-transition {{ ADMINLTE_SKIN_STYLE }}{% endblock body_class %}

skin_style

HTML <body> tag class attribute for AdminLTE 2 skin theme.

Valid values are: 'skin-black', 'skin-black-light', 'skin-blue', 'skin-blue-light', 'skin-green', 'skin-green-light', 'skin-purple', 'skin-purple-light', 'skin-red', 'skin-red-light', 'skin-yellow', 'skin-yellow-light'.

javascripts_body: JavaScript links in <body>.

Layouts¶

Sidebar and top navigation layout template blocks:

Templates¶

header_template

AdminLTE 2 navigation header template.

Default:

{% block header_template %}
    {% include 'adminlte2/components/header.html' %}
{% endblock header_template %}

sidebar_template

AdminLTE 2 navigation sidebar template.

Default:

{% block sidebar_template %}
    {% include 'adminlte2/components/sidebar.html' %}
{% endblock sidebar_template %}

messages_template¶

Django messages alert box template.

Default:

{% block messages_template %}
    {% include 'adminlte2/components/messages.html' %}
{% endblock messages_template %}

control_template¶

AdminLTE 2 control sidebar template.

Default:

{% block control_template %}
    {% include 'adminlte2/components/control.html %}
{% endblock control_template %}

footer_template¶

AdminLTE 2 footer template.

Default:

{% block footer_template %}
    {% include 'adminlte2/components/footer.html' %}
{% endblock footer_template %}

Content¶

content_template

AdminLTE 2 page content code.

Default:

{% block content_template %}
        <div class="content-wrapper">
            {% block content_wrapper %}
                {% block no_content_header %}
                    <section class="content-header">
                        {% block content_header %}
                            {% block no_page_title %}
                                <h1>
                                    {% block page_title %}{% endblock page_title %}
                                    <small>{% block page_description %}{% endblock page_description %}</small>
                                </h1>
                            {% endblock no_page_title %}

                            {% block no_breadcrumbs %}
                                <ol class="breadcrumb">
                                    {% block breadcrumbs %}{% endblock breadcrumbs %}
                                </ol>
                            {% endblock no_breadcrumbs %}
                        {% endblock content_header %}
                    </section>
                {% endblock no_content_header %}

                {% block content_body %}
                    <section class="content">
                        {% block messages_template %}
                            {% include 'adminlte2/components/messages.html' %}
                        {% endblock messages_template %}

                        {% block content %}
                        {% endblock content %}
                    </section>
                {% endblock content_body %}
            {% endblock content_wrapper %}
        </div>
    {% endblock content_template %}

content_wrapper: Page content <div class="content-wrapper"> code.

content_header

Page content header code. Contains the page title and description, and breadcrumb navigation.

Default:

{% block content_header %}
    {% block no_page_title %}
        <h1>
            {% block page_title %}{% endblock page_title %}
            <small>{% block page_description %}{% endblock page_description %}</small>
        </h1>
    {% endblock no_page_title %}

    {% block no_breadcrumbs %}
        <ol class="breadcrumb">
            {% block breadcrumbs %}{% endblock breadcrumbs %}
        </ol>
    {% endblock no_breadcrumbs %}
{% endblock content_header %}

no_content_header

Declare block as empty to remove page content header (page title and description, breadcrumb navigation):

{% block no_content_header %}{% endblock no_content_header %}

page_title: Page title text that will be displayed in the content header.

page_description: Page description text that will be displayed in the content header.

no_page_title

Declare block as empty to remove page title and description text:

{% block no_page_title %}{% endblock no_page_title %}

breadcrumbs: Breadcrumb navigation that will be displayed in the content header.

no_breadcrumbs

Declare block as empty to remove breadcrumb navigation:

{% block no_breadcrumbs %}{% endblock no_breadcrumbs %}

content_body

Page content body code. Contains the Django messages alert boxes and page main content.

Default:

{% block content_body %}
    <section class="content">
        {% block messages_template %}
            {% include 'adminlte2/components/messages.html' %}
        {% endblock messages_template %}

        {% block content %}
        {% endblock content %}
    </section>
{% endblock content_body %}

content: Page main content.

Header¶

django-adminlte2-templates supports header for both sidebar (boxed, collapsed, fixed) and top navigation layouts:

logo

Header logo code.

Default for sidebar:

{% block logo %}
    <a href="{% block logo_href %}/{% endblock %}" class="logo">
        <span class="logo-mini">{% block logo_mini %}<b>A</b>LTE{% endblock logo_mini %}</span>
        <span class="logo-lg">{% block logo_lg %}<b>Admin</b>LTE{% endblock logo_lg %}</span>
    </a>
{% endblock logo %}

Default for top navigation:

{% block logo %}
    <a href="{% block logo_href %}/{% endblock logo_href %}" class="navbar-brand">
        {% block logo_lg %}
            <b>Admin</b>LTE
        {% endblock logo_lg %}
    </a>
{% endblock logo %}

logo_href

Header logo link URL.

Default:

logo_mini

(sidebar only) Header logo content when the sidebar content is collapsed.

Default:

<b>A</b>LTE

logo_lg

Header logo content when sidebar content is exposed, or for top navigation layout.

Default:

<b>Admin</b>LTE

header_content

Header main content code.

Default for sidebar:

{% block header_content %}
    <nav class="navbar navbar-static-top">
        {% block sidebar_toggle %}
            <a href="#" class="sidebar-toggle" data-toggle="offcanvas" role="button">
                <span class="sr-only">
                    {% block sidebar_toggle_text %}Toggle navigation{% endblock sidebar_toggle_text %}
                </span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
            </a>
        {% endblock sidebar_toggle %}

        <div class="navbar-custom-menu">
            <ul class="nav navbar-nav">
                {% block header_items %}
                {% endblock header_items %}
            </ul>
        </div>
    </nav>
{% endblock header_content %}

Default for top navigation:

{% block header_content %}
    <div class="collapse navbar-collapse pull-left" id="navbar-collapse">
        <ul class="nav navbar-nav">
            {% block header_items_left %}
            {% endblock header_items_left %}
        </ul>
    </div>

    <div class="navbar-custom-menu">
        <ul class="nav navbar-nav">
            {% block header_items %}
                {% block header_items_right %}
                {% endblock header_items_right %}
            {% endblock header_items %}
        </ul>
    </div>
{% endblock header_content %}

header_items: Header (right) navigation items.

header_items_left: (top navigation only) Header left navigation items.

header_items_right

(top navigation only) Header right navigation items. Alias for header_items.

Default:

{% block header_items %}
    {% block header_items_right %}
    {% endblock header_items_right %}
{% endblock header_items %}

sidebar_toggle

(sidebar only) Sidebar toggle button for sidebar (boxed, collapsed, fixed) layouts.

Default:

{% block sidebar_toggle %}
    <a href="#" class="sidebar-toggle" data-toggle="offcanvas" role="button">
        <span class="sr-only">
            {% block sidebar_toggle_text %}Toggle navigation{% endblock sidebar_toggle_text %}
        </span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
    </a>
{% endblock sidebar_toggle %}

sidebar_toggle_text

(sidebar only) Sidebar toggle button screenreader text for sidebar (boxed, collapsed, fixed) layouts.

Default:

Toggle navigation

header_toggle

(top navigation only) Responsive toggle button for left navigation links.

Default:

{% block header_toggle %}
    <button type="button" class="navbar-toggle collapsed"
        data-toggle="collapse" data-target="#navbar-collapse">
        <span class="sr-only">
            {% block header_toggle_text %}Toggle navigation{% endblock header_toggle_text %}
        </span>
        <i class="fa fa-bars"></i>
    </button>
{% endblock header_toggle %}

header_toggle_text¶

(top navigation only) Responsive toggle button screenreader text for left navigation links.

Default:

Toggle navigation

Control¶

control_items: Control sidebar navigation items.

control_tabs: Control sidebar navigation tab contents.

Messages¶

Django messages alert boxes.

message_debug

DEBUG alert box.

Default:

<div class="alert alert-info alert-dismissible">
    <button type="button" class="close" data-dismiss="alert" aria-hidden="true">&times;</button>
    {{ message }}
</div>

message_info

INFO alert box.

Default:

<div class="alert alert-info alert-dismissible">
    <button type="button" class="close" data-dismiss="alert" aria-hidden="true">&times;</button>
    {{ message }}
</div>

message_success

SUCCESS alert box.

Default:

<div class="alert alert-success alert-dismissible">
    <button type="button" class="close" data-dismiss="alert" aria-hidden="true">&times;</button>
    {{ message }}
</div>

message_warning

WARNING alert box.

Default:

<div class="alert alert-warning alert-dismissible">
    <button type="button" class="close" data-dismiss="alert" aria-hidden="true">&times;</button>
    {{ message }}
</div>

message_error

ERROR alert box.

Default:

<div class="alert alert-error alert-dismissible">
    <button type="button" class="close" data-dismiss="alert" aria-hidden="true">&times;</button>
    {{ message }}
</div>

message_default

Custom message alert box.

Default:

<div class="alert alert-info alert-dismissible">
    <button type="button" class="close" data-dismiss="alert" aria-hidden="true">&times;</button>
    {{ message }}
</div>

Footer¶

footer_content

Footer content code.

Default:

{% block footer_content %}

    <div class="pull-right hidden-xs">
        {% block footer_right %}
            <b>Version</b> {% block footer_version %}#.#.#{% endblock footer_version %}
        {% endblock footer_right %}
    </div>

    {% block footer_left %}
        {% block footer_legal %}
            <strong>Copyright &copy; {% now "Y" %}.</strong> All rights reserved.
        {% endblock footer_legal %}
    {% endblock footer_left %}

{% endblock footer_content %}

footer_left

Footer left side content.

{% block footer_left %}
    {% block footer_legal %}
        <strong>Copyright &copy; {% now "Y" %}.</strong> All rights reserved.
    {% endblock footer_legal %}
{% endblock footer_left %}

footer_right

Footer right side content.

<div class="pull-right hidden-xs">
    {% block footer_right %}
        <b>Version</b> {% block footer_version %}#.#.#{% endblock footer_version %}
    {% endblock footer_right %}
</div>

footer_version

Footer version text.

Default:

<b>Version</b> {% block footer_version %}#.#.#{% endblock footer_version %}

footer_legal

Footer legal text.

Default:

{% block footer_legal %}
    <strong>Copyright &copy; {% now "Y" %}.</strong> All rights reserved.
{% endblock footer_legal %}

Pages¶

Login¶

login_logo

Login logo code.

Default:

{% block login_logo %}
    <div class="login-logo">
        <a href="{% block login_logo_href %}{% endblock login_logo_href %}">
            {% block login_logo_text %}
                <b>Admin</b>LTE
            {% endblock login_logo_text %}
        </a>
    </div>
{% endblock login_logo %}

login_logo_href: Login logo link URL.

login_logo_text

Login logo content.

Default:

<b>Admin</b>LTE

login_content

Login page main content code.

Default:

{% block login_content %}
    <div class="login-box-body">

        <p class="login-box-msg">
            {% block login_description %}
                Sign in to start your session
            {% endblock login_description %}
        </p>

        {% block login_form %}
            <form method="POST">
                {% csrf_token %}
                {{ form }}
            </form>
        {% endblock login_form %}

        <div class="social-auth-links text-center">
            {% block login_social_auth %}
            {% endblock login_social_auth %}
        </div>

        {% block login_links %}
        {% endblock login_links %}

    </div>
{% endblock login_content %}

login_description

Login page description.

Default:

Sign in to start your session

login_form

Login form

{% block login_form %}
    <form method="POST">
        {% csrf_token %}
        {{ form }}
    </form>
{% endblock login_form %}

login_social_auth: Login social authentication links.

login_links: Login links.

Register¶

register_logo

Register logo code.

Default:

{% block register_logo %}
    <div class="register-logo">
        <a href="{% block register_logo_href %}{% endblock register_logo_href %}">
            {% block register_logo_text %}
                <b>Admin</b>LTE
            {% endblock register_logo_text %}
        </a>
    </div>
{% endblock register_logo %}

register_logo_href: Register logo link URL.

register_logo_text

Register logo content.

Default:

<b>Admin</b>LTE

register_content

Register page main content code.

Default:

{% block register_content %}
    <div class="register-box-body">

        <p class="login-box-msg">
            {% block register_description %}
                Register a new membership
            {% endblock register_description %}
        </p>

        {% block register_form %}
            <form method="POST">
                {% csrf_token %}
                {{ form }}
            </form>
        {% endblock register_form %}

        <div class="social-auth-links text-center">
            {% block register_social_auth %}
            {% endblock register_social_auth %}
        </div>

        {% block register_links %}
        {% endblock register_links %}

    </div>
{% endblock register_content %}

register_description

Register page description.

Default:

Register a new membership

register_form

Register form

{% block register_form %}
    <form method="POST">
        {% csrf_token %}
        {{ form }}
    </form>
{% endblock register_form %}

register_social_auth: Register social authentication links.

register_links: Register links.

Template Blocks¶

General¶

<html> content¶

<head> content¶

<body> content¶

Layouts¶

Templates¶

Content¶

Header¶

Sidebar¶

Control¶

Messages¶

Footer¶

Pages¶

Login¶

Register¶