Requirements

- OpenCart 3.x or 4.x and PHP 7.2+ -8.x
- HTTPS is recommended
- Google Cloud project with billing enabled
- Maps JavaScript API and a valid API key
- ShopShine PostaPont Pro licence key

Installation

1. Back up the store files and database.
2. In admin, open **Extensions → Installer**.
3. Upload "shopshine_postapont_pro... .ocmod.zip".
4. Open **Extensions → Modifications** and click Refresh.
5. Open **Extensions → Extensions**, choose Shipping, and install ShopShine PostaPont Pro.
6. Open the module settings.

Initial configuration

1. Select the store and checkout type in use.
2. Enter the Google Maps API key.
3. Configure pricing, permitted pickup-point types and any exclusions.
4. Enter the licence key.
5. **Save the module first**, then click **Recheck** in the licence section.
6. Enable the extension and save the settings.

Google Maps API key

1. Open Google Cloud Console and select or create a project.
2. Link the project to a billing account.
3. Enable **Maps JavaScript API**.
4. Create an API key.
5. Restrict the key to your store's HTTP referrers, for example "https://www.example.com/*".

Checkout integration

On Settings → General, select the active checkout:

- OpenCart default checkout
- Journal 3 / 3.2 One Page Checkout
- Xtensions Best Checkout

After changing checkout or heavily customising the theme, test desktop and mobile checkout flows.

Pricing

You can configure a general fee, weight bands, and—per customer group—up to four cart-total bands plus separate weight rates. An upper limit of "0" means no upper limit. Enter fees in the store's base currency.

Multi-store

Use the store selector at the top of the administration page to maintain separate settings for each store. Before saving or validating a licence, verify that the correct store is selected.

Exclusions

Products and categories are searchable by name. The shipping method is hidden if the cart contains a selected product or a product belonging to an excluded category.

Troubleshooting

- Refresh the modification cache after installation and clear the theme cache if needed.
- Verify that the extension is enabled, the licence is active, and the Google Maps API referrer restriction matches the store domain.
- If the map is missing, inspect the browser console for a Google Maps API error.
- For AJAX checkouts, confirm that the correct checkout integration is selected.

Updating and uninstalling

Create a backup before updating. Upload the new installer and refresh Modifications. To remove the extension, disable and uninstall it first, then remove its OCMOD installation from the Installer if required.