A comprehensive WordPress maintenance and system administration tool designed for developers, system administrators, and site owners who need advanced control over their WordPress installations.
- Secure Access Key Protection: Configurable access key prevents unauthorized usage
- Emergency Login Options: Multiple methods to regain admin access
- Session Management: Proper WordPress authentication handling
- Site Overview: Complete WordPress installation details
- Server Information: PHP version, memory limits, and server configuration
- Database Status: Connection details and basic statistics
- Performance Metrics: Memory usage and execution time monitoring
- PHP Limits Configuration: Modify and reset PHP memory limits, execution time, upload size, and post size
- User Listing: View all WordPress users with roles and details
- Ajax Pagination: Smooth navigation through user lists with dynamic loading
- Scrollable Interface: Convenient scrollbar for browsing large user lists
- Quick Login: Login as any existing user instantly with dropdown user selection
- Temporary Admin Creation: Generate temporary administrator accounts
- Direct Admin Access: Create secure bypass links for emergency access
- User Role Management: View and understand user permissions
- Real-time Updates: Cache-busting technology ensures data is always current
- Database Information: View database name, size, and table count
- Connection Testing: Verify database connectivity
- Table Overview: List all database tables with sizes
- Ajax Pagination: Smooth navigation through database tables with dynamic loading
- Scrollable Interface: Convenient scrollbar for browsing large table lists
- Query Execution: Basic database query capabilities
- Real-time Updates: Cache-busting technology ensures database information is always current
- File Browser: Navigate through WordPress directory structure
- File Viewer: Preview files with syntax highlighting
- File Editor: Edit text files directly in the browser
- File Upload: Upload files to any directory
- File Download: Download files from the server
- File Operations: Delete, rename, and manage files
- Binary File Support: Preview images and handle binary files
- Security Checks: Validate file types and permissions
- Plugin Listing: View all installed plugins
- Ajax Pagination: Smooth navigation through plugin lists with dynamic loading
- Scrollable Interface: Convenient scrollbar for browsing large plugin lists
- Plugin Control: Activate/deactivate plugins with real-time status updates
- Plugin Information: Version details and status
- Bulk Operations: Manage multiple plugins efficiently
- Real-time Updates: Cache-busting technology ensures plugin status is always current
- Theme Overview: List all installed themes
- Active Theme Detection: Identify currently active theme
- Theme Information: Version and status details
- Theme Switching: Quick theme activation
- Multiple Mode Options: Choose from maintenance, coming soon, or payment request modes
- Custom Messaging: Personalized titles and messages for each mode
- Social Contact Integration: Display developer contact information (email, phone, WhatsApp, Skype)
- SEO-Friendly: Proper HTTP status codes and noindex meta tags
- Bypass Access: Administrators and bypass URL users can access the site normally
- Custom CSS Support: Add custom styling to maintenance pages
- Real-time Preview: Live preview and management of active modes
- 🔧 Maintenance Mode: Display maintenance message with 503 status code (temporary unavailable)
- 🚀 Coming Soon Mode: Show coming soon page with 200 status code and email collection
- 💰 Payment Request Mode: Display payment request message with 402 status code for unpaid projects
- Visual Debug Controls: Interactive interface to enable/disable WordPress debug settings
- Real-time Debug Status: Live monitoring of WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY, SCRIPT_DEBUG, and SAVEQUERIES
- Debug Log Viewer: Built-in viewer for recent debug log entries with real-time monitoring
- wp-config.php Auto-editing: Safe automatic modification of WordPress configuration
- Debug Information Panel: Comprehensive debug environment details and file status
- Debug Settings Guide: Built-in documentation and recommended configurations
- PHP Limits Management: Modify memory limit, execution time, upload size, and post size
- Multi-file Configuration: Update settings in wp-config.php, .htaccess, or php.ini
- One-Click Reset: Restore default PHP configuration values with a single click
- Real-time Feedback: Visual confirmation of successful updates and changes
- Server-Specific Options: Tailor PHP settings to your specific hosting environment
- Ajax Pagination: Smooth, dynamic loading of data without full page refreshes
- Scrollable Interfaces: Convenient scrollbars for browsing large data lists
- Real-time Data Updates: Cache-busting technology ensures information is always current
- Font Awesome Icons: Professional icon system with 6.4.0 CDN integration
- Branding Color Variables: Consistent design system with CSS custom properties
- Interactive Lightbox Modals: Enhanced user experience for complex instructions
- Responsive Design: Mobile-friendly interface with modern styling
- Visual Feedback: Clear status indicators and error messages with contextual icons
- Enhanced User Selection: Dropdown fields for quick user selection
- Locked Out Recovery: Multiple methods to regain access
- Maintenance Mode: Safe system maintenance capabilities with multiple mode options
- System Diagnostics: Troubleshoot common WordPress issues
- Frontend Installation Guide: Interactive lightbox with detailed setup instructions
- Visual Error Indicators: Clear warnings with Font Awesome icons for missing components
- PHP: 7.4 or higher
- WordPress: 5.0 or higher
- Server: Apache/Nginx with mod_rewrite
- Permissions: Write access to WordPress directory
- Memory: Minimum 128MB PHP memory limit
-
Download the Tool
wget https://github.com/yasirshabbirservices/wp-arzo/archive/refs/heads/main.zip unzip main.zip
-
Upload to WordPress Root
- Upload
wp-arzo.phpto your WordPress root directory - Ensure it's in the same directory as
wp-config.php
- Upload
-
Configure Security Key
// Edit line 11 in wp-arzo.php define('ACCESS_KEY', 'your-unique-secure-key-here');
-
Set Permissions
chmod 644 wp-arzo.php
-
Access the Tool
https://yoursite.com/wp-arzo.php?key=your-unique-secure-key-here
The tool uses a secure access key to prevent unauthorized access:
define('ACCESS_KEY', 'YS_maint_7x9K2pQ8vL4nB6wE3rT5uA1cF8dG');Important: Change this to a unique, complex string before deployment.
The tool automatically detects WordPress installation in these locations:
- Same directory as the tool
- Parent directory
- Two levels up
Ensure proper file permissions for full functionality:
- Read access: View files and directories
- Write access: Edit, upload, and delete files
- Execute access: Navigate directories
- Navigate to
https://yoursite.com/wp-arzo.php?key=YOUR_ACCESS_KEY - Use the navigation menu to access different features
- Each section provides specific functionality for WordPress management
-
🔧 Maintenance Mode: Perfect for scheduled maintenance, updates, or repairs
- Returns HTTP 503 status (Service Unavailable)
- Includes noindex meta tag to prevent search engine indexing
- Shows maintenance message with estimated completion time
-
🚀 Coming Soon Mode: Ideal for new websites under development
- Returns HTTP 200 status (OK)
- Includes noindex meta tag and email collection form
- Professional coming soon page with social contact options
-
💰 Payment Request Mode: For projects with pending payments
- Returns HTTP 402 status (Payment Required)
- Includes noindex meta tag and contact information
- Clear payment request message with developer contact details
- Administrator Access: Logged-in administrators can always access the site
- Bypass URL: Use
?maintenance_bypass=YOUR_ACCESS_KEYto view the normal site - Preview Mode: Real-time preview of maintenance pages before activation
If locked out of WordPress admin:
- Go to the "Quick Login" tab
- Choose from three recovery methods:
- Login as existing user
- Create temporary admin
- Generate direct admin access link
- Navigate to the "Files" tab
- Browse directories using the file manager
- Click file icons to view, edit, or download
- Use upload form to add new files
- Check "Site Info" for system overview
- Monitor "Database" for connection status
- Review "Users" for account management
- Navigate to the "Debug" tab
- View current debug settings status with color-coded indicators
- Enable/disable debug settings using the interactive form
- Monitor debug log file size and recent entries
- Use the built-in guide for recommended configurations
- Navigate to the "Extra Options" tab
- Select the target configuration file (wp-config.php, .htaccess, or php.ini)
- Set custom values for Memory Limit, Max Execution Time, Upload Max Filesize, and Post Max Size
- Click "Update PHP Limits" to apply changes
- Use "Reset to Defaults" to restore standard values (Memory: 128M, Execution: 30s, Upload/Post: 64M)
- Always use a strong, unique access key
- Remove the tool after maintenance is complete
- Never leave the tool accessible on production sites
- Use HTTPS for all access to prevent key interception
- Limit write permissions to necessary directories only
- Regularly audit file changes made through the tool
- Monitor access logs for unauthorized usage
- Document your access key in a secure location
- Test emergency access methods before needed
- Have backup restoration procedures ready
"WordPress not found" Error
- Ensure the tool is in the correct directory
- Check WordPress installation paths
- Verify file permissions
"File not found" Error
- Verify the access key is correct
- Check URL parameters
- Ensure the tool file exists
File Upload Failures
- Check PHP upload limits
- Verify directory permissions
- Review server error logs
Database Connection Issues
- Verify wp-config.php settings
- Check database server status
- Review MySQL/MariaDB logs
Use the built-in Debug Management feature to easily configure WordPress debug settings:
- Go to the "Debug" tab
- Use the visual interface to enable/disable debug options
- Monitor debug logs in real-time
- The tool automatically updates wp-config.php with proper settings
Alternatively, manually enable debug mode:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);We welcome contributions to improve the WordPress Maintenance Tool!
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow WordPress coding standards
- Add comments for complex functionality
- Test all features thoroughly
- Update documentation for new features
- Use the GitHub issue tracker
- Provide detailed reproduction steps
- Include system information
- Attach relevant error logs
This project is licensed under the MIT License - see the LICENSE file for details.
Permissions:
- ✅ Commercial use
- ✅ Modification
- ✅ Distribution
- ✅ Private use
Conditions:
- 📋 License and copyright notice
Limitations:
- ❌ Liability
- ❌ Warranty
Yasir Shabbir
- Website: yasirshabbir.com
- Email: contact@yasirshabbir.com
- GitHub: @yasirshabbirservices
- WordPress community for excellent documentation
- PHP community for robust language features
- Open source contributors for inspiration
- Security researchers for best practices
- NEW: PHP Limits Reset Functionality - One-click reset of PHP configuration limits to default values
- IMPROVED: Extra Options Interface - Enhanced PHP limits configuration with reset capability
- NEW: Ajax Pagination System - Smooth, dynamic loading for Users, Database Tables, and Plugins
- NEW: Scrollable Interfaces - Convenient scrollbars for browsing large data lists
- NEW: Cache-Busting Technology - Real-time data updates without browser caching issues
- NEW: User Selection Dropdown - Enhanced Quick Login with user selection field
- NEW: Debug Management System - Visual interface for WordPress debug settings
- NEW: Real-time Debug Monitoring - Live status of all debug constants
- NEW: Debug Log Viewer - Built-in viewer for debug.log with recent entries
- NEW: wp-config.php Auto-editing - Safe automatic configuration updates
- NEW: Enhanced Frontend Installation Guide - Interactive lightbox modal with step-by-step instructions
- NEW: Font Awesome Icons Integration - Professional icon system throughout the interface
- NEW: Branding Color Variables - Consistent design system with customizable color scheme
- NEW: Maintenance Modes System - Complete maintenance mode functionality with multiple options
- 🔧 Maintenance Mode (HTTP 503) for scheduled maintenance
- 🚀 Coming Soon Mode (HTTP 200) for new websites
- 💰 Payment Request Mode (HTTP 402) for pending payments
- Social contact integration (email, phone, WhatsApp, Skype)
- Custom messaging and CSS styling support
- SEO-friendly with proper status codes and noindex tags
- Administrator and bypass URL access
- Enhanced file management system with improved performance
- Advanced user authentication and management capabilities
- Optimized database operations and monitoring
- Comprehensive plugin and theme management with real-time status updates
- Multiple emergency access recovery methods
- Modern responsive UI with better UX
- Enhanced security hardening and access controls
- Improved system diagnostics and troubleshooting
- Better error handling and user feedback
- Streamlined codebase with performance optimizations
🔒 Security Reminder: Remove this tool from production servers after maintenance is complete to prevent unauthorized access.