Need help adding additional controls to a custom widget Part 2

Here is an updated version of the widget which handles the vertical layout option, including categories, and excluding categories.

Handling the vertical layout option is pretty straightforward; we just check to see if the option is checked, and if so, output the appropriate classes.

Handling the inclusion/exclusion of categories is a little more complex because we are taking those settings in from the user as strings (comma separated list of IDs) and converting those values into arrays for use in the WP_Query parameters category__in and category__not_in.

class chimp_post_widget extends WP_Widget {
    function __construct() {
            //Create Widget
            parent::__construct(
                    'post_display_widget',
                    esc_html__('The Post Widget','text_domain'),
                    array(
                            'classname'       =>    'post-widget',
                            'description'     =>    esc_html__('A Post Thumbnail Widget', 'text_domain' )
                    )
            );
    }

    public function form( $instance ) {
        $title = isset( $instance['title'] ) ? $instance['title'] : '';
        $number_of_posts = isset( $instance['number_of_posts'] ) ? absint( $instance['number_of_posts'] ) : 5;
        $number_of_words = isset( $instance['number_of_words'] ) ? absint( $instance['number_of_words'] ) : 20;

        $cat_include = isset( $instance['cat_include'] ) ? $instance['cat_include'] : '';
        $cat_exclude = isset( $instance['cat_exclude'] ) ? $instance['cat_exclude'] : '';

        $vertical_sidebar_check =  isset( $instance[ 'vertical_sidebar_check' ] ) && ( 'on' === $instance[ 'vertical_sidebar_check' ] ) ? 'on' : 'off';
        ?>
        <p><label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e( 'Title:', 'text_domain' ); ?></label>
        <input class="widefat" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>" /></p>

        <p><label for="<?php echo $this->get_field_id( 'number_of_posts' ); ?>"><?php _e( 'Number of projects to show:', 'text_domain' ); ?></label>
        <input class="tiny-text" id="<?php echo $this->get_field_id( 'number_of_posts' ); ?>" name="<?php echo $this->get_field_name( 'number_of_posts' ); ?>" type="number" step="1" min="1" value="<?php echo $number_of_posts; ?>" size="3" /></p>

        <p><label for="<?php echo $this->get_field_id( 'number_of_words' ); ?>"><?php _e( 'Set the word limit for project descriptions:', 'text_domain' ); ?></label>
        <input class="tiny-text" id="<?php echo $this->get_field_id( 'number_of_words' ); ?>" name="<?php echo $this->get_field_name( 'number_of_words' ); ?>" type="number" step="1" min="1" value="<?php echo $number_of_words; ?>" size="4" /></p>

        <p><label for="<?php echo $this->get_field_id( 'cat_include' ); ?>"><?php _e( 'Include Categories:', 'text_domain' ); ?></label>
        <input class="widefat" id="<?php echo $this->get_field_id( 'cat_include' ); ?>" name="<?php echo $this->get_field_name( 'cat_include' ); ?>" type="text" value="<?php echo esc_attr( $cat_include ); ?>" />
        <small>Comma separated list of category IDs to <strong>include</strong> in post query. e.g.: 11,17,347<br>If blank, all categories will be included.</small>
        </p>

        <p><label for="<?php echo $this->get_field_id( 'cat_exclude' ); ?>"><?php _e( 'Exclude Categories:', 'text_domain' ); ?></label>
        <input class="widefat" id="<?php echo $this->get_field_id( 'cat_exclude' ); ?>" name="<?php echo $this->get_field_name( 'cat_exclude' ); ?>" type="text" value="<?php echo esc_attr( $cat_exclude ); ?>" />
        <small>Comma separated list of category IDs to <strong>exclude</strong> in post query. e.g.: 1,16<br>If blank, no categories will be excluded.</small>
        </p>

        <p><input class="checkbox" type="checkbox" <?php checked( $vertical_sidebar_check, 'on' ); ?> id="<?php echo $this->get_field_id( 'vertical_sidebar_check' ); ?>" name="<?php echo $this->get_field_name( 'vertical_sidebar_check' ); ?>" />
        <label for="<?php echo $this->get_field_id( 'vertical_sidebar_check' ); ?>"><?php _e('Select for Vertical Sidebar', 'text-domain'); ?></label></p>


         <?php
    }

