Contao Community Documentation - User contributions [en]

Contao.Dev ExtensionsCatalogExt

2011-12-22T16:06:59Z

Dolores: /* Catalog Reference */

{{stub}}

[PageOutline(1-4, Table of Contents)]

= Catalog Extension =

<code>
The Catalog and Catalog Extension modules are advanced modules and will require intermediate knowledge of PHP, HTML/CSS in order to create catalog that displays the way you really need it. To create advanced displays, you will need to understand PHP array structures provided in the TPL files.
*NOTE: This is not a module for beginners*.
</code>
<code>
The Catalog module is a simple stop-gap to assist beginners with quickly getting up a custom application without having to write any code. However, the Catalog module is obviously NOT capable of working for all situations, at some point you have to get yourself dirty with PHP programming and just write your own TL applicationa, which is a bit of work and a lot of files, but easier than you might think.
</code>

The documentation below only explains how to configure the [[CatalogExt]] Front-End modules (see reference links below).

== Reference Links ==

* [ExtensionsCatalog Configuring the Catalog] -- should be done before reading this section
* [TutorialsCatalog Catalog Templates Tutotial] explains advanced template customisation
* [TutorialsCatalogMultiLanguage Catalog Multi-Language Tutorial] explains how to easily set-up multi-language catalogs

== Summary ==

Once you've setup a Catalog in the back-end, you can use the Catalog Extension to add more features and to build the front-end with the following modules:

* Catalog Filter Module: build your filter on field values, range, date, search.
* Catalog List Module: displays a list of items responding to the filter above.
* Catalog Reader: displays item detail view + reference info (jump links to other catalogs).
* Catalog Notify: creates contact form for clients to send contact info on catalog item (used on reader page)
* Catalog Featured: selectable number of (random) items filtered by a preset condition.
* Catalog Related: show related catalog items (except current) with selectable matching parameters.
* Catalog Reference: show child catalog items where a selected reference field is matching the current viewed parent item.

== Front-end Display Modules ==

To better understand the Front-End (FE) Modules, the following two diagrams will illustrate the two-page approach.

=== Catalog List Page ===

[[File:catalog-list-use.jpg]]

=== Catalog Reader Page ===

[[File:catalog-reader-usage.jpg]]

=== Catalog Filter ===

