claude-plugin-wordpress-manager 2.1.0 → 2.2.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.
- package/.claude-plugin/plugin.json +2 -2
- package/CHANGELOG.md +30 -0
- package/agents/wp-content-strategist.md +30 -0
- package/agents/wp-monitoring-agent.md +50 -0
- package/docs/GUIDE.md +249 -15
- package/docs/plans/2026-02-28-wcop-strategic-assessment.md +220 -0
- package/hooks/hooks.json +9 -0
- package/package.json +6 -3
- package/servers/wp-rest-bridge/build/tools/index.d.ts +119 -0
- package/servers/wp-rest-bridge/build/tools/index.js +3 -0
- package/servers/wp-rest-bridge/build/tools/wc-webhooks.d.ts +129 -0
- package/servers/wp-rest-bridge/build/tools/wc-webhooks.js +142 -0
- package/servers/wp-rest-bridge/build/types.d.ts +12 -0
- package/skills/wordpress-router/references/decision-tree.md +7 -3
- package/skills/wp-content/SKILL.md +3 -0
- package/skills/wp-content-repurposing/SKILL.md +96 -0
- package/skills/wp-content-repurposing/references/content-atomization.md +117 -0
- package/skills/wp-content-repurposing/references/email-newsletter.md +136 -0
- package/skills/wp-content-repurposing/references/platform-specs.md +80 -0
- package/skills/wp-content-repurposing/references/social-formats.md +169 -0
- package/skills/wp-content-repurposing/scripts/repurposing_inspect.mjs +140 -0
- package/skills/wp-headless/SKILL.md +1 -0
- package/skills/wp-monitoring/SKILL.md +12 -2
- package/skills/wp-monitoring/references/fleet-monitoring.md +160 -0
- package/skills/wp-monitoring/scripts/monitoring_inspect.mjs +54 -1
- package/skills/wp-webhooks/SKILL.md +107 -0
- package/skills/wp-webhooks/references/integration-recipes.md +176 -0
- package/skills/wp-webhooks/references/payload-formats.md +134 -0
- package/skills/wp-webhooks/references/webhook-security.md +147 -0
- package/skills/wp-webhooks/references/woocommerce-webhooks.md +129 -0
- package/skills/wp-webhooks/references/wordpress-core-webhooks.md +162 -0
- package/skills/wp-webhooks/scripts/webhook_inspect.mjs +157 -0
- package/skills/wp-woocommerce/SKILL.md +1 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "wordpress-manager",
|
|
3
|
-
"version": "2.
|
|
4
|
-
"description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (
|
|
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.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "vinmor",
|
|
7
7
|
"email": "morreale.v@gmail.com"
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,36 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to the WordPress Manager plugin for Claude Code.
|
|
4
4
|
|
|
5
|
+
## [2.2.0] - 2026-02-28
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
- **Fleet monitoring** — cross-site health assessment for all configured WordPress sites
|
|
9
|
+
- New reference file: `skills/wp-monitoring/references/fleet-monitoring.md` (fleet iteration, cross-site patterns, fleet baselines, site grouping, scheduling, P0 escalation)
|
|
10
|
+
- Detection script updated: `detectFleetConfiguration()` checks WP_SITES_CONFIG and sites.json for multi-site fleet
|
|
11
|
+
- Agent updated: Procedure 7 (Fleet Monitoring) + Fleet Report Template in `wp-monitoring-agent`
|
|
12
|
+
|
|
13
|
+
- **Content repurposing skill** (`wp-content-repurposing`) — transform WordPress content into multi-channel outputs
|
|
14
|
+
- 4 reference files: social-formats (Twitter/LinkedIn/Instagram/Facebook templates), email-newsletter (digest/drip/subject lines), content-atomization (pillar→atoms workflow, repurposing matrix), platform-specs (character limits, image dimensions, posting frequency)
|
|
15
|
+
- Detection script: `repurposing_inspect.mjs` — detects social plugins, email plugins, content volume
|
|
16
|
+
- Agent updated: `wp-content-strategist` now includes Content Repurposing Workflow and repurposing example
|
|
17
|
+
|
|
18
|
+
- **Webhook propagation skill** (`wp-webhooks`) — WordPress outbound webhook configuration and management
|
|
19
|
+
- 5 reference files: woocommerce-webhooks (API, topics, MCP tools), wordpress-core-webhooks (mu-plugin, action hooks), integration-recipes (Zapier/Make/n8n/Slack/CDN), payload-formats (JSON payloads, WC examples), webhook-security (HMAC-SHA256, signatures, rate limiting)
|
|
20
|
+
- Detection script: `webhook_inspect.mjs` — detects WC webhooks, mu-plugin webhooks, webhook plugins, wp-config constants
|
|
21
|
+
- 4 new MCP tools via WP REST Bridge: `wc_list_webhooks`, `wc_create_webhook`, `wc_update_webhook`, `wc_delete_webhook`
|
|
22
|
+
- `WCWebhook` TypeScript interface added to types.ts
|
|
23
|
+
- Safety hook for `wc_delete_webhook` (PreToolUse prompt confirmation)
|
|
24
|
+
|
|
25
|
+
### Changed
|
|
26
|
+
- Router decision-tree.md upgraded to v9 with fleet, webhook, and content repurposing keywords and routing
|
|
27
|
+
- Cross-references added: `wp-content` → wp-content-repurposing, `wp-headless` → wp-webhooks, `wp-woocommerce` → wp-webhooks
|
|
28
|
+
- Plugin now has 30 skills, 11 agents, and 85 MCP tools
|
|
29
|
+
|
|
30
|
+
## [2.1.1] - 2026-02-28
|
|
31
|
+
|
|
32
|
+
### Changed
|
|
33
|
+
- **GUIDE.md**: aggiornamento completo da v1.7.1 a v2.1.0 — documenta WooCommerce, Multisite, CI/CD, Monitoring (11 agent, 28 skill, 81 tool, 16 script, router v8, 16 scenari, +13 termini glossario)
|
|
34
|
+
|
|
5
35
|
## [2.1.0] - 2026-02-28
|
|
6
36
|
|
|
7
37
|
### Added
|
|
@@ -24,6 +24,13 @@ description: |
|
|
|
24
24
|
assistant: "I'll use the wp-content-strategist agent to set up the taxonomy structure."
|
|
25
25
|
<commentary>Taxonomy design impacts content architecture and SEO.</commentary>
|
|
26
26
|
</example>
|
|
27
|
+
|
|
28
|
+
<example>
|
|
29
|
+
Context: User wants to repurpose blog content for social media.
|
|
30
|
+
user: "Turn my latest blog posts into social media content"
|
|
31
|
+
assistant: "I'll use the wp-content-strategist agent to extract key insights from your posts and generate platform-specific social content."
|
|
32
|
+
<commentary>Content repurposing requires selecting source content and applying platform templates.</commentary>
|
|
33
|
+
</example>
|
|
27
34
|
model: inherit
|
|
28
35
|
tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
|
|
29
36
|
---
|
|
@@ -147,6 +154,28 @@ Excerpt: [Meta description with keyword, under 160 chars]
|
|
|
147
154
|
- ALWAYS preserve existing SEO-optimized slugs when updating content
|
|
148
155
|
- ALWAYS check for duplicate slugs before creating new content
|
|
149
156
|
|
|
157
|
+
## Content Repurposing Workflow
|
|
158
|
+
|
|
159
|
+
When repurposing existing WordPress content into multi-channel formats:
|
|
160
|
+
|
|
161
|
+
1. **Select source content**: Use `list_content` to find recent/popular posts
|
|
162
|
+
- Filter by `orderby: "date"` for recent or by popularity metrics
|
|
163
|
+
- Prioritize evergreen content with broad appeal
|
|
164
|
+
2. **Extract key elements** from source post:
|
|
165
|
+
- Headline and hook
|
|
166
|
+
- 3-5 key insights or data points
|
|
167
|
+
- Quotable passages
|
|
168
|
+
- Statistics or results
|
|
169
|
+
- Call to action
|
|
170
|
+
3. **Apply platform templates** from `wp-content-repurposing` skill:
|
|
171
|
+
- Social formats: `references/social-formats.md`
|
|
172
|
+
- Email newsletter: `references/email-newsletter.md`
|
|
173
|
+
- Atomization: `references/content-atomization.md`
|
|
174
|
+
4. **Generate formatted outputs** per target channel
|
|
175
|
+
5. **Present all variants** to user for review before distribution
|
|
176
|
+
|
|
177
|
+
See the `wp-content-repurposing` skill for detailed templates and platform specifications.
|
|
178
|
+
|
|
150
179
|
## Multilingual Content
|
|
151
180
|
|
|
152
181
|
When creating content for multilingual sites:
|
|
@@ -164,3 +193,4 @@ When creating content for multilingual sites:
|
|
|
164
193
|
|
|
165
194
|
- **`wp-content` skill** — content lifecycle management, editorial workflows
|
|
166
195
|
- **`wp-i18n` skill** — internationalization and localization procedures
|
|
196
|
+
- **`wp-content-repurposing` skill** — content transformation for multi-channel distribution
|
|
@@ -24,6 +24,13 @@ description: |
|
|
|
24
24
|
assistant: "I'll use the wp-monitoring-agent to analyze performance metrics and compare with the baseline."
|
|
25
25
|
<commentary>Performance trend analysis requires collecting current metrics and comparing with historical data.</commentary>
|
|
26
26
|
</example>
|
|
27
|
+
|
|
28
|
+
<example>
|
|
29
|
+
Context: User wants to check all their WordPress sites at once.
|
|
30
|
+
user: "Run a health check across all my sites"
|
|
31
|
+
assistant: "I'll use the wp-monitoring-agent to perform a fleet-wide health assessment across all configured sites."
|
|
32
|
+
<commentary>Fleet monitoring requires iterating over all configured sites and aggregating findings.</commentary>
|
|
33
|
+
</example>
|
|
27
34
|
model: inherit
|
|
28
35
|
tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
|
|
29
36
|
---
|
|
@@ -109,6 +116,23 @@ Run a full assessment to create a monitoring baseline:
|
|
|
109
116
|
4. Check robots.txt via WebFetch: verify no unexpected rules
|
|
110
117
|
5. Report content changes, spam levels, and SEO health
|
|
111
118
|
|
|
119
|
+
### Procedure 7: Fleet Monitoring
|
|
120
|
+
|
|
121
|
+
Run health assessments across all configured sites and generate a fleet-wide comparison:
|
|
122
|
+
|
|
123
|
+
1. **Enumerate sites**: Use `list_sites` to get all configured sites
|
|
124
|
+
2. **Iterate**: For each site:
|
|
125
|
+
a. `switch_site` to target the site
|
|
126
|
+
b. Run Procedures 3-6 (uptime, performance, security, content)
|
|
127
|
+
c. Record per-site metrics and findings
|
|
128
|
+
3. **Aggregate**: Combine per-site results into a fleet comparison table
|
|
129
|
+
4. **Cross-site pattern detection**:
|
|
130
|
+
- Same plugin vulnerability across multiple sites
|
|
131
|
+
- Correlated performance degradation (shared hosting, CDN issue)
|
|
132
|
+
- Identical outdated WordPress core versions
|
|
133
|
+
- Common configuration drift from baselines
|
|
134
|
+
5. **Generate fleet report** (see Fleet Report template below)
|
|
135
|
+
|
|
112
136
|
## Report Generation
|
|
113
137
|
|
|
114
138
|
After completing relevant procedures, generate a report following the templates in `references/reporting-templates.md`:
|
|
@@ -155,6 +179,31 @@ After completing relevant procedures, generate a report following the templates
|
|
|
155
179
|
3. [Third priority]
|
|
156
180
|
```
|
|
157
181
|
|
|
182
|
+
### Fleet Report Template
|
|
183
|
+
|
|
184
|
+
```
|
|
185
|
+
## Fleet Health Report
|
|
186
|
+
**Date:** [date] | **Sites:** [count] | **Scope:** [full / quick]
|
|
187
|
+
|
|
188
|
+
### Fleet Overview
|
|
189
|
+
| Site | Uptime | Performance | Security | Content | Overall |
|
|
190
|
+
|------|--------|-------------|----------|---------|---------|
|
|
191
|
+
| [site-1] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] |
|
|
192
|
+
| [site-2] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] |
|
|
193
|
+
|
|
194
|
+
### Fleet Summary
|
|
195
|
+
- **Healthy sites:** X/N
|
|
196
|
+
- **Degraded sites:** X/N (list)
|
|
197
|
+
- **Critical sites:** X/N (list)
|
|
198
|
+
|
|
199
|
+
### Cross-Site Patterns
|
|
200
|
+
[findings or "No cross-site patterns detected"]
|
|
201
|
+
|
|
202
|
+
### Fleet Recommendations (Priority Order)
|
|
203
|
+
1. [Fleet-wide action]
|
|
204
|
+
2. [Site-specific action]
|
|
205
|
+
```
|
|
206
|
+
|
|
158
207
|
## Safety Rules
|
|
159
208
|
|
|
160
209
|
- **NEVER modify any site data** — this agent is strictly read-only
|
|
@@ -175,6 +224,7 @@ For issues found during monitoring:
|
|
|
175
224
|
| Content or SEO issues | `wp-content-strategist` agent |
|
|
176
225
|
| Plugin/deployment issues | `wp-deployment-engineer` agent |
|
|
177
226
|
| Infrastructure/hosting issues | `wp-site-manager` agent |
|
|
227
|
+
| Fleet-wide infrastructure issue | `wp-site-manager` agent (multi-site coordination) |
|
|
178
228
|
|
|
179
229
|
## Related Skills
|
|
180
230
|
|
package/docs/GUIDE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# WordPress Manager - Guida Completa per Utenti e Amministratori
|
|
2
2
|
|
|
3
|
-
**Versione:** 1.
|
|
3
|
+
**Versione:** 2.1.0
|
|
4
4
|
**Ultimo aggiornamento:** 2026-02-28
|
|
5
5
|
**Repository:** https://github.com/morrealev/wordpress-manager
|
|
6
6
|
|
|
@@ -53,6 +53,10 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
|
|
|
53
53
|
- **Audit accessibilita**: WCAG 2.2 AA, axe-core, pa11y, Lighthouse
|
|
54
54
|
- **Internazionalizzare**: PHP/JS gettext, .pot/.po/.mo workflow, RTL, WPML/Polylang
|
|
55
55
|
- **Architetture headless**: REST vs WPGraphQL, JWT auth, CORS, Next.js/Nuxt/Astro
|
|
56
|
+
- **Gestire WooCommerce**: prodotti, ordini, clienti, coupon, report vendite, configurazione store
|
|
57
|
+
- **Amministrare Multisite**: sub-site, network plugin, Super Admin, domain mapping
|
|
58
|
+
- **Configurare CI/CD**: GitHub Actions, GitLab CI, Bitbucket Pipelines, quality gates, deploy automatico
|
|
59
|
+
- **Monitorare siti**: uptime, performance baseline, security scanning, content integrity, alerting
|
|
56
60
|
|
|
57
61
|
### Requisiti
|
|
58
62
|
|
|
@@ -76,7 +80,7 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
|
|
|
76
80
|
wordpress-manager plugin
|
|
77
81
|
/ | \
|
|
78
82
|
Hostinger MCP WP REST Bridge WordPress.com MCP
|
|
79
|
-
(119 tool) (
|
|
83
|
+
(119 tool) (81 tool) (~15 tool)
|
|
80
84
|
| | |
|
|
81
85
|
Infrastruttura Contenuti + Siti hosted
|
|
82
86
|
DNS, SSL, VPS Plugin, Utenti su WordPress.com
|
|
@@ -89,12 +93,12 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
|
|
|
89
93
|
### Componenti del Plugin
|
|
90
94
|
|
|
91
95
|
```
|
|
92
|
-
wordpress-manager/ #
|
|
96
|
+
wordpress-manager/ # v2.1.0
|
|
93
97
|
+-- .claude-plugin/plugin.json # Manifest
|
|
94
98
|
+-- .mcp.json # Server MCP bundled
|
|
95
99
|
+-- LICENSE # MIT + GPL-2.0-or-later
|
|
96
100
|
+-- CHANGELOG.md # Cronologia versioni
|
|
97
|
-
+-- agents/ #
|
|
101
|
+
+-- agents/ # 11 agenti specializzati
|
|
98
102
|
| +-- wp-site-manager.md # Orchestratore centrale
|
|
99
103
|
| +-- wp-deployment-engineer.md # Specialista deploy
|
|
100
104
|
| +-- wp-content-strategist.md # Contenuti e SEO
|
|
@@ -103,9 +107,12 @@ wordpress-manager/ # v1.7.1
|
|
|
103
107
|
| +-- wp-performance-optimizer.md # Performance e CWV
|
|
104
108
|
| +-- wp-test-engineer.md # Testing (E2E, unit, integration)
|
|
105
109
|
| +-- wp-accessibility-auditor.md # WCAG 2.2 AA audit (read-only)
|
|
110
|
+
| +-- wp-ecommerce-manager.md # WooCommerce store management (v1.8.0)
|
|
111
|
+
| +-- wp-cicd-engineer.md # CI/CD pipeline specialist (v2.0.0)
|
|
112
|
+
| +-- wp-monitoring-agent.md # Site monitoring read-only (v2.1.0)
|
|
106
113
|
+-- commands/ # 5 slash commands
|
|
107
114
|
| +-- wp-status.md / wp-deploy.md / wp-audit.md / wp-backup.md / wp-setup.md
|
|
108
|
-
+-- skills/ #
|
|
115
|
+
+-- skills/ # 28 skill totali
|
|
109
116
|
| +-- [OPERATIVE - 5 skill]
|
|
110
117
|
| +-- wp-deploy/ # Procedure deploy
|
|
111
118
|
| +-- wp-audit/ # Checklist audit
|
|
@@ -115,7 +122,7 @@ wordpress-manager/ # v1.7.1
|
|
|
115
122
|
| +-- [AMBIENTE LOCALE - 1 skill]
|
|
116
123
|
| +-- wp-local-env/ # Studio/LocalWP/wp-env
|
|
117
124
|
| +-- [SVILUPPO - 13 skill da WordPress/agent-skills]
|
|
118
|
-
| +-- wordpress-router/ # Router unificato
|
|
125
|
+
| +-- wordpress-router/ # Router unificato v8 (dev + local + ops + multisite + cicd + monitoring)
|
|
119
126
|
| +-- wp-project-triage/ # Auto-detect tipo progetto
|
|
120
127
|
| +-- wp-block-development/ # Blocchi Gutenberg
|
|
121
128
|
| +-- wp-block-themes/ # Temi a blocchi
|
|
@@ -134,6 +141,11 @@ wordpress-manager/ # v1.7.1
|
|
|
134
141
|
| +-- wp-i18n/ # Internazionalizzazione
|
|
135
142
|
| +-- wp-accessibility/ # WCAG 2.2 accessibilita
|
|
136
143
|
| +-- wp-headless/ # Architettura headless/decoupled
|
|
144
|
+
| +-- [E-COMMERCE + INFRASTRUTTURA - 4 skill]
|
|
145
|
+
| +-- wp-woocommerce/ # WooCommerce store management (v1.8.0)
|
|
146
|
+
| +-- wp-multisite/ # Multisite network management (v1.9.0)
|
|
147
|
+
| +-- wp-cicd/ # CI/CD pipeline automation (v2.0.0)
|
|
148
|
+
| +-- wp-monitoring/ # Site monitoring e observability (v2.1.0)
|
|
137
149
|
+-- hooks/ # 6 hook di sicurezza
|
|
138
150
|
| +-- hooks.json # 4 prompt + 2 command
|
|
139
151
|
| +-- scripts/ # Script per hook command-type
|
|
@@ -313,6 +325,10 @@ WordPress Manager comprende richieste in linguaggio naturale. Ecco come formular
|
|
|
313
325
|
| Audit accessibilita | "Controlla l'accessibilita" / "WCAG audit" |
|
|
314
326
|
| Internazionalizzare | "Internazionalizza il plugin" / "Traduci il tema" |
|
|
315
327
|
| Setup headless | "WordPress headless con Next.js" / "Configura WPGraphQL" |
|
|
328
|
+
| Gestire WooCommerce | "Mostra gli ordini" / "Crea un prodotto" / "Report vendite" |
|
|
329
|
+
| Amministrare Multisite | "Crea un sub-site" / "Network activate plugin" / "Super Admin" |
|
|
330
|
+
| Configurare CI/CD | "Setup GitHub Actions" / "CI per il mio plugin" / "Deploy automatico" |
|
|
331
|
+
| Monitorare il sito | "Monitora il sito" / "Health report" / "Setup uptime check" |
|
|
316
332
|
|
|
317
333
|
---
|
|
318
334
|
|
|
@@ -476,7 +492,7 @@ I comandi slash sono scorciatoie dirette per operazioni specifiche. Si invocano
|
|
|
476
492
|
|
|
477
493
|
Gli agenti sono "personalita" specializzate di Claude che vengono attivate automaticamente in base al contesto della conversazione. Non devi invocarli manualmente - Claude sceglie l'agente giusto per il compito.
|
|
478
494
|
|
|
479
|
-
Il plugin include **
|
|
495
|
+
Il plugin include **11 agenti** organizzati per area di competenza. Alcuni agenti lavorano in coppia (audit → fix) o in modalita read-only (monitoraggio).
|
|
480
496
|
|
|
481
497
|
### wp-site-manager (Orchestratore)
|
|
482
498
|
|
|
@@ -697,14 +713,101 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
|
|
|
697
713
|
|
|
698
714
|
---
|
|
699
715
|
|
|
716
|
+
### wp-ecommerce-manager (WooCommerce)
|
|
717
|
+
|
|
718
|
+
| Proprieta | Valore |
|
|
719
|
+
|-----------|--------|
|
|
720
|
+
| Colore | Orange |
|
|
721
|
+
| Ruolo | Gestione completa store WooCommerce |
|
|
722
|
+
| Attivazione | "Mostra gli ordini", "crea un prodotto", "report vendite", "coupon", "WooCommerce" |
|
|
723
|
+
|
|
724
|
+
**Capacita** (30 tool MCP via WP REST Bridge, namespace `wc/v3`):
|
|
725
|
+
|
|
726
|
+
| Area | Tool | Operazioni |
|
|
727
|
+
|------|------|-----------|
|
|
728
|
+
| Products | 7 | CRUD prodotti, categorie, variazioni |
|
|
729
|
+
| Orders | 6 | Lista ordini, aggiorna stato, note, rimborsi |
|
|
730
|
+
| Customers | 4 | Gestione clienti, profili, cronologia |
|
|
731
|
+
| Coupons | 4 | Creazione coupon, marketing promozioni |
|
|
732
|
+
| Reports | 5 | Vendite, top seller, totali ordini/prodotti/clienti |
|
|
733
|
+
| Settings | 4 | Gateway pagamento, zone spedizione, tasse, system status |
|
|
734
|
+
|
|
735
|
+
**Prerequisiti**: WooCommerce attivo + Consumer Key/Secret configurati in `WP_SITES_CONFIG` (generare da WooCommerce > Settings > Advanced > REST API).
|
|
736
|
+
|
|
737
|
+
**Skill correlata**: `wp-woocommerce`
|
|
738
|
+
|
|
739
|
+
---
|
|
740
|
+
|
|
741
|
+
### wp-cicd-engineer (CI/CD)
|
|
742
|
+
|
|
743
|
+
| Proprieta | Valore |
|
|
744
|
+
|-----------|--------|
|
|
745
|
+
| Colore | Cyan |
|
|
746
|
+
| Ruolo | Setup, configurazione e debug pipeline CI/CD |
|
|
747
|
+
| Attivazione | "Setup GitHub Actions", "CI per il plugin", "pipeline fallisce", "deploy automatico" |
|
|
748
|
+
|
|
749
|
+
**3 piattaforme supportate**:
|
|
750
|
+
|
|
751
|
+
| Piattaforma | Config | Best for |
|
|
752
|
+
|-------------|--------|----------|
|
|
753
|
+
| GitHub Actions | `.github/workflows/*.yml` | Plugin open-source, GitHub repos |
|
|
754
|
+
| GitLab CI | `.gitlab-ci.yml` | Enterprise, self-hosted GitLab |
|
|
755
|
+
| Bitbucket Pipelines | `bitbucket-pipelines.yml` | Team Atlassian |
|
|
756
|
+
|
|
757
|
+
**Pipeline WordPress tipica**:
|
|
758
|
+
1. **Lint**: PHP syntax, PHPCS code style
|
|
759
|
+
2. **Static Analysis**: PHPStan livello 6+
|
|
760
|
+
3. **Unit Test**: PHPUnit con WordPress test suite
|
|
761
|
+
4. **E2E Test**: Playwright con wp-env in Docker
|
|
762
|
+
5. **Deploy**: SSH/rsync o Hostinger MCP con rollback automatico
|
|
763
|
+
|
|
764
|
+
**Detection**: `cicd_inspect.mjs` rileva piattaforma CI, quality tool, wp-env, e genera raccomandazioni.
|
|
765
|
+
|
|
766
|
+
**Skill correlata**: `wp-cicd`
|
|
767
|
+
|
|
768
|
+
---
|
|
769
|
+
|
|
770
|
+
### wp-monitoring-agent (Monitoring)
|
|
771
|
+
|
|
772
|
+
| Proprieta | Valore |
|
|
773
|
+
|-----------|--------|
|
|
774
|
+
| Colore | Teal |
|
|
775
|
+
| Ruolo | Monitoring continuo del sito (read-only, non modifica nulla) |
|
|
776
|
+
| Attivazione | "Monitora il sito", "health report", "uptime check", "performance trend", "security scan periodico" |
|
|
777
|
+
|
|
778
|
+
**5 aree di monitoraggio**:
|
|
779
|
+
|
|
780
|
+
| Area | Cosa monitora |
|
|
781
|
+
|------|--------------|
|
|
782
|
+
| Uptime | HTTP status, response time, SSL expiry, WP-Cron |
|
|
783
|
+
| Performance | Core Web Vitals trend, TTFB, Lighthouse score |
|
|
784
|
+
| Security | Plugin vulnerabilita, file integrity, utenti anomali, malware patterns |
|
|
785
|
+
| Content | Modifiche non autorizzate, broken links, spam comments, media integrity |
|
|
786
|
+
| Alerting | Threshold P0-P3, notifiche email/Slack/webhook, escalation |
|
|
787
|
+
|
|
788
|
+
**Report disponibili**: Daily Health Summary, Weekly Performance, Monthly Security, Quarterly Trend, Executive Dashboard.
|
|
789
|
+
|
|
790
|
+
**Delegazione**: Quando rileva problemi, delega a agent specializzati:
|
|
791
|
+
- Sicurezza → `wp-security-auditor` + `wp-security-hardener`
|
|
792
|
+
- Performance → `wp-performance-optimizer`
|
|
793
|
+
- Contenuti → `wp-content-strategist`
|
|
794
|
+
- Deploy fix → `wp-deployment-engineer`
|
|
795
|
+
|
|
796
|
+
**Detection**: `monitoring_inspect.mjs` rileva setup monitoring esistente (uptime tools, Lighthouse CI, security plugins, logging config).
|
|
797
|
+
|
|
798
|
+
**Skill correlata**: `wp-monitoring`
|
|
799
|
+
|
|
800
|
+
---
|
|
801
|
+
|
|
700
802
|
### Pattern di Collaborazione tra Agent
|
|
701
803
|
|
|
702
804
|
| Pattern | Flusso | Descrizione |
|
|
703
805
|
|---------|--------|-------------|
|
|
704
806
|
| **Audit → Fix** | `wp-security-auditor` → `wp-security-hardener` | L'auditor trova problemi, l'hardener implementa le correzioni |
|
|
807
|
+
| **Monitor → Delegate** | `wp-monitoring-agent` → agent specializzati | Il monitoring rileva anomalie e delega agli agent competenti |
|
|
705
808
|
| **Delegazione** | `wp-site-manager` → tutti gli altri | Il site manager delega a agent specializzati in base al task |
|
|
706
809
|
|
|
707
|
-
Il `wp-site-manager` puo delegare a tutti gli
|
|
810
|
+
Il `wp-site-manager` puo delegare a tutti gli 11 agent specializzati:
|
|
708
811
|
|
|
709
812
|
| Task | Agent delegato |
|
|
710
813
|
|------|---------------|
|
|
@@ -715,6 +818,9 @@ Il `wp-site-manager` puo delegare a tutti gli 8 agent specializzati:
|
|
|
715
818
|
| Performance, CWV | `wp-performance-optimizer` |
|
|
716
819
|
| Testing | `wp-test-engineer` |
|
|
717
820
|
| Accessibilita | `wp-accessibility-auditor` |
|
|
821
|
+
| WooCommerce, e-commerce | `wp-ecommerce-manager` |
|
|
822
|
+
| CI/CD pipeline | `wp-cicd-engineer` |
|
|
823
|
+
| Site monitoring e health reports | `wp-monitoring-agent` |
|
|
718
824
|
|
|
719
825
|
---
|
|
720
826
|
|
|
@@ -752,10 +858,11 @@ Le skill di sviluppo provengono da due fonti:
|
|
|
752
858
|
|
|
753
859
|
- **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.
|
|
754
860
|
- **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.
|
|
755
862
|
|
|
756
863
|
### Il Router Unificato
|
|
757
864
|
|
|
758
|
-
La skill `wordpress-router` (
|
|
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.
|
|
759
866
|
|
|
760
867
|
```
|
|
761
868
|
Utente: "Crea un blocco custom per la gallery"
|
|
@@ -791,6 +898,30 @@ wordpress-router: TASK = sviluppo (testing)
|
|
|
791
898
|
wp-e2e-testing skill + wp-test-engineer agent
|
|
792
899
|
```
|
|
793
900
|
|
|
901
|
+
```
|
|
902
|
+
Utente: "Mostrami gli ordini WooCommerce di questa settimana"
|
|
903
|
+
|
|
|
904
|
+
wordpress-router: TASK = operativo (e-commerce)
|
|
905
|
+
|
|
|
906
|
+
wp-woocommerce skill + wp-ecommerce-manager agent
|
|
907
|
+
```
|
|
908
|
+
|
|
909
|
+
```
|
|
910
|
+
Utente: "Setup GitHub Actions per il mio plugin WordPress"
|
|
911
|
+
|
|
|
912
|
+
wordpress-router: TASK = sviluppo (CI/CD)
|
|
913
|
+
|
|
|
914
|
+
wp-cicd skill + wp-cicd-engineer agent
|
|
915
|
+
```
|
|
916
|
+
|
|
917
|
+
```
|
|
918
|
+
Utente: "Configura il monitoring del sito con alerting"
|
|
919
|
+
|
|
|
920
|
+
wordpress-router: TASK = operativo (monitoring)
|
|
921
|
+
|
|
|
922
|
+
wp-monitoring skill + wp-monitoring-agent agent
|
|
923
|
+
```
|
|
924
|
+
|
|
794
925
|
### Panoramica Skills di Sviluppo — Community (13)
|
|
795
926
|
|
|
796
927
|
| Skill | Si attiva quando... | Risorse |
|
|
@@ -823,9 +954,20 @@ Aggiunte in v1.6.0, queste skill coprono aree avanzate dello sviluppo WordPress.
|
|
|
823
954
|
|
|
824
955
|
**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.
|
|
825
956
|
|
|
957
|
+
### Panoramica Skills E-Commerce + Infrastruttura (4)
|
|
958
|
+
|
|
959
|
+
Aggiunte in v1.8.0-v2.1.0, queste skill coprono e-commerce, multisite, CI/CD e monitoring.
|
|
960
|
+
|
|
961
|
+
| Skill | Si attiva quando... | Risorse | Agent dedicato |
|
|
962
|
+
|-------|---------------------|---------|----------------|
|
|
963
|
+
| `wp-woocommerce` | "prodotti", "ordini", "WooCommerce", "coupon", "report vendite" | 6 reference files, woocommerce_inspect.mjs | `wp-ecommerce-manager` |
|
|
964
|
+
| `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` |
|
|
967
|
+
|
|
826
968
|
### Script di Rilevamento Automatico
|
|
827
969
|
|
|
828
|
-
Le skill includono
|
|
970
|
+
Le skill includono 16 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
|
|
829
971
|
|
|
830
972
|
| Script | Cosa rileva |
|
|
831
973
|
|--------|-------------|
|
|
@@ -841,6 +983,10 @@ Le skill includono 12 script Node.js (`.mjs`) che eseguono analisi automatica de
|
|
|
841
983
|
| `security_inspect.mjs` | wp-config constants, permessi file, .htaccess, plugin sicurezza (v1.6.0) |
|
|
842
984
|
| `i18n_inspect.mjs` | Text domain, file .pot/.po/.mo, funzioni i18n PHP/JS (v1.6.0) |
|
|
843
985
|
| `headless_inspect.mjs` | WPGraphQL, CORS config, framework frontend (v1.6.0) |
|
|
986
|
+
| `woocommerce_inspect.mjs` | WooCommerce attivo, API keys, prodotti, ordini, gateway (v1.8.0) |
|
|
987
|
+
| `multisite_inspect.mjs` | Multisite abilitato, sub-sites, network plugins, Super Admin (v1.9.0) |
|
|
988
|
+
| `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) |
|
|
844
990
|
|
|
845
991
|
### WordPress Playground — Ambienti Disposable
|
|
846
992
|
|
|
@@ -875,7 +1021,7 @@ Senza il server MCP, la skill usa conoscenza generale di `@wordpress/components`
|
|
|
875
1021
|
```
|
|
876
1022
|
1. cd mio-progetto-wordpress/
|
|
877
1023
|
2. Claude esegue wp-project-triage → rileva "wp-block-plugin"
|
|
878
|
-
3. wordpress-router
|
|
1024
|
+
3. wordpress-router v8 → instrada a wp-block-development
|
|
879
1025
|
4. Claude guida la creazione con block.json, edit.js, save.js
|
|
880
1026
|
5. wp-e2e-testing + wp-test-engineer → esegue test E2E con Playwright
|
|
881
1027
|
6. wp-accessibility + wp-accessibility-auditor → verifica WCAG 2.2
|
|
@@ -1009,9 +1155,9 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
|
|
|
1009
1155
|
| Sorgente | Custom TypeScript server in `servers/wp-rest-bridge/` |
|
|
1010
1156
|
| Trasporto | stdio (JSON-RPC via stdin/stdout) |
|
|
1011
1157
|
| Autenticazione | `WP_SITES_CONFIG` JSON env var |
|
|
1012
|
-
| Tool disponibili | 40 |
|
|
1158
|
+
| Tool disponibili | 81 (40 WordPress + 30 WooCommerce + 11 Multisite) |
|
|
1013
1159
|
|
|
1014
|
-
**Categorie tool
|
|
1160
|
+
**Categorie tool WordPress** (`wp/v2`):
|
|
1015
1161
|
|
|
1016
1162
|
| Categoria | Tool | Esempio |
|
|
1017
1163
|
|-----------|------|---------|
|
|
@@ -1024,6 +1170,26 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
|
|
|
1024
1170
|
| Media | 4 | `list_media`, `create_media`, `delete_media` |
|
|
1025
1171
|
| WP.org | 2 | `search_plugin_repository`, `get_plugin_details` |
|
|
1026
1172
|
|
|
1173
|
+
**Categorie tool WooCommerce** (`wc/v3`, richiede Consumer Key/Secret):
|
|
1174
|
+
|
|
1175
|
+
| Categoria | Tool | Esempio |
|
|
1176
|
+
|-----------|------|---------|
|
|
1177
|
+
| Products | 7 | `wc_list_products`, `wc_create_product`, `wc_list_product_variations` |
|
|
1178
|
+
| Orders | 6 | `wc_list_orders`, `wc_update_order_status`, `wc_create_refund` |
|
|
1179
|
+
| Customers | 4 | `wc_list_customers`, `wc_get_customer`, `wc_update_customer` |
|
|
1180
|
+
| Coupons | 4 | `wc_list_coupons`, `wc_create_coupon`, `wc_delete_coupon` |
|
|
1181
|
+
| Reports | 5 | `wc_get_sales_report`, `wc_get_top_sellers`, `wc_get_orders_totals` |
|
|
1182
|
+
| Settings | 4 | `wc_list_payment_gateways`, `wc_list_shipping_zones`, `wc_get_system_status` |
|
|
1183
|
+
|
|
1184
|
+
**Categorie tool Multisite** (`ms_` prefix, richiede `is_multisite: true` + SSH/WP-CLI):
|
|
1185
|
+
|
|
1186
|
+
| Categoria | Tool | Esempio |
|
|
1187
|
+
|-----------|------|---------|
|
|
1188
|
+
| Sub-sites | 4 | `ms_list_sites`, `ms_create_site`, `ms_activate_site`, `ms_deactivate_site` |
|
|
1189
|
+
| Network Plugins | 3 | `ms_network_activate`, `ms_network_deactivate`, `ms_network_plugins` |
|
|
1190
|
+
| Admin | 2 | `ms_list_super_admins`, `ms_network_settings` |
|
|
1191
|
+
| DNS | 2 | `ms_domain_mapping`, `ms_site_url` |
|
|
1192
|
+
|
|
1027
1193
|
**Architettura multi-sito**: Il server mantiene una `Map<siteId, AxiosInstance>` dove ogni sito ha la propria istanza HTTP autenticata. Il cambio sito e istantaneo.
|
|
1028
1194
|
|
|
1029
1195
|
#### WordPress.com MCP
|
|
@@ -1245,7 +1411,49 @@ Claude (attiva skill wp-i18n):
|
|
|
1245
1411
|
6. Verifica supporto RTL se necessario
|
|
1246
1412
|
```
|
|
1247
1413
|
|
|
1248
|
-
### Scenario 12:
|
|
1414
|
+
### Scenario 12: Gestione Store WooCommerce
|
|
1415
|
+
|
|
1416
|
+
```
|
|
1417
|
+
Tu: "Mostrami gli ordini di questa settimana e crea un coupon sconto 20%"
|
|
1418
|
+
|
|
1419
|
+
Claude (attiva wp-ecommerce-manager + skill wp-woocommerce):
|
|
1420
|
+
1. Lista ordini con wc_list_orders (filtro ultimi 7 giorni)
|
|
1421
|
+
2. Mostra riepilogo: totale ordini, revenue, status breakdown
|
|
1422
|
+
3. Crea coupon con wc_create_coupon (20% sconto, tipo percentuale)
|
|
1423
|
+
4. Conferma codice coupon e condizioni d'uso
|
|
1424
|
+
-> Report: ordini settimanali + coupon creato
|
|
1425
|
+
```
|
|
1426
|
+
|
|
1427
|
+
### Scenario 13: Setup CI/CD per Plugin WordPress
|
|
1428
|
+
|
|
1429
|
+
```
|
|
1430
|
+
Tu: "Configura GitHub Actions per il mio plugin con PHPStan e Playwright"
|
|
1431
|
+
|
|
1432
|
+
Claude (attiva wp-cicd-engineer + skill wp-cicd):
|
|
1433
|
+
1. Detection con cicd_inspect.mjs (rileva PHPStan, Playwright, wp-env)
|
|
1434
|
+
2. Genera workflow YAML con 4 stage: lint, phpstan, phpunit, playwright
|
|
1435
|
+
3. Configura wp-env per E2E testing in Docker
|
|
1436
|
+
4. Imposta quality gates (coverage > 80%, PHPStan level 6)
|
|
1437
|
+
5. Aggiunge deploy stage condizionale (push to main)
|
|
1438
|
+
-> File: .github/workflows/ci.yml creato e spiegato
|
|
1439
|
+
```
|
|
1440
|
+
|
|
1441
|
+
### Scenario 14: Monitoring Continuo del Sito
|
|
1442
|
+
|
|
1443
|
+
```
|
|
1444
|
+
Tu: "Configura il monitoring completo per opencactus.com"
|
|
1445
|
+
|
|
1446
|
+
Claude (attiva wp-monitoring-agent + skill wp-monitoring):
|
|
1447
|
+
1. Detection con monitoring_inspect.mjs (rileva setup esistente)
|
|
1448
|
+
2. Baseline: cattura CWV attuali, TTFB, plugin count, DB size
|
|
1449
|
+
3. Uptime check: configura cron per HTTP probe ogni 5 minuti
|
|
1450
|
+
4. Security: schedule settimanale per plugin audit e file integrity
|
|
1451
|
+
5. Alerting: configura threshold P0-P3 con notifiche email/Slack
|
|
1452
|
+
6. Report template: configura Daily Health Summary + Weekly Performance
|
|
1453
|
+
-> Report: baseline stabilito, monitoring schedule configurato
|
|
1454
|
+
```
|
|
1455
|
+
|
|
1456
|
+
### Scenario 15: Architettura Headless con Next.js
|
|
1249
1457
|
|
|
1250
1458
|
```
|
|
1251
1459
|
Tu: "Voglio usare WordPress come CMS headless con Next.js"
|
|
@@ -1259,6 +1467,20 @@ Claude (attiva skill wp-headless):
|
|
|
1259
1467
|
6. Configura webhook per invalidazione cache
|
|
1260
1468
|
```
|
|
1261
1469
|
|
|
1470
|
+
### Scenario 16: WordPress Multisite Network
|
|
1471
|
+
|
|
1472
|
+
```
|
|
1473
|
+
Tu: "Crea un network multisite con 3 sub-site per i nostri brand"
|
|
1474
|
+
|
|
1475
|
+
Claude (attiva skill wp-multisite):
|
|
1476
|
+
1. Detection con multisite_inspect.mjs (multisite gia abilitato?)
|
|
1477
|
+
2. Se necessario, guida conversione single → multisite (wp-config.php + .htaccess)
|
|
1478
|
+
3. Crea 3 sub-site con ms_create_site
|
|
1479
|
+
4. Network-activate plugin comuni
|
|
1480
|
+
5. Configura domain mapping per ogni sub-site
|
|
1481
|
+
-> Report: network configurato con 3 sub-site attivi
|
|
1482
|
+
```
|
|
1483
|
+
|
|
1262
1484
|
---
|
|
1263
1485
|
|
|
1264
1486
|
## 14. Amministrazione Avanzata
|
|
@@ -1509,8 +1731,20 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
|
|
|
1509
1731
|
| **RTL** | Right-to-Left — supporto per lingue scritte da destra a sinistra (arabo, ebraico) |
|
|
1510
1732
|
| **WCAG** | Web Content Accessibility Guidelines — standard W3C per accessibilita web (target: 2.2 AA) |
|
|
1511
1733
|
| **WPGraphQL** | Plugin WordPress che espone un'API GraphQL come alternativa alla REST API |
|
|
1734
|
+
| **WooCommerce** | Plugin e-commerce per WordPress; il WP REST Bridge espone 30 tool via namespace `wc/v3` |
|
|
1735
|
+
| **Consumer Key/Secret** | Credenziali API WooCommerce per accesso REST (`wc/v3`), generate da WooCommerce > Settings > REST API |
|
|
1736
|
+
| **Multisite** | Funzionalita WordPress per gestire una rete di siti da una singola installazione (Network Admin) |
|
|
1737
|
+
| **Super Admin** | Ruolo utente WordPress con accesso a tutte le operazioni del network multisite |
|
|
1738
|
+
| **Domain Mapping** | Associazione di un dominio custom a un sub-site del network multisite |
|
|
1739
|
+
| **CI/CD** | Continuous Integration / Continuous Deployment — pipeline automatizzate per build, test e deploy |
|
|
1740
|
+
| **GitHub Actions** | Piattaforma CI/CD integrata in GitHub, configurata via file YAML in `.github/workflows/` |
|
|
1741
|
+
| **Quality Gate** | Soglia di qualita in una pipeline CI (es. PHPStan level 6, coverage > 80%) che blocca il deploy se non superata |
|
|
1742
|
+
| **Monitoring** | Osservabilita continua del sito: uptime, performance trend, security scan, content integrity |
|
|
1743
|
+
| **Baseline** | Snapshot iniziale delle metriche (CWV, TTFB, plugin count) usato come riferimento per trend analysis |
|
|
1744
|
+
| **P0-P3** | Livelli di severity per alerting: P0 critico (sito down), P1 alto, P2 medio, P3 informativo |
|
|
1745
|
+
| **TTFB** | Time To First Byte — tempo tra la richiesta HTTP e il primo byte di risposta dal server |
|
|
1512
1746
|
|
|
1513
1747
|
---
|
|
1514
1748
|
|
|
1515
|
-
*Guida
|
|
1749
|
+
*Guida v2.1.0 - WordPress Manager Plugin per Claude Code*
|
|
1516
1750
|
*Ultimo aggiornamento: 2026-02-28*
|