claude-plugin-wordpress-manager 2.2.0 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/CHANGELOG.md +26 -0
  3. package/agents/wp-content-strategist.md +25 -0
  4. package/agents/wp-ecommerce-manager.md +23 -0
  5. package/agents/wp-site-manager.md +26 -0
  6. package/docs/GUIDE.md +116 -28
  7. package/package.json +8 -3
  8. package/skills/wordpress-router/references/decision-tree.md +8 -2
  9. package/skills/wp-content/SKILL.md +1 -0
  10. package/skills/wp-content-attribution/SKILL.md +97 -0
  11. package/skills/wp-content-attribution/references/attribution-models.md +189 -0
  12. package/skills/wp-content-attribution/references/conversion-funnels.md +137 -0
  13. package/skills/wp-content-attribution/references/reporting-dashboards.md +199 -0
  14. package/skills/wp-content-attribution/references/roi-calculation.md +202 -0
  15. package/skills/wp-content-attribution/references/utm-tracking-setup.md +161 -0
  16. package/skills/wp-content-attribution/scripts/attribution_inspect.mjs +277 -0
  17. package/skills/wp-headless/SKILL.md +1 -0
  18. package/skills/wp-i18n/SKILL.md +1 -0
  19. package/skills/wp-multilang-network/SKILL.md +107 -0
  20. package/skills/wp-multilang-network/references/content-sync.md +182 -0
  21. package/skills/wp-multilang-network/references/hreflang-config.md +198 -0
  22. package/skills/wp-multilang-network/references/language-routing.md +234 -0
  23. package/skills/wp-multilang-network/references/network-architecture.md +119 -0
  24. package/skills/wp-multilang-network/references/seo-international.md +213 -0
  25. package/skills/wp-multilang-network/scripts/multilang_inspect.mjs +308 -0
  26. package/skills/wp-multisite/SKILL.md +1 -0
  27. package/skills/wp-programmatic-seo/SKILL.md +97 -0
  28. package/skills/wp-programmatic-seo/references/data-sources.md +200 -0
  29. package/skills/wp-programmatic-seo/references/location-seo.md +134 -0
  30. package/skills/wp-programmatic-seo/references/product-seo.md +147 -0
  31. package/skills/wp-programmatic-seo/references/technical-seo.md +197 -0
  32. package/skills/wp-programmatic-seo/references/template-architecture.md +125 -0
  33. package/skills/wp-programmatic-seo/scripts/programmatic_seo_inspect.mjs +264 -0
  34. package/skills/wp-woocommerce/SKILL.md +1 -0
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "wordpress-manager",
3
- "version": "2.2.0",
4
- "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.",
3
+ "version": "2.3.0",
4
+ "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.",
5
5
  "author": {
6
6
  "name": "vinmor",
7
7
  "email": "morreale.v@gmail.com"
package/CHANGELOG.md CHANGED
@@ -2,6 +2,32 @@
2
2
 
3
3
  All notable changes to the WordPress Manager plugin for Claude Code.
4
4
 
5
+ ## [2.3.0] - 2026-02-28
6
+
7
+ ### Added
8
+ - **Programmatic SEO skill** (`wp-programmatic-seo`) — template-based scalable page generation via headless WordPress + multisite
9
+ - 5 reference files: `template-architecture.md`, `location-seo.md`, `product-seo.md`, `data-sources.md`, `technical-seo.md`
10
+ - Detection script: `programmatic_seo_inspect.mjs` (headless frontend, SEO plugins, CPTs, WPGraphQL)
11
+ - Agent updated: Programmatic SEO Workflow + example in `wp-content-strategist`
12
+ - **Content-Commerce Attribution skill** (`wp-content-attribution`) — link WooCommerce sales data to content that drives conversions
13
+ - 5 reference files: `utm-tracking-setup.md`, `conversion-funnels.md`, `attribution-models.md`, `roi-calculation.md`, `reporting-dashboards.md`
14
+ - Detection script: `attribution_inspect.mjs` (WooCommerce, analytics plugins, UTM tracking, order meta)
15
+ - Agent updated: Content Attribution Workflow + example in `wp-ecommerce-manager`
16
+ - **Multi-Language Network skill** (`wp-multilang-network`) — multisite multi-language orchestration with hreflang and content sync
17
+ - 5 reference files: `network-architecture.md`, `hreflang-config.md`, `content-sync.md`, `language-routing.md`, `seo-international.md`
18
+ - Detection script: `multilang_inspect.mjs` (multisite status, multilingual plugins, language patterns, hreflang)
19
+ - Agent updated: Multi-Language Network Management + example in `wp-site-manager`
20
+
21
+ ### Changed
22
+ - Router decision-tree.md upgraded to v10 with programmatic SEO, content attribution, and multi-language network keywords and routing
23
+ - 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
24
+ - Plugin now has 33 skills, 11 agents, and 85 MCP tools
25
+
26
+ ## [2.2.1] - 2026-02-28
27
+
28
+ ### Changed
29
+ - **GUIDE.md**: aggiornamento completo da v2.1.0 a v2.2.0 — documenta fleet monitoring, content repurposing, webhook propagation (19 scenari, 30 skill, 85 tool, router v9, +6 termini glossario)
30
+
5
31
  ## [2.2.0] - 2026-02-28
6
32
 
7
33
  ### Added
@@ -31,6 +31,13 @@ description: |
31
31
  assistant: "I'll use the wp-content-strategist agent to extract key insights from your posts and generate platform-specific social content."
32
32
  <commentary>Content repurposing requires selecting source content and applying platform templates.</commentary>
33
33
  </example>
34
+
35
+ <example>
36
+ Context: User wants to generate hundreds of location-based landing pages.
37
+ user: "Generate 200 city pages for our plumbing service"
38
+ assistant: "I'll use the wp-content-strategist agent to design the template, set up the data source, and bulk-generate the city pages."
39
+ <commentary>Programmatic SEO at scale requires structured data, URL design, and bulk content creation via REST API.</commentary>
40
+ </example>
34
41
  model: inherit
35
42
  tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
36
43
  ---
@@ -176,6 +183,23 @@ When repurposing existing WordPress content into multi-channel formats:
176
183
 
177
184
  See the `wp-content-repurposing` skill for detailed templates and platform specifications.
178
185
 
186
+ ## Programmatic SEO Workflow
187
+
188
+ When generating large-scale pages from structured data (city pages, product variants, comparison pages):
189
+
190
+ 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.
191
+ 2. **Design URL pattern**: Define the template — `/{service}/{city}` or `/{product}/{variant}`. Keep to max 3 levels, include primary keyword in first path segment.
192
+ 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.
193
+ 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.
194
+ 5. **Generate content in bulk**: Loop via `create_content` MCP tool:
195
+ - Create as `status: "draft"` first for review
196
+ - Process in batches of 10, report progress
197
+ - Assign taxonomies via `assign_terms_to_content`
198
+ 6. **Configure headless frontend**: Reference `wp-programmatic-seo` skill for ISR/SSG setup (Next.js `revalidate`, Nuxt `routeRules`, Astro hybrid mode).
199
+ 7. **Submit sitemap**: Verify XML sitemap includes all programmatic pages, submit to Google Search Console.
200
+
201
+ See the `wp-programmatic-seo` skill for reference files on template architecture, location SEO, product SEO, data sources, and technical SEO.
202
+
179
203
  ## Multilingual Content
180
204
 
181
205
  When creating content for multilingual sites:
@@ -194,3 +218,4 @@ When creating content for multilingual sites:
194
218
  - **`wp-content` skill** — content lifecycle management, editorial workflows
195
219
  - **`wp-i18n` skill** — internationalization and localization procedures
196
220
  - **`wp-content-repurposing` skill** — content transformation for multi-channel distribution
221
+ - **`wp-programmatic-seo` skill** — scalable page generation from structured data (city pages, product variants, comparison pages)
@@ -26,6 +26,13 @@ description: |
26
26
  <commentary>Sales analytics combining multiple report endpoints requires the WooCommerce agent.</commentary>
27
27
  </example>
28
28
 
29
+ <example>
30
+ Context: User wants to know which blog posts are driving sales.
31
+ user: "Which blog posts are driving the most sales?"
32
+ assistant: "I'll use the wp-ecommerce-manager agent to analyze order attribution data and identify top converting content."
33
+ <commentary>Content-commerce attribution requires correlating WooCommerce order UTM meta with content data.</commentary>
34
+ </example>
35
+
29
36
  model: inherit
30
37
  tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
31
38
  ---
@@ -93,6 +100,21 @@ For cross-referencing with WordPress content:
93
100
  3. Shipping: `wc_list_shipping_zones` (verify zone coverage)
94
101
  4. Tax: `wc_get_tax_classes` (verify tax configuration)
95
102
 
103
+ ### Content Attribution Workflow
104
+
105
+ When analyzing which content drives WooCommerce sales:
106
+
107
+ 1. **Verify setup**: Run `attribution_inspect.mjs` to check WooCommerce + content + UTM tracking readiness
108
+ 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`
109
+ 3. **Pull sales data**: `wc_get_sales_report` for the reporting period (default: last 30 days)
110
+ 4. **Pull order details**: `wc_list_orders` with `status=completed` — check `_last_utm_campaign` and `_first_utm_campaign` meta on each order
111
+ 5. **Pull content data**: `list_content` for the same period to map campaign slugs back to post titles
112
+ 6. **Correlate**: Match order UTM campaign values with content piece slugs; aggregate revenue per content piece
113
+ 7. **Apply attribution model**: Default to last-touch (`_last_utm_campaign`); reference `wp-content-attribution` skill for other models
114
+ 8. **Generate attribution report**: Top converting content pieces, revenue by content category, CAC by source, recommendations
115
+
116
+ See the `wp-content-attribution` skill for reference files on UTM setup, attribution models, ROI calculation, and reporting dashboards.
117
+
96
118
  ## Report Format
97
119
 
98
120
  ```
@@ -134,3 +156,4 @@ For cross-referencing with WordPress content:
134
156
  - `wp-deploy` — Deploy store changes to production
135
157
  - `wp-backup` — Backup store database before bulk operations
136
158
  - `wp-audit` — Security and performance audit for WC stores
159
+ - `wp-content-attribution` — Content-commerce attribution, UTM tracking, ROI calculation
@@ -24,6 +24,13 @@ description: |
24
24
  assistant: "I'll use the wp-site-manager agent to handle multi-site operations."
25
25
  <commentary>Multi-site coordination is a core capability of this agent.</commentary>
26
26
  </example>
27
+
28
+ <example>
29
+ Context: User wants to set up a multilingual multisite network.
30
+ user: "Set up Italian and Spanish versions of our site"
31
+ assistant: "I'll use the wp-site-manager agent to create language-specific sub-sites and configure the multi-language network."
32
+ <commentary>Multi-language network setup requires creating sub-sites, configuring hreflang, and establishing content sync — all multisite operations.</commentary>
33
+ </example>
27
34
  model: inherit
28
35
  tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
29
36
  ---
@@ -127,6 +134,20 @@ For WordPress Multisite networks (sites with `is_multisite: true` in WP_SITES_CO
127
134
  - ALWAYS confirm before network-activating plugins (affects ALL sites)
128
135
  - Announce which network you're operating on when multiple multisite networks are configured
129
136
 
137
+ ### Multi-Language Network Management
138
+
139
+ When setting up or managing a multi-language WordPress Multisite network:
140
+
141
+ 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).
142
+ 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}`.
143
+ 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.
144
+ 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`.
145
+ 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`.
146
+ 6. **Configure language routing**: Set up language switcher widget and optional browser detection redirect. See `references/language-routing.md`.
147
+ 7. **Verify international SEO**: Check hreflang reciprocal links, per-language sitemaps, GSC properties per language. See `references/seo-international.md`.
148
+
149
+ See the `wp-multilang-network` skill for detailed reference files on network architecture, hreflang, content sync, language routing, and international SEO.
150
+
130
151
  ### Safety Rules
131
152
  - NEVER delete content without explicit user confirmation
132
153
  - NEVER deactivate plugins without listing dependencies first
@@ -150,3 +171,8 @@ For domain-specific tasks, delegate to specialized agents:
150
171
  | Multisite network management | `wp-site-manager` (this agent) | Sub-sites, network plugins, Super Admin — see section above |
151
172
  | CI/CD pipeline setup and troubleshooting | `wp-cicd-engineer` | GitHub Actions, GitLab CI, Bitbucket, quality gates |
152
173
  | Site monitoring and health reports | `wp-monitoring-agent` | Uptime, performance trends, security scanning, content integrity |
174
+
175
+ ## Related Skills
176
+
177
+ - **`wp-multisite` skill** — multisite network management with 10 MCP tools
178
+ - **`wp-multilang-network` skill** — multi-language network orchestration (hreflang, content sync, international SEO)
package/docs/GUIDE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # WordPress Manager - Guida Completa per Utenti e Amministratori
2
2
 
3
- **Versione:** 2.1.0
3
+ **Versione:** 2.2.0
4
4
  **Ultimo aggiornamento:** 2026-02-28
5
5
  **Repository:** https://github.com/morrealev/wordpress-manager
6
6
 
@@ -57,6 +57,9 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
57
57
  - **Amministrare Multisite**: sub-site, network plugin, Super Admin, domain mapping
58
58
  - **Configurare CI/CD**: GitHub Actions, GitLab CI, Bitbucket Pipelines, quality gates, deploy automatico
59
59
  - **Monitorare siti**: uptime, performance baseline, security scanning, content integrity, alerting
60
+ - **Fleet monitoring**: monitorare tutti i siti configurati con report comparativi cross-site
61
+ - **Riproporre contenuti**: trasformare post WordPress in social media, email, newsletter multi-canale
62
+ - **Gestire webhook**: configurare notifiche outbound WordPress verso servizi esterni (Zapier, Slack, CDN)
60
63
 
61
64
  ### Requisiti
62
65
 
@@ -80,7 +83,7 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
80
83
  wordpress-manager plugin
81
84
  / | \
82
85
  Hostinger MCP WP REST Bridge WordPress.com MCP
83
- (119 tool) (81 tool) (~15 tool)
86
+ (119 tool) (85 tool) (~15 tool)
84
87
  | | |
85
88
  Infrastruttura Contenuti + Siti hosted
86
89
  DNS, SSL, VPS Plugin, Utenti su WordPress.com
@@ -93,7 +96,7 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
93
96
  ### Componenti del Plugin
94
97
 
95
98
  ```
