wordpress-publisher

# WordPress Publisher > **First time?** If `setup_complete: false` above, run `./SETUP.md` first, then set `setup_complete: true`. Publish content to WordPress with a two-step flow: draft first, then publish after user confirmation. ## Default Language: Hebrew **IMPORTANT:** Unless the user explicitly requests English or another language, create all blog posts in Hebrew with RTL formatting. Also generate images using the `image-generation` skill for: - Featured/hero image for the post - Internal images to illustrate concepts (instead of ASCII diagrams) Always wrap Hebrew content in: ```html <article dir="rtl" lang="he"> <!-- Hebrew content here --> </article> ``` ## Configuration Create `.env` file in the skill directory: ```bash # ~/.claude/skills/wordpress-publisher/.env WP_URL=https://your-site.com WP_USERNAME=your_username WP_APP_PASSWORD=YourApplicationPasswordNoSpaces ``` **Creating Application Password:** 1. Go to WordPress Admin → Users → Profile 2. Scroll to "Application Passwords" 3. Enter a name (e.g., "Claude Code") and click "Add New" 4. Copy the password and **remove all spaces** ## Usage ### Create Draft ```bash node ~/.claude/skills/wordpress-publisher/scripts/wp-publish.js create "Post Title" content.html ``` ### Create with Featured Image ```bash node ~/.claude/skills/wordpress-publisher/scripts/wp-publish.js create "Post Title" content.html --image=cover.jpg ``` ### Create and Publish Immediately ```bash node ~/.claude/skills/wordpress-publisher/scripts/wp-publish.js create "Post Title" content.html --publish ``` ### Publish Existing Draft ```bash node ~/.claude/skills/wordpress-publisher/scripts/wp-publish.js publish POST_ID ``` ### Check Post Status ```bash node ~/.claude/skills/wordpress-publisher/scripts/wp-publish.js status POST_ID ``` ### Read from stdin ```bash echo "<h1>Hello</h1>" | node ~/.claude/skills/wordpress-publisher/scripts/wp-publish.js create "Hello" - ``` ## Options | Option | Description | |--------|-------------| | `--publish` | Publish immediately (default: draft) | | `--image=<path>` | Featured image (uploaded to media library) | | `--excerpt=<text>` | Add excerpt | | `--categories=<ids>` | Category IDs (comma-separated) | | `--tags=<ids>` | Tag IDs (comma-separated) | ## Response Format ### After Creating Draft: ``` Draft created! **Post ID:** 123 **Edit in WordPress:** https://your-site.com/wp-admin/post.php?post=123&action=edit **Preview:** https://your-site.com/?p=123 Publish now or review first? ``` ### After Publishing: ``` Post is live! **URL:** https://your-site.com/your-post-slug/ ``` ## Error Handling | Error | Cause | Solution | |-------|-------|----------| | 401 Unauthorized | Wrong credentials | Check WP_USERNAME and WP_APP_PASSWORD | | 403 Forbidden | No permissions | Ensure user has Editor/Admin role | | 404 Not Found | Wrong URL or API disabled | Check WP_URL, enable REST API | ## Hebrew/RTL Content For Hebrew content, wrap in RTL container: ```html <article dir="rtl" lang="he"> <!-- Hebrew content here --> </article> ```