This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
devel:blueprints:django_template [2010/01/13 10:34] eide django and context processors |
devel:blueprints:django_template [2010/01/13 12:07] eide context processors as a table |
||
---|---|---|---|
Line 11: | Line 11: | ||
Some features of the templates, such as debug, version number and account/user info and preferences requires context processors. | Some features of the templates, such as debug, version number and account/user info and preferences requires context processors. | ||
- | Currently these context processors are: debug, account and nav_version. | + | Context processors are not passed to templates by default with render_to_response(), a RequestContext object must be passed to render_to_response to get them. |
- | === Debug === | + | Without the account_processor all user specific content in templates will not work. |
- | Provides a SQL debug table at the bottom of every Django page if the DEBUG setting is set to true. | + | <code> |
+ | render_to_response( | ||
+ | 'path/to/template', | ||
+ | {'some_context': var}, | ||
+ | RequestContext(request) | ||
+ | ) | ||
+ | </code> | ||
- | === Account_processor === | + | ^ NAV context processors ^^ |
+ | | debug | Provides a SQL debug table at the bottom of every Django page if the DEBUG setting is set to true. | | ||
+ | | account_processor | Provides account object for current user, a flag telling if he/she is and admin, messages for the user and custom navigation bar. | | ||
+ | | nav_version | The version number from nav.web.buildconf | | ||
+ | | toolbar | All available tools from the toolbox (not enabled by default) | | ||
- | Provides the account object for the current user, a flag telling if he/she is an admin, messages for the user and the custom links found in the navbar (includes quick links). | + | ==== Template blocks and variables ==== |
- | === nav_version === | + | The base templates contains a number of template blocks and variables that both can be overwritten by subsystems. |
- | Returns the version number from nav.web.buildconf | + | ^ Blocks ^^ |
+ | | base_header | The header. Doctype, HTML head section and the header parts of the html. | | ||
+ | | base_header_head | The head block. | | ||
+ | | base_header_title | The title of the page. | | ||
+ | | base_header_additional_head | Any additional content that should go inside the head tag. Ie. extra CSS or JavaScript | | ||
+ | | base_body_start | The opening body tag. | | ||
+ | | base_header_logo | The NAV logo. | | ||
+ | | base_header_navbar | The navigation bar with breadcrumbs, customizable navbar and quick-links. | | ||
+ | | base_header_navpath | Breadcrumb path. | | ||
+ | | base_content | The content of the page. This one should be overwritten by subsystems to display the content. | | ||
+ | | base_debug | Output from the debug preprocessor. | | ||
+ | | base_footer | The footer | | ||
+ | |||
+ | ^ Variables ^^ | ||
+ | | title | Title of the page. Appears inside base_header_title so subsystems can use either one of them. | | ||
+ | | navpath | Breadcrumb path. Contains a list of tuples on the form (url, title). If url is None regular text is displayed, else you get an anchor. | | ||
+ | | navbar | Users navigation bar. Supplied from account_processor. | | ||
+ | | qlink1 and qlink2 | Quick link drop-downs. Supplied from account_processor. | | ||
+ | | nav_version | NAV Version, supplied from nav_version context preprocessor. | | ||
===== Backwards compability ===== | ===== Backwards compability ===== |