96
- wordpress-manager/ # v2.1.0
99
+ wordpress-manager/ # v2.2.0
97
100
  +-- .claude-plugin/plugin.json # Manifest
98
101
  +-- .mcp.json # Server MCP bundled
99
102
  +-- LICENSE # MIT + GPL-2.0-or-later
@@ -112,7 +115,7 @@ wordpress-manager/ # v2.1.0
112
115
  | +-- wp-monitoring-agent.md # Site monitoring read-only (v2.1.0)
113
116
  +-- commands/ # 5 slash commands
114
117
  | +-- wp-status.md / wp-deploy.md / wp-audit.md / wp-backup.md / wp-setup.md
115
- +-- skills/ # 28 skill totali
118
+ +-- skills/ # 30 skill totali
116
119
  | +-- [OPERATIVE - 5 skill]
117
120
  | +-- wp-deploy/ # Procedure deploy
118
121
  | +-- wp-audit/ # Checklist audit
@@ -122,7 +125,7 @@ wordpress-manager/ # v2.1.0
122
125
  | +-- [AMBIENTE LOCALE - 1 skill]
123
126
  | +-- wp-local-env/ # Studio/LocalWP/wp-env
124
127
  | +-- [SVILUPPO - 13 skill da WordPress/agent-skills]
125
- | +-- wordpress-router/ # Router unificato v8 (dev + local + ops + multisite + cicd + monitoring)
128
+ | +-- wordpress-router/ # Router unificato v9 (dev + local + ops + multisite + cicd + monitoring + webhooks + repurposing)
126
129
  | +-- wp-project-triage/ # Auto-detect tipo progetto
