Sidebar

startup_tutorial_and_checklist:usability_configuration:category_browsing_configurations:front_page_category_navigation

Front Page Category Navigation

From v5.1 forward the default front page default design displays category navigation in the center of the page and geographic navigation on the left side of the page. The front page by default uses the front_page.tpl template where these changes (if you make them) would take place.

Default Category Navigation on Front Page

By default the front page category navigation is placed into the front_page.tpl template where ever the {body_html} tag is. So if you use that placement tag within the template attached to the front page you'll get a basic category navigation you see in many of our demo front pages. There are admin tools to control that display found here:

SITE SETUP > BROWING SETTINGS > Display Category/Subcategory Navigation
SITE SETUP > BROWING SETTINGS > Display Category/Subcategory Counts
SITE SETUP > BROWING SETTINGS > Listing Type Order for Category Counts 
SITE SETUP > BROWING SETTINGS > Arrange Categories Alphabetically
SITE SETUP > BROWING SETTINGS > Display Category Description while Browsing Listings

SITE SETUP > BROWING SETTINGS > Category Display on Home Page

The first 5 settings above affect category navigation display within the {body_html} tag on the front page as well as the same category navigation that appears in the {body_html} on category browsing pages (if you use this feature). The last setting above only affects category navigation display on the front page.

Replacing Default Category Navigation with Category Navigation Module

If you find you want to display this category navigation differently we would suggest using a category navigation module in place of the category navigation displayed by the {body_html} tag. To change the "body HTML" category navigation with module category navigation simply remove the {body_html} tag from the front page template (front_page.tpl by default) and place the category navigation module of your choice within that page template where you want it to appear. To find the available category navigation modules within the admin tool look here:

PAGE MODULES > BROWSING > CATEGORY NAVIGATION

You would see many category navigation module options. Our suggestion would be to place the main category navigation module there as it only displays the top level categories where it's is placed. If you agree look to use the following module tag in place of the {body_html} tag in the front_page.tpl template or whatever front page template you use:

{module tag='main_classified_navigation_1'}

Many clients simply want to turn off subcategory display on the home page. This can't be done in the default body html tag but once you have the category navigation module in place you can. The admin tool for the above module if you chose to use it would be here:

PAGE MODULES > BROWSING > CATEGORY NAVIGATION > Main Category Navigation 1

and the admin tool would look like:

and you would make sure the Display Subcategories (as links) shown in the above screenshot is set to no to not display subcategories.

The next step would be "uncheck" the "home page" option within the following admin tool setting:

SITE SETUP > BROWSING SETTINGS > Display Category/Subcategory Navigation

and that should stop it from displaying on the front page template. At that point only the category navigation module placed above should be display on your front page.

Removing Dynamic Category Navigation From Front Page

You do not need to use any of the above mentioned category navigation solutions if you do not want to or can't get them to display the way you want. Since the category navigation from the front page will never change (at least until you change the category structure in the admin tool) and the front page has its own page template assigned to it you can remove the "{body_html}" and/or category navigation module navigation display you may be using and replace it with html category links that you create. You would not be able to display the category counts the above dynamic solutions provide but you would be able to display the category links you want as well as the display those links in exactly the design you create.

You simply remove the {body_html} and/or category navigation module tags you are currently using and create the links to categories directly within the html/css you want to use to format those links directly into the front page template you are using. Look to the following category link explanation on how to create category links.

Possible Shortcut

Many clients just want to remove a category or two from the front page but everything else is fine. If that's so then why not use the html already created by the software and just edit it to remove the one category link you want. The first thing to do is turn off the display of the category counts here within the admin tool:

SITE SETUP > BROWSING SETTINGS > Display Category/Subcategory Counts

That will turn off the display of the category counts which cannot be displayed within hardcoded html links anyway. The next step would be to surround the {body_html} tag in the front_page.tpl template with some tags so you can easily see the body html output in the source code. Add something like:

<!--before the body html tag-->
{body_html}
<!--after the body html tag-->

Save those changes and go to the front page of your Geo installation and click refresh. Then have your browser display the html source of the page. You will find the above tags. You can simply cut and paste the content between the two above html comments. Now you have the default category navigation for your front page.

With that content in your clipboard you would return to edit your front_page.tpl template and paste what's in your clipboard over the {body_html} tag in the front_page.tpl template. After pasting you should not have the {body_html} tag in your front_page.tpl template. If it's still there simply delete it. You now have the same category navigation in your front page except that it's now hardcoded htm. From here you simply edit the html of that category navigation to remove the links you wish to remove OR make other changes you wish. When done save your changes.

Once that is all done simply turn off the software creating the category navigation for the front page here in the admin tool:

SITE SETUP > BROWSING SETTINGS > Display Category/Subcategory Navigation

<tip c n>Note now that you have that in your front page template any category changes you make will not reflect in your front page. If you make category changes and wish to get those changes to your front page you will either need to:

  1. reverse steps to get the default category navigation and the do these steps again
  2. or just make your change directly to the html of the category navigation currently in your front_page.tpl

</tip>

startup_tutorial_and_checklist/usability_configuration/category_browsing_configurations/front_page_category_navigation.txt · Last modified: 2018/06/19 23:38 by geojames