Form includes¶
Important
In order for this feature to work, the user browser must support html template tags.
Baton lets you include templates directly inside the change form page, in any position you desire. It’s as simple as specifying the template path, the field name used as anchor and the position of the template:
@admin.register(News)
class NewsAdmin(admin.ModelAdmin):
#...
baton_form_includes = [
('news/admin_datetime_include.html', 'datetime', 'top', ),
('news/admin_content_include.html', 'content', 'above', )
]
In this case, Baton will place the content of the admin_datetime_include.html
template at the top of the datetime field row, and the content of the admin_content_include.html
above the content field row.
You can specify the following positions:
Position | Description |
---|---|
top | the template is placed inside the form row, at the top |
bottom | the template is placed inside the form row, at the bottom |
above | the template is placed above the form row |
below | the template is placed below the form row |
right | the template is placed inline at the field right side |
And, of course, you can access the {{ original }} object variable inside your template.
It works seamlessly with the tab facility, if you include content related to a field inside one tab, then the content will be placed in the same tab.