Collapsing Categories vs Image Widget

Collapsing Categories creates an expandable list of categories and subcategories. It can also expand to show posts. The primary usage is as a widget, but you can also use the code in your theme manually if you wish (see installation instructions) Options Options can be set from the block panel. If you wish to insert the code into your theme manually instead of using a widget, you can use the following options. These options can be given to the collapsCat() function either as an array or in query style, in the same manner as the wp_list_categories function. $defaults=array( 'showPostCount' => true, 'inExclude' => 'exclude', 'inExcludeCats' => '', 'showPosts' => true, 'showPages' => false, 'linkToCat' => true, 'olderThan' => 0, 'excludeAll' => '0', 'catSortOrder' => 'ASC', 'catSort' => 'catName', 'postSortOrder' => 'ASC', 'postSort' => 'postTitle', 'expand' => '0', 'defaultExpand' => '', 'postTitleLength' => 0, 'accordion' => 0, 'catfeed' => 'none', 'taxonomy' => 'category', 'showPostDate' => false, 'postDateAppend' => 'after', 'postDateFormat' => 'm/d', 'useCookies' => true, 'showTopLevel' => true, 'postsBeforeCats' => false, 'expandCatPost' => true, 'debug'=>'0' ); inExclude Whether to include or exclude certain categories ‘exclude’ (default) ‘include’ inExcludeCats The categories which should be included or excluded showPages Whether or not to include pages as well as posts. Default if false linkToCat 1 (true), clicking on a category title will link to the category archive (default) 0 (false), clicking on a category title expands and collapses catSort How to sort the categorys. Possible values: ‘catName’ the title of the category (default) ‘catId’ the Id of the category ‘catSlug’ the url of the category ‘catCount’ the number of posts in the category ‘catOrder’ custom order specified in the categorys settings catSortOrder Whether categories should be sorted in normal or reverse order. Possible values: ‘ASC’ normal order (a-z 0-9) (default) ‘DESC’ reverse order (z-a 9-0) postSort How to sort the posts. Possible values: ‘postDate’ the date of the post (default) ‘postId’ the Id of the post ‘postTitle’ the title of the post ‘postComment’ the number of comments on the post ‘postOrder’ sort by menu order postSortOrder Whether post should be sorted in normal or reverse order. Possible values: ‘ASC’ normal order (a-z 0-9) (default) ‘DESC’ reverse order (z-a 9-0) expand The symbols to be used to mark expanding and collapsing. Possible values: ‘0’ Triangles (default) ‘1’ + – ‘2’ [+] [-] ‘3’ images (you can upload your own if you wish) ‘4’ custom symbols customExpand If you have selected ‘4’ for the expand option, this character will be used to mark expandable link categories customCollapse If you have selected ‘4’ for the expand option, this character will be used to mark collapsible link categories postTitleLength Truncate post titles to this number of characters (default: 0 = don’t truncate) accordion When set to true, expanding one category closes all others at that level catfeed Whether to add a link to the rss feed for a category. Possible values: ‘none’ (default) ‘text’ shows RSS ‘image’ shows an RSS icon taxonomy Type of taxonmy to display. Possible values: ‘category’ (default) ‘link_category’ ‘post_tag’ ‘both’ (categories and tags) any other registered taxononmy (e.g. recipe press uses recipe-categories) showPostDate When true, show the date of each post postDateAppend Show the date before or after the post title. Possible values: ‘after’ (default) ‘before’ postDateFormat What format the post date is in. This uses the standard php date formatting codes useCookies When true, expanding and collapsing of categories is remembered for each visitor. When false, categories are always display collapsed (unless explicitly set to auto-expand). Possible values: 1 (true) (default) 0 (false) showTopLevel When set to false, the top level category will not be shown. This could be useful if you only want to show subcategories from one particular top-level category 1 (true) (default) 0 (false) postsBeforeCats When set to true, posts in category X will be ordered before subcategories of category X 1 (true) 0 (false) (default) expandCatPost When set to true, any category to which a post is assigned will automatically be expanded on a single post page. 1 (true) (default) 0 (false) showEmptyCat When set to true, empty categories are shown 0 (false) (default) 1 (true) debug When set to true, extra debugging information will be displayed in the underlying code of your page (but not visible from the browser). Use this option if you are having problems Examples collapsCat('catSort=ASC&expand=3&inExcludeCats=general,uncategorized') This will produce a list with: * categories shown in alphabetical order * using images to mark collapsing and expanding * exclude posts from the categories general and uncategorized ` ‘postDate’, ‘postSortOrder’ => ‘DESC’, ) ); } else { wp_get_categories(‘your_options_here’); } echo “ \n”; ?> ` Demo I use this plugin in my blog at http://robfelty.com CAVEAT Currently this plugin relies on Javascript to expand and collapse the links. If a user’s browser doesn’t support javascript they won’t see the links to the posts, but the links to the categories will still work (which is the default behavior in wordpress anyways)

