devot:eeDevoted to ExpressionEngine

PARAMETERS

1) parent_id - Required. Allows you to specify parent category id number
  (the id number of each category is displayed in the Control Panel).
  You can stack parent categories using pipe character e.g. parent=“3|16|28”.

2) site - Optional. Default value is “1”.

3) invalid_input - Optional. Accepts two values: “alert” and “silence”.
Default value is “silence”. If the value is “alert”, then in cases when some
parameter’s value is invalid plugin exits and PHP alert is being shown;
if the value is “silence”, then in cases when some parameter’s value
is invalid plugin finishes its work without any alert being shown.
Set this parameter to “alert” for development, and to “silence” - for deployment.

VARIABLES

For outputting of parent categories the plugin supports huge number of variables of the types outlined below.
The number next to the word “parent” in them indicates the order or parent_id inside value of “parent” parameter. So, if
we have parent=“8|11|15” then the category having id “8” will outputted as “parent0”, the category having id “11”
will outputted as “parent1”, and the category having id “15” will outputted as “parent2”.

1) {cat_bunch_parent0_cat_id}, {cat_bunch_parent1_cat_id}, {cat_bunch_parent2_cat_id} ...
{cat_bunch_parent99_cat_id}.

2) {cat_bunch_parent0_cat_name}, {cat_bunch_parent1_cat_name}, {cat_bunch_parent2_cat_name} ...
{cat_bunch_parent99_cat_name}.

3) {cat_bunch_parent0_cat_url_title}, {cat_bunch_parent1_cat_url_title}, {cat_bunch_parent2_cat_url_title} ... 
{cat_bunch_parent99_cat_url_title}.

4) {cat_bunch_parent0_parent_id}, {cat_bunch_parent1_parent_id}, {cat_bunch_parent2_parent_id} ...
{cat_bunch_parent99_parent_id}.

5) {cat_bunch_parent0_group_id}, {cat_bunch_parent1_group_id}, {cat_bunch_parent2_group_id} ...
{cat_bunch_parent99_group_id}.

6) {cat_bunch_parent0_cat_description}, {cat_bunch_parent1_cat_description}, {cat_bunch_parent2_cat_description} ...
{cat_bunch_parent99_cat_description}.

7) {cat_bunch_parent0_cat_image}, {cat_bunch_parent1_cat_image}, {cat_bunch_parent2_cat_image} ...
{cat_bunch_parent99_cat_image}.

8) {cat_bunch_parent0_entries_number}, {cat_bunch_parent1_entries_number}, {cat_bunch_parent2_entries_number} ... 
{cat_bunch_parent99_entries_number}.

For outputting of child categories the plugin supports huge number of variables of the types outlined below.
The number next to the word “parent” in them indicates the order or parent_id inside value of “parent” parameter. So, if
we have parent=“8|11|15” then the category having id “8” will outputted as “parent0”, the category having id “11”
will outputted as “parent1”, and the category having id “15” will outputted as “parent2”.
The number next to the word “child” in them indicates custom order of category assigned in Control Panel, i.e. child
categories will be ordered as they are ordered in Control Panel.

1) {cat_bunch_parent0_child0_cat_id}, {cat_bunch_parent0_child1_cat_id}, {cat_bunch_parent0_child2_cat_id} ...
{cat_bunch_parent1_child0_cat_id}, {cat_bunch_parent1_child1_cat_id}, {cat_bunch_parent1_child2_cat_id} ...
{cat_bunch_parent99_child99_cat_id}.

2) {cat_bunch_parent0_child0_cat_name}, {cat_bunch_parent0_child1_cat_name}, {cat_bunch_parent0_child2_cat_name} ...
{cat_bunch_parent1_child0_cat_name}, {cat_bunch_parent1_child1_cat_name}, {cat_bunch_parent1_child2_cat_name} ...
{cat_bunch_parent99_child99_cat_name}.

3) {cat_bunch_parent0_child0_cat_url_title}, {cat_bunch_parent1_child1_cat_url_title}, {cat_bunch_parent2_child2_cat_url_title} ...
{cat_bunch_parent1_child0_cat_url_title}, {cat_bunch_parent1_child1_cat_url_title}, {cat_bunch_parent1_child2_cat_url_title} ... 
{cat_bunch_parent99_child99_cat_url_title}.

4) {cat_bunch_parent0_child0_parent_id}, {cat_bunch_parent0_child1_parent_id}, {cat_bunch_parent0_child2_parent_id} ...
{cat_bunch_parent1_child0_parent_id}, {cat_bunch_parent1_child1_parent_id}, {cat_bunch_parent1_child2_parent_id} ...
{cat_bunch_parent99_child99_parent_id}.

5) {cat_bunch_parent0_child0_group_id}, {cat_bunch_parent0_child1_group_id}, {cat_bunch_parent0_child2_group_id} ...
{cat_bunch_parent1_child0_group_id}, {cat_bunch_parent1_child1_group_id}, {cat_bunch_parent1_child2_group_id} ...
{cat_bunch_parent99_child99_group_id}.

6) {cat_bunch_parent0_child0_cat_description}, {cat_bunch_parent0_child1_cat_description}, {cat_bunch_parent0_child2_cat_description} ...
{cat_bunch_parent1_child0_cat_description}, {cat_bunch_parent1_child1_cat_description}, {cat_bunch_parent1_child2_cat_description} ...
{cat_bunch_parent99_child99_cat_description}.

7) {cat_bunch_parent0_child0_cat_image}, {cat_bunch_parent0_cat_child1_image}, {cat_bunch_parent0_child2_cat_image} ...
{cat_bunch_parent1_child0_cat_image}, {cat_bunch_parent1_child1_cat_image}, {cat_bunch_parent1_child2_cat_image} ...
{cat_bunch_parent99_child99_cat_image}.

8) {cat_bunch_parent0_child0_entries_number}, {cat_bunch_parent0_child1_entries_number}, {cat_bunch_parent0_child2_entries_number} ...
{cat_bunch_parent1_child0_entries_number}, {cat_bunch_parent1_child1_entries_number}, {cat_bunch_parent1_child2_entries_number} ...
{cat_bunch_parent99_child99_entries_number}.

Conditionals are supported for all variables.

USAGE EXAMPLE

{exp:cat_bunch parent_id="17" site="1"}

{if cat_bunch_parent0_entries_number > 0}

<h1>{cat_bunch_parent0_cat_name}, {cat_bunch_parent0_entries_number}</h1>
{cat_bunch_parent0_child0_cat_name}, {cat_bunch_parent0_child0_entries_number}

{cat_bunch_parent0_child1_cat_name}, {cat_bunch_parent0_child1_entries_number}

{cat_bunch_parent0_child2_cat_name}, {cat_bunch_parent0_child2_entries_number}

{cat_bunch_parent0_child3_cat_name}, {cat_bunch_parent0_child3_entries_number}


{/if}

{/exp:cat_bunch}