127
130
  | +-- wp-block-development/ # Blocchi Gutenberg
128
131
  | +-- wp-block-themes/ # Temi a blocchi
@@ -141,13 +144,15 @@ wordpress-manager/ # v2.1.0
141
144
  | +-- wp-i18n/ # Internazionalizzazione
142
145
  | +-- wp-accessibility/ # WCAG 2.2 accessibilita
143
146
  | +-- wp-headless/ # Architettura headless/decoupled
144
- | +-- [E-COMMERCE + INFRASTRUTTURA - 4 skill]
147
+ | +-- [E-COMMERCE + INFRASTRUTTURA - 6 skill]
145
148
  | +-- wp-woocommerce/ # WooCommerce store management (v1.8.0)
146
149
  | +-- wp-multisite/ # Multisite network management (v1.9.0)
147
150
  | +-- wp-cicd/ # CI/CD pipeline automation (v2.0.0)
148
- | +-- wp-monitoring/ # Site monitoring e observability (v2.1.0)
149
- +-- hooks/ # 6 hook di sicurezza
150
- | +-- hooks.json # 4 prompt + 2 command
151
+ | +-- wp-monitoring/ # Site monitoring, fleet monitoring e observability (v2.1.0-v2.2.0)
152
+ | +-- wp-content-repurposing/ # Content repurposing multi-canale (v2.2.0)
153
+ | +-- wp-webhooks/ # Webhook propagation e integrazioni (v2.2.0)
154
+ +-- hooks/ # 7 hook di sicurezza
155
+ | +-- hooks.json # 5 prompt + 2 command
151
156
  | +-- scripts/ # Script per hook command-type
