acseo / sylius-geo-plugin

v0.1.0 2026-10-07 14:17 UTC

Requires

• php: ^8.2
• sylius/sylius: ^2.0

Requires (Dev)

• behat/behat: ^3.16
• dbrekelmans/bdi: ^1.4
• dmore/behat-chrome-extension: ^1.4
• dmore/chrome-mink-driver: ^2.9
• ekino/phpstan-banned-code: ^3.2
• friends-of-behat/mink: ^1.11
• friends-of-behat/mink-browserkit-driver: ^1.6
• friends-of-behat/mink-debug-extension: ^2.1
• friends-of-behat/mink-extension: ^2.7
• friends-of-behat/page-object-extension: ^0.3
• friends-of-behat/suite-settings-extension: ^1.1
• friends-of-behat/symfony-extension: ^2.6
• friends-of-behat/variadic-extension: ^1.6
• nyholm/psr7: ^1.8
• phpstan/phpstan: ^2.2
• phpstan/phpstan-doctrine: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• phpstan/phpstan-symfony: ^2.0
• phpstan/phpstan-webmozart-assert: ^2.0
• phpunit/phpunit: ^10.5
• sylius-labs/coding-standard: ^4.4
• sylius-labs/suite-tags-extension: ~0.2
• sylius/test-application: ^2.0.0@alpha
• symfony/browser-kit: ^6.4 || ^7.4
• symfony/debug-bundle: ^6.4 || ^7.4
• symfony/dotenv: ^6.4 || ^7.4
• symfony/http-client: ^6.4 || ^7.4
• symfony/intl: ^6.4 || ^7.4
• symfony/runtime: ^6.4 || ^7.4
• symfony/web-profiler-bundle: ^6.4 || ^7.4
• symfony/webpack-encore-bundle: ^2.2

MIT

• geo
• markdown
• sylius
• sylius-plugin
• ai-crawlers
• llm-txt

Published on Packagist.org on 2026-10-09 15:46 UTC

README

Generative Engine Optimization for Sylius. The plugin exposes a shop-aware llms.txt index and Markdown representations of catalog pages so AI crawlers can read accurate, public commerce data without guessing from HTML.

Package	acseo/sylius-geo-plugin
Requirements	PHP 8.3–8.4, Sylius 2.0–2.3; see compatibility for Symfony combinations
Base	Sylius PluginSkeleton

Preview

llms.txt index of a channel locale, with the channel information, the crawler policy and links to the Markdown pages:

Markdown page of a product, with price, availability, attributes, variants, images, taxons and JSON-LD:

The canonical product URL answers HTML to browsers and Markdown to clients that prefer text/markdown (headers trimmed to the relevant ones):

Markdown page of a taxon, served by negotiation on its canonical URL:

GEO sitemap with the product Markdown URLs and the taxon URLs:

acseo:geo:audit explains what a channel locale exports:

Features

• llms.txt per channel locale with products, taxons, channel information, and crawler policy.
• GEO sitemap endpoints for search and AI crawlers.
• Markdown product pages with description, brand, price, stock, attributes, variants, images, taxons, canonical URL, and optional JSON-LD.
• Markdown taxon pages with description, subcategories, and canonical URL.
• HTTP content negotiation on canonical product and taxon URLs.
• Public Shop API GEO endpoints.
• HTTP cache headers on public GEO responses: Cache-Control and ETag.
• Fine-grained configuration for catalog limits, route opt-outs, product exclusions, stock strategy, and price strategy.
• Symfony events before llms.txt, product Markdown, taxon Markdown, and HTTP response creation.
• Extension points for custom product, taxon, llms.txt, and CMS sections.
• Diagnostic and audit commands to explain product, taxon, channel, and locale export state.
• GitHub Actions CI with Composer validation, PHPUnit, Behat and ECS across a Sylius/Symfony compatibility matrix, and PHPStan (level max) on Symfony 7.4.

Quick start

See the installation guide for Composer setup, configuration import, and route registration.

Documentation

• Compatibility policy
• Installation
• Endpoints and content negotiation
• Documentation examples
• Configuration
• Commands
• Diagnostics
• Extension points
• Local development

About ACSEO

Developed and maintained by ACSEO, a French web and mobile development agency founded in 2009, with teams in Aix-en-Provence and Montpellier. ACSEO builds Symfony business applications and e-commerce platforms for startups and large companies, with services spanning UI/UX design, development, and DevOps infrastructure.

ACSEO has been a Sylius partner since 2022 and is listed as a Premium Solution Partner in the official Sylius partner directory. This plugin brings ACSEO’s development and SEO/GEO expertise to Sylius catalogs.

For project support or custom development, contact ACSEO.