Tags lists

Improved post tags plugin for Bludit CMS.

Sidebar Tags List

The sidebar tags 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 tags plugin for those who have already written custom CSS for the sidebar tags list.

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

Default Settings

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

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

Template Tags

The tags 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 TagLists namespace and backslash before the function call.

<?php TagLists\tags_list(); ?>

The following example demonstrates the addition of a list label.

<?php TagLists\tags_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
$tags_list = [
	'show_count' => true,
	'label_el'   => 'h3',
	'direction'  => 'horz'
];
echo TagLists\tags_list( $tags_list );
?>