This page is under construction
Saltcorn has a small number of view templates built in, and more can be enabled through plug-ins.
Show: show one row in the database to the user. The layout of the display of the row is configured with the drag-and-drop builder.
Edit: a form for creating a new or editing an existing row in the database. The form layout is configured with the drag-and-drop builder, and there is additional configuration of the values to be used for filling in the fields that have been left out of the form, and where to navigate when the form has been successfully filled out.
List: show multiple rows from the database to the user in a table. Configured by choosing the columns in the table, which can include table fields, join fields (fields and related tables), aggregations, actions on the current row (for instance, Delete row), links to other views of that row. Also displays the current state form as a drop-down menu button and optionally, a link or embed a form to create a new row.
Feed: display multiple rows from the database by displaying each row using the underlying view (the "Item view") chosen in the configuration, in a feed, possibly with multiple columns. The Item view will typically be an instance of the show view template.
Additional view templates can be installed with plug-ins, for instance kanban boards (where each card in the board is shown as an underlying view) and maps (pop-ups can be configured as underlying views)
A view template is a template for creating a new view by applying it to a table. The view template will also define what further information is needed in order to create the full view.
View = View templates applied to table with specified options
View templates are defined in plug-ins. Some basic view templates are defined in the base plug-in, and more view templates can be added by activating new plug-ins.
There are two different kinds of view templates, basic and composed.
Plug-ins may provide both composed and basic view templates.
The base plug-in provides three different basic view templates: list, edit, and show.
List view: Display multiple rows from a table in a grid with columns you specify. For example, a view with a list of authors.
You can also add fields to a list view from related tables, links to other views or aggregations (calculations from related tables). For example, the number of posts written is calculated from the Blog table, and displayed in the list view.
Edit: Form for creating a new row or editing existing rows. With the right permissions, you can set a view to show the list, and allow an admin or other user to edit right on the page. For example, Joshua Bell can be given rights to add another blog post.
DO WE NEED THIS HERE? The edit view template creates forms for creating new or editing existing rows in a table. It has somewhat limited customisability consisting only of choosing the fields in the form, and if fields have been left out of the form, a default value may be specified.
Show: Show a single row, with flexible layout. So rather than just a row, you could design an author bio view with a big photo, a list of credentials, a biography, and contact details.
You can also add fields to a show view from related tables, links to other views or aggregations (calculations over related tables). For example, you could add cards showing all the posts an author has written to the author bio view.
ListShowList: Combine an optional list view on the left with displays on the right of a single selected row, with views of related rows from different tables underneath. You could make an author bio view with a big photo, a list of credentials, a biography, contact details from one table. Then add a list of their blog posts and statistics.
Feed: Show multiple rows by displaying a chosen view for each row, stacked or in columns.
Filter: Elements that limit the rows shown in other views on the same page. Filter views do not show any rows on their own.