README

=== Select Posts Widget ===

Contributors: matstars
Tags: post, widget
Tested up to: 4.0 Requires at least: 3.5
Stable tag: 0.6.0 License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

== Description == An easy to use (and extend) widget that allows you to selectively curate posts using a simple drag and drop interface.

The following filters are available:

• spw_template to override the output template for the widget, see below for more information. Passes an optional second argument of the widget id.
• widget_title this is a WordPress core filter see here for more information.
• spw_post_types to override the post types available for this widget. Passes an optional second argument of the widget id.

== Installation ==

See Installing Plugins.

== Frequently Asked Questions ==

= How do you use a custom template? =

Simply extend the plugin using the spw_template filter.

<?php
    add_filter( 'spw_template', 'customize_spw_template_filter' );
    function customize_spw_template_filter( $template ){
        $template_dir = get_template_directory();
        return $template_dir . '/views/custom-spw.php';
    }
?>

= How do I set the plugin to use post types besides/in addition to post? =

Simply extend the plugin using the spw_select_posts_widget filter.

<?php
    add_filter( 'spw_select_posts_widget-15_template', 'customize_spw_post_types' );
    function customize_spw_post_types($post_types){
        $post_types = array( 'post', 'page' 'custom_post_type' );
        return $post_types;
    }
?>

== Changelog ==

0.6.0
*Works with widget section in the theme customizer *Filter post types globally or per post type (by passing optional argument of widget id in spw_template and spw_post_types filters)

0.5.1
Changed composer type to wordpress-plugin (was library)

0.5.0
Bound javascript events on 'body' instead of '.widget' to ensure events persist after destroying/creating widget Added templating for individual widgets Added indicator if no posts are selected Refactored WET code Updated code comments

0.4.1
Added readme

0.4
Added filter to allow developers ability to use custom template for widget