Co zyskuje klient sklepu?
- Jedno miejsce do znalezienia punktu: klient przegląda adresy i dane kontaktowe bez szukania ich w wielu osobnych materiałach.
- Wyszukiwanie konkretnych lokalizacji: może wpisać miasto, kod pocztowy, ulicę albo nazwę firmy i połączyć frazę z filtrami kraju, typu punktu oraz usługi.
- Wyszukiwanie w pobliżu: po wyrażeniu zgody na lokalizację wybiera promień od 1 do 500 kilometrów lub mil, a wyniki są porządkowane od najbliższego punktu.
- Kontakt z wybranym punktem: prawidłowo uzupełnione telefony i adres e-mail stają się odnośnikami do połączenia lub wiadomości; osobny link prowadzi na stronę internetową punktu.
- Informacje przed wizytą: karta punktu może pokazywać logo, typ, usługi, dodatkową notatkę i rozwijane godziny otwarcia dla poszczególnych dni tygodnia.
- Przejście do wskazówek dojazdu: odnośnik „Trasa dojazdu” otwiera zewnętrzne Google Maps z lokalizacją lub adresem punktu, również przy mapie OpenFreeMap.
Mapa OpenStreetMap, Google Maps lub sama lista
OpenFreeMap — mapa bez klucza Google
Moduł korzysta z publicznej usługi OpenFreeMap i danych OpenStreetMap, a bibliotekę MapLibre dołącza lokalnie. Wyświetlanie tej mapy nie wymaga konta ani klucza API. OpenFreeMap udostępnia publiczną usługę bez opłat za wyświetlenia; jest to jednak usługa zewnętrzna, a nie infrastruktura utrzymywana przez moduł. Aktualne zasady opisuje dostawca OpenFreeMap.
Google Maps — opcja z własnym kluczem
Jeżeli wybierzesz Google Maps, podajesz klucz przeglądarkowy do Maps JavaScript API. Opcjonalny identyfikator mapy umożliwia użycie zaawansowanych znaczników Google. Konfiguracja projektu i ewentualne opłaty pozostają po stronie właściciela konta Google; moduł nie zarządza rozliczeniami. Wymagania opisuje dokumentacja konfiguracji Google Maps.
Lista niezależna od wyświetlania mapy
Mapa wczytuje się dopiero po kliknięciu „Pokaż mapę”. Znaczniki odpowiadają punktom z bieżącej strony wyników — maksymalnie 20 — i aktualizują się po wyszukiwaniu lub zmianie strony. Kliknięcie znacznika pokazuje nazwę, adres i odnośnik dojazdu, a widok mapy dopasowuje się do prezentowanych lokalizacji. Możesz wyłączyć mapę i pozostawić katalog z wyszukiwarką; podstawowa lista, filtry i paginacja działają także bez JavaScript.
Adres nie zastępuje współrzędnych. Punkt bez szerokości i długości geograficznej może być widoczny na liście, ale nie otrzyma znacznika i nie pojawi się w wynikach wyszukiwania w promieniu. Współrzędne wpisujesz ręcznie, importujesz z CSV albo uzupełniasz na żądanie w formularzu punktu przez osobny klucz Google Geocoding API. Darmowe wyświetlanie mapy nie oznacza wbudowanego darmowego geokodowania.
Zarządzanie punktami w panelu PrestaShop
- Dodawanie i edycja punktów: formularz obejmuje nazwę firmy, kraj, ulicę, miasto, kod pocztowy, dane kontaktowe, stronę internetową, notatkę, godziny i współrzędne.
- Kontrola publikacji: punkt można aktywować lub ukryć bez usuwania jego danych. Listę administracyjną można filtrować i sortować; dostępne jest również usuwanie rekordów.
- Własne typy i usługi: utworzysz klasyfikacje odpowiednie dla swojej sieci, na przykład salon ekspozycyjny, punkt odbioru, doradztwo lub montaż. Punkt może mieć jeden opcjonalny typ i wiele usług.
- Wielojęzyczne nazwy klasyfikacji: nazwy typów i usług można podać w językach sklepu. Brak tłumaczenia powoduje użycie nazwy z języka domyślnego; dane opisowe samego punktu nie mają osobnych wersji językowych.
- Logotypy punktów: formularz przyjmuje PNG, JPEG i WebP do 2 MiB, pod warunkiem obsługi danego formatu przez serwer. Obraz jest przetwarzany i zapisywany jako PNG; można go później wymienić lub usunąć.
- Czytelny podział panelu: wspólny nagłówek z informacjami o stanie konfiguracji prowadzi do ustawień, listy dystrybutorów, typów i usług oraz importu i eksportu CSV.
- Oddzielne ustawienia widoczności: włączenie katalogu i jego obecność na stronie głównej mają osobne przełączniki, a formularz zawiera polskie podpowiedzi i instrukcję uruchomienia bez Google.
Import i eksport CSV z kontrolą zmian
Import obsługuje pliki CSV w UTF-8 o rozmiarze do 2 MiB i zawierające do 1000 wierszy danych. Do wyboru są średnik, przecinek i tabulator. W panelu pobierzesz pusty szablon lub plik przykładowy, a istniejące punkty dopasowywane są po stałym identyfikatorze external_id, nie po nazwie firmy czy adresie.
- Wczytaj plik: moduł sprawdzi obsługiwane nagłówki, wartości pól, identyfikatory, kody krajów oraz przypisania typów i usług.
- Sprawdź podgląd: zobaczysz rekordy do utworzenia i aktualizacji, pozycje bez zmian, błędy oraz porównanie wartości przed i po zmianie. Podgląd nie zapisuje zmian w punktach.
- Zatwierdź poprawne dane: choćby jeden błąd blokuje import pliku. Poprawny podgląd można zatwierdzić w ciągu 30 minut, w tym samym sklepie i przez tego samego pracownika. Zmiany danych od czasu podglądu mogą wymagać ponownego wczytania pliku.
Przy aktualizacji pominięta kolumna zachowuje dotychczasową wartość, a pusta komórka może wyczyścić pole opcjonalne. Rekordy nieobecne w CSV nie są usuwane. Zapis punktów i powiązań odbywa się w transakcji; błąd zapisu wycofuje jej zmiany. Typy i usługi trzeba wcześniej utworzyć w panelu — import odwołuje się do ich kodów.
Eksport z zakładki CSV obejmuje aktywne i nieaktywne punkty bieżącego sklepu, pola kontaktowe, godziny, współrzędne i kody klasyfikacji. Obowiązują te same limity: 1000 punktów i 2 MiB. Format zawiera zabezpieczenie komórek przed interpretacją jako formuły arkusza i może być ponownie wczytany do modułu. Nie stanowi pełnej kopii modułu: nie zawiera plików logo, ustawień, tłumaczeń słowników ani przypisań do sklepów.
Multistore — punkty przypisane do wybranych sklepów
Punkty, typy i usługi mają jawne przypisania do sklepów. Nowy punkt domyślnie należy tylko do aktualnie wybranego sklepu; w formularzu można przypisać go również do innych dostępnych sklepów z zainstalowanym modułem. Lista na froncie, mapa, wyniki wyszukiwania i eksport uwzględniają bieżący sklep. Włączenie katalogu, blok na stronie głównej, dostawca mapy i klucze API są konfigurowane per sklep.
Współdzielenie punktu nie tworzy niezależnych kopii. Nazwa, adres, kontakty, logo, aktywność i klasyfikacja tego samego rekordu są wspólne dla przypisanych sklepów. Zapis wymaga wyboru pojedynczego sklepu, a edycja punktu współdzielonego — dostępu do wszystkich jego sklepów. Nowe punkty z CSV trafiają do bieżącego sklepu, natomiast aktualizacja zachowuje dotychczasowe przypisania.
Prezentacja katalogu i elementy technicznego SEO
- Osobna strona katalogu: moduł udostępnia link, który można wykorzystać w menu sklepu. Opcjonalny blok na stronie głównej wymaga wyświetlania miejsca
displayHomeprzez motyw. - Układ dostosowany do mniejszych ekranów: formularz i lista mają reguły responsywne, a godziny otwarcia można rozwinąć w karcie punktu.
- Wyniki bez przeładowania całej strony: przy dostępnej obsłudze JavaScript wyszukiwanie i paginacja aktualizują listę oraz znaczniki przez AJAX.
- Treść katalogu renderowana po stronie serwera: adresy i kontakty znajdują się w HTML listy, a nie wyłącznie w oknach mapy.
- Metadane strony katalogu: kontroler przekazuje tytuł, opis, nawigację okruszkową i adres kanoniczny katalogu. Wyniki z filtrami oraz kolejne strony otrzymują dyrektywę
noindex,follow.
Moduł nie tworzy osobnych podstron lokalizacji ani danych strukturalnych LocalBusiness. Opisane mechanizmy nie są gwarancją pozycji w Google ani obecności w odpowiedziach AI.
Jak uruchomić katalog bez kluczy Google?
- W multistore wybierz sklep, dla którego chcesz skonfigurować katalog.
- Włącz katalog i wybierz OpenFreeMap / OpenStreetMap jako dostawcę mapy.
- Dodaj aktywne punkty z prawdziwymi adresami i obiema współrzędnymi; w razie potrzeby przypisz własne typy i usługi.
- Otwórz katalog z panelu i użyj przycisku „Pokaż mapę”. Opcjonalnie włącz blok na stronie głównej.
Ważne rozróżnienia przed wdrożeniem
Mapa dystrybutorów Pro jest katalogiem informacyjnym. Nie dodaje wyboru punktu do koszyka ani zamówienia, nie łączy punktów z produktami lub ich stanami magazynowymi i nie obsługuje rezerwacji. Godziny są wpisywanym tekstem — bez automatycznego statusu „otwarte teraz”. Odległość w wynikach jest liczona w linii prostej, a nie według przebiegu drogi.
Geolokalizacja wymaga zgody użytkownika i bezpiecznego kontekstu przeglądarki, zwykle HTTPS. Interaktywna mapa OpenFreeMap wymaga obsługi WebGL2 i połączenia z usługą dostawcy. Wczytanie mapy powoduje kontakt przeglądarki z dostawcą map; przycisk jej uruchomienia nie jest integracją z systemem zarządzania zgodami. Sam katalog pozostaje dostępny bez