cms_module_hint

   Purpose

This function plugin can be used to provide hints for module behavior if various parameters cannot be specified on the URL. I.e: In a situation when a site is configured to use pretty urls for SEO purposes it is often impossible to provide additional module parameters like a detailtemplate or sort order on a URL. This plugin can be used in page templates, GCBs or in a page specific way to give hints as to how modules should behave.

Any parameters that are specified on the URL will override matching module hints. i.e: When using News and a detailtemplate parameter is specified on a News detail url, any detailtemplate hints will have no effect.

In order to ensure proper behavior, module hints must be created before the {content} tag is executed in the CMSMS page template. Therefore they should (normally) be created very early in the page template process. An ideal location for page specific hints is in the "Smarty data or logic that is specific to this page:" textarea on the editcontent form.

   Available parameters

  • module (required) - The module name that you are adding a hint for.

Any further parameters to this tag are stored as hints.

   Example

When using the News module, and pretty URLs are configured. You wish to display news articles for a specific category on one page, and would like to use a non-standard detail template to display the individual articles on a different page. e.g: perhaps on your "Sports" page you are calling News like: {News category=sports detailpage=sports_detail}. However, using pretty URLs it may be impossible to specify a detailtemplate on the links that will generate the detail views. The solution is to use the {cms_module_hint} tag on the sports_detail page to provide some hints as to how News should behave on that page.

When editing the sports_detail page on the options tab, in the textarea entitled "Smarty data or logic that is specific to this page:" you could enter a tag such as: {cms_module_hint module=News detailtemplate=sports}. Now, when a user clicks on a link from the News summary display on your "sports" page, they will be directed to the sports_detail page, and the News detail template entitled "sports" will be used to display the article.

   Usage

{cms_module_hint module=ModuleName paramname=value ...}