Filter This!

Please note that this tutorial pertains to GARS 2.1.1 and GARS 2.1.2
Earlier versions will not have the filter module and later versions may be slightly different (but how the hell do I know that as I haven't written any newer versions yet!).

The custom field

The filter module is a new module and feature in GARS that will enable you to filter a forum by a custom field. The custom field MUST be a 'Select Box' type. A select box is a drop down list of pre-defined text. You define the text when you create (or edit) a Select Box custom field

filter-selectbox.jpg
A select box custom field

Adding to your type

Then your type must have the select box custom field associated with it. To do this, edit the correct type and scroll to the bottom. You will notice that there will be a tick box to associate the custom field to your type. There will also be an additional tick box (only available with select box custom fields) to allow users to filter by the field.

filter-type.jpg
Allow users to filter by field

Setting up the module

You need to add the filter module to your module set in order for it to appear. It is important to note that the filter module only works on forumdisplay pages so don't add it to the showthread page!

filter-select.jpg
Editing the modules settings

You can currently only filter by 1 select field at a time.

Want an example? The forum this tutorial in is set up to filter between GARS, GAL and GAB tutorials

nJoy

	GAB GAB is a highly configurable banner system that allows you to customize banners for vBulletin easily. Determine which usergroups see banners, which ones can disable them, which pages have banners and where. GAB is the one stop shop for banner advertising.

	GAL The Geek Auto-linker is the famous vBulletin system for auto highlighting key words is posts with links and/or popups. A wonder for glossaries and sponsors!