authors
8 years ago
contact-info
5 years ago
eu-cookie-law
2 years ago
facebook-likebox
11 years ago
flickr
2 years ago
gallery
4 years ago
goodreads
5 years ago
google-translate
4 years ago
image-widget
8 years ago
instagram
6 years ago
internet-defense-league
3 years ago
migrate-to-core
3 years ago
milestone
2 years ago
my-community
8 years ago
simple-payments
4 years ago
social-icons
4 years ago
social-media-icons
5 years ago
top-posts
8 years ago
wordpress-post-widget
3 years ago
authors.php
3 years ago
blog-stats.php
2 years ago
class-jetpack-eu-cookie-law-widget.php
3 years ago
class-jetpack-instagram-widget.php
2 years ago
contact-info.php
2 years ago
customizer-controls.css
9 years ago
customizer-utils.js
6 years ago
facebook-likebox.php
3 years ago
flickr.php
3 years ago
gallery.php
3 years ago
goodreads.php
3 years ago
google-translate.php
2 years ago
gravatar-profile.css
10 years ago
gravatar-profile.php
3 years ago
image-widget.php
3 years ago
internet-defense-league.php
3 years ago
mailchimp.php
3 years ago
milestone.php
5 years ago
my-community.php
2 years ago
rsslinks-widget.php
3 years ago
simple-payments.php
2 years ago
social-icons.php
2 years ago
social-media-icons.php
3 years ago
top-posts.php
2 years ago
twitter-timeline-admin.js
6 years ago
twitter-timeline.php
3 years ago
upcoming-events.php
3 years ago
wordpress-post-widget.php
4 years ago
upcoming-events.php
188 lines
| 1 | <?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName |
| 2 | /** |
| 3 | * Upcoming Events widget |
| 4 | * |
| 5 | * It relies on the icalendar-reader library. |
| 6 | * |
| 7 | * @package automattic/jetpack |
| 8 | */ |
| 9 | |
| 10 | // phpcs:disable Universal.Files.SeparateFunctionsFromOO.Mixed -- TODO: Move classes to appropriately-named class files. |
| 11 | |
| 12 | /** |
| 13 | * Register the widget. |
| 14 | */ |
| 15 | function upcoming_events_register_widgets() { |
| 16 | register_widget( Jetpack_Upcoming_Events_Widget::class ); |
| 17 | } |
| 18 | add_action( 'widgets_init', 'upcoming_events_register_widgets' ); |
| 19 | |
| 20 | /** |
| 21 | * Widget class. |
| 22 | */ |
| 23 | class Jetpack_Upcoming_Events_Widget extends WP_Widget { |
| 24 | /** |
| 25 | * Constructor |
| 26 | */ |
| 27 | public function __construct() { |
| 28 | parent::__construct( |
| 29 | 'upcoming_events_widget', |
| 30 | /** This filter is documented in modules/widgets/facebook-likebox.php */ |
| 31 | apply_filters( 'jetpack_widget_name', __( 'Upcoming Events', 'jetpack' ) ), |
| 32 | array( |
| 33 | 'description' => __( 'Display upcoming events from an iCalendar feed.', 'jetpack' ), |
| 34 | 'customize_selective_refresh' => true, |
| 35 | ) |
| 36 | ); |
| 37 | if ( is_active_widget( false, false, $this->id_base ) ) { |
| 38 | add_action( 'wp_head', array( $this, 'css' ) ); |
| 39 | } |
| 40 | } |
| 41 | |
| 42 | /** |
| 43 | * Output CSS in the header everywhere where the widget is active. |
| 44 | */ |
| 45 | public function css() { |
| 46 | ?> |
| 47 | <style type="text/css"> |
| 48 | .upcoming-events li { |
| 49 | margin-bottom: 10px; |
| 50 | } |
| 51 | .upcoming-events li span { |
| 52 | display: block; |
| 53 | } |
| 54 | </style> |
| 55 | <?php |
| 56 | } |
| 57 | |
| 58 | /** |
| 59 | * Displays the form for this widget on the Widgets page of the WP Admin area. |
| 60 | * |
| 61 | * @param array $instance Instance configuration. |
| 62 | * |
| 63 | * @return void |
| 64 | */ |
| 65 | public function form( $instance ) { |
| 66 | $defaults = array( |
| 67 | 'title' => __( 'Upcoming Events', 'jetpack' ), |
| 68 | 'feed-url' => '', |
| 69 | 'count' => 3, |
| 70 | ); |
| 71 | $instance = array_merge( $defaults, (array) $instance ); |
| 72 | ?> |
| 73 | |
| 74 | <p> |
| 75 | <label for="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>"><?php esc_html_e( 'Title:', 'jetpack' ); ?></label> |
| 76 | <input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'title' ) ); ?>" type="text" value="<?php echo esc_attr( $instance['title'] ); ?>" /> |
| 77 | </p> |
| 78 | |
| 79 | <p> |
| 80 | <label for="<?php echo esc_attr( $this->get_field_id( 'feed-url' ) ); ?>"><?php esc_html_e( 'iCalendar Feed URL:', 'jetpack' ); ?></label> |
| 81 | <input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'feed-url' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'feed-url' ) ); ?>" type="text" value="<?php echo esc_attr( $instance['feed-url'] ); ?>" /> |
| 82 | </p> |
| 83 | |
| 84 | <p> |
| 85 | <label for="<?php echo esc_attr( $this->get_field_id( 'count' ) ); ?>"><?php esc_html_e( 'Items to show:', 'jetpack' ); ?></label> |
| 86 | <select id="<?php echo esc_attr( $this->get_field_id( 'count' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'count' ) ); ?>"> |
| 87 | <?php for ( $i = 1; $i <= 10; $i++ ) { ?> |
| 88 | <option <?php selected( $instance['count'], $i ); ?>><?php echo (int) $i; ?></option> |
| 89 | <?php } ?> |
| 90 | <option value="0" <?php selected( $instance['count'], 0 ); ?>><?php esc_html_e( 'All', 'jetpack' ); ?></option> |
| 91 | </select> |
| 92 | </p> |
| 93 | <?php |
| 94 | } |
| 95 | |
| 96 | /** |
| 97 | * Deals with the settings when they are saved by the admin. |
| 98 | * |
| 99 | * @param array $new_instance New configuration values. |
| 100 | * @param array $old_instance Old configuration values. |
| 101 | * |
| 102 | * @return array |
| 103 | */ |
| 104 | public function update( $new_instance, $old_instance ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable |
| 105 | $instance = array(); |
| 106 | $instance['title'] = wp_strip_all_tags( $new_instance['title'] ); |
| 107 | $instance['feed-url'] = wp_strip_all_tags( $new_instance['feed-url'] ); |
| 108 | $instance['count'] = min( absint( $new_instance['count'] ), 10 ); // 10 or less |
| 109 | return $instance; |
| 110 | } |
| 111 | |
| 112 | /** |
| 113 | * Outputs the HTML for this widget. |
| 114 | * |
| 115 | * @param array $args An array of standard parameters for widgets in this theme. |
| 116 | * @param array $instance An array of settings for this widget instance. |
| 117 | * |
| 118 | * @return void Echoes it's output |
| 119 | */ |
| 120 | public function widget( $args, $instance ) { |
| 121 | require_once JETPACK__PLUGIN_DIR . '/_inc/lib/icalendar-reader.php'; |
| 122 | |
| 123 | $ical = new iCalendarReader(); |
| 124 | $events = $ical->get_events( $instance['feed-url'], $instance['count'] ); |
| 125 | $events = $this->apply_timezone_offset( $events ); |
| 126 | $ical->timezone = null; |
| 127 | |
| 128 | echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped |
| 129 | if ( ! empty( $instance['title'] ) ) { |
| 130 | echo $args['before_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped |
| 131 | echo esc_html( $instance['title'] ); |
| 132 | echo $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped |
| 133 | } |
| 134 | |
| 135 | if ( ! $events ) : // nothing to display? |
| 136 | ?> |
| 137 | <p><?php esc_html_e( 'No upcoming events', 'jetpack' ); ?></p> |
| 138 | <?php |
| 139 | else : |
| 140 | ?> |
| 141 | <ul class="upcoming-events"> |
| 142 | <?php foreach ( $events as $event ) : ?> |
| 143 | <li> |
| 144 | <strong class="event-summary"> |
| 145 | <?php |
| 146 | echo $ical->escape( stripslashes( $event['SUMMARY'] ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- this method is built to escape. |
| 147 | ?> |
| 148 | </strong> |
| 149 | <span class="event-when"><?php echo esc_html( $ical->formatted_date( $event ) ); ?></span> |
| 150 | <?php if ( ! empty( $event['LOCATION'] ) ) : ?> |
| 151 | <span class="event-location"> |
| 152 | <?php |
| 153 | echo $ical->escape( stripslashes( $event['LOCATION'] ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- this method is built to escape. |
| 154 | ?> |
| 155 | </span> |
| 156 | <?php endif; ?> |
| 157 | <?php if ( ! empty( $event['DESCRIPTION'] ) ) : ?> |
| 158 | <span class="event-description"> |
| 159 | <?php |
| 160 | echo wp_trim_words( $ical->escape( stripcslashes( $event['DESCRIPTION'] ) ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- this method is built to escape. |
| 161 | ?> |
| 162 | </span> |
| 163 | <?php endif; ?> |
| 164 | </li> |
| 165 | <?php endforeach; ?> |
| 166 | </ul> |
| 167 | <?php |
| 168 | endif; |
| 169 | |
| 170 | echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped |
| 171 | |
| 172 | /** This action is documented in modules/widgets/gravatar-profile.php */ |
| 173 | do_action( 'jetpack_stats_extra', 'widget_view', 'upcoming_events' ); |
| 174 | } |
| 175 | |
| 176 | /** |
| 177 | * Left this function here for backward compatibility |
| 178 | * just incase a site using jetpack is also using this function |
| 179 | * |
| 180 | * @param array|false $events Array of events, false on failure. |
| 181 | */ |
| 182 | private function apply_timezone_offset( $events ) { |
| 183 | require_once JETPACK__PLUGIN_DIR . '/_inc/lib/icalendar-reader.php'; |
| 184 | |
| 185 | return ( new iCalendarReader() )->apply_timezone_offset( $events ); |
| 186 | } |
| 187 | } |
| 188 |