Categories Dressing

Here's my tpl_categories.php file. Please show me where and what places to edit.


<?php
/**
* Side Box Template
*
* @package templateSystem
* @copyright Copyright 2003-2006 Zen Cart Development Team
* @copyright Portions Copyright 2003 osCommerce
* @license http://www.zen-cart.com/license/2_0.txt GNU Public License V2.0
* @version $Id: tpl_categories.php 4162 2006-08-17 03:55:02Z ajeh $
* Modified for Categories Dressing v2.1 by Glenn Herbert (gjh42) 2008-01-01
*/
$disp_block = '';
//$disp_block = '<br />'; //if not using display: block; in stylesheet, uncomment this line
$disp_block_head = '';
//$disp_block_head = '<br />'; // for headings not block uncomment this line
$content = "";

$content .= '<div id="' . str_replace('_', '-', $box_id . 'Content') . '" class="sideBoxContent">' . "\n";
for ($i=0;$i<sizeof($box_categories_array);$i++) {
switch(true) {
// to make a specific category stand out define a new class in the stylesheet example: A.category-holiday
// uncomment the select below and set the cPath=3 to the cPath= your_categories_id
// many variations of this can be done
case ($box_categories_array[$i]['path'] == 'cPath=3'):
$new_style = 'category-Holiday1';
break;
case ($box_categories_array[$i]['top'] == 'true'):
$new_style = 'category-top';
break;
case ($box_categories_array[$i]['has_sub_cat']):
$new_style = 'category-subs';
break;
default:
$new_style = 'category-products';
}
$current_path = str_replace("cPath=","",$box_categories_array[$i]['path']);
if (zen_get_product_types_to_category($box_categories_array[$i]['path']) == 3 or ($box_categories_array[$i]['top'] != 'true' and SHOW_CATEGORIES_SUBCATEGORIES_ALWAYS != 1)) {
// skip if this is for the document box (==3)
} else {
// categories dressing - add divider above specified cats
if(in_array($current_path, explode(",",'3,22,21_56'))) { //replace numbers with your cat ids separated by commas
$content .= '<hr class="catBoxDivider" />' . "\n";
}
// categories dressing - add (divider and) heading above a cat
switch ($current_path) {
case '23': //replace number with your desired cPath
$content .= '<hr class="catBoxDivider" />' . "\n"; // to add divider uncomment this line
$content .= '<span class="catBoxPearls">' . (file_exists(DIR_WS_TEMPLATE_IMAGES . 'cathead' . $current_path . '.gif') ? zen_image(DIR_WS_TEMPLATE_IMAGES . 'cathead' . $current_path . '.gif') . '</span>':'Heading 1</span>' . $disp_block_head) . "\n";
break;
}
// categories dressing - category name mods
$cat_name_display = $box_categories_array[$i]['name'];
$cat_img_bg = '';
// categories dressing - display image if exists for category name
if (file_exists(DIR_WS_TEMPLATE_IMAGES . 'catimg' . $current_path . '.gif')) {
$cat_name_display = zen_image(DIR_WS_TEMPLATE_IMAGES . 'catimg' . $current_path . '.gif');
// categories dressing - display background image if exists for category name
} elseif (file_exists(DIR_WS_TEMPLATE_IMAGES . 'catbg' . $current_path . '.gif')) {
$cat_name_display = '';
$cat_img_bg = ' catBg' . $current_path;
} else {
$cat_img_bg = '-text';//append to main classname
}
$content .= '<a class="' . $new_style . $cat_img_bg . '" href="' . zen_href_link(FILENAME_DEFAULT, $box_categories_array[$i]['path']) . '">';
if ($box_categories_array[$i]['current']) {
if ($box_categories_array[$i]['has_sub_cat']) {
$content .= '<span class="category-subs-parent">' . $cat_name_display . ($disp_block == '<br />'?'</span>':'');
} else {
$content .= '<span class="category-subs-selected">' . $cat_name_display . ($disp_block == '<br />'?'</span>':'');
}
} else {
$content .= '<span class="category-not-selected">' . $cat_name_display . ($disp_block == '<br />'?'</span>':'');
} // category name mods

if ($box_categories_array[$i]['has_sub_cat']) {
$content .= CATEGORIES_SEPARATOR;
}
$content .= ($disp_block == '<br />'?'</a>':''); // categories dressing - adjust link end

if (SHOW_COUNTS == 'true') {
if ((CATEGORIES_COUNT_ZERO == '1' and $box_categories_array[$i]['count'] == 0) or $box_categories_array[$i]['count'] >= 1) {
$content .= CATEGORIES_COUNT_PREFIX . $box_categories_array[$i]['count'] . CATEGORIES_COUNT_SUFFIX;
}
}

$content .= ($disp_block == ''?'</span></a>':'') . $disp_block . "\n"; // categories dressing - adjust link end

// categories dressing - add subtext below a cat
switch ($current_path) {
case '23': //replace number with your desired cPath
$content .= '<span class="catBoxSubtext">Subtext for cat 23 escape apostrophe\'s</span>' . $disp_block . "\n";
break;
} // subtext
}
}