* Filter Module is simple point-and-click form builder
* Almost all fields can be used as a filtered list, except URL, FILE (these were too difficult to achieve successfully) and LONGTEXT (as a dropdown with lots of rich text won't be of any value)
* Each field can now be ordered and separately changed to: none, links list, radio, select drop-down
* Set-up a Field Filter Tree with auto-hide children and children become self-filtered by parents. This is ideal for situations like: Area, City (click on area and it only shows cities in that area)
* Tags can be set to display as multiple selects (radio becomes a checkbox control, and select becomes a multi-select)
* Date filter section, order and chose which date fields and the types or past periods (day, week, month, 6 months or year)
* As this is a separate module, you can place the filter in the right/left nav bar, but it must appear on the same page as the Catalog List module to create the filter URL for the list module to respond
* Multiple catalog filters are supported on the same page, each can display only a certain part, e.g. one for filter on 1 field to create categories, another for the search and other filter specs in the right nav.
* You can also set-up a [[JumpTo]] page, to which the filter will jump when clicked on a filter field, range, date, search or sort field. [[JumpTo]] is also Filter Tree View aware, e.g. it does not jump unless you are clicking on the last field in the filter tree (the final selection in your menu, which then jumps to your results). This allows you to set-up a category list on another page than the results.

=== Templates ===
* filter_default.tpl => default for Catalog Filter
* filter_widgets.tpl => empty template with debug to show how to build your own filter with Catalog Filter

[[File:catalog_ex-filter.jpg]]

=== Catalog List ===

* Select which the order and visibility of listed fields
* Supports a custom WHERE clause to exclude/include regardless of above filter specs (e.g. archived!=1 AND published=1). [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Supports a custom default ORDER BY clause, which is replace by the sort order
* Set the Query Mode (AND/OR)
* Set the Tags Mode (AND/OR)
* Select which fields are searched when search string is provided
* Enable Conditional listing mode, where nothing is listed until the filter conditions are fulfilled, e.g. both Genre AND Formats chosen, then the list is shown
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== NOTE ===
* Must be on the same page as the Catalog Filter module above to respond to the active filters
* List Module is SEO-bases and supports paging (which is NOT SEO)

=== Templates ===
* catalog_simpletable.tpl => simulates the Listing module (to a degree)
* catalog_simple.tpl => use with Catalog Listing (mainly)

[[File:catalog-list.jpg]]

=== Catalog Reader ===

* Select which the order and visibility of listed fields
* Catalog Reader Module is placed on the [[JumpTo]] page (just like News), configured in the back-end catalog
* replaces page title with _title_ if defined as catalog field
* Adds a reference variable to the items array so you can output the referenced catalog's info
* Above reference now also checks if reference is another catalog and provides a jumpTo URL (link and id) so users can jump to another category's detailed description.

=== Templates ===
* catalog_full.tpl => use with Catalog Reader (mainly)
* catalog_full_ref.tpl => use with Catalog Reader (with select/tag referenced array example)

=== Catalog Notify ===

* Add simple form fields with only text headings -- all fields are required!
* You can disable the security question
* Enter the Notification Subject -- this can contain catalog item field references, e.g. _{{catalog::fieldname}}_
* You can add multiple recipients in a list
* Enter the Body Text of the e-mail, which can contain 2 special variables: _##catalog##_ (the catalog name) and _##link##_ which creates hyperlink text to the current catalog item. You can also use the above catalog item field references, e.g. _{{catalog::fieldname}}_

=== NOTE ===
* This module must be on the same page as the Catalog Reader module as it also refers to a single catalog item

=== Templates ===
* mod_catalognotify.tpl => creates the form and submit button, and displays the "received" message

[[File:catalog-notify.jpg]]

In the Front-End, this is what it looks like:

[[File:catalog-notify-fe.jpg]]

=== Catalog Featured ===

* Select which the order and visibility of listed fields
* Custom where clause [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

[[File:catalog-featured.jpg]]

=== Catalog Related ===

This module provides a way to (randomly) list items with similar specification/fields to the currently viewed catalog item. Example: View other "Action Adventure" games where this related [genre] field matched.

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select which the order and visibility of listed fields
* Select the related fields that must match with the current viewed catalog item
* Custom condition (WHERE) clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own ORDER by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== Catalog Reference ===

This module provides a way to (randomly) list child table items where a selected field matches the currently viewed parent catalog item. Example: List all items from the (child) Games Catalog where the currently viewed reference (parent) Region Catalog item matches on the selected reference field [region].

<code>
This module is intended to be used on a Catalog Reader Page.
</code>

* Select the Catalog to list items from (child records)
* Select the reference field to which the ID must match with the currently viewed item with catalog reader.
* Select the current catalog being viewed in the Catalog Reader module (parent item).
* Select the catalog layout template
* Select which the order and visibility of listed fields
* Custom where clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

You can also use the [#CatalogInsertTags Catalog [[InsertTags]]] as specified above in Catalog Related.

[[File:catalog-reference.jpg]]

== Catalog [[InsertTags]] ==

Its also possible to add custom parameters retrieved from the current catalog item as Catalog [[InsertTags]] in the custom condition (WHERE) and ordering (ORDER) boxes. See the image below for a more complete example using a price bracket and using date calculations compared to the current date. The general format to use the currently viewed catalog item's values is:
_{{catalog::fieldname}}_ will return the field's value

[[File:catalog_ex-related.jpg]]

== Tips & Tricks ==

Several tips and tricks are listed below.

=== Custom Condition ===

You can set-up complex custom conditions using the [#CatalogInsertTags Catalog [[InsertTags]]] above as well as regular [EnglishInserttags TL [[InsertTags]]]. This will allow you to filter the current Catalog module by variables like date, time, and when placed on a Catalog Reader page, you can use the current items information to further filter the Featured, Related, Reference, etc. items.

[[File:catalog-conditionorder.jpg]]

=== Custom Ordering ===

You can also enter custom ordering clauses (Featured requires you to enable it first) to allow you to order the items in your own way. Here are some suggestions.

*Show the latest entered item first
<code>tstamp DESC</code>

* Show a (limited to 1) item randomly cached by the current day -- this usually only becomes useful when you also set: _Number of items = 1_. This will then remain the same item, until the next day. Kind of like a featured random item per day. This has an added benefit of being able to go back to specific day to see the "random" item for that day, just replace _CURDATE()_ with the actual date _2009-02-27_

<code>MD5(CONCAT(CURDATE(),id))</code>

Contao.Dev ExtensionsCatalogExt

2011-12-22T15:58:07Z

Dolores: /* Catalog Extension */

{{stub}}

[PageOutline(1-4, Table of Contents)]

= Catalog Extension =

<code>
The Catalog and Catalog Extension modules are advanced modules and will require intermediate knowledge of PHP, HTML/CSS in order to create catalog that displays the way you really need it. To create advanced displays, you will need to understand PHP array structures provided in the TPL files.
*NOTE: This is not a module for beginners*.
</code>
<code>
The Catalog module is a simple stop-gap to assist beginners with quickly getting up a custom application without having to write any code. However, the Catalog module is obviously NOT capable of working for all situations, at some point you have to get yourself dirty with PHP programming and just write your own TL applicationa, which is a bit of work and a lot of files, but easier than you might think.
</code>

The documentation below only explains how to configure the [[CatalogExt]] Front-End modules (see reference links below).

== Reference Links ==

* [ExtensionsCatalog Configuring the Catalog] -- should be done before reading this section
* [TutorialsCatalog Catalog Templates Tutotial] explains advanced template customisation
* [TutorialsCatalogMultiLanguage Catalog Multi-Language Tutorial] explains how to easily set-up multi-language catalogs

== Summary ==

Once you've setup a Catalog in the back-end, you can use the Catalog Extension to add more features and to build the front-end with the following modules:

* Catalog Filter Module: build your filter on field values, range, date, search.
* Catalog List Module: displays a list of items responding to the filter above.
* Catalog Reader: displays item detail view + reference info (jump links to other catalogs).
* Catalog Notify: creates contact form for clients to send contact info on catalog item (used on reader page)
* Catalog Featured: selectable number of (random) items filtered by a preset condition.
* Catalog Related: show related catalog items (except current) with selectable matching parameters.
* Catalog Reference: show child catalog items where a selected reference field is matching the current viewed parent item.

== Front-end Display Modules ==

To better understand the Front-End (FE) Modules, the following two diagrams will illustrate the two-page approach.

=== Catalog List Page ===

[[File:catalog-list-use.jpg]]

=== Catalog Reader Page ===

[[File:catalog-reader-usage.jpg]]

=== Catalog Filter ===

* Filter Module is simple point-and-click form builder
* Almost all fields can be used as a filtered list, except URL, FILE (these were too difficult to achieve successfully) and LONGTEXT (as a dropdown with lots of rich text won't be of any value)
* Each field can now be ordered and separately changed to: none, links list, radio, select drop-down
* Set-up a Field Filter Tree with auto-hide children and children become self-filtered by parents. This is ideal for situations like: Area, City (click on area and it only shows cities in that area)
* Tags can be set to display as multiple selects (radio becomes a checkbox control, and select becomes a multi-select)
* Date filter section, order and chose which date fields and the types or past periods (day, week, month, 6 months or year)
* As this is a separate module, you can place the filter in the right/left nav bar, but it must appear on the same page as the Catalog List module to create the filter URL for the list module to respond
* Multiple catalog filters are supported on the same page, each can display only a certain part, e.g. one for filter on 1 field to create categories, another for the search and other filter specs in the right nav.
* You can also set-up a [[JumpTo]] page, to which the filter will jump when clicked on a filter field, range, date, search or sort field. [[JumpTo]] is also Filter Tree View aware, e.g. it does not jump unless you are clicking on the last field in the filter tree (the final selection in your menu, which then jumps to your results). This allows you to set-up a category list on another page than the results.

=== Templates ===
* filter_default.tpl => default for Catalog Filter
* filter_widgets.tpl => empty template with debug to show how to build your own filter with Catalog Filter

[[File:catalog_ex-filter.jpg]]

=== Catalog List ===

* Select which the order and visibility of listed fields
* Supports a custom WHERE clause to exclude/include regardless of above filter specs (e.g. archived!=1 AND published=1). [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Supports a custom default ORDER BY clause, which is replace by the sort order
* Set the Query Mode (AND/OR)
* Set the Tags Mode (AND/OR)
* Select which fields are searched when search string is provided
* Enable Conditional listing mode, where nothing is listed until the filter conditions are fulfilled, e.g. both Genre AND Formats chosen, then the list is shown
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== NOTE ===
* Must be on the same page as the Catalog Filter module above to respond to the active filters
* List Module is SEO-bases and supports paging (which is NOT SEO)

=== Templates ===
* catalog_simpletable.tpl => simulates the Listing module (to a degree)
* catalog_simple.tpl => use with Catalog Listing (mainly)

[[File:catalog-list.jpg]]

=== Catalog Reader ===

* Select which the order and visibility of listed fields
* Catalog Reader Module is placed on the [[JumpTo]] page (just like News), configured in the back-end catalog
* replaces page title with _title_ if defined as catalog field
* Adds a reference variable to the items array so you can output the referenced catalog's info
* Above reference now also checks if reference is another catalog and provides a jumpTo URL (link and id) so users can jump to another category's detailed description.

=== Templates ===
* catalog_full.tpl => use with Catalog Reader (mainly)
* catalog_full_ref.tpl => use with Catalog Reader (with select/tag referenced array example)

=== Catalog Notify ===

* Add simple form fields with only text headings -- all fields are required!
* You can disable the security question
* Enter the Notification Subject -- this can contain catalog item field references, e.g. _{{catalog::fieldname}}_
* You can add multiple recipients in a list
* Enter the Body Text of the e-mail, which can contain 2 special variables: _##catalog##_ (the catalog name) and _##link##_ which creates hyperlink text to the current catalog item. You can also use the above catalog item field references, e.g. _{{catalog::fieldname}}_

=== NOTE ===
* This module must be on the same page as the Catalog Reader module as it also refers to a single catalog item

=== Templates ===
* mod_catalognotify.tpl => creates the form and submit button, and displays the "received" message

[[File:catalog-notify.jpg]]

In the Front-End, this is what it looks like:

[[File:catalog-notify-fe.jpg]]

=== Catalog Featured ===

* Select which the order and visibility of listed fields
* Custom where clause [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

[[File:catalog-featured.jpg]]

=== Catalog Related ===

This module provides a way to (randomly) list items with similar specification/fields to the currently viewed catalog item. Example: View other "Action Adventure" games where this related [genre] field matched.

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select which the order and visibility of listed fields
* Select the related fields that must match with the current viewed catalog item
* Custom condition (WHERE) clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own ORDER by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== Catalog Reference ===

This module provides a way to (randomly) list child table items where a selected field matches the currently viewed parent catalog item. Example: List all items from the (child) Games Catalog where the currently viewed reference (parent) Region Catalog item matches on the selected reference field [region].

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select the Catalog to list items from (child records)
* Select the reference field to which the ID must match with the currently viewed item with catalog reader.
* Select the current catalog being viewed in the Catalog Reader module (parent item).
* Select the catalog layout template
* Select which the order and visibility of listed fields
* Custom where clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

You can also use the [#CatalogInsertTags Catalog [[InsertTags]]] as specified above in Catalog Related.

[[File:catalog-reference.jpg]]

== Catalog [[InsertTags]] ==

Its also possible to add custom parameters retrieved from the current catalog item as Catalog [[InsertTags]] in the custom condition (WHERE) and ordering (ORDER) boxes. See the image below for a more complete example using a price bracket and using date calculations compared to the current date. The general format to use the currently viewed catalog item's values is:
_{{catalog::fieldname}}_ will return the field's value

[[File:catalog_ex-related.jpg]]

== Tips & Tricks ==

Several tips and tricks are listed below.

=== Custom Condition ===

You can set-up complex custom conditions using the [#CatalogInsertTags Catalog [[InsertTags]]] above as well as regular [EnglishInserttags TL [[InsertTags]]]. This will allow you to filter the current Catalog module by variables like date, time, and when placed on a Catalog Reader page, you can use the current items information to further filter the Featured, Related, Reference, etc. items.

[[File:catalog-conditionorder.jpg]]

=== Custom Ordering ===

You can also enter custom ordering clauses (Featured requires you to enable it first) to allow you to order the items in your own way. Here are some suggestions.

*Show the latest entered item first
<code>tstamp DESC</code>

* Show a (limited to 1) item randomly cached by the current day -- this usually only becomes useful when you also set: _Number of items = 1_. This will then remain the same item, until the next day. Kind of like a featured random item per day. This has an added benefit of being able to go back to specific day to see the "random" item for that day, just replace _CURDATE()_ with the actual date _2009-02-27_

<code>MD5(CONCAT(CURDATE(),id))</code>

Contao.Dev ExtensionsCatalogExt

2011-12-22T15:56:14Z

Dolores: /* Custom Ordering */

{{stub}}

[PageOutline(1-4, Table of Contents)]

= Catalog Extension =

<pre>
<code class="div">
The Catalog and Catalog Extension modules are advanced modules and will require intermediate knowledge of PHP, HTML/CSS in order to create catalog that displays the way you really need it. To create advanced displays, you will need to understand PHP array structures provided in the TPL files.
*NOTE: This is not a module for beginners*.
</code></pre>

<pre>
<code class="div">
The Catalog module is a simple stop-gap to assist beginners with quickly getting up a custom application without having to write any code. However, the Catalog module is obviously NOT capable of working for all situations, at some point you have to get yourself dirty with PHP programming and just write your own TL applicationa, which is a bit of work and a lot of files, but easier than you might think.
</code></pre>

The documentation below only explains how to configure the [[CatalogExt]] Front-End modules (see reference links below).

== Reference Links ==

* [ExtensionsCatalog Configuring the Catalog] -- should be done before reading this section
* [TutorialsCatalog Catalog Templates Tutotial] explains advanced template customisation
* [TutorialsCatalogMultiLanguage Catalog Multi-Language Tutorial] explains how to easily set-up multi-language catalogs

== Summary ==

Once you've setup a Catalog in the back-end, you can use the Catalog Extension to add more features and to build the front-end with the following modules:

* Catalog Filter Module: build your filter on field values, range, date, search.
* Catalog List Module: displays a list of items responding to the filter above.
* Catalog Reader: displays item detail view + reference info (jump links to other catalogs).
* Catalog Notify: creates contact form for clients to send contact info on catalog item (used on reader page)
* Catalog Featured: selectable number of (random) items filtered by a preset condition.
* Catalog Related: show related catalog items (except current) with selectable matching parameters.
* Catalog Reference: show child catalog items where a selected reference field is matching the current viewed parent item.

== Front-end Display Modules ==

To better understand the Front-End (FE) Modules, the following two diagrams will illustrate the two-page approach.

=== Catalog List Page ===

[[File:catalog-list-use.jpg]]

=== Catalog Reader Page ===

[[File:catalog-reader-usage.jpg]]

=== Catalog Filter ===

* Filter Module is simple point-and-click form builder
* Almost all fields can be used as a filtered list, except URL, FILE (these were too difficult to achieve successfully) and LONGTEXT (as a dropdown with lots of rich text won't be of any value)
* Each field can now be ordered and separately changed to: none, links list, radio, select drop-down
* Set-up a Field Filter Tree with auto-hide children and children become self-filtered by parents. This is ideal for situations like: Area, City (click on area and it only shows cities in that area)
* Tags can be set to display as multiple selects (radio becomes a checkbox control, and select becomes a multi-select)
* Date filter section, order and chose which date fields and the types or past periods (day, week, month, 6 months or year)
* As this is a separate module, you can place the filter in the right/left nav bar, but it must appear on the same page as the Catalog List module to create the filter URL for the list module to respond
* Multiple catalog filters are supported on the same page, each can display only a certain part, e.g. one for filter on 1 field to create categories, another for the search and other filter specs in the right nav.
* You can also set-up a [[JumpTo]] page, to which the filter will jump when clicked on a filter field, range, date, search or sort field. [[JumpTo]] is also Filter Tree View aware, e.g. it does not jump unless you are clicking on the last field in the filter tree (the final selection in your menu, which then jumps to your results). This allows you to set-up a category list on another page than the results.

=== Templates ===
* filter_default.tpl => default for Catalog Filter
* filter_widgets.tpl => empty template with debug to show how to build your own filter with Catalog Filter

[[File:catalog_ex-filter.jpg]]

=== Catalog List ===

* Select which the order and visibility of listed fields
* Supports a custom WHERE clause to exclude/include regardless of above filter specs (e.g. archived!=1 AND published=1). [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Supports a custom default ORDER BY clause, which is replace by the sort order
* Set the Query Mode (AND/OR)
* Set the Tags Mode (AND/OR)
* Select which fields are searched when search string is provided
* Enable Conditional listing mode, where nothing is listed until the filter conditions are fulfilled, e.g. both Genre AND Formats chosen, then the list is shown
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== NOTE ===
* Must be on the same page as the Catalog Filter module above to respond to the active filters
* List Module is SEO-bases and supports paging (which is NOT SEO)

=== Templates ===
* catalog_simpletable.tpl => simulates the Listing module (to a degree)
* catalog_simple.tpl => use with Catalog Listing (mainly)

[[File:catalog-list.jpg]]

=== Catalog Reader ===

* Select which the order and visibility of listed fields
* Catalog Reader Module is placed on the [[JumpTo]] page (just like News), configured in the back-end catalog
* replaces page title with _title_ if defined as catalog field
* Adds a reference variable to the items array so you can output the referenced catalog's info
* Above reference now also checks if reference is another catalog and provides a jumpTo URL (link and id) so users can jump to another category's detailed description.

=== Templates ===
* catalog_full.tpl => use with Catalog Reader (mainly)
* catalog_full_ref.tpl => use with Catalog Reader (with select/tag referenced array example)

=== Catalog Notify ===

* Add simple form fields with only text headings -- all fields are required!
* You can disable the security question
* Enter the Notification Subject -- this can contain catalog item field references, e.g. _{{catalog::fieldname}}_
* You can add multiple recipients in a list
* Enter the Body Text of the e-mail, which can contain 2 special variables: _##catalog##_ (the catalog name) and _##link##_ which creates hyperlink text to the current catalog item. You can also use the above catalog item field references, e.g. _{{catalog::fieldname}}_

=== NOTE ===
* This module must be on the same page as the Catalog Reader module as it also refers to a single catalog item

=== Templates ===
* mod_catalognotify.tpl => creates the form and submit button, and displays the "received" message

[[File:catalog-notify.jpg]]

In the Front-End, this is what it looks like:

[[File:catalog-notify-fe.jpg]]

=== Catalog Featured ===

* Select which the order and visibility of listed fields
* Custom where clause [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

[[File:catalog-featured.jpg]]

=== Catalog Related ===

This module provides a way to (randomly) list items with similar specification/fields to the currently viewed catalog item. Example: View other "Action Adventure" games where this related [genre] field matched.

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select which the order and visibility of listed fields
* Select the related fields that must match with the current viewed catalog item
* Custom condition (WHERE) clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own ORDER by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== Catalog Reference ===

This module provides a way to (randomly) list child table items where a selected field matches the currently viewed parent catalog item. Example: List all items from the (child) Games Catalog where the currently viewed reference (parent) Region Catalog item matches on the selected reference field [region].

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select the Catalog to list items from (child records)
* Select the reference field to which the ID must match with the currently viewed item with catalog reader.
* Select the current catalog being viewed in the Catalog Reader module (parent item).
* Select the catalog layout template
* Select which the order and visibility of listed fields
* Custom where clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

You can also use the [#CatalogInsertTags Catalog [[InsertTags]]] as specified above in Catalog Related.

[[File:catalog-reference.jpg]]

== Catalog [[InsertTags]] ==

Its also possible to add custom parameters retrieved from the current catalog item as Catalog [[InsertTags]] in the custom condition (WHERE) and ordering (ORDER) boxes. See the image below for a more complete example using a price bracket and using date calculations compared to the current date. The general format to use the currently viewed catalog item's values is:
_{{catalog::fieldname}}_ will return the field's value

[[File:catalog_ex-related.jpg]]

== Tips & Tricks ==

Several tips and tricks are listed below.

=== Custom Condition ===

You can set-up complex custom conditions using the [#CatalogInsertTags Catalog [[InsertTags]]] above as well as regular [EnglishInserttags TL [[InsertTags]]]. This will allow you to filter the current Catalog module by variables like date, time, and when placed on a Catalog Reader page, you can use the current items information to further filter the Featured, Related, Reference, etc. items.

[[File:catalog-conditionorder.jpg]]

=== Custom Ordering ===

You can also enter custom ordering clauses (Featured requires you to enable it first) to allow you to order the items in your own way. Here are some suggestions.

*Show the latest entered item first
<code>tstamp DESC</code>

* Show a (limited to 1) item randomly cached by the current day -- this usually only becomes useful when you also set: _Number of items = 1_. This will then remain the same item, until the next day. Kind of like a featured random item per day. This has an added benefit of being able to go back to specific day to see the "random" item for that day, just replace _CURDATE()_ with the actual date _2009-02-27_

<code>MD5(CONCAT(CURDATE(),id))</code>

Contao.Dev ExtensionsCatalogExt

2011-12-22T09:03:01Z

Dolores: /* Catalog Related */

{{stub}}

[PageOutline(1-4, Table of Contents)]

= Catalog Extension =

<pre>
<code class="div">
The Catalog and Catalog Extension modules are advanced modules and will require intermediate knowledge of PHP, HTML/CSS in order to create catalog that displays the way you really need it. To create advanced displays, you will need to understand PHP array structures provided in the TPL files.
*NOTE: This is not a module for beginners*.
</code></pre>

<pre>
<code class="div">
The Catalog module is a simple stop-gap to assist beginners with quickly getting up a custom application without having to write any code. However, the Catalog module is obviously NOT capable of working for all situations, at some point you have to get yourself dirty with PHP programming and just write your own TL applicationa, which is a bit of work and a lot of files, but easier than you might think.
</code></pre>

The documentation below only explains how to configure the [[CatalogExt]] Front-End modules (see reference links below).

== Reference Links ==

* [ExtensionsCatalog Configuring the Catalog] -- should be done before reading this section
* [TutorialsCatalog Catalog Templates Tutotial] explains advanced template customisation
* [TutorialsCatalogMultiLanguage Catalog Multi-Language Tutorial] explains how to easily set-up multi-language catalogs

== Summary ==

Once you've setup a Catalog in the back-end, you can use the Catalog Extension to add more features and to build the front-end with the following modules:

* Catalog Filter Module: build your filter on field values, range, date, search.
* Catalog List Module: displays a list of items responding to the filter above.
* Catalog Reader: displays item detail view + reference info (jump links to other catalogs).
* Catalog Notify: creates contact form for clients to send contact info on catalog item (used on reader page)
* Catalog Featured: selectable number of (random) items filtered by a preset condition.
* Catalog Related: show related catalog items (except current) with selectable matching parameters.
* Catalog Reference: show child catalog items where a selected reference field is matching the current viewed parent item.

== Front-end Display Modules ==

To better understand the Front-End (FE) Modules, the following two diagrams will illustrate the two-page approach.

=== Catalog List Page ===

[[File:catalog-list-use.jpg]]

=== Catalog Reader Page ===

[[File:catalog-reader-usage.jpg]]

=== Catalog Filter ===

* Filter Module is simple point-and-click form builder
* Almost all fields can be used as a filtered list, except URL, FILE (these were too difficult to achieve successfully) and LONGTEXT (as a dropdown with lots of rich text won't be of any value)
* Each field can now be ordered and separately changed to: none, links list, radio, select drop-down
* Set-up a Field Filter Tree with auto-hide children and children become self-filtered by parents. This is ideal for situations like: Area, City (click on area and it only shows cities in that area)
* Tags can be set to display as multiple selects (radio becomes a checkbox control, and select becomes a multi-select)
* Date filter section, order and chose which date fields and the types or past periods (day, week, month, 6 months or year)
* As this is a separate module, you can place the filter in the right/left nav bar, but it must appear on the same page as the Catalog List module to create the filter URL for the list module to respond
* Multiple catalog filters are supported on the same page, each can display only a certain part, e.g. one for filter on 1 field to create categories, another for the search and other filter specs in the right nav.
* You can also set-up a [[JumpTo]] page, to which the filter will jump when clicked on a filter field, range, date, search or sort field. [[JumpTo]] is also Filter Tree View aware, e.g. it does not jump unless you are clicking on the last field in the filter tree (the final selection in your menu, which then jumps to your results). This allows you to set-up a category list on another page than the results.

=== Templates ===
* filter_default.tpl => default for Catalog Filter
* filter_widgets.tpl => empty template with debug to show how to build your own filter with Catalog Filter

[[File:catalog_ex-filter.jpg]]

=== Catalog List ===

* Select which the order and visibility of listed fields
* Supports a custom WHERE clause to exclude/include regardless of above filter specs (e.g. archived!=1 AND published=1). [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Supports a custom default ORDER BY clause, which is replace by the sort order
* Set the Query Mode (AND/OR)
* Set the Tags Mode (AND/OR)
* Select which fields are searched when search string is provided
* Enable Conditional listing mode, where nothing is listed until the filter conditions are fulfilled, e.g. both Genre AND Formats chosen, then the list is shown
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== NOTE ===
* Must be on the same page as the Catalog Filter module above to respond to the active filters
* List Module is SEO-bases and supports paging (which is NOT SEO)

=== Templates ===
* catalog_simpletable.tpl => simulates the Listing module (to a degree)
* catalog_simple.tpl => use with Catalog Listing (mainly)

[[File:catalog-list.jpg]]

=== Catalog Reader ===

* Select which the order and visibility of listed fields
* Catalog Reader Module is placed on the [[JumpTo]] page (just like News), configured in the back-end catalog
* replaces page title with _title_ if defined as catalog field
* Adds a reference variable to the items array so you can output the referenced catalog's info
* Above reference now also checks if reference is another catalog and provides a jumpTo URL (link and id) so users can jump to another category's detailed description.

=== Templates ===
* catalog_full.tpl => use with Catalog Reader (mainly)
* catalog_full_ref.tpl => use with Catalog Reader (with select/tag referenced array example)

=== Catalog Notify ===

* Add simple form fields with only text headings -- all fields are required!
* You can disable the security question
* Enter the Notification Subject -- this can contain catalog item field references, e.g. _{{catalog::fieldname}}_
* You can add multiple recipients in a list
* Enter the Body Text of the e-mail, which can contain 2 special variables: _##catalog##_ (the catalog name) and _##link##_ which creates hyperlink text to the current catalog item. You can also use the above catalog item field references, e.g. _{{catalog::fieldname}}_

=== NOTE ===
* This module must be on the same page as the Catalog Reader module as it also refers to a single catalog item

=== Templates ===
* mod_catalognotify.tpl => creates the form and submit button, and displays the "received" message

[[File:catalog-notify.jpg]]

In the Front-End, this is what it looks like:

[[File:catalog-notify-fe.jpg]]

=== Catalog Featured ===

* Select which the order and visibility of listed fields
* Custom where clause [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

[[File:catalog-featured.jpg]]

=== Catalog Related ===

This module provides a way to (randomly) list items with similar specification/fields to the currently viewed catalog item. Example: View other "Action Adventure" games where this related [genre] field matched.

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select which the order and visibility of listed fields
* Select the related fields that must match with the current viewed catalog item
* Custom condition (WHERE) clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own ORDER by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== Catalog Reference ===

This module provides a way to (randomly) list child table items where a selected field matches the currently viewed parent catalog item. Example: List all items from the (child) Games Catalog where the currently viewed reference (parent) Region Catalog item matches on the selected reference field [region].

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select the Catalog to list items from (child records)
* Select the reference field to which the ID must match with the currently viewed item with catalog reader.
* Select the current catalog being viewed in the Catalog Reader module (parent item).
* Select the catalog layout template
* Select which the order and visibility of listed fields
* Custom where clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

You can also use the [#CatalogInsertTags Catalog [[InsertTags]]] as specified above in Catalog Related.

[[File:catalog-reference.jpg]]

== Catalog [[InsertTags]] ==

Its also possible to add custom parameters retrieved from the current catalog item as Catalog [[InsertTags]] in the custom condition (WHERE) and ordering (ORDER) boxes. See the image below for a more complete example using a price bracket and using date calculations compared to the current date. The general format to use the currently viewed catalog item's values is:
_{{catalog::fieldname}}_ will return the field's value

[[File:catalog_ex-related.jpg]]

== Tips & Tricks ==

Several tips and tricks are listed below.

=== Custom Condition ===

You can set-up complex custom conditions using the [#CatalogInsertTags Catalog [[InsertTags]]] above as well as regular [EnglishInserttags TL [[InsertTags]]]. This will allow you to filter the current Catalog module by variables like date, time, and when placed on a Catalog Reader page, you can use the current items information to further filter the Featured, Related, Reference, etc. items.

[[File:catalog-conditionorder.jpg]]

=== Custom Ordering ===

You can also enter custom ordering clauses (Featured requires you to enable it first) to allow you to order the items in your own way. Here are some suggestions.

* Show the latest entered item first
<pre>
tstamp DESC
</code></pre>

* Show a (limited to 1) item randomly cached by the current day -- this usually only becomes useful when you also set: _Number of items = 1_. This will then remain the same item, until the next day. Kind of like a featured random item per day. This has an added benefit of being able to go back to specific day to see the "random" item for that day, just replace _CURDATE()_ with the actual date _2009-02-27_
<pre>
MD5(CONCAT(CURDATE(),id))
</code></pre>

Contao.Dev ExtensionsCatalogExt

2011-12-22T09:01:52Z

Dolores: /* Front-end Display Modules */

{{stub}}

[PageOutline(1-4, Table of Contents)]

= Catalog Extension =

<pre>
<code class="div">
The Catalog and Catalog Extension modules are advanced modules and will require intermediate knowledge of PHP, HTML/CSS in order to create catalog that displays the way you really need it. To create advanced displays, you will need to understand PHP array structures provided in the TPL files.
*NOTE: This is not a module for beginners*.
</code></pre>

<pre>
<code class="div">
The Catalog module is a simple stop-gap to assist beginners with quickly getting up a custom application without having to write any code. However, the Catalog module is obviously NOT capable of working for all situations, at some point you have to get yourself dirty with PHP programming and just write your own TL applicationa, which is a bit of work and a lot of files, but easier than you might think.
</code></pre>

The documentation below only explains how to configure the [[CatalogExt]] Front-End modules (see reference links below).

== Reference Links ==

* [ExtensionsCatalog Configuring the Catalog] -- should be done before reading this section
* [TutorialsCatalog Catalog Templates Tutotial] explains advanced template customisation
* [TutorialsCatalogMultiLanguage Catalog Multi-Language Tutorial] explains how to easily set-up multi-language catalogs

== Summary ==

Once you've setup a Catalog in the back-end, you can use the Catalog Extension to add more features and to build the front-end with the following modules:

* Catalog Filter Module: build your filter on field values, range, date, search.
* Catalog List Module: displays a list of items responding to the filter above.
* Catalog Reader: displays item detail view + reference info (jump links to other catalogs).
* Catalog Notify: creates contact form for clients to send contact info on catalog item (used on reader page)
* Catalog Featured: selectable number of (random) items filtered by a preset condition.
* Catalog Related: show related catalog items (except current) with selectable matching parameters.
* Catalog Reference: show child catalog items where a selected reference field is matching the current viewed parent item.

== Front-end Display Modules ==

To better understand the Front-End (FE) Modules, the following two diagrams will illustrate the two-page approach.

=== Catalog List Page ===

[[File:catalog-list-use.jpg]]

=== Catalog Reader Page ===

[[File:catalog-reader-usage.jpg]]

=== Catalog Filter ===

* Filter Module is simple point-and-click form builder
* Almost all fields can be used as a filtered list, except URL, FILE (these were too difficult to achieve successfully) and LONGTEXT (as a dropdown with lots of rich text won't be of any value)
* Each field can now be ordered and separately changed to: none, links list, radio, select drop-down
* Set-up a Field Filter Tree with auto-hide children and children become self-filtered by parents. This is ideal for situations like: Area, City (click on area and it only shows cities in that area)
* Tags can be set to display as multiple selects (radio becomes a checkbox control, and select becomes a multi-select)
* Date filter section, order and chose which date fields and the types or past periods (day, week, month, 6 months or year)
* As this is a separate module, you can place the filter in the right/left nav bar, but it must appear on the same page as the Catalog List module to create the filter URL for the list module to respond
* Multiple catalog filters are supported on the same page, each can display only a certain part, e.g. one for filter on 1 field to create categories, another for the search and other filter specs in the right nav.
* You can also set-up a [[JumpTo]] page, to which the filter will jump when clicked on a filter field, range, date, search or sort field. [[JumpTo]] is also Filter Tree View aware, e.g. it does not jump unless you are clicking on the last field in the filter tree (the final selection in your menu, which then jumps to your results). This allows you to set-up a category list on another page than the results.

=== Templates ===
* filter_default.tpl => default for Catalog Filter
* filter_widgets.tpl => empty template with debug to show how to build your own filter with Catalog Filter

[[File:catalog_ex-filter.jpg]]

=== Catalog List ===

* Select which the order and visibility of listed fields
* Supports a custom WHERE clause to exclude/include regardless of above filter specs (e.g. archived!=1 AND published=1). [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Supports a custom default ORDER BY clause, which is replace by the sort order
* Set the Query Mode (AND/OR)
* Set the Tags Mode (AND/OR)
* Select which fields are searched when search string is provided
* Enable Conditional listing mode, where nothing is listed until the filter conditions are fulfilled, e.g. both Genre AND Formats chosen, then the list is shown
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== NOTE ===
* Must be on the same page as the Catalog Filter module above to respond to the active filters
* List Module is SEO-bases and supports paging (which is NOT SEO)

=== Templates ===
* catalog_simpletable.tpl => simulates the Listing module (to a degree)
* catalog_simple.tpl => use with Catalog Listing (mainly)

[[File:catalog-list.jpg]]

=== Catalog Reader ===

* Select which the order and visibility of listed fields
* Catalog Reader Module is placed on the [[JumpTo]] page (just like News), configured in the back-end catalog
* replaces page title with _title_ if defined as catalog field
* Adds a reference variable to the items array so you can output the referenced catalog's info
* Above reference now also checks if reference is another catalog and provides a jumpTo URL (link and id) so users can jump to another category's detailed description.

=== Templates ===
* catalog_full.tpl => use with Catalog Reader (mainly)
* catalog_full_ref.tpl => use with Catalog Reader (with select/tag referenced array example)

=== Catalog Notify ===

* Add simple form fields with only text headings -- all fields are required!
* You can disable the security question
* Enter the Notification Subject -- this can contain catalog item field references, e.g. _{{catalog::fieldname}}_
* You can add multiple recipients in a list
* Enter the Body Text of the e-mail, which can contain 2 special variables: _##catalog##_ (the catalog name) and _##link##_ which creates hyperlink text to the current catalog item. You can also use the above catalog item field references, e.g. _{{catalog::fieldname}}_

=== NOTE ===
* This module must be on the same page as the Catalog Reader module as it also refers to a single catalog item

=== Templates ===
* mod_catalognotify.tpl => creates the form and submit button, and displays the "received" message

[[File:catalog-notify.jpg]]

In the Front-End, this is what it looks like:

[[File:catalog-notify-fe.jpg]]

=== Catalog Featured ===

* Select which the order and visibility of listed fields
* Custom where clause [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

[[File:catalog-featured.jpg]]

=== Catalog Related ===

This module provides a way to (randomly) list items with similar specification/fields to the currently viewed catalog item. Example: View other "Action Adventure" games where this related [genre] field matched.

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select which the order and visibility of listed fields
* Select the related fields that must match with the current viewed catalog item
* Custom condition (WHERE) clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own ORDER by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== Catalog Reference ===

This module provides a way to (randomly) list child table items where a selected field matches the currently viewed parent catalog item. Example: List all items from the (child) Games Catalog where the currently viewed reference (parent) Region Catalog item matches on the selected reference field [region].

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select the Catalog to list items from (child records)
* Select the reference field to which the ID must match with the currently viewed item with catalog reader.
* Select the current catalog being viewed in the Catalog Reader module (parent item).
* Select the catalog layout template
* Select which the order and visibility of listed fields
* Custom where clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

You can also use the [#CatalogInsertTags Catalog [[InsertTags]]] as specified above in Catalog Related.

[[File:catalog-reference.jpg]]

== Catalog [[InsertTags]] ==

Its also possible to add custom parameters retrieved from the current catalog item as Catalog [[InsertTags]] in the custom condition (WHERE) and ordering (ORDER) boxes. See the image below for a more complete example using a price bracket and using date calculations compared to the current date. The general format to use the currently viewed catalog item's values is:
_{{catalog::fieldname}}_ will return the field's value

[[File:catalog_ex-related.jpg]]

== Tips & Tricks ==

Several tips and tricks are listed below.

=== Custom Condition ===

You can set-up complex custom conditions using the [#CatalogInsertTags Catalog [[InsertTags]]] above as well as regular [EnglishInserttags TL [[InsertTags]]]. This will allow you to filter the current Catalog module by variables like date, time, and when placed on a Catalog Reader page, you can use the current items information to further filter the Featured, Related, Reference, etc. items.

[[File:catalog-conditionorder.jpg]]

=== Custom Ordering ===

You can also enter custom ordering clauses (Featured requires you to enable it first) to allow you to order the items in your own way. Here are some suggestions.

* Show the latest entered item first
<pre>
tstamp DESC
</code></pre>

* Show a (limited to 1) item randomly cached by the current day -- this usually only becomes useful when you also set: _Number of items = 1_. This will then remain the same item, until the next day. Kind of like a featured random item per day. This has an added benefit of being able to go back to specific day to see the "random" item for that day, just replace _CURDATE()_ with the actual date _2009-02-27_
<pre>
MD5(CONCAT(CURDATE(),id))
</code></pre>

Contao.Dev ExtensionsCatalogExt

2011-12-22T08:59:08Z

Dolores: /* Catalog Extension */

{{stub}}

[PageOutline(1-4, Table of Contents)]

= Catalog Extension =

<pre>
<code class="div">
The Catalog and Catalog Extension modules are advanced modules and will require intermediate knowledge of PHP, HTML/CSS in order to create catalog that displays the way you really need it. To create advanced displays, you will need to understand PHP array structures provided in the TPL files.
*NOTE: This is not a module for beginners*.
</code></pre>

<pre>
<code class="div">
The Catalog module is a simple stop-gap to assist beginners with quickly getting up a custom application without having to write any code. However, the Catalog module is obviously NOT capable of working for all situations, at some point you have to get yourself dirty with PHP programming and just write your own TL applicationa, which is a bit of work and a lot of files, but easier than you might think.
</code></pre>

The documentation below only explains how to configure the [[CatalogExt]] Front-End modules (see reference links below).

== Reference Links ==

* [ExtensionsCatalog Configuring the Catalog] -- should be done before reading this section
* [TutorialsCatalog Catalog Templates Tutotial] explains advanced template customisation
* [TutorialsCatalogMultiLanguage Catalog Multi-Language Tutorial] explains how to easily set-up multi-language catalogs

== Summary ==

Once you've setup a Catalog in the back-end, you can use the Catalog Extension to add more features and to build the front-end with the following modules:

* Catalog Filter Module: build your filter on field values, range, date, search.
* Catalog List Module: displays a list of items responding to the filter above.
* Catalog Reader: displays item detail view + reference info (jump links to other catalogs).
* Catalog Notify: creates contact form for clients to send contact info on catalog item (used on reader page)
* Catalog Featured: selectable number of (random) items filtered by a preset condition.
* Catalog Related: show related catalog items (except current) with selectable matching parameters.
* Catalog Reference: show child catalog items where a selected reference field is matching the current viewed parent item.

== Front-end Display Modules ==

To better understand the Front-End (FE) Modules, the following two diagrams will illustrate the two-page approach.

*Catalog List Page*

[[File:catalog-list-use.jpg]]

*Catalog Reader Page*

[[File:catalog-reader-usage.jpg]]

=== Catalog Filter ===

* Filter Module is simple point-and-click form builder
* Almost all fields can be used as a filtered list, except URL, FILE (these were too difficult to achieve successfully) and LONGTEXT (as a dropdown with lots of rich text won't be of any value)
* Each field can now be ordered and separately changed to: none, links list, radio, select drop-down
* Set-up a Field Filter Tree with auto-hide children and children become self-filtered by parents. This is ideal for situations like: Area, City (click on area and it only shows cities in that area)
* Tags can be set to display as multiple selects (radio becomes a checkbox control, and select becomes a multi-select)
* Date filter section, order and chose which date fields and the types or past periods (day, week, month, 6 months or year)
* As this is a separate module, you can place the filter in the right/left nav bar, but it must appear on the same page as the Catalog List module to create the filter URL for the list module to respond
* Multiple catalog filters are supported on the same page, each can display only a certain part, e.g. one for filter on 1 field to create categories, another for the search and other filter specs in the right nav.
* You can also set-up a [[JumpTo]] page, to which the filter will jump when clicked on a filter field, range, date, search or sort field. [[JumpTo]] is also Filter Tree View aware, e.g. it does not jump unless you are clicking on the last field in the filter tree (the final selection in your menu, which then jumps to your results). This allows you to set-up a category list on another page than the results.

*Templates*
* filter_default.tpl => default for Catalog Filter
* filter_widgets.tpl => empty template with debug to show how to build your own filter with Catalog Filter

[[File:catalog_ex-filter.jpg]]

=== Catalog List ===

* Select which the order and visibility of listed fields
* Supports a custom WHERE clause to exclude/include regardless of above filter specs (e.g. archived!=1 AND published=1). [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Supports a custom default ORDER BY clause, which is replace by the sort order
* Set the Query Mode (AND/OR)
* Set the Tags Mode (AND/OR)
* Select which fields are searched when search string is provided
* Enable Conditional listing mode, where nothing is listed until the filter conditions are fulfilled, e.g. both Genre AND Formats chosen, then the list is shown
* Thumbnails size override for one single image field and one multi image field with new size parameters

*NOTE:*
* Must be on the same page as the Catalog Filter module above to respond to the active filters
* List Module is SEO-bases and supports paging (which is NOT SEO)

*Templates*
* catalog_simpletable.tpl => simulates the Listing module (to a degree)
* catalog_simple.tpl => use with Catalog Listing (mainly)

[[File:catalog-list.jpg]]

=== Catalog Reader ===

* Select which the order and visibility of listed fields
* Catalog Reader Module is placed on the [[JumpTo]] page (just like News), configured in the back-end catalog
* replaces page title with _title_ if defined as catalog field
* Adds a reference variable to the items array so you can output the referenced catalog's info
* Above reference now also checks if reference is another catalog and provides a jumpTo URL (link and id) so users can jump to another category's detailed description.

*Templates*
* catalog_full.tpl => use with Catalog Reader (mainly)
* catalog_full_ref.tpl => use with Catalog Reader (with select/tag referenced array example)

=== Catalog Notify ===

* Add simple form fields with only text headings -- all fields are required!
* You can disable the security question
* Enter the Notification Subject -- this can contain catalog item field references, e.g. _{{catalog::fieldname}}_
* You can add multiple recipients in a list
* Enter the Body Text of the e-mail, which can contain 2 special variables: _##catalog##_ (the catalog name) and _##link##_ which creates hyperlink text to the current catalog item. You can also use the above catalog item field references, e.g. _{{catalog::fieldname}}_

*NOTE:*
* This module must be on the same page as the Catalog Reader module as it also refers to a single catalog item

*Templates*
* mod_catalognotify.tpl => creates the form and submit button, and displays the "received" message

[[File:catalog-notify.jpg]]

In the Front-End, this is what it looks like:

[[File:catalog-notify-fe.jpg]]

=== Catalog Featured ===

* Select which the order and visibility of listed fields
* Custom where clause [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

[[File:catalog-featured.jpg]]

=== Catalog Related ===

This module provides a way to (randomly) list items with similar specification/fields to the currently viewed catalog item. Example: View other "Action Adventure" games where this related [genre] field matched.

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select which the order and visibility of listed fields
* Select the related fields that must match with the current viewed catalog item
* Custom condition (WHERE) clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own ORDER by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== Catalog Reference ===

This module provides a way to (randomly) list child table items where a selected field matches the currently viewed parent catalog item. Example: List all items from the (child) Games Catalog where the currently viewed reference (parent) Region Catalog item matches on the selected reference field [region].

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select the Catalog to list items from (child records)
* Select the reference field to which the ID must match with the currently viewed item with catalog reader.
* Select the current catalog being viewed in the Catalog Reader module (parent item).
* Select the catalog layout template
* Select which the order and visibility of listed fields
* Custom where clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

You can also use the [#CatalogInsertTags Catalog [[InsertTags]]] as specified above in Catalog Related.

[[File:catalog-reference.jpg]]

== Catalog [[InsertTags]] ==

Its also possible to add custom parameters retrieved from the current catalog item as Catalog [[InsertTags]] in the custom condition (WHERE) and ordering (ORDER) boxes. See the image below for a more complete example using a price bracket and using date calculations compared to the current date. The general format to use the currently viewed catalog item's values is:
_{{catalog::fieldname}}_ will return the field's value

[[File:catalog_ex-related.jpg]]

== Tips & Tricks ==

Several tips and tricks are listed below.

=== Custom Condition ===

You can set-up complex custom conditions using the [#CatalogInsertTags Catalog [[InsertTags]]] above as well as regular [EnglishInserttags TL [[InsertTags]]]. This will allow you to filter the current Catalog module by variables like date, time, and when placed on a Catalog Reader page, you can use the current items information to further filter the Featured, Related, Reference, etc. items.

[[File:catalog-conditionorder.jpg]]

=== Custom Ordering ===

You can also enter custom ordering clauses (Featured requires you to enable it first) to allow you to order the items in your own way. Here are some suggestions.

* Show the latest entered item first
<pre>
tstamp DESC
</code></pre>

* Show a (limited to 1) item randomly cached by the current day -- this usually only becomes useful when you also set: _Number of items = 1_. This will then remain the same item, until the next day. Kind of like a featured random item per day. This has an added benefit of being able to go back to specific day to see the "random" item for that day, just replace _CURDATE()_ with the actual date _2009-02-27_
<pre>
MD5(CONCAT(CURDATE(),id))
</code></pre>

File:Catalog-conditionorder.jpg

2011-12-22T08:56:15Z

Dolores:

File:Catalog ex-related.jpg

2011-12-22T08:55:46Z

Dolores:

File:Catalog-reference.jpg

2011-12-22T08:54:41Z

Dolores:

File:Catalog-featured.jpg

2011-12-22T08:53:57Z

Dolores:

Contao.Dev ExtensionsCatalogExt

2011-12-22T08:53:08Z

Dolores:

{{stub}}

[PageOutline(1-4, Table of Contents)]

= Catalog Extension =

<pre>
<code class="div">
The Catalog and Catalog Extension modules are advanced modules and will require intermediate knowledge of PHP, HTML/CSS in order to create catalog that displays the way you really need it. To create advanced displays, you will need to understand PHP array structures provided in the TPL files.

*NOTE: This is not a module for beginners*.
</code></pre>

<pre>
<code class="div">
The Catalog module is a simple stop-gap to assist beginners with quickly getting up a custom application without having to write any code. However, the Catalog module is obviously NOT capable of working for all situations, at some point you have to get yourself dirty with PHP programming and just write your own TL applicationa, which is a bit of work and a lot of files, but easier than you might think.
</code></pre>

The documentation below only explains how to configure the [[CatalogExt]] Front-End modules (see reference links below).

== Reference Links ==

* [ExtensionsCatalog Configuring the Catalog] -- should be done before reading this section
* [TutorialsCatalog Catalog Templates Tutotial] explains advanced template customisation
* [TutorialsCatalogMultiLanguage Catalog Multi-Language Tutorial] explains how to easily set-up multi-language catalogs

== Summary ==

Once you've setup a Catalog in the back-end, you can use the Catalog Extension to add more features and to build the front-end with the following modules:

* Catalog Filter Module: build your filter on field values, range, date, search.
* Catalog List Module: displays a list of items responding to the filter above.
* Catalog Reader: displays item detail view + reference info (jump links to other catalogs).
* Catalog Notify: creates contact form for clients to send contact info on catalog item (used on reader page)
* Catalog Featured: selectable number of (random) items filtered by a preset condition.
* Catalog Related: show related catalog items (except current) with selectable matching parameters.
* Catalog Reference: show child catalog items where a selected reference field is matching the current viewed parent item.

== Front-end Display Modules ==

To better understand the Front-End (FE) Modules, the following two diagrams will illustrate the two-page approach.

*Catalog List Page*

[[File:catalog-list-use.jpg]]

*Catalog Reader Page*

[[File:catalog-reader-usage.jpg]]

=== Catalog Filter ===

* Filter Module is simple point-and-click form builder
* Almost all fields can be used as a filtered list, except URL, FILE (these were too difficult to achieve successfully) and LONGTEXT (as a dropdown with lots of rich text won't be of any value)
* Each field can now be ordered and separately changed to: none, links list, radio, select drop-down
* Set-up a Field Filter Tree with auto-hide children and children become self-filtered by parents. This is ideal for situations like: Area, City (click on area and it only shows cities in that area)
* Tags can be set to display as multiple selects (radio becomes a checkbox control, and select becomes a multi-select)
* Date filter section, order and chose which date fields and the types or past periods (day, week, month, 6 months or year)
* As this is a separate module, you can place the filter in the right/left nav bar, but it must appear on the same page as the Catalog List module to create the filter URL for the list module to respond
* Multiple catalog filters are supported on the same page, each can display only a certain part, e.g. one for filter on 1 field to create categories, another for the search and other filter specs in the right nav.
* You can also set-up a [[JumpTo]] page, to which the filter will jump when clicked on a filter field, range, date, search or sort field. [[JumpTo]] is also Filter Tree View aware, e.g. it does not jump unless you are clicking on the last field in the filter tree (the final selection in your menu, which then jumps to your results). This allows you to set-up a category list on another page than the results.

*Templates*
* filter_default.tpl => default for Catalog Filter
* filter_widgets.tpl => empty template with debug to show how to build your own filter with Catalog Filter

[[File:catalog_ex-filter.jpg]]

=== Catalog List ===

* Select which the order and visibility of listed fields
* Supports a custom WHERE clause to exclude/include regardless of above filter specs (e.g. archived!=1 AND published=1). [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Supports a custom default ORDER BY clause, which is replace by the sort order
* Set the Query Mode (AND/OR)
* Set the Tags Mode (AND/OR)
* Select which fields are searched when search string is provided
* Enable Conditional listing mode, where nothing is listed until the filter conditions are fulfilled, e.g. both Genre AND Formats chosen, then the list is shown
* Thumbnails size override for one single image field and one multi image field with new size parameters

*NOTE:*
* Must be on the same page as the Catalog Filter module above to respond to the active filters
* List Module is SEO-bases and supports paging (which is NOT SEO)

*Templates*
* catalog_simpletable.tpl => simulates the Listing module (to a degree)
* catalog_simple.tpl => use with Catalog Listing (mainly)

[[File:catalog-list.jpg]]

=== Catalog Reader ===

* Select which the order and visibility of listed fields
* Catalog Reader Module is placed on the [[JumpTo]] page (just like News), configured in the back-end catalog
* replaces page title with _title_ if defined as catalog field
* Adds a reference variable to the items array so you can output the referenced catalog's info
* Above reference now also checks if reference is another catalog and provides a jumpTo URL (link and id) so users can jump to another category's detailed description.

*Templates*
* catalog_full.tpl => use with Catalog Reader (mainly)
* catalog_full_ref.tpl => use with Catalog Reader (with select/tag referenced array example)

=== Catalog Notify ===

* Add simple form fields with only text headings -- all fields are required!
* You can disable the security question
* Enter the Notification Subject -- this can contain catalog item field references, e.g. _{{catalog::fieldname}}_
* You can add multiple recipients in a list
* Enter the Body Text of the e-mail, which can contain 2 special variables: _##catalog##_ (the catalog name) and _##link##_ which creates hyperlink text to the current catalog item. You can also use the above catalog item field references, e.g. _{{catalog::fieldname}}_

*NOTE:*
* This module must be on the same page as the Catalog Reader module as it also refers to a single catalog item

*Templates*
* mod_catalognotify.tpl => creates the form and submit button, and displays the "received" message

[[File:catalog-notify.jpg]]

In the Front-End, this is what it looks like:

[[File:catalog-notify-fe.jpg]]

=== Catalog Featured ===

* Select which the order and visibility of listed fields
* Custom where clause [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

[[File:catalog-featured.jpg]]

=== Catalog Related ===

This module provides a way to (randomly) list items with similar specification/fields to the currently viewed catalog item. Example: View other "Action Adventure" games where this related [genre] field matched.

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select which the order and visibility of listed fields
* Select the related fields that must match with the current viewed catalog item
* Custom condition (WHERE) clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own ORDER by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== Catalog Reference ===

This module provides a way to (randomly) list child table items where a selected field matches the currently viewed parent catalog item. Example: List all items from the (child) Games Catalog where the currently viewed reference (parent) Region Catalog item matches on the selected reference field [region].

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select the Catalog to list items from (child records)
* Select the reference field to which the ID must match with the currently viewed item with catalog reader.
* Select the current catalog being viewed in the Catalog Reader module (parent item).
* Select the catalog layout template
* Select which the order and visibility of listed fields
* Custom where clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

You can also use the [#CatalogInsertTags Catalog [[InsertTags]]] as specified above in Catalog Related.

[[File:catalog-reference.jpg]]

== Catalog [[InsertTags]] ==

Its also possible to add custom parameters retrieved from the current catalog item as Catalog [[InsertTags]] in the custom condition (WHERE) and ordering (ORDER) boxes. See the image below for a more complete example using a price bracket and using date calculations compared to the current date. The general format to use the currently viewed catalog item's values is:
_{{catalog::fieldname}}_ will return the field's value

[[File:catalog_ex-related.jpg]]

== Tips & Tricks ==

Several tips and tricks are listed below.

=== Custom Condition ===

You can set-up complex custom conditions using the [#CatalogInsertTags Catalog [[InsertTags]]] above as well as regular [EnglishInserttags TL [[InsertTags]]]. This will allow you to filter the current Catalog module by variables like date, time, and when placed on a Catalog Reader page, you can use the current items information to further filter the Featured, Related, Reference, etc. items.

[[File:catalog-conditionorder.jpg]]

=== Custom Ordering ===

You can also enter custom ordering clauses (Featured requires you to enable it first) to allow you to order the items in your own way. Here are some suggestions.

* Show the latest entered item first
<pre>
tstamp DESC
</code></pre>

* Show a (limited to 1) item randomly cached by the current day -- this usually only becomes useful when you also set: _Number of items = 1_. This will then remain the same item, until the next day. Kind of like a featured random item per day. This has an added benefit of being able to go back to specific day to see the "random" item for that day, just replace _CURDATE()_ with the actual date _2009-02-27_
<pre>
MD5(CONCAT(CURDATE(),id))
</code></pre>

File:Catalog-notify-fe.jpg

2011-12-22T08:51:21Z

Dolores:

File:Catalog-notify.jpg

2011-12-22T08:50:02Z

Dolores:

File:Catalog-list.jpg

2011-12-22T08:49:20Z

Dolores:

File:Catalog-list-use.jpg

2011-12-22T08:47:04Z

Dolores:

File:Catalog-reader-usage.jpg

2011-12-22T08:46:17Z

Dolores:

File:Catalog ex-filter.jpg

2011-12-22T08:45:03Z

Dolores:

Contao.Dev ExtensionsCatalogExt

2011-12-21T15:34:33Z

Dolores: Created page with '{{stub}} [PageOutline(1-4, Table of Contents)] = Catalog Extension = <pre> <code class="div"> The Catalog and Catalog Extension modules are advanced modules and will require…'

{{stub}}

[PageOutline(1-4, Table of Contents)]

= Catalog Extension =

<pre>
<code class="div">
The Catalog and Catalog Extension modules are advanced modules and will require intermediate knowledge of PHP, HTML/CSS in order to create catalog that displays the way you really need it. To create advanced displays, you will need to understand PHP array structures provided in the TPL files.

*NOTE: This is not a module for beginners*.
</code></pre>

<pre>
<code class="div">
The Catalog module is a simple stop-gap to assist beginners with quickly getting up a custom application without having to write any code. However, the Catalog module is obviously NOT capable of working for all situations, at some point you have to get yourself dirty with PHP programming and just write your own TL applicationa, which is a bit of work and a lot of files, but easier than you might think.
</code></pre>

The documentation below only explains how to configure the [[CatalogExt]] Front-End modules (see reference links below).

== Reference Links ==

* [ExtensionsCatalog Configuring the Catalog] -- should be done before reading this section
* [TutorialsCatalog Catalog Templates Tutotial] explains advanced template customisation
* [TutorialsCatalogMultiLanguage Catalog Multi-Language Tutorial] explains how to easily set-up multi-language catalogs

== Summary ==

Once you've setup a Catalog in the back-end, you can use the Catalog Extension to add more features and to build the front-end with the following modules:

* Catalog Filter Module: build your filter on field values, range, date, search.
* Catalog List Module: displays a list of items responding to the filter above.
* Catalog Reader: displays item detail view + reference info (jump links to other catalogs).
* Catalog Notify: creates contact form for clients to send contact info on catalog item (used on reader page)
* Catalog Featured: selectable number of (random) items filtered by a preset condition.
* Catalog Related: show related catalog items (except current) with selectable matching parameters.
* Catalog Reference: show child catalog items where a selected reference field is matching the current viewed parent item.

== Front-end Display Modules ==

To better understand the Front-End (FE) Modules, the following two diagrams will illustrate the two-page approach.

*Catalog List Page*

[[File:catalog-list-use.jpg]]

*Catalog Reader Page*

[[File:catalog-reader-usage.jpg]]

=== Catalog Filter ===

* Filter Module is simple point-and-click form builder
* Almost all fields can be used as a filtered list, except URL, FILE (these were too difficult to achieve successfully) and LONGTEXT (as a dropdown with lots of rich text won't be of any value)
* Each field can now be ordered and separately changed to: none, links list, radio, select drop-down
* Set-up a Field Filter Tree with auto-hide children and children become self-filtered by parents. This is ideal for situations like: Area, City (click on area and it only shows cities in that area)
* Tags can be set to display as multiple selects (radio becomes a checkbox control, and select becomes a multi-select)
* Date filter section, order and chose which date fields and the types or past periods (day, week, month, 6 months or year)
* As this is a separate module, you can place the filter in the right/left nav bar, but it must appear on the same page as the Catalog List module to create the filter URL for the list module to respond
* Multiple catalog filters are supported on the same page, each can display only a certain part, e.g. one for filter on 1 field to create categories, another for the search and other filter specs in the right nav.
* You can also set-up a [[JumpTo]] page, to which the filter will jump when clicked on a filter field, range, date, search or sort field. [[JumpTo]] is also Filter Tree View aware, e.g. it does not jump unless you are clicking on the last field in the filter tree (the final selection in your menu, which then jumps to your results). This allows you to set-up a category list on another page than the results.

*Templates*
* filter_default.tpl => default for Catalog Filter
* filter_widgets.tpl => empty template with debug to show how to build your own filter with Catalog Filter

[[File:catalog_ex-filter.jpg]]

=== Catalog List ===

* Select which the order and visibility of listed fields
* Supports a custom WHERE clause to exclude/include regardless of above filter specs (e.g. archived!=1 AND published=1). [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Supports a custom default ORDER BY clause, which is replace by the sort order
* Set the Query Mode (AND/OR)
* Set the Tags Mode (AND/OR)
* Select which fields are searched when search string is provided
* Enable Conditional listing mode, where nothing is listed until the filter conditions are fulfilled, e.g. both Genre AND Formats chosen, then the list is shown
* Thumbnails size override for one single image field and one multi image field with new size parameters

*NOTE:*
* Must be on the same page as the Catalog Filter module above to respond to the active filters
* List Module is SEO-bases and supports paging (which is NOT SEO)

*Templates*
* catalog_simpletable.tpl => simulates the Listing module (to a degree)
* catalog_simple.tpl => use with Catalog Listing (mainly)

[[File:catalog-list.jpg]]

=== Catalog Reader ===

* Select which the order and visibility of listed fields
* Catalog Reader Module is placed on the [[JumpTo]] page (just like News), configured in the back-end catalog
* replaces page title with _title_ if defined as catalog field
* Adds a reference variable to the items array so you can output the referenced catalog's info
* Above reference now also checks if reference is another catalog and provides a jumpTo URL (link and id) so users can jump to another category's detailed description.

*Templates*
* catalog_full.tpl => use with Catalog Reader (mainly)
* catalog_full_ref.tpl => use with Catalog Reader (with select/tag referenced array example)

=== Catalog Notify ===

* Add simple form fields with only text headings -- all fields are required!
* You can disable the security question
* Enter the Notification Subject -- this can contain catalog item field references, e.g. _{{catalog::fieldname}}_
* You can add multiple recipients in a list
* Enter the Body Text of the e-mail, which can contain 2 special variables: _##catalog##_ (the catalog name) and _##link##_ which creates hyperlink text to the current catalog item. You can also use the above catalog item field references, e.g. _{{catalog::fieldname}}_

*NOTE:*
* This module must be on the same page as the Catalog Reader module as it also refers to a single catalog item

*Templates*
* mod_catalognotify.tpl => creates the form and submit button, and displays the "received" message

[[File:catalog-notify.jpg]]

In the Front-End, this is what it looks like:

[[IFile:catalog-notify-fe.jpg]]

=== Catalog Featured ===

* Select which the order and visibility of listed fields
* Custom where clause [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

[[File:catalog-featured.jpg]]

=== Catalog Related ===

This module provides a way to (randomly) list items with similar specification/fields to the currently viewed catalog item. Example: View other "Action Adventure" games where this related [genre] field matched.

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select which the order and visibility of listed fields
* Select the related fields that must match with the current viewed catalog item
* Custom condition (WHERE) clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own ORDER by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

=== Catalog Reference ===

This module provides a way to (randomly) list child table items where a selected field matches the currently viewed parent catalog item. Example: List all items from the (child) Games Catalog where the currently viewed reference (parent) Region Catalog item matches on the selected reference field [region].

<pre>
<code class="div">
This module is intended to be used on a Catalog Reader Page.
</code></pre>

* Select the Catalog to list items from (child records)
* Select the reference field to which the ID must match with the currently viewed item with catalog reader.
* Select the current catalog being viewed in the Catalog Reader module (parent item).
* Select the catalog layout template
* Select which the order and visibility of listed fields
* Custom where clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Limit items (0 to show all)
* Option to disable randomizer feature _ORDER BY RAND()_ and enter your own order by clause. [EnglishInserttags TL [[InsertTags]]] are allowed here.
* Thumbnails size override for one single image field and one multi image field with new size parameters

You can also use the [#CatalogInsertTags Catalog [[InsertTags]]] as specified above in Catalog Related.

[[File:catalog-reference.jpg]]

== Catalog [[InsertTags]] ==

Its also possible to add custom parameters retrieved from the current catalog item as Catalog [[InsertTags]] in the custom condition (WHERE) and ordering (ORDER) boxes. See the image below for a more complete example using a price bracket and using date calculations compared to the current date. The general format to use the currently viewed catalog item's values is:
_{{catalog::fieldname}}_ will return the field's value

[[File:catalog_ex-related.jpg]]

== Tips & Tricks ==

Several tips and tricks are listed below.

=== Custom Condition ===

You can set-up complex custom conditions using the [#CatalogInsertTags Catalog [[InsertTags]]] above as well as regular [EnglishInserttags TL [[InsertTags]]]. This will allow you to filter the current Catalog module by variables like date, time, and when placed on a Catalog Reader page, you can use the current items information to further filter the Featured, Related, Reference, etc. items.

[[File:catalog-conditionorder.jpg]]

=== Custom Ordering ===

You can also enter custom ordering clauses (Featured requires you to enable it first) to allow you to order the items in your own way. Here are some suggestions.

* Show the latest entered item first
<pre>
tstamp DESC
</code></pre>

* Show a (limited to 1) item randomly cached by the current day -- this usually only becomes useful when you also set: _Number of items = 1_. This will then remain the same item, until the next day. Kind of like a featured random item per day. This has an added benefit of being able to go back to specific day to see the "random" item for that day, just replace _CURDATE()_ with the actual date _2009-02-27_
<pre>
MD5(CONCAT(CURDATE(),id))
</code></pre>

Contao.Dev ExtensionsCatalogMailer

2011-12-21T15:20:32Z

Dolores:

{{stub}}

[PageOutline(1-4, Table of Contents)]

= Catalog Mailer =

The Catalog Mailer adds the ability to mail catalog items to a predefined mail setup. This is ideal for sending an property or product update e-mail to a head-office or group e-mail on a regular basis.

<pre>
<code class="div">
This module requires the installation of the [ExtensionsCatalog Catalog Module] and [ExtensionsCatalogExt Catalog Extension Module].
</code></pre>

== Installation ==

* Download and Install from: [http://www.contao.org/extension-list/tags/Catalog%20mailer.html "Extension Repository"]

== Summary ==

This module adds the ability to mail Catalog items to the Catalog/Catalog Extension modules. You can set-up a pre-defined query with limit numbers and then the mailer will allow individual item selection before mailing.

== Additional Catalog Configuration ==

The backend allows setting up the subject, sender address, pre-defined recipient list, mail_xx and catalog_xx templates, field list to display in mailer application, filter condition and default sort order, and number of items.

[[File:Catalog_mailer-mail.jpg]]

== Catalog Mail button ==

Once enabled, the Catalog Mailer creates a mail button for each catalog. The mailer application allows you to add custom recipients, a custom message and to select the catalog items to add to the mail. You can then preview or mail the catalog items.

[[File:Catalog_mailer-config.jpg]]

Contao.Dev ExtensionsCatalogMailer

2011-12-21T15:16:18Z

Dolores: /* Summary */

{{stub}}

[[PageOutline(1-4, Table of Contents)]]

= Catalog Mailer =

The Catalog Mailer adds the ability to mail catalog items to a predefined mail setup. This is ideal for sending an property or product update e-mail to a head-office or group e-mail on a regular basis.

<pre>
<code class="div">
This module requires the installation of the [ExtensionsCatalog Catalog Module] and [ExtensionsCatalogExt Catalog Extension Module].
</code></pre>

== Installation ==

* Download and Install from: [http://www.contao.org/extension-list/tags/Catalog%20mailer.html "Extension Repository"]

== Summary ==

This module adds the ability to mail Catalog items to the Catalog/Catalog Extension modules. You can set-up a pre-defined query with limit numbers and then the mailer will allow individual item selection before mailing.

== Additional Catalog Configuration ==

The backend allows setting up the subject, sender address, pre-defined recipient list, mail_xx and catalog_xx templates, field list to display in mailer application, filter condition and default sort order, and number of items.

[[File:Catalog_mailer-mail.jpg]]

== Catalog Mail button ==

Once enabled, the Catalog Mailer creates a mail button for each catalog. The mailer application allows you to add custom recipients, a custom message and to select the catalog items to add to the mail. You can then preview or mail the catalog items.

[[File:Catalog_mailer-config.jpg]]

Contao.Dev ExtensionsCatalogMailer

2011-12-21T15:16:08Z

Dolores: /* Installation */

Contao.Dev ExtensionsCatalogMailer

2011-12-21T15:15:49Z

Dolores: Created page with '{{stub}} PageOutline(1-4, Table of Contents) = Catalog Mailer = The Catalog Mailer adds the ability to mail catalog items to a predefined mail setup. This is ideal for s…'

File:Catalog mailer-mail.jpg

2011-12-21T15:14:11Z

Dolores:

File:Catalog mailer-config.jpg

2011-12-21T15:09:53Z

Dolores:

Contao.Dev ExtensionsBrowserUpdate

2011-12-15T10:41:19Z

Dolores:

{{stub}}
= Browser Upgrade: module description =

== Resources ==

* [http://www.typolight.org/erweiterungsliste/view/browser_update.10000004.de.html module page in the repository (only DE)]
* [http://dev.typolight-forge.org/projects/show/browserupdate the TYPOlight-forge page]
* [http://www.typolight.org/board/topic/10936.html link to the thread (only DE)]

== Features ==

* Simple implementation of a notice from "if a visitor uses an obsolete browser version (similar to a security advice)
* Possible to define which browsers should be considered as being obsolete
* test mode (display in all browsers)

== Setup ==

You can install the extension like every other one using the extension repository. Follow the instructions as usual.

== Use ==

*Create a new module
*Enter a title (e.g. 'browser update notice')
*Choose the module type 'Browser Update' (see category miscellaneous)
*Configure notices. It's recommended that you display the notice in every browser first while testing the extension. This way you (and you're hopefully using the current version of your browser) are able to see the notice as well.
*Save the module
*Go to the page layouts. In the section 'Included modules' you can now include your module wherever you want to. It doesn't matter whether you choose the 'header' or the 'Left column' because [[JavaScript]]-Code is included in your page header anyway.
*Switch to the frontend view to test
*After a successful test go back to the module to change your notice settings. I suggest using the manual configuration which includes Internet Explorer 6 as well.

[http://www.typolight.org/mitgliederliste.html?show=3517 Tutorial created by ETES] [http://www.browser-update.org browser-update.org]

[http://www.typolight.org/mitgliederliste.html?show=3170 Tutorial translated by "Toflar"]

Contao.Dev ExtensionsBrowserUpdate

2011-12-07T16:41:22Z

Dolores:

= Browser Upgrade: module description =

== Resources ==

* [http://www.typolight.org/erweiterungsliste/view/browser_update.10000004.de.html module page in the repository (only DE)]
* [http://dev.typolight-forge.org/projects/show/browserupdate the TYPOlight-forge page]
* [http://www.typolight.org/board/topic/10936.html link to the thread (only DE)]

== Features ==

* Simple implementation of a notice from "if a visitor uses an obsolete browser version (similar to a security advice)
* Possible to define which browsers should be considered as being obsolete
* test mode (display in all browsers)

== Setup ==

You can install the extension like every other one using the extension repository. Follow the instructions as usual.

== Use ==

*Create a new module
*Enter a title (e.g. 'browser update notice')
*Choose the module type 'Browser Update' (see category miscellaneous)
*Configure notices. It's recommended that you display the notice in every browser first while testing the extension. This way you (and you're hopefully using the current version of your browser) are able to see the notice as well.
*Save the module
*Go to the page layouts. In the section 'Included modules' you can now include your module wherever you want to. It doesn't matter whether you choose the 'header' or the 'Left column' because [[JavaScript]]-Code is included in your page header anyway.
*Switch to the frontend view to test
*After a successful test go back to the module to change your notice settings. I suggest using the manual configuration which includes Internet Explorer 6 as well.

[http://www.typolight.org/mitgliederliste.html?show=3517 Tutorial created by ETES] [http://www.browser-update.org browser-update.org]

[http://www.typolight.org/mitgliederliste.html?show=3170 Tutorial translated by "Toflar"]

Contao.Dev ExtensionsBrowserUpdate

2011-12-07T16:31:39Z

Dolores:

= Browser Upgrade: module description =

== Resources ==

* [http://www.typolight.org/erweiterungsliste/view/browser_update.10000004.de.html module page in the repository (only DE)]
* [http://dev.typolight-forge.org/projects/show/browserupdate the TYPOlight-forge page]
* [http://www.typolight.org/board/topic/10936.html link to the thread (only DE)]

== Features ==

* Simple implementation of a notice from "if a visitor uses an obsolete browser version (similar to a security advice)
* Possible to define which browsers should be considered as being obsolete
* test mode (display in all browsers)

== Setup ==

You can install the extension like every other one using the extension repository. Follow the instructions as usual.

== Use ==

*Create a new module
*Enter a title (e.g. 'browser update notice')
*Choose the module type 'Browser Update' (see category miscellaneous)
*Configure notices. It's recommended that you display the notice in every browser first while testing the extension. This way you (and you're hopefully using the current version of your browser) are able to see the notice as well.
*Save the module
*Go to the page layouts. In the section 'Included modules' you can now include your module wherever you want to. It doesn't matter whether you choose the 'header' or the 'Left column' because [[JavaScript]]-Code is included in your page header anyway.
*Switch to the frontend view to test
*After a successful test go back to the module to change your notice settings. I suggest using the manual configuration which includes Internet Explorer 6 as well.

Tutorial created by [http://www.typolight.org/mitgliederliste.html?show=3517 ETES" [http://www.browser-update.org]

Tutorial translated by "Toflar" [http://www.typolight.org/mitgliederliste.html?show=3170]

Contao.Dev ExtensionsBrowserUpdate

2011-12-07T16:16:59Z

Dolores: /* Use */

= Browser Upgrade: module description =

== Resources ==

* "module page in the repository (only DE)" [http://www.typolight.org/erweiterungsliste/view/browser_update.10000004.de.html]
* "the TYPOlight-forge page" [http://dev.typolight-forge.org/projects/show/browserupdate]
* "link to the thread (only DE)" [http://www.typolight.org/board/topic/10936.html]

== Features ==

* Simple implementation of a notice from "if a visitor uses an obsolete browser version (similar to a security advice)
* Possible to define which browsers should be considered as being obsolete
* test mode (display in all browsers)

== Setup ==

You can install the extension like every other one using the extension repository. Follow the instructions as usual.

== Use ==

*Create a new module
*Enter a title (e.g. 'browser update notice')
*Choose the module type 'Browser Update' (see category miscellaneous)
*Configure notices. It's recommended that you display the notice in every browser first while testing the extension. This way you (and you're hopefully using the current version of your browser) are able to see the notice as well.
*Save the module
*Go to the page layouts. In the section 'Included modules' you can now include your module wherever you want to. It doesn't matter whether you choose the 'header' or the 'Left column' because [[JavaScript]]-Code is included in your page header anyway.
*Switch to the frontend view to test
*After a successful test go back to the module to change your notice settings. I suggest using the manual configuration which includes Internet Explorer 6 as well.

Tutorial created by [http://www.typolight.org/mitgliederliste.html?show=3517 ETES":http://www.browser-update.org]

Tutorial translated by "Toflar" [http://www.typolight.org/mitgliederliste.html?show=3170]

Contao.Dev ExtensionsBrowserUpdate

2011-12-07T16:08:11Z

Dolores: Created page with '= Browser Upgrade: module description = == Resources == * "module page in the repository (only DE)" [http://www.typolight.org/erweiterungsliste/view/browser_update.10000004.…'

= Browser Upgrade: module description =

== Resources ==

* "module page in the repository (only DE)" [http://www.typolight.org/erweiterungsliste/view/browser_update.10000004.de.html]
* "the TYPOlight-forge page" [http://dev.typolight-forge.org/projects/show/browserupdate]
* "link to the thread (only DE)" [http://www.typolight.org/board/topic/10936.html]

== Features ==

* Simple implementation of a notice from "if a visitor uses an obsolete browser version (similar to a security advice)
* Possible to define which browsers should be considered as being obsolete
* test mode (display in all browsers)

== Setup ==

You can install the extension like every other one using the extension repository. Follow the instructions as usual.

== Use ==

*Create a new module
*Enter a title (e.g. 'browser update notice')
*Choose the module type 'Browser Update' (see category miscellaneous)
*Configure notices. It's recommended that you display the notice in every browser first while testing the extension. This way you (and you're hopefully using the current version of your browser) are able to see the notice as well.
*Save the module
*Go to the page layouts. In the section 'Included modules' you can now include your module wherever you want to. It doesn't matter whether you choose the 'header' or the 'Left column' because [[JavaScript]]-Code is included in your page header anyway.
*Switch to the frontend view to test
*After a successful test go back to the module to change your notice settings. I suggest using the manual configuration which includes Internet Explorer 6 as well.

_Tutorial created by [http://www.typolight.org/mitgliederliste.html?show=3517 ETES":http://www.browser-update.org]

_Tutorial translated by "Toflar" [http://www.typolight.org/mitgliederliste.html?show=3170]