<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
* Flickr Widget, pulling recent photos from Flickr using RSS feed.
* This widget is now deprecated.
* Existing widgets will continue to work, but Flickr no longer displays RSS feeds,
* making it impossible for site owners to configure this widget.
* We consequently only register the widget if it's already in use on the site.
* @see https://github.com/Automattic/jetpack/issues/39824
* @package automattic/jetpack
// phpcs:disable Universal.Files.SeparateFunctionsFromOO.Mixed -- TODO: Move classes to appropriately-named class files.
* Disable direct access/execution to/of the widget code.
if ( ! defined( 'ABSPATH' ) ) {
if ( ! class_exists( 'Jetpack_Flickr_Widget' ) ) {
* Display your recent Flickr photos.
class Jetpack_Flickr_Widget extends WP_Widget {
public function __construct() {
/** This filter is documented in modules/widgets/facebook-likebox.php */
apply_filters( 'jetpack_widget_name', esc_html__( 'Flickr', 'jetpack' ) ),
'description' => esc_html__( 'Display your recent Flickr photos.', 'jetpack' ),
'customize_selective_refresh' => true,
public function enqueue_style() {
wp_enqueue_style( 'flickr-widget-style', plugins_url( 'flickr/style.css', __FILE__ ), array(), '20170405' );
* Return an associative array of default values.
* These values are used in new widgets.
* @return array Default values for the widget options.
public function defaults() {
'title' => esc_html__( 'Flickr Photos', 'jetpack' ),
'flickr_image_size' => 'thumbnail',
* Front-end display of the widget.
* @html-template-var array $instance
* @html-template-var string|null $flickr_home
* @html-template-var string $photos';
* @param array $args Widget arguments.
* @param array $instance Saved values from database.
public function widget( $args, $instance ) {
$instance = wp_parse_args( $instance, $this->defaults() );
// Enqueue front end assets.
if ( ! empty( $instance['flickr_rss_url'] ) ) {
* Parse the URL, and rebuild a URL that's sure to display images.
* Some Flickr Feeds do not display images by default.
$flickr_parameters = wp_parse_url( htmlspecialchars_decode( $instance['flickr_rss_url'], ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401 ) );
! empty( $flickr_parameters['host'] )
&& ! empty( $flickr_parameters['query'] )
&& str_contains( $flickr_parameters['host'], 'flickr' )
parse_str( $flickr_parameters['query'], $vars );
// Do we have an ID in the feed? Let's continue.
if ( isset( $vars['id'] ) ) {
// Flickr Feeds can be used for groups or for individuals.
! empty( $flickr_parameters['path'] )
&& str_contains( $flickr_parameters['path'], 'groups' )
$feed_url = 'https://api.flickr.com/services/feeds/groups_pool.gne';
$feed_url = 'https://api.flickr.com/services/feeds/photos_public.gne';
// Build our new RSS feed.
'%1$s?id=%2$s&format=rss_200_enc',
// Still no RSS feed URL? Get a default feed from Flickr to grab interesting photos.
if ( empty( $rss_url ) ) {
$rss_url = 'https://api.flickr.com/services/feeds/photos_interesting.gne?format=rss_200';
$rss = fetch_feed( $rss_url );
$flickr_home = null; // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Used in flickr/widget.php template file.
if ( ! is_wp_error( $rss ) ) {
foreach ( $rss->get_items( 0, $instance['items'] ) as $photo ) {
switch ( $instance['flickr_image_size'] ) {
$src = $photo->get_enclosure()->get_thumbnail();
$src = preg_match( '/src="(.*?)"/i', $photo->get_description(), $p );
$src = $photo->get_enclosure()->get_link();
$photos .= '<a href="' . esc_url( $photo->get_permalink(), array( 'http', 'https' ) ) . '" ';
if ( $instance['target'] ) {
$photos .= 'target="_blank" rel="noopener noreferrer" ';
$photos .= '><img src="' . esc_url( $src, array( 'http', 'https' ) ) . '" ';
$photos .= 'alt="' . esc_attr( $photo->get_title() ) . '" ';
$photos .= 'title="' . esc_attr( $photo->get_title() ) . '" ';
if ( ! empty( $photos ) ) {
$photos = apply_filters( 'jetpack_image_cdn_content', $photos );
$flickr_home = $rss->get_link(); // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Used in flickr/widget.php template file.
echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
if ( empty( $photos ) ) {
if ( current_user_can( 'edit_theme_options' ) ) {
esc_html__( 'There are no photos to display. Make sure your Flickr feed URL is correct, and that your pictures are publicly accessible.', 'jetpack' ),
esc_html__( '(Only admins can see this message)', 'jetpack' )
echo $args['before_title'] . $instance['title'] . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
require __DIR__ . '/flickr/widget.php';
echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
/** This action is already documented in modules/widgets/gravatar-profile.php */
do_action( 'jetpack_stats_extra', 'widget_view', 'flickr' );
* @html-template-var array $instance
* @param array $instance Previously saved values from database.
public function form( $instance ) {
$instance = wp_parse_args( $instance, $this->defaults() );
require __DIR__ . '/flickr/form.php';
* Sanitize widget form values as they are saved.
* @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
if ( isset( $new_instance['title'] ) ) {
$instance['title'] = wp_kses( $new_instance['title'], array() );
if ( isset( $new_instance['items'] ) ) {
$instance['items'] = (int) $new_instance['items'];
if ( isset( $new_instance['target'] ) ) {
$instance['target'] = (bool) $new_instance['target'];
isset( $new_instance['flickr_image_size'] ) &&
in_array( $new_instance['flickr_image_size'], array( 'thumbnail', 'small', 'large' ), true )
$instance['flickr_image_size'] = $new_instance['flickr_image_size'];
$instance['flickr_image_size'] = 'thumbnail';
if ( isset( $new_instance['flickr_rss_url'] ) ) {
$instance['flickr_rss_url'] = esc_url( $new_instance['flickr_rss_url'], array( 'http', 'https' ) );
if ( strlen( $instance['flickr_rss_url'] ) < 10 ) {
$instance['flickr_rss_url'] = '';
* Register Jetpack_Flickr_Widget widget.
function jetpack_register_flickr_widget() {
$transient = 'jetpack_flickr_widget::is_active';
$has_widget = get_transient( $transient );
if ( false === $has_widget ) {
$is_active_widget = is_active_widget( false, false, 'flickr', false );
$has_widget = (int) ! empty( $is_active_widget );
set_transient( $transient, $has_widget, 1 * HOUR_IN_SECONDS );
// [DEPRECATION]: Only register widget if active widget exists already
register_widget( 'Jetpack_Flickr_Widget' );
add_action( 'widgets_init', 'jetpack_register_flickr_widget' );