the_meta()

Display a list of post custom fields.

Contents

Description Description

Source Source

File: wp-includes/post-template.php 

function the_meta() {
	if ( $keys = get_post_custom_keys() ) {
		$li_html = '';
		foreach ( (array) $keys as $key ) {
			$keyt = trim( $key );
			if ( is_protected_meta( $keyt, 'post' ) ) {
				continue;
			}

			$values = array_map( 'trim', get_post_custom_values( $key ) );
			$value  = implode( $values, ', ' );

			$html = sprintf(
				"<li><span class='post-meta-key'>%s</span> %s</li>\n",
				/* translators: %s: Post custom field name */
				sprintf( _x( '%s:', 'Post custom field name' ), $key ),
				$value
			);

			/**
			 * Filters the HTML output of the li element in the post custom fields list.
			 *
			 * @since 2.2.0
			 *
			 * @param string $html  The HTML output for the li element.
			 * @param string $key   Meta key.
			 * @param string $value Meta value.
			 */
			$li_html .= apply_filters( 'the_meta_key', $html, $key, $value );
		}

		if ( $li_html ) {
			echo "<ul class='post-meta'>\n{$li_html}</ul>\n";
		}
	}
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
1.2.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/l10n.php: _x()

Retrieve translated string with gettext context.
wp-includes/plugin.php: apply_filters()

Call the functions added to a filter hook.
wp-includes/post-template.php: the_meta_key

Filters the HTML output of the li element in the post custom fields list.
wp-includes/post.php: get_post_custom_keys()

Retrieve meta field names for a post.
wp-includes/post.php: get_post_custom_values()

Retrieve values for a custom post field.
wp-includes/meta.php: is_protected_meta()

Determines whether a meta key is considered protected.
Show 1 more use Hide more uses

Top ↑

User Contributed Notes User Contributed Notes

  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by Jb Audras —

    Since revision 41583, the_meta() allow translators to manage spaces before the colon character.

    Default output:

    <ul class="post-meta">
    <li><span class='post-meta-key'>Your first meta key:</span> one or several values separated by commas</li>
    …
    <li><span class='post-meta-key'>Your second meta key:</span> one or several values separated by commas</li>
    <li><span class='post-meta-key'>Your third meta key:</span> one or several values separated by commas</li>
</ul>

    French output:

    <ul class="post-meta">
	<li><span class='post-meta-key'>Your first meta key :</span> one or several values separated by commas</li>
	…
	<li><span class='post-meta-key'>Your second meta key :</span> one or several values separated by commas</li>
	<li><span class='post-meta-key'>Your third meta key :</span> one or several values separated by commas</li>
</ul>

    There is a non breaking space character before the colon character. Each Locale can handle it differently.

You must log in before being able to contribute a note or feedback.