if (SHOW_CATEGORIES_BOX_SPECIALS == 'true' or SHOW_CATEGORIES_BOX_PRODUCTS_NEW == 'true' or SHOW_CATEGORIES_BOX_FEATURED_PRODUCTS == 'true' or SHOW_CATEGORIES_BOX_PRODUCTS_ALL == 'true') {
// display a separator between categories and links
if (SHOW_CATEGORIES_SEPARATOR_LINK == '1') {
$content .= '<hr id="catBoxDivider" />' . "\n";
}
if (SHOW_CATEGORIES_BOX_SPECIALS == 'true') {
//$content .= '<span class="catBoxHeading1">' . (file_exists(DIR_WS_TEMPLATE_IMAGES . 'cathead-specials.gif') ? zen_image(DIR_WS_TEMPLATE_IMAGES . 'cathead-specials.gif') . '</span>':'Link Heading</span>' . $disp_block_head) . "\n";// categories dressing - uncomment this line for heading above link
$show_this = $db->Execute("select s.products_id from " . TABLE_SPECIALS . " s where s.status= 1 limit 1");
if ($show_this->RecordCount() > 0) {
$content .= '<a class="category-links" href="' . zen_href_link(FILENAME_SPECIALS) . '">' . CATEGORIES_BOX_HEADING_SPECIALS . '</a>' . $disp_block . "\n";
}
}
if (SHOW_CATEGORIES_BOX_PRODUCTS_NEW == 'true') {
// display limits
// $display_limit = zen_get_products_new_timelimit();
$display_limit = zen_get_new_date_range();

$show_this = $db->Execute("select p.products_id
from " . TABLE_PRODUCTS . " p
where p.products_status = 1 " . $display_limit . " limit 1");
if ($show_this->RecordCount() > 0) {
//$content .= '<span class="catBoxHeading1">' . (file_exists(DIR_WS_TEMPLATE_IMAGES . 'cathead-new.gif') ? zen_image(DIR_WS_TEMPLATE_IMAGES . 'cathead-new.gif') . '</span>':'Link Heading</span>' . $disp_block_head) . "\n";// categories dressing - uncomment this line for heading above link
$content .= '<a class="category-links" href="' . zen_href_link(FILENAME_PRODUCTS_NEW) . '">' . CATEGORIES_BOX_HEADING_WHATS_NEW . '</a>' . $disp_block . "\n";
}
}
if (SHOW_CATEGORIES_BOX_FEATURED_PRODUCTS == 'true') {
$show_this = $db->Execute("select products_id from " . TABLE_FEATURED . " where status= 1 limit 1");
if ($show_this->RecordCount() > 0) {
//$content .= '<span class="catBoxHeading1">' . (file_exists(DIR_WS_TEMPLATE_IMAGES . 'cathead-featured.gif') ? zen_image(DIR_WS_TEMPLATE_IMAGES . 'cathead-featured.gif') . '</span>':'Link Heading</span>' . $disp_block_head) . "\n";// categories dressing - uncomment this line for heading above link
$content .= '<a class="category-links" href="' . zen_href_link(FILENAME_FEATURED_PRODUCTS) . '">' . CATEGORIES_BOX_HEADING_FEATURED_PRODUCTS . '</a>' . $disp_block . "\n";
}
}
if (SHOW_CATEGORIES_BOX_PRODUCTS_ALL == 'true') {
$content .= '<span class="catBoxHeading1">' . (file_exists(DIR_WS_TEMPLATE_IMAGES . 'cathead-all.gif') ? zen_image(DIR_WS_TEMPLATE_IMAGES . 'cathead-all.gif') . '</span>':'Link Heading</span>' . $disp_block_head) . "\n";// categories dressing - uncomment this line for heading above link
$content .= '<a class="category-links" href="' . zen_href_link(FILENAME_PRODUCTS_ALL) . '">' . CATEGORIES_BOX_HEADING_PRODUCTS_ALL . '</a>' . "\n";
}
}
$content .= '</div>';
?>


The site is located here: 72.167.78.125

Thanks,
Len

This is the part you will edit to get the headings:

PHP Code:

---

// categories dressing - add (divider and) heading above a cat
switch ($current_path) {
case '23': //replace number with your desired cPath
$content .= '<hr class="catBoxDivider" />' . "\n"; // to add divider uncomment this line
$content .= '<span class="catBoxPearls">' . (file_exists(DIR_WS_TEMPLATE_IMAGES . 'cathead' . $current_path . '.gif') ? zen_image(DIR_WS_TEMPLATE_IMAGES . 'cathead' . $current_path . '.gif') . '</span>':'Heading 1</span>' . $disp_block_head) . "\n";
break;
} 


---

Duplicate the case...break section for each heading you want.

Navigate to the category that you want to appear just below the heading, and see its "&cPath=xx" in the address bar at the top of your window. Put the number part of that in the case 'xx': statement.

Replace Heading 1 with your heading text - leave the quote ' in front of it.

If you are using an image file for the heading, name it catheadxx.gif and save it in /includes/templates/your_template/images/.

PHP Code:

---

// categories dressing - add (divider and) heading above a cat
switch ($current_path) {
case '23': //replace number with your desired cPath
$content .= '<hr class="catBoxDivider" />' . "\n"; // to add divider uncomment this line
$content .= '<span class="catBoxPearls">' . (file_exists(DIR_WS_TEMPLATE_IMAGES . 'cathead' . $current_path . '.gif') ? zen_image(DIR_WS_TEMPLATE_IMAGES . 'cathead' . $current_path . '.gif') . '</span>':'Cat 23 Heading</span>' . $disp_block_head) . "\n";
break;

case '69': //replace number with your desired cPath
$content .= '<hr class="catBoxDivider" />' . "\n"; // to add divider uncomment this line
$content .= '<span class="catBoxPearls">' . (file_exists(DIR_WS_TEMPLATE_IMAGES . 'cathead' . $current_path . '.gif') ? zen_image(DIR_WS_TEMPLATE_IMAGES . 'cathead' . $current_path . '.gif') . '</span>':'Cat 69 Heading</span>' . $disp_block_head) . "\n";
break;
} 


---

I need help guys, I want to delete this line:

http://img122.imageshack.us/img122/4674/picture2tz2.png

What I can do guys? :(

Quote:

---

Originally Posted by maclancer

I need help guys, I want to delete this line:

http://img122.imageshack.us/img122/4674/picture2tz2.png

---

Set the value for "Categories Separator between links Status" to 0 in the Admin > Configuration > Layout Settings menu.

Thanks a lot, I have another question, can I add this mod to the "information" section? It is possible? how to do it?

It should be possible to make a similar mod for the information sidebox, but it would require mostly new code tailored to that box.

Glenn,

Okay. I got the static headings to work as you explained above. I have a question:

If the Top Category heading is 'static' shouldn't its SubCategories appear under it? It looks like it repeats itself.

Pearls *(Static Top Category-Non-Linked)
Pearls *********(Should not be here/redundant)**************
Fresh Water Pearls *( Should be a sub-category linked to Pearls)
Abalone *( Should be a sub-category linked to Pearls)
Mother of Pearl Shell *( Should be a sub-category linked to Pearls)
River Shell *( Should be a sub-category linked to Pearls)
South Sea Shell Pearls *( Should be a sub-category linked to Pearls)


I want it to look like this. SubCategories appear underneath non-linked items:

Pearls *(Static Top Category-Non-Linked)
Fresh Water Pearls *(Links to section)
Abalone *(Links to section)
Mother of Pearl Shell *(Links to section)
River Shell *(Links to section)
South Sea Shell Pearls *(Links to section)

Glass Beads *(Static Top Category-Non-Linked)
Example *(Links to section)
Example *(Links to section)
Example *(Links to section)

Take a look at fusionbeads.com. I want my main menu to look like theirs. Any help would be appreciated greatly!

Thank you,
Len

The non-linked headings are not the actual category names, they are just additional text.

If you don't want the top categories to be clickable, there is no benefit in the sidebox to having the subcats structurally organized under anything. They can all be top cats, given an explicit sort order in admin so the headings show in the correct places.

For the breadcrumb display, you might want the top cats active, and also for handling in admin. It should be possible to tweak the categories sidebox code so that if a top cat is being processed, only text is generated, not a link. Then you would not need the additional non-linked headings.

2 Questions.

1) Sometimes my Category name goes to 2 lines.

Cookies, Chocolates &
Sweet Favors

I am trying to make it look like:

Cookies, Chocolates &
Sweet Favors

2) When I click on a category it opens up to the sub categories just fine.
but what I wanted to know if there was a way to click on the category again
and have them close back up again.

The mod is on my www.allforyourwedding.com site

The page display doesn't show whatever you intended for your desired example, but I would guess that you want to have the second line of the subcat indented for clarity.

There is not an easy way to do that exactly (that I can think of now anyway), but you can easily make the distinction with line spacing.
Modify your stylesheet declaration to look like this:

Code:

---

a.category-subs-text, a.category-products-text  {
    /*background-color: #ff69ff;*/
    color: #6699aa;
    line-height: .9em;
    margin: .5em 0;
    /*padding: 0.2em 0.3em;*/
    }

---

The line-height will set the line spacing of subcats closer, and the margin will add back space between different subcats.

Adjust to taste.


The re-collapsing function is not available without some kind of custom coding, if at all.