Overview
Control whether to automatically add author information to JSON-LD output.
Description
By default, ACF automatically includes the post author in the JSON-LD output as a Person object with name and URL. This filter allows you to disable this behavior for specific posts or post types.
Changelog
- Added in version 6.8.0
Parameters
apply_filters( 'acf/schema/auto_add_author', $add_author, $post, $post_type );
$add_author(bool) Whether to add the author. Default:true$post(WP_Post) The post object$post_type(string) The post type name
Return
(bool) Whether to add author information to JSON-LD output.
Example
This example disables auto author for pages.
/**
* Disable auto author for pages.
*
* @param bool $add_author Whether to add author.
* @param WP_Post $post The post object.
* @param string $post_type The post type.
* @return bool Whether to add author.
*/
function my_acf_schema_disable_page_author( $add_author, $post, $post_type ) {
if ( $post_type === 'page' ) {
return false;
}
return $add_author;
}
add_filter( 'acf/schema/auto_add_author', 'my_acf_schema_disable_page_author', 10, 3 );
This example disables auto author when using a custom author ACF field.
/**
* Disable auto author when custom author field exists.
*
* @param bool $add_author Whether to add author.
* @param WP_Post $post The post object.
* @param string $post_type The post type.
* @return bool Whether to add author.
*/
function my_acf_schema_custom_author_field( $add_author, $post, $post_type ) {
// If we have a custom author field mapped, don't add the auto author
$custom_author = get_field( 'article_author', $post->ID );
if ( $custom_author ) {
return false;
}
return $add_author;
}
add_filter( 'acf/schema/auto_add_author', 'my_acf_schema_custom_author_field', 10, 3 );
Supercharge Your Website With Premium Features Using ACF PRO
Speed up your workflow and unlock features to better develop websites using ACF Blocks and Options Pages, with the Flexible Content, Repeater, Clone, Gallery Fields & More.
Related
- Filters: acf/schema/auto_add_image
- Filters: acf/schema/disable_output
- Filters: acf/schema/data
- Filters: acf/schema/post_field_objects
- Filters: acf/schema/block_jsonld_enabled