apply_filters( 'the_content', string $content )
Filters the post content.
Contents
Description Description
Parameters Parameters
- $content
-
(string) Content of the current post.
Source Source
Changelog Changelog
| Version | Description |
|---|---|
| 0.71 | Introduced. |
More Information More Information
This filter is used to filter the content of a post after it is retrieved from the database and before it is printed to the screen.
Usage Usage
When using this filter it’s important to check if you’re filtering the content in the main query with the conditionals is_main_query() and in_the_loop(). The main post query can be thought of as the primary post loop that displays the main content for a post, page or archive. Without these conditionals you could unintentionally be filtering the content for custom loops in sidebars, footers, or elsewhere.
add_filter( 'the_content', 'filter_the_content_in_the_main_loop' );
function filter_the_content_in_the_main_loop( $content ) {
// Check if we're inside the main loop in a single post page.
if ( is_single() && in_the_loop() && is_main_query() ) {
return $content . "I'm filtering the content inside the main loop";
}
return $content;
}
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Note that
the_contentfilter isn’t used whenget_the_content()function is called.You can choose whether $content will have Shortcodes processed before or after your
the_contentfunction has executed by setting the Priority inadd_filter. The default (10) will process Shortcodes after you have returned $content at the end of your Filter function. A large figure, such as 99, will already have processed Shortcodes before your Filter function is passed $content.Example
/* Add a paragraph only to Pages. */ function my_added_page_content ( $content ) { if ( is_page() ) { return $content . '<p>Your content added to all pages (not posts).</p>'; } } add_filter( 'the_content', 'my_added_page_content');