152
157
  +-- scripts/ # Utility
153
158
  +-- servers/wp-rest-bridge/ # MCP Server custom (TypeScript)
@@ -329,6 +334,9 @@ WordPress Manager comprende richieste in linguaggio naturale. Ecco come formular
329
334
  | Amministrare Multisite | "Crea un sub-site" / "Network activate plugin" / "Super Admin" |
330
335
  | Configurare CI/CD | "Setup GitHub Actions" / "CI per il mio plugin" / "Deploy automatico" |
331
336
  | Monitorare il sito | "Monitora il sito" / "Health report" / "Setup uptime check" |
337
+ | Fleet monitoring | "Monitora tutti i siti" / "Fleet health" / "Cross-site comparison" |
338
+ | Riproporre contenuti | "Riproponi il post per social" / "Newsletter dal blog" / "Atomizza contenuto" |
339
+ | Gestire webhook | "Configura webhook" / "Notifica Zapier" / "WooCommerce webhook" |
332
340
 
333
341
  ---
334
342
 
@@ -562,7 +570,9 @@ IDEAZIONE -> BOZZA -> REVISIONE -> OTTIMIZZAZIONE -> PUBBLICAZIONE -> MONITORAGG
562
570
 
563
571
  **6 template disponibili**: Blog standard, Listicle, How-To Guide, Landing Page, About Page, Product Page
564
572
 
565
- **Skill correlata**: `wp-content`, `wp-i18n`
573
+ **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.
574
+
575
+ **Skill correlata**: `wp-content`, `wp-i18n`, `wp-content-repurposing`
566
576
 
567
577
  ---
568
578
 
@@ -721,7 +731,7 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
721
731
  | Ruolo | Gestione completa store WooCommerce |
722
732
  | Attivazione | "Mostra gli ordini", "crea un prodotto", "report vendite", "coupon", "WooCommerce" |
723
733
 
