WordPress как на ладони
WordPress темы и плагины за 250 рублей wordpress jino

register_widget() WP 2.8.0

Регистрирует (создает) виджет. Функции нужно передать название созданного класса расширяющего основной класс виджетов WP_Widget.

Хуков нет.

Возвращает

Ничего не возвращает.

Использование

register_widget( $widget_class )
$widget_class(объект) (обязательный)
Название класса, который расширяет основной класс виджетов WP_Widget.

Примеры

#1 Шаблон для создания виджета

Этот код расширяет базовый класс виджетов WP_Widget и создает дополнительный виджет, который можно будет использовать многократно:

// Класс виджета
class My_Widget extends WP_Widget {

	function __construct() {
		// Запускаем родительский класс
		parent::__construct(
			'идентификатор_виджета', // ID виджета, если не указать (оставить ''), то ID будет равен названию класса в нижнем регистре: my_widget
			'Название виджета',
			array('description' => 'Описание виджета')
		);

		// стили скрипты виджета, только если он активен
		if ( is_active_widget( false, false, $this->id_base ) || is_customize_preview() ) {
			add_action('wp_enqueue_scripts', array( $this, 'add_my_widget_scripts' ));
			add_action('wp_head', array( $this, 'add_my_widget_style' ) );
		}
	}

	// Вывод виджета
	function widget( $args, $instance ){
		$title = apply_filters( 'widget_title', $instance['title'] );

		echo $args['before_widget'];

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

		echo 'Привет!';

		echo $args['after_widget'];
	}

	// Сохранение настроек виджета (очистка)
	function update( $new_instance, $old_instance ) {
	}

	// html форма настроек виджета в Админ-панели
	function form( $instance ) {
	}

	// скрипт виджета
	function add_my_widget_scripts() {
		// фильтр чтобы можно было отключить скрипты
		if( ! apply_filters( 'show_my_widget_script', true, $this->id_base ) )
			return;

		$theme_url = get_stylesheet_directory_uri();

		wp_enqueue_script('my_widget_script', $theme_url .'/my_widget_script.js' );
	}

	// стили виджета
	function add_my_widget_style() {
		// фильтр чтобы можно было отключить стили
		if( ! apply_filters( 'show_my_widget_style', true, $this->id_base ) )
			return;
		?>
		<style>
			.my_widget a{ display:inline; }
		</style>
		<?php
	}
}

// Регистрация класса виджета
add_action( 'widgets_init', 'my_register_widgets' );
function my_register_widgets() {
	register_widget( 'My_Widget' );
}

#2 Создание виджета с настройками

Этот пример создает виджет Foo_Widget с настройками, в которых можно указать заголовок виджета. По аналогии можно добавить любые настройки:

<?php
/**
 * Добавление нового виджета Foo_Widget.
 */
class Foo_Widget extends WP_Widget {

	// Регистрация виджета используя основной класс
	function __construct() {
		// вызов конструктора выглядит так:
		// __construct( $id_base, $name, $widget_options = array(), $control_options = array() )
		parent::__construct(
			'foo_widget', // ID виджета, если не указать (оставить ''), то ID будет равен названию класса в нижнем регистре: foo_widget
			'Заголовок виджета',
			array( 'description' => 'Описание виджета', /*'classname' => 'my_widget',*/ )
		);

		// скрипты/стили виджета, только если он активен
		if ( is_active_widget( false, false, $this->id_base ) || is_customize_preview() ) {
			add_action('wp_enqueue_scripts', array( $this, 'add_my_widget_scripts' ));
			add_action('wp_head', array( $this, 'add_my_widget_style' ) );
		}
	}

	/**
	 * Вывод виджета во Фронт-энде
	 *
	 * @param array $args     аргументы виджета.
	 * @param array $instance сохраненные данные из настроек
	 */
	function widget( $args, $instance ) {
		$title = apply_filters( 'widget_title', $instance['title'] );

		echo $args['before_widget'];
		if ( ! empty( $title ) ) {
			echo $args['before_title'] . $title . $args['after_title'];
		}
		echo __( 'Hello, World!', 'text_domain' );
		echo $args['after_widget'];
	}

	/**
	 * Админ-часть виджета
	 *
	 * @param array $instance сохраненные данные из настроек
	 */
	function form( $instance ) {
		$title = @ $instance['title'] ?: 'Заголовок по умолчанию';

		?>
		<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 esc_attr( $title ); ?>">
		</p>
		<?php 
	}

