Installation

1. Ensure the module is activated in Administration → Add-ons → Manage add-ons.

2. The module is automatically installed in Multivendor and Ultimate editions of CS-Cart.

3. On installation, the module runs migrations to create the necessary data structures.

Configuration

1. Get SypexGeo API key: Register at SypexGeo (https://sypexgeo.net/), obtain an API key.

2. Module settings: Go to Administration → Add-ons → Manage add-ons → MS: Geolocation from SypexGeo. Enter the API key in the «API Key» field. Set the number of requests (default 3). Enable «Hide popup» if needed. Save changes.

3. Check API key status: The module settings display the API key status. Ensure the key is active.

Usage for administrator

1. Adding blocks: Go to Administration → Design → Block manager. Add the «MS: Customer location» block (cities) for city selection. Add the «MS: City info» block (city_phrase) for displaying city information.

2. City management (if cities or rus_cities module is installed): Go to Administration → MS: Geolocation from SypexGeo. Cities. Manage the city list, configure additional information (phrase, link).

Usage for customer

1. Automatic detection: On first visit, the module detects the city by IP. A popup may appear for confirmation.

2. Manual city selection: Find the city selection block, click to open the list, select a city. The city is saved in the session.

3. Viewing information: The page displays information about the selected city (configured by administrator).

Verification

1. Open the site from a new IP — verify automatic city detection.

2. Select a city manually — ensure saving works.

3. Check block display on site pages.

Troubleshooting

City not detected: Check the API key and its status.

Popup not showing: Check the «Hide popup» setting.

Blocks not working: Ensure blocks are added via the block manager and the module is activated.