724
- **Capacita** (30 tool MCP via WP REST Bridge, namespace `wc/v3`):
734
+ **Capacita** (34 tool MCP via WP REST Bridge, namespace `wc/v3`):
725
735
 
726
736
  | Area | Tool | Operazioni |
727
737
  |------|------|-----------|
@@ -731,10 +741,11 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
731
741
  | Coupons | 4 | Creazione coupon, marketing promozioni |
732
742
  | Reports | 5 | Vendite, top seller, totali ordini/prodotti/clienti |
733
743
  | Settings | 4 | Gateway pagamento, zone spedizione, tasse, system status |
744
+ | Webhooks | 4 | Lista, crea, aggiorna, elimina webhook WooCommerce (v2.2.0) |
734
745
 
735
746
  **Prerequisiti**: WooCommerce attivo + Consumer Key/Secret configurati in `WP_SITES_CONFIG` (generare da WooCommerce > Settings > Advanced > REST API).
736
747
 
737
- **Skill correlata**: `wp-woocommerce`
748
+ **Skill correlata**: `wp-woocommerce`, `wp-webhooks`
738
749
 
739
750
  ---
740
751
 
@@ -773,9 +784,9 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
773
784
  |-----------|--------|
774
785
  | Colore | Teal |
775
786
  | Ruolo | Monitoring continuo del sito (read-only, non modifica nulla) |
776
- | Attivazione | "Monitora il sito", "health report", "uptime check", "performance trend", "security scan periodico" |
787
+ | Attivazione | "Monitora il sito", "health report", "uptime check", "performance trend", "security scan periodico", "fleet health", "monitora tutti i siti" |
777
788
 
778
- **5 aree di monitoraggio**:
789
+ **5 aree di monitoraggio + fleet**:
779
790
 
780
791
  | Area | Cosa monitora |
781
792
  |------|--------------|
@@ -784,8 +795,11 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
784
795
  | Security | Plugin vulnerabilita, file integrity, utenti anomali, malware patterns |
785
796
  | Content | Modifiche non autorizzate, broken links, spam comments, media integrity |
786
797
  | Alerting | Threshold P0-P3, notifiche email/Slack/webhook, escalation |
798
+ | Fleet (v2.2.0) | Cross-site health comparison, fleet-wide patterns, per-site breakdown |
799
+
800
+ **Report disponibili**: Daily Health Summary, Weekly Performance, Monthly Security, Quarterly Trend, Executive Dashboard, Fleet Health Report (v2.2.0).
787
801
 
788
- **Report disponibili**: Daily Health Summary, Weekly Performance, Monthly Security, Quarterly Trend, Executive Dashboard.
802
+ **Fleet monitoring** (v2.2.0): Itera su tutti i siti configurati (`list_sites` + `switch_site`), esegue le procedure di monitoring per ciascuno, aggrega i risultati in un report comparativo fleet con pattern cross-site (stessa vulnerabilita su piu siti, performance regression fleet-wide).
789
803
 
790
804
  **Delegazione**: Quando rileva problemi, delega a agent specializzati:
791
805
  - Sicurezza → `wp-security-auditor` + `wp-security-hardener`
@@ -858,11 +872,11 @@ Le skill di sviluppo provengono da due fonti:
858
872
 
859
873
  - **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.
860
874
  - **5 skill estese** (MIT) aggiunte in v1.6.0: testing, security, internazionalizzazione, accessibilita, headless.
861
- - **4 skill e-commerce + infrastruttura** (MIT) aggiunte in v1.8.0-v2.1.0: WooCommerce, Multisite, CI/CD, Monitoring.
875
+ - **6 skill e-commerce + infrastruttura** (MIT) aggiunte in v1.8.0-v2.2.0: WooCommerce, Multisite, CI/CD, Monitoring, Content Repurposing, Webhooks.
862
876
 
863
877
  ### Il Router Unificato
864
878
 
865
- La skill `wordpress-router` (v8) e il punto d'ingresso per tutti i task WordPress. Classifica automaticamente il task in **sei categorie**: sviluppo, ambiente locale, operativo, multisite, CI/CD, monitoring.
879
+ 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.
866
880
 
867
881
  ```
868
882
  Utente: "Crea un blocco custom per la gallery"
@@ -922,6 +936,22 @@ wordpress-router: TASK = operativo (monitoring)
922
936
  wp-monitoring skill + wp-monitoring-agent agent
923
937
  ```
924
938
 
939
+ ```
940
+ Utente: "Riproponi l'ultimo post del blog per i social media"
941
+ |
942
+ wordpress-router: TASK = operativo (content repurposing)
943
+ |
944
+ wp-content-repurposing skill + wp-content-strategist agent
945
+ ```
946
+
947
+ ```
948
+ Utente: "Configura un webhook WooCommerce per Zapier"
949
+ |
950
+ wordpress-router: TASK = operativo (webhook)
951
+ |
952
+ wp-webhooks skill + wp-site-manager agent
953
+ ```
954
+
925
955
  ### Panoramica Skills di Sviluppo — Community (13)
