Sidebar

startup_tutorial_and_checklist:feature_configuration:module_configuration:tag_level_controls_within_module

Pass Configurations Within Module Tag

There are numerous other controls that you can use to control settings that normally appear in that module's admin control. When you look at the admin tool for each module you'll see many controls for display, number of listings to display,…etc. You can have the same controls within the individual module tag you place in the html to display that module. So if you only use a specific module (ex newest listings 1, hottest listings,…etc) once on your site controlling within the admin tool for that module is easiest. But if you want to place that module in more than one place within your site AND you want different configurations for each instance you use it you can insert attribute tags into that module placement tag like you see in the "add pagination" wiki section above.

For example if you wanted the newest listings module to display only 5 listings at a time and pagination in one template yet display in another template display 20 listings, pull listings from category 123 (category id), use no pagination and the display header column these would be example template tags to use:

Set number of listings to display to 5 and use pagination…otherwise use the configurations currently in that modules admin tool:

{module tag='newest_ads_1' module_number_of_ads_to_display='5' use_pagination='1'}

Set number of listings to display to 20 and display the header row…otherwise use the configurations currently in that modules admin tool:

{module tag='newest_ads_1' module_number_of_ads_to_display='20' module_display_header_row='1'}

For the full list of attributes you can place directly within the modules placement tag go to the custom smarty tags section of the support wiki here

The top left featured pic module of the current default design takes advantage of this feature and is explained here in the classifieds and auction support wiki

Within that implementation in the default design's front_page.tpl you would see this tag:

{module tag='module_featured_pic_1' gallery_columns=1 module_thumb_width=196 module_thumb_height=200}

You'll see that we set these parameters that you would by default set within the featured pic 1 module's admin tool.

  • gallery_columns=1
  • module_thumb_width=196
  • module_thumb_height=200
  • The max listings to display for the pic modules must be set within the modules admin tool.

The values above override those same configurations made in the admin tool for that module with the ones there.

Additional Controls That Can Be Passed

module_display_new_ad_icon=0

Setting to 0 like above will hide the "new" icon within a category navigation module.

startup_tutorial_and_checklist/feature_configuration/module_configuration/tag_level_controls_within_module.txt · Last modified: 2017/04/25 06:57 by geojames