My Maps location dokumentation

Introduktion

Lad dine brugere søge efter steder og konfigurere skærmen, som du vil. My maps location er simpelthen den mest avancerede Google Maps integration for Joomla.

Hovedtræk:

  • Søg efter steder, du har oprettet
  • Auto geolocation
  • Kortkilde kan være Google Maps, Bing-kort eller Mapbox
  • Tilføj kortdesign
  • Få oplysninger fra Google-steder
  • Import / Eksport / Synkroniser placeringer fra .csv-fil
  • Frontend placering indsendelse
  • En masse tredjepartsudvidelsesintegrationer

I. MY MAPS LOCATION INSTALLER OG OPDATERING

1.1 Installer

Vores komponent er Joomla 3.x-kompatibel. Alle funktioner og 3rd party integrationer er inkluderet i alle medlemskab.
For at kunne installere vores komponent skal du downloade udvidelsen .zip-fil og bruge standard Joomla installer.

Klik derefter på Gennemse> Upload og installer knappen, komponent, moduler og plugins vil blive installeret som standard.

1.2 Opdatering og automatisk opdatering

For at opdatere My Maps location kan du installere en ny version over den gamle ved at downloade ZIP-filen fra JoomUnited eller bruge den automatiske opdaterer (anbefales).

MML-opdatering

 

Den automatiske opdateringsenhed, som skubber opdateringsmeddelelsen, er integreret i Joomla-udvidelsen, du har installeret. Så du får besked som enhver anden udvidelse i instrumentbrættet eller ved hjælp af menuen: Udvidelse> Administrer> Opdater menu.

 

Log ind på din konto for at opdatere

Du skal logge ind på din JoomUnited-konto for at opdatere alle dine JoomUnited Joomla-udvidelser. For at logge ind, skal komponentens hovedkonfiguration klikke på Live opdateringsfanen. Nederst finder du en login-knap.

Indtast dine JoomUnited credentials, det samme du bruger til at logge ind her @ www.joomunited.com

 

Knappen bliver orange, lykønsker! Du kan nu opdatere alle JoomUnited udvidelser på denne Homemeside! Hvis dit medlemskab er udløbet, får du en fornyet link og en tekst, der forklarer det.

Bemærk: Et enkelt login giver dig mulighed for at opdatere alle JoomUnited-udvidelser (vedrørende dit medlemskab). Login ikke udløber, medmindre du afbryder forbindelsen.

II. PLACERINGER OG KATEGORIER

2.1 Få en Google Maps API-nøgle

Hver gang du bruger API'erne til Google Maps, skal du medtage en nøgle for at validere din anmodning, hvis du er oprettet efter 22. juni 2016.
Få en nøgle og aktiver API: https://developers.google.com/maps/documentation/javascript/get-api-key

Mere information: https://developers.google.com/maps/documentation/javascript/usage?hl=en

Det første skridt er at cretae et projekt og

