README

About

This extension offers the possibility to create multiple lists containing address data, contact information as well as opening times. From the Frontend the user can enter any possible address to see which stores are nearby (like on Google Maps). Read more

Important

With version 5, the complete Google Maps integration has been updated. The map display now uses the Google Maps Element, and the address search is handled via the Place Autocomplete Element. If you are using customized templates, they must be updated to ensure compatibility with the new implementation.

Screenshot

System requirements

• Contao 5.3 or newer
• Google API Key (optional)

Installation

• Install via Contao Manager or Composer (composer require numero2/contao-storelocator)
• Run a database update via the Contao Manager or using the contao:migrate command.

Using other providers

StoreLocator comes pre-bundled with a provider for Google Maps as well as OpenStreetMap Nominatim. If you want to use another provider you'll need to install additional packages:

Events

By default the importer will populate the model with the fields for the current row and the key provided in the first row of the file. For custom handling feel free to use the contao.storelocator_store_import event:

// src/EventListener/StoreImportListener.php
namespace App\EventListener;

use numero2\StoreLocatorBundle\Event\StoreImportEvent;
use numero2\StoreLocatorBundle\Event\StoreLocatorEvents;
use Symfony\Component\EventDispatcher\Attribute\AsEventListener;

#[AsEventListener(StoreLocatorEvents::STORE_IMPORT)]
class StoreImportListener {

    public function __invoke( StoreImportEvent $event ): void {
        // …
    }
}