Twenty_Fourteen_Ephemera_Widget::widget( array $args, array $instance )

Parameters

$argsarray

An array of standard parameters for widgets in this theme.

$instancearray

An array of settings for this widget instance.

Hooks fired · 1

One hook fires while Twenty_Fourteen_Ephemera_Widget::widget() runs, in this order:

1. 1
   apply_filters( widget_title )filterline 113 (+41 into the body)

   Filters the widget title.

Uses · 33

• __()Retrieves the translation of $text.
• absint()Converts a value to non-negative integer.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• get_option()Retrieves an option value based on an option name.
• esc_attr()Escaping for HTML attributes.
• esc_url()Checks and cleans a URL.
• get_post_format_link()Returns a link to a post format index.
• esc_html()Escaping for HTML blocks.
• post_class()Displays the classes for the post container element.
• has_post_format()Check if a post has any of the given formats, or any format.
• post_password_required()Determines whether the post requires password and whether a correct password has been provided.
• the_content()Displays the post content.

Source

View on Trac ↗View on GitHub ↗

72	public function widget( $args, $instance ) {73		$format = isset( $instance['format'] ) ? $instance['format'] : '';74 75		if ( ! $format || ! in_array( $format, $this->formats, true ) ) {76			$format = 'aside';77		}78 79		switch ( $format ) {80			case 'image':81				$format_string      = __( 'Images', 'twentyfourteen' );82				$format_string_more = __( 'More images', 'twentyfourteen' );83				break;84			case 'video':85				$format_string      = __( 'Videos', 'twentyfourteen' );86				$format_string_more = __( 'More videos', 'twentyfourteen' );87				break;88			case 'audio':89				$format_string      = __( 'Audio', 'twentyfourteen' );90				$format_string_more = __( 'More audio', 'twentyfourteen' );91				break;92			case 'quote':93				$format_string      = __( 'Quotes', 'twentyfourteen' );94				$format_string_more = __( 'More quotes', 'twentyfourteen' );95				break;96			case 'link':97				$format_string      = __( 'Links', 'twentyfourteen' );98				$format_string_more = __( 'More links', 'twentyfourteen' );99				break;100			case 'gallery':101				$format_string      = __( 'Galleries', 'twentyfourteen' );102				$format_string_more = __( 'More galleries', 'twentyfourteen' );103				break;104			case 'aside':105			default:106				$format_string      = __( 'Asides', 'twentyfourteen' );107				$format_string_more = __( 'More asides', 'twentyfourteen' );108				break;109		}110 111		$number = ! empty( $instance['number'] ) ? absint( $instance['number'] ) : 2;112		$title  = ! empty( $instance['title'] ) ? $instance['title'] : $format_string;113		$title  = apply_filters( 'widget_title', $title, $instance, $this->id_base );114 115		$ephemera = new WP_Query(116			array(117				'order'          => 'DESC',118				'posts_per_page' => $number,119				'no_found_rows'  => true,120				'post_status'    => 'publish',121				'post__not_in'   => get_option( 'sticky_posts' ),122				'tax_query'      => array(123					array(124						'taxonomy' => 'post_format',125						'terms'    => array( "post-format-$format" ),126						'field'    => 'slug',127						'operator' => 'IN',128					),129				),130			)131		);132 133		if ( $ephemera->have_posts() ) :134			$tmp_content_width        = $GLOBALS['content_width'];135			$GLOBALS['content_width'] = 306;136 137			echo $args['before_widget'];138			?>139			<h1 class="widget-title <?php echo esc_attr( $format ); ?>">140				<a class="entry-format" href="<?php echo esc_url( get_post_format_link( $format ) ); ?>"><?php echo esc_html( $title ); ?></a>141			</h1>142			<ol>143 144				<?php145				while ( $ephemera->have_posts() ) :146					$ephemera->the_post();147					$tmp_more        = $GLOBALS['more'];148					$GLOBALS['more'] = 0;149					?>150				<li>151				<article <?php post_class(); ?>>

History

Introduced in Twenty Fourteen 1.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-content/themes/twentyfourteen/inc/widgets.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.