Image Widget vs WP LIST PAGES BY CUSTOM TAXONOMY

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

This plugin will provide a new widget in the Widgets Section, so you can easily add it in any widgetized area of your theme. With this widget you will be able to list pages or posts or any other post-type, filtering them by terms of categories, tags and any other active custom taxonomy. You can add filtering by Custom Meta Field value, and decide how to order the list. You can also choose to display only Title, or to add Thumbnails, Excerpts and Date. Or you could display only the image with the details on rollover! Its scope is very similar to the default Recent Posts widget, but you’ll have tons of options and you can use it for any post-type and taxonomy. Now you can also set the max width of the thumbnail, and the excerpt length, so the listing can display nicely even on larger widgetized areas. “This is the last listing widget plugin you’ll ever need to download” the main features of the widget are: Decide how many entries to display Choose which Post-Type you want to list Choose which Taxonomy will be used as filter Choose which Terms to narrow your list with (or choose “any” term of the selected taxonomy) Select multiple terms at once Include or exclude children terms of the selected ones Filter by Custom Meta Fields values (full list of comparison operators) Automatically lists in dropdown selectors, all available post-types, taxonomies, terms, and meta fields! no need to find their slugs or ids! Order by ID, Date, Last Modified Date, Title, Comments, Page Order, Meta Field, or Random Order Ascendant or Descendant Choose if display Thumbnails, and if link them to the post url Choose which Thumbnail Size to pull from the database Set Thumbnail max width Choose the thumb alignment (left, right or centered above) Choose if display Excerpts Set Excerpt length (in characters) Choose if to display Date (or “Last Modified” Date) and which alignment Decide if text content can flow below the image or rather stay on its side Eventually force the titles to stay on one line and hide the overflowing Truncate the title after a specific amount of characters Exclude specific posts/pages from the listing Exclude current post image placeholder if no-thumb is found Choose to display results into a simple dropdown Choose to display only image If only-image, choose to display post data on mouse hover Act as SubPages Nav Menu! (Display only the Children of the same current Parent) Display the current Parent/Page as Widget Title Add text or html above the list Several filter hooks available for manipulating the plugin logic (for developers) Also, the plugin is structured to allow easy overriding of the output template. Just duplicate the file pbytax-template.php that you’ll find within the plugin subfolder “templates”, and put it in your theme folder. You can also take advantage of a few useful filter hooks (see FAQ)! the widget is built with a very little css styling, in order to adapt perfectly in any theme. though, if you want to style it up, all the html elements have been named with specific classes, to allow easy targetting in your css file. if you’d like me to add a new feature to the widget, please let me know by writing a post in the support forum , and hopefully I will add it to the next version of WP List Pages by Custom Taxonomy. If this plugin has been helpful for you, please don’t forget to review it and consider to make a donation. Don’t be shy, a couple of dollars would still make me happy! 🙂