SEO Configuration

The SEO group controls how Magento handles page titles, meta descriptions, and Open Graph tags for blog pages.

Admin path: Stores > Configuration > Orange Collar > WordPress Integration > SEO

Settings

Use WordPress SEO Meta

When enabled, Magento pulls SEO metadata from the WordPress oc-bridge /seo/{post_id} endpoint and applies it to the page. This endpoint returns data from Yoast SEO or RankMath if either plugin is active, otherwise it falls back to WordPress core metadata.

Priority order: Yoast SEO -> RankMath -> WordPress core title and excerpt

The following metadata is applied:

<title> - meta title
<meta name="description"> - meta description
<meta name="robots"> - robots directives
Open Graph tags (og:title, og:description, og:image, og:type)
Twitter Card tags (twitter:card, twitter:title, twitter:description, twitter:image)
JSON-LD Article schema

Blog Page Meta Title

The <title> value used on the blog listing page (not individual posts - those use WordPress titles when SEO meta is enabled).

Default: Blog

Blog Page Meta Description

The <meta name="description"> value for the blog listing page.

URL Structure

Controls how post URLs are formatted. Options:

Option	Example URL
Post Name (default)	`/blog/my-post-slug`
Date and Name	`/blog/2024/01/15/my-post-slug`

The Router in Magento strips date-based URL prefixes from WordPress links when rewriting internal links, so content links work regardless of this setting.

SEO Plugin Implementation

The SeoPlugin class intercepts Magento’s page rendering and injects metadata before the <head> is output. It only fires on blog pages (checked via the current layout handle). If the WordPress API call for SEO data fails (e.g., WordPress is temporarily unreachable), Magento falls back to its own page title and meta tags gracefully.

Breadcrumbs

The BreadcrumbPlugin adds blog breadcrumbs automatically:

Blog listing: Home > Blog
Post view: Home > Blog > Category > Post Title
Category view: Home > Blog > Category Name
Tag view: Home > Blog > Tag Name
Author view: Home > Blog > Author Name