/** * 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; } }
/** * Render a list of webcomic characters. * * ### Arguments * * - `string` **$id** - Value of the id attribute of the list element. * - `mixed` **$class** - String or array of additional classes for the list element. * - `string` **$before** - Content to display before the output. * - `string` **$after** - Content to display after the output. * - `boolean` **$ordered** - Use `<ol>` instead of `<ul>`. * - `string` **$collection** - The collection characters must belong to. * - `string` **$orderby** - What field to sort terms by. Defaults to 'name'. * - `object` **$walker** - Custom walker object. Defaults Walker_WebcomicTerm_List. * - `string` **$feed** - Text or image URL to use for a term feed link. * - `string` **$feed_type** - The type of feed to link to. * - `integer` **$depth** - How deep the walker should run. Defaults to 0 (all levels). A -1 depth will result in flat output. * - `boolean` **$webcomics** - Whether to display a list of webcomic posts grouped by term. The 'hide_empty' argument is ignored when $webcomics is true. * - `string` **$webcomic_order** - How to order webcomics, one of 'ASC' or 'DESC'. Defaults to 'ASC'. * - `string` **$webcomic_orderby** - What field to order webcomics by. Defaults to 'date'. See WP_Query for details. * - `string` **$webcomic_image** - Size of the webcomic image to use for webcomic links. * - `boolean` **$show_count** - Whether to display the total number of webcomics in a term. * - `boolean` **$show_description** - Whether to display term descriptions. * - `boolean` **$show_image** - Size of the term image to use for term links. * - `string` **$target** - The target url for terms, one of 'archive', 'first', 'last', or 'random'. Defaults to 'archive'. * - `integer` **$selected** - The ID of the selected term or webcomic. * * <code class="php"> * // render a list of characters with at least one webcomic in the current collection * webcomic_list_characters(); * * // render an ordered list of all characters in collection 42 linked to the beginning of each character * webcomic_list_characters( array( 'collection' => 'webcomic42', 'hide_empty' => false, 'target' => 'first', 'ordered' => true ) ); * * // render a list of published webcomic thumbnails grouped by character in collection 42 with character descriptions * webcomic_list_characters( array( 'collection' => 'webcomic42', 'show_description' => true, 'webcomics' => true, 'webcomic_image' => 'thumbnail' ) ); * </code> * * <code class="bbcode"> * // render a list of characters with at least one webcomic in the current collection * [webcomic_list_characters] * * // render an ordered list of all characters in collection 42 linked to the beginning of each character * [webcomic_list_characters collection="webcomic42" hide_empty="false" target="first" ordered="true"] * * // render a list of published webcomic thumbnails grouped by character in collection 42 with character descriptions * [webcomic_list_characters collection="webcomic42" show_description="true" webcomics="true" webcomic_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_list_terms() */ function webcomic_list_characters($args = array()) { $r = wp_parse_args($args, array('id' => '', 'class' => '', 'before' => '', 'after' => '', 'sep' => '', 'ordered' => '', 'hierarchical' => true, 'collection' => '', 'orderby' => '', 'walker' => false, 'feed' => '', 'feed_type' => 'rss2', 'depth' => 0, 'webcomics' => false, 'webcomic_image' => '', 'show_count' => false, 'show_description' => false, 'show_image' => '', '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_list_terms($r); } }
/** * Handle webcomic_list_terms 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_list_terms() */ public function webcomic_list_terms($atts, $content, $name) { $r = shortcode_atts(array('id' => '', 'class' => '', 'before' => '', 'after' => '', 'sep' => '', 'ordered' => '', 'hierarchical' => true, 'collection' => '', 'orderby' => '', 'walker' => false, 'feed' => '', 'feed_type' => 'rss2', 'depth' => 0, 'webcomics' => false, 'webcomic_image' => '', 'show_count' => false, 'show_description' => false, 'show_image' => '', '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_list_terms($r); } }