Cookbook¶
Recipes for getting a specific job done. Each entry is a question you might have, and the shortest answer that works.
If you are new to iommi, work through Getting started and the Tutorial first: these recipes assume you already have iommi running.
Per component¶
- General
- Parts & Pages
- How do I override part of a part/page?
- How do I set the title of my page?
- How do I specify the context used when a Template is rendered?
- How do I make a menu?
- How do I add a custom endpoint?
- How do I add CSS or JavaScript assets to a page?
- How do I set the content of a fragment-like part?
- How do I group actions together?
- Forms
- How do I specify which fields to show?
- How do I supply a custom parser for a field?
- How do I make a field non-editable?
- How do I make an entire form non-editable?
- How do I supply a custom validator?
- How do I validate multiple fields together?
- How do I exclude a field?
- How do I say which fields to include when creating a form from a model?
- How do I supply a custom initial value?
- How do I set if a field is required?
- How do I change the order of the fields?
- How do I specify which model fields the search of a choice_queryset uses?
- How do I make a foreign key field a multi-select?
- How do I insert a CSS class or HTML attribute?
- How do I override rendering of an entire field?
- How do I override rendering of the input field?
- How do I change how fields are rendered everywhere in my project?
- How do I change where the form redirects to after completion?
- How do I make a fields choices depend on another field?
- How do I enable a reverse foreign key relationship?
- How do I set an initial value on a field that is not in the form?
- How do I group fields?
- How do I show a reverse many-to-many relationship?
- How do I nest multiple forms?
- How do I use templates for fields?
- How do I make a field that depends on the choice in another field?
- How do I make a create or edit form?
- How do I create a hidden field?
- How do I access errors?
- How do I customize how a field value is written to the instance?
- How do I make complex layouts for forms?
- How to make cool drag&drop file or image fields?
- How do I customize a form’s buttons?
- How do I read the model information iommi found for a form?
- How do I customize how choices are displayed?
- How do I customize a field’s label and help text?
- How do I control how a field’s input is read and rendered?
- How do I change how a field reads its value from the instance?
- How do I hook into saving a create/edit form?
- Tables
- How do I customize the rendering of a table?
- How do you turn off pagination?
- How do I customize the rendering of a cell?
- How do I make a link in a cell?
- How do I create a column based on computed data (i.e. a column not based on an attribute of the row)?
- How do I get iommi tables to understand my Django ModelField subclasses?
- How do I reorder columns?
- How do I enable searching/filter on columns?
- How do I make a freetext search field?
- How do I customize HTML attributes, CSS classes or CSS style specifications?
- How do I customize the rendering of a row?
- How do I customize the rendering of a header?
- How do I turn off the header?
- How do I add fields to a table that is generated from a model?
- How do I specify which columns to show?
- How do I access table data programmatically (like for example to dump to json)?
- How do I access foreign key related data in a column?
- How do I turn off sorting? (on a column or table wide)
- How do I specify the title of a header?
- How do I set the default sort direction of a column to be descending instead of ascending?
- How do I set the default sorting column of a table?
- How do I group columns?
- How do I group rows?
- How do I get rowspan on a table?
- How do I enable bulk editing?
- How do I enable bulk delete?
- How do I make a custom bulk action?
- What is the difference between
attrand_name? - How do I show a reverse foreign key relationship?
- How do I show a reverse many-to-many relationship?
- How do I insert arbitrary html into a Table?
- How do I add custom actions/links to a table?
- How do I render additional rows?
- How do I set an initial filter to a table?
- How do I automatically create filters for indexed fields?
- How do I show row numbers?
- How do I show nested foreign key relationships?
- How do I stop rendering the header?
- How do I render a Table as divs?
- How do I do custom processing on rows before rendering?
- How do I set an empty message?
- How do I make complex layouts for table rows?
- How do I group columns under a superheader?
- How do I change what a column sorts by?
- How do I avoid extra queries for a column across a relationship?
- How do I limit the choices for a column?
- How do I read the model information iommi found?
- How do I use custom classes for a table’s internal parts?
- How do I render the table actions below the table?
- How do I run code after a bulk edit, or limit which rows it touches?
- How do I customize the message shown for an invalid filter?
- How do I wrap just the table tag (e.g. for responsive scrolling)?
- How do I let the user download a table as CSV?
- Edit tables
- How do you edit one-to-one fields in an edit table?
- How do I change the delete buttons to checkboxes?
- How do I include labels for fields?
- How do I let users drag to reorder rows?
- How do I configure the edit and create forms of an edit table?
- How do I customize the Save and Add row actions?
- How do I set defaults on newly added rows?
- How do I nest an edit table inside a form?
- Queries
- How do I override what operator is used for a query?
- How do I control what Q is produced?
- How do I control the name used in the advanced query?
- How do I filter on the thing itself?
- How do I style the query container?
- How does a query filter the rows, and how do I post-process them?
- How do I choose which filters are generated from a model?
- How do I configure a filter’s GUI field?
- How do I customize how a single filter matches?
- How do I customize the advanced query language area?
- How do I let a filter match several values at once?
- Main menu
- How do I control which menu items are shown for a user?
- How do I control the display name of a menu item?
- How do I add sub-paths for a menu item?
- How do I add external links in the menu?
- How do I nest menu items?
- How do I put arbitrary html in the menu?
- How do I show which specific object I am on in the menu?
- How do I make a data driven dynamic submenu?
- How do I use the menu for access control and path mapping without rendering into the menu?
- Calendar