'widget_rss_links', 'description' => __( "Links to your blog's RSS feeds", 'jetpack' ), 'customize_selective_refresh' => true, ); parent::__construct( 'rss_links', /** This filter is documented in modules/widgets/facebook-likebox.php */ apply_filters( 'jetpack_widget_name', __( 'RSS Links', 'jetpack' ) ), $widget_ops ); } /** * Display the widget. * * @param array $args Display arguments including before_title, after_title, before_widget, and after_widget. * @param array $instance The settings for the particular instance of the widget. */ public function widget( $args, $instance ) { $instance = wp_parse_args( (array) $instance, $this->defaults() ); $before_widget = isset( $args['before_widget'] ) ? $args['before_widget'] : ''; $before_title = isset( $args['before_title'] ) ? $args['before_title'] : ''; $after_title = isset( $args['after_title'] ) ? $args['after_title'] : ''; $after_widget = isset( $args['after_widget'] ) ? $args['after_widget'] : ''; /** This filter is documented in core/src/wp-includes/default-widgets.php */ $title = apply_filters( 'widget_title', $instance['title'] ); echo $before_widget; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped if ( $title ) { echo $before_title . $title . $after_title; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } if ( 'text' === $instance['format'] ) { echo ''; } echo "\n" . $after_widget; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped /** This action is documented in modules/widgets/gravatar-profile.php */ do_action( 'jetpack_stats_extra', 'widget_view', 'rss-links' ); } /** * Return an associative array of default values * These values are used in new widgets as well as when sanitizing input. * * @return array Array of default values for the Widget's options */ public function defaults() { return array( 'title' => '', 'display' => 'posts-comments', 'format' => 'text', ); } /** * Sanitize widget form values as they are saved. * * @see WP_Widget::update() * * @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 ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable $instance = $old_instance; $instance['title'] = wp_filter_nohtml_kses( $new_instance['title'] ); $instance['display'] = $new_instance['display']; $instance['format'] = $new_instance['format']; $instance['imagesize'] = $new_instance['imagesize']; $instance['imagecolor'] = $new_instance['imagecolor']; return $instance; } /** * Back end widget form. * * @see WP_Widget::form() * * @param array $instance Previously saved values from database. * * @return string|void */ public function form( $instance ) { $instance = wp_parse_args( (array) $instance, $this->defaults() ); $title = stripslashes( $instance['title'] ); $display = $instance['display']; $format = $instance['format']; $image_size = isset( $instance['imagesize'] ) ? $instance['imagesize'] : 0; $image_color = isset( $instance['imagecolor'] ) ? $instance['imagecolor'] : 'red'; echo '

'; $displays = array( 'posts' => __( 'Posts', 'jetpack' ), 'comments' => __( 'Comments', 'jetpack' ), 'posts-comments' => __( 'Posts & Comments', 'jetpack' ), ); echo '

'; $formats = array( 'text' => __( 'Text Link', 'jetpack' ), 'image' => __( 'Image Link', 'jetpack' ), 'text-image' => __( 'Text & Image Links', 'jetpack' ), ); echo '

'; echo ''; } /** * Output a link with a link to the feed. * * @param string $type Widget type (posts or comments). * @param array $args Widget arguments. */ private function rss_link( $type, $args ) { $link_text = null; $rss_type = null; $subscribe_to = null; if ( 'posts' === $type ) { $subscribe_to = esc_html__( 'Subscribe to posts', 'jetpack' ); $link_text = esc_html__( 'RSS - Posts', 'jetpack' ); $rss_type = 'rss2_url'; } elseif ( 'comments' === $type ) { $subscribe_to = esc_html__( 'Subscribe to comments', 'jetpack' ); $link_text = esc_html__( 'RSS - Comments', 'jetpack' ); $rss_type = 'comments_rss2_url'; } /** * Filters the target link attribute for the RSS link in the RSS widget. * * @module widgets * * @since 3.4.0 * * @param bool false Control whether the link should open in a new tab. Default to false. */ if ( apply_filters( 'jetpack_rsslinks_widget_target_blank', false ) ) { $link_target = '_blank'; } else { $link_target = '_self'; } $link_contents = null; $format = $args['format']; if ( 'image' === $format ) { $link_contents = $this->get_image_tag( $args ); } elseif ( 'text-image' === $format ) { $link_contents = sprintf( '%1$s %2$s', $this->get_image_tag( $args ), $link_text ); } elseif ( 'text' === $format ) { $link_contents = $link_text; } printf( '%1$s%6$s%2$s', 'text' === $format ? '
  • ' : '

    ', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped 'text' === $format ? '

    • ' : '

    ', // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped esc_attr( $link_target ), esc_url( get_bloginfo( $rss_type ) ), esc_attr( $subscribe_to ), $link_contents // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- we are escaping this above. ); } /** * Return an image tag for the RSS icon. * * @param array $args Widget arguments. */ private function get_image_tag( $args ) { $image_path = sprintf( 'images/rss/%1$s-%2$s.png', $args['imagecolor'], $args['imagesize'] ); /** * Filters the image used as RSS icon in the RSS widget. * * @module widgets * * @since 3.6.0 * * @param string $var URL of RSS Widget icon. */ $image = apply_filters( 'jetpack_rss_widget_icon', plugins_url( $image_path, dirname( __DIR__ ) ) ); return sprintf( '%2$s', esc_url( $image ), esc_attr__( 'RSS feed', 'jetpack' ) ); } } // Class Jetpack_RSS_Links_Widget