	/**
	 * Сохранение настроек виджета. Здесь данные должны быть очищены и возвращены для сохранения их в базу данных.
	 *
	 * @see WP_Widget::update()
	 *
	 * @param array $new_instance новые настройки
	 * @param array $old_instance предыдущие настройки
	 *
	 * @return array данные которые будут сохранены
	 */
	function update( $new_instance, $old_instance ) {
		$instance = array();
		$instance['title'] = ( ! empty( $new_instance['title'] ) ) ? strip_tags( $new_instance['title'] ) : '';

		return $instance;
	}

	// скрипт виджета
	function add_my_widget_scripts() {
		// фильтр чтобы можно было отключить скрипты
		if( ! apply_filters( 'show_my_widget_script', true, $this->id_base ) )
			return;

		$theme_url = get_stylesheet_directory_uri();

		wp_enqueue_script('my_widget_script', $theme_url .'/my_widget_script.js' );
	}

	// стили виджета
	function add_my_widget_style() {
		// фильтр чтобы можно было отключить стили
		if( ! apply_filters( 'show_my_widget_style', true, $this->id_base ) )
			return;
		?>
		<style type="text/css">
			.my_widget a{ display:inline; }
		</style>
		<?php
	}

} 
// конец класса Foo_Widget

// регистрация Foo_Widget в WordPress
function register_foo_widget() {
	register_widget( 'Foo_Widget' );
}
add_action( 'widgets_init', 'register_foo_widget' );

Код register widget: wp-includes/widgets.php VER 4.9.6

<?php
function register_widget( $widget ) {
	global $wp_widget_factory;

	$wp_widget_factory->register( $widget );
}

Cвязанные функции

Из метки: sidebar (widget Виджет)

7 комментов
  • Ellisa cайт: tkd-kaliningrad.ru

    Обновился до версии 4.3 и теперь у меня на сайте какая-то неразбериха типо:
    Notice: Вызванный метод конструктора класса WP_Widget считается устаревшим с версии 4.3.0! Используйте __construct()
    Пожалуйста, помогите разобраться! help

    P.S. Крик души...

    Ответить2.7 года назад #
    • campusboy2787 cайт: www.youtube.com/c/wpplus

      Посмотрите в wp-config.php, чтобы была запись:

      define('WP_DEBUG', false);

      Можете ещё поискать по теме "Отключение ошибок в WordPress", есть разные решения. В данном случае у Вас не ошибка, а лишь предупреждение, потому скорее всего вышеприведенного кода будет достаточно.

      -1
      Ответить2.7 года назад #
    • Дмитрий

      Используйте современный синтаксис конструктора класса. А именно, для класса WP_Widget переименуйте метод-конструктор WP_Widget() на __construct() (смотрите пример №2).

      3
      Ответить2.3 года назад #
  • campusboy2787 cайт: www.youtube.com/c/wpplus

    В примере наверное всё же стоит заменить

    $title = @ $instance['title'] ?: 'Заголовок по умолчанию';

    на

    $title = ( empty( $instance['title'] ) ) $instance['title'] ? 'Заголовок по умолчанию' : $instance['title'];
    Ответить1.7 год назад #
  • kir

    Привет, есть идея, добавить все шорткоду в виджеты, тоесть, что бы использовать шорткод, как отдельный виджет.
    Все сделал, все работает, но есть момент
    допустип есть массив конфигураций $widgets, который содержит все, что нужно для создания шоркода и виджета

    $shortcodes = array(
    	'shortcode 1' => array('widget'=true, 'options'=>array('title', 'id', 'class')),
    	'shortcode 2' => array('widget'=true, 'options'=>array('title', 'id', 'class')),
    	'shortcode 3' => array('widget'=false, 'options'=>array('title', 'id', 'class'))
    );
    foreach ($shortcodes as $widget_class=>$widget_options) {
    	if ($widget_options['widget']) {
    		class $widget_class extends WP_Widget {
    			...
    		}
    	}
    }

    но это не хочет работать
    можно ли как то динамически это делать?
    Основная проблема в том, что я делаю большую родительскую тему и там будет 100500 разных шорткодов, и желательно что б они автоматом генерили виджеты...

    Ответить4 месяца назад #

Здравствуйте, !