Skip to content

Latest commit

 

History

History
199 lines (103 loc) · 4.61 KB

README.md

File metadata and controls

199 lines (103 loc) · 4.61 KB
Raw

README

Purpose

Map datatype for Umbraco V7

Why?

Wish to give your content editors or grid editors easy Maps to set real world locations.

See https://umbraco.com/apps/terratype/ for more details

Usage

  1. Install Terratype framework package via Nuget https://www.nuget.org/packages/Terratype/

  2. Install the Map Providers you would like to use, you can install and use, simultaneously, multiple providers. https://www.nuget.org/packages/Terratype.GoogleMapsV3

    https://www.nuget.org/packages/Terratype.LeafletV1

    https://www.nuget.org/packages/Terratype.BingMapsV8

  3. Create a new data type based off this the newly added Terratype property Editor. You may need to obtain any API Keys that are necessary

  4. Add this new data type to a document type

  5. Create new content based off this document type

Documentation

https://github.com/Joniff/Terratype/blob/master/docs/manual.pdf

Render

@using Terratype;

@Html.Terratype(Options, Map, @Label)

Log

1.0.21

Added Stamen Tileserver to Leaflet
Fixed Grid Label error

1.0.20

Fixed missing resource files for Bing & Leaflet
Updated to use Leaflet version 1.3.4

1.0.19

Complete rewrite of how providers are loaded
Amend to GMaps rendering to allow bypass of failback when first rendering or resizing

1.0.18

Removed Minifier dependancy

1.0.17

Fixed error converting old properties (https://bit.ly/2HEgf4x)
Fixed no click event for some markers in JS client library 
Fixed rendering issue in IE11 for Bing and Leaflet maps
Fixed loading Generic providers
Added distance calculation for positions using Haversine formula
Minified & bundle js files

1.0.16

Fixed custom icons in GMaps when rendering
Custom Position setting for map fixed when rendering

1.0.15

Updated markercluster for GMaps
Fixed error converting model when using ModelsBuilder
Added 3 more Google map styles
Added Javascript event library
Added AutoFit, AutoShowLabel & AutoRecenterAfterRefresh to options

1.0.14

Updated GMaps versions
Fixed custom icon error (ronaldbarendse)

1.0.13

Terratype model now includes height
Extra handling for GMaps when resize doesn't call idle event afterwards
Improved code to detect when Rendered map is being shown
Now with jQuery monitoring

1.0.12

All providers use .NET Framework 4.5
Added Icon to Options, to be able to render custom icons 
Fixed label issue for multiple Rendered GMaps

1.0.11

Fix for when providers are missing their default values
Fixed Minor spelling mistakes
Leaflet Map Icon is now static when rendered in razor

1.0.10

Render error with map height and zoom in option

1.0.9

Added Bing Maps
Leaflet not displaying
Switching between providers in config now smoother

1.0.8

Fixed option error in FireFox

1.0.7

@Html.Terratype() now handles dynamic values
Added Leaflet Provider
Remove labels from frontend when no label is present
Improved provider loading

1.0.6

Error when creating Google Maps without an API Key present

1.0.5

Added native Grid editor to allow terratype maps to be added/edited and rendered inside grids (With no coding required)
Added native Datum values to each Coordinate System

1.0.4

Fixed error with Null types in assemblies
Fixed error with map height for IE in Umbraco backend only
Added content editable Labels to maps

1.0.3

Error checking for providers fixed

1.0.2

Removed reliance on terratype map provider having to be same version as terratype

1.0.1

Removed hardcoded /umbraco/ references

1.0.0

Complete rewrite based from AngularGoogleMaps.

Future development

Current Roadmap

Include stylised maps for Leaflet, using own Tile Servers (Likely to be free or paid for service depending on your data usage).

Implement http://humangeo.github.io/leaflet-tilefilter

Adding an ArcGIS, CartoDB & MapBox providers - likely to charge for these providers, to recupe development and cover maintance costs (My thinking is better to have working providers for money, than broken providers for free)

Allow Null Position maps, so allowing maps that have no current location. This includes allowing null position as the starting location of a map

Source code

Download the source code, it should work for Visual Studio 2013 & 2015. If you set Terratype.TestSite as your Set as Startup project this should execute the test Umbraco website, where you can test maps under different scenarios. Once running, surf to http://localhost:60389/umbraco and at the login type admin for user and password for password.