Trails App Templates
Each page within the trails 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 trails app instance key is "trails" then you would put all of your template files within the trails folder inside the templates folder.
If your theme was called "Custom" then this would be an example folder structure:
General pages and their templates
Below is the list of app pages and the name of the template file that you should create.
The trails home page is often used to show a Google map of all trail locations, the search form to search trails and a paginated list of trails.
The Google map can show the markers for the center point of each trail. Some sites also show the line segments for individual trails as you zoom into the map.
Template name: home.twig
The search page can be used to show the search form to search trails. Alternately you can use the Search Form API to embed the search form on other pages.
Template name: search.twig
The search results page can show the results of a trails search. It can show a paginated list of matching trails or you can also display a Google map of matching trails.
Template name: search-results.twig
The trails list page is usually a continuation of the paginated list of trails from the trails app home page.
Template name: trails.twig
The trail detail page shows the information for an individual trail. Often a Google map is displayed showing the individual line segments and feature points for the trail.
Template name: trail.twig
This is a public page to allow visitors to edit an individual trail. Under Trails -> Settings you can configure whether or not someone has to be logged in to make changes.
While an entire trail can be edited this page is often used to allow your visitors to add additional trail images to a single trail.
You can allow third-party websites to embed trail information into their websites. This view is used to display the content that is embedded via an iframe into their website.
Template name: embed.twig
Public users can log into the website to manage their trails, diary entries and view their badges. Below is the list of account specific trails app pages.
This is where they will log into their account.
This page is the landing page for the account. It's where they go when they log in if they weren't coming from a password protected page or another page that requires a login. If they were coming from a password protected page or another page that requires a login, then they would be redirected back to that page.
The account edit page shows a form that allows an account holder to update their profile and login information.
This page allows the account holder to request a password reset if they are having trouble logging in.
Shows a form to allow new account holders to register themselves.
Account badges, diary entries, and trails
If the site allows it, account holders can earn badges for completing trails, create diary entries of their trail adventures, wishlist trails, favorite trails, and mark trails as completed. Below are the pages that you can set up for a logged in account holder to view and manage that information.
This page shows the list of badges that an account holder has earned.
Account badge details
This page shows the details of an individual badge that an account holder has earned.
Account completed trails
This page shows the trails that the account holder has marked as completed.
Account diary entries
This page shows the list of diary entries that the account holder has added.
Account diary add entry
This page shows a form to allow the account holder to add a diary entry for an individual trail.
Account diary edit entry
Shows a form to allow the account holder to edit a diary entry.
Account diary entry
Shows an individual diary entry that the account holder has added.
Account favorite trails
This page shows the trails that the account holder has added to their favorites list.
Account my trails
Shows all of the trails that the account holder has completed, added to their wishlist, or added to their favorites list.
Account share badge
This page allows a single badge for an account to be shared without having to be logged in to view it.
Account share badges
This page allows all of the badges for an account to be shared without having to be logged in to view them.
Account wishlist trails
This page shows the trails that the account holder has added to their wishlist.