Skip to content

changelog.md

Latest commit

 

History

History
113 lines (84 loc) · 9.47 KB

changelog.md

File metadata and controls

113 lines (84 loc) · 9.47 KB
Raw

Changelog

[1.4] - 2025-09-19

🚀 New Features

  • Automated Remote Site Snapshots disembark: A powerful new command that uses browser automation (Playwright) to remotely log into a WordPress site, install and activate the Disembark Connector plugin, retrieve a connection token, and initiate a backup. It's a complete, hands-off solution for snapshotting a remote site without prior access.
  • Debug Mode for Browser Automation --debug: The disembark command now includes a --debug flag to run the browser automation in a visible (headed) mode, making it easy to troubleshoot login or installation issues.

✨ Improvements

  • Selective Backups backup --exclude: The backup command now accepts multiple --exclude="<pattern>" flags, allowing you to easily omit specific files or directories (like large cache folders) from the backup archive.
  • Script-Friendly Backups backup --quiet: Added a --quiet flag to the backup command to suppress all informational output and print only the final backup URL, perfect for scripting and automation.
  • Contextual Performance Testing find slow-plugins: The find slow-plugins command can now test performance against a specific front-end page render (e.g., _do find slow-plugins /about-us) instead of just the WP-CLI bootstrap, providing more relevant and accurate results for front-end slowdowns.

[1.3] - 2025-08-16

🚀 New Features

  • Quick Archiving zip: A new utility to create a zip archive of any specified folder. When run within a WordPress site, it provides a public URL for the generated archive, making it easy to share.
  • Plugin Cleanup clean plugins: A new subcommand to find and delete all inactive plugins. It works safely on both single-site and multisite installations, only removing plugins that are not active anywhere in a network.

✨ Improvements

  • ⚡️ High-Speed Image Conversion convert-to-webp: The image conversion utility has been massively overhauled for performance and flexibility.
    • It now accepts an optional folder path to convert images outside the default wp-content/uploads directory.
    • Performance is dramatically improved by processing multiple images in parallel.
    • The script now provides clearer feedback by indicating which image detection method (identify or a PHP fallback) is being used.
  • Smarter Naming dump: The output file from the dump command is now intelligently named based on the source directory (e.g., my-plugin-dump.txt) for better organization.

🐛 Bug Fixes

  • Robust Image Handling convert-to-webp: The command is now more reliable, as it verifies that an image file exists before attempting to process it, preventing errors from broken file paths.

[1.2] - 2025-07-10

🚀 New Features

  • 🏦 Secure Snapshot Vault vault: A comprehensive suite of commands for managing secure, remote, full-site snapshots using Restic and Backblaze B2. Includes creating, listing, deleting, and browsing snapshots, as well as mounting the entire backup repository.
  • 🔍 Advanced Diagnostics find: Centralizes several diagnostic tools under a single powerful command.
    • find recent-files: Finds recently modified files.
    • find slow-plugins: Identifies plugins slowing down WP-CLI.
    • find hidden-plugins: Detects active plugins hidden from the admin list.
    • find malware: Scans for suspicious code and verifies file integrity.
    • find php-tags: Scans for outdated PHP short tags.
  • 🔌 Easy Plugin Installation install: Simplifies installing common helper and premium plugins.
    • install kinsta-mu: Installs the Kinsta Must-Use plugin.
    • install helper: Installs the CaptainCore Helper plugin.
    • install events-calendar-pro: Installs The Events Calendar Pro after prompting for a license.
  • New Standalone Utilities:
    • https: Applies HTTPS to all site URLs with an interactive prompt for www preference.
    • launch: A dedicated command to launch a site, updating the URL from a dev to a live domain.
    • upgrade: Allows the _do script to upgrade itself to the latest version.
    • email: Provides an interactive prompt to send an email using wp_mail via WP-CLI.
  • ⚙️ Database Prefix Changer db change-prefix: Safely changes the database table prefix after automatically creating a backup.