    public function update($new_instance, $old_instance) {
        $instance = $old_instance;
        $instance['title']           = sanitize_text_field( $new_instance['title'] );
        $instance['number_of_posts'] = absint( $new_instance['number_of_posts'] );
        $instance['number_of_words'] = absint( $new_instance['number_of_words'] );
        $instance['cat_include']     = sanitize_text_field( $new_instance['cat_include'] );
        $instance['cat_exclude']     = sanitize_text_field( $new_instance['cat_exclude'] );
        $instance[ 'vertical_sidebar_check' ] = isset( $new_instance[ 'vertical_sidebar_check' ] ) && ( 'on' === $new_instance[ 'vertical_sidebar_check' ] ) ? 'on' : 'off';
        return $instance;
    }

    public function widget($args, $instance) {
        extract( $args );

        $title = apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base );

        echo $args['before_widget'];
        if ( $title ) {
            echo $args['before_title'] . $title . $args['after_title'];
        }

        $number_of_posts = ( ! empty( $instance['number_of_posts'] ) ) ? absint( $instance['number_of_posts'] ) : 5;
        if ( ! $number_of_posts ) {
            $number_of_posts = 5;
        }

        $number_of_words = ( ! empty( $instance['number_of_words'] ) ) ? absint( $instance['number_of_words'] ) : 20;
        if ( ! $number_of_words ) {
            $number_of_words = 20;
        }

        // Convert comma separated string to array for use in WP_Query.
        $category_include = $instance['cat_include'];
        if ( $category_include ) {
            $category_include = explode( ',', $instance['cat_include'] );
        } else {
            $category_include = array();
        }

        // Convert comma separated string to array for use in WP_Query.
        $category_exclude = $instance['cat_exclude'];
        if ( $category_exclude ) {
            $category_exclude = explode( ',', $instance['cat_exclude'] );
        } else {
            $category_exclude = array();
        }

        $vertical_sidebar_check = isset( $instance[ 'vertical_sidebar_check' ] ) && ( 'on' === $instance[ 'vertical_sidebar_check' ] ) ? 'on' : 'off';

        /* Create a custom query and get the most recent x projects. */
        $queryArgs = array(
            'category__in' => $category_include,
            'category__not_in' => $category_exclude,
            /* Order by date. */
            'orderby' => 'date',
            /* Show all posts. */
            'posts_per_page' => $number_of_posts,
        );

        $query = new WP_Query( $queryArgs );
        if ( $query->have_posts() ) : ?>
                <ul class="unbullet<?php echo $vertical_sidebar_check === 'on' ? ' unbullet-v' : ''; ?>">
                <?php while ( $query->have_posts() ) : $query->the_post(); ?>
                        <li class="snippet-box<?php echo $vertical_sidebar_check === 'on' ? ' vertical' : ''; ?>">
                            <div>
                                <!-- <img src="http://heightandweights.com/wp-content/uploads/2014/10/Beautiful-Lindsey-Vonn.jpg" alt="" class="hundred"> -->
                                <?php the_post_thumbnail( 'medium', array( 'class' => 'hundred' ) ); ?>
                                <div class="snippet-text">
                                    <h3><a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a></h3>
                                    <p><?php echo wp_trim_words( get_the_excerpt(), $number_of_words , __( '&hellip;', 'text_domain' ) ); ?></p>
                                </div>
                            </div>
                            <!-- <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_post_thumbnail( 'large', array( 'class' => 'img-responsive' ) ); ?></a> -->
                        </li>
                <?php endwhile; ?>
                </ul>
        <?php endif;
        /* Display the markup after the widget. */
        echo $after_widget;
    }
}

add_action('widgets_init', function(){
    register_widget('chimp_post_widget');
});

