【SANGO向けカスタマイズ】SANGO向け「同じカテゴリの人気記事一覧」ウィジェットを自作する

<?php
/**
 * Adds CategoryPopular_Widget widget.
 */
class MyCategoryPopular_Widget extends WP_Widget {

	/**
	 * ウィジェットの実体を作成
	 */
	public function __construct() {
		parent::__construct(
			'my_category_popular_widget',
			'同じカテゴリの人気記事'
		);
	}

	/**
	 * ウィジェットのフロントエンド表示
	 *
	 * @see WP_Widget::widget()
	 *
	 * @param array $args     ウィジェットの引数.
	 * @param array $instance データベースに保存されている設定値.
	 */
	public function widget( $args, $instance ) {

		/* 投稿記事以外は表示しない */
		if ( ! is_single( get_the_ID() ) ) {
			return;
		}

		/* ここから記事一覧の表示 */
		$category = get_the_category( get_the_ID() );

		/* サブクエリの条件を作成 */
		$sub_args = array(
			/* カテゴリを現在表示している投稿記事のものに絞る */
			'category_name'  => $category[0]->category_nicename,
			/* 投稿記事を_my_view_countをキーとするメタデータの数に対して降順に整列 */
			'meta_key'       => 'post_views_count',
			'orderby'        => 'meta_value_num',
			'order'          => 'DESC',
			/* 整列後の投稿記事のデータを設定された表示数分取得 */
			'posts_per_page' => $instance['num'],
		);

		/* サブクエリを発行してデータベースからデータ取得 */
		$my_query = new WP_Query( $sub_args );

		/* データ取得できなかった場合は終了 */
		if ( ! $my_query->have_posts() ) {
			wp_reset_postdata();
			return;
		}

		/* ここからregister_sidebarに入力されたHTMLを出力 */

		/* before_widgetを出力 */
		echo $args['before_widget'];

		/* before_titleとafter_titleを出力 */
		if ( ! empty( $instance['title'] ) ) {
			/* タイトルが設定されている場合のみ出力 */
			echo $args['before_title'] . apply_filters( 'widget_title', $instance['title'] ) . $args['after_title'];
		} else {
			/* タイトルが設定されていない場合の出力 */
			echo '同じカテゴリの人気記事';
		}

		echo '<ul class="my-widget show_num">';

		/* 取得した投稿データをサブループで表示 */
		while ( $my_query->have_posts() ) {
			$my_query->the_post();

			$post_id = get_the_ID();
			/* サムネを表示するHTMLを取得 */
			$thumbnail_id = get_post_thumbnail_id( $post_id );
			$image        = wp_get_attachment_image_src( $thumbnail_id, 'thumbnail' );
			$image_url    = $image[0];
			/* タイトル取得 */
			$title = get_the_title( $post_id );
			/* リンク取得 */
			$link = get_the_permalink( $post_id );
			/* ページビュー数取得 */
			$num_views = get_post_meta( $post_id, 'post_views_count', true );
			/* コメント数取得 */
			$num_comments = get_comments_number( $post_id );

			/* 取得した情報を出力 */
			$output = '';
			$output = $output . '<li>';
			$output = $output . '<a href="' . $link . '">';
			$output = $output . '<figure class="my-widget__img">';
			$output = $output . '<img width="81" height="81" alt="" class="wpp-thumbnail wpp_featured wpp_cached_thumb wpp-lazyloaded" src="' . $image_url . '">';
			$output = $output . '</figure>';
			$output = $output . '<div class="my-widget__text">';
			$output = $output . $title;
			$output = $output . '<span class="dfont views"> <span class="wpp-views">' . $num_views . ' views</span> | <span class="wpp-comments">' . $num_comments . ' comments</span></span>';
			$output = $output . '</div></a></li>';

			echo $output;
		}
		wp_reset_postdata();
		echo '</ul>';

		/* 最後にafter_widgetを出力 */
		echo $args['after_widget'];
	}

	/**
	 * ウィジェットの設定フォームを表示する関数
	 *
	 * @param array $instance : 元々の設定を持つインスタンス.
	 */
	public function form( $instance ) {
		/* 設定値が設定されていない時のデフォルト値設定 */
		if ( ! empty( $instance['title'] ) ) {
			$title = $instance['title'];
		} else {
			$title = '同じカテゴリの人気記事';
		}

		if ( ! empty( $instance['num'] ) ) {
			$num = $instance['num'];
		} else {
			$num = '5';
		}
		?>
		<!-- ウィジェットのタイトル設定フォームを表示 -->
		<p>
		<label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e( 'タイトル:' ); ?></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( 'num' ); ?>"><?php _e( '表示数:' ); ?></label>
		<input class="widefat" id="<?php echo $this->get_field_id( 'num' ); ?>" name="<?php echo $this->get_field_name( 'num' ); ?>" type="text" value="<?php echo esc_attr( $num ); ?>">
		</p>
		<?php
	}

	/**
	 * ウィジェットの設定を更新する関数
	 *
	 * @param array $new_instance : 新しい設定を持つインスタンス.
	 * @param array $old_instance : 元々の設定を持つインスタンス.
	 */
	public function update( $new_instance, $old_instance ) {
		/* サニタイズ後の設定値を格納するための$instanceを作成 */
		$instance = array();

		/*
		 * instance['title']：タイトル
		 * instance['num']：表示数
		 */

		/* タイトルのサニタイズ */
		if ( ! empty( $new_instance['title'] ) ) {
			/*
				フォームに設定された文字列が空でない場合は
				strip_tagsを実行後の文字列をタイトルの設定値に設定
			*/
			$instance['title'] = strip_tags( $new_instance['title'] );
		} else {
			/* 空の場合は「新しいタイトル」をタイトルに設定 */
			$instance['title'] = '新しいタイトル';
		}

		/* 表示数のサニタイズ */
		if ( ! empty( $new_instance['num'] ) ) {
			/* フォームに設定された文字列が空でない場合 */
			if ( intval( strip_tags( $new_instance['num'] ) ) > 0 ) {
				/* 文字列をint化した数値が0より大きい場合のみ、その文字列を表示数として設定 */
				$instance['num'] = strip_tags( $new_instance['num'] );
			} else {
				/* 0より小さい場合はデフォルト値5を設定 */
				$instance['num'] = '5';
			}
		} else {
			/* フォームに設定された文字列が空の場合はデフォルトの5を設定 */
			$instance['num'] = '5';
		}

		return $instance;
	}
}

/**
 * 作成したウィジェットサブクラスを登録
 */
function my_register_category_popular_widgets() {
	register_widget( 'MyCategoryPopular_Widget' );
}

/* widgets_init に作成したウィジェットを登録する関数をフック */
add_action( 'widgets_init', 'my_register_category_popular_widgets' );
?>