My Maps location dokumentasjon

Introduksjon

La brukerne søke etter steder og konfigurere skjermen som du vil. My maps location er rett og slett den mest avanserte Google Maps-integrasjonen for Joomla.

 

My-kart-location-hoved

 

Hovedtrekkene:

  • Søk etter steder du har opprettet
  • Auto geolocation
  • Kartkilden kan være Google Maps, Bing-kart eller Kartboks
  • Legg til kartdesign
  • Få informasjon fra Google-steder
  • Import / Eksporter / Synkroniser steder fra .csv-fil
  • Innlegg for frontendplassering
  • Mange tredjeparts utvidelsesintegrasjoner

I. MY MAPS LOCATION INSTALLER OG OPPDATERING

1.1 Installer

Vår komponent er Joomla 3.x-kompatibel. Alle funksjonene og integrasjonene fra tredjeparter er inkludert i alle medlemskap.
For å kunne installere komponenten må du laste ned utvidelsen .zip-fil og bruke standard Joomla installer.

 

Joomla-installasjon

 

Klikk deretter Bla gjennom> Last opp og installer, komponent, moduler og plugins vil bli installert som standard.

1.2 Oppdatering og automatisk oppdatering

For å oppdatere My Maps location kan du installere en ny versjon over den gamle ved å laste ned ZIP-filen fra JoomUnited eller bruke den automatiske oppdatereren (anbefalt).

 

MML-oppdatering

 

Den automatiske oppdatereren, som presser oppdateringsvarselet, er innebygd i Joomla-utvidelsen du har installert. Så får du beskjed som enhver annen utvidelse i dashbordet eller ved hjelp av menyen: Utvidelse> Administrer> Oppdater meny.

 

Logg inn på kontoen din for å oppdatere

Du må logge inn på JoomUnited-kontoen din for å oppdatere alle JoomUnited Joomla-utvidelsene. For å logge inn, må komponentens hovedkonfigurasjon klikke på Live oppdateringsfanen. Nederst finner du en innloggingsknapp.

 

live oppdatering

 

Skriv inn JoomUnited-legitimasjonene dine, det samme du bruker til å logge inn her @ www.joomunited.com

 

login-joomunited

 

Knappen blir oransje, gratulerer! Du kan nå oppdatere alle JoomUnited-utvidelsene på denne nettsiden! Hvis medlemskapet ditt er utløpt, får du en forny kobling og en tekst som forklarer det.

 

konto bundet

 

Merk: En enkelt pålogging vil tillate deg å oppdatere alle JoomUnited-utvidelsene (angående medlemskapet ditt). Innlogging utløper ikke med mindre du kobler fra den.

II. PLASSERINGER OG KATEGORIER

2.1 Få en Google Maps API-nøkkel

Hver gang du bruker Google Maps-APIer, må du ha en nøkkel for å validere forespørselen din dersom du har blitt opprettet etter 22. juni 2016.
Få en nøkkel og aktiver API: https://developers.google.com/maps/documentation/javascript/get-api-key

Mer informasjon: https://developers.google.com/maps/documentation/javascript/usage?hl=en

Det første trinnet er å skrive et prosjekt og deretter skrive inn navnet på prosjektet.

 

create-api-key

 

