File "class-template-widget.php"

Full path: /home/dora/public_html/wp-content/plugins/wp-grid-builder/includes/widgets/class-template-widget.php
File size: 2.86 KB
MIME-type: --
Charset: utf-8

<?php
/**
 * Template Widget
 *
 * @package   WP Grid Builder
 * @author    Loïc Blascos
 * @copyright 2019-2022 Loïc Blascos
 */

namespace WP_Grid_Builder\Includes\Widgets;

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

/**
 * Add Template Widget
 *
 * @class WP_Grid_Builder\Includes\Widgets\Template_Widget
 * @since 1.4.0
 */
final class Template_Widget extends \WP_Widget {

	/**
	 * Register widget with WordPress
	 *
	 * @since 1.4.0
	 * @access public
	 */
	public function __construct() {

		parent::__construct(
			WPGB_SLUG . '_template',
			WPGB_NAME . ' - ' . __( 'Template', 'wp-grid-builder' ),
			[ 'description' => esc_html__( 'Displays a template.', 'wp-grid-builder' ) ]
		);

	}

	/**
	 * Front-end display of widget.
	 *
	 * @since 1.4.0
	 * @access public
	 *
	 * @param array $args     Widget arguments.
	 * @param array $instance Saved values from database.
	 */
	public function widget( $args, $instance ) {

		if ( empty( $instance['id'] ) ) {
			return;
		}

		$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );

		echo wp_kses_post( $args['before_widget'] );

		if ( $title ) {

			echo wp_kses_post( $args['before_title'] );
			echo esc_html( $title );
			echo wp_kses_post( $args['after_title'] );

		}

		wpgb_render_template( $instance['id'] );
		echo wp_kses_post( $args['after_widget'] );

	}

	/**
	 * Back-end widget form.
	 *
	 * @since 1.4.0
	 * @access public
	 *
	 * @param array $instance Previously saved values from database.
	 */
	public function form( $instance ) {

		$title     = isset( $instance['title'] ) ? $instance['title'] : '';
		$template  = isset( $instance['id'] ) ? $instance['id'] : '';
		$templates = Widget::get( 'templates' );

		printf(
			'<p>
				<label for="%1$s">%2$s</label>
				<input id="%1$s" class="widefat" name="%3$s" value="%4$s">
			</p>',
			esc_attr( $this->get_field_id( 'title' ) ),
			esc_html__( 'Title:', 'wp-grid-builder' ),
			esc_attr( $this->get_field_name( 'title' ) ),
			esc_attr( $title )
		);

		Widget::output_list(
			__( 'Template:', 'wp-grid-builder' ),
			$this->get_field_id( 'id' ),
			$this->get_field_name( 'id' ),
			$templates,
			$template
		);

	}

	/**
	 * Sanitize widget form values as they are saved.
	 *
	 * @since 1.4.0
	 * @access public
	 *
	 * @param array $new_instance Values just sent to be saved.
	 * @param array $old_instance Previously saved values from database.
	 * @return array Updated safe values to be saved.
	 */
	public function update( $new_instance, $old_instance ) {

		$templates  = apply_filters( 'wp_grid_builder/templates', [] );
		$registered = isset( $new_instance['id'], $templates[ $new_instance['id'] ] );

		return [
			'title' => isset( $new_instance['title'] ) ? wp_strip_all_tags( $new_instance['title'] ) : '',
			'id'    => $registered ? $new_instance['id'] : '',
		];

	}
}