Ubuntu

init(); } /** * Initialize the GEO Posts extension * * @since 6.8.0 */ public function init() { // Add front-end JSON-LD output for posts. add_action( 'wp_head', array( $this, 'output_jsonld_data' ) ); } /** * Output JSON-LD structured data for ACF fields on posts * * @since 6.8.0 */ public function output_jsonld_data() { /** * Filters whether to output debug comments in HTML * * @param bool $debug Whether to output debug comments. Default false. */ $debug = apply_filters( 'acf/schema/debug', false ); // Only output on singular posts/pages. if ( ! is_singular() ) { if ( $debug ) { echo "\n"; } return; } global $post; if ( ! $post ) { if ( $debug ) { echo "\n"; } return; } $post_type = get_post_type( $post ); if ( ! $post_type ) { if ( $debug ) { echo "\n"; } return; } if ( $debug ) { echo '\n"; } // Build list of post types with JSON-LD enabled. $enabled_post_types = array(); // Get ACF custom post types with JSON-LD enabled. $acf_post_types = acf_get_acf_post_types(); foreach ( $acf_post_types as $acf_post_type ) { if ( ! empty( $acf_post_type['auto_jsonld'] ) && isset( $acf_post_type['post_type'] ) ) { $enabled_post_types[] = $acf_post_type['post_type']; } } /** * Filters the list of post types that have JSON-LD output enabled. * * @param array $enabled_post_types Array of post type names with JSON-LD enabled. */ $enabled_post_types = apply_filters( 'acf/schema/enabled_post_types', $enabled_post_types ); // Exit if current post type is not in the enabled list. if ( ! in_array( $post_type, $enabled_post_types, true ) ) { if ( $debug ) { echo '\n"; } return; } /** * Filters the field objects before retrieval, allowing posts to provide custom data. * * This is useful for posts that need custom field data handling. * Return a non-null value to short-circuit the default get_field_objects() call. * * @since 6.8.0 * * @param array|null $field_objects The field objects array, or null to use default behavior. * @param WP_Post $post The post object. * @param string $post_type The post type. */ $field_objects = apply_filters( 'acf/schema/post_field_objects', null, $post, $post_type ); /** * Filters the field objects for a specific post type. * * The dynamic portion of the hook name, `$post_type`, refers to the post type name. * For example, 'acf/schema/post_field_objects/post_type=product' for the product post type. * * @since 6.8.0 * * @param array|null $field_objects The field objects array, or null to use default behavior. * @param WP_Post $post The post object. */ $field_objects = apply_filters( 'acf/schema/post_field_objects/post_type=' . $post_type, $field_objects, $post ); // If no custom field objects were provided, get them from the post. if ( null === $field_objects ) { // Get all ACF field objects for this post without formatting to get raw ACF storage format. $field_objects = get_field_objects( $post->ID, false ); } if ( ! $field_objects || ! is_array( $field_objects ) ) { if ( $debug ) { echo '\n"; } return; } if ( $debug ) { echo '\n"; } // Process ACF fields and extract types from qualified properties. // This handles schema_property mapping. $processed_fields = GEO::process_fields( $field_objects ); // Get any explicitly set schema type for this post type. $acf_post_type_object = null; foreach ( $acf_post_types as $acf_post_type ) { if ( isset( $acf_post_type['post_type'] ) && $acf_post_type['post_type'] === $post_type ) { $acf_post_type_object = $acf_post_type; break; } } $provided_type = $acf_post_type_object['schema_type'] ?? null; $field_types = $processed_fields['field_types'] ?? array(); // Determine the final @type based on provided type or field types from qualified properties. $schema_type = GEO::determine_schema_type( $provided_type, $field_types, 'Article' ); // Remove internal type data from processed fields. unset( $processed_fields['field_types'] ); // Build base JSON-LD structured data. $jsonld_data = array( '@context' => 'https://schema.org', '@type' => $schema_type, '@id' => get_permalink( $post ), 'url' => get_permalink( $post ), 'name' => get_the_title( $post ), 'headline' => get_the_title( $post ), ); // Add publication date if available. if ( $post->post_date ) { $jsonld_data['datePublished'] = get_the_date( 'c', $post ); } if ( $post->post_modified ) { $jsonld_data['dateModified'] = get_the_modified_date( 'c', $post ); } /** * Filter whether to automatically add featured image to JSON-LD output * * @param bool $add_image Whether to add the featured image. Default true. * @param WP_Post $post The post object. * @param string $post_type The post type. */ $add_image = apply_filters( 'acf/schema/auto_add_image', true, $post, $post_type ); // Add featured image if available and enabled. if ( $add_image && has_post_thumbnail( $post ) ) { $thumbnail_id = get_post_thumbnail_id( $post ); $thumbnail_url = wp_get_attachment_image_url( $thumbnail_id, 'full' ); if ( $thumbnail_url ) { // Get image metadata for additional properties. $image_meta = wp_get_attachment_metadata( $thumbnail_id ); $jsonld_data['image'] = array( '@type' => 'ImageObject', 'url' => $thumbnail_url, ); if ( isset( $image_meta['width'] ) ) { $jsonld_data['image']['width'] = $image_meta['width']; } if ( isset( $image_meta['height'] ) ) { $jsonld_data['image']['height'] = $image_meta['height']; } } } /** * Filter whether to automatically add author to JSON-LD output * * @param bool $add_author Whether to add the author. Default true. * @param WP_Post $post The post object. * @param string $post_type The post type. */ $add_author = apply_filters( 'acf/schema/auto_add_author', true, $post, $post_type ); // Add author if enabled. if ( $add_author && $post->post_author ) { $author = get_userdata( $post->post_author ); if ( $author ) { $jsonld_data['author'] = array( '@type' => 'Person', 'name' => $author->display_name, ); // Add author URL if available. $author_url = get_author_posts_url( $post->post_author ); if ( $author_url ) { $jsonld_data['author']['url'] = $author_url; } } } // Merge processed fields into JSON-LD data. $jsonld_data = array_merge( $jsonld_data, $processed_fields ); /** * Filters the JSON-LD data before output for a post. * * @param array $jsonld_data The JSON-LD data array. * @param WP_Post $post The post object. * @param string $post_type The post type. */ $jsonld_data = apply_filters( 'acf/schema/data', $jsonld_data, $post, $post_type ); // Only output if we have data after filtering. if ( empty( $jsonld_data ) ) { return; } // Output the JSON-LD using the shared helper. GEO::render_jsonld_script( $jsonld_data ); } }