claude-plugin-wordpress-manager 2.2.1 → 2.3.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "wordpress-manager",
-  "version": "2.2.1",
-  "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (85 tools incl. WooCommerce + Multisite + Webhooks), and WordPress.com MCP (hosted sites) with 11 specialized agents, 30 skills, and security hooks. Includes fleet monitoring, content repurposing, webhook propagation, site monitoring (uptime, performance baseline, security scanning, content integrity, alerting), CI/CD pipeline automation (GitHub Actions, GitLab CI, Bitbucket), WordPress Multisite network management, WooCommerce store management, local dev environment support, development, testing, security, i18n, accessibility, headless, and operations.",
+  "version": "2.3.1",
+  "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (85 tools incl. WooCommerce + Multisite + Webhooks), and WordPress.com MCP (hosted sites) with 11 specialized agents, 33 skills, and security hooks. Includes programmatic SEO, content-commerce attribution, multi-language network, fleet monitoring, content repurposing, webhook propagation, site monitoring (uptime, performance baseline, security scanning, content integrity, alerting), CI/CD pipeline automation (GitHub Actions, GitLab CI, Bitbucket), WordPress Multisite network management, WooCommerce store management, local dev environment support, development, testing, security, i18n, accessibility, headless, and operations.",
   "author": {
     "name": "vinmor",
     "email": "morreale.v@gmail.com"

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to the WordPress Manager plugin for Claude Code.
 
+## [2.3.1] - 2026-02-28
+
+### Changed
+- **GUIDE.md**: aggiornamento completo da v2.2.0 a v2.3.0 — documenta programmatic SEO, content-commerce attribution, multi-language network (22 scenari, 33 skill, 85 tool, router v10, +16 termini glossario)
+
+## [2.3.0] - 2026-02-28
+
+### Added
+- **Programmatic SEO skill** (`wp-programmatic-seo`) — template-based scalable page generation via headless WordPress + multisite
+  - 5 reference files: `template-architecture.md`, `location-seo.md`, `product-seo.md`, `data-sources.md`, `technical-seo.md`
+  - Detection script: `programmatic_seo_inspect.mjs` (headless frontend, SEO plugins, CPTs, WPGraphQL)
+  - Agent updated: Programmatic SEO Workflow + example in `wp-content-strategist`
+- **Content-Commerce Attribution skill** (`wp-content-attribution`) — link WooCommerce sales data to content that drives conversions
+  - 5 reference files: `utm-tracking-setup.md`, `conversion-funnels.md`, `attribution-models.md`, `roi-calculation.md`, `reporting-dashboards.md`
+  - Detection script: `attribution_inspect.mjs` (WooCommerce, analytics plugins, UTM tracking, order meta)
+  - Agent updated: Content Attribution Workflow + example in `wp-ecommerce-manager`
+- **Multi-Language Network skill** (`wp-multilang-network`) — multisite multi-language orchestration with hreflang and content sync
+  - 5 reference files: `network-architecture.md`, `hreflang-config.md`, `content-sync.md`, `language-routing.md`, `seo-international.md`
+  - Detection script: `multilang_inspect.mjs` (multisite status, multilingual plugins, language patterns, hreflang)
+  - Agent updated: Multi-Language Network Management + example in `wp-site-manager`
+
+### Changed
+- Router decision-tree.md upgraded to v10 with programmatic SEO, content attribution, and multi-language network keywords and routing
+- Cross-references added: `wp-headless` → wp-programmatic-seo, `wp-woocommerce` → wp-content-attribution, `wp-content` → wp-content-attribution, `wp-multisite` → wp-multilang-network, `wp-i18n` → wp-multilang-network
+- Plugin now has 33 skills, 11 agents, and 85 MCP tools
+
 ## [2.2.1] - 2026-02-28
 
 ### Changed

package/agents/wp-content-strategist.md

@@ -31,6 +31,13 @@ description: |
   assistant: "I'll use the wp-content-strategist agent to extract key insights from your posts and generate platform-specific social content."
   <commentary>Content repurposing requires selecting source content and applying platform templates.</commentary>
   </example>
+
+  <example>
+  Context: User wants to generate hundreds of location-based landing pages.
+  user: "Generate 200 city pages for our plumbing service"
+  assistant: "I'll use the wp-content-strategist agent to design the template, set up the data source, and bulk-generate the city pages."
+  <commentary>Programmatic SEO at scale requires structured data, URL design, and bulk content creation via REST API.</commentary>
+  </example>
 model: inherit
 tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
 ---
@@ -176,6 +183,23 @@ When repurposing existing WordPress content into multi-channel formats:
 
 See the `wp-content-repurposing` skill for detailed templates and platform specifications.
 
+## Programmatic SEO Workflow
+
+When generating large-scale pages from structured data (city pages, product variants, comparison pages):
+
+1. **Assess data source**: Use `discover_content_types` to find what structured data exists (products, locations, categories). Run `programmatic_seo_inspect.mjs` for readiness assessment.
+2. **Design URL pattern**: Define the template — `/{service}/{city}` or `/{product}/{variant}`. Keep to max 3 levels, include primary keyword in first path segment.
+3. **Create CPT or taxonomy**: If no suitable CPT exists, create one in WordPress with `show_in_rest: true` for headless access. Define custom fields for template variables.
+4. **Build page template**: Map CPT fields to page elements — title, meta description, H1, body sections, schema markup. Ensure 300+ words of unique content per page.
+5. **Generate content in bulk**: Loop via `create_content` MCP tool:
+   - Create as `status: "draft"` first for review
+   - Process in batches of 10, report progress
+   - Assign taxonomies via `assign_terms_to_content`
+6. **Configure headless frontend**: Reference `wp-programmatic-seo` skill for ISR/SSG setup (Next.js `revalidate`, Nuxt `routeRules`, Astro hybrid mode).
+7. **Submit sitemap**: Verify XML sitemap includes all programmatic pages, submit to Google Search Console.
+
+See the `wp-programmatic-seo` skill for reference files on template architecture, location SEO, product SEO, data sources, and technical SEO.
+
 ## Multilingual Content
 
 When creating content for multilingual sites:
@@ -194,3 +218,4 @@ When creating content for multilingual sites:
 - **`wp-content` skill** — content lifecycle management, editorial workflows
 - **`wp-i18n` skill** — internationalization and localization procedures
 - **`wp-content-repurposing` skill** — content transformation for multi-channel distribution
+- **`wp-programmatic-seo` skill** — scalable page generation from structured data (city pages, product variants, comparison pages)

package/agents/wp-ecommerce-manager.md

@@ -26,6 +26,13 @@ description: |
   <commentary>Sales analytics combining multiple report endpoints requires the WooCommerce agent.</commentary>
   </example>
 
+  <example>
+  Context: User wants to know which blog posts are driving sales.
+  user: "Which blog posts are driving the most sales?"
+  assistant: "I'll use the wp-ecommerce-manager agent to analyze order attribution data and identify top converting content."
+  <commentary>Content-commerce attribution requires correlating WooCommerce order UTM meta with content data.</commentary>
+  </example>
+
 model: inherit
 tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
 ---
@@ -93,6 +100,21 @@ For cross-referencing with WordPress content:
 3. Shipping: `wc_list_shipping_zones` (verify zone coverage)
 4. Tax: `wc_get_tax_classes` (verify tax configuration)
 
+### Content Attribution Workflow
+
+When analyzing which content drives WooCommerce sales:
+
+1. **Verify setup**: Run `attribution_inspect.mjs` to check WooCommerce + content + UTM tracking readiness
+2. **Check UTM tracking**: Is the UTM capture mu-plugin installed? If not, guide setup from `wp-content-attribution` skill → `references/utm-tracking-setup.md`
+3. **Pull sales data**: `wc_get_sales_report` for the reporting period (default: last 30 days)
+4. **Pull order details**: `wc_list_orders` with `status=completed` — check `_last_utm_campaign` and `_first_utm_campaign` meta on each order
+5. **Pull content data**: `list_content` for the same period to map campaign slugs back to post titles
+6. **Correlate**: Match order UTM campaign values with content piece slugs; aggregate revenue per content piece
+7. **Apply attribution model**: Default to last-touch (`_last_utm_campaign`); reference `wp-content-attribution` skill for other models
+8. **Generate attribution report**: Top converting content pieces, revenue by content category, CAC by source, recommendations
+
+See the `wp-content-attribution` skill for reference files on UTM setup, attribution models, ROI calculation, and reporting dashboards.
+
 ## Report Format
 
 ```
@@ -134,3 +156,4 @@ For cross-referencing with WordPress content:
 - `wp-deploy` — Deploy store changes to production
 - `wp-backup` — Backup store database before bulk operations
 - `wp-audit` — Security and performance audit for WC stores
+- `wp-content-attribution` — Content-commerce attribution, UTM tracking, ROI calculation

package/agents/wp-site-manager.md

@@ -24,6 +24,13 @@ description: |
   assistant: "I'll use the wp-site-manager agent to handle multi-site operations."
   <commentary>Multi-site coordination is a core capability of this agent.</commentary>
   </example>
+
+  <example>
+  Context: User wants to set up a multilingual multisite network.
+  user: "Set up Italian and Spanish versions of our site"
+  assistant: "I'll use the wp-site-manager agent to create language-specific sub-sites and configure the multi-language network."
+  <commentary>Multi-language network setup requires creating sub-sites, configuring hreflang, and establishing content sync — all multisite operations.</commentary>
+  </example>
 model: inherit
 tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
 ---
@@ -127,6 +134,20 @@ For WordPress Multisite networks (sites with `is_multisite: true` in WP_SITES_CO
 - ALWAYS confirm before network-activating plugins (affects ALL sites)
 - Announce which network you're operating on when multiple multisite networks are configured
 
+### Multi-Language Network Management
+
+When setting up or managing a multi-language WordPress Multisite network:
+
+1. **Assess current network**: Use `ms_list_sites` to list existing sub-sites. Run `multilang_inspect.mjs` for readiness assessment (multisite status, multilingual plugin, language patterns, hreflang).
+2. **Create language sub-sites**: Use `ms_create_site` for each target language. Use ISO 639-1 codes as slugs (e.g., `/it/`, `/de/`, `/fr/`). Title format: `{Brand} - {Language Name}`.
+3. **Configure multilingual plugin**: Network-activate the chosen plugin (WPML, Polylang, or MultilingualPress) via `ms_network_activate_plugin`. Assign language to each sub-site in plugin settings.
+4. **Set up hreflang**: If using MultilingualPress or WPML, hreflang is auto-generated. Otherwise, install the hreflang mu-plugin from `wp-multilang-network` skill → `references/hreflang-config.md`.
+5. **Establish content sync workflow**: Define whether content is manually replicated, semi-auto (plugin-assisted), or fully synced. See `wp-multilang-network` skill → `references/content-sync.md`.
+6. **Configure language routing**: Set up language switcher widget and optional browser detection redirect. See `references/language-routing.md`.
+7. **Verify international SEO**: Check hreflang reciprocal links, per-language sitemaps, GSC properties per language. See `references/seo-international.md`.
+
+See the `wp-multilang-network` skill for detailed reference files on network architecture, hreflang, content sync, language routing, and international SEO.
+
 ### Safety Rules
 - NEVER delete content without explicit user confirmation
 - NEVER deactivate plugins without listing dependencies first
@@ -150,3 +171,8 @@ For domain-specific tasks, delegate to specialized agents:
 | Multisite network management | `wp-site-manager` (this agent) | Sub-sites, network plugins, Super Admin — see section above |
 | CI/CD pipeline setup and troubleshooting | `wp-cicd-engineer` | GitHub Actions, GitLab CI, Bitbucket, quality gates |
 | Site monitoring and health reports | `wp-monitoring-agent` | Uptime, performance trends, security scanning, content integrity |
+
+## Related Skills
+
+- **`wp-multisite` skill** — multisite network management with 10 MCP tools
+- **`wp-multilang-network` skill** — multi-language network orchestration (hreflang, content sync, international SEO)

package/docs/GUIDE.md

@@ -1,6 +1,6 @@
 # WordPress Manager - Guida Completa per Utenti e Amministratori
 
-**Versione:** 2.2.0
+**Versione:** 2.3.0
 **Ultimo aggiornamento:** 2026-02-28
 **Repository:** https://github.com/morrealev/wordpress-manager
 
@@ -60,6 +60,9 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
 - **Fleet monitoring**: monitorare tutti i siti configurati con report comparativi cross-site
 - **Riproporre contenuti**: trasformare post WordPress in social media, email, newsletter multi-canale
 - **Gestire webhook**: configurare notifiche outbound WordPress verso servizi esterni (Zapier, Slack, CDN)
+- **SEO programmatico**: generare centinaia di pagine template da dati strutturati (city pages, product variants, directory)
+- **Attribuzione contenuti-vendite**: misurare quale contenuto WordPress genera conversioni WooCommerce (UTM tracking, attribution models, ROI)
+- **Rete multilingua**: orchestrare WordPress Multisite come network multilingua con hreflang, content sync e SEO internazionale
 
 ### Requisiti
 
@@ -96,7 +99,7 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
 ### Componenti del Plugin
 
 ```
-wordpress-manager/                          # v2.2.0
+wordpress-manager/                          # v2.3.0
 +-- .claude-plugin/plugin.json              # Manifest
 +-- .mcp.json                               # Server MCP bundled
 +-- LICENSE                                 # MIT + GPL-2.0-or-later
@@ -115,7 +118,7 @@ wordpress-manager/                          # v2.2.0
 |   +-- wp-monitoring-agent.md                  # Site monitoring read-only (v2.1.0)
 +-- commands/                               # 5 slash commands
 |   +-- wp-status.md / wp-deploy.md / wp-audit.md / wp-backup.md / wp-setup.md
-+-- skills/                                 # 30 skill totali
++-- skills/                                 # 33 skill totali
 |   +-- [OPERATIVE - 5 skill]
 |   +-- wp-deploy/                              # Procedure deploy
 |   +-- wp-audit/                               # Checklist audit
@@ -125,7 +128,7 @@ wordpress-manager/                          # v2.2.0
 |   +-- [AMBIENTE LOCALE - 1 skill]
 |   +-- wp-local-env/                           # Studio/LocalWP/wp-env
 |   +-- [SVILUPPO - 13 skill da WordPress/agent-skills]
-|   +-- wordpress-router/                       # Router unificato v9 (dev + local + ops + multisite + cicd + monitoring + webhooks + repurposing)
+|   +-- wordpress-router/                       # Router unificato v10 (dev + local + ops + multisite + cicd + monitoring + webhooks + repurposing + pseo + attribution + multilang)
 |   +-- wp-project-triage/                      # Auto-detect tipo progetto
 |   +-- wp-block-development/                   # Blocchi Gutenberg
 |   +-- wp-block-themes/                        # Temi a blocchi
@@ -151,6 +154,10 @@ wordpress-manager/                          # v2.2.0
 |   +-- wp-monitoring/                          # Site monitoring, fleet monitoring e observability (v2.1.0-v2.2.0)
 |   +-- wp-content-repurposing/                 # Content repurposing multi-canale (v2.2.0)
 |   +-- wp-webhooks/                            # Webhook propagation e integrazioni (v2.2.0)
+|   +-- [STRATEGIA + SEO INTERNAZIONALE - 3 skill]
+|   +-- wp-programmatic-seo/                    # SEO programmatico scalabile (v2.3.0)
+|   +-- wp-content-attribution/                 # Attribuzione content-to-commerce (v2.3.0)
+|   +-- wp-multilang-network/                   # Rete multilingua su multisite (v2.3.0)
 +-- hooks/                                  # 7 hook di sicurezza
 |   +-- hooks.json                              # 5 prompt + 2 command
 |   +-- scripts/                                # Script per hook command-type
@@ -337,6 +344,9 @@ WordPress Manager comprende richieste in linguaggio naturale. Ecco come formular
 | Fleet monitoring | "Monitora tutti i siti" / "Fleet health" / "Cross-site comparison" |
 | Riproporre contenuti | "Riproponi il post per social" / "Newsletter dal blog" / "Atomizza contenuto" |
 | Gestire webhook | "Configura webhook" / "Notifica Zapier" / "WooCommerce webhook" |
+| SEO programmatico | "Genera city pages" / "Template pages" / "Pagine da dati" / "Programmatic SEO" |
+| Attribuzione contenuti | "Quale contenuto genera vendite?" / "UTM tracking" / "Content ROI" / "Revenue per post" |
+| Rete multilingua | "Sito multilingua" / "Hreflang" / "International SEO" / "Sub-site per lingua" |
 
 ---
 
@@ -572,7 +582,9 @@ IDEAZIONE -> BOZZA -> REVISIONE -> OTTIMIZZAZIONE -> PUBBLICAZIONE -> MONITORAGG
 
 **Content repurposing** (v2.2.0): Trasforma contenuti WordPress in output multi-canale — social media post (Twitter/LinkedIn/Instagram/Facebook), email newsletter, drip sequence. Usa la skill `wp-content-repurposing` per template e regole per piattaforma.
 
-**Skill correlata**: `wp-content`, `wp-i18n`, `wp-content-repurposing`
+**Programmatic SEO** (v2.3.0): Guida la generazione scalabile di pagine da dati strutturati — city pages, product variants, comparison pages, directory listings. Workflow: assess data source → design URL pattern → create CPT → build template → generate in bulk → configure ISR/SSG → submit sitemap. Usa la skill `wp-programmatic-seo`.
+
+**Skill correlata**: `wp-content`, `wp-i18n`, `wp-content-repurposing`, `wp-programmatic-seo`
 
 ---
 
@@ -745,7 +757,9 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
 
 **Prerequisiti**: WooCommerce attivo + Consumer Key/Secret configurati in `WP_SITES_CONFIG` (generare da WooCommerce > Settings > Advanced > REST API).
 
-**Skill correlata**: `wp-woocommerce`, `wp-webhooks`
+**Content Attribution** (v2.3.0): Misura quale contenuto WordPress genera conversioni WooCommerce. Workflow: verifica WooCommerce + contenuti → check UTM tracking (guida setup mu-plugin) → pull sales data → pull content data → correla con attribution model → genera report con top converting content. Usa la skill `wp-content-attribution`.
+
+**Skill correlata**: `wp-woocommerce`, `wp-webhooks`, `wp-content-attribution`
 
 ---
 
@@ -873,10 +887,11 @@ Le skill di sviluppo provengono da due fonti:
 - **13 skill community** integrate dal repository [WordPress/agent-skills](https://github.com/WordPress/agent-skills) (licenza GPL-2.0-or-later). Coprono blocchi, temi, plugin, endpoint REST, analisi statica, profiling e altro.
 - **5 skill estese** (MIT) aggiunte in v1.6.0: testing, security, internazionalizzazione, accessibilita, headless.
 - **6 skill e-commerce + infrastruttura** (MIT) aggiunte in v1.8.0-v2.2.0: WooCommerce, Multisite, CI/CD, Monitoring, Content Repurposing, Webhooks.
+- **3 skill strategia + SEO internazionale** (MIT) aggiunte in v2.3.0: Programmatic SEO, Content-Commerce Attribution, Multi-Language Network.
 
 ### Il Router Unificato
 
-La skill `wordpress-router` (v9) e il punto d'ingresso per tutti i task WordPress. Classifica automaticamente il task in **otto categorie**: sviluppo, ambiente locale, operativo, multisite, CI/CD, monitoring, content repurposing, webhook.
+La skill `wordpress-router` (v10) e il punto d'ingresso per tutti i task WordPress. Classifica automaticamente il task in **undici categorie**: sviluppo, ambiente locale, operativo, multisite, CI/CD, monitoring, content repurposing, webhook, programmatic SEO, content attribution, multi-language network.
 
 ```
 Utente: "Crea un blocco custom per la gallery"
@@ -952,6 +967,30 @@ wordpress-router: TASK = operativo (webhook)
 wp-webhooks skill + wp-site-manager agent
 ```
 
+```
+Utente: "Genera 200 city pages per il nostro servizio idraulico"
+  |
+wordpress-router: TASK = operativo (programmatic SEO)
+  |
+wp-programmatic-seo skill + wp-content-strategist agent
+```
+
+```
+Utente: "Quali post del blog generano piu vendite WooCommerce?"
+  |
+wordpress-router: TASK = operativo (content attribution)
+  |
+wp-content-attribution skill + wp-ecommerce-manager agent
+```
+
+```
+Utente: "Configura versioni italiano e spagnolo del nostro sito"
+  |
+wordpress-router: TASK = operativo (multi-language network)
+  |
+wp-multilang-network skill + wp-site-manager agent
+```
+
 ### Panoramica Skills di Sviluppo — Community (13)
 
 | Skill | Si attiva quando... | Risorse |
@@ -997,9 +1036,19 @@ Aggiunte in v1.8.0-v2.2.0, queste skill coprono e-commerce, multisite, CI/CD, mo
 | `wp-content-repurposing` | "riproponi contenuto", "social dal blog", "newsletter dai post", "atomizza" | 4 reference files, repurposing_inspect.mjs | `wp-content-strategist` |
 | `wp-webhooks` | "webhook", "notifica esterna", "Zapier", "WooCommerce webhook" | 5 reference files, webhook_inspect.mjs | `wp-site-manager` |
 
+### Panoramica Skills Strategia + SEO Internazionale (3)
+
+Aggiunte in v2.3.0, queste skill coprono SEO programmatico, attribuzione content-to-commerce e rete multilingua su Multisite.
+
+| Skill | Si attiva quando... | Risorse | Agent dedicato |
+|-------|---------------------|---------|----------------|
+| `wp-programmatic-seo` | "template pages", "city pages", "programmatic SEO", "bulk page generation" | 5 reference files, programmatic_seo_inspect.mjs | `wp-content-strategist` |
+| `wp-content-attribution` | "content ROI", "UTM tracking", "revenue per post", "quale contenuto genera vendite" | 5 reference files, attribution_inspect.mjs | `wp-ecommerce-manager` |
+| `wp-multilang-network` | "multilingua", "hreflang", "international SEO", "sub-site per lingua", "translate site" | 5 reference files, multilang_inspect.mjs | `wp-site-manager` |
+
 ### Script di Rilevamento Automatico
 
-Le skill includono 18 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
+Le skill includono 21 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
 
 | Script | Cosa rileva |
 |--------|-------------|
@@ -1021,6 +1070,9 @@ Le skill includono 18 script Node.js (`.mjs`) che eseguono analisi automatica de
 | `monitoring_inspect.mjs` | Uptime tools, Lighthouse CI, security plugins, logging config, fleet config (v2.1.0-v2.2.0) |
 | `repurposing_inspect.mjs` | Social plugins, email plugins, content volume, repurposing readiness (v2.2.0) |
 | `webhook_inspect.mjs` | WC webhooks, mu-plugin webhooks, webhook plugins, wp-config constants (v2.2.0) |
+| `programmatic_seo_inspect.mjs` | Headless frontend, SEO plugin, content counts, CPT, WPGraphQL, readiness (v2.3.0) |
+| `attribution_inspect.mjs` | WooCommerce, analytics plugin, UTM tracking, content/product volume, order meta (v2.3.0) |
+| `multilang_inspect.mjs` | Multisite, multilingual plugin, language patterns, hreflang tags, WPLANG (v2.3.0) |
 
 ### WordPress Playground — Ambienti Disposable
 
@@ -1055,7 +1107,7 @@ Senza il server MCP, la skill usa conoscenza generale di `@wordpress/components`
 ```
 1. cd mio-progetto-wordpress/
 2. Claude esegue wp-project-triage → rileva "wp-block-plugin"
-3. wordpress-router v9 → instrada a wp-block-development
+3. wordpress-router v10 → instrada a wp-block-development
 4. Claude guida la creazione con block.json, edit.js, save.js
 5. wp-e2e-testing + wp-test-engineer → esegue test E2E con Playwright
 6. wp-accessibility + wp-accessibility-auditor → verifica WCAG 2.2
@@ -1563,6 +1615,55 @@ Claude (attiva skill wp-multisite):
 -> Report: network configurato con 3 sub-site attivi
 ```
 
+### Scenario 20: SEO Programmatico — City Pages
+
+```
+Tu: "Genera 200 city pages per il nostro servizio idraulico con schema LocalBusiness"
+
+Claude (attiva wp-content-strategist + skill wp-programmatic-seo):
+1. Detection con programmatic_seo_inspect.mjs (headless frontend? SEO plugin? CPT?)
+2. Progetta URL pattern: /idraulico/{citta} (es. /idraulico/roma, /idraulico/milano)
+3. Crea CPT "location" in WordPress con campi: citta, regione, telefono, indirizzo
+4. Definisce template pagina: H1 dinamico, meta description, contenuto localizzato
+5. Genera 200 pagine in bulk via create_content MCP tool
+6. Configura ISR su frontend headless (Next.js revalidate: 86400)
+7. Genera sitemap XML e submette a Search Console
+-> Report: 200 city pages create, sitemap generato, ISR configurato
+```
+
+### Scenario 21: Attribuzione Content-Commerce
+
+```
+Tu: "Quali post del blog generano piu vendite nel mio store WooCommerce?"
+
+Claude (attiva wp-ecommerce-manager + skill wp-content-attribution):
+1. Detection con attribution_inspect.mjs (WooCommerce? UTM tracking? Analytics?)
+2. Se UTM tracking assente: guida installazione mu-plugin per cattura UTM → order meta
+3. Pull dati vendite: wc_get_sales_report per ultimo trimestre
+4. Pull dati contenuti: list_content per stesso periodo
+5. Correla ordini con source UTM → identifica top converting content
+6. Applica attribution model (last-touch default)
+7. Calcola ROI per post: revenue attribuita / costo produzione contenuto
+-> Report: top 10 post per revenue, CAC per tipo contenuto, raccomandazioni
+```
+
+### Scenario 22: Rete Multilingua su Multisite
+
+```
+Tu: "Configura versioni italiano e spagnolo del nostro sito WordPress"
+
+Claude (attiva wp-site-manager + skill wp-multilang-network):
+1. Detection con multilang_inspect.mjs (multisite? plugin multilingua?)
+2. Se non multisite: guida conversione single → multisite
+3. Crea sub-site "it" con ms_create_site (italiano, sito principale)
+4. Crea sub-site "es" con ms_create_site (spagnolo)
+5. Installa e configura plugin multilingua (Polylang/MultilingualPress)
+6. Configura hreflang automatico via mu-plugin (slug-based matching)
+7. Setup language switcher e routing per lingua
+8. Verifica con checklist SEO internazionale (GSC properties, sitemaps per lingua)
+-> Report: network multilingua configurato, hreflang attivo, SEO verificato
+```
+
 ---
 
 ## 14. Amministrazione Avanzata
@@ -1831,8 +1932,23 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
 | **Webhook** | Notifica HTTP outbound inviata automaticamente da WordPress quando si verifica un evento (es. ordine creato) |
 | **HMAC-SHA256** | Algoritmo di firma usato per autenticare webhook — il receiver verifica l'integrita del payload |
 | **mu-plugin** | Must-Use Plugin WordPress — plugin caricato automaticamente senza attivazione, usato per webhook core |
+| **Programmatic SEO** | Generazione sistematica di pagine search-optimized da dati strutturati (city pages, product variants, directory) |
+| **ISR (Incremental Static Regeneration)** | Rigenerazione incrementale di pagine statiche — aggiorna singole pagine senza rebuild completo |
+| **SSG (Static Site Generation)** | Generazione statica di tutte le pagine al build time — massima performance, dati non real-time |
+| **CPT (Custom Post Type)** | Tipo di contenuto personalizzato in WordPress, usato come data source per pagine programmatiche |
+| **Content Attribution** | Misurazione di quale contenuto WordPress genera conversioni e-commerce (vendite WooCommerce) |
+| **UTM Parameters** | Tag URL (utm_source, utm_medium, utm_campaign) per tracciare la provenienza del traffico |
+| **First-Touch Attribution** | Modello che attribuisce il 100% del credito al primo contenuto con cui l'utente ha interagito |
+| **Last-Touch Attribution** | Modello che attribuisce il 100% del credito all'ultimo contenuto prima dell'acquisto |
+| **CAC (Customer Acquisition Cost)** | Costo di acquisizione cliente — quanto costa in contenuto acquisire un nuovo cliente |
+| **LTV (Lifetime Value)** | Valore nel tempo di un cliente — revenue totale generata nel ciclo di vita |
+| **Multi-Language Network** | Architettura WordPress Multisite dove ogni sub-site serve una lingua diversa |
+| **hreflang** | Tag HTML che indica la lingua e la regione di una pagina, usato per SEO internazionale |
+| **x-default** | Valore hreflang speciale che indica la pagina fallback per utenti senza match di lingua |
+| **Content Sync** | Sincronizzazione di contenuti tra sub-site di lingua diversa in un network multilingua |
+| **MultilingualPress** | Plugin WordPress nativo per multisite multilingua — connessioni tra contenuti cross-site |
 
 ---
 
-*Guida v2.2.0 - WordPress Manager Plugin per Claude Code*
+*Guida v2.3.0 - WordPress Manager Plugin per Claude Code*
 *Ultimo aggiornamento: 2026-02-28*

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-plugin-wordpress-manager",
-  "version": "2.2.1",
-  "description": "Unified WordPress management and development plugin for Claude Code. Orchestrates Hostinger MCP, WP REST API bridge (85 tools incl. 30 WooCommerce + 10 Multisite + 4 Webhooks), and WordPress.com MCP with 30 skills, 11 agents, and security hooks. v2.2.0 adds fleet monitoring, content repurposing skill, and webhook propagation (WooCommerce webhook MCP tools + mu-plugin patterns).",
+  "version": "2.3.1",
+  "description": "Unified WordPress management and development plugin for Claude Code. Orchestrates Hostinger MCP, WP REST API bridge (85 tools incl. 30 WooCommerce + 10 Multisite + 4 Webhooks), and WordPress.com MCP with 33 skills, 11 agents, and security hooks. v2.3.0 adds programmatic SEO, content-commerce attribution, and multi-language network skills.",
   "author": {
     "name": "vinmor",
     "email": "morreale.v@gmail.com"
@@ -36,7 +36,12 @@
     "health-check",
     "webhook",
     "content-repurposing",
-    "fleet-monitoring"
+    "fleet-monitoring",
+    "programmatic-seo",
+    "attribution",
+    "multilingual",
+    "hreflang",
+    "international-seo"
   ],
   "repository": {
     "type": "git",

package/skills/wordpress-router/references/decision-tree.md

@@ -1,4 +1,4 @@
-# Router decision tree (v9 — development + local environment + operations + multisite + CI/CD + monitoring + webhooks + content repurposing)
+# Router decision tree (v10 — development + local environment + operations + multisite + CI/CD + monitoring + webhooks + content repurposing + programmatic SEO + content attribution + multi-language network)
 
 This routing guide covers WordPress **development**, **local environment**, and **operations** workflows.
 
@@ -14,7 +14,7 @@ Keywords that indicate **local environment**:
 local site, Studio, LocalWP, Local by Flywheel, wp-env, local WordPress, start site, stop site, create local site, local development, symlink plugin, local database, switch PHP version, localhost, local preview, detect environment, WASM, SQLite local
 
 Keywords that indicate **operations**:
-deploy, push to production, audit, security check, backup, restore, migrate, move site, create post, manage content, site status, check plugins, performance check, SEO audit, WooCommerce, prodotto, ordine, coupon, negozio, catalogo, inventario, vendite, carrello, multisite, network, sub-site, sub-sito, domain mapping, super admin, network activate, monitor, uptime, health report, trend, scansione periodica, alerting, performance baseline, fleet, all sites, network health, cross-site, webhook, outbound notification, event propagation, Zapier, content sync, repurpose content, social posts from blog, content atomization, newsletter from posts, content distribution
+deploy, push to production, audit, security check, backup, restore, migrate, move site, create post, manage content, site status, check plugins, performance check, SEO audit, WooCommerce, prodotto, ordine, coupon, negozio, catalogo, inventario, vendite, carrello, multisite, network, sub-site, sub-sito, domain mapping, super admin, network activate, monitor, uptime, health report, trend, scansione periodica, alerting, performance baseline, fleet, all sites, network health, cross-site, webhook, outbound notification, event propagation, Zapier, content sync, repurpose content, social posts from blog, content atomization, newsletter from posts, content distribution, programmatic SEO, template pages, city pages, location pages, bulk page generation, scalable landing pages, content ROI, attribution, which content drives sales, conversion tracking, UTM tracking, revenue per post, multilingual, multi-language, hreflang, international SEO, translate site, language sites, localize content
 
 Keywords that indicate **development**:
 create block, block.json, theme.json, register_rest_route, plugin development, hooks, PHPStan, build, test, scaffold, i18n, translation, accessibility, a11y, headless, decoupled, WPGraphQL, CI, CD, pipeline, GitHub Actions, GitLab CI, deploy automatico, workflow, quality gate
@@ -98,6 +98,12 @@ Priority: `gutenberg` > `wp-core` > `wp-site` > `wp-block-theme` > `wp-block-plu
   → `wp-webhooks` skill + `wp-site-manager` agent
 - **Repurpose content / social posts from blog / newsletter from content / atomize / content distribution / turn blog into social**
   → `wp-content-repurposing` skill + `wp-content-strategist` agent
+- **Programmatic SEO / template pages / city pages / bulk page generation / scalable landing pages / location-based SEO / product variant pages**
+  → `wp-programmatic-seo` skill + `wp-content-strategist` agent
+- **Content attribution / ROI / conversion tracking / UTM / revenue per post / which content drives sales**
+  → `wp-content-attribution` skill + `wp-ecommerce-manager` agent
+- **Multi-language / multilingual / hreflang / international SEO / language sites / translate network**
+  → `wp-multilang-network` skill + `wp-site-manager` agent
 
 ## Step 2c: route by local environment intent (keywords)
 

package/skills/wp-content/SKILL.md

@@ -104,3 +104,4 @@ Tool: assign_terms_to_content — assign terms to content
 
 ### Related Skills
 - **`wp-content-repurposing`** — transform existing content for social media, email, and multi-channel distribution
+- **`wp-content-attribution`** — measure which content drives WooCommerce sales (UTM tracking, attribution models, ROI)

package/skills/wp-content-attribution/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: wp-content-attribution
+description: |
+  This skill should be used when the user asks to "track content ROI",
+  "attribute sales to content", "measure content performance", "conversion tracking",
+  "UTM tracking setup", "which content drives sales", "content attribution",
+  "revenue per post", "customer acquisition source", "marketing attribution",
+  or mentions connecting WordPress content metrics with WooCommerce sales data.
+version: 1.0.0
+---
+
+## Overview
+
+Content-Commerce Attribution measures which WordPress content pieces drive WooCommerce conversions, enabling data-driven content strategy. By linking UTM-tracked traffic to order data, you can calculate ROI per content piece — answering "which blog posts actually generate revenue?"
+
+This skill orchestrates existing MCP tools — WooCommerce reports, content CRUD, order management — into attribution workflows. No new tools or custom plugins are required; UTM capture uses lightweight mu-plugin patterns.
+
+## When to Use
+
+- User has a WooCommerce store plus blog/content and wants to understand content ROI
+- "Which of my blog posts are driving the most sales?"
+- "How do I track which content leads to purchases?"
+- "Set up UTM tracking for my WooCommerce store"
+- "Calculate revenue per blog post"
+- "Build a content attribution dashboard"
+- "What's my customer acquisition cost by content type?"
+
+## Attribution vs Analytics
+
+| Aspect | Attribution | Analytics |
+|--------|------------|-----------|
+| Measures | Contribution to conversion | Traffic and engagement |
+| Answer | "This post generated $5,000 in revenue" | "This post got 10,000 visits" |
+| Data source | Order meta + UTM params | Page views + sessions |
+| Granularity | Revenue per content piece | Visitors per content piece |
+| Action | Invest more in high-ROI content | Invest in high-traffic topics |
+
+## Prerequisites / Detection
+
+```bash
+node skills/wp-content-attribution/scripts/attribution_inspect.mjs --cwd=/path/to/wordpress
+```
+
+The script checks WooCommerce presence, analytics plugins, UTM tracking setup, content/product volume ratio, and existing order meta with source fields.
+
+## Content Attribution Operations Decision Tree
+
+1. **What attribution task?**
+
+   - "UTM tracking" / "campaign tracking" / "source tracking"
+     → **UTM Setup** — Read: `references/utm-tracking-setup.md`
+
+   - "conversion funnel" / "customer journey" / "touchpoints"
+     → **Funnel Analysis** — Read: `references/conversion-funnels.md`
+
+   - "attribution model" / "first touch" / "last touch" / "multi-touch"
+     → **Attribution Models** — Read: `references/attribution-models.md`
+
+   - "content ROI" / "revenue per post" / "cost per acquisition"
+     → **ROI Calculation** — Read: `references/roi-calculation.md`
+
+   - "dashboard" / "report" / "analytics setup"
+     → **Reporting** — Read: `references/reporting-dashboards.md`
+
+2. **Common workflow (first-time setup):**
+   1. Verify WooCommerce + content setup (run `attribution_inspect.mjs`)
+   2. Install UTM capture mu-plugin (see `utm-tracking-setup.md`)
+   3. Tag internal links from content → product pages with UTM parameters
+   4. Wait for data accumulation (minimum 2–4 weeks)
+   5. Pull sales data: `wc_get_sales_report` for period
+   6. Pull content data: `list_content` for same period
+   7. Correlate: match order UTM sources with content pieces
+   8. Apply attribution model (default: last-touch)
+   9. Generate attribution report with top converting content
+
+## Recommended Agent
+
+`wp-ecommerce-manager` — handles WooCommerce data, sales reports, and order analysis with attribution context.
+
+## Additional Resources
+
+### Reference Files
+
+| File | Description |
+|------|-------------|
+| **`references/utm-tracking-setup.md`** | UTM parameter design, mu-plugin for capture, naming conventions |
+| **`references/conversion-funnels.md`** | Funnel stages, drop-off analysis, cart abandonment metrics |
+| **`references/attribution-models.md`** | First-touch, last-touch, linear, time-decay, position-based models |
+| **`references/roi-calculation.md`** | Revenue per post, content ROI formula, CAC, LTV by source |
+| **`references/reporting-dashboards.md`** | GA4 integration, MonsterInsights setup, dashboard KPIs |
+
+### Related Skills
+
+- `wp-woocommerce` — WooCommerce store management and reporting tools
+- `wp-content` — content management and editorial workflows
+- `wp-monitoring` — ongoing site performance and health tracking
+- `wp-content-repurposing` — transform high-ROI content into multi-channel formats