50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
# 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.
|