aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--include/functions_html.inc.php20
1 files changed, 14 insertions, 6 deletions
diff --git a/include/functions_html.inc.php b/include/functions_html.inc.php
index 6e28dc5de..a7752e4c2 100644
--- a/include/functions_html.inc.php
+++ b/include/functions_html.inc.php
@@ -144,12 +144,20 @@ function style_select($default_style, $select_name = "style")
return $style_selected;
}
-// The function get_cat_display_name returns a string containing the list
-// of upper categories to the root category from the lowest category shown
-// example : "anniversaires - fete mere 2002 - animaux - erika"
-// You can give this parameters :
-// - $style : the style of the span tag for the lowest category,
-// "font-style:italic;" for example
+/**
+ * returns the list of categories as a HTML string
+ *
+ * categories string returned contains categories as given in the input
+ * array $cat_informations. $cat_informations array must be an association
+ * of {category_id => category_name}. If url input parameter is empty,
+ * returns only the categories name without links.
+ *
+ * @param array cat_informations
+ * @param string separator
+ * @param string url
+ * @param boolean replace_space
+ * @return string
+ */
function get_cat_display_name($cat_informations,
$separator,
$url = 'category.php?cat=',