✨ Improvements

  • New Command Flags: Added several flags for non-interactive use and more control:
    • --all for convert-to-webp to convert all images regardless of size.
    • --domain for launch to specify the new domain for scripting.
    • --force for install kinsta-mu to bypass the Kinsta environment check.
    • --output for vault snapshots to provide a non-interactive list.
  • 🛠️ Advanced Dependency Sideloading: _do can now automatically download and use tools like restic, git, and imagemagick in a private directory if they aren't installed system-wide. The ImageMagick setup cleverly extracts the identify binary from an AppImage to avoid system installation and FUSE issues.
  • Reliable WebP Detection: The convert-to-webp command no longer requires a system-installed identify command. It now uses the automatically sideloaded ImageMagick binary and includes a PHP fallback to reliably check if an image is already a WebP file.
  • Command Organization: Refactored several commands into logical groups for better usability (e.g., reset-wp is now reset wp, slow-plugins is now find slow-plugins).
  • Private Directory Discovery: The script is now much smarter at finding a writable private directory, checking WP-CLI configs, WPEngine paths, and common parent structures (../private) before falling back to the home directory.
  • Public Dump URL: The dump command now generates a public URL for the created text file if run within a WordPress site.

🐛 Bug Fixes

  • Cross-Platform PHP Tag Scanning php-tags: Rewrote the command to use a more portable grep syntax, ensuring it works correctly on systems like macOS where the -P flag is not available by default.

[1.1] - 2025-06-21

🚀 New Features

  • 💾 Checkpoint Management checkpoint: A full suite to create, list, show, and revert WordPress installation checkpoints. Capture the state of your site's core, themes, and plugins and easily roll back changes.
  • 🔄 Integrated Update Management update: Streamlines the WordPress update process. update all automatically creates 'before' and 'after' checkpoints around the updates, logging all changes for easy review.
  • ⏰ Cron Job Management cron: Schedule any _do command to run at specific intervals. Includes commands to enable, list, add, delete, and run scheduled tasks.
  • 🩺 WP-CLI Health Checker wpcli: A new utility to diagnose issues with WP-CLI itself by identifying themes or plugins that cause warnings.
  • 💥 Site Reset reset-wp: A powerful command to reset a WordPress installation to its default state, reinstalling core and the latest default theme.
  • 🧹 Advanced Cleaning clean:
    • clean themes: Deletes all inactive themes while preserving the latest default WordPress theme.
    • clean disk: Launches an interactive disk usage analyzer to find and manage large files.
  • ⚙️ Database Optimization db optimize: A new command to convert tables to InnoDB, clean transients, and report the largest tables.

✨ Improvements

  • Command Structure: Refactored commands for better organization. backup-db is now db backup, and monitor is now a subcommand with specific targets (traffic, errors, etc.).
  • 🛠️ Automated Dependency Handling: The script now automatically checks for, downloads, and installs missing dependencies like gum, cwebp, and rclone into a ~/private directory.
  • 🏗️ Development Workflow: Added compile.sh and watch.sh scripts to streamline development by combining source files into a single distributable script automatically.
  • Flexible Migrations migrate: Added an --update-urls flag to control URL replacement and improved temporary file handling.
  • File Exclusion dump: The dump command was enhanced with an -x flag to exclude specific files or directories.

🐛 Bug Fixes

  • Migration File Handling: The migrate function now handles cases where wp-content exists but contains no plugins or themes, preventing errors.
  • Dump Self-Exclusion: The dump command now explicitly excludes its own output file to prevent it from being included in the dump.

[1.0] - 2025-06-10

🎉 Initial Release

  • Full and Database Backups backup, backup-db: Create full-site (files + DB) and database-only backups.
  • Real-time Traffic Monitoring monitor: Watch server access logs in real-time with a summarized view of top hits.
  • Performance Profiling slow-plugins: Identify WordPress plugins that slow down WP-CLI commands.
  • Image Optimization convert-to-webp: Find and convert large JPG/PNG images to the modern WebP format.
  • Site Migration migrate: Automate migrating a WordPress site from a backup URL or local file.
  • File Content Dumper dump: Concatenate the contents of files matching a pattern into a single text file.
  • Database Autoload Checker db-check-autoload: Check the size of autoloaded options in the database.
  • Permission Resetter reset-permissions: Reset file and folder permissions to standard defaults (755/644).
  • Site Suspension suspend: Activate or deactivate a "Website Suspended" maintenance page.