Image Widget is a simple plugin that uses the native WordPress media manager to add image widgets to your site. Image Widget Features Responsive MU Compatible Handles image resizing and alignment Link the image Add title and description Versatile – all fields are optional Upload, link to external image, or select an image from your media collection Customize the look & feel with filter hooks or theme overrides Quality You Can Trust Image Widget is developed and maintained by The Events Calendar, the same folks behind The Events Calendar, Event Tickets, and a full suite of premium plugins. This plugin is actively supported by our team and contributions from community members. If you see a question in the forum you can help with or have a great idea and want to code it up or submit a patch, that would be awesome! Not only will we shower you with praise and thanks, it’s also a good way to get to know us and lead into options for paid work if you freelance. Pull Requests & Translations Check us out on GitHub to pull request changes. Translations can be submitted here on WordPress.org. Documentation The built in template can be overridden by files within your template. Default vs. Custom Templates The Image Widget comes with a default template for the widget output. If you would like to alter the widget display code, create a new folder called “image-widget” in your template directory and copy over the “views/widget.php” file. Edit the new file to your hearts content. Please do not edit the one in the plugin folder as that will cause conflicts when you update the plugin to the latest release. New in 3.2: You may now also use the “sp_template_image-widget_widget.php” filter to override the default template behavior for .php template files. Eg: if you wanted widget.php to reside in a folder called my-custom-templates/ and wanted it to be called my-custom-name.php: add_filter('sp_template_image-widget_widget.php', 'my_template_filter'); function my_template_filter($template) { return get_template_directory() . '/my-custom-templates/my-custom-name.php'; } Filters There are a number of filters in the code that will allow you to override data as you see fit. The best way to learn what filters are available is always by simply searching the code for ‘apply_filters’. But all the same, here are a few of the more essential filters: widget_title This is actually a pretty typical filter in widgets and is applied to the widget title. widget_text Another very typical widget filter that is applied to the description body text. This filter also takes 2 additional arguments for $args and $instance so that you can learn more about the specific widget instance in the process of filtering the content. image_widget_image_attachment_id Filters the attachment id of the image. Accepts additional $args and $instance arguments. image_widget_image_url Filters the url of the image displayed in the widget. Accepts additional $args and $instance arguments. THIS IS DEPRECATED AND WILL EVENTUALLY BE DELETED image_widget_image_width Filters the display width of the image. Accepts additional $args and $instance arguments. image_widget_image_height Filters the display height of the image. Accepts additional $args and $instance arguments. image_widget_image_maxwidth Filters the inline max-width style of the image. Hint: override this to use this in responsive designs 🙂 Accepts additional $args and $instance arguments. Return null to remove this css from the image output (defaults to ‘100%’). image_widget_image_maxheight Filters the inline max-height style of the image. Accepts additional $args and $instance arguments. Return null to remove this css from the image output (defaults to null) image_widget_image_size Filters the selected image ‘size’ corresponding to WordPress registered sizes. If this is set to ‘tribe_image_widget_custom’ then the width and height are used instead. Accepts additional $args and $instance arguments. image_widget_image_align Filters the display alignment of the image. Accepts additional $args and $instance arguments. image_widget_image_alt Filters the alt text of the image. Accepts additional $args and $instance arguments. image_widget_image_link Filters the url that the image links to. Accepts additional $args and $instance arguments. image_widget_image_link_target Filters the link target of the image link. Accepts additional $args and $instance arguments. image_widget_image_attributes Filters a list of image attributes used in the image output. Similar to ‘wp_get_attachment_image_attributes’ Accepts $instance arguments image_widget_link_attributes Filters a list of attributes used in the image link. Similar to ‘wp_get_attachment_image_attributes’ Accepts $instance arguments Have You Supported the Image Widget? If so, then THANK YOU! Also, feel free to add this line to your wp-config.php file to prevent the image widget from displaying a message after upgrades. define( ‘I_HAVE_SUPPORTED_THE_IMAGE_WIDGET’, true ); For more info on the philosophy here, check out our blog post