My Maps location documentatie

Invoering

Laat uw gebruikers zoeken naar locaties en de weergave configureren zoals u wilt. My maps location is gewoon de meest geavanceerde Google Maps-integratie voor Joomla.

Belangrijkste kenmerken:

  • Zoeken naar locaties die u heeft gemaakt
  • Automatische geolocatie
  • Mapbron kan Google Maps, Bing maps of Mapbox zijn
  • Voeg kaartontwerp toe
  • Informatie opvragen van Google-plaatsen
  • Locaties importeren / exporteren / synchroniseren vanuit .csv-bestand
  • Frontend locatie indienen
  • Veel uitbreidingsintegraties van derden

I. MY MAPS LOCATION INSTALLEREN & UPDATEN

1.1 Installeren

Ons onderdeel is Joomla 3.x compatibel. Alle functies en integraties van derden zijn opgenomen in alle lidmaatschappen.
Om onze component te installeren, moet je het extensie .zip-bestand downloaden en het standaard Joomla-installatieprogramma gebruiken.

Klik vervolgens op Bladeren> Uploaden en installeren, component, modules en plug-ins worden standaard geactiveerd.

1.2 Update en automatische updater

Om My Maps location bij te werken, kun je een nieuwe versie over de oude versie installeren door het ZIP-bestand van JoomUnited te downloaden of de automatische updater te gebruiken (aanbevolen).

MML update

 

De automatische updater, die de updatemelding pusht, is ingesloten in de Joomla-extensie die u hebt geïnstalleerd. U krijgt dus een melding zoals elke andere extensie in het dashboard of via het menu: Uitbreiding> Beheer> Update menu.

 

Meld u aan om uw account bij te werken

U moet inloggen op uw JoomUnited-account om al uw JoomUnited Joomla-extensies te updaten. Om toegang te krijgen tot de hoofdconfiguratie van het onderdeel, klikt u op de Live update-tabblad. Onderaan vindt u een inlogknop.

Voer uw Joom United referenties in, dezelfde die u gebruikt om hier in te loggen @ www.joomunited.com

 

De knop wordt oranje, gefeliciteerd! je kunt nu alle Joom United-extensies op deze website bijwerken! Als uw lidmaatschap is verlopen, krijgt u een vernieuwingslink en een tekst die dat verklaart.

Opmerking: met één enkele login kunt u alle JoomUnited-extensies bijwerken (met betrekking tot uw lidmaatschap). Inloggen verloopt niet tenzij u de verbinding verbreekt.

II. LOCATIES EN CATEGORIEEN

2.1 Download een Google Maps API-sleutel

Telkens wanneer u de Google Maps API's gebruikt en uw domein is gemaakt na 22 juni 2016, moet u een sleutel toevoegen om uw aanvraag te valideren.
Een sleutel ophalen en API inschakelen: https://developers.google.com/maps/documentation/javascript/get-api-key

Meer informatie: https://developers.google.com/maps/documentation/javascript/usage?hl=en

De eerste stap is om een ​​project te creteren en

