# essential-widgets/trunk/includes/widgets/class-ew-posts.php

Essential Widgets, version trunk. 336 lines.

- Page: https://pluginprobe.com/plugins/essential-widgets/trunk/code/includes/widgets/class-ew-posts.php
- Raw: https://pluginprobe.com/plugins/essential-widgets/trunk/raw/includes/widgets/class-ew-posts.php
- Modified: 2026-05-26T18:08:48+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/essential-widgets/trunk/code/includes/widgets/class-ew-posts.php#L10-L20`.

```php
<?php

if ( ! defined( 'ABSPATH' ) ) {
    exit; // Exit if accessed directly.
}

/**
 * Posts Widget
 *
 * @package Essential_Widgets
 */


if ( ! class_exists( 'EW_Posts' ) ) :
	/**
	 * Makes a custom Widget for Displaying About
	 *
	 * Learn more: http://codex.wordpress.org/Widgets_API#Developing_Widgets
	 *
	 * @package Essential_Widgets
	 */
	class EW_Posts extends WP_Widget // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedClassFound -- EW_ is this plugin's abbreviated prefix; wrapped in class_exists() guard.
	{


		/**
		 * Holds widget settings defaults, populated in constructor.
		 *
		 * @var array
		 */
		protected $defaults;

		public function __construct() {
			$this->defaults = array(
				'title'       => esc_attr__( 'Posts', 'essential-widgets' ),
				'post_type'   => array( 'post' ),
				'order'       => 'DESC',
				'orderby'     => 'date',
				'number'      => 10,
				'show_date'   => false,
				'show_author' => false,
			);

			$widget_ops = array(
				'classname'   => 'essential-widgets ew-posts ewposts',
				'description' => esc_html__( 'Displays a list of posts.', 'essential-widgets' ),
			);

			$control_ops = array(
				'id_base' => 'ew-posts',
			);

			parent::__construct(
				'ew-posts', // Base ID
				esc_html__( 'EW: Posts', 'essential-widgets' ), // Name
				$widget_ops,
				$control_ops
			);
		}

		/**
		 * Displays the widget control options in the Widgets admin screen.
		 *
		 * @since  1.0.0
		 * @access public
		 * @param  array $instance
		 * @param  void
		 */
		public function form( $instance ) {
			// Merge the user-selected arguments with the defaults.
			$instance = wp_parse_args( (array) $instance, $this->defaults );

			// <select> element options.
			$types = get_post_types( array( 'public' => true ), 'objects' );

			$order = array(
				'ASC'  => esc_attr__( 'Ascending', 'essential-widgets' ),
				'DESC' => esc_attr__( 'Descending', 'essential-widgets' ),
			);

			$orderby = array(
				'author'        => esc_attr__( 'Author', 'essential-widgets' ),
				'name'          => esc_attr__( 'Slug', 'essential-widgets' ),
				'none'          => esc_attr__( 'None', 'essential-widgets' ),
				'type'          => esc_attr__( 'Type', 'essential-widgets' ),
				'date'          => esc_attr__( 'Date', 'essential-widgets' ),
				'ID'            => esc_attr__( 'ID', 'essential-widgets' ),
				'modified'      => esc_attr__( 'Date (Modified)', 'essential-widgets' ),
				'parent'        => esc_attr__( 'Parent', 'essential-widgets' ),
				'comment_count' => esc_attr__( 'Comment Count', 'essential-widgets' ),
				'menu_order'    => esc_attr__( 'Menu Order', 'essential-widgets' ),
				'title'         => esc_attr__( 'Title', 'essential-widgets' ),
			); ?>

			<p>
				<label>
					<?php esc_html_e( 'Title:', 'essential-widgets' ); ?>
					<input type="text" class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'title' ) ); ?>" value="<?php echo esc_attr( $instance['title'] ); ?>" placeholder="<?php echo esc_attr( $this->defaults['title'] ); ?>" />
				</label>
			</p>

			<?php esc_html_e( 'Post Type:', 'essential-widgets' ); ?>

			<div class="wp-tab-panel">
				<ul>
					<?php foreach ( $types as $type ) : ?>

						<li>
							<label>
								<input type="checkbox" name="<?php echo esc_attr( $this->get_field_name( 'post_type' ) ); ?>[]" value="<?php echo esc_attr( $type->name ); ?>" <?php checked( in_array( $type->name, (array) $instance['post_type'], true ) ); ?> />
								<?php echo esc_html( $type->labels->singular_name ); ?>
							</label>
						</li>

					<?php endforeach; ?>
				</ul>
			</div>

			<p>
				<label>
					<?php esc_html_e( 'Number:', 'essential-widgets' ); ?>
					<input
						type="number"
						min="1"
						size="3"
						class="widefat"
						name="<?php echo esc_attr( $this->get_field_name( 'number' ) ); ?>"
						value="<?php echo esc_attr( $instance['number'] ); ?>"
						placeholder="<?php echo esc_attr( $this->defaults['number'] ); ?>"
					/>
				</label>
			</p>

			<p>
				<label>
					<?php esc_html_e( 'Order:', 'essential-widgets' ); ?>

					<select class="widefat" name="<?php echo esc_attr( $this->get_field_name( 'order' ) ); ?>">
						<?php foreach ( $order as $option_value => $option_label ) : ?>
							<option value="<?php echo esc_attr( $option_value ); ?>" <?php selected( $instance['order'], $option_value ); ?>>
								<?php echo esc_html( $option_label ); ?>
							</option>
						<?php endforeach; ?>
					</select>
				</label>
			</p>

			<p>
				<label>
					<?php esc_html_e( 'Order By:', 'essential-widgets' ); ?>

					<select class="widefat" name="<?php echo esc_attr( $this->get_field_name( 'orderby' ) ); ?>">
						<?php foreach ( $orderby as $option_value => $option_label ) : ?>
							<option value="<?php echo esc_attr( $option_value ); ?>" <?php selected( $instance['orderby'], $option_value ); ?>>
								<?php echo esc_html( $option_label ); ?>
							</option>
						<?php endforeach; ?>
					</select>
				</label>
			</p>

			<p>
				<label>
					<input type="checkbox" <?php checked( $instance['show_date'], true ); ?> name="<?php echo esc_attr( $this->get_field_name( 'show_date' ) ); ?>" />
					<?php esc_html_e( 'Display post date?', 'essential-widgets' ); ?>
				</label>
			</p>

			<p>
				<label>
					<input type="checkbox" <?php checked( $instance['show_author'], true ); ?> name="<?php echo esc_attr( $this->get_field_name( 'show_author' ) ); ?>" />
					<?php esc_html_e( 'Display post author?', 'essential-widgets' ); ?>
				</label>
			</p>
			<?php
		}


		/**
		 * update the particular instant
		 *
		 * This function should check that $new_instance is set correctly.
		 * The newly calculated value of $instance should be returned.
		 * If "false" is returned, the instance won't be saved/updated.
		 *
		 * $new_instance New settings for this instance as input by the user via form()
		 * $old_instance Old settings for this instance
		 * Settings to save or bool false to cancel saving
		 */
		public function update( $new_instance, $old_instance ) {
		    $instance = $old_instance;

		    // Sanitize title.
		    $instance['title'] = isset( $new_instance['title'] )
		        ? sanitize_text_field( $new_instance['title'] )
		        : '';

		    // Sanitize post_type array.
		    $instance['post_type'] = isset( $new_instance['post_type'] )
		        ? array_map( 'sanitize_key', (array) $new_instance['post_type'] )
		        : array( 'post' );

		    // Whitelist order options.
		    $order = array( 'ASC', 'DESC' );
		    $instance['order'] = ( isset( $new_instance['order'] ) && in_array( $new_instance['order'], $order, true ) )
		        ? $new_instance['order']
		        : 'DESC';

		    // Whitelist orderby options.
		    $orderby = array( 'author', 'name', 'none', 'type', 'date', 'ID', 'modified', 'parent', 'comment_count', 'menu_order', 'title' );
		    $instance['orderby'] = ( isset( $new_instance['orderby'] ) && in_array( $new_instance['orderby'], $orderby, true ) )
		        ? $new_instance['orderby']
		        : 'date';

		    // Sanitize number input.
		    $instance['number'] = isset( $new_instance['number'] )
		        ? intval( $new_instance['number'] )
		        : 10;

		    // Checkboxes: show_date and show_author.
		    $instance['show_date']   = !empty( $new_instance['show_date'] ) ? 1 : 0;
		    $instance['show_author'] = !empty( $new_instance['show_author'] ) ? 1 : 0;

		    return $instance;
		}


		/**
		 * Displays the Widget in the front-end.
		 *
		 * $args Display arguments including before_title, after_title, before_widget, and after_widget.
		 * $instance The settings for the particular instance of the widget
		 */
		public function widget( $args, $instance ) {
			// Merge instance with defaults.
			$instance = wp_parse_args( $instance, $this->defaults );

			$loop = new \WP_Query(
				array(
					'posts_per_page'      => $instance['number'],
					'post_type'           => $instance['post_type'],
					'order'               => $instance['order'],
					'orderby'             => $instance['orderby'],
					'no_found_rows'       => true,
					'post_status'         => 'publish',
					'ignore_sticky_posts' => true,
				)
			);

			if ( $loop->have_posts() ) :

				// Escape widget wrapper attributes.
				echo wp_kses_post( $args['before_widget'] );

				// If a title was input by the user, display it safely.
				if ( ! empty( $instance['title'] ) ) {
					echo wp_kses_post( $args['before_title'] );

					// Apply filters to title, then escape it for output
					$title = apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base );
					echo esc_html( $title );

					echo wp_kses_post( $args['after_title'] );
				}

				// Output the main content of the widget (shortcode output)
				echo wp_kses_post( $this->shortcode( $instance ) );

				// Close the widget wrapper safely.
				echo wp_kses_post( $args['after_widget'] );

				wp_reset_postdata();

			endif;
		}

		public function shortcode( $atts ) {
			$atts = wp_parse_args( $atts, $this->defaults );

			$loop = new \WP_Query(
				array(
					'posts_per_page'      => $atts['number'],
					'post_type'           => $atts['post_type'],
					'order'               => $atts['order'],
					'orderby'             => $atts['orderby'],
					'no_found_rows'       => true,
					'post_status'         => 'publish',
					'ignore_sticky_posts' => true,
				)
			);

			$output = '';

			// Only show this title in block element and not on widget.
			if ( isset( $atts['is_block'] ) && true === $atts['is_block'] && !empty( $atts['title'] ) ) {
				$output .= '<h2 class="ew-post-block-title">' . esc_html( $atts['title'] ) . '</h2>';
			}

			// Output the page list.
			$output .= '<ul>';
			while ( $loop->have_posts() ) :
				$loop->the_post();

				$output .= '<li>';
				$output .= '<a href="' . esc_url( get_the_permalink() ) . '">' . esc_html( get_the_title() ) . '</a>';

				if ( $atts['show_author'] ) :
					$output .= '<span class="post-author"> by ' . esc_html( get_the_author() ) . '</span>';
				endif;

				if ( $atts['show_date'] ) :
					$output .= ' <span class="post-date">' . esc_html( get_the_date() ) . '</span>';
				endif;
				$output .= '</li>';

			endwhile;

			$output .= '</ul>';
			return $output;
		}
	}
endif;


if ( ! function_exists( 'ew_posts_register' ) ) :
	/**
	 * Intiate About_Widget Class.
	 *
	 * @since 1.0.0
	 */
	function ew_posts_register() { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedFunctionFound -- ew_ is this plugin's abbreviated prefix.
		register_widget( 'EW_Posts' );
	}
	add_action( 'widgets_init', 'ew_posts_register' );
endif;

```