bavarianrankengine/bavarian-rank-engine/includes/Features/SchemaEnhancer.php

<?php
namespace BavarianRankEngine\Features;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

use BavarianRankEngine\Admin\SettingsPage;

class SchemaEnhancer {
	public function register(): void {
		$settings = SettingsPage::getSettings();
		$enabled  = $settings['schema_enabled'] ?? array();

		if ( empty( $enabled ) ) {
			return;
		}

		if ( in_array( 'ai_meta_tags', $enabled, true ) ) {
			add_action( 'wp_head', array( $this, 'outputAiMetaTags' ), 1 );
		}

		$json_ld_types = array_diff( $enabled, array( 'ai_meta_tags' ) );
		if ( ! empty( $json_ld_types ) ) {
			add_action( 'wp_head', array( $this, 'outputJsonLd' ), 5 );
		}

		add_action( 'wp_head', array( $this, 'outputMetaDescription' ), 2 );
	}

	public function outputAiMetaTags(): void {
		echo '<meta name="robots" content="max-snippet:-1, max-image-preview:large, max-video-preview:-1">' . "\n";
		echo '<meta name="googlebot" content="max-snippet:-1, max-image-preview:large">' . "\n";
	}

	public function outputMetaDescription(): void {
		if ( defined( 'RANK_MATH_VERSION' ) || defined( 'WPSEO_VERSION' ) || defined( 'AIOSEO_VERSION' ) ) {
			return;
		}
		if ( ! is_singular() ) {
			return;
		}

		$desc = get_post_meta( get_the_ID(), '_bre_meta_description', true );
		if ( empty( $desc ) ) {
			return;
		}

		echo '<meta name="description" content="' . esc_attr( $desc ) . '">' . "\n";
	}

	public function outputJsonLd(): void {
		$settings = SettingsPage::getSettings();
		$enabled  = $settings['schema_enabled'] ?? array();
		$schemas  = array();

		if ( in_array( 'organization', $enabled, true ) ) {
			$schemas[] = $this->buildOrganizationSchema( $settings );
		}

		if ( is_singular() ) {
			if ( in_array( 'article_about', $enabled, true ) ) {
				$schemas[] = $this->buildArticleSchema();
			}
			if ( in_array( 'author', $enabled, true ) ) {
				$schemas[] = $this->buildAuthorSchema();
			}
			if ( in_array( 'speakable', $enabled, true ) ) {
				$schemas[] = $this->buildSpeakableSchema();
			}
		}

		if ( in_array( 'breadcrumb', $enabled, true )
			&& ! defined( 'RANK_MATH_VERSION' )
			&& ! defined( 'WPSEO_VERSION' ) ) {
			$breadcrumb = $this->buildBreadcrumbSchema();
			if ( $breadcrumb ) {
				$schemas[] = $breadcrumb;
			}
		}

		foreach ( $schemas as $schema ) {
			echo '<script type="application/ld+json">'
				. wp_json_encode( $schema, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES )
				. '</script>' . "\n";
		}
	}

	private function buildOrganizationSchema( array $settings ): array {
		$same_as = array_values( array_filter( $settings['schema_same_as']['organization'] ?? array() ) );
		$schema  = array(
			'@context' => 'https://schema.org',
			'@type'    => 'Organization',
			'name'     => get_bloginfo( 'name' ),
			'url'      => home_url( '/' ),
		);
		if ( ! empty( $same_as ) ) {
			$schema['sameAs'] = $same_as;
		}
		$logo = get_site_icon_url( 192 );
		if ( $logo ) {
			$schema['logo'] = $logo;
		}
		return $schema;
	}

	private function buildArticleSchema(): array {
		return array(
			'@context'      => 'https://schema.org',
			'@type'         => 'Article',
			'headline'      => get_the_title(),
			'url'           => get_permalink(),
			'datePublished' => get_the_date( 'c' ),
			'dateModified'  => get_the_modified_date( 'c' ),
			'description'   => get_post_meta( get_the_ID(), '_bre_meta_description', true ) ?: get_the_excerpt(),
			'publisher'     => array(
				'@type' => 'Organization',
				'name'  => get_bloginfo( 'name' ),
				'url'   => home_url( '/' ),
			),
		);
	}

	private function buildAuthorSchema(): array {
		$author_id = (int) get_the_author_meta( 'ID' );
		$schema    = array(
			'@context' => 'https://schema.org',
			'@type'    => 'Person',
			'name'     => get_the_author(),
			'url'      => get_author_posts_url( $author_id ),
		);
		$twitter   = get_the_author_meta( 'twitter', $author_id );
		if ( $twitter ) {
			$schema['sameAs'] = array( 'https://twitter.com/' . ltrim( $twitter, '@' ) );
		}
		return $schema;
	}

	private function buildSpeakableSchema(): array {
		return array(
			'@context'  => 'https://schema.org',
			'@type'     => 'WebPage',
			'url'       => get_permalink(),
			'speakable' => array(
				'@type'       => 'SpeakableSpecification',
				'cssSelector' => array( 'h1', '.entry-content p:first-of-type', '.post-content p:first-of-type' ),
			),
		);
	}

	private function buildBreadcrumbSchema(): ?array {
		if ( ! is_singular() && ! is_category() ) {
			return null;
		}

		$items = array(
			array(
				'@type'    => 'ListItem',
				'position' => 1,
				'name'     => get_bloginfo( 'name' ),
				'item'     => home_url( '/' ),
			),
		);

		if ( is_singular() ) {
			$items[] = array(
				'@type'    => 'ListItem',
				'position' => 2,
				'name'     => get_the_title(),
				'item'     => get_permalink(),
			);
		}

		return array(
			'@context'        => 'https://schema.org',
			'@type'           => 'BreadcrumbList',
			'itemListElement' => $items,
		);
	}
}