<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
* It relies on the icalendar-reader library.
* @package automattic/jetpack
if ( ! defined( 'ABSPATH' ) ) {
// phpcs:disable Universal.Files.SeparateFunctionsFromOO.Mixed -- TODO: Move classes to appropriately-named class files.
function upcoming_events_register_widgets() {
register_widget( Jetpack_Upcoming_Events_Widget::class );
add_action( 'widgets_init', 'upcoming_events_register_widgets' );
class Jetpack_Upcoming_Events_Widget extends WP_Widget {
public function __construct() {
'upcoming_events_widget',
/** This filter is documented in modules/widgets/facebook-likebox.php */
apply_filters( 'jetpack_widget_name', __( 'Upcoming Events', 'jetpack' ) ),
'description' => __( 'Display upcoming events from an iCalendar feed.', 'jetpack' ),
'customize_selective_refresh' => true,
if ( is_active_widget( false, false, $this->id_base ) ) {
add_action( 'wp_head', array( $this, 'css' ) );
* Output CSS in the header everywhere where the widget is active.
.upcoming-events li span {
* Displays the form for this widget on the Widgets page of the WP Admin area.
* @param array $instance Instance configuration.
public function form( $instance ) {
'title' => __( 'Upcoming Events', 'jetpack' ),
$instance = array_merge( $defaults, (array) $instance );
<label for="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>"><?php esc_html_e( 'Title:', 'jetpack' ); ?></label>
<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'] ); ?>" />
<label for="<?php echo esc_attr( $this->get_field_id( 'feed-url' ) ); ?>"><?php esc_html_e( 'iCalendar Feed URL:', 'jetpack' ); ?></label>
<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'] ); ?>" />
<label for="<?php echo esc_attr( $this->get_field_id( 'count' ) ); ?>"><?php esc_html_e( 'Items to show:', 'jetpack' ); ?></label>
<select id="<?php echo esc_attr( $this->get_field_id( 'count' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'count' ) ); ?>">
<?php for ( $i = 1; $i <= 10; $i++ ) { ?>
<option <?php selected( $instance['count'], $i ); ?>><?php echo esc_html( (string) $i ); ?></option>
<option value="0" <?php selected( $instance['count'], 0 ); ?>><?php esc_html_e( 'All', 'jetpack' ); ?></option>
* Deals with the settings when they are saved by the admin.
* @param array $new_instance New configuration values.
* @param array $old_instance Old configuration values.
public function update( $new_instance, $old_instance ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
$instance['title'] = wp_strip_all_tags( $new_instance['title'] );
$instance['feed-url'] = wp_strip_all_tags( $new_instance['feed-url'] );
$instance['count'] = min( absint( $new_instance['count'] ), 10 ); // 10 or less
* Outputs the HTML for this widget.
* @param array $args An array of standard parameters for widgets in this theme.
* @param array $instance An array of settings for this widget instance.
* @return void Echoes it's output
public function widget( $args, $instance ) {
require_once JETPACK__PLUGIN_DIR . '/_inc/lib/icalendar-reader.php';
$ical = new iCalendarReader();
if ( ! empty( $instance['feed-url'] ) ) {
$events = $ical->get_events( $instance['feed-url'], $instance['count'] );
$events = $this->apply_timezone_offset( $events );
echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
if ( ! empty( $instance['title'] ) ) {
echo $args['before_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo esc_html( $instance['title'] );
echo $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
if ( empty( $instance['feed-url'] ) ) {
if ( current_user_can( 'manage_options' ) ) {
echo '<div class="error-message">';
esc_html_e( 'The events feed URL is not properly set up in this widget.', 'jetpack' );
esc_html_e( 'No upcoming events', 'jetpack' );
<ul class="upcoming-events">
<?php foreach ( $events as $event ) : ?>
<strong class="event-summary">
echo $ical->escape( stripslashes( $event['SUMMARY'] ?? '' ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- this method is built to escape.
<span class="event-when"><?php echo esc_html( $ical->formatted_date( $event ) ); ?></span>
<?php if ( ! empty( $event['LOCATION'] ) ) : ?>
<span class="event-location">
echo $ical->escape( stripslashes( $event['LOCATION'] ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- this method is built to escape.
<?php if ( ! empty( $event['DESCRIPTION'] ) ) : ?>
<span class="event-description">
echo wp_trim_words( $ical->escape( stripcslashes( $event['DESCRIPTION'] ) ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- this method is built to escape.
echo $args['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', 'upcoming_events' );
* Left this function here for backward compatibility
* just incase a site using jetpack is also using this function
* @param array|false $events Array of events, false on failure.
private function apply_timezone_offset( $events ) {
require_once JETPACK__PLUGIN_DIR . '/_inc/lib/icalendar-reader.php';
return ( new iCalendarReader() )->apply_timezone_offset( $events );