Dokumentacja My Maps location

Wprowadzenie

Pozwól swoim użytkownikom wyszukiwać lokalizacje i konfigurować wyświetlacz, jak chcesz. My maps location to po prostu najbardziej zaawansowana integracja z Google Maps dla Joomla.

Główne cechy:

  • Wyszukaj lokalizacje, które utworzyłeś
  • Automatyczna geolokalizacja
  • Źródłem mapy mogą być Mapy Google, mapy Bing lub Mapbox
  • Dodaj projekt mapy
  • Uzyskaj informacje z miejsc Google
  • Importuj / eksportuj / synchronizuj lokalizacje z pliku .csv
  • Przesyłanie lokalizacji frontendu
  • Wiele integracji rozszerzeń innych firm

I. MY MAPS LOCATION INSTALUJ I AKTUALIZUJ

1.1 Zainstaluj

Nasz komponent jest kompatybilny z Joomla 3.x. Wszystkie funkcje i integracje ze stronami trzecimi są zawarte we wszystkich członkostwach.
Aby zainstalować nasz komponent, musisz pobrać plik rozszerzenia .zip i użyć standardowego instalatora Joomla.

Następnie kliknij Przeglądaj> przycisk Prześlij i zainstaluj, komponent, moduły i wtyczki zostaną zainstalowane strona głównayślnie.

1.2 Aktualizacja i automatyczny aktualizator

Aby zaktualizować My Maps location, możesz zainstalować nową wersję na starej, pobierając plik ZIP z JoomUnited lub używając automatycznego aktualizatora (zalecane).

aktualizacja mml

 

Automatyczny aktualizator, który przesyła powiastrona głównaienie o aktualizacji, jest osadzony w zainstalowanym rozszerzeniu Joomla. Otrzymasz powiastrona głównaienie jak każde inne rozszerzenie na pulpicie nawigacyjnym lub za pomocą menu: Rozszerzenie> Zarządzaj> menu Aktualizuj.

 

Zaloguj się do swojego konta, aby zaktualizować

Musisz się zalogować na swoje konto JoomUnited, aby zaktualizować wszystkie swoje rozszerzenia Joomla Joomla. Aby zalogować się, przejdź do głównej konfiguracji komponentu, a następnie kliknij Karta aktualizacji na żywo. Na dole znajdziesz przycisk logowania.

Wprowadź swoje poświadczenia JoomUnited, takie same, jakich używasz do logowania się tutaj @ www.joomunited.com

 

Przycisk zmieni kolor na pomarańczowy, gratulacje! możesz teraz zaktualizować wszystkie rozszerzenia JoomUnited na tej stronie! Jeśli Twoje członkostwo wygasło, otrzymasz link odnawiający i tekst, który to wyjaśnia.

Uwaga: jedno logowanie pozwoli zaktualizować wszystkie rozszerzenia JoomUnited (dotyczące członkostwa). Logowanie nie wygasa, jeśli go nie rozłączysz.

II. LOKALIZACJE I KATEGORIE

2.1 Uzyskaj klucz API Google Maps

Za każdym razem, gdy korzystasz z interfejsów API Map Google, jeśli strona głównaena została utworzona po 22 czerwca 2016 r., Musisz podać klucz, aby potwierdzić żądanie.
Uzyskaj klucz i włącz interfejs API: https://developers.google.com/maps/documentation/javascript/get-api-key

Więcej informacji: https://developers.google.com/maps/documentation/javascript/usage?hl=en

Pierwszym krokiem jest stworzenie projektu i

