claude-plugin-wordpress-manager 1.4.0

package/skills/wp-content/references/content-templates.md

@@ -0,0 +1,230 @@
+# WordPress Content Templates
+
+## Blog Post Template
+
+### Standard Blog Post (800-1500 words)
+
+```
+Title: [Primary Keyword] — [Compelling Hook]
+Slug: primary-keyword-phrase
+Excerpt: [Meta description, 120-160 chars, includes keyword and CTA]
+Categories: [1 primary category]
+Tags: [3-5 specific tags]
+Featured Image: [Relevant, optimized, with alt text]
+
+---
+
+[Opening paragraph — hook the reader, include primary keyword in first 2 sentences]
+
+## [H2: First Major Point — include secondary keyword]
+
+[2-3 paragraphs expanding the point]
+
+[Image or list to break up text]
+
+## [H2: Second Major Point — include secondary keyword]
+
+[2-3 paragraphs]
+
+### [H3: Supporting detail if needed]
+
+[1-2 paragraphs]
+
+## [H2: Third Major Point]
+
+[2-3 paragraphs]
+
+## Conclusion
+
+[Summary of key points]
+
+[Call to action — what should the reader do next?]
+
+[Internal link to related content]
+```
+
+### Listicle Post (600-1200 words)
+
+```
+Title: [Number] [Keyword] [Benefit/Hook]
+Example: "7 Benefits of Cactus Water for Daily Hydration"
+
+---
+
+[Intro paragraph — what will the reader learn?]
+
+## 1. [First Item — strongest/most interesting]
+
+[2-3 sentences explaining]
+
+## 2. [Second Item]
+
+[2-3 sentences]
+
+[... continue for all items ...]
+
+## Final Thoughts
+
+[Brief summary + CTA]
+```
+
+### How-To Guide (1000-2000 words)
+
+```
+Title: How to [Achieve Goal] — [Clarifying Detail]
+Example: "How to Set Up WordPress Caching — A Complete Guide"
+
+---
+
+[Intro — what problem does this solve?]
+
+## What You'll Need
+
+- [Prerequisite 1]
+- [Prerequisite 2]
+
+## Step 1: [First Action]
+
+[Detailed explanation with screenshots if applicable]
+
+## Step 2: [Second Action]
+
+[Detailed explanation]
+
+[... continue for all steps ...]
+
+## Troubleshooting
+
+### [Common Issue 1]
+[Solution]
+
+### [Common Issue 2]
+[Solution]
+
+## Summary
+
+[Recap of steps + link to related guides]
+```
+
+## Page Templates
+
+### Landing Page
+
+```
+Title: [Product/Service Name] — [Value Proposition]
+Slug: product-or-service-name
+
+---
+
+[Hero Section]
+# [Headline with primary keyword]
+[Subheadline — key benefit in 1 sentence]
+[CTA Button]
+
+[Social Proof]
+## Trusted by [X] customers
+[Testimonials or logos]
+
+[Features/Benefits]
+## Why Choose [Product]
+### [Benefit 1]
+[Brief explanation]
+
+### [Benefit 2]
+[Brief explanation]
+
+### [Benefit 3]
+[Brief explanation]
+
+[Detailed Explanation]
+## How It Works
+[Step-by-step or detailed description]
+
+[FAQ Section]
+## Frequently Asked Questions
+### [Question 1]
+[Answer]
+
+[Final CTA]
+## Get Started Today
+[CTA with urgency or benefit reminder]
+```
+
+### About Page
+
+```
+Title: About [Company/Brand Name]
+Slug: about
+
+---
+
+## Our Story
+[Origin story — authentic, concise]
+
+## Our Mission
+[Mission statement — 1-2 sentences]
+
+## Our Values
+### [Value 1]
+[Brief explanation]
+### [Value 2]
+[Brief explanation]
+
+## The Team
+[Team member profiles with photos]
+
+## Contact Us
+[Link to contact page]
+```
+
+## Custom Post Type Content
+
+### Product Page (for WooCommerce or custom CPT)
+
+```
+Title: [Product Name] — [Key Feature]
+Slug: product-name
+
+---
+
+[Product Image Gallery]
+
+## [Product Name]
+[1-2 sentence product summary]
+
+### Key Features
+- [Feature 1]
+- [Feature 2]
+- [Feature 3]
+
+### Ingredients / Specifications
+[Detailed specs table]
+
+### How to Use
+[Usage instructions]
+
+### Reviews
+[Customer reviews section]
+
+[CTA: Add to Cart / Buy Now]
+```
+
+## Content Quality Checklist
+
+Before publishing any content:
+
+- [ ] Title includes primary keyword (under 60 chars)
+- [ ] Excerpt/meta description set (120-160 chars)
+- [ ] Clean slug with keyword
+- [ ] H1 is unique on the page
+- [ ] H2/H3 hierarchy is logical
+- [ ] Primary keyword in first paragraph
+- [ ] At least 2 internal links
+- [ ] At least 1 external link to authority source
+- [ ] All images have alt text
+- [ ] Featured image set
+- [ ] Category assigned (not "Uncategorized")
+- [ ] 3-5 relevant tags assigned
+- [ ] Content length meets minimum (300+ for posts, 500+ for pillar)
+- [ ] Proofread for spelling and grammar
+- [ ] CTA present

