Layouts - Place holders

Introduction

Place holders in a layout determine what information is shown. In a layout they appear in {} as if they are a type of plugin!
For example a typical line in a Download layout is
{file_pic}{file_title}{release}{pic_is_new}{pic_is_hot}{pic_is_updated}

This would produce a view such as that opposite. In this example only thefilepic, file title and hot placeholders produce output.  The hot appears as the downloadable file has been downloaded a sufficient number of times.  placeholder02
The release placeholder does not cause any output as no version number was set.  Similarly thenew and the updated place holders produce no output as they do not meet the relevant criteria to be shown.

This article has a reference list of all the known placeholders used in layouts.  It is useful if you are modifying a layout to add or remove some place holders.

The layouts themselves are like mini-templates defining what goes where when CjDowolads Categories and Dowloads are shown in the front end. To get an overall understanding of layouts please see the article An Introduction to Layouts (opens in a new window/tab)

There are seven different types of layout as noted below. In general each type has several different layouts.
  1. Categories
  2. Subcategories
  3. Category
  4. Downloads
  5. Download Details
  6. Summary
  7. Search form

Categories

Header
The placeholders available in Categories layout Header are
{home_link} {search_link} {upload_link} {upper_link} and {category_listbox} and for some layout types {cat_title} and {cat_description}
Subheading
The available place holders are:{subheader_title} {page_navigation} {page_navigation_results_counter} {page_navigation_pages_counter} and {count_of_sub_categories}.
Main
The available placeholder variables are {cat_title} {cat_description} {cat_pic} {sum_subcats} {sum_files_cat} {google_adsense} {tags} The placeholder variables {cat_info_begin} and {cat_info_end} mark the zone where the information about a category will be displayed.

Footer
The available placeholder variables are {back_link} {page_navigation} {page_navigation_results_counter} and {page_navigation_pages_counter}..

Subcategories

There are  no Header, Subheading or Footer parts in Subcategories
Main
The available placeholder variables are {cat_title} {cat_description} {cat_pic} {sum_subcats} {sum_files_cat} {google_adsense} {tags}. The placeholder variables {cat_info_begin} and {cat_info_end} mark the zone where the information about a category will be displayed.

Category

This is how a single Category is displayed in the frontend.
Header
The header placeholder variables are {home_link} {search_link} {upload_link} {category_listbox} and for some layout types {upper_link} {cat_title} and {cat_description}.

Subheading
The available placeholder variables are {subheader_title} {page_navigation} {page_navigation_results_counter} {page_navigation_pages_counter} {count_of_sub_categories}.

Main
The available placeholder variables are {cat_title} {cat_description} {cat_pic} {sub_categories} {files} {checkbox_top} {sum_subcats} {sum_files_cat} {google_adsense} and {tags}. Use the placeholder variables {cat_title_begin} {subcats_title_text} {cat_title_end} to insert a title above the subcategories.

Note: The {sub_categories} {files} {form_hidden} {form_button} {checkbox_top} placeholder variables should NOT be removed from the code. Also only remove placeholder variable {checkbox_top} from the layout if placeholder variable {url_download} is used in the file layout. The {files} placeholder variable is replaced with data from the file layout and the {sub_categories} placeholder variable is replaced with the sub categories which used the categories layout.

Footer
The Category footer placeholder variables are {back_link} {page_navigation} {page_navigation_results_counter} {page_navigation_pages_counter}. and for some layout types: {cat_title} and {cat_description}.

Downloads

Header
The available placeholder variables are {home_link} {search_link} {upload_link} {category_listbox} and for some layout types {upper_link} {cat_title} and {cat_description}.

Subheading
The available placeholder variables are {subheader_title} {page_navigation} {page_navigation_results_counter} {page_navigation_pages_counter} {count_of_sub_categories} and only for Downloads layouts: {sort_order}.

Main

The general placeholder variables are noted in the two sections below. The first section are those which generally appear by themseves.

{url_download} {checkbox_list} {cat_id} {file_id} {file_pic} {file_title} {pic_is_new} {pic_is_hot} {pic_is_updated} {thumbnail} {description} {link_to_details} {mirror_1} {mirror_2} {preview_player} {preview_url} {mp3_id3_tag} {google_adsense} {report_link} {sum_jcomments} {featured_class} {featured_detail_class} {featured_pic} and {show_association}.

In this second section the placeholders shown below are usually paired together.
{category_title} {category_name}
{file_name_title} {file_name}
{release_title} {release}
{file_date_title} {file_date}
{license_title} {license_text}
{language_title} {language_text}
{filesize_title} {filesize_value}
{system_title} {system_text}
{price_title} {price_value}
{author_title} {author_text}
{author_url_title} {author_url_text}
{created_date_title} {created_date_value}
{hits_title} {hits_value}
{created_by_title} {created_by_value}
{modified_by_title} {modified_by_value}
{modified_date_title} {modified_date_value}
{rating_title} {rating}
{tags_title} {tags}

Fields

To insert Fields use placeholders {jdfield_title 'id'} and {jdfield 'id'} where 'id' is the ID of the required Field.

Images

To insert an image (screenshot), which are used with the Lightbox Function, requires placeholder variables as described below.
For the first image: {screenshot_begin} {screenshot_end} 

For subsequent images include a sequence number, starting at 2, as indicated in the following:
{screenshot_begin2}{screenshot_end2} 
{screenshot_begin3}{screenshot_end3}  
 
A typical line in a Layout would be as shown opposite.  The format is quite strict!

placeholder01
Footer
The available placeholder variables are {back_link} {page_navigation} {page_navigation_results_counter} and {page_navigation_pages_counter}.

Download Details

Header
The available placeholder variables are {home_link} {search_link} {upload_link} {category_listbox} and for some layout types {upper_link} {cat_title} and {cat_description}.

Subheading
The only available placeholder variable is {detail_title}.

Main
The regular placeholders are the same as those in the Main part of the Downloads.

Tabs

Tabs may be used in the Downloads Details layouts if required.
If you use TABS for the frontend output, you must select a tabs type in the configuration. Then you must place {tabs begin} where the tabs are to start and {tabs end} where they are to end in the TABS area in the layout. Inside the TABS area you can define the following areas: {tab description} {tab description end} {tab pics} {tab pics end} {tab mp3} {tab mp3 end} {tab data} {tab data end} {tab download} {tab download end} {tab custom1} {tab custom1 end} {tab custom2} {tab custom2 end} {tab custom3} {tab custom3 end} 
Footer
The only available placeholder variable in the footer is {back_link}.

Summary

Header
The available placeholder variables are {home_link} {search_link} {upload_link} {category_listbox} and for some layout types {upper_link} {cat_title} and {cat_description}.

Subheading
The only available placeholder variable is {summary_title}.

Main
The {download_liste} and {download_link} placeholder variables should NOT be removed from the code. The {captcha} or {password} placeholder variables may also be inserted if you use those options and you wish to show that information.

Available placeholder variables are{summary_pic} {title_text} {download_liste} {download_link} {external_download_info} {aup_points_info} {license_title} {license_text} {license_checkbox} {info_zip_file_size} {google_adsense} {user_limitations} {captcha} and {password}.
Footer
The only available placeholder variable is {back_link}.

Search Form

Header
The available placeholder variables are {home_link} {search_link} {upload_link} {category_listbox} and for some layout types {upper_link} {cat_title} and {cat_description}.

Subheading
No place holders are available in a Search layout Subheading.

Main
Search Forms do not have a Main part of the layout but you can add {google_adsense}.

Footer
The only available placeholder variable is {back_link}.


ColinM February 2020, modified April 2021

Tags: index

Print