Карта дистриб’юторів Pro — карта та пошук точок для PrestaShop

Що отримує клієнт магазину?

• Одне місце для пошуку точки: клієнт переглядає адреси та контактні дані без потреби шукати їх у багатьох окремих матеріалах.
• Пошук конкретних локацій: може ввести місто, поштовий індекс, вулицю або назву компанії та поєднати запит із фільтрами країни, типу точки й послуги.
• Пошук поблизу: після надання згоди на визначення місцезнаходження вибирає радіус від 1 до 500 кілометрів або миль, а результати впорядковуються від найближчої точки.
• Контакт з вибраною точкою: правильно заповнені телефони та адреса e-mail стають посиланнями для дзвінка або повідомлення; окреме посилання веде на вебсайт точки.
• Інформація перед візитом: картка точки може показувати логотип, тип, послуги, додаткову примітку та розгортані години роботи для окремих днів тижня.
• Перехід до маршруту: посилання «Маршрут» відкриває зовнішні Google Maps із локацією або адресою точки, також при використанні карти OpenFreeMap.

Карта OpenStreetMap, Google Maps або лише список

OpenFreeMap — карта без ключа Google

Модуль використовує публічний сервіс OpenFreeMap і дані OpenStreetMap, а бібліотека MapLibre підключається локально. Відображення цієї карти не потребує облікового запису чи ключа API. OpenFreeMap надає публічний сервіс без плати за перегляди; однак це зовнішній сервіс, а не інфраструктура, яку підтримує модуль. Актуальні правила описує постачальник OpenFreeMap.

Google Maps — варіант із власним ключем

Якщо ви виберете Google Maps, ви вказуєте браузерний ключ для Maps JavaScript API. Необов’язковий ідентифікатор карти дає змогу використовувати розширені маркери Google. Налаштування проєкту та можливі платежі залишаються на боці власника облікового запису Google; модуль не керує розрахунками. Вимоги описано в документації з налаштування Google Maps.

Список, незалежний від відображення карти

Карта завантажується лише після натискання «Показати карту». Маркери відповідають точкам з поточної сторінки результатів — максимум 20 — і оновлюються після пошуку або зміни сторінки. Натискання на маркер показує назву, адресу та посилання на маршрут, а вигляд карти підлаштовується під показані локації. Ви можете вимкнути карту й залишити каталог із пошуком; базовий список, фільтри та пагінація працюють також без JavaScript.

Адреса не замінює координати. Точка без широти й довготи може бути видимою у списку, але не отримає маркера і не з’явиться в результатах пошуку в радіусі. Координати ви вводите вручну, імпортуєте з CSV або доповнюєте на вимогу у формі точки через окремий ключ Google Geocoding API. Безкоштовне відображення карти не означає вбудованого безкоштовного геокодування.

Керування точками в панелі PrestaShop

• Додавання та редагування точок: форма охоплює назву компанії, країну, вулицю, місто, поштовий індекс, контактні дані, вебсайт, примітку, години роботи та координати.
• Контроль публікації: точку можна активувати або приховати без видалення її даних. Адміністративний список можна фільтрувати та сортувати; також доступне видалення записів.
• Власні типи та послуги: ви створите класифікації, що відповідають вашій мережі, наприклад шоурум, пункт самовивозу, консультація або монтаж. Точка може мати один необов’язковий тип і багато послуг.
• Багатомовні назви класифікацій: назви типів і послуг можна вказати мовами магазину. Відсутність перекладу спричиняє використання назви мовою за замовчуванням; описові дані самої точки не мають окремих мовних версій.
• Логотипи точок: форма приймає PNG, JPEG і WebP до 2 MiB, за умови підтримки відповідного формату сервером. Зображення обробляється та зберігається як PNG; пізніше його можна замінити або видалити.
• Зрозумілий поділ панелі: спільний заголовок з інформацією про стан конфігурації веде до налаштувань, списку дистриб’юторів, типів і послуг, а також імпорту й експорту CSV.
• Окремі налаштування видимості: увімкнення каталогу та його присутність на головній сторінці мають окремі перемикачі, а форма містить польські підказки та інструкцію запуску без Google.

Імпорт і експорт CSV з контролем змін

Імпорт підтримує файли CSV у UTF-8 розміром до 2 MiB і з вмістом до 1000 рядків даних. На вибір доступні крапка з комою, кома та табуляція. У панелі ви завантажите порожній шаблон або приклад файлу, а наявні точки зіставляються за сталим ідентифікатором external_id, а не за назвою компанії чи адресою.

