| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168 |
- <?php
- /**
- * WPForms widget.
- *
- * @since 1.0.2
- */
- class WPForms_Widget extends WP_Widget {
- /**
- * Hold widget settings defaults, populated in constructor.
- *
- * @since 1.0.2
- *
- * @var array
- */
- protected $defaults;
- /**
- * Constructor
- *
- * @since 1.0.2
- */
- public function __construct() {
- // Widget defaults.
- $this->defaults = array(
- 'title' => '',
- 'form_id' => '',
- 'show_title' => false,
- 'show_desc' => false,
- );
- // Widget Slug.
- $widget_slug = 'wpforms-widget';
- // Widget basics.
- $widget_ops = array(
- 'classname' => $widget_slug,
- 'description' => esc_html_x( 'Display a form.', 'Widget', 'wpforms-lite' ),
- );
- // Widget controls.
- $control_ops = array(
- 'id_base' => $widget_slug,
- );
- // Load widget.
- parent::__construct( $widget_slug, esc_html_x( 'WPForms', 'Widget', 'wpforms-lite' ), $widget_ops, $control_ops );
- }
- /**
- * Output the HTML for this widget.
- *
- * @since 1.0.2
- *
- * @param array $args An array of standard parameters for widgets in this theme.
- * @param array $instance An array of settings for this widget instance.
- */
- public function widget( $args, $instance ) {
- // Merge with defaults.
- $instance = wp_parse_args( (array) $instance, $this->defaults );
- echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
- // Title.
- if ( ! empty( $instance['title'] ) ) {
- echo $args['before_title'] . apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base ) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
- }
- // Form.
- if ( ! empty( $instance['form_id'] ) ) {
- wpforms()->frontend->output( absint( $instance['form_id'] ), $instance['show_title'], $instance['show_desc'] );
- }
- echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
- }
- /**
- * Deal with the settings when they are saved by the admin. Here is
- * where any validation should be dealt with.
- *
- * @since 1.0.2
- *
- * @param array $new_instance An array of new settings as submitted by the admin.
- * @param array $old_instance An array of the previous settings.
- *
- * @return array The validated and (if necessary) amended settings
- */
- public function update( $new_instance, $old_instance ) {
- $new_instance['title'] = wp_strip_all_tags( $new_instance['title'] );
- $new_instance['form_id'] = ! empty( $new_instance['form_id'] ) ? (int) $new_instance['form_id'] : 0;
- $new_instance['show_title'] = isset( $new_instance['show_title'] ) ? '1' : false;
- $new_instance['show_desc'] = isset( $new_instance['show_desc'] ) ? '1' : false;
- return $new_instance;
- }
- /**
- * Display the form for this widget on the Widgets page of the WP Admin area.
- *
- * @since 1.0.2
- *
- * @param array $instance An array of the current settings for this widget.
- */
- public function form( $instance ) {
- // Merge with defaults.
- $instance = wp_parse_args( (array) $instance, $this->defaults );
- ?>
- <p>
- <label for="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>">
- <?php echo esc_html( _x( 'Title:', 'Widget', 'wpforms-lite' ) ); ?>
- </label>
- <input type="text"
- 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'] ); ?>" class="widefat"/>
- </p>
- <p>
- <label for="<?php echo esc_attr( $this->get_field_id( 'form_id' ) ); ?>">
- <?php echo esc_html( _x( 'Form:', 'Widget', 'wpforms-lite' ) ); ?>
- </label>
- <select class="widefat"
- id="<?php echo esc_attr( $this->get_field_id( 'form_id' ) ); ?>"
- name="<?php echo esc_attr( $this->get_field_name( 'form_id' ) ); ?>">
- <?php
- $forms = wpforms()->form->get();
- if ( ! empty( $forms ) ) {
- echo '<option value="" selected disabled>' . esc_html_x( 'Select your form', 'Widget', 'wpforms-lite' ) . '</option>';
- foreach ( $forms as $form ) {
- echo '<option value="' . esc_attr( $form->ID ) . '" ' . selected( $instance['form_id'], $form->ID, false ) . '>' . esc_html( $form->post_title ) . '</option>';
- }
- } else {
- echo '<option value="">' . esc_html_x( 'No forms', 'Widget', 'wpforms-lite' ) . '</option>';
- }
- ?>
- </select>
- </p>
- <p>
- <input type="checkbox" id="<?php echo esc_attr( $this->get_field_id( 'show_title' ) ); ?>"
- name="<?php echo esc_attr( $this->get_field_name( 'show_title' ) ); ?>" <?php checked( '1', $instance['show_title'] ); ?>>
- <label for="<?php echo esc_attr( $this->get_field_id( 'show_title' ) ); ?>">
- <?php echo esc_html( _x( 'Display form name', 'Widget', 'wpforms-lite' ) ); ?>
- </label>
- <br>
- <input type="checkbox" id="<?php echo esc_attr( $this->get_field_id( 'show_desc' ) ); ?>"
- name="<?php echo esc_attr( $this->get_field_name( 'show_desc' ) ); ?>" <?php checked( '1', $instance['show_desc'] ); ?>>
- <label for="<?php echo esc_attr( $this->get_field_id( 'show_desc' ) ); ?>">
- <?php echo esc_html( _x( 'Display form description', 'Widget', 'wpforms-lite' ) ); ?>
- </label>
- </p>
- <?php
- }
- }
- /**
- * Register WPForms plugin widgets.
- */
- function wpforms_register_widgets() {
- register_widget( 'WPForms_Widget' );
- }
- add_action( 'widgets_init', 'wpforms_register_widgets' );
|