package/skills/wp-content/references/seo-optimization.md

@@ -0,0 +1,169 @@
+# On-Page SEO Optimization Patterns for WordPress
+
+## Title Tag Optimization
+
+### Formula
+```
+[Primary Keyword] — [Benefit/Hook] | [Brand Name]
+```
+
+### Rules
+- Maximum 60 characters (Google truncates at ~60)
+- Primary keyword at the beginning
+- Brand name at the end (optional, adds trust)
+- Each page title must be unique across the site
+- Avoid keyword stuffing
+
+### Examples
+- Good: "Cactus Water Benefits — Zero Calorie Hydration | DolceZero"
+- Bad: "Cactus Water Benefits | Best Cactus Water | Buy Cactus Water"
+
+## Meta Description (Excerpt)
+
+### Formula
+```
+[Action verb] [what the user gets]. [Key detail]. [CTA].
+```
+
+### Rules
+- 120-160 characters (Google truncates at ~160)
+- Include primary keyword naturally
+- Include a call to action
+- Make it compelling (this is your "ad copy" in search results)
+- Each page must have a unique meta description
+
+### Examples
+- Good: "Discover the natural benefits of Sicilian cactus water. Zero calories, rich in antioxidants. Try DolceZero today."
+- Bad: "Welcome to our website. We sell cactus water products. Click here."
+
+## URL Slug Optimization
+
+### Rules
+- Use lowercase, hyphens between words
+- Include primary keyword
+- Remove stop words (a, the, in, of, for, etc.)
+- Keep under 75 characters
+- Never change an existing indexed slug (use 301 redirect)
+
+### Examples
+- Good: `/cactus-water-benefits`
+- Bad: `/the-amazing-benefits-of-drinking-cactus-water-for-your-health-2026`
+
+## Heading Hierarchy
+
+### Structure
+```
+H1: Page title (1 per page, contains primary keyword)
+  H2: Major sections (2-6 per page, secondary keywords)
+    H3: Sub-sections (as needed, long-tail keywords)
+      H4: Detail level (rarely needed)
+```
+
+### Rules
+- Only one H1 per page
+- Never skip heading levels (H1 → H3 without H2)
+- Headings should outline the content (scannable)
+- Include keywords naturally (don't force)
+
+## Internal Linking Strategy
+
+### Pillar-Cluster Model
+```
+Pillar Page (broad topic, 2000+ words)
+├── Cluster Post 1 (specific subtopic)
+├── Cluster Post 2 (specific subtopic)
+├── Cluster Post 3 (specific subtopic)
+└── Cluster Post 4 (specific subtopic)
+
+All cluster posts link to pillar page
+Pillar page links to all cluster posts
+Cluster posts link to each other where relevant
+```
+
+### Link Placement Rules
+- 2-3 internal links per 1000 words minimum
+- Anchor text should be descriptive (not "click here")
+- Link to relevant, high-value pages
+- Link to newer content from older content (update older posts)
+- Place important links above the fold
+
+## Image SEO
+
+### File Naming
+```
+Good: cactus-water-bottle-dolcezero.webp
+Bad: IMG_20260226_123456.jpg
+```
+
+### Alt Text
+```
+Good: "DolceZero cactus water bottle in three sweetness levels"
+Bad: "image" or "" (empty)
+```
+
+### Optimization
+- Format: WebP preferred (40-60% smaller than JPEG)
+- Max width: 1200px for full-width, 800px for in-content
+- Max file size: 200KB for hero, 100KB for in-content
+- Always include width and height attributes (prevents CLS)
+
+## Structured Data for WordPress
+
+### Article Schema (blog posts)
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "Article",
+  "headline": "Title",
+  "author": { "@type": "Person", "name": "Author" },
+  "datePublished": "2026-02-26",
+  "image": "featured-image-url"
+}
+```
+
+### Product Schema (product pages)
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "Product",
+  "name": "Product Name",
+  "description": "Product description",
+  "offers": {
+    "@type": "Offer",
+    "price": "9.99",
+    "priceCurrency": "EUR"
+  }
+}
+```
+
+### FAQ Schema (FAQ sections)
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "FAQPage",
+  "mainEntity": [{
+    "@type": "Question",
+    "name": "Question text?",
+    "acceptedAnswer": {
+      "@type": "Answer",
+      "text": "Answer text."
+    }
+  }]
+}
+```
+
+Most SEO plugins (Yoast, Rank Math) generate structured data automatically. Verify with Google Rich Results Test.
+
+## Content Freshness
+
+### Update Strategy
+- Review and update top-performing posts every 6 months
+- Update statistics and data references annually
+- Add new sections to pillar content as topics evolve
+- Re-optimize meta descriptions for underperforming pages
+- Update internal links when publishing new related content
+
+### Signals to Search Engines
+- Modified date in schema (automatic in WordPress)
+- Meaningful content changes (not just date changes)
+- New sections, updated data, additional depth

package/skills/wp-deploy/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: wp-deploy
+description: This skill should be used when the user asks to "deploy a plugin",
+  "deploy a theme", "push to production", "deploy to WordPress", "deploy to Hostinger",
+  or mentions deployment of WordPress components. Provides step-by-step deployment
+  workflows for Hostinger-hosted and SSH-accessible WordPress sites.
+version: 1.0.0
+---
+
+# WordPress Deployment Skill
+
+## Overview
+
+Guides deployment of WordPress plugins, themes, and static sites to production servers. Supports Hostinger MCP (preferred for Hostinger hosting) and SSH/SFTP (universal).
+
+## When to Use
+
+- User asks to deploy a plugin or theme
+- User wants to push changes to a WordPress site
+- User needs to migrate a WordPress installation
+- User wants to set up a deployment pipeline
+
+## Deployment Decision Tree
+
+1. **Is the target Hostinger-hosted?**
+   - Yes → Use Hostinger MCP tools (`hosting_deployWordpressPlugin`, `hosting_deployWordpressTheme`)
+   - No → Use SSH/SFTP deployment
+
+2. **What are you deploying?**
+   - Plugin → Package plugin directory, deploy, activate
+   - Theme → Package theme directory, deploy, optionally activate
+   - Static site → Archive build output, deploy
+   - Full site → Export DB + files, use `hosting_importWordpressWebsite`
+
+## Pre-Deployment Steps
+
+1. **Verify files** - Check all required files exist and are valid
+2. **Check for secrets** - Ensure no credentials are in deployment files
+3. **Confirm target** - Verify which site and environment (staging/production)
+4. **Backup** - Ensure a rollback path exists
+
+## Post-Deployment Steps
+
+1. **Verify** - Check the deployed component appears in WordPress
+2. **Test** - Verify core functionality works
+3. **Report** - Summarize what was deployed and where
+
+## Additional Resources
+
+### Reference Files
+- **`references/hostinger-deploy.md`** - Hostinger MCP deployment details
+- **`references/ssh-deploy.md`** - SSH/SFTP deployment procedures

package/skills/wp-deploy/references/hostinger-deploy.md

@@ -0,0 +1,51 @@
+# Hostinger MCP Deployment Reference
+
+## Plugin Deployment
+
+### Tool: `hosting_deployWordpressPlugin`
+Deploys a WordPress plugin from a local directory to a Hostinger-hosted site.
+
+**Input:** Local directory path containing plugin files
+**Process:** Uploads all files, triggers server-side deployment
+**Post-deploy:** Use `activate_plugin` via WP REST Bridge to activate
+
+### Example workflow:
+```
+1. Verify plugin: php -l main-plugin-file.php
+2. Deploy: hosting_deployWordpressPlugin(directory)
+3. Verify: list_plugins → check plugin appears
+4. Activate: activate_plugin(plugin_slug)
+5. Test: visit site to confirm functionality
+```
+
+## Theme Deployment
+
+### Tool: `hosting_deployWordpressTheme`
+Deploys a WordPress theme from a local directory with optional activation.
+
+**Input:** Local directory path + optional activate flag
+**Process:** Uploads all theme files, triggers deployment, activates if requested
+
+### Required theme files:
+- `style.css` (with valid theme headers)
+- `index.php`
+- `functions.php` (recommended)
+
+## Static Site Deployment
+
+### Tool: `hosting_deployStaticWebsite`
+Deploys pre-built static HTML/CSS/JS from an archive.
+
+**Supported formats:** zip, tar, tar.gz, tgz
+**Process:** Upload archive → extract to web root → serve
+
+## Site Import
+
+### Tool: `hosting_importWordpressWebsite`
+Full WordPress site migration/restore.
+
+**Input:**
+- Archive file (zip/tar.gz) with WordPress files
+- SQL database dump file
+
+**WARNING:** This overwrites the existing installation.

package/skills/wp-deploy/references/ssh-deploy.md

@@ -0,0 +1,63 @@
+# SSH/SFTP Deployment Reference
+
+## Prerequisites
+
+1. SSH key configured in `~/.ssh/config`
+2. SSH access verified: `ssh user@host 'echo ok'`
+3. Know the WordPress installation path (typically `/home/user/htdocs/` on Hostinger)
+
+## Plugin Deployment via SSH
+
+```bash
+# 1. Package the plugin
+tar -czf /tmp/plugin-name.tar.gz -C /path/to/plugin-dir .
+
+# 2. Upload to server
+scp /tmp/plugin-name.tar.gz user@host:/tmp/
+
+# 3. Extract to plugins directory
+ssh user@host 'mkdir -p /path/to/wp-content/plugins/plugin-name && tar xzf /tmp/plugin-name.tar.gz -C /path/to/wp-content/plugins/plugin-name'
+
+# 4. Set correct permissions
+ssh user@host 'chmod -R 755 /path/to/wp-content/plugins/plugin-name'
+
+# 5. Clean up
+ssh user@host 'rm /tmp/plugin-name.tar.gz'
+rm /tmp/plugin-name.tar.gz
+```
+
+## Theme Deployment via SSH
+
+```bash
+# Same pattern as plugin but targeting themes directory
+tar -czf /tmp/theme-name.tar.gz -C /path/to/theme-dir .
+scp /tmp/theme-name.tar.gz user@host:/tmp/
+ssh user@host 'mkdir -p /path/to/wp-content/themes/theme-name && tar xzf /tmp/theme-name.tar.gz -C /path/to/wp-content/themes/theme-name'
+ssh user@host 'chmod -R 755 /path/to/wp-content/themes/theme-name'
+ssh user@host 'rm /tmp/theme-name.tar.gz'
+```
+
+## Hostinger-Specific Paths
+
+- Web root: `/home/<username>/htdocs/<domain>/`
+- Plugins: `/home/<username>/htdocs/<domain>/wp-content/plugins/`
+- Themes: `/home/<username>/htdocs/<domain>/wp-content/themes/`
+- Uploads: `/home/<username>/htdocs/<domain>/wp-content/uploads/`
+
+## SSH Config for Hostinger
+
+```
+Host opencactus-hostinger
+    HostName <ip-or-hostname>
+    User <hostinger-username>
+    IdentityFile ~/.ssh/hostinger_opencactus_20250904
+    IdentitiesOnly yes
+```
+
+## Rollback via SSH
+
+```bash
+# If you backed up before deploying:
+ssh user@host 'mv /path/to/wp-content/plugins/plugin-name /path/to/wp-content/plugins/plugin-name.broken'
+ssh user@host 'mv /path/to/wp-content/plugins/plugin-name.backup /path/to/wp-content/plugins/plugin-name'
+```