WP OPS

Tools, scripts, and guides for modern WordPress development & devops—optimized for Trellis/Bedrock workflows.

Contents

• Trellis
• Bedrock
• WP-CLI
• Nginx
• Scripts
• MCP Server
• WordPress Utilities
• Troubleshooting

Trellis

Tool	Description	Docs
Updater	Safely update Trellis while preserving custom configurations	→
Backup Tools	Ansible playbooks for database and files backup/push/pull	→
Provisioning	Common provisioning commands and workflows	→
New Machine Setup	Set up macOS for Trellis development	→
Project Setup	Clone and configure an existing Trellis/Bedrock project	→
Monitoring	Nginx log monitoring for traffic analysis and security threat detection	→
Security	fail2ban IP blocking and manual deny rules	→

Bedrock

Tool	Description	Docs
Local Package Development	Test an in-development plugin/theme branch in a Bedrock site via a Composer path repository, before tagging a release	→
WP-CLI Config	Standard wp-cli.yml for Bedrock path setup plus a wp pattern validate command for canonicalizing block pattern files	→

WP-CLI

Tool	Description	Docs
Content Creation	Automated page creation and content management workflows	→
Migration Tools	Migrate WordPress sites to Trellis/Bedrock (single and multi-site)	→
URL Update Methods	WordPress URL update methods for migrations	→
Diagnostics	Diagnostic tools for transients, caching, and performance	→
Security Scanners	Dual-scanner suite for malware detection and security auditing	→
SEO	SEO analysis and audit tools for page structure, redirects, schema markup, blog content, and orphan pages	→

Nginx

Tool	Description	Docs
Image Optimization	WebP/AVIF configuration with automatic format serving	→
Browser Caching	Optimal static asset caching configuration	→
Redirects	Redirect configuration for SEO and URL management	→

Scripts

Standalone Bash/PHP utilities — see scripts/README.md for full docs, flags, and examples.

Releases & GitHub

Tool	Description	Docs
PR Creation	AI-powered GitHub PR descriptions (Claude/Codex)	→
Plugin Release	AI-powered version bumping and changelog generation for plugins	→
Theme Release	AI-powered version bumping and changelog generation for themes	→
WordPress.org Deploy	Publish a plugin to the WordPress.org SVN directory	→
Release Asset Upload	Manually attach a zip to an existing GitHub release	→

Monitoring & Security

Tool	Description	Docs
Run Monitoring	Orchestrator: runs all monitors and generates a markdown summary	→
Traffic Monitor	Nginx traffic analysis with bot filtering and reporting	→
Security Monitor	Nginx threat detection with IP block recommendations	→
AI Bot Monitor	AI crawler traffic analysis (GPTBot, ClaudeBot, etc.)	→
404 Checker	Internal broken-link checker — homepage scan or recursive spider	→
Redirect Check	Mass URL redirect checker using curl	→
CF7 Smoke Test	Playwright post-deploy contact-form submission check	→
Updown Webhook	updown.io downtime alert handler + PHP receiver	→

Content & Backups

Tool	Description	Docs
Post Count	Count published blog posts by year/month (blog posts only, CPTs excluded)	→
DB Backup	Trellis-aware database backup with optional URL replacement	→
Site Backup	Full site backup (database + uploads + config + content)	→

Images, WooCommerce & Files

Tool	Description	Docs
Batch Resize	Batch resize + center-crop images for featured images	→
WebP Convert	JPG→WebP at the Facebook OG ratio with center crop	→
Product Variations	Bulk-create WooCommerce product variations via WP-CLI	→
Theme Sync	Rsync a theme between Trellis and a standalone repo	→
Find & Replace	Batch find and replace files across directory trees	→
Git Log Oneline	Show recent git commits as compact one-liners	→

MCP Server

Exposes wp-ops operations as MCP tools, so Claude (and other MCP-compatible clients) can call them directly instead of running the underlying scripts by hand. Scaffold stage — one tool implemented so far, more (backups, PR creation, releases, image optimization) planned. See mcp-server/README.md for setup, transports (stdio/Streamable HTTP), and Docker usage.

Tool	Description	Docs
security_scan	Run the wp-cli security scanners against a registered site/environment (local or over SSH)	→

WordPress Utilities

Tool	Description	Docs
Snippets	Self-contained PHP snippets ready to drop into themes or plugins	→
Age Verification	Cookie-based age verification with modal interface and ACF integration	→
Analytics	Google Analytics, Matomo implementation and detection	→
Speed Optimization	Performance testing and TTFB analysis with curl/wget	→

Troubleshooting

Tool	Description	Docs
Server Diagnostics	Diagnose PHP-FPM, MariaDB, and server issues	→

Requirements

• Core: Git, Bash, rsync
• Tool-specific: See individual docs for Ansible, WP-CLI, ImageMagick, etc.

License

MIT License. See LICENSE.md for details.

---

Copyright © Imagewize