Categories Lists

Improved categories plugin for Bludit CMS.

Sidebar Categories List

The sidebar categories list requires no coding and is enabled by default. It can be disabled on the settings page. The HTML markup and the CSS classes for the list are nearly identical to the original Bludit categories plugin for those who have already written custom CSS for the sidebar categories list.

When enabled, the sidebar categories list has several options for customizing to your needs.

Default Settings

The array below is the complete array of arguments used to construct a categories list. Any of these can be overridden with an array of arguments passed to a function call. These are also used by the sidebar categories list but array values are overridden by the plugin with settings values.

<?php
$defaults = [
	'wrap'       => false,
	'wrap_class' => 'list-wrap cats-list-wrap',
	'direction'  => 'vert', // horz or vert
	'list_class' => 'categories-list standard-taxonomy-list',
	'label'      => false,
	'label_el'   => 'h2',
	'links'      => true,
	'show_count' => false,
	'hide_empty' => true
];
?>

Template Tags

The categories list function accepts an array of arguments to override the function defaults. It is also namespaced so the function must be preceded by the namespace or aliased.

Following is an example of displaying a default list in a theme template. Note the CatLists namespace and backslash before the function call.

<?php CatLists\cats_list(); ?>

The following example demonstrates the addition of a list label.

<?php CatLists\cats_list( [ 'label' => $L->get( 'Content Types' ) ] ); ?>

The following example shows the post count, modifies the heading element, and changes the direction. Changing the direction of the list requires you to add CSS if you override the default classes.

<?php
$cats_list = [
	'show_count' => true,
	'label_el'   => 'h3',
	'direction'  => 'horz'
];
echo CatLists\cats_list( $cats_list );
?>