General App Templates
Each page within the general app has its own template to display that page's content.
Where to save template files
Template files will go in a folder that has the same name as the app instance key. For example, if the general app instance key is "app" then you would put all of your template files within the app folder inside the templates folder.
If your theme was called "Custom" then this would be an example folder structure:
- themes
- custom
- theme.json
- templates
- home.twig
- one-column.twig
- two-column.twig
- app
- account-items.twig
- add-item.twig
- categories.twig
- category.twig
- edit-item.twig
- home.twig
- item.twig
- items.twig
- search.twig
- search-results.twig
- tag.twig
- tags.twig
- custom
App pages and their templates
Below is the list of general app pages and the name of the template file that you should create.
App home
The app home page often shows the app items and/or categories.
Template name: home.twig
Account items
This page shows items that the account holder created.
Template name: account-items.twig
Add item
This page is used to show a form on the public site that allows visitors to add a new item to the app. It can be restricted to only allow logged in users add items. Items added through this form can also be configured to require admin approval before displaying in the list of items.
Template name: add-item.twig
Categories list
This page shows the list of categories.
Template name: categories.twig
Category detail
This page shows the detail information for an individual category. The items assigned to the category are often shown.
Template name: category.twig
Edit item
This is a public page to allow visitors to edit an individual item. Under App -> Settings you can configure whether or not someone has to be logged in to make changes.
Template: edit-item.twig
Item detail
This page shows the full details for an individual app item.
Template name: item.twig
Item list
This page shows a paginated list of app items.
Template name: items.twig
Search
The search page can be used to show the form to search for items.
Template name: search.twig
Search results
The search results page can show the results of an app search. It can show a paginated list of matching items.
Template name: search-results.twig
Tags list
This page shows the list of tags.
Template name: tags.twig
Tag detail
This page shows the detail information for an individual tag. The items assigned to the tag are often shown.
Template name: tag.twig