devot:eeDevoted to ExpressionEngine

Parameters

channel=“channel_short_name”
Will return all category groups assigned to the channel.

category_groups=“1|2|3”
Will return those specific category groups.

include_categories=“no”
Defaults to yes, but if you only want to return the category groups, you can set it to “no” to reduce queries.

Example Usage

Category Structure:

Colorado (group)

• Boulder
• Denver
• Springfield

North Carolina (group)

• Chapel Hill
• Durham
• Raleigh

Virginia (group)

• Alexandria
• Arlington
• Falls Church

Now, let’s say that you want to return a list of the states and cities:

{exp:vl_category_groups
	channel="location"
}
	{if count == "1"}
		<ul>
	{/if}
	
	<li>
		<strong>{category_group_name}</strong>
		{categories}
			{if category_count == "1"}
				<ul>
			{/if}
			
			<li>
				<a href="/locations/city/{category_url_title}">{category_name}</a>
			</li>
			
			{if category_count == total_categories}
				</ul>
			{/if}
		{/categories}
	</li>
	
	{if count == total_results}
		</ul>
	{/if}
{/exp:vl_category_groups}