Hvis jeg vil tillate alle forespørsler fra mydomain, er mønsteret som følger * .joomunited.com / *
Hvis du bare vil tillate enkelt domene for eksempel mydomain.com, vil mønsteret være joomunited.com/*


På et localhost-miljø kan du legge til en gyldig nøkkel, og den vil fungere uten å henvise domener.

 

domene-api-mønster


API-nøkkelen er generert da dette er nøkkelen du må kopiere for å legge til i My Maps location.

 

api-laget

 

Legg til nøkkelen til My Maps Location.

Fra Komponenter> My Maps Location> Alternativvisning, kan du legge til en nøkkel i konfigurasjonen.

 

Kartene-konfigurasjon

 

Lim inn tasten.

 

add-api-key

 

Steg for steg resumé:


Så trinnene jeg følger er

  • Gå til Google API-konsollen
  • Opprett eller velg et prosjekt
  • Klikk på Fortsette for å aktivere API og eventuelle relaterte tjenester
  • På siden Credentials, få en Nettleser nøkkel (og angi API-legitimasjonene)
  • For å forhindre kvote tyveri, må du sikre at API-nøkkelen følger de beste praksisene

2.2 Administrer kategorier av plassering

Plassering er klassifisert i kategorier. Disse kategoriene kan vises som filter i frontend eller brukes som en forhåndsdefinert parameter i et menyelement for å laste inn noen kategoriserte steder.
 

kategori-filter-grensesnittet

 

Hvis du har mange steder, anbefales det å bruke kategorier. Du kan opprette kategorier og underkategorier.
For å opprette en kategori, vennligst gå inn My Maps location> Kategori og klikk på Ny

 

kategori-steder

 

Deretter må du legge til en tittel og en overordnet kategori i kategorien skjerm hvis du vil opprette en underkategori

 

kategori-foreldre

 

Du kan også definere en standardmarkør for plassering i teksten ved hjelp av fanen Markørvalg

 

markør kategori

 

Merk: En kategori er opprettet som standard oppkalt "Min kategori" slik at du kan begynne å legge til steder direkte etter installasjonen

2.3 Opprett et sted

For å opprette et sted, vennligst gå inn My Maps location> Steder> Ny

Det er 3 obligatoriske felt:

  • Navn på stedet
  • Kategori av stedet
  • Plasseringsdetaljer (adresse)

 

For adressen har du 3 løsning for å legge til den:

  • Bruk søkefeltet (anbefalt)
  • Naviger til kartet og bruk markøren til å peke på et sted
  • Fyll ut en adresse (må være Google Maps gyldig)

 

For å legge til et sted med søkemotoren, skriv inn navnet på stedet du vil legge til.

 

add-plassering

 

Ved valg fylles feltene breddegrad og lengdegrad automatisk. Mine kart er også integrert med Google-steder! Det betyr at du kan søke etter en butikk eller noe annet som er registrert på Google Maps, vår komponent vil få all informasjon om stedet.

 

Google-plass

 

 

Du kan også flytte på kartet og sette en markør direkte, resultatet blir det samme og du får en breddegrad og en lengdegrad som automatisk fylles.

 

map-point

 

Vær forsiktig med adressefeltet og postnummeret hvis du fyller det manuelt, det må samsvare med en kjent Google Maps-adresse.

 

adressefelt

 

All annen informasjon om stedet (beskrivelse, timer, ...) vises i detaljert visning av stedet.

Kontaktlenken i detaljoppdateringen for plassering, er muligheten til å legge til en kontaktlänk, mailto eller URL per sted. På frontend vil det være en kontaktknapp som vil åpne nettadressen eller utføre mailto-handlingen.

 

9

 

2.4 Annen lokasjonsinformasjon

På hvert sted kan du legge til et bilde og en markør.

  • Stedsbilde: Bildet vil bli vist som et miniatyrbilde i verktøytipset til stedet og i større format på stedet for detaljdetaljer.
  • Bruk kategoriikon: Bruk ikonet du legger i kategorifeltet for kartplasseringene mine
  • Markørbakgrunn: velg farge for bakgrunnen markøren
  • Marker vil vises på kartet som et stedmerkeikon. Du har også noen fine markørsett for plasseringene dine inkludert i My Maps Location-utvidelsen.
  • Bruk en tilpasset lenke vil overstyre lenken til detaljer om stedet med en tilpasset URL.

 

markør-image-plassering

 

My Maps location bruker Joomla native flerspråklig funksjon. Du kan definere et språk i kategorier av plassering og på steder. På språkbryter blir steder filtrert som noe annet Joomla-innhold for å vise det språkgodkjente innholdet.

 

Språk

 

Plasseringsbeskrivelsesfeltet er en av de viktigste.
Den vil bli vist på plasseringsdetaljer siden og, avhengig av temaet, som en introtekst av stedet i søkeresultatene. Viktigere, beskrivelsen er en WYSIWYG-editor med alt pluginet inne i, det betyr at du kan ha alt du vil ha i det (bilder, videoer ...).

 

plassering-description

 

Her er introteksten som vises i søkeresultatene.

 

text-in-plassering-resultater

 

Etikettfeltet er samme tagsystem som Joomla. Du kan legge til tagger og underetiketter og deretter laste den i frontend som filter. For å administrere alle kodene laster du bare inn Joomla-tagkomponenten: Meny Komponent> Merker
På frontend, avhengig av konfigurasjonen, kan merkene vises som avkrysningsboks (som bellow) eller som en dropdown-liste.

 

tag-filteret

 

My Maps Location fikk flere felt for å fylle metainformasjon (for søkemotorer). Disse feltene er lastet på plasseringsdetaljer siden.

 

meta-informasjon

 

2.5 Vis steder på frontend

For å vise stedene dine på frontend kan du bruke:

  • En meny for å vise plasseringssøkemotor, enkelt sted eller kategori av steder
  • En modul for å vise et søkefelt eller velge et sett med steder
  • En editorknapp for å vise enkelt eller flere steder i et hvilket som helst redigeringsprogram

Last inn steder fra en meny

Fra Joomla menybehandling, legg til et element og velg som type "Stedsøk og display". Det vil vise søkemotoren med filtre.
Å velge "Visningsdetaljvisning" for å vise en enkelt forhåndsdefinert plassering.

 

plassering-menyen

 

Hvis du velger "Stedsøk og display" du har noen visningsparametere. Noen kan overstyre standardkomponentparametere.

 

Hoved-menu-config

 

Fra hovedfanen i menyen kan du sette opp:

  • Skriv inn adresse: Du kan tvinge en standardadresse som skal vises på sidelast. Det kan stå tomt
  • Avstand: Avstanden til låsesøk, refererer til adressen ovenfor. Den kan stå som -1 (standard)
  • Kategori: last inn en bestemt kategori av plassering
  • Søkegrense: begrense antall søkeresultater. 10 vil bare returnere de 10 første resultatene på stedssøk
  • bestilling: bestille søkeresultater etter dato, tittel, avstand (standard)

 

MML-menyen avanserte

 

Så på My Maps Location menyfanen, kan du sette opp:

  • Velg komponent: My Maps Location eller alle tredjeparts integrasjon som K2, Jomsocial ...
  • Standard kategori ID (Tredjepartsutvidelser): Standardkategori som skal lastes når en tredjepartsutvidelse er i bruk, som K2, Hikashop eller Adsmanager, CB-liste-ID for fellesskapsbygger
  • Barn kategori steder: Vis også som søkeresultater steder fra underkategorier, ikke bare den som er valgt ovenfor
  • Tema: velg en av de 3 temaene standard, full bredde og sidebjelke i søke- og resultatdisplayet som er tilgjengelig for menyelementet
  • Kartleverandør: Velg Google Maps, Bing Maps, Mapbox, OpenStreetMap eller Mapquest for å utforme kartene dine
  • Aktiver søkeetiketter: Tillater søkeforespørsler som skal gjøres ved hjelp av stedsnavn
  • design: Avhengig av kartkilden har du flere karttyper og farger
  • Kartlag: Legg til noen data (lag) til deg kart. Det er KML-lag, Trafikklag, Transittlag og Sykkellag.
  • Google Map Layer Url: Bruk Data-laget til å lagre dine egendefinerte data, eller å vise GeoJSON-data på et Google-kart
  • Bing Karttype: Hvis Bing Maps er kartleverandør, velger du utseendet og dataene til Bing Maps
  • OpenStreetMap type: Hvis OpenStreetMap er kartleverandør, kan du legge til noen data (lag) til deg kart
  • Plasseringsverktøytips: På kartbelastning åpner du automatisk verktøylippen etter plassering
  • Kartzoom: Definer et standard zoomnivå på kartet
  • Kart og søkeresultater bredde og høydealternativer

 

Frontend-skjerm basert på tema

 

map-søk-temaer

 

Resultat for en enkelt plasserings søkvisning:

bridgewater-plassering


Vis steder ved hjelp av en modul

My maps location leveres med 2 moduler for opprinnelige steder + annet for tredjepartsintegrasjon (som en modul for å vise K2-objektlokasjoner)

Kartmodulen lar deg vise stedene dine med de samme filtre som menyen, men i en modulposisjon. Stedene vil bli vist som Kart eller Liste. Du kan velge et sett med steder eller velge stedskategorier.

 

map-modul

 

My Maps Location-kart - søkemodul vil vise en søkemotor med noen filtre som alternativ, for eksempel kartbredde eller komponenten der stedet blir søkt i (søk kun etter K2-plassering etter aksempel).

 

search-modul

 

Skjermmodul på frontend:

 

search-map-frontend-moduler

 

 

Vis steder ved hjelp av en editor-knapp


Redigererknappen vil bli lastet inn i Joomla-editoren din (vanligvis i artikler eller HTML-tilpassede moduler). Du får se knappen nederst på redigeringsprogrammet.
Ved å klikke vil du se en lysboks som lar deg velge en eller flere steder du har lagt til før.

 

map-editor-knappen

 

Deretter kan du velge ett eller noe sted og trykke på knappen for å legge den til i artikkelen din. Hvis du ikke angir noe zoomnivå, lastes det automatisk inn for å passe deg til plasseringsområdet.
Merkekoden du vil se i WYSIWYG-editoren, blir som denne modellen: {mymaplocations mapid bredde høyde}

Eks: {mymaplocation id = 1 bredde = 58% høyde = 400px zoom = 10 type = google} denne koden vil vise et kart med ID = 1, med 58% bredde, 400px høyde, 10 ganger zoom og Google-type. Bruk kommaet for å legge til mer enn ett sted i et kart. Eks: {mymaplocation id = 1 bredde = 58% høyde = 400px zoom = 10 type = google} posisjon ID = 1, 2, 3.

 

III. FRONTEND LOCATION SUBMISSION

3.1 Legg til og administrer steder

My maps location tilbyr muligheten til å sende inn og administrere dine egne steder fra frontend. Først må du opprette en meny som tillater frontend innsending.

Fra Joomla menybehandling, legg til et element og velg som type Legg til steder. Deretter ved å klikke på det, blir brukerne omdirigert, etter innlogging, til et sted for innsending av skjema.
Menyen "Mine steder" lar brukeren redigere sine tidligere innsendte steder.

 

add-klarer-location-frontend

 

Frontend meny skjema oversikt:

 

meny-front

 

3.2 Tilgangsbegrensning

Frontend innsending og utgave prosess er styrt av Joomla ACL. For å redigere hvem som har lov til å sende inn og redigere plassering, klikker du på Komponenter> My Maps Location> Valg> Tillatelser.
Derfra kan du styre heks Joomla brukergruppe er i stand til å:

  • Lag steder
  • Slett steder
  • Rediger steder
  • Rediger publiseringsstatus
  • Rediger egne steder

 

Frontend-location-innsending

 

IV. IMPORT - EKSPORTPLASSER

My Maps location har et Import - Export - Synkroniseringsverktøy for plassering fra en .csv eller .kml-fil (Google Earth-fil). Klikk på meny My Maps Location> Import / eksport for å få tilgang til grensesnittet.

 

import-eksport-verktøy

 

Fra dette grensesnittet kan du:

  • Importer steder fra en .csv eller .kml-fil
  • Eksporter steder fra en .csv eller .kml-fil
  • Lag en oppdatering (synkronisering) av stedene fra en .csv eller .kml-fil

 

Merk: Synkroniseringsknappen fungerer også når du har lagt til plassering direkte i databasen

V. SØKSTATISTIKK

Du kan se statistikken for ditt lokalsøk ved å aktivere Aktiver statistikkparameter på Innstillinger> Generelt konfigurasjonsfane.

 

statistiske måneder

 

Og du kan se listen over de beste stedene under, du kan Eksport det med .csv filtype også.

 

eksport-statistikk

 

VI. PARAMETRE

6.1 Innstillinger

Komponenten har mange alternativer, noen kan overstyres i menyvisningen som vi har sett før. Klikk på meny: My Maps Location> Valg for å få tilgang til grensesnittet (øverst til høyre på skjermen)

Tab1: Generell konfigurasjon

 

Parameters1

 

  • Aktiver statistikk: Aktiver posisjonsstatistikk
  • AJAX søk: Aktiver søkeforespørsmålene i AJAX, utfør et søk uten å laste siden på nytt
  • Visningsdistanse: Vis avstanden til stedet fra brukerposisjonen
  • Enhet av avstand: Kilometer eller kilometer
  • Kartleverandør: velg mellom Google maps, Microsoft Bing kart, Mapbox, Openstreetmap + Leaflet eller Mapquest
  • Autofullfør søket: Autofullfør forslag når du gjør et stedssøk. Autofullfør forslag kan komme fra Google Maps, Bing Maps eller Openstreetmap, uansett kartsystem du har valgt
  • Hver gang du bruker Google Maps-APIer, må du ha en nøkkel, dersom du har blitt opprettet domenet etter 22. juni 2016. å validere forespørselen din.
    Mer informasjon: https://developers.google.com/maps/documentation/javascript/usage?hl=en
    Få en nøkkel: https://developers.google.com/maps/documentation/javascript/get-api-key
  • Google Maps-type: karttype: veikart, satellitt, hybrid eller terreng
  • Kartdesign: Velg en standarddesign for kartene dine
  • Rull musekart: Aktiver zoom inn / zoom ut med musen når du flytter kartet
  • Dra kart: Aktiver å dra kartet for å flytte over det, ved å bruke musen
  • Åpne hendelsesmarkør: Hvordan plasseringsdetaljene åpnes når du klikker på eller svever en markør
  • Aktiver markørklynger: Hver klynge som har mer enn en markør, viser en telling av antall markører inne i klyngen
  • Autozoom-funksjonen: Juster automatisk zoomen for å vise alle markørene på kartet
  • Bing Karttype: karttype: antenne, fugleøye eller vei
  • Bing-kart-API-nøkkel: sett en API-nøkkel for å få det til å fungere;)

 

Parameters2

 

  • Hvor som helst søk: legg til alternativet i radius søk for å søke hvor som helst på verden
  • Søk hvor som helst som standard: Som standard vil radiusvelgeren i søkevisningen settes til hvor som helst
  • Tagformat i søk: vis etikettfiltrene som avkrysningsboks eller rullegardinliste
  • Gatevisning: Legg til gatevisning i søk som alternativ
  • Vis rute: Vis en kobling for å beregne ruten fra brukerposisjon
  • Ruteformat: vis ruten på My Maps location eller omdirigere til Google
  • Kontakt lenke på stedet: Legg til en lenke til en kontaktside
  • Kontaktknapp: vis kontaktknappen
  • Mål for kontaktlenk: Åpne kontaktkoblingsmodus
  • Kart standard zoom: Standard zoomnivå på kartet på første last (sett autozoom til nei)
  • Kartstørrelse: kart og søkeresultater bredde og høyde
  • Avstand for radius søk: Angi verdiene for rullegardinlisten
    Ex. Brukeren kan velge å søke 10 miles rundt New York City.
  • Vis avstandseleksjonsliste: alternativ for å vise avstanden rediger søkeliste

 

Parameters3

 

  • Ordbeskjære i søkeresultatene: beskjære plasseringsbeskrivelsen ved et visst antall ord i søkeresultatene
  • JQuery sidebjelke: endre standard sidefelt til en JQuery-en (mindre og jevn rulleffekt)
  • Deaktiver geolocation: deaktiver geografisk plassering på ikke https-nettsted.
  • Deaktiver kategorifilter: Dette alternativet aktiverer kategorien dropdown list filter
  • Deaktiver landstilstandsfilter: vis en rullegardin for landstilstand i søkevisningen
  • Søk etter postnummer: Søk etter postnummerfelt
  • Farge for OR-knapp: "ELLER" knappfarge på standardtema
  • Knappfarge: "Geolocate me" -knappen farge på standard tema
  • Global skriftfarge: Bruk dette alternativet til å angi global fontfargen på Mine kartposisjoner
  • Bakgrunnsbilde: bilde i bakgrunnen av søket på standardtema
  • Du markør: legg til deg posisjon på kartet og velg et bilde som markør
  • Standard ikonbilde: bruk standard ikonbilde hvis ikon ikke er tilgjengelig
  • Helper Overstyring: generer en Joomla standard layout overstyr fil som ikke vil bli påvirket av utvidelsesoppdateringer (i / html-mappe)

 

6.2 Bing som kartkilde

Hvis du vil bruke Bing Maps fra Microsoft som kartkilde, må du fylle en API-nøkkel i den globale konfigurasjonen av My Maps location. Bing siden er her: https://www.bingmapsportal.com/

 

global-bing

 

Du må opprette en gratis konto herfra og kopiere API-nøkkelkoden fra kontoen din.

 

bing-key-microsoft

 

Deretter kan du bruke Bing-kartet som kartkilde fra den globale konfigurasjonen (for å aktivere den som standard) eller fra menyelementet.

 

bing-config

 

6.3 Kartkasse som kartkilde

For å bruke Kartboks må den tilpassede kartplattformen for utviklere, som kartkilde, du fylle en kartboks-API i My Maps location konfigurasjon> Kartleverandører.
HOMEmesiden til kartboks er her, du må opprette en gratis konto derfra: https://www.mapbox.com/

 

mapbox-home

 

Derfra kan du lage noe nytt sidedesign eller bruke den anbefalte og lagre den på kontoen din.

 

map-stil

 

For å få din legitimasjon bruker du menykonto (øverst til høyre):

  • Kartboks-API: Bruk menyen Konto> Tilgangsfunksjoner

Så du får en nøkkel per kartstil du har opprettet.

 

mapbox-apikey

 

Så kopier det bare i My Maps location-konfigurasjonen for å bruke den.

 

mapbox-config