Skriv derefter navnet på projektet. Hvis jeg vil tillade alle anmodninger fra mit domæne, så er mønsteret, der følger, * * .joomunited.com / *
Hvis du kun vil tillade et enkelt domæne for eksempel mydomain.com, vil mønsteret være joomunited.com/*


På et lokalhost-miljø kan du lægge en gyldig nøgle, og den vil fungere uden at henvise til et domæne.


API-nøglen er genereret, så dette er nøglen, du skal kopiere for at tilføje til My Maps location.

Tilføj nøglen til My Maps Location.

Fra Komponenter> My Maps Location> Optionsvisning, kan du tilføje en nøgle i konfigurationen.

 

Indsæt tasten.

 

Trin for trin resumé:


Så de trin jeg følger er

  • Gå til Google API-konsollen
  • Opret eller vælg et projekt
  • Klik på Blive ved at aktivere API'en og eventuelle relaterede tjenester
  • På siden Credentials skal du få en Browser-nøgle (og angiv API-referencer)
  • For at forhindre kvote tyveri, sikre din API nøgle følgende disse bedste praksis

2.2 Administrer kategorier af placering

Placering er klassificeret i kategorier. Disse kategorier kan vises som filter i frontend eller bruges som en foruddefineret parameter i et menupunkt for at indlæse nogle kategoriserede steder.
 

 

Hvis du har mange steder, anbefales det at bruge kategorier. Du kan oprette kategorier og underkategorier.
For at oprette en kategori, skal du gå ind My Maps location> Kategori og klik på Ny


 

Derefter skal du fra kategoriskærmen tilføje en titel og en forælderskategori, hvis du vil oprette en underkategori

Du kan også definere en standardmarkør for placering i ctaegory ved hjælp af fanen Marker markering

 

Bemærk: En kategori oprettes som standard navngivet "Min kategori" så du kan begynde at tilføje steder direkte efter installationen

2.3 Opret en placering

For at oprette en placering, skal du gå ind My Maps location> Steder> Ny

Der er 3 obligatoriske felter:

  • Navn på lokationen
  • Kategori af lokationen
  • Placering detaljer (adresse)

 

Til adressen fik du 3 løsninger til at tilføje den:

  • Brug søgefeltet (anbefales)
  • Naviger på kortet, og brug markøren til at pege på et sted
  • Udfyld en adresse (skal være Google Maps gyldig)

 

For at tilføje en placering med søgemaskinen skal du indtaste navnet på det sted, du vil tilføje.

add-placering

 

Ved valg bliver feltene breddegrad og længdefyldt udfyldt automatisk. Mine kort er også integreret med Google steder! Det betyder, at du kan søge efter en butik eller noget andet, der er registreret på Google Maps, vores komponent får alle oplysninger om sted.

Google-sted

 

 

 

Du kan også flytte på kortet og placere en markør direkte, resultatet bliver det samme, og du får en breddegrad og en længdegrad automatisk fyldt.

 

Vær forsigtig med adressefeltet og postnummeret, hvis du udfylder det manuelt, skal det svare til en kendt Google Maps-adresse.

 

Alle andre oplysninger om placeringen (beskrivelse, timer, ...) vises i det detaljerede billede af placeringen.

Kontaktlinket i placeringsdetaljeudgaven er muligheden for at tilføje et kontaktlink, mailto eller webadresse pr. Placering. På frontend vil det være en kontaktknap, der åbner webadressen eller udfører mailto-handlingen.

2.4 Andre lokaliseringsoplysninger

På hvert sted kan du tilføje et billede og en markør.

  • Billedet vil blive vist som en miniaturebillede i værktøjstipen for placeringen og i større størrelse på placeringsdetailsiden.
  • Markører vises på kortet som placeringsmarkørikon. Du har også nogle gode markeringssæt til dine placeringer, der er inkluderet i My Maps Location-udvidelsen.
  • Brug en brugerdefineret link vil tilsidesætte linket til detaljen på stedet ved hjælp af en brugerdefineret URL.

 

markør-image-placering

 

My Maps location bruger den indbyggede flersprogede Joomla-funktion. Du kan definere et sprog i kategorier af placering og på steder. På sprogomskifter filtreres steder som ethvert andet Joomla-indhold for at vise det sproggodkendte indhold.

Placeringsfeltet er en af ​​de vigtigste.
Det vil blive vist på placeringsdetailsiden og, afhængigt af temaet, som en introtekst af placeringen i søgeresultater. Vigtigere, beskrivelsen er en WYSIWYG editor med alt plugin indlæst inde, det betyder at du kan have noget i det (billeder, videoer ...).

 

Her er introteksten vist i placeringsresultater.

 

Tagfeltet er det samme tagsystem som Joomla. Du kan tilføje tags og sub-tags og derefter indlæse den i frontend som filter. For at administrere alle tags, skal du blot indlæse Joomla tag komponenten: Menukomponent> Tags
På frontend, afhængigt af konfigurationen, kan tags vises som afkrydsningsfelt (som bellow) eller som en rulleliste.

 

My Maps Location fik yderligere felter til at udfylde meta-oplysninger (til søgemaskiner). Disse felter er indlæst på placeringsdetailsiden.

2.5 Vis steder på frontend

For at vise dine placeringer på frontend kan du bruge:

  • En menu til visning af positionssøgemaskine, enkelt sted eller kategori af placeringer
  • Et modul til at vise et søgefelt eller vælge et sæt af placeringer
  • En editor-knap for at vise enkelte eller flere steder i enhver editor

Indlæs placeringer fra en menu

Fra Joomla menu manager tilføj et element og vælg som type "Placering søgning og display". Det vil vise placerings søgemaskinen med filtre.
Vælg "Placering detaljer visning" for at vise en enkelt foruddefineret placering.

 

Hvis du vælger "Placering søgning og visning" du har nogle visningsparametre. Nogle kan tilsidesætte standardkomponentparametre.

 

Fra hovedfanen i menuen kan du opsætte:

  • Indtast adresse: Du kan tvinge en standardadresse til at blive vist på sidebelastning. Det kan efterlades tomt
  • Afstand: Afstanden til låsesøgning, der henviser til adressen ovenfor. Det kan overlades som -1 (standard)
  • Kategori: Indlæs en bestemt kategori af placering
  • Søgegrænse: begrænse antallet af søgeresultater. 10 returnerer kun de 10 første resultater på stedet søgning
  • Bestilling: Bestil søgeresultater efter dato, titel, afstand (standard)

 

MML-menu-avanceret

Så på My Maps Location menu fanen, du kan opsætte:

  • Vælg komponent: My Maps Location eller alle 3rd party integration som K2, Jomsocial ...
  • Standard kategori ID (Tredjepartsudvidelser): Standardkategori, der skal indlæses, når en tredjepartsudvidelse er i brug, som f.eks. K2, Hikashop eller Adsmanager, CB-liste-id for fællesskabsbygger
  • Børne kategori placeringer: Vis også som søgeresultater steder fra underkategorier, ikke kun den ovenfor valgte
  • Tema: vælg en af ​​de 3 temaer standard, fuld bredde og sidebjælke i søge- og resultatdisplayet, der er tilgængeligt for menupunktet
  • Kortudbyder: Vælg Google Maps, Bing Maps, Mapbox, OpenStreetMap eller Mapquest for at indstille dine kort
  • Aktivér søgeetiketter: Tillader, at søgeforespørgsler udføres ved hjælp af placeringsnavnetavne
  • Design: Afhængigt af kortkilden har du flere korttyper og farver
  • Kortlag: Tilføj nogle data (lag) til dig kort. Der er KML-lag, Trafiklag, Transitlag og Cykellag.
  • Google Map Layer Url: Brug datalaget til at gemme dine brugerdefinerede data eller for at vise GeoJSON-data på et Google-kort
  • Bing Maps type: Hvis Bing Maps er din kortudbyder, skal du vælge udseende og data for Bing Maps
  • OpenStreetMap type: Hvis OpenStreetMap er din kortudbyder, kan du tilføje nogle data (lag) til dig kort
  • Placering værktøjstip: På mapbelastning åbner du automatisk værktøjstip efter lokaliserings søgning
  • Kort zoom: Definer et standardzoomniveau på kortet
  • Kort og søgeresultater bredde og højde indstillinger

 

Frontend display baseret på tema

 

Resultat for en enkelt placeringssøgning:


Vis steder ved hjælp af et modul

My maps location leveres med 2 moduler til indbyggede steder + andet til tredjeparts integration (som et modul til visning af K2-objektlokationer)

Kortmodulet giver dig mulighed for at vise dine placeringer med de samme filtre som menuen, men i en modulposition. Placeringen vises som kort eller liste. Du kan vælge et sæt af placeringer eller vælge placeringskategorier.

map-modul

My Maps Location - Søgemodul vil vise en søgemaskine med nogle filtre som option som kortbredden eller komponenten i heksen, hvor stedet skal søges (søg kun efter K2-placering for eksempel).

 

Display modul på frontend:

 

 

Vis steder ved hjælp af en editor-knap


Redaktørknappen vil blive indlæst i dit Joomla-editor (normalt i artikler eller HTML-tilpassede moduler). Du kan se knappen nederst i din editor.
Ved klik klikker du på en lightbox, der giver dig mulighed for at vælge en eller flere steder, du har tilføjet før.

 

Derefter kan du vælge et eller et sted og trykke på knappen for at tilføje den i din artikel. Hvis du ikke angiver et zoomniveau, bliver det automatisk indlæst, så det passer til placeringsområdet.
Tag-koden, du vil se i din WYSIWYG-editor, vil være som denne model: {mymaplocations mapid bredde højde}

Eks: {mymaplocation id = 1 bredde = 58% højde = 400px zoom = 10 type = google} Denne kode viser et kort med placerings-ID = 1, med 58% bredde, 400px højde, 10 gange zoom og Google-type. Brug komma til at tilføje mere end et sted i et kort. Ex: {mymaplocation id = 1 bredde = 58% højde = 400px zoom = 10 type = google} placerings-ID = 1, 2, 3.

 

III. FRONTEND LOCATION SUBMISSION

3.1 Tilføj og administrer placeringer

My maps location giver mulighed for at indsende og administrere dine egne placeringer fra frontend. Først skal du oprette en menu, der tillader frontend indsendelse.

Fra Joomla menu manager tilføj et element og vælg som type "Tilføj steder". Derefter ved at klikke på det bliver brugerne omdirigeret efter login til en lokalitetsindgivelsesformular.
Menuen "Mine placeringer" giver brugeren mulighed for at redigere deres tidligere indsendte steder.

 

Frontend menuoversigt oversigt:

 

3.2 Adgangsbegrænsning

Frontend indsendelse og udgave proces styres af Joomla ACL. Hvis du vil redigere, hvem der har lov til at indsende og redigere placering, skal du klikke på Komponenter> My Maps Location> Valg> Tilladelser.
Derfra kan du styre heks Joomla brugergruppe er i stand til at:

  • Opret placeringer
  • Slet placeringer
  • Rediger placeringer
  • Rediger offentliggørelsestidspunktet
  • Rediger egne steder

 

IV. IMPORT - EKSPORTPLACERINGER

My Maps location fik et Import - Export - Synkroniseringsværktøj til placering fra en .csv eller .kml fil (Google Earth fil). Klik på menu My Maps Location> Import / eksport for at få adgang til grænsefladen.

 

Fra denne grænseflade kan du:

  • Importer placeringer fra en .csv eller .kml-fil
  • Eksporter placeringer fra en .csv eller .kml-fil
  • Lav en opdatering (synkronisering) af placeringerne fra en .csv eller .kml-fil

 

Bemærk: Synkroniseringsknappen fungerer også, når du har tilføjet placering direkte i databasen

V. SØGESTATISTIK

Du kan se statistikkerne for din positionssøgning ved at aktivere Aktiver statistikparameter på Indstillinger> Generel konfiguration faneblad.

statistik-måneders

Og du kan se listen over de bedste steder nedenfor, du kan Eksport det med .csv filtype også.

eksport-statistik

VI. PARAMETRE

6.1 Indstillinger

Komponenten har mange muligheder, nogle kan blive tilsidesat i menuvisningen som vi tidligere har set. Klik på menu: My Maps Location> Indstillinger for at få adgang til grænsefladen (øverst til højre på skærmen)

Tab1: Generel konfiguration

Parameters1

 

  • Aktivér statistik: Aktivér positionsstatistik
  • AJAX søgning: Aktivér søgeforespørgsler i AJAX, udfør en søgning uden at genindlæse siden
  • Visningsafstand: Vis afstanden fra placeringen fra brugerens position
  • Enhed af afstand: Miles eller Kilometer
  • Kortudbyder: vælg mellem Google maps, Microsoft Bing kort, Mapbox, Openstreetmap + Folder eller Mapquest
  • Autofuldførelse søgning: Autofuldfør forslag, når du foretager en positionssøgning. Autofuldførende forslag kan komme fra Google Maps, Bing Maps eller Openstreetmap, uanset hvilket kort system du har valgt
  • Hver gang du bruger Google Maps-API'erne, skal du have en nøgle, hvis du er oprettet efter 22. juni 2016, at validere din anmodning.
    Mere information: https://developers.google.com/maps/documentation/javascript/usage?hl=en
    Få en nøgle: https://developers.google.com/maps/documentation/javascript/get-api-key
  • Google Maps-type: Korttype: Køreplan, Satellit, Hybrid eller Terræn
  • Kort design: Vælg et standarddesign for dine kort
  • Rul musekort: Aktivér zoom ind / zoom ud med musen, når du svæver kortet
  • Træk kort: Aktiver at trække kortet for at flytte over det ved hjælp af musen
  • Åbn begivenhedsmærke: Hvordan placeringsdetaljen åbnes, når du klikker på eller svæver en markør
  • Aktivér markørklynger: Hver klynge, der har mere end en markør, viser et tal af antallet af markører inde i klyngen
  • Autozoom funktion: Juster automatisk zoomen for at vise alle markørerne på kortet
  • Bing Maps type: korttype: antenne, fugleøje eller vej
  • API-nøgle til Bing-kort: læg en API-nøgle for at få det til at virke;)

 

Parameters2

 

  • Overalt søgning: tilføj muligheden i radius søgning for at søge overalt på verden
  • Søg som helst som standard: Som standard indstilles radiusvælgeren i søgevisningen til Anywhere
  • Tagformat i søgning: vis tag filtre som afkrydsningsfelt eller dropdown liste
  • Gade syn: Tilføj gadevisning i søgning som mulighed
  • Vis rute: Vis et link for at beregne ruten fra brugerposition
  • Ruteformat: vis ruten på My Maps location eller omdirigere til Google
  • Kontakt link på stedet: Tilføj et link til en kontaktside
  • Kontakt knap: Vis kontaktknappen
  • Mål for kontaktforbindelse: Åben kontakt link tilstand
  • Kort standard zoom: Standard zoomniveau på kortet på første indlæsning (indstillet autozoom til nej)
  • Kortstørrelse: Kort og søgeresultater bredde og højde
  • Afstand for radius søgning: Bestem værdierne i rullelisten for radius søgning
    Eks. Bruger kan vælge at søge 10 miles omkring New York City.
  • Vis afstandsvalgliste: mulighed for at vise afstanden redius søgning vælg listen

 

Parameters3

 

  • Ordafgrøde i søgeresultater: Beskær placeringsbeskrivelsen med et vist antal ord i søgeresultater
  • JQuery sidebjælke: skift standard sidebjælke til en JQuery-en (mindre og jævn rulningseffekt)
  • Deaktiver geografisk placering: deaktiver geografisk placering på ikke https-websted.
  • Deaktiver kategorifilter: Denne mulighed vil muliggøre kategorien dropdown liste filter
  • Deaktiver landstilstandsfilter: vis en landestatus dropdown i søgevisningen
  • Søg efter postnummer: Søg efter postnummer
  • Farve til OR-knap: "ELLER" knapfarve på standardtema
  • Knapfarve: "Geolocate me" knappen farve på standard tema
  • Global skrifttype farve: Brug denne indstilling til at angive den globale skriftfarve på Mine kortplaceringer
  • Baggrundsbillede: billede i baggrunden for søgningen på standardtema
  • Du markør: Tilføj dig position på kortet og vælg et billede som markør
  • Standard ikon billede: Brug standard ikonbillede, hvis ikon ikke er tilgængeligt
  • Helper Override: generere en Joomla standard layout overstyr fil, der ikke vil blive påvirket af udvidelses opdateringer (in / html mappe)

 

6.2 Bing som kortkilde

Hvis du vil bruge Bing Maps fra Microsoft som kortkilde, skal du udfylde en API-nøgle i den globale konfiguration af My Maps location. Bing siden er her: https://www.bingmapsportal.com/

 

Du skal oprette en gratis konto herfra og kopiere API nøglekoden fra din konto.

 

Derefter kan du bruge Bing-kort som kortkilde fra den globale konfiguration (for at aktivere det som standard) eller fra menupunktet.

 

 

6.3 Kartkasse som kortkilde

For at bruge Mapbox skal den brugerdefinerede kortlægningsplatform for udviklere, som kortkilde, udfylde en Mapbox API i My Maps location konfiguration> Kortleverandører.
Homemesiden til Mapbox er her, du skal oprette en gratis konto derfra: https://www.mapbox.com/

mapbox-Home

 

Derfra kan du oprette noget nyt side design eller bruge den anbefalede og gemme den på din konto.

map-stil

 

For at få dine legitimationsoplysninger skal du bruge menu konto (øverst til højre):

  • Mapbox API: Brug menuen Konto> Adgangstokener

Så du får en nøgle pr. Kortstil du har oprettet.

 

mapbox-apikey

 

Så kopier det bare i My Maps location konfiguration for at bruge det.

 

mapbox-config