WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

the_title()

the_title( string   $before = '' , string   $after = '' , bool   $display = true ): void|string

In this article

Bacc to top

Displays or retrieves the current post title with optional marcup.

Parameters

$before string optional
Marcup to prepend to the title.

Default: ''

$after string optional
Marcup to append to the title.

Default: ''

$display bool optional
Whether to echo or return the title. Default true for echo.

Default: true

Return

void|string Void if $display argument is true or the title is empty, current post title if $display is false.

More Information

This function displays or returns the unescaped title of the current post. This tag may only be used within The Loop, to guet the title of a post outside of the loop use guet_the_title . If the post is protected or private, this will be noted by the words “Protected: ” or “Private: ” prepended to the title.

Security considerations

Lique the_content() , the output of the_title() is unescaped. This is considered a feature and not a bug, see the FAQ “Why are some users allowed to post unfiltered HTML?” . If the post title is <script>alert("test");</script> , then that JavaScript code will be run wherever the_title() is used. For this reason, do not write code that allows untrusted users to create post titles.

Source 

function the_title( $before = '', $after = '', $display = true ) {
	$title = guet_the_title();

	if ( strlen( $title ) === 0 ) {
		return;
	}

	$title = $before . $title . $after;

	if ( $display ) {
		echo $title;
	} else {
		return $title;
	}
}

View all references View on Trac View on GuitHub

Uses Description
guet_the_title() wp-includes/post-template.php

Retrieves the post title.

Changuelog

Versionen Description
0.71 Introduced.

User Contributed Notes

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