opencart-automation-suite/README.md

Automation Suite for OpenCart 3

An OpenCart 3.x extension that automatically manages product status based on stock levels, disabling out-of-stock products and re-enabling them when inventory returns.

Features

🚀 Automatic Product Status Management

• Automatically disables products when quantity reaches zero after an order
• Re-enables products when stock is replenished (e.g., through order cancellation or manual adjustment)
• No core file changes required - uses OCMOD system

📦 Module Structure

• install.xml: OCMOD installation file with modification definitions
• upload/: Directory for module files to be uploaded to OpenCart
• install.php: Optional PHP installation script
• install.sql: Optional database installation script

🔄 Automated Releases

• Integrated Gitea Actions workflow for automatic builds
• Generates .ocmod.zip packages on push to main branch
• Extracts metadata from install.xml for versioning
• Ready-to-install extension packages

🛠️ Development Tools

• XML-based modification system
• Template structure for rapid module development
• CI/CD pipeline for quality assurance
• Version management through install.xml

Installation

1. Clone this repository
2. The install.xml is pre-configured for the Automation Suite functionality
3. Place any additional module files in the upload/ directory if needed
4. Add installation scripts if needed (install.php, install.sql)
5. Push to your repository to trigger automatic release build

Usage

For Store Owners

1. Download the generated .ocmod.zip from releases
2. Upload via OpenCart's Extension Installer
3. The module will automatically manage product status based on stock levels

For Developers

1. Modify install.xml to customize the behavior
2. Add custom files to upload/ directory
3. Test locally before deploying

Changelog

v1.0.0

• Initial release
• Automatic product disabling when out of stock
• Automatic product re-enabling when stock is replenished

3. Install and configure the module through admin panel

Requirements

• OpenCart 3.x
• PHP 7.3 or higher
• MySQL 5.7 or higher
• OCMOD support enabled

Author

Mohamed Youssef
Website: my-dev.pro
Email: Contact through website

License

This template is provided as-is for OpenCart module development. Please check individual module licenses for usage terms.