926
956
 
927
957
  | Skill | Si attiva quando... | Risorse |
@@ -954,20 +984,22 @@ Aggiunte in v1.6.0, queste skill coprono aree avanzate dello sviluppo WordPress.
954
984
 
955
985
  **Cross-reference bidirezionali**: Le skill con agent dedicato contengono una sezione "Recommended Agent", e gli agent contengono "Related Skills". Questo garantisce che Claude attivi sia la conoscenza (skill) che l'esecutore (agent) appropriati.
956
986
 
957
- ### Panoramica Skills E-Commerce + Infrastruttura (4)
987
+ ### Panoramica Skills E-Commerce + Infrastruttura (6)
958
988
 
959
- Aggiunte in v1.8.0-v2.1.0, queste skill coprono e-commerce, multisite, CI/CD e monitoring.
989
+ Aggiunte in v1.8.0-v2.2.0, queste skill coprono e-commerce, multisite, CI/CD, monitoring, content repurposing e webhook.
960
990
 
961
991
  | Skill | Si attiva quando... | Risorse | Agent dedicato |
962
992
  |-------|---------------------|---------|----------------|
963
- | `wp-woocommerce` | "prodotti", "ordini", "WooCommerce", "coupon", "report vendite" | 6 reference files, woocommerce_inspect.mjs | `wp-ecommerce-manager` |
993
+ | `wp-woocommerce` | "prodotti", "ordini", "WooCommerce", "coupon", "report vendite" | 8 reference files, woocommerce_inspect.mjs | `wp-ecommerce-manager` |
964
994
  | `wp-multisite` | "multisite", "sub-site", "network admin", "domain mapping" | 6 reference files, multisite_inspect.mjs | — |
965
- | `wp-cicd` | "CI/CD", "GitHub Actions", "pipeline", "deploy automatico" | 6 reference files, cicd_inspect.mjs | `wp-cicd-engineer` |
966
- | `wp-monitoring` | "monitora", "uptime", "health report", "alerting", "trend" | 6 reference files, monitoring_inspect.mjs | `wp-monitoring-agent` |
995
+ | `wp-cicd` | "CI/CD", "GitHub Actions", "pipeline", "deploy automatico" | 7 reference files, cicd_inspect.mjs | `wp-cicd-engineer` |
996
+ | `wp-monitoring` | "monitora", "uptime", "health report", "alerting", "fleet health" | 7 reference files, monitoring_inspect.mjs | `wp-monitoring-agent` |
997
+ | `wp-content-repurposing` | "riproponi contenuto", "social dal blog", "newsletter dai post", "atomizza" | 4 reference files, repurposing_inspect.mjs | `wp-content-strategist` |
998
+ | `wp-webhooks` | "webhook", "notifica esterna", "Zapier", "WooCommerce webhook" | 5 reference files, webhook_inspect.mjs | `wp-site-manager` |
967
999
 
968
1000
  ### Script di Rilevamento Automatico
969
1001
 
970
- Le skill includono 16 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
1002
+ Le skill includono 18 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
971
1003
 
972
1004
  | Script | Cosa rileva |
973
1005
  |--------|-------------|
@@ -986,7 +1018,9 @@ Le skill includono 16 script Node.js (`.mjs`) che eseguono analisi automatica de
986
1018
  | `woocommerce_inspect.mjs` | WooCommerce attivo, API keys, prodotti, ordini, gateway (v1.8.0) |
987
1019
  | `multisite_inspect.mjs` | Multisite abilitato, sub-sites, network plugins, Super Admin (v1.9.0) |
988
1020
  | `cicd_inspect.mjs` | Piattaforme CI, quality tools, wp-env, deploy config (v2.0.0) |
989
- | `monitoring_inspect.mjs` | Uptime tools, Lighthouse CI, security plugins, logging config (v2.1.0) |
1021
+ | `monitoring_inspect.mjs` | Uptime tools, Lighthouse CI, security plugins, logging config, fleet config (v2.1.0-v2.2.0) |
1022
+ | `repurposing_inspect.mjs` | Social plugins, email plugins, content volume, repurposing readiness (v2.2.0) |
1023
+ | `webhook_inspect.mjs` | WC webhooks, mu-plugin webhooks, webhook plugins, wp-config constants (v2.2.0) |
990
1024
 
991
1025
  ### WordPress Playground — Ambienti Disposable
992
1026
 