Typ vervolgens de naam van het project. Als ik alle verzoeken van mijn domein wil toestaan, is het volgende patroon * .joomunited.com / *
Als u slechts één domein wilt toestaan, bijvoorbeeld mijndomein.com, dan is patroon joomunited.com/*


In een localhost-omgeving kunt u elke geldige sleutel plaatsen en deze werkt zonder dat u naar een domein hoeft te verwijzen.


De API-sleutel wordt vervolgens gegenereerd, dit is de sleutel die u moet kopiëren om toe te voegen aan My Maps location.

Voeg de sleutel toe aan My Maps Location.

Van de Componenten> My Maps Location> Optieweergave, u kunt een sleutel toevoegen aan de configuratie.

 

Plak de sleutel.

 

Stap voor stap hervat:


Dus de stappen die ik volg zijn

  • Ga naar de Google API-console
  • Maak of selecteer een project
  • Klik op Doorgaan met om de API en alle gerelateerde services in te schakelen
  • Op de pagina Credentials krijgt u een Browsertoets (en stel de API-referenties in)
  • Om diefstal van quota te voorkomen, beveiligt u uw API-sleutel als volgt die best practices

2.2 Beheer categorieën van locatie

Locatie zijn ingedeeld in categorieën. Deze categorieën kunnen worden weergegeven als filter in de frontend of worden gebruikt als een vooraf gedefinieerde parameter in een menu-item om een ​​aantal gecategoriseerde locaties te laden.
 

 

Als u veel locaties heeft, wordt u geadviseerd om categorieën te gebruiken. U kunt categorieën en subcategorieën maken.
Ga naar binnen om een ​​categorie te maken My Maps location> Categorie en klik op Nieuw


 

Vervolgens moet u in het categoriescherm een ​​titel en een bovenliggende categorie toevoegen voor het geval u een subcategorie wilt maken

U kunt ook een standaardmarkering voor locatie in de ctaegorie definiëren met behulp van het tabblad Markerselectie

 

Opmerking: een categorie wordt standaard gemaakt met de naam "Mijn categorie" zodat u locaties direct na de installatie kunt toevoegen

2.3 Maak een locatie

Ga naar binnen om een ​​locatie te maken My Maps location> Locaties> Nieuw

Er zijn 3 verplichte velden:

  • Naam van de locatie
  • Categorie van de locatie
  • Locatiegegevens (adres)

 

Voor het adres kreeg je 3 oplossing om het toe te voegen:

  • Gebruik het zoekveld (aanbevolen)
  • Navigeer naar de kaart en gebruik de cursor om naar een locatie te wijzen
  • Vul een adres in (moet Google Maps geldig zijn)

 

Als u een locatie met de zoekmachine wilt toevoegen, typt u de naam van de plaats die u wilt toevoegen.

Voeg locatie toe

 

Bij selectie worden de velden voor de breedte- en lengtegraad automatisch ingevuld. Mijn kaarten zijn ook geïntegreerd met Google-plaatsen! Het betekent dat u kunt zoeken naar een winkel of iets anders dat is geregistreerd op Google Maps, ons onderdeel krijgt alle plaatsinformatie.

Google-plaats

 

 

 

U kunt ook op de kaart gaan en een markering rechtstreeks plaatsen, het resultaat is hetzelfde en u krijgt automatisch een breedte- en lengtegraad.

 

Wees voorzichtig met het adresveld en de postcode als u deze handmatig invult, deze moet overeenkomen met een bekend adres van Google Maps.

 

Alle andere informatie over de locatie (beschrijving, uren, ...) wordt weergegeven in het gedetailleerde overzicht van de locatie.

De contactlink in de detaileditie van de locatie, is de mogelijkheid om een ​​contactkoppeling, mailto of URL per locatie toe te voegen. Op de frontend zal het een contactknop zijn die de URL opent of de mailto-actie uitvoert.

2.4 Andere locatie-informatie

Op elke locatie kunt u een afbeelding en een markering toevoegen.

  • Afbeelding wordt weergegeven als een miniatuur in de tooltip van de locatie en op een groter formaat op de locatiedetailpagina.
  • Markeringen worden op de kaart weergegeven als pictogram voor locatiemarkeringen. Je hebt ook een aantal leuke markeersets voor je locaties opgenomen in de extensie My Maps Location.
  • Gebruik een aangepaste koppeling overschrijft de koppeling naar het detail van de locatie door een aangepaste URL.

 

marker-image-locatie

 

My Maps location gebruikt de meertalige functie van Joomla. U kunt een taal definiëren in locatielocaties en locaties. Bij taalomschakeling worden locaties gefilterd zoals elke andere Joomla-inhoud om de door de taal goedgekeurde inhoud weer te geven.

Het veld met locatiebeschrijvingen is een van de belangrijkste.
Het wordt weergegeven op de locatiedetailpagina en, afhankelijk van het thema, als introtekst van de locatie in de zoekresultaten. Belangrijker nog, de beschrijving is een WYSIWYG-editor met alle plug-ins erin geladen, dit betekent dat je alles kunt gebruiken wat je wilt (afbeeldingen, video's ...).

 

Dit is de introtekst die wordt weergegeven in de zoekresultaten voor locaties.

 

Het tagveld is hetzelfde labelsysteem als Joomla. U kunt tags en subtags toevoegen en deze als filter in de frontend laden. Als u alle tags wilt beheren, laadt u gewoon de Joomla-tagcomponent: Menucomponent> Tags
Op de frontend kunnen tags, afhankelijk van de configuratie, worden weergegeven als checkbox (zoals hieronder) of als een vervolgkeuzelijst.

 

My Maps Location kreeg extra velden om meta-informatie te vullen (voor zoekmachines). Deze velden worden geladen op de locatiedetailpagina.

2.5 Toon locaties op frontend

Om uw locaties op frontend weer te geven, kunt u het volgende gebruiken:

  • Een menu om locatiezoekmachine, enkele locatie of categorie locaties weer te geven
  • Een module om een ​​zoekveld weer te geven of een reeks locaties te selecteren
  • Een editor-knop om enkele of meerdere locaties in een editor weer te geven

Laad locaties vanuit een menu

Voeg vanuit het Joomla menu manager een element toe en selecteer als type "Locatie zoeken en weergeven". Het geeft de locatiezoekmachine weer met filters.
kiezen "Locatiedetailweergave" om een ​​enkele vooraf gedefinieerde locatie weer te geven.

 

Als u selecteert "Locatie zoeken en weergeven" je hebt enkele weergaveparameters. Sommige kunnen standaardcomponentparameters overschrijven.

 

Via het hoofdtabblad van het menu kunt u het volgende instellen:

  • Adres invoeren: u kunt een standaardadres dwingen om te worden weergegeven bij het laden van de pagina. Het kan leeg worden gelaten
  • Afstand: de afstand om het zoeken te vergrendelen, verwijzend naar het bovenstaande adres. Het kan worden overgelaten als -1 (standaard)
  • Categorie: laad een specifieke categorie van locaties
  • Zoeklimiet: beperk het aantal zoekresultaten. 10 retourneert alleen de 10 eerste resultaten bij het zoeken naar locaties
  • Bestellen: bestel zoekresultaten op datum, titel, afstand (standaard)

 

MML-menu geavanceerde

Dan op de My Maps Location menutab, je kunt instellen:

  • Selecteer onderdeel: My Maps Location of alle integratie van derden zoals K2, Jomsocial ...
  • Standaardcategorie ID (Extensies van derden): standaardcategorie die moet worden geladen wanneer een externe extensie wordt gebruikt, zoals K2, Hikashop of Adsmanager, CB-lijst-ID voor community-builder
  • Locaties van kindercategorieën: Toon ook als locaties van zoekresultaten uit subcategorieën, niet alleen degene die hierboven is geselecteerd
  • Thema: selecteer een van de 3 standaardthema's, volledige breedte en zijbalk van het zoek- en resultaatweergavethema dat beschikbaar is voor het menu-item
  • Kaartprovider: Selecteer Google Maps, Bing Maps, Mapbox, OpenStreetMap of Mapquest om uw kaarten op te maken
  • Zoekmarkeringen inschakelen: Hiermee kunnen zoekopdrachten worden uitgevoerd met behulp van locatietagnamen
  • designs: Afhankelijk van de kaartbron hebt u verschillende kaarttypen en kleuren
  • Kaartlaag: Voeg wat gegevens (laag) toe aan je kaarten. Er zijn een KML-laag, verkeerslaag, doorvoerlaag en fietslaag.
  • Google Map Layer-URL: Gebruik de gegevenslaag om uw aangepaste gegevens op te slaan of GeoJSON-gegevens weer te geven op een Google-kaart
  • Type Bing-kaarten: Als Bing Maps uw kaartprovider is, selecteert u het uiterlijk en de gegevens van Bing Maps
  • OpenStreetMap-type: Als OpenStreetMap uw kaartprovider is, kunt u enkele gegevens (lagen) aan uw kaarten toevoegen
  • Locatie tooltip: Bij het laden van de kaart opent automatisch de tooltip voor locaties na het zoeken naar locaties
  • Kaartzoom: Definieer een standaard zoomniveau op de kaart
  • Kaart- en zoekresultaten breedte- en hoogte-opties

 

Frontend display op basis van thema

 

Resultaat voor een zoekscherm voor één locatie:


Locaties weergeven met behulp van een module

My maps location wordt geleverd met 2 modules voor native locaties + andere voor integratie door derden (zoals een module om K2-itemlocaties weer te geven)

De kaartmodule kunt u uw locaties weergeven met dezelfde filters als het menu, maar in een modulepositie. De locaties worden weergegeven als Kaart of Lijst. U kunt een set locaties selecteren of locatiecategorieën selecteren.

map-module

My Maps Location - Zoekmodule zal een zoekmachine weergeven met enkele filters als optie zoals de breedte van de kaart of de component waarin de locatie zal worden doorzocht (zoek alleen naar K2-locatie voor een voorbeeld).

 

Display module op frontend:

 

 

Locatie weergeven met een editor-knop


De editor-knop wordt geladen in uw Joomla-editor (meestal in artikelen of aangepaste HTML-modules). Je ziet de knop onderaan je editor.
Als u op klikt, ziet u een lightbox waarmee u een of meer locaties kunt selecteren die u eerder hebt toegevoegd.

 

Vervolgens kunt u een of meer locaties selecteren en op de knop drukken om deze in uw artikel toe te voegen. Als u geen zoomniveau opgeeft, wordt het automatisch geladen zodat het in uw locatiegebied past.
De tagcode die u in uw WYSIWYG-editor ziet, is als dit model: {mymaplocations mapid width height}

Voorbeeld: {mymaplocation id = 1 width = 58% height = 400px zoom = 10 type = google} deze code geeft een kaart weer met de locatie-ID = 1, met 58% breedte, 400 px hoogte, 10 keer zoomen en Google-type. De komma gebruiken om meer dan één locatie op een kaart toe te voegen. Voorbeeld: {mymaplocation id = 1 width = 58% height = 400px zoom = 10 type = google} de locatie-ID = 1, 2, 3.

 

III. FRONTEND LOCATION SUBMISSION

3.1 Locaties toevoegen en beheren

My maps location biedt de mogelijkheid om uw eigen locaties vanuit frontend in te dienen en te beheren. Eerst moet u een menu maken dat de verzending van de frontend toestaat.

Voeg vanuit het Joomla menu manager een element toe en selecteer als type "Voeg locaties toe". Door er vervolgens op te klikken, worden gebruikers na het inloggen omgeleid naar een formulier voor het indienen van locaties.
Het menu "Mijn locaties" stelt de gebruiker in staat om zijn eerder ingeleverde locaties te bewerken.

 

Overzicht frontend menu-formulier:

 

3.2 Toegangsbeperking

Het frontend-inzendings- en -uitgifteproces wordt beheerd door Joomla ACL. Als je wilt bewerken wie de locatie mag verzenden en bewerken, klik je op Componenten> My Maps Location> Opties> Toestemmingen.
Van daaruit kun je regelen welke Joomla-gebruikersgroep in staat is om:

  • Maak locaties
  • Locaties verwijderen
  • Bewerk locaties
  • Bewerk de publicatiestatus
  • Bewerk eigen locaties

 

IV. IMPORT - EXPORT LOCATIES

My Maps location heeft een Import - Export - Synchronisatie tool voor locatie van een .csv of .kml bestand (Google Earth bestand). Klik op de menu My Maps Location> Importeren / exporteren om toegang te krijgen tot de interface.

 

Vanuit deze interface kunt u:

  • Locaties importeren vanuit een .csv- of .kml-bestand
  • Locaties exporteren vanuit een .csv- of .kml-bestand
  • Voer een update (synchronisatie) van de locaties uit een .csv- of .kml-bestand uit

 

Opmerking: de knop Sync werkt ook als u de locatie rechtstreeks in de database hebt toegevoegd

V. ZOEKSTATISTIEKEN

U kunt de statistieken van uw zoekactie op locatie bekijken door Parameters voor statistiek inschakelen in te schakelen bij Instellingen> tabblad Algemene instellingen.

statistiek maanden

En je kunt de lijst met toplocaties hieronder zien, dat kan Exporteren het met .csv-bestandstype ook.

export-statistiek

VI. PARAMETERS

6.1 Instellingen

Het onderdeel heeft veel opties, sommige kunnen worden genegeerd in de menuweergave zoals we eerder hebben gezien. Klik op de menu: My Maps Location> Opties om toegang te krijgen tot de interface (rechtsboven op het scherm)

Tab1: Algemene configuratie

Parameters1

 

  • Statistieken inschakelen: Schakel locatiestatistieken in
  • AJAX zoeken: Schakel de zoekopdrachten in AJAX in, voer een zoekopdracht uit zonder de pagina opnieuw te laden
  • Display afstand: Toon de afstand van de locatie tot de gebruikerspositie
  • Eenheid van afstand: Miles of kilometers
  • Kaartprovider: kies tussen Google maps, Microsoft Bing maps, Mapbox, Openstreetmap + Leaflet of Mapquest
  • Zoekopdracht automatisch aanvullen: Suggesties automatisch aanvullen bij het zoeken naar locaties. Suggesties voor automatisch aanvullen kunnen afkomstig zijn van Google Maps, Bing Maps of Openstreetmap, ongeacht het kaartsysteem dat u hebt gekozen
  • Elke keer dat u de Google Maps API's gebruikt en uw domein is gemaakt na 22 juni 2016, moet u een sleutel toevoegen, om uw aanvraag te valideren.
    Meer informatie: https://developers.google.com/maps/documentation/javascript/usage?hl=en
    Krijg een sleutel: https://developers.google.com/maps/documentation/javascript/get-api-key
  • Type Google Maps: kaarttype: Roadmap, Satellite, Hybrid of Terrain
  • Kaartontwerp: Selecteer een standaardontwerp voor uw kaarten
  • Scroll muis kaart: Schakel het inzoomen / uitzoomen met de muis in als u de kaart zweeft
  • Sleep kaart: Schakel in om de kaart te verslepen om eroverheen te gaan, met behulp van de muis
  • Open evenement marker: Hoe het locatiedetail wordt geopend wanneer u op een marker klikt of deze verplaatst
  • Schakel markercluster in: Elke cluster met meer dan één markering toont een telling van het aantal markeringen in de cluster
  • Autozoom-functie: pas de zoomfactor automatisch aan om alle markeringen van de kaart weer te geven
  • Type Bing-kaarten: kaarttype: luchtfoto, vogeloog of weg
  • Bing maps API-sleutel: zet een API-sleutel om het te laten werken;)

 

Parameters2

 

  • Overal zoeken: voeg de optie in de straalzoekopdracht toe om overal in de wereld te zoeken
  • Zoek overal standaard: standaard wordt de radiusselector in de zoekweergave ingesteld op Overal
  • Tag-indeling in zoekopdracht: toon de tagfilters als selectievakje of vervolgkeuzelijst
  • Street view: Voeg straatweergave toe als optie voor zoeken
  • Display Route: Geef een link weer om de route te berekenen vanaf de positie van de gebruiker
  • Route-indeling: toon de route op My Maps location of doorverwijs naar Google
  • Contactlink op locatie: Voeg een link toe aan een contactpagina
  • Contactknop: toon de contactknop
  • Doel van de contactlink: Open de contactkoppelingsmodus
  • Standaard zoomkaart: Standaard zoomniveau op de kaart bij eerste lading (zet autozoom op nee)
  • Kaart grootte: kaart en zoekresultaten breedte en hoogte
  • Afstand voor zoeken op radius: bepaal de waarden van de vervolgkeuzelijst radius zoeken
    Ex. De gebruiker kan kiezen om 10 mijl rond de stad New-York te zoeken.
  • Toon afstandselectielijst: optie om de redius-zoekselectielijst voor afstand weer te geven

 

Parameters3

 

  • Woorduitsnijden in zoekresultaten: snijd de locatiebeschrijving bij een bepaald woord in de zoekresultaten bij
  • JQuery zijbalk: verander de standaardzijbalk naar een JQuery-een (kleiner en vloeiend scroll-effect)
  • Geolocatie uitschakelen: geolocatie uitschakelen op niet-https-site.
  • Schakel categoriefilter uit: Met deze optie wordt de vervolgkeuzelijst voor categorieën ingeschakeld
  • Landstaat filter uitschakelen: een vervolgkeuzemenu voor de landstatus weergeven in de zoekweergave
  • Zoeken op postcode: Zoeken op postcode veld
  • Kleur voor OK-knop: "OF" knop kleur op standaardthema
  • Knop kleur: "Geolocate me" knop kleur op standaardthema
  • Algemene lettertypekleur: gebruik deze optie om de algemene lettertypekleur van Mijn kaartlocaties in te stellen
  • Achtergrond afbeelding: afbeelding op de achtergrond van de zoekopdracht op standaardthema
  • Jij marker: voeg je positie toe op de kaart en selecteer een afbeelding als markering
  • Standaard pictogramafbeelding: gebruik de standaard pictogramafbeelding als het pictogram niet beschikbaar is
  • Helper negeren: een Joomla-standaard opmaakbestand genereren dat niet wordt beïnvloed door extensie-updates (in / html-map)

 

6.2 Bing als kaartbron

Als u Bing Maps van Microsoft als kaartbron wilt gebruiken, moet u een API-sleutel invullen in de algemene configuratie van My Maps location. De Bing-pagina is hier: https://www.bingmapsportal.com/

 

U moet hier een gratis account maken en de API-code van uw account kopiëren.

 

Vervolgens kunt u de Bing-kaart gebruiken als kaartbron in de algemene configuratie (om deze standaard in te schakelen) of in het menu-item.

 

 

6.3 Mapbox als kaartbron

Om Mapbox, het aangepaste kaartplatform voor ontwikkelaars, als kaartbron te gebruiken, moet u een Mapbox API in de My Maps location-configuratie> Mapproviders.
De Mapbox-startpagina is hier, u moet daar een gratis account maken: https://www.mapbox.com/

mapbox-home

 

Van daaruit kunt u een nieuw ontwerp van de pagina maken of de aanbevolen pagina gebruiken en deze opslaan in uw account.

map-stijl

 

Gebruik uw account om uw referenties te verkrijgen menu Account (rechtsboven):

  • Mapbox API: gebruik het menu Account> Toegangstokens

U krijgt dus één sleutel per kaartstijl die u hebt gemaakt.

 

mapbox-apikey

 

Kopieer het vervolgens in My Maps location-configuratie om het te gebruiken.

 

mapbox-config