twentytwenty_get_post_meta( int $post_id = null, string $location = 'single-top' )

Parameters

$post_idintoptional

The ID of the post.Default: null

$locationstringoptional

The location where the meta is shown.Default: 'single-top'

Hooks fired · 5

5 hooks fire while twentytwenty_get_post_meta() runs, in this order:

1. 1
   apply_filters( twentytwenty_disallowed_post_types_for_meta_output )filterline 259 (+17 into the body)

   Filters post types array.

2. 2
   apply_filters( twentytwenty_post_meta_location_single_top )filterline 285 (+43 into the body)

   Filters post meta info visibility.

3. 3
   apply_filters( twentytwenty_post_meta_location_single_bottom )filterline 310 (+68 into the body)

   Filters post tags visibility.

4. 4
   do_action( twentytwenty_start_of_post_meta_list )actionline 353 (+111 into the body)

   Fires before post meta HTML display.

5. 5
   do_action( twentytwenty_end_of_post_meta_list )actionline 500 (+258 into the body)

   Fires after post meta HTML display.

Uses · 28

• apply_filters()Calls the callback functions that have been added to a filter hook.
• get_post_type()Retrieves the post type of the current post or of a given post.
• get_post()Retrieves post data given a post ID or post object.
• setup_postdata()Set up global post data.
• esc_attr()Escaping for HTML attributes.
• do_action()Calls the callback functions that have been added to an action hook.
• post_type_supports()Checks a post type's support for a given feature.
• _e()Displays translated text.
• twentytwenty_the_theme_svg()Output and Get Theme SVG.
• __()Retrieves the translation of $text.
• esc_url()Checks and cleans a URL.
• get_author_posts_url()Retrieves the URL to the author page for the user with the ID provided.

Used by · 1

• twentytwenty_the_post_meta()Retrieves and displays the post meta.

Source

View on Trac ↗View on GitHub ↗

242function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' ) {243 244	// Require post ID.245	if ( ! $post_id ) {246		return;247	}248 249	/**250	 * Filters post types array.251	 *252	 * This filter can be used to hide post meta information of post, page or custom post type253	 * registered by child themes or plugins.254	 *255	 * @since Twenty Twenty 1.0256	 *257	 * @param array Array of post types.258	 */259	$disallowed_post_types = apply_filters( 'twentytwenty_disallowed_post_types_for_meta_output', array( 'page' ) );260 261	// Check whether the post type is allowed to output post meta.262	if ( in_array( get_post_type( $post_id ), $disallowed_post_types, true ) ) {263		return;264	}265 266	$post_meta_wrapper_classes = '';267	$post_meta_classes         = '';268 269	// Get the post meta settings for the location specified.270	if ( 'single-top' === $location ) {271		/**272		 * Filters post meta info visibility.273		 *274		 * Use this filter to hide post meta information like Author, Post date, Comments, Is sticky status.275		 *276		 * @since Twenty Twenty 1.0277		 *278		 * @param array $args {279		 *     @type string $author280		 *     @type string $post-date281		 *     @type string $comments282		 *     @type string $sticky283		 * }284		 */285		$post_meta = apply_filters(286			'twentytwenty_post_meta_location_single_top',287			array(288				'author',289				'post-date',290				'comments',291				'sticky',292			)293		);294 295		$post_meta_wrapper_classes = ' post-meta-single post-meta-single-top';296 297	} elseif ( 'single-bottom' === $location ) {298 299		/**300		 * Filters post tags visibility.301		 *302		 * Use this filter to hide post tags.303		 *304		 * @since Twenty Twenty 1.0305		 *306		 * @param array $args {307		 *     @type string $tags308		 * }309		 */310		$post_meta = apply_filters(311			'twentytwenty_post_meta_location_single_bottom',312			array(313				'tags',314			)315		);316 317		$post_meta_wrapper_classes = ' post-meta-single post-meta-single-bottom';318 319	}320 321	// If the post meta setting has the value 'empty', it's explicitly empty and the default post meta shouldn't be output.

History

Introduced in Twenty Twenty 1.0. One change between 6.7.7 and 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/twentytwenty/inc/template-tags.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.