PRC Schema SEO

Provides schema generation, SEO meta tags, primary term management, preview panels, and site-level template defaults for titles & descriptions on Pew Research Center platform sites.

Features

• JSON-LD schema generation with post-type level overrides
• Meta tag output (title, description, canonical, robots, Open Graph, Twitter)
• Primary term selection per taxonomy
• Editor previews (search, social, chat, internal)
• Site Editor sidebar for global pattern configuration and noindex lists
• Extensible pattern token engine
• AI-powered SEO suggestions (title, description, social text) via the prc-schema-seo/suggest WP AI ability
• Real-Time Collaboration (RTC) compatible editor UI (WP 7.0+)
• Auto-redirects on slug/term changes via Safe Redirect Manager integration
• Redirect CSV import UI
• IndexNow search engine notification on publish
• Google Search Console URL Inspection integration
• Reading score WP Ability
• Parse.ly metadata via the official wp-parsely plugin (see below)

Requirements

Required plugins (declared in the plugin header Requires Plugins field):

• prc-scripts — provides @prc/components, @prc/icons, and shared webpack configuration
• prc-post-publish-pipeline — sync and async post lifecycle hooks used for cache invalidation, IndexNow, and Search Console

The plugin no longer depends on prc-platform-core. All shared JS components and scripts are sourced from prc-scripts.

Parse.ly (wp-parsely)

The platform uses Automattic’s wp-parsely on VIP. prc-schema-seo implements Parsely_Integration (includes/class-parsely-integration.php) so Pew SEO data (canonical URL, titles, authors, sections, keywords) is merged into Parse.ly’s metadata pipeline instead of maintaining a parallel tag system.

How it works

WordPress hooks used

Caching

Home, term, and post type archive Parse.ly HTML fragments are cached with wp_cache_* in group prc_schema_seo_parsely_07142026, TTL 1 hour, keys such as parsely_tags_home, parsely_tags_term_{term_id}, and parsely_tags_post_type_archive_{post_type}. Term and home/archive fragments are invalidated on term meta updates and blogname/home/siteurl option changes. The WP-CLI migration command can warm term cache via the same Parsely_Integration::warm_term_cache() path.

Operational notes

• Canonical: Changes that affect prc_schema_seo_canonical_url or stored SEO data affect Parse.ly link and url fields after cache invalidation or TTL expiry.
• Keywords / section: Built from category, formats, research-teams, and internal markers (get_parsely_tag_tokens, get_parsely_section); empty section is omitted so articleSection is not sent when there is no primary category name.
• Troubleshooting: If Parse.ly tags are missing locally, confirm environment type is local (for MU loader), that wp-parsely is active, and that the current template is not one where insertion is intentionally disabled (see table above).

Pattern Tokens

Patterns can be set for title & description via Site Editor sidebar fields. The following tokens are available:

Static tokens:

%post_title%
%site_name%
%primary_category%
%post_type%
%year%
%author%
%categories%      (comma-separated list of category names)
%tags%            (comma-separated list of tag names)

Dynamic tokens:

%primary_term:taxonomy%   (chosen primary term for the taxonomy, falls back to first term)
%terms:taxonomy%          (comma-separated list of all term names for taxonomy)

Whitespace is normalized after replacement. Empty tokens resolve to an empty string.

Extending Tokens

Use the prc_schema_seo_pattern_tokens filter to register additional simple tokens (key/value pairs). Dynamic patterns should be handled separately (e.g. by also parsing custom placeholders inside a secondary filter if needed).

add_filter( 'prc_schema_seo_pattern_tokens', function( $tokens, $post_id ) {
    $modified = get_post( $post_id ) ? get_post_modified_time( 'Y-m-d', false, $post_id ) : '';
    $tokens['%modified_date%'] = $modified;
    return $tokens;
}, 10, 2 );

Filters Reference

All hooks use the prc_schema_seo_ prefix. Return values must match the documented type; invalid types are ignored and logged.

Schema Output

// Example: mark a custom post type as SoftwareApplication
add_filter( 'prc_schema_seo_schema_type_default', function( $type, $post_type, $post_id ) {
    if ( 'tool' === $post_type ) {
        return 'SoftwareApplication';
    }
    return $type;
}, 10, 3 );

Schema Objects — Article / Person / WebPage

Schema Objects — Organization