Related Posts:

  1. How can I use the built in WordPress “browse link” functionality?
  2. Modifying the default search widget
  3. How to build widget with arrays inside arrays?
  4. How do I save data from submitted form from widget
  5. How to listen to color changes on the color picker?
  6. Add New Footer Widget Area with Limited Options?
  7. Add div class to only one widget
  8. How to use control_callback when creating a widget via functions.php or plugin?
  9. Disable default WordPress widgets in sidebar
  10. Adding classes to dynamic sidebar
  11. iris color picker in widget – click event doesn’t fire when initially when widget is first created
  12. Custom widget using get_categories select menu dropdown
  13. Find if widget block is active
  14. Elegantly using JavaScript on widget admin forms
  15. Widget queries even when there are no sidebars?
  16. Multiple users editting widgets
  17. How to rename wordpress Widget
  18. How to hack recent comments default widget?
  19. Recent Posts widget without Title
  20. Pre-install widgets in WP-Admin
  21. How to change plugin`s template (view) correctly?
  22. Showing a Thickbox (tb_show) does nothing
  23. jQuery UI inside widget on admin page
  24. How do I add a widget from an Android phone?
  25. Error gets thrown when calling require_once on widget.php
  26. How to activate or install the Gallery Widget?
  27. Custom User Field in Dashboard Widget
  28. Getting a div wrapped around two widgets
  29. How to create a widget that accepts html input?
  30. Widget changes in customizer ajax error to many options?
  31. How to Add TinyMCE to widget
  32. How can I get the first section of a page 100% width, while the rest will have a sidebar? [closed]
  33. Widgets not adding div on before and after title
  34. Dynamically add content to an existing widget area
  35. RSS dashboard widget not showing visuals
  36. Simple widget causing whitescreen
  37. How to stop comments widget conflicting with theme comments
  38. How do I create a widget to embed the code for a sign up form, so that the sign up form appears on every page?
  39. Tabs and Category Widget
  40. How to change the default class for the widget title?
  41. How to add the same widget twice?
  42. How to hide widget if current category has no posts assigned to it?
  43. ‘is_author()’ logic in widget for author only
  44. Unable to load “wpColorPicker” on theme customize page
  45. Undefined Variable in my widget
  46. Update widget form after drag-and-drop “only specific plugin”
  47. Recent Comments from Specific Category Widget
  48. Different sidebars not changing
  49. Placing a widget with $wpdb query
  50. How to make widget appear conditionally
  51. Ampersand breaking Widget title
  52. How to allow editing of text in sidebar?
  53. Shortcode into widget
  54. Want to add more option in “Sexy Login”
  55. How to show avatar of current logged in user in a widget
  56. Got a problem with a widget
  57. Widget control – putting a slideshow in the widget area
  58. WordPress Local to Live and The Missing Widgets!
  59. How do I find out which
  60. Unable to see Widget Submenu under Appearance with Class Based WP_Widget
  61. How to update a widget data?
  62. custom widget not saved to sidebar
  63. When editing in block editor, the post/article gets under the floating widgets
  64. Recently changed domain name. Home page widgets are now not in the customize menu yet still being on the page
  65. Is it possible to dynamically output the name of the widgets?
  66. I accidentally added a widget area called sidebar 1
  67. wp_registered_widgets doesn’t contains my widgets
  68. How can I write this code snippet so that it echo’s the response when submitting empty fields?
  69. What is the difference between widget object and widget instance?
  70. Apply two different styles to Wiget Titles along with a decorative line
  71. How to retrieve category ID’s from widget settings?
  72. My plugin works in home page, but doesn’t work in post page
  73. Widget text color change
  74. Widget to embed youtube video
  75. How to make featured area?
  76. Checking if widget has title not working
  77. wp_list_categories + widget
  78. How can I add widgets to the category page?
  79. How to create another widgets.php page
  80. Remove default WordPress widgets
  81. widget that will do shortcodes that user inputs
  82. Disable wordpress widget automatically on error
  83. Can I add a widget to the of my site?
  84. Widget dynamically add new input field
  85. How to show widget in frontend?
  86. WordPress function breaks widget’s markup?
  87. Registering multiple copies of a widget
  88. How do I stop out of stock items from appearing on my WooCommerce site when using the Layered Nav widget [closed]
  89. Single Widget Multi Sidebar
  90. An issue with register_sidebar and the admin interface
  91. page url in shortcode
  92. iframe/embed vid in text widget loads outside container and moves around when scrolling the page?
  93. menu in different page in different style
  94. Add text to Text Widget using Javascript
  95. Widget on home page displays wrong time compared to same widget on inside pages
  96. Subpages menu on sidebar plus widgets
  97. Widgets in PHP files?
  98. Text Widget Not Working
  99. Sample widget code which get data(1-5 record) from Wp_Admin panel and display to Homepage(WordPress Custom Theme)
  100. getBlockVariations(…) is undefined in Widget and Template Part editors but not Post Editor

Leave a Comment