Locus Changelog

WooCommerce configuration in the admin panel
Two new sections have been added to GEO Engine Settings > WooCommerce, making the WooCommerce schema features fully configurable without any custom code.

Product Attribute Schema Properties Add the WooCommerce attribute slugs you want to appear as structured data properties on your product pages. For example, adding material will cause Locus to output the product's Material attribute as an additionalProperty node in the schema, making it readable by search engines and AI models. Enter each attribute on a separate row using the slug shown in WooCommerce > Attributes.

Category FAQs Add FAQ questions and answers for each product category. Enter the category slug and then add as many question/answer pairs as needed. Locus will output a FAQPage schema block on that category's archive page, eligible for FAQ rich results in Google Search.

Both sections were previously only configurable by a developer. They are now managed entirely within the WordPress admin panel.

Internal housekeeping release. No change to schema output for correctly configured sites.

The WooCommerce class has been fully generalised - it no longer contains any site-specific defaults for product attribute names, category FAQ content, or shipping scope. All of these are now configured per site via WordPress filters. This makes Locus suitable for deployment on any WooCommerce site without modification.

Patch release. Changes in two files only: includes/class-locus-acf.php and includes/class-locus-woocommerce.php.

Changes
New ACF tab: WooCommerce (includes/class-locus-acf.php)

A new WooCommerce tab has been added to GEO Engine Settings (between the Person Entity tab and the API Settings tab) with two fields:

• geo_merchant_return_days (number) — Return window in days. Default 14, reflecting the EU/UK distance selling legal minimum and a safe baseline for most sites. Set to your actual policy value on sites with a different window.
• geo_merchant_return_link (url) — Full URL of the returns and refund policy page. Falls back to {home_url}/returns/ if not set.

build_return_policy() updated (includes/class-locus-woocommerce.php)

• merchantReturnDays now reads from geo_merchant_return_days ACF options field. Default is 14 (EU/UK distance selling minimum), not the 30 placeholder from earlier versions.
• merchantReturnLink now reads from geo_merchant_return_link ACF options field. Falls back to {home_url}/returns/ if not set. The previous hardcoded path has been removed.
• refundType added with value https://schema.org/StoreCreditRefund — reflects that most returns policies offer credit or exchange rather than unconditional full cash refunds. Overridable via the locus/woocommerce/return_policy filter.

Minor update to the WooCommerce schema integration introduced in v1.8.0.

• Product category FAQ questions now correctly appear on the Belay/Lower-Off and Guides & Books category pages.
• Schema output for shipping and return policy has been cleaned up to pass structured data validation without warnings.
• Return policy country is now derived automatically from WooCommerce settings, ensuring the plugin works correctly on any site.

WooCommerce Schema Support
Locus now generates structured schema for WooCommerce product and product category pages, extending its GEO and entity schema capabilities to e-commerce sites.

Product pages
On individual product pages, Locus outputs a complete Product schema node including:

Product name, description, SKU, brand, and category
Product images (main image and gallery images where present)
Offer data including price, currency, stock availability, condition, and seller reference
Variable products - each variation gets its own Offer entry with its specific price, SKU, and stock status
Worldwide shipping declaration
Merchant return policy reference
Product attributes (material, anchor type, breaking strain, certification standards) output as additionalProperty nodes

Product category pages
On product category archive pages, Locus outputs:

A CollectionPage node describing the category, drawing on ACF category description fields where set
An ItemList of products in the category - name, URL, and thumbnail for each product, up to 50 items
A FAQPage with climbing-hardware-specific questions and answers, matched to the category

How it works
The WooCommerce class loads automatically when WooCommerce is active on the site. No configuration is required beyond having Locus activated with a valid licence.

The schema respects all existing Locus output - Organisation, Person, and WebSite entity schema already generated by Locus are not duplicated. All WooCommerce schema fires after the existing Locus entity output.

Currency is always read from the WooCommerce base currency setting - no manual configuration needed.

• WordPress 7.0 compatibility: replaced hardcoded admin colour with --wp-admin-theme-color CSS variable in sort header hover state.

• Custom Locus crosshair icon displayed in WordPress admin menu, replacing the generic location dashicon

• Primary Schema Type field upgraded to Select2 searchable dropdown
• Schema types grouped with section headers and subtypes indented for clear visual hierarchy
• Separator rows are non-interactive and cannot be saved as field values

• Primary Schema Type expanded from 19 to 137 valid schema.org types
• Full LocalBusiness hierarchy added across 17 groups (Automotive, Food & Drink, Retail, Health & Medical, Home & Construction, etc.)
• Non-LocalBusiness Organization branches added: Education, NGO, Government, SportsOrganization, PerformingGroup, Corporation, ResearchOrganization, NewsMediaOrganization, WorkersUnion, Consortium
• geo, openingHoursSpecification, and priceRange suppressed for non-LocalBusiness types
• priceRange now outputs correctly for all LocalBusiness subtypes, not just the literal LocalBusiness type
• Schema Map label lookup and unknown-type warning updated to cover all 137 types
• Migration: Charity remapped to NGO on upgrade

• areaServed, provider, audience, isRelatedTo, and offers only output on service pages when the schema type supports them
• SoftwareApplication on existing pages remapped to Service at render time to prevent invalid property output

• Activation migration remaps WebDesignCompany and MarketingAgency database values to ProfessionalService
• Schema Map displays human-readable type labels instead of raw schema.org keys
• Schema Map shows inline warning if an unrecognised business type is detected

• WebDesignCompany and MarketingAgency removed from Primary Schema Type select (not valid schema.org types)
• SoftwareApplication removed from service schema type select
• geo and openingHoursSpecification suppressed when business type is not a LocalBusiness/Place subtype
• isRelatedTo and hasOfferFrom suppressed when service schema type is SoftwareApplication
• Related entity types from AI enrichment validated against allowlist; invalid types mapped to Thing
• AI enrichment prompt updated to remove Concept from entity type options

• Sitewide entity schema (class-locus-entity.php): Organisation, Person, and WebSite JSON-LD blocks injected into wp_head
• Organisation block includes @type, name, legalName, description, logo, address, geo, telephone, email, contactPoint, foundingDate, priceRange, vatID, leiCode, openingHoursSpecification, aggregateRating, knowsAbout, hasOfferCatalog, areaServed, sameAs, subjectOf, founder
• Person block with jobTitle, description, image, alumniOf, knowsAbout, hasCredential, sameAs
• WebSite block with SearchAction on front page only
• Lean areaServed (counties/regions/country) on all pages; full city list injected on homepage only
• llms.txt and llms-full.txt generation (class-locus-llms.php) with transient caching
  Profile Wizard (class-locus-profile-wizard.php) - Method A (scrape) and Method B (paste) for populating ACF fields via Claude
• UK places reference data (locus-uk-places.php) for geographic page detection
• Full ACF options page expansion: Business Entity, Services, Social & Identity, LLMS.txt, Person Entity, and Generation Settings tabs
• Filters: locus/entity/organisation, locus/entity/person, locus/entity/website, locus/entity/homepage_areas