Name ), // Name. array( 'classname' => 'beetle_magazine_posts_grid', 'description' => esc_html__( 'Displays your posts from a selected category in a grid layout. Please use this widget ONLY in the Magazine Homepage widget area.', 'beetle' ), 'customize_selective_refresh' => true, ) // Args. ); // Delete Widget Cache on certain actions. add_action( 'save_post', array( $this, 'delete_widget_cache' ) ); add_action( 'deleted_post', array( $this, 'delete_widget_cache' ) ); add_action( 'switch_theme', array( $this, 'delete_widget_cache' ) ); } /** * Set default settings of the widget */ private function default_settings() { $defaults = array( 'title' => '', 'category' => 0, 'layout' => 'three-columns', 'number' => 6, 'excerpt' => false, 'meta_date' => true, 'meta_author' => false, ); return $defaults; } /** * Main Function to display the widget * * @uses this->render() * * @param array $args / Parameters from widget area created with register_sidebar(). * @param array $instance / Settings for this widget instance. */ function widget( $args, $instance ) { $cache = array(); // Get Widget Object Cache. if ( ! $this->is_preview() ) { $cache = wp_cache_get( 'widget_beetle_magazine_posts_grid', 'widget' ); } if ( ! is_array( $cache ) ) { $cache = array(); } // Display Widget from Cache if exists. if ( isset( $cache[ $this->id ] ) ) { echo $cache[ $this->id ]; return; } // Start Output Buffering. ob_start(); // Get Widget Settings. $settings = wp_parse_args( $instance, $this->default_settings() ); // Output. echo $args['before_widget']; ?>
widget_title( $args, $settings ); ?>
render( $settings ); ?>
is_preview() ) { $cache[ $this->id ] = ob_get_flush(); wp_cache_set( 'widget_beetle_magazine_posts_grid', $cache, 'widget' ); } else { ob_end_flush(); } } // widget() /** * Renders the Widget Content * * Switches between two or three column layout style based on widget settings * * @uses this->magazine_posts_two_column_grid() or this->magazine_posts_three_column_grid() * @used-by this->widget() * * @param array $settings / Settings for this widget instance. */ function render( $settings ) { if ( 'three-columns' === $settings['layout'] ) : $this->magazine_posts_three_column_grid( $settings ); else : $this->magazine_posts_two_column_grid( $settings ); endif; } // render() /** * Displays category posts in two column grid * * @used-by this->render() * * @param array $settings / Settings for this widget instance. */ function magazine_posts_two_column_grid( $settings ) { // Get latest posts from database. $query_arguments = array( 'posts_per_page' => (int) $settings['number'], 'ignore_sticky_posts' => true, 'cat' => (int) $settings['category'], ); $posts_query = new WP_Query( $query_arguments ); $i = 0; // Check if there are posts. if ( $posts_query->have_posts() ) : // Limit the number of words for the excerpt. add_filter( 'excerpt_length', 'beetle_magazine_posts_excerpt_length' ); // Display Posts. while ( $posts_query->have_posts() ) : $posts_query->the_post(); // Open new Row on the Grid. if ( 0 === $i % 2 ) : $row_open = true; ?>
>
', esc_url( get_permalink() ) ), '' ); ?> entry_meta( $settings ); ?>
render() * * @param array $settings / Settings for this widget instance. */ function magazine_posts_three_column_grid( $settings ) { // Get latest posts from database. $query_arguments = array( 'posts_per_page' => (int) $settings['number'], 'ignore_sticky_posts' => true, 'cat' => (int) $settings['category'], ); $posts_query = new WP_Query( $query_arguments ); $i = 0; // Check if there are posts. if ( $posts_query->have_posts() ) : // Limit the number of words for the excerpt. add_filter( 'excerpt_length', 'beetle_magazine_posts_excerpt_length' ); // Display Posts. while ( $posts_query->have_posts() ) : $posts_query->the_post(); // Open new Row on the Grid. if ( 0 === $i % 3 ) : $row_open = true; ?>
>
', esc_url( get_permalink() ) ), '' ); ?> entry_meta( $settings ); ?>
' . $postmeta . ''; } } // entry_meta() /** * Displays Widget Title * * @param array $args / Parameters from widget area created with register_sidebar(). * @param array $settings / Settings for this widget instance. */ function widget_title( $args, $settings ) { // Add Widget Title Filter. $widget_title = apply_filters( 'widget_title', $settings['title'], $settings, $this->id_base ); if ( ! empty( $widget_title ) ) : // Link Category Title. if ( $settings['category'] > 0 ) : // Set Link URL and Title for Category. $link_title = sprintf( esc_html__( 'View all posts from category %s', 'beetle' ), get_cat_name( $settings['category'] ) ); $link_url = esc_url( get_category_link( $settings['category'] ) ); // Display Widget Title with link to category archive. echo '
'; echo '

'. $widget_title . '

'; echo '
'; else : // Display default Widget Title without link. echo $args['before_title'] . $widget_title . $args['after_title']; endif; endif; } // widget_title() /** * Update Widget Settings * * @param array $new_instance / New Settings for this widget instance. * @param array $old_instance / Old Settings for this widget instance. * @return array $instance */ function update( $new_instance, $old_instance ) { $instance = $old_instance; $instance['title'] = sanitize_text_field( $new_instance['title'] ); $instance['category'] = (int) $new_instance['category']; $instance['layout'] = esc_attr( $new_instance['layout'] ); $instance['number'] = (int) $new_instance['number']; $instance['excerpt'] = ! empty( $new_instance['excerpt'] ); $instance['meta_date'] = ! empty( $new_instance['meta_date'] ); $instance['meta_author'] = ! empty( $new_instance['meta_author'] ); $this->delete_widget_cache(); return $instance; } /** * Displays Widget Settings Form in the Backend * * @param array $instance / Settings for this widget instance. */ function form( $instance ) { // Get Widget Settings. $settings = wp_parse_args( $instance, $this->default_settings() ); ?>


esc_html__( 'All Categories', 'beetle' ), 'show_count' => true, 'hide_empty' => false, 'selected' => $settings['category'], 'name' => $this->get_field_name( 'category' ), 'id' => $this->get_field_id( 'category' ), ); wp_dropdown_categories( $args ); ?>