Post Link
elementor_extras/widgets/posts/link
Filters the post link.
Parameters
| Param | Type | Description |
|---|---|---|
| $link | String | The link to the post |
| $post | WP_Post | The post object |
Example usage
add_filter( 'elementor_extras/widgets/posts/link', function( $link, $post ) {
// Modify post link here
return $link; // Return the post link
}, 10, 2);Post Thumbnail
elementor_extras/widgets/posts/thumbnail
Filters the post thumbnail.
Parameters
| Param | Type | Description |
|---|---|---|
| $post_thumbnail | String | The html for the thumbnail of the post |
| $post | WP_Post | The post object |
Returns
post_thumbnail — The html for the thumbnail of the post.
Example usage
add_filter( 'elementor_extras/widgets/posts/thumbnail', function( $post_thumbnail, $post ) {
// Modify post thumbnail html here
return $post_thumbnail; // Return the post thumbnail
}, 10, 2);Post Title
ee_posts_title
Deprecated. Use elementor_extras/widgets/posts/title instead.
elementor_extras/widgets/posts/title
Filters the title of each post in the widget.
Parameters
| Param | Type | Description |
|---|---|---|
| $post_title | String | The title of the post |
| $post | WP_Post | The post object |
Returns
post_title — The title of the post
Example usage
add_filter( 'elementor_extras/widgets/posts/title', function( $post_title, $post ) {
// Modify post title here
return $post_title; // Return the post title
}, 10, 2);elementor_extras/widgets/posts/title/link
Filters the title link of each post in the widget.
Parameters
| Param | Type | Description |
|---|---|---|
| $title_link | String | The link to the post |
| $post | WP_Post | The post object |
Returns
title_link — The link to the post
Example usage
add_filter( 'elementor_extras/widgets/posts/title/link', function( $title_link, $post ) {
// Modify the link here
return $title_link; // Return the link
}, 10, 2);Post Date Time
ee_posts_date_time
Deprecated. Use elementor_extras/widgets/posts/date_time instead.
elementor_extras/widgets/posts/date_time
Filters the date of each post in the widget.
Parameters
| Param | Type | Description |
|---|---|---|
| $post_date_time | String | The date and time of the post |
| $post | WP_Post | The post object |
Returns
post_title — The title of the post
Example usage
add_filter( 'elementor_extras/widgets/posts/post_date_time', function( $post_date_time, $post ) {
// Modify date time here
return $post_date_time; // Return the date time
}, 10, 2);Post Comments
ee_posts_comments_prefix
Deprecated. Use elementor_extras/widgets/posts/comments/prefix instead.
elementor_extras/widgets/posts/comments/prefix
Filters the prefix for the post comments count.
Parameters
| Param | Type | Description |
|---|---|---|
| $post_comments_prefix | String | The comments count prefix |
| $post | WP_Post | The post object |
Returns
post_comments_prefix — The comments count prefix
Example usage
add_filter( 'elementor_extras/widgets/posts/comments/prefix', function( $post_comments_prefix, $post ) {
$post_comments_prefix = __( 'Comments: ' );
return $post_comments_prefix; // Return the comments count prefix
}, 10, 2);In the example above we change the prefix with a custom one programatically.
ee_posts_comments
Deprecated. Use elementor_extras/widgets/posts/comments instead.
elementor_extras/widgets/posts/comments
Filters the post comments count.
Parameters
| Param | Type | Description |
|---|---|---|
| $post_comments | String | The comments count |
| $post | WP_Post | The post object |
Returns
post_comments — The comments count
Example usage
add_filter( 'elementor_extras/widgets/posts/comments', function( $post_comments, $post ) {
if ( 0 === get_comments_number( $post->ID ) ) { // Check if there are any comments
$post_comments = __( 'No comments' ); // Replace the count with a custom string
}
return $post_comments; // Return the post comment count
}, 10, 2);In the example above we replace the comment count to a specific message if there are no comments for the post.
ee_posts_comments_suffix
Deprecated. Use elementor_extras/widgets/posts/comments/suffix instead.
elementor_extras/widgets/posts/comments/suffix
Filters the suffix for the post comments count.
Parameters
| Param | Type | Description |
|---|---|---|
| $post_comments_suffix | String | The comments count suffix |
| $post | WP_Post | The post object |
Returns
post_comments_suffix — The comments count suffix
Example usage
add_filter( 'elementor_extras/widgets/posts/comments/suffix', function( $post_comments_suffix, $post ) {
$post_comments_suffix = __( 'replies' );
return $post_comments_suffix; // Return the comments count suffix
}, 10, 2);The example above sets the suffix to ‘replies’. The output for the comment count (if no prefix is added) will be:
10 replies
Post Excerpt
ee_posts_excerpt
Deprecated. Use elementor_extras/widgets/posts/excerpt instead.
elementor_extras/widgets/posts/excerpt
Filters the post excerpt.
Parameters
| Param | Type | Description |
|---|---|---|
| $post_excerpt | String | The excerpt of the post |
| $post | WP_Post | The post object |
Returns
post_excerpt — The excerpt of the post
Example usage
add_filter( 'elementor_extras/widgets/posts/excerpt', function( $post_excerpt, $post ) {
// Modify post excerpt here
return $post_excerpt; // Return the excerpt
}, 10, 2);In the above example we hook into the field excerpt, check if a specific ACF field is set and if so we set the excerpt of the value of that field.
Post Button
elementor_extras/widgets/posts/media/link
Filters the post media link. This is available only if the whole media area is linked when the Content > Media > Link to Post option is enabled.
Parameters
| Param | Type | Description |
|---|---|---|
| $media_link | String | The link for the post media area |
| $post | WP_Post | The post object |
Returns
media_link — The link for the media area
Example usage
add_filter( 'elementor_extras/widgets/posts/media/link', function( $media_link, $post ) {
// Modify the link here
return $media_link; // Return the link
}, 10, 2);Post Button
elementor_extras/widgets/posts/button/link
Filters the post button link.
Parameters
| Param | Type | Description |
|---|---|---|
| $button_link | String | The link for the post button |
| $post | WP_Post | The post object |
Returns
button_link — The link for the button
Example usage
add_filter( 'elementor_extras/widgets/posts/button/link', function( $button_link, $post ) {
// Modify the link here
return $button_link; // Return the link
}, 10, 2);elementor_extras/widgets/posts/button/text
Filters the label for the post read more button.
Parameters
| Param | Type | Description |
|---|---|---|
| $button_text | String | The label of the button |
| $post | WP_Post | The post object |
Returns
button_text — The button label
Example usage
add_filter( 'elementor_extras/widgets/posts/button/text', function( $button_text, $post ) {
$button_text = sprintf( __( 'Read about %s' ), $post->post_title ); // Include the post title in the button label
return $button_text; // Return the button label
}, 10, 2);In this example we redefine the label for the button include the title of the post and return the new label.
Queries
elementor_extras/widgets/posts/query
Filters the current query for the widget. This is run AFTER any Elementor filters added for the same query.
Parameters
| Param | Type | Description |
|---|---|---|
| $query | WP_Query | The current query |
Returns
query — The modified query
Example usage
add_filter( 'elementor_extras/widgets/posts/query', function( $query ) {
// Modify your query here
return $query; // Return the new query
}, 10, 1);elementor_extras/widgets/posts/filters/args
Filters the args for the term filters.
Parameters
| Param | Type | Description |
|---|---|---|
| $args | Array | Array of arguments. See WP_Term_Query::__construct() for information on accepted arguments. |
Returns
$args — The modified args
Example usage
add_filter( 'elementor_extras/widgets/posts/filters/args', function( $args ) {
$args['hide_empty'] = false;
return $args;
}, 10, 1);