Slovak Address Autocomplete

Slovak Address Autocomplete is a free PrestaShop module for entering addresses in Slovakia. A chosen address fills the street and returned house numbers, an NNN NN postcode when available, and town. It uses open Register adries data from the Ministry of the Interior of the Slovak Republic without an account, key or cost per lookup.

Quick start

1. Upload and install the module ZIP in PrestaShop. No MV SR account, key or payment setup is needed.
2. Open Configure, or the Slovak Address entry in the back office menu; in multishop select one shop you can manage.
3. Check that Slovakia is active and available on the native address forms you use.
4. Choose the overall, account, checkout and back office switches, in that order, and save. There is no country selector here.
5. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.
6. Merge the MV SR origin into an existing CSP and mention the browser connection in your privacy notice.
7. Select Slovakia and type Obchod 12 Bratis. When returned, choose Obchodná 512/12 and check 811 06 and Bratislava. Also test a village without streets, missing-postcode completion, manual entry, guests, invoices, staff/new-order, France with French Address Autocomplete and phone width.

Features

• Slovak address suggestions. Official Register adries data on native account and checkout forms, including guests.
• Filled together. Street and returned house numbers, NNN NN postcode when available, and town.
• Fixed Slovakia coverage. National register addresses, including villages without streets; missing postcodes need completion.
• Back office. The same postal address help for staff in Customers > Addresses.
• Everyday entry. Phone taps, keyboard navigation and screen-reader announcements; manual entry remains.
• No service account. A free module using free national data, with four separate switches and no key.

Configuration options

• Suggest addresses while the customer types: overall switch, first in the form.
• On the address form in the customer account: native account addresses.
• On the checkout address forms (guests and separate invoice addresses included): native checkout.
• On the address form in the back office (customer addresses, new orders): native Customers > Addresses.

Open Configure in Module Manager, or the Slovak Address entry in the back office menu. This release has one Settings page with Configuration, Integrity, License, Update and Support sections. The four switches above appear in that order, followed by Save. All default to on. There is no provider key, account or country field. In multishop select one authorized shop; settings are stored for that shop. After the form the notes cover coverage/free service, manual entry, privacy and CSP, followed by the shared sibling-service note. English, German, French, Polish, Italian, Spanish and Slovak settings strings are supplied; this does not promise address data in seven languages.

Use for these countries is available on worldwide siblings only. Empty means all countries available to the form; a selected list restricts that sibling. MV SR remains fixed to SK. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. For example leave a worldwide service for other destinations and enable Slovak Address for Slovakia. No failed search automatically retries another service.

Customization examples

Allow MV SR in your Content Security Policy

Allow https://rageo.minv.sk in connect-src, the origin used by the adapter and the recorded service calls. Scripts and styles are served by your shop. Merge this example into your existing policy, preserving theme rules, inline styles/nonces and other modules. With French Address Autocomplete also allow https://data.geopf.fr in connect-src. Check requests and policy on your shop. The data.gov.sk source identifier is never fetched as a separate origin. Use for these countries is available on worldwide siblings only. Empty means all countries available to the form; a selected list restricts that sibling. MV SR remains fixed to SK. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. For example leave a worldwide service for other destinations and enable Slovak Address for Slovakia. No failed search automatically retries another service.

script-src 'self';
style-src 'self';
connect-src 'self' https://rageo.minv.sk;

Retain apartment and delivery details

The selected country, second address line, name, company and telephone remain unchanged. Keep apartment, floor or entrance details on line two. A selection replaces the street line with the returned address; add any extra detail afterwards. Check house numbers, postcode and town before saving. No apartment or house-name lookup is provided. Customers can always edit the result or enter the address manually.

Installation

Requirements

• General PrestaShop range: PS 1.6 – 9.x. Exact declared floor: PrestaShop 1.6.1.0, PHP 7.1 or later.
• Native address fields and Bootstrap 3, 4 or 5 presentation. Slovakia must be available; activate it if you deliver there.
• Check that Slovakia is active and available on the native address forms you use.

Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. Slovak Address works alone.

Installation does not certify service availability or every platform/theme combination. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.

How it works

Suggestions begin after three characters and a 300 ms pause. The browser sends a direct JSON POST to https://rageo.minv.sk/geocoder/api/v1/search, with normalized text, categories:["adresa"] and size:50. It removes optional street prefixes and normalizes námestie. A short prefix of one of 25 larger towns can add a parallel search with that town completed. A recognized postcode with a house number adds a WFS GET to /geoserver/ows, filtering postcode, number and street/town words. Results are merged and ranked by number match, typed town and large-town order; up to five suggestions are shown.