@@ -1021,7 +1055,7 @@ Senza il server MCP, la skill usa conoscenza generale di `@wordpress/components`
1021
1055
  ```
1022
1056
  1. cd mio-progetto-wordpress/
1023
1057
  2. Claude esegue wp-project-triage → rileva "wp-block-plugin"
1024
- 3. wordpress-router v8 → instrada a wp-block-development
1058
+ 3. wordpress-router v9 → instrada a wp-block-development
1025
1059
  4. Claude guida la creazione con block.json, edit.js, save.js
1026
1060
  5. wp-e2e-testing + wp-test-engineer → esegue test E2E con Playwright
1027
1061
  6. wp-accessibility + wp-accessibility-auditor → verifica WCAG 2.2
@@ -1099,6 +1133,7 @@ Questi hook chiedono a Claude di valutare se l'operazione e stata esplicitamente
1099
1133
  | 2 | Disattivazione plugin | `deactivate_plugin` | Conferma prima di disattivare (potrebbe rompere dipendenze) |
1100
1134
  | 3 | Import WordPress | `hosting_importWordpressWebsite` | Conferma prima di SOVRASCRIVERE l'installazione esistente |
1101
1135
  | 4 | Modifica DNS | `DNS_updateDNSRecordsV1`, `DNS_resetDNSRecordsV1` | Conferma prima di modificare i record DNS |
1136
+ | 5 | Eliminazione webhook WC | `wc_delete_webhook` | Conferma prima di eliminare un webhook (le integrazioni esterne smetteranno di ricevere eventi) |
1102
1137
 
1103
1138
  ### Hook Command-Based (Validazione Script)
1104
1139
 
@@ -1155,7 +1190,7 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
1155
1190
  | Sorgente | Custom TypeScript server in `servers/wp-rest-bridge/` |
1156
1191
  | Trasporto | stdio (JSON-RPC via stdin/stdout) |
1157
1192
  | Autenticazione | `WP_SITES_CONFIG` JSON env var |
1158
- | Tool disponibili | 81 (40 WordPress + 30 WooCommerce + 11 Multisite) |
1193
+ | Tool disponibili | 85 (41 WordPress + 34 WooCommerce + 10 Multisite) |
1159
1194
 
1160
1195
  **Categorie tool WordPress** (`wp/v2`):
1161
1196
 
@@ -1180,6 +1215,7 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
1180
1215
  | Coupons | 4 | `wc_list_coupons`, `wc_create_coupon`, `wc_delete_coupon` |
1181
1216
  | Reports | 5 | `wc_get_sales_report`, `wc_get_top_sellers`, `wc_get_orders_totals` |
1182
1217
  | Settings | 4 | `wc_list_payment_gateways`, `wc_list_shipping_zones`, `wc_get_system_status` |
1218
+ | Webhooks | 4 | `wc_list_webhooks`, `wc_create_webhook`, `wc_update_webhook`, `wc_delete_webhook` |
1183
1219
 
1184
1220
  **Categorie tool Multisite** (`ms_` prefix, richiede `is_multisite: true` + SSH/WP-CLI):
1185
1221
 
@@ -1467,7 +1503,53 @@ Claude (attiva skill wp-headless):
1467
1503
  6. Configura webhook per invalidazione cache
1468
1504
  ```
1469
1505
 
1470
- ### Scenario 16: WordPress Multisite Network
1506
+ ### Scenario 16: Fleet Monitoring Cross-Site
1507
+
1508
+ ```
1509
+ Tu: "Controlla la salute di tutti i miei siti WordPress"
1510
+
1511
+ Claude (attiva wp-monitoring-agent + skill wp-monitoring, Procedura 7):
1512
+ 1. list_sites per enumerare tutti i siti configurati
1513
+ 2. Per ogni sito: switch_site, poi uptime + performance + security + content check
1514
+ 3. Aggrega i risultati in tabella comparativa fleet
1515
+ 4. Identifica pattern cross-site (stessa vulnerabilita su piu siti, regressione simultanea)
1516
+ 5. Genera Fleet Health Report con breakdown per sito + summary fleet
1517
+ -> Report: fleet health, anomalie, raccomandazioni prioritizzate
1518
+ ```
1519
+
1520
+ ### Scenario 17: Content Repurposing Multi-Canale
1521
+
1522
+ ```
1523
+ Tu: "Trasforma l'ultimo post del blog in contenuti per social media e newsletter"
1524
+
1525
+ Claude (attiva wp-content-strategist + skill wp-content-repurposing):
1526
+ 1. Seleziona post piu recente via list_content
1527
+ 2. Estrae elementi chiave: headline, punti principali, quote, statistiche, CTA
1528
+ 3. Genera Twitter/X thread (280 char per tweet, hook + 3-5 punti + CTA)
1529
+ 4. Genera LinkedIn summary (angolo professionale, 1000 char)
1530
+ 5. Genera Instagram carousel (5-7 slide con takeaway visivi)
1531
+ 6. Genera newsletter digest (excerpt + CTA, subject line ottimizzata)
1532
+ 7. Presenta tutte le varianti per revisione
1533
+ -> Output: 4+ formati pronti per distribuzione
1534
+ ```
1535
+
1536
+ ### Scenario 18: Webhook WooCommerce per Zapier
1537
+
1538
+ ```
1539
+ Tu: "Configura un webhook WooCommerce per notificare Zapier quando arriva un nuovo ordine"
1540
+
1541
+ Claude (attiva skill wp-webhooks):
1542
+ 1. Verifica WooCommerce attivo con webhook_inspect.mjs
1543
+ 2. Crea webhook con wc_create_webhook:
1544
+ - topic: "order.created"
1545
+ - delivery_url: URL webhook Zapier dell'utente
1546
+ - secret: genera shared secret per HMAC-SHA256
1547
+ 3. Verifica webhook attivo con wc_list_webhooks
1548
+ 4. Spiega come verificare la signature nel receiver
1549
+ -> Report: webhook configurato, URL delivery, istruzioni test
1550
+ ```
1551
+
1552
+ ### Scenario 19: WordPress Multisite Network
1471
1553
 
