Which Layout is used where?
The objective of this article is to show which layout or part of a layout is used when showing jDownloads Categories and Downloads.
There are seven layout types as listed below, most have sevaeral layout versions. Only one layout of each type is the 'activate' one.
- Categories: Defines the layout of the Categories view. No Downloads are here listed, only the Root Categories.
- Subcategories: Defines the layout when showing multiple Subcategories.
- Category: Defines the layout of a single Category.
- Downloads: Defines the layout of each Download that is listed.
- Download Details: Defines the layout of the detailed view of a Download.
- Summary: Defines the layout of the Download summary page which may be shown in various circumstances such as supplying a password, confirming a licence and so on. If it is shown then this is the page where actual downloading is initiated.
- Search form: Defines how the form and the results from the frontend search function are shown.
Which layout is used
There are up to six parts in a layout
- main - this is the central part of the layout, it is often used multiple times on a page for example once for every Download
- header - appears as the heading, used once per page
- sub-header - appears below the header, used once per page
- footer - shown below the last item on each page, used once per page
- use before - this is used once per page and occurs just before the main part of the layout, normally empty
- use after - this is used once per page and occurs after all uses of the main part of the layout, normally empty
Showing Download Details, Summary or Search
- viewing Download Details uses the active Download Details layout for all four principle parts;
- viewing the Summary uses the active Summary layout for all four principle parts;
- viewing a Search uses the active Search layout. Only the header, subheader and footer parts are used.
Showing List All Categories
Appendix: Options Front End Tab Setup Details
For details of all the front end option see the article A Tutorial on Front End Options (opens in a new window/tab)
|Front End Parameter
|Number of Categories to show per page *
|Allows you to specify the maximum number of category entries that will be displayed per page by the front-end.
|Number of Downloads to show per page *
|Allows you to specify the maximum number of Downloads entries that will be displayed on each page by the front-end.
|Categories default frontend sort order
|Title Reverse Alphabetical
|Select the default frontend sort order for Categories. Select 'Categories Manager Order' to use the backend default order.
|Downloads default frontend sort order
|Select the default frontend sort order for Downloads. Select 'Downloads Manager Order' to use the backend default order.
|Use files title as download link
|When this option is set to Yes then the download title will be a link that starts the downloading process.
|Show navigation at the top
|If set to Yes, a page navigation bar for the 'downloads' is displayed at the top of the page.
|Show navigation at the bottom
|If set to Yes, a page navigation bar for the 'downloads' is displayed at the bottom of the page.
|Show navigation for Subcategories
|If set to Yes then an extra field is shown below allowing you to specify the 'Number of Subcategories/Page'. A subcategories navigation bar will be displayed in the front end view.
|Number of Subcategories
|Allows you to select the maximum number of subcategories that will be displayed per page.
|Show empty Categories
|If set to Yes then all categories are shown including those without any Downloads.
Colin Mercer, December 2019, modified March 2021 and May 2023