WordPress Maintenance Automation

A secure, fast, and modular WP-CLI management system for maintaining multiple WordPress sites efficiently. This toolkit provides automated updates, database optimization, and maintenance operations across all your WordPress installations.

📋 Table of Contents

1. Features
2. Prerequisites
3. Installation
4. Configuration
5. Usage
   • 5.1 Basic Syntax
   • 5.2 Operation Modes
   • 5.3 Options
   • 5.4 Examples
6. How It Works
   • 6.1 User Detection
   • 6.2 Safe Execution
   • 6.3 Logging System
7. Troubleshooting
   • 7.1 Common Issues
   • 7.2 Debug Mode
8. Contributing
9. License
10. Acknowledgments
11. Author & Support

1. Features

• Multi-site Management: Automate maintenance across multiple WordPress installations
• Flexible Operation Modes: Choose specific maintenance tasks or run comprehensive updates
• Smart User Detection: Automatically determines correct system users for WP-CLI operations
• Comprehensive Logging: Detailed execution logs with color-coded output
• Automatic Discovery: Find WordPress installations automatically with the included discovery script
• Safe Operations: Built-in safety checks and error handling
• Database Optimization: Automatic database repair and optimization
• Cron Management: Run WordPress cron events efficiently
• Astra Pro Support: Specialized handling for Astra Pro plugin with license management
• Detailed Error Logging: Comprehensive error tracking in wp_cli_errors.log

2. Prerequisites

• Operating System: Linux (tested on CentOS, Ubuntu, Debian)
• Shell: Bash 4.0 or higher
• Permissions: Root access (for user switching)
• Dependencies:
  • WP-CLI installed at /usr/local/bin/wp
  • WordPress 3.7 or higher
  • Standard GNU core utilities

3. Installation

3.1 Download the Scripts

Clone the repository or download the scripts directly:

git clone https://github.com/paulmann/Bash_WP-CLI_Update.git
cd Bash_WP-CLI_Update

3.2 Set Execution Permissions

Important: Make both scripts executable:

chmod +x Bash_WP-CLI_Update.sh
chmod +x Find_WP_Senior.sh

3.3 Verify Script Interpreters

Check that the shebang lines at the top of each script point to correct shell paths:

• Bash_WP-CLI_Update.sh: Should have #!/usr/bin/env bash
• Find_WP_Senior.sh: Should have #!/bin/bash

Update if necessary for your system configuration.

3.4 Verify WP-CLI Installation

Ensure WP-CLI is installed at the expected location:

which wp
# Should return: /usr/local/bin/wp

If not installed, follow WP-CLI installation instructions.

4. Configuration

4.1 Automatic Site Discovery

Run the discovery script to automatically find WordPress installations:

./Find_WP_Senior.sh

This will create a wp-found.txt file with paths to all discovered WordPress installations.

4.2 Manual Site Configuration

If you prefer manual configuration, create or edit wp-found.txt:

nano wp-found.txt

Add one WordPress root directory per line:

/var/www/site1.com
/var/www/site2.com
/var/www/site3.com

4.3 Astra Pro License Configuration

For Astra Pro plugin support, configure your license key in the main script:

# Edit the script and set your Astra Pro license key
nano Bash_WP-CLI_Update.sh

# Locate and update the ASTRA_KEY constant:
readonly ASTRA_KEY="YOUR_ACTUAL_LICENSE_KEY_HERE"

5. Usage

5.1 Basic Syntax

./Bash_WP-CLI_Update.sh [MODE] [OPTIONS]

5.2 Operation Modes

Mode	Short	Description
--full	-f	Complete maintenance (core, plugins, themes, DB optimize/repair, cron)
--core	-c	Update WordPress core only
--plugins	-p	Update all plugins
--themes	-t	Update all themes
--db-optimize	-d	Optimize and repair database
--db-fix	-x	Repair database only
--cron	-r	Run due cron events
--astra	-s	Update Astra Pro plugin with license activation

5.3 Options

Option	Short	Description
--DEBUG	-D	Enable detailed debug logging

5.4 Examples

Update all plugins across all sites:

./Bash_WP-CLI_Update.sh --plugins
# or using short option
./Bash_WP-CLI_Update.sh -p

Run complete maintenance with debug output:

./Bash_WP-CLI_Update.sh --full --DEBUG
# or using short options
./Bash_WP-CLI_Update.sh -f -D

Optimize databases only:

./Bash_WP-CLI_Update.sh --db-optimize

Run WordPress cron events:

./Bash_WP-CLI_Update.sh --cron

Update Astra Pro plugin with license management:

./Bash_WP-CLI_Update.sh --astra

6. How It Works

6.1 User Detection

The script automatically determines the correct system user for each WordPress installation by checking:

1. File owner of wp-config.php
2. Directory owner of WordPress root
3. Path structure patterns
4. DB_USER from wp-config.php (fallback)

6.2 Safe Execution

• Runs WP-CLI commands as the correct system user
• Includes proper environment variables
• Skips problematic plugins during updates
• Provides comprehensive error handling

6.3 Logging System

Main Log (wp_cli_manager.log)

Structured logging with timestamps and color-coded console output:

• INFO - General operation information
• SUCCESS - Completed operations
• WARNING - Non-critical issues
• ERROR - Operation failures
• DEBUG - Detailed debugging information

Error Log (wp_cli_errors.log)

Detailed error logging for troubleshooting:

• Complete command context
• Full command output
• Exit codes and error details
• Timestamped error events

7. Troubleshooting

7.1 Common Issues

Script stops after "Processing site":

• Check that WP-CLI is installed at /usr/local/bin/wp
• Verify the WordPress user exists and has proper permissions
• Run with --DEBUG flag for detailed output

Permission denied errors:

• Ensure scripts are executable: chmod +x *.sh
• Run as root user for proper user switching

WP-CLI not found:

• Install WP-CLI globally or update the path in the script
• Verify installation with wp --info

Astra Pro license errors:

• Ensure ASTRA_KEY is set to your actual license key in the script
• Verify Astra Pro plugin is installed and active
• Check error log for detailed license activation issues

7.2 Debug Mode

For detailed troubleshooting, use debug mode:

./Bash_WP-CLI_Update.sh --cron --DEBUG

This provides:

• Step-by-step execution details
• Command output and exit codes
• User detection process information
• Environment variable settings

7.3 Error Investigation

Check the detailed error log for in-depth analysis:

tail -f wp_cli_errors.log

8. Contributing

We welcome contributions! Please feel free to submit pull requests, report bugs, or suggest new features.

Development Guidelines

1. Follow existing code style and structure
2. Add appropriate error handling
3. Include debug information for new features
4. Update documentation for changes
5. Test changes thoroughly before submitting

9. License

This project is licensed under the MIT License - see the LICENSE file for details.

10. Acknowledgments

• WP-CLI Team for the excellent command-line interface
• WordPress Community for continuous improvement and updates
• Astra Team for the wonderful theme and plugin ecosystem
• Contributors who help maintain and improve this tool

11. Author & Support

Mikhail Deynekin

• 🌐 Website: deynekin.com
• 📧 Email: mid1977@gmail.com
• 🐙 GitHub: @paulmann

Getting Help

• 📖 Documentation: Read this README thoroughly
• 🐛 Bug Reports: Open an issue
• 💡 Feature Requests: Request features
• 💬 Questions: Check Discussions

---

Note: Always test maintenance scripts in a staging environment before deploying to production.