Widgets */ add_action( 'widgets_init', 'jetpack_twitter_timeline_widget_init' ); function jetpack_twitter_timeline_widget_init() { register_widget( 'Jetpack_Twitter_Timeline_Widget' ); } class Jetpack_Twitter_Timeline_Widget extends WP_Widget { /** * Register widget with WordPress. */ public function __construct() { parent::__construct( 'twitter_timeline', /** This filter is documented in modules/widgets/facebook-likebox.php */ apply_filters( 'jetpack_widget_name', esc_html__( 'Twitter Timeline', 'jetpack' ) ), array( 'classname' => 'widget_twitter_timeline', 'description' => __( 'Display an official Twitter Embedded Timeline widget.', 'jetpack' ), 'customize_selective_refresh' => true, ) ); if ( is_active_widget( false, false, $this->id_base ) || is_active_widget( false, false, 'monster' ) || is_customize_preview() ) { add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_scripts' ) ); } add_action( 'admin_enqueue_scripts', array( $this, 'admin_scripts' ) ); } /** * Enqueue scripts. */ public function enqueue_scripts() { wp_enqueue_script( 'jetpack-twitter-timeline' ); } /** * Enqueue Twitter's widget library. * * @deprecated */ public function library() { _deprecated_function( __METHOD__, '4.0.0' ); wp_print_scripts( array( 'jetpack-twitter-timeline' ) ); } /** * Enqueue script to improve admin UI */ public function admin_scripts( $hook ) { // This is still 'widgets.php' when managing widgets via the Customizer. if ( 'widgets.php' === $hook ) { wp_enqueue_script( 'twitter-timeline-admin', Jetpack::get_file_url_for_environment( '_inc/build/widgets/twitter-timeline-admin.min.js', 'modules/widgets/twitter-timeline-admin.js' ) ); } } /** * Front-end display of widget. * * @see WP_Widget::widget() * * @param array $args Widget arguments. * @param array $instance Saved values from database. */ public function widget( $args, $instance ) { // Twitter deprecated `data-widget-id` on 2018-05-25, // with cease support deadline on 2018-07-27. // 1532563200 is 2018-07-26, one day early. if ( 'widget-id' === $instance['type'] && time() > 1532563200 ) { if ( current_user_can( 'edit_theme_options' ) ) { echo $args['before_widget']; echo $args['before_title'] . esc_html__( 'Twitter Timeline', 'jetpack' ) . $args['after_title']; echo '

' . esc_html__( "The Twitter Timeline widget can't display tweets based on searches or hashtags. To display a simple list of tweets instead, change the Widget ID to a Twitter username. Otherwise, delete this widget.", 'jetpack' ) . '

'; echo '

' . esc_html__( '(Only administrators will see this message.)', 'jetpack' ) . '

'; echo $args['after_widget']; } return; } $instance['lang'] = substr( strtoupper( get_locale() ), 0, 2 ); echo $args['before_widget']; $title = isset( $instance['title'] ) ? $instance['title'] : ''; /** This filter is documented in core/src/wp-includes/default-widgets.php */ $title = apply_filters( 'widget_title', $title ); if ( ! empty( $title ) ) { echo $args['before_title'] . $title . $args['after_title']; } if ( 'widget-id' === $instance['type'] && current_user_can( 'edit_theme_options' ) ) { echo '

' . esc_html__( 'As of July 27, 2018, the Twitter Timeline widget will no longer display tweets based on searches or hashtags. To display a simple list of tweets instead, change the Widget ID to a Twitter username.', 'jetpack' ) . '

'; echo '

' . esc_html__( '(Only administrators will see this message.)', 'jetpack' ) . '

'; } // Start tag output // This tag is transformed into the widget markup by Twitter's // widgets.js code echo ''; $timeline_placeholder = __( 'My Tweets', 'jetpack' ); /** * Filter the Timeline placeholder text. * * @module widgets * * @since 3.4.0 * * @param string $timeline_placeholder Timeline placeholder text. */ $timeline_placeholder = apply_filters( 'jetpack_twitter_timeline_placeholder', $timeline_placeholder ); echo esc_html( $timeline_placeholder ) . ''; // End tag output echo $args['after_widget']; /** This action is documented in modules/widgets/gravatar-profile.php */ do_action( 'jetpack_stats_extra', 'widget_view', 'twitter_timeline' ); } /** * 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 ) { $instance = array(); $instance['title'] = sanitize_text_field( $new_instance['title'] ); $width = (int) $new_instance['width']; if ( $width ) { // From publish.twitter.com: 220 <= width <= 1200 $instance['width'] = min( max( $width, 220 ), 1200 ); } else { $instance['width'] = ''; } $height = (int) $new_instance['height']; if ( $height ) { // From publish.twitter.com: height >= 200 $instance['height'] = max( $height, 200 ); } else { $instance['height'] = ''; } $tweet_limit = (int) $new_instance['tweet-limit']; if ( $tweet_limit ) { $instance['tweet-limit'] = min( max( $tweet_limit, 1 ), 20 ); /** * A timeline with a specified limit is expanded to the height of those Tweets. * The specified height value no longer applies, so reject the height value * when a valid limit is set: a widget attempting to save both limit 5 and * height 400 would be saved with just limit 5. */ $instance['height'] = ''; } else { $instance['tweet-limit'] = null; } // If they entered something that might be a full URL, try to parse it out if ( is_string( $new_instance['widget-id'] ) ) { if ( preg_match( '#https?://twitter\.com/settings/widgets/(\d+)#s', $new_instance['widget-id'], $matches ) ) { $new_instance['widget-id'] = $matches[1]; } } $instance['widget-id'] = sanitize_text_field( $new_instance['widget-id'] ); $hex_regex = '/#([a-f]|[A-F]|[0-9]){3}(([a-f]|[A-F]|[0-9]){3})?\b/'; foreach ( array( 'link-color', 'border-color' ) as $color ) { $new_color = sanitize_text_field( $new_instance[ $color ] ); if ( preg_match( $hex_regex, $new_color ) ) { $instance[ $color ] = $new_color; } } $instance['type'] = 'profile'; $instance['theme'] = 'light'; if ( in_array( $new_instance['theme'], array( 'light', 'dark' ) ) ) { $instance['theme'] = $new_instance['theme']; } $instance['chrome'] = array(); $chrome_settings = array( 'noheader', 'nofooter', 'noborders', 'transparent', 'noscrollbar', ); if ( isset( $new_instance['chrome'] ) ) { foreach ( $new_instance['chrome'] as $chrome ) { if ( in_array( $chrome, $chrome_settings ) ) { $instance['chrome'][] = $chrome; } } } return $instance; } /** * Returns a link to the documentation for a feature of this widget on * Jetpack or WordPress.com. */ public function get_docs_link( $hash = '' ) { if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) { $base_url = 'https://support.wordpress.com/widgets/twitter-timeline-widget/'; } else { $base_url = 'https://jetpack.com/support/extra-sidebar-widgets/twitter-timeline-widget/'; } return '( ? )'; } /** * Back end widget form. * * @see WP_Widget::form() * * @param array $instance Previously saved values from database. */ public function form( $instance ) { $defaults = array( 'title' => esc_html__( 'Follow me on Twitter', 'jetpack' ), 'width' => '', 'height' => '400', 'type' => 'profile', 'widget-id' => '', 'link-color' => '#f96e5b', 'border-color' => '#e8e8e8', 'theme' => 'light', 'chrome' => array(), 'tweet-limit' => null, ); $instance = wp_parse_args( (array) $instance, $defaults ); if ( 'widget-id' === $instance['type'] ) { $instance['widget-id'] = ''; } $instance['type'] = 'profile'; ?>


id="get_field_id( 'chrome-noheader' ); ?>" name="get_field_name( 'chrome' ); ?>[]" value="noheader" />
id="get_field_id( 'chrome-nofooter' ); ?>" name="get_field_name( 'chrome' ); ?>[]" value="nofooter" />
id="get_field_id( 'chrome-noborders' ); ?>" name="get_field_name( 'chrome' ); ?>[]" value="noborders" />
id="get_field_id( 'chrome-noscrollbar' ); ?>" name="get_field_name( 'chrome' ); ?>[]" value="noscrollbar" />
id="get_field_id( 'chrome-transparent' ); ?>" name="get_field_name( 'chrome' ); ?>[]" value="transparent" />