# Prevent PO Box Address for OpenCart 3

An OpenCart 3 extension template that blocks PO Box addresses during checkout and improves shipping address validation.

## Features

- Prevents PO Box addresses in shipping and billing forms
- Works with OpenCart 3.x and the OCMOD modification system
- No core file edits required
- Easy to install as a `.ocmod.zip` extension package
- Includes a ready-to-use `install.xml` definition and upload package structure

## Installation

1. Download or clone this repository.
2. Open the OpenCart admin panel and go to `Extensions > Installer`.
3. Upload the generated `.ocmod.zip` package.
4. Go to `Extensions > Modifications` and click `Refresh`.
5. Open `Extensions > Extensions`, choose `Shipping` or the appropriate extension type, and install the module if needed.

## Setup

1. Customize `install.xml` if required:
   - Update `<name>`, `<code>`, and `<version>`
   - Adjust the address validation rules in the modification definitions
2. Place any additional files in the `upload/` directory for packaging.
3. If you add install scripts, include `install.php` or `install.sql`.

## Usage

- After installation, checkout address fields are validated for PO Box patterns.
- Users attempting to enter a PO Box address will be prompted to use a street address instead.
- Test on a development store before deploying to production.

## Requirements

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

## Author

**Mohamed Youssef**  
Website: [my-dev.pro](https://my-dev.pro)

## License

This extension template is provided as-is for OpenCart module development. Review and adapt it to your own store policies and licensing needs.