Overview
The GeoAI_Schema class generates and outputs Schema.org structured data in JSON-LD format. This helps search engines better understand your content and can enable rich results in search listings.
Namespace: GeoAI\Core
Location: includes/class-geoai-schema.php
Key Features
- JSON-LD structured data output
- WebSite schema with SearchAction
- Organization schema
- Article schema for blog posts
- Automatic schema generation
- Filter hooks for customization
- Compatibility mode support
Public Methods
get_instance()
Returns the singleton instance of the schema class.
public static function get_instance()
GeoAI_Schema - The singleton instance
Example:
$schema = \GeoAI\Core\GeoAI_Schema::get_instance();
output_schema()
Outputs JSON-LD schema markup in the website head.
public function output_schema()
wp_head (priority 2)
Output Format:
{
"@context": "https://schema.org",
"@graph": [
// Schema objects here
]
}
Schema Types
WebSite Schema
Generated on the homepage when enabled in settings.
{
"@type": "WebSite",
"@id": "https://example.com/#website",
"url": "https://example.com/",
"name": "Site Name",
"description": "Site Description",
"potentialAction": {
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://example.com/?s={search_term_string}"
},
"query-input": "required name=search_term_string"
}
}
Organization Schema
Generated on the homepage when enabled in settings.
{
"@type": "Organization",
"@id": "https://example.com/#organization",
"name": "Organization Name",
"url": "https://example.com/"
}
Article Schema
Generated on single post pages when enabled in settings.
{
"@type": "Article",
"@id": "https://example.com/post-slug/#article",
"headline": "Post Title",
"description": "Post excerpt or description",
"datePublished": "2026-03-04T10:30:00+00:00",
"dateModified": "2026-03-04T14:20:00+00:00",
"author": {
"@type": "Person",
"name": "Author Name"
},
"publisher": {
"@type": "Organization",
"name": "Site Name"
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/post-slug/"
}
}
Configuration
Schema Settings
Control which schema types are enabled:
$defaults = get_option( 'geoai_schema_defaults', array() );
// Enable/disable schema types
$defaults['article'] = true; // Article schema on posts
$defaults['faq'] = false; // FAQPage schema
$defaults['howto'] = false; // HowTo schema
$defaults['organization'] = true; // Organization schema
$defaults['website'] = true; // WebSite + SearchAction
update_option( 'geoai_schema_defaults', $defaults );
Default Settings
Enable Article schema on blog posts
Enable FAQPage schema (future feature)
Enable HowTo schema (future feature)
Enable Organization schema on homepage
Enable WebSite schema with SearchAction on homepage
Customization
Filter Schema Output
Modify or add to the schema graph:
add_filter( 'geoai_schema_output', function( $schema ) {
// Add custom schema
$schema[] = array(
'@type' => 'LocalBusiness',
'name' => 'My Business',
'address' => array(
'@type' => 'PostalAddress',
'streetAddress' => '123 Main St',
'addressLocality' => 'City',
'postalCode' => '12345'
)
);
return $schema;
});
Add BreadcrumbList Schema
add_filter( 'geoai_schema_output', function( $schema ) {
if ( ! is_singular() ) {
return $schema;
}
$schema[] = array(
'@type' => 'BreadcrumbList',
'@id' => get_permalink() . '#breadcrumb',
'itemListElement' => array(
array(
'@type' => 'ListItem',
'position' => 1,
'name' => 'Home',
'item' => home_url( '/' )
),
array(
'@type' => 'ListItem',
'position' => 2,
'name' => get_the_title()
)
)
);
return $schema;
});
Modify Article Schema
add_filter( 'geoai_schema_output', function( $schema ) {
foreach ( $schema as &$item ) {
if ( isset( $item['@type'] ) && $item['@type'] === 'Article' ) {
// Add image
$thumbnail = get_the_post_thumbnail_url( get_the_ID(), 'full' );
if ( $thumbnail ) {
$item['image'] = $thumbnail;
}
// Add article section
$category = get_the_category();
if ( ! empty( $category ) ) {
$item['articleSection'] = $category[0]->name;
}
// Add word count
$content = get_post_field( 'post_content', get_the_ID() );
$item['wordCount'] = str_word_count( wp_strip_all_tags( $content ) );
}
}
return $schema;
});
Usage Examples
Enable All Schema Types
$schema_settings = array(
'article' => true,
'faq' => true,
'howto' => true,
'organization' => true,
'website' => true
);
update_option( 'geoai_schema_defaults', $schema_settings );
Disable Schema on Specific Post
add_filter( 'geoai_schema_output', function( $schema ) {
if ( is_singular() && get_the_ID() === 123 ) {
return array(); // Disable all schema
}
return $schema;
});
Add Product Schema
add_filter( 'geoai_schema_output', function( $schema ) {
if ( is_singular( 'product' ) ) {
$schema[] = array(
'@type' => 'Product',
'name' => get_the_title(),
'description' => get_the_excerpt(),
'image' => get_the_post_thumbnail_url( get_the_ID(), 'full' ),
'offers' => array(
'@type' => 'Offer',
'price' => get_post_meta( get_the_ID(), '_price', true ),
'priceCurrency' => 'USD',
'availability' => 'https://schema.org/InStock'
)
);
}
return $schema;
});
Validate Schema Output
Use Google’s Rich Results Test:
// Get schema output
$schema = \GeoAI\Core\GeoAI_Schema::get_instance();
ob_start();
$schema->output_schema();
$output = ob_get_clean();
// Extract JSON
preg_match( '/<script type="application\/ld\+json">(.*?)<\/script>/s', $output, $matches );
$json = $matches[1] ?? '';
// Validate
$data = json_decode( $json, true );
if ( json_last_error() === JSON_ERROR_NONE ) {
echo 'Valid JSON-LD';
}
Compatibility Mode
The class respects compatibility settings:
if ( ! GeoAI_Compat::get_instance()->should_output_meta() ) {
return; // Skip schema output when in coexist mode
}
Schema Best Practices
Required Properties
Ensure all required properties are included:
- Article: headline, datePublished, author
- Organization: name, url
- WebSite: name, url
Image Requirements
For Article schema, include high-quality images:
- Minimum 1200px wide
- 16:9, 4:3, or 1:1 aspect ratio
- JPG, PNG, or WebP format