Safe Publish

Safe Publish is a WordPress plugin that allows editors to securely promote content from non-production environments (staging, development) to production. It provides a user-friendly interface for browsing, comparing, and importing posts, pages, and custom post types while preserving supported formatting, media, and REST-exposed metadata.

Features

• Secure Authentication: Required HMAC shared secret with optional basic authentication
• Content Compare: Compare an imported post with fresh source content side by side before updating it
• Bulk Import: Import multiple posts at once with progress tracking
• Media Handling: Automatically imports featured images and inline images
• Block Preservation: Maintains Gutenberg block formatting and structure
• Manage page: Browse source content, manage imports, review failures, and roll back changes
• Post Type Support: Works with posts, pages, and custom post types
• VIP-Safe: Built with WordPress VIP best practices and coding standards

Use Cases

Safe Publish is ideal for:

• Content Promotion Workflows: Move approved content from staging to production
• Editorial Review: Create and review content in a safe environment before going live
• Multi-Environment Publishing: Separate content creation from publication
• Compliance & Auditing: Track all content imports with detailed history
• Media-Rich Content: Seamlessly import posts with multiple images

Requirements

• PHP: 8.2 or higher
• WordPress: 6.9 or higher
• cURL: PHP cURL extension with SSL support
• Site URLs: HTTP or HTTPS; use HTTPS outside local development
• Administrator privileges on both source and destination sites

Installation

See the Quickstart Guide for detailed instructions.

Documentation

• Quickstart - Get started in minutes
• Core Concepts - Understand how the plugin works
  • Authentication - Setting up secure connections
  • Content Validation - Understanding validation checks
  • Import Process - How imports work step-by-step
  • Managing Imports - Browsing source content and managing imports
  • Audit Log - Reviewing logged events, including exports
• Extending - Customize the plugin
  • Hooks and Filters - Available WordPress hooks
  • Custom Post Types - Supporting custom post types
  • REST API Extension - Extending the API
• Local Development - Setting up a development environment
• Troubleshooting - Common issues and solutions

Contributing

Issues, pull requests, and discussions are welcome. Please see our contribution guide for more information.

Support

• Report bugs and request features via GitHub Issues
• Check the troubleshooting guide for common issues
• Review documentation for detailed information

Security

If you discover a security vulnerability, please email security@wpvip.com instead of using the issue tracker.

License

Safe Publish is licensed under the GPLv2 (or later).