/**
* Render the widget.
*
* @param array $args General widget arguments.
* @param array $instance Specific instance arguments.
* @uses WebcomicTag::webcomic_list_terms()
* @uses WebcomicTag::webcomic_term_cloud()
* @uses WebcomicTag::webcomic_dropdown_terms()
* @uses WebcomicTag::get_webcomic_collection()
*/
public function widget($args, $instance)
{
extract($args);
extract($instance);
$a = array_merge($args, $instance);
$object = get_queried_object();
unset($a['name']);
$a['target'] = empty($a['target']) ? 'archive' : $a['target'];
$a['taxonomy'] = $collection ? "{$collection}_character" : WebcomicTag::get_webcomic_collection() . '_character';
$a['show_option_none'] = __('Select Character', 'webcomic');
if (!empty($object->taxonomy) and $a['taxonomy'] === $object->taxonomy) {
$a['selected'] = $object->term_id;
}
if ('list' === $format) {
$output = WebcomicTag::webcomic_list_terms($a);
} elseif ('dropdown' === $format) {
$output = WebcomicTag::webcomic_dropdown_terms($a);
} else {
$output = WebcomicTag::webcomic_term_cloud($a);
}
if ($output) {
echo $before_widget, empty($title) ? '' : $before_title . $title . $after_title, $output, $after_widget;
}
}
/**
* Return a "cloud" of webcomic characters.
*
* ### Arguments
*
* - `string` **$id** - Value of the id attribute of the wrapping element.
* - `mixed` **$class** - String or array of additional classes for the wrapping element.
* - `integer` **$smallest** - The smallest font size to display links in.
* - `integer` **$largest** - The largest font size to display links in.
* - `string` **$unit** - The CSS unit to use for $smallest and $largest.
* - `string` **$image** - Size of the character avatar to use for character links. Modified by the number of posts in a given character and the $smallest and $largest values.
* - `string` **$before** - Content to display before the output.
* - `string` **$after** - Content to display after the output.
* - `string` **$sep** - Separator to use between links. An empty value generates an unordered list. Defaults to "\n".
* - `string` **$collection** - The collection characters must belong to.
* - `string` **$order** - How to order characters. Defaults to 'RAND'.
* - `mixed` **$callback** - Callback function to use when building links.
* - `boolean` **$show_count** - Whether to display the total number of webcomics featuring a character.
* - `string` **$target** - The target url for characters, one of 'archive', 'first', 'last', or 'random'. Defaults to 'archive'.
* - `integer` **$selected** - The ID of the current character.
*
* <code class="php">
* // render a cloud of webcomic characters
* webcomic_character_cloud();
*
* // render a list cloud of webcomic characters in collection 42 linked to the beginning of each character
* webcomic_character_cloud( array( 'collection' => 'webcomic42', 'target' => 'first', 'sep' => '' ) );
*
* // render a cloud of thumbnail-sized webcomic avatars
* webcomic_character_cloud( array( 'image' => 'thumbnail' ) );
* </code>
*
* <code class="bbcode">
* // render a cloud of webcomic characters
* [webcomic_character_cloud]
*
* // render a list cloud of webcomic characters in collection 42 linked to the beginning of each character
* [webcomic_character_cloud collection="webcomic42" target="first" sep=""]
*
* // render a cloud of thumbnail-sized webcomic avatars
* [webcomic_character_cloud image="thumbnail"]
* </code>
*
* @package Webcomic
* @param array $args Array of arguments. See function description for detailed information.
* @uses WebcomicTag::get_webcomic_collection()
* @uses WebcomicTag::webcomic_term_cloud()
*/
function webcomic_character_cloud($args = array())
{
$r = wp_parse_args($args, array('id' => '', 'class' => '', 'smallest' => 75, 'largest' => 150, 'unit' => '%', 'image' => '', 'before' => '', 'after' => '', 'sep' => "\n", 'collection' => '', 'order' => 'RAND', 'callback' => '', 'show_count' => false, 'target' => 'archive', 'selected' => 0));
$collection = $r['collection'] ? $r['collection'] : WebcomicTag::get_webcomic_collection();
if (taxonomy_exists("{$collection}_character")) {
$r['taxonomy'] = "{$collection}_character";
echo WebcomicTag::webcomic_term_cloud($r);
}
}
/**
* Handle webcomic_term_cloud shortcodes.
*
* @param array $atts Shortcode attributes.
* @param string $content Shortcode content.
* @param string $name Shortcode name.
* @return string
* @uses WebcomicTag::get_webcomic_collection()
* @uses WebcomicTag::webcomic_term_cloud()
*/
public function webcomic_term_cloud($atts, $content, $name)
{
$r = shortcode_atts(array('id' => '', 'class' => '', 'smallest' => 75, 'largest' => 150, 'unit' => '%', 'image' => '', 'before' => '', 'after' => '', 'sep' => "\n", 'collection' => '', 'order' => 'RAND', 'callback' => '', 'show_count' => false, 'target' => 'archive', 'selected' => 0), $atts);
$collection = $r['collection'] ? $r['collection'] : WebcomicTag::get_webcomic_collection();
if (false !== strpos($name, 'storyline')) {
$tax = 'storyline';
} elseif (false !== strpos($name, 'character')) {
$tax = 'character';
} else {
$tax = '';
}
if (taxonomy_exists("{$collection}_{$tax}")) {
$r['taxonomy'] = "{$collection}_{$tax}";
return WebcomicTag::webcomic_term_cloud($r);
}
}