Następnie wpisz nazwę projektu. Jeśli chcę zezwolić na wszystkie żądania z mystrona głównaain, wzór do naśladowania to * .joomunited.com / *
Jeśli chcesz zezwolić na pojedynczą strona głównaenę, na przykład mystrona głównaain.com, wówczas wzorzec będzie joomunited.com/*


W środowisku localhost możesz umieścić dowolny prawidłowy klucz i będzie działać bez odwoływania się do żadnej strona głównaeny.


Klucz API jest wtedy generowany, jest to klucz, który należy skopiować, aby dodać go do My Maps location.

Dodaj klucz do My Maps Location.

Od Komponenty> My Maps Location> Widok opcji, możesz dodać klucz w konfiguracji.

 

Wklej klucz.

 

Krok po kroku:


Oto kroki, które podążam

  • Przejdź do konsoli Google API
  • Utwórz lub wybierz projekt
  • Kliknij dalej aby włączyć API i wszelkie powiązane usługi
  • Na stronie Poświadczenia uzyskaj Klawisz przeglądarki (i ustaw poświadczenia API)
  • Aby zapobiec kradzieży kwot, zabezpiecz następujący klucz API te najlepsze praktyki

2.2 Zarządzaj kategoriami lokalizacji

Lokalizacja jest klasyfikowana w kategoriach. Kategorie te mogą być wyświetlane jako filtr w interfejsie lub jako predefiniowany parametr w pozycji menu, aby załadować niektóre skategoryzowane lokalizacje.
 

 

Jeśli masz wiele lokalizacji, zaleca się używanie kategorii. Możesz tworzyć kategorie i podkategorie.
Aby utworzyć kategorię, wejdź My Maps location> Kategoria i kliknij Nowy


 

Następnie z ekranu kategorii musisz dodać tytuł i kategorię nadrzędną w przypadku, gdy chcesz utworzyć podkategorię

Możesz również zdefiniować strona głównayślny znacznik lokalizacji w magazynie przy użyciu zakładki Wybór znaczników

 

Uwaga: kategoria jest tworzona strona głównayślnie o nazwie „Moja kategoria” umożliwiając rozpoczęcie dodawania lokalizacji bezpośrednio po instalacji

2.3 Utwórz lokalizację

Aby utworzyć lokalizację, wejdź My Maps location> Lokalizacje> Nowy

Istnieją 3 obowiązkowe pola:

  • Nazwa lokalizacji
  • Kategoria lokalizacji
  • Szczegóły lokalizacji (adres)

 

Na adres masz 3 rozwiązanie, aby je dodać:

  • Użyj pola wyszukiwania (zalecane)
  • Przejdź na mapę i użyj kursora, aby wskazać lokalizację
  • Wypełnij adres (musi być ważny Google Maps)

 

Aby dodać lokalizację za pomocą wyszukiwarki, wpisz nazwę miejsca, które chcesz dodać.

Dodaj miejsce

 

Po wybraniu pola szerokości i długości geograficznej zostaną wypełnione automatycznie. Moje mapy są również zintegrowane z miejscami Google! Oznacza to, że możesz wyszukać sklep lub cokolwiek innego, co jest zarejestrowane w Google Maps, nasz komponent otrzyma wszystkie informacje o miejscu.

Miejsce Google

 

 

 

Możesz także poruszać się po mapie i umieścić znacznik bezpośrednio, wynik będzie taki sam, a otrzymasz automatycznie szerokość i długość geograficzną.

 

Uważaj z polem adresu i kodem pocztowym, jeśli wypełnisz go ręcznie, musi on pasować do znanego adresu Google Maps.

 

Wszystkie inne informacje o lokalizacji (opis, godziny, ...) są wyświetlane w szczegółowym widoku lokalizacji.

Łącze do kontaktu w edycji szczegółów lokalizacji to możliwość dodania łącza do kontaktu, mailto lub adresu URL na lokalizację. Na froncie pojawi się przycisk kontaktowy, który otworzy adres URL lub wykona akcję mailto.

2.4 Inne informacje o lokalizacji

W każdej lokalizacji możesz dodać obraz i znacznik.

  • Obraz zostanie wyświetlony jako miniatura w podpowiedzi lokalizacji i w większym rozmiarze na stronie szczegółów lokalizacji.
  • Znaczniki będą wyświetlane na mapie jako ikona znacznika lokalizacji. Dostałeś też kilka ładnych zestawów znaczników dla swoich lokalizacji zawartych w rozszerzeniu My Maps Location.
  • Użyj niestandardowego linku zastąpi link do szczegółu lokalizacji niestandardowym adresem URL.

 

marker-image-lokalizacja

 

My Maps location używa wielojęzycznej funkcji Joomla. Możesz zdefiniować język w kategoriach lokalizacji i lokalizacji. W przypadku zmiany języka lokalizacje będą filtrowane jak każda inna zawartość Joomla w celu wyświetlenia treści zatwierdzonej przez język.

Pole opisu lokalizacji jest jednym z najważniejszych.
Zostanie on wyświetlony na stronie szczegółów lokalizacji i, w zależności od tematu, jako tekst wstępny lokalizacji w wynikach wyszukiwania. Co ważniejsze, opis jest edytorem WYSIWYG z całą wtyczką ładowaną wewnątrz, oznacza to, że możesz w nim wszystko, co chcesz (obrazy, filmy ...).

 

Oto tekst wstępu wyświetlany w wynikach wyszukiwania lokalizacji.

 

Pole znacznika jest tym samym systemem znaczników, co Joomla. Możesz dodać tagi i tagi podrzędne, a następnie załadować je w interfejsie jako filtr. Aby zarządzać wszystkimi tagami, po prostu załaduj komponent znacznika Joomla: Składnik menu> Tagi
W frontend, w zależności od konfiguracji, tagi mogą być wyświetlane jako pole wyboru (jak poniżej) lub jako lista rozwijana.

 

My Maps Location dostał dodatkowe pola do wypełnienia metadanych (dla wyszukiwarek). Te pola są ładowane na stronie szczegółów lokalizacji.

2.5 Wyświetl lokalizacje na frontend

Aby wyświetlić swoje lokalizacje na froncie, możesz użyć:

  • Menu do wyświetlania wyszukiwarki lokalizacji, pojedynczej lokalizacji lub kategorii lokalizacji
  • Moduł do wyświetlania pola wyszukiwania lub wyboru zestawu lokalizacji
  • Przycisk edytora do wyświetlania pojedynczych lub wielu lokalizacji w dowolnym edytorze

Załaduj lokalizacje z menu

Z menedżera menu Joomla dodaj element i wybierz jako typ „Wyszukiwanie i wyświetlanie lokalizacji”. Wyświetli wyszukiwarkę lokalizacji z filtrami.
Wybierz „Widok szczegółów lokalizacji” aby wyświetlić jedną predefiniowaną lokalizację.

 

Jeśli wybierzesz „Wyszukiwanie i wyświetlanie lokalizacji” masz kilka parametrów wyświetlania. Niektóre mogą zastąpić strona głównayślne parametry komponentu.

 

Z głównej karty menu możesz skonfigurować:

  • Podaj adres: możesz wymusić wyświetlenie strona głównayślnego adresu podczas ładowania strony. Można go pozostawić pustym
  • Dystans: odległość do szukania blokady, odwołując się do powyższego adresu. Można go pozostawić jako -1 (strona głównayślnie)
  • Kategoria: załaduj określoną kategorię lokalizacji
  • Limit wyszukiwania: ograniczyć liczbę wyników wyszukiwania. 10 zwróci 10 pierwszych wyników wyszukiwania w lokalizacji
  • Zamawianie: zamów wyniki wyszukiwania według daty, tytułu, odległości (strona głównayślnie)

 

mml-menu-advanced

Potem na Karta menu My Maps Location, możesz skonfigurować:

  • Wybierz komponent: My Maps Location lub cała integracja z innymi firmami, np. K2, Jomsocial ...
  • strona głównayślny identyfikator kategorii (Rozszerzenia innych firm): strona głównayślna kategoria do załadowania, gdy używane jest rozszerzenie trzeciej strony, takie jak K2, Hikashop lub Adsmanager, ID listy CB dla konstruktora społeczności
  • Lokalizacje kategorii dzieci: Wyświetlaj także jako lokalizacje wyników wyszukiwania z podkategorii, nie tylko tej wybranej powyżej
  • Motyw: wybierz jeden z 3 strona głównayślnych motywów, pełną szerokość i pasek boczny tematu wyszukiwania i wyświetlania wyników dostępnych dla elementu menu
  • Dostawca map: Wybierz Mapy Google, Mapy Bing, Mapbox, OpenStreetMap lub Mapquest, aby stylować swoje Mapy
  • Włącz tagi wyszukiwania: Umożliwia wykonywanie zapytań przy użyciu nazw znaczników lokalizacji
  • Projekty: W zależności od źródła mapy masz kilka typów map i kolorów
  • Warstwa mapy: Dodaj kilka danych (warstw) do map. Istnieje warstwa KML, warstwa ruchu, warstwa tranzytowa i warstwa rowerowa.
  • Adres URL warstwy mapy Google: Użyj warstwy danych do przechowywania własnych danych lub do wyświetlania danych GeoJSON na mapie Google
  • Typ Bing Maps: Jeśli Bing Maps jest Twoim dostawcą map, wybierz wygląd i dane Bing Maps
  • Typ OpenStreetMap: Jeśli OpenStreetMap jest Twoim dostawcą map, możesz dodać do siebie mapy danych (warstw)
  • Etykieta lokalizacji: Po załadowaniu mapy automatycznie otwórz etykietę lokalizacji po wyszukiwaniu lokalizacji
  • Powiększenie mapy: Zdefiniuj strona głównayślny poziom powiększenia na mapie
  • Opcje szerokości i wysokości mapy i wyników wyszukiwania

 

Frontendowy wyświetlacz oparty na motywie

 

Wynik dla pojedynczego ekranu wyszukiwania lokalizacji:


Wyświetl lokalizacje za pomocą modułu

My maps location jest wyposażony w 2 moduły dla lokalizacji rodzimych + inne dla integracji z innymi firmami (np. Moduł do wyświetlania lokalizacji elementów K2)

Moduł Mapa umożliwia wyświetlanie lokalizacji z tymi samymi filtrami, co menu, ale w pozycji modułu. Lokalizacje będą wyświetlane jako Mapa lub Lista. Możesz wybrać zestaw lokalizacji lub wybrać kategorie lokalizacji.

moduł mapy

My Maps Location - moduł wyszukiwania wyświetli wyszukiwarkę z niektórymi filtrami jako opcją, taką jak szerokość mapy lub komponent, w którym lokalizacja zostanie przeszukana (wyszukaj lokalizację K2 tylko dla przykładu).

 

Moduł wyświetlania na nakładce:

 

 

Wyświetl lokalizacje za pomocą przycisku edytora


Przycisk edytora zostanie załadowany do edytora Joomla (zwykle w artykułach lub niestandardowych modułach HTML). Zobaczysz przycisk na dole edytora.
Po kliknięciu zobaczysz lightbox, który pozwala wybrać jedną lub kilka lokalizacji dodanych wcześniej.

 

Następnie możesz wybrać jedną lub kilka lokalizacji i nacisnąć przycisk, aby dodać go do artykułu. Jeśli nie określisz żadnego poziomu powiększenia, zostanie on automatycznie załadowany w celu dopasowania do obszaru lokalizacji.
Kod tagu, który zobaczysz w edytorze WYSIWYG, będzie podobny do tego modelu: {mymaplocations mapid width height}

Np .: {mymaplocation id = 1 width = 58% height = 400px zoom = 10 type = google} ten kod wyświetli mapę z identyfikatorem lokalizacji = 1, o szerokości 58%, wysokości 400 pikseli, 10-krotnym powiększeniu i typie Google. Za pomocą przecinka dodaj więcej niż jedną lokalizację na mapie. Np .: {mymaplocation id = 1 width = 58% height = 400px zoom = 10 type = google} ID lokalizacji = 1, 2, 3.

 

III. ZGŁASZANIE LOKALIZACJI FRONTEND

3.1 Dodawanie lokalizacji i zarządzanie nimi

My maps location oferuje opcję przesyłania i zarządzania własnymi lokalizacjami z interfejsu użytkownika. Najpierw musisz utworzyć menu, które pozwala na przesłanie frontendu.

Z menedżera menu Joomla dodaj element i wybierz jako typ „Dodaj lokalizacje”. Następnie, klikając na niego, użytkownicy zostaną przekierowani, po zalogowaniu, do formularza przesyłania lokalizacji.
Menu „Moje lokalizacje” pozwala użytkownikowi edytować wcześniej przesłane lokalizacje.

 

Przegląd formularza menu interfejsu:

 

3.2 Ograniczenie dostępu

Proces składania i edycji frontendu jest kontrolowany przez ACL Joomla. Aby edytować, kto może przesyłać i edytować lokalizację, kliknij Komponenty> My Maps Location> Opcje> Uprawnienia.
Stamtąd możesz kontrolować grupę użytkowników Joomla, która jest w stanie:

  • Utwórz lokalizacje
  • Usuń lokalizacje
  • Edytuj lokalizacje
  • Edytuj stan publikacji
  • Edytuj własne lokalizacje

 

IV. IMPORT - MIEJSCA EKSPORTOWE

My Maps location dostał narzędzie do importu - eksportu - synchronizacji do lokalizacji z pliku .csv lub .kml (plik Google Earth). Kliknij na menu My Maps Location> Import / Eksport aby uzyskać dostęp do interfejsu.

 

Z tego interfejsu możesz:

  • Importuj lokalizacje z pliku .csv lub .kml
  • Eksportuj lokalizacje z pliku .csv lub .kml
  • Dokonaj aktualizacji (synchronizacji) lokalizacji z pliku .csv lub .kml

 

Uwaga: przycisk synchronizacji działa również po dodaniu lokalizacji bezpośrednio do bazy danych

V. SZUKAJ STATYSTYK

Możesz przeglądać statystyki wyszukiwania lokalizacji, włączając parametr Włącz statystyki na Ustawienia> karta Konfiguracja ogólna.

miesięcy statystycznych

Możesz zobaczyć listę najlepszych lokalizacji poniżej Eksport to także z plikiem typu .csv.

statystyka eksportu

VI. PARAMETRY

6.1 Ustawienia

Komponent ma wiele opcji, niektóre mogą być nadpisane w widoku menu, jak widzieliśmy wcześniej. Kliknij na menu: My Maps Location> Opcje aby uzyskać dostęp do interfejsu (prawy górny róg ekranu)

Tab1: Ogólna konfiguracja

Parameters1

 

  • Włącz statystyki: Włącz statystyki lokalizacji
  • Wyszukiwanie AJAX: Włącz zapytania w AJAX, wykonaj wyszukiwanie bez przeładowywania strony
  • Odległość wyświetlania: Wyświetl odległość lokalizacji od pozycji użytkownika
  • Jednostka odległości: Mile lub kilometry
  • Dostawca map: wybierz pomiędzy Google Maps, Microsoft Bing map, Mapbox, Openstreetmap + Leaflet lub Mapquest
  • Wyszukiwanie autouzupełniania: Sugestie autouzupełniania podczas wyszukiwania lokalizacji. Sugestie dotyczące autouzupełniania mogą pochodzić z Google Maps, Bing Maps lub Openstreetmap, niezależnie od wybranego systemu map
  • Za każdym razem, gdy korzystasz z interfejsów API Map Google, jeśli strona głównaena została utworzona po 22 czerwca 2016 r., Musisz dołączyć klucz, potwierdzić żądanie.
    Więcej informacji: https://developers.google.com/maps/documentation/javascript/usage?hl=en
    Zdobądź klucz: https://developers.google.com/maps/documentation/javascript/get-api-key
  • Typ Google Maps: typ mapy: mapa drogowa, satelita, hybrydowy lub terenowy
  • Projekt mapy: Wybierz strona głównayślny projekt swoich map
  • Przewiń mapę myszy: Włącz powiększanie / pomniejszanie za pomocą myszy, gdy najedziesz na mapę
  • Przeciągnij mapę: Włącz przeciąganie mapy, aby poruszać się po niej za pomocą myszy
  • Znacznik zdarzenia otwartego: Sposób otwierania szczegółów lokalizacji po kliknięciu lub najechaniu na znacznik
  • Włącz klastrowanie znaczników: Każdy klaster, który ma więcej niż jeden znacznik, pokazuje liczbę znaczników wewnątrz klastra
  • Funkcja Autozoom: automatycznie dostosuj zoom, aby wyświetlić wszystkie znaczniki na mapie
  • Typ Bing Maps: typ mapy: Antena, Oko ptaka lub Droga
  • Klucz API map Bing: umieść klucz API, aby to działało;)

 

Parameters2

 

  • Wyszukiwanie w dowolnym miejscu: dodaj opcję wyszukiwania promienia, aby wyszukać w dowolnym miejscu na świecie
  • Wyszukaj w dowolnym miejscu strona głównayślnie: strona głównayślnie selektor promienia w widoku wyszukiwania zostanie ustawiony na Anywhere
  • Format tagów podczas wyszukiwania: wyświetl filtry znaczników jako pole wyboru lub listę rozwijaną
  • Widok ulicy: Dodaj widok ulicy w opcji wyszukiwania jako opcję
  • Wyświetl trasę: Wyświetl link, aby obliczyć trasę z pozycji użytkownika
  • Format trasy: wyświetlić trasę na My Maps location lub przekierować do Google
  • Link do kontaktu w lokalizacji: Dodaj link do strony kontaktu
  • Przycisk kontaktu: wyświetl przycisk kontaktu
  • Link do celu kontaktu: Otwórz tryb łącza kontaktu
  • strona głównayślne powiększenie mapy: strona głównayślny poziom powiększenia na mapie przy pierwszym ładowaniu (ustaw autozoom na no)
  • Rozmiar mapy: mapa i wyniki wyszukiwania szerokość i wysokość
  • Odległość do wyszukiwania promienia: określ wartości listy rozwijanej wyszukiwania promienia
    Dawny. Użytkownik może wybrać wyszukiwanie 10 mil wokół miasta Nowy Jork.
  • Wyświetl listę wyboru odległości: opcja wyświetlania listy wyboru wyszukiwania odległości

 

Parameters3

 

  • Uprawa programu Word w wynikach wyszukiwania: przyciąć opis lokalizacji z określoną ilością słów w wynikach wyszukiwania
  • Pasek boczny JQuery: zmień strona głównayślny pasek boczny na JQuery (mniejszy i gładki efekt przewijania)
  • Wyłącz geolokalizację: wyłącz geolokalizację na stronie innej niż https.
  • Wyłącz filtr kategorii: ta opcja włącza filtr listy rozwijanej kategorii
  • Wyłącz filtr stanu kraju: wyświetl listę rozwijaną stanu kraju w widoku wyszukiwania
  • Szukaj według kodu pocztowego: Wyszukaj według pola Kod pocztowy
  • Kolor przycisku OR: Kolor przycisku „LUB” na strona głównayślnym motywie
  • Kolor przycisku: Kolor przycisku „Geolocate me” na strona głównayślnym motywie
  • Globalny kolor czcionki: użyj tej opcji, aby ustawić globalny kolor czcionki w lokalizacjach Mojej mapy
  • Zdjęcie w tle: obraz w tle wyszukiwania strona głównayślnego motywu
  • Zaznaczasz: dodaj pozycję na mapie i wybierz obraz jako znacznik
  • strona głównayślny obraz ikony: użyj strona głównayślnego obrazu ikony, jeśli ikona nie jest dostępna
  • Pomiń pomocnika: wygeneruj standardowy plik zastępujący układ Joomla, na który nie będą miały wpływu aktualizacje rozszerzeń (w folderze / html)

 

6.2 Bing jako źródło mapy

Aby korzystać z Bing Maps firmy Microsoft jako źródła mapy, musisz wypełnić klucz API w globalnej konfiguracji My Maps location. Strona Bing jest tutaj: https://www.bingmapsportal.com/

 

Musisz utworzyć darmowe konto i skopiować kod klucza API ze swojego konta.

 

Następnie będziesz mógł użyć mapy Bing jako źródła mapy z konfiguracji globalnej (aby ją włączyć strona głównayślnie) lub z pozycji menu.

 

 

6.3 Mapbox jako źródło mapy

Aby korzystać z Mapbox, niestandardowej platformy mapowania dla programistów, jako źródło mapy musisz wypełnić API Mapbox w Konfiguracja My Maps location> Dostawcy map.
Strona główna Mapbox jest tutaj, musisz utworzyć darmowe konto stamtąd: https://www.mapbox.com/

mapbox-home

 

Stamtąd możesz utworzyć nowy projekt strony lub użyć zalecanego i zapisać go na swoim koncie.

styl mapy

 

Aby uzyskać poświadczenia, użyj menu Konto (w prawym górnym rogu):

  • Mapbox API: użyj menu Konto> Tokeny dostępu

Dostajesz jeden klucz na utworzony styl mapy.

 

mapbox-apikey

 

Następnie skopiuj go w konfiguracji My Maps location, aby go użyć.

 

mapbox-config