While a search or selection is pending, the plain line “Searching addresses…” appears after 600 ms. Each HTTP request gives up after ten seconds. Search and selection are separate operations, so this is not a total interaction deadline. A rate limit pauses requests according to Retry-After or ten seconds. Customers can always continue entering or editing the address by hand.

Selected address fields

A pick fills the street and house numbers as the register writes them: súpisné/orientačné, for example Obchodná 512/12. Either available number and letter suffixes are kept. The postcode becomes 811 06 and the town Bratislava; Bratislava and Košice district names are reduced to the city without inventing a postal-office suffix. Without a street, a district or village name is used, for example Horša 12 with Levice, or Čičmany 123. A missing postcode stays empty and must be entered manually. Ordinary geocoder options have two lines: street/locality and number, then the returned place. They do not include a postcode. A normal pick fetches one structured WFS record by its source identifier. Typed-postcode results already carry the fields, show postcode and town on the second line and need no extra retrieval. Valid details need a town and at least one house number; malformed records are rejected. Street-only filling is not implemented. Missing postcodes clear the field; no province is supplied.

Use for these countries is available on worldwide siblings only. Empty means all countries available to the form; a selected list restricts that sibling. MV SR remains fixed to SK. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. For example leave a worldwide service for other destinations and enable Slovak Address for Slovakia. No failed search automatically retries another service.

Staff entering an address after a telephone enquiry get suggestions in Customers > Addresses. Choosing a Slovak address fills the same native street, postcode and town fields. The back office switch is independent of the account and checkout switches.

The code also targets native new-order address windows served by the customer address page. Custom routes and third-party forms need checking. The bundled engine supports marked checkout address forms and uses per-shop service settings shared with Checkout Revolution.

On a phone, tap a result beneath the street field. With a keyboard, use the arrows and Enter to select; Escape or Tab dismisses the list. Screen readers receive result announcements. The shared dropdown uses the theme’s Bootstrap presentation.

The list shows the credit © Ministerstvo vnútra SR. No match leaves the list closed, and service failure announces that suggestions are unavailable. Customers keep manual entry and editing. Saving an address never requires a suggestion, and the module does not validate delivery addresses on submission.

Privacy and data credit

The browser sends normalized search text and fixed search options directly to the Ministry’s service at https://rageo.minv.sk. A larger-town completion may add another search; postcode searches send postcode, house number and street/town words in WFS filters. A normal selection sends the chosen source identifier to retrieve the address. No key, selected-country, page-language, name, email, phone, company or second-line parameter is added. Anything typed into the search may be sent after normalization. Requests disable credentials. The connection exposes the visitor’s IP and browser information; origin and referring-page information follow browser policy. No shop proxy or search-history feature is implemented; diagnostics omit queries and returned addresses. Mention this transfer in your privacy notice. Visible credit: © Ministerstvo vnútra SR.

Honest limits

• Coverage and availability depend on Register adries; neither every address nor continuous service is guaranteed. No exhaustive postcode directory or unlimited-use promise.
• The ordinary suggestion list has no postcode. Search pages and town-prefix expansion are bounded; selecting a result can fail independently of the search. Missing postcodes need manual completion.
• House numbers are retained as returned. No apartment or house-name lookup, no street-only fill and no invented postal-office suffix. Check the chosen address before saving.
• Every request times out after ten seconds; search and selection are separate. Rate limits pause requests. Manual entry remains, with no automatic service failover.
• Custom forms/themes and differently routed new-order windows need checking. Custom checkout forms need integration with the shared engine. No map, geolocation, submit-time validation, automatic country choice or delivery guarantee. Free module with lifetime updates, no included support commitment.

Troubleshooting

• No Slovak results: select Slovakia, check its active status and the overall/form switches, then try full street + number + town.
• Try another spelling or the full town name when a short query is too broad. Keep all address modules current.
• No details or missing postcode: enter or complete street, number, postcode and town manually, then check before saving.
• Unavailable suggestions: inspect browser requests and CSP for rageo.minv.sk, wait after a rate limit and continue manual entry.
• Custom layout: test a native form, phone and keyboard, and the new-order route. Check the shared service settings for the selected shop.