1472
1554
  ```
1473
1555
  Tu: "Crea un network multisite con 3 sub-site per i nostri brand"
@@ -1743,8 +1825,14 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
1743
1825
  | **Baseline** | Snapshot iniziale delle metriche (CWV, TTFB, plugin count) usato come riferimento per trend analysis |
1744
1826
  | **P0-P3** | Livelli di severity per alerting: P0 critico (sito down), P1 alto, P2 medio, P3 informativo |
1745
1827
  | **TTFB** | Time To First Byte — tempo tra la richiesta HTTP e il primo byte di risposta dal server |
1828
+ | **Fleet Monitoring** | Monitoraggio simultaneo di tutti i siti WordPress configurati con report comparativo cross-site |
1829
+ | **Content Repurposing** | Trasformazione sistematica di contenuti WordPress in formati multi-canale (social, email, newsletter) |
1830
+ | **Content Atomization** | Scomposizione di contenuti pillar in unita atomiche autonome (quote, statistiche, tip) per distribuzione |
1831
+ | **Webhook** | Notifica HTTP outbound inviata automaticamente da WordPress quando si verifica un evento (es. ordine creato) |
1832
+ | **HMAC-SHA256** | Algoritmo di firma usato per autenticare webhook — il receiver verifica l'integrita del payload |
1833
+ | **mu-plugin** | Must-Use Plugin WordPress — plugin caricato automaticamente senza attivazione, usato per webhook core |
1746
1834
 
1747
1835
  ---
1748
1836
 
1749
- *Guida v2.1.0 - WordPress Manager Plugin per Claude Code*
1837
+ *Guida v2.2.0 - WordPress Manager Plugin per Claude Code*
1750
1838
  *Ultimo aggiornamento: 2026-02-28*
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "claude-plugin-wordpress-manager",
3
- "version": "2.2.0",
4
- "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).",
3
+ "version": "2.3.0",
4
+ "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.",
5
5
  "author": {
6
6
  "name": "vinmor",
7
7
  "email": "morreale.v@gmail.com"
@@ -36,7 +36,12 @@
36
36
  "health-check",
37
37
  "webhook",
38
38
  "content-repurposing",
39
- "fleet-monitoring"
39
+ "fleet-monitoring",
40
+ "programmatic-seo",
41
+ "attribution",
42
+ "multilingual",
43
+ "hreflang",
44
+ "international-seo"
40
45
  ],
41
46
  "repository": {
42
47
  "type": "git",
@@ -1,4 +1,4 @@
1
- # Router decision tree (v9 — development + local environment + operations + multisite + CI/CD + monitoring + webhooks + content repurposing)
1
+ # Router decision tree (v10 — development + local environment + operations + multisite + CI/CD + monitoring + webhooks + content repurposing + programmatic SEO + content attribution + multi-language network)
2
2
 
3
3
  This routing guide covers WordPress **development**, **local environment**, and **operations** workflows.
4
4
 
@@ -14,7 +14,7 @@ Keywords that indicate **local environment**:
14
14
  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
15
15
 
16
16
  Keywords that indicate **operations**:
17
- 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
17
+ 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
18
18
 
19
19
  Keywords that indicate **development**:
20
20
  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
98
98
  → `wp-webhooks` skill + `wp-site-manager` agent
99
99
  - **Repurpose content / social posts from blog / newsletter from content / atomize / content distribution / turn blog into social**
100
100
  → `wp-content-repurposing` skill + `wp-content-strategist` agent
101
+ - **Programmatic SEO / template pages / city pages / bulk page generation / scalable landing pages / location-based SEO / product variant pages**
102
+ → `wp-programmatic-seo` skill + `wp-content-strategist` agent
103
+ - **Content attribution / ROI / conversion tracking / UTM / revenue per post / which content drives sales**
104
+ → `wp-content-attribution` skill + `wp-ecommerce-manager` agent
105
+ - **Multi-language / multilingual / hreflang / international SEO / language sites / translate network**
106
+ → `wp-multilang-network` skill + `wp-site-manager` agent
101
107
 
102
108
  ## Step 2c: route by local environment intent (keywords)
103
109
 
@@ -104,3 +104,4 @@ Tool: assign_terms_to_content — assign terms to content
104
104
 
105
105
  ### Related Skills
106
106
  - **`wp-content-repurposing`** — transform existing content for social media, email, and multi-channel distribution
107
+ - **`wp-content-attribution`** — measure which content drives WooCommerce sales (UTM tracking, attribution models, ROI)