1. Завантажте файл: модуль перевірить підтримувані заголовки, значення полів, ідентифікатори, коди країн і прив’язки типів та послуг.
2. Перевірте попередній перегляд: ви побачите записи для створення й оновлення, позиції без змін, помилки, а також порівняння значень до та після зміни. Попередній перегляд не зберігає зміни в точках.
3. Підтвердьте правильні дані: навіть одна помилка блокує імпорт файлу. Коректний попередній перегляд можна підтвердити протягом 30 хвилин, у тому самому магазині й тим самим працівником. Зміни даних із часу попереднього перегляду можуть вимагати повторного завантаження файлу.

Під час оновлення пропущений стовпець зберігає поточне значення, а порожня комірка може очистити необов’язкове поле. Записи, відсутні в CSV, не видаляються. Збереження точок і зв’язків відбувається в транзакції; помилка збереження скасовує її зміни. Типи та послуги потрібно попередньо створити в панелі — імпорт посилається на їхні коди.

Експорт із вкладки CSV охоплює активні й неактивні точки поточного магазину, контактні поля, години роботи, координати та коди класифікацій. Діють ті самі ліміти: 1000 точок і 2 MiB. Формат містить захист комірок від інтерпретації як формул електронної таблиці й може бути повторно завантажений у модуль. Це не є повною копією модуля: не містить файлів логотипів, налаштувань, перекладів словників або прив’язок до магазинів.

Multistore — точки, прив’язані до вибраних магазинів

Точки, типи та послуги мають явні прив’язки до магазинів. Нова точка за замовчуванням належить лише до поточно вибраного магазину; у формі її також можна прив’язати до інших доступних магазинів із встановленим модулем. Список на фронтенді, карта, результати пошуку та експорт враховують поточний магазин. Увімкнення каталогу, блок на головній сторінці, постачальник карти та ключі API налаштовуються окремо для кожного магазину.

Спільне використання точки не створює незалежних копій. Назва, адреса, контакти, логотип, активність і класифікація того самого запису є спільними для прив’язаних магазинів. Збереження вимагає вибору одного магазину, а редагування спільної точки — доступу до всіх її магазинів. Нові точки з CSV потрапляють до поточного магазину, натомість оновлення зберігає наявні прив’язки.

Презентація каталогу та елементи технічного SEO

• Окрема сторінка каталогу: модуль надає посилання, яке можна використати в меню магазину. Необов’язковий блок на головній сторінці вимагає відображення позиції displayHome темою.
• Макет, адаптований до менших екранів: форма та список мають адаптивні правила, а години роботи можна розгорнути в картці точки.
• Результати без перезавантаження всієї сторінки: за наявності підтримки JavaScript пошук і пагінація оновлюють список і маркери через AJAX.
• Вміст каталогу рендериться на боці сервера: адреси та контакти містяться в HTML списку, а не лише у вікнах карти.
• Метадані сторінки каталогу: контролер передає заголовок, опис, навігацію breadcrumbs і канонічну адресу каталогу. Результати з фільтрами та наступні сторінки отримують директиву noindex,follow.

Модуль не створює окремих підсторінок локацій або структурованих даних LocalBusiness. Описані механізми не є гарантією позицій у Google чи присутності у відповідях AI.

Як запустити каталог без ключів Google?

1. У multistore виберіть магазин, для якого хочете налаштувати каталог.
2. Увімкніть каталог і виберіть OpenFreeMap / OpenStreetMap як постачальника карти.
3. Додайте активні точки з реальними адресами та обома координатами; за потреби призначте власні типи та послуги.
4. Відкрийте каталог із панелі та скористайтеся кнопкою «Показати карту». За бажанням увімкніть блок на головній сторінці.

Важливі відмінності перед впровадженням

Карта дистриб’юторів Pro є інформаційним каталогом. Вона не додає вибір точки до кошика чи замовлення, не пов’язує точки з товарами або їхніми складськими залишками й не підтримує бронювання. Години роботи — це текст, що вводиться вручну, без автоматичного статусу «відчинено зараз». Відстань у результатах обчислюється по прямій, а не за маршрутом дороги.

Геолокація вимагає згоди користувача та безпечного контексту браузера, зазвичай HTTPS. Інтерактивна карта OpenFreeMap вимагає підтримки WebGL2 і з’єднання із сервісом постачальника. Завантаження карти спричиняє контакт браузера з постачальником карт; кнопка її запуску не є інтеграцією із системою керування згодами. Сам каталог залишається доступним без