Sidebar

startup_tutorial_and_checklist:usability_configuration:category_browsing_configurations:category_browsing_category_navigation

Category Navigation Within the Category Browsing Pages up to v7.6.3

The default category navigation used by the default design is produced within the {body_html} tag. You can edit the category browsing feature {body_html} category navigation look to make your changes within the following section of the admin tool:

SITE SETUP > BROWSING SETTINGS > CATEGORY SETTINGS

Settings that can affect category display in the {body_html} tag of the category browsing page

  • Display Category/Subcategory Counts
  • Listing Type Order for Category Counts
  • Include all Subcategory Listings
  • Subcategory Display while Browsing Listings
  • Arrange Categories Alphabetically
  • Display Category Description while Browsing Listings
  • Display the 'No Subcategory' Message while Browsing Listings
  • Category Tree (Breadcrumb) Location
  • Display the 'All' tab while Browsing Listings
  • Default Browse View
  • Display browse view links
  • Gallery View number of columns
  • Show 'Sort By:' dropdown

Alternatives to the {body_html} Category Navigation

The v7.3 and up default designs category browsing page uses the category_page.tpl template. This template is used only on the browsing categories page so any changes you make to it will only affect display on that one page unless you attach the category_page.tpl template to other pages in the system.

If you find the "body html" category navigation a bit limiting as far as display options you can turn off the display of the "body HTML" category navigation and replace with a category navigation module. You can turn off the display of the "body HTML" category navigation in the above admin tool section by changing the following admin tool setting to "no":

SITE SETUP > BROWSING SETTINGS > Display Category/Subcategory Navigation

Once you have turned that off you will need to find a category navigation module that should work best for you in place of the category navigation you are replacing. You can find all the available category navigation modules here within the admin tool:

PAGE MODULES > BROWSING > CATEGORY NAVIGATION

We do not suggest that you use a "main" category navigation module here unless you only have one level of categories in your category structure. Once you have decided on a category navigation module you will need to place that modules placement tag within the category_page.tpl page template (or template you use for the category browsing feature). If you are moving that module around in that template you'll need to create the space for the new category navigation location within the html of that page template.

To edit the category_page.tpl template you would open it for editing in the following admin tool:

DESIGN > MANAGER

The category_page.tpl is by default here in your custom template set:

/main_page/category_page.tpl

Once opened you will then need to place that modules placement tag within the HTML source where you want it to appear. If you are in the source view of the page template you can use the "insert a tag" option at the top of the source code editor to have the editor place the correct module tag where you choose within the source HTML of the page template.

Note the HTML that places the {body_html} within the design and put the module placement tag in the page template to make it appear where you want in relation to the category browsing results. If you still want that category navigation above the body HTML (category browsing results placed where the body HTML tag is within the page template) you will need to place that module placement tag above the {body_html} tag in that page template's HTML. Note that you may also need to add some HTML to properly place the category navigation results where you want them.

At this point you will notice if you go to your category browsing page on the client side that the category tree may not be where you want it either. If you haven't modified it yet it would appear just above the category browsing results. If you do not like where it is displayed you can turn off the display of the category tree within the admin tool here:

SITE SETUP > BROWSING SETTINGS > CATEGORY TREE (BREADCRUMB) LOCATION

And if you still want to display a category tree you can place one of the category tree modules where you want it to display just as you have done with the category navigation module. You can find the full list of category tree modules available here within the admin tool:

PAGE MODULES > BROWSING > CATEGORY TREE DISPLAY MODULES

And of course place the module placement tag within the page template where you want it to display in relation to the category navigation (category navigation module placement tag) and category browsing results ({body_html} tag).

If you have a completely custom template set or changed page to template attachment in a few pages you can find out the template you use there in two places within the admin tool:

PAGES MANAGEMENT > BROWSING LISTINGS > BROWSE CATEGORIES > TEMPLATE ATTACHMENTS

Or

DESIGN > PAGE ATTACHMENTS > BROWSE CATEGORIES

Featured Module Display

The "body html" featured display is controlled by the featured gallery feature of the Core Display addon now. If you decide you do not like this featured display option you can do the above steps to place category tree and category navigation modules above the "body html" tag but also place a featured module after those modules and before the "body html" tag. You could use the featured modules that display in the grid format to display listings that way.

The section previous describes how to break out the category navigation and category tree display into modules so you can place the featured module where you want between them and the {body_html} tag.

startup_tutorial_and_checklist/usability_configuration/category_browsing_configurations/category_browsing_category_navigation.txt · Last modified: 2016/02/25 10:55 by geojames