first commit

jherbaux · Dec 6, 2018 · 192cf59 · 192cf59
commit 192cf59
Show file tree

Hide file tree

Showing 285 changed files with 35,975 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,72 @@
+# CHANGELOG
+
+### 1.4.1 (2014-10-30)
+
+ * 882cb65 - [Services] Fix origins/destinations switch for distance matrix construction
+ * 197fcf1 - [Services] Handle http errors (4XX/5XX)
+ * 188dc68 - [Gitignore] Remove Composer installer and phar
+ * 5606a85 - Migrate to PSR-4
+ * ddcf4ae - [Composer] Refine deps
+ * e107ab4 - [Travis] Add hhvm-nightly + Allow hhvm/hhvm-nightly to fail
+ * e152093 - Updated to use widop/http-adapter version 1.1+
+ * afc822c - Added PHP 5.6 and HHVM to travis.yml
+ * dbc3965 - [Travis][Composer] Remove --dev
+ * 6203fee - [Composer] Upgrade to PSR-4
+ * fba0016 - [Autoload] Remove dist file
+
+### 1.4.0 (2014-06-17)
+
+ * c622643 - [Helper][Map] Introduce renderJsContainerExtra
+ * c5a19df - [Services][Directions] Fix waypoint stopover
+ * b5173e9 - [Helper][Extension] Fix InfoBox loading with async map
+ * b10a1a2 - Add coveralls support
+ * a1608ae - [Services] Check if the http adapter returns a valid response
+ * ca767aa - [Places][Autocomplete] Fix exception + tests
+ * 654744c - [Helper] Rely on egeloen/json-builder
+ * 533a5b0 - [Places] Fix helper rendering bug + Add component restrictions support
+ * ece9738 - Update new year
+
+### 1.3.0 (2013-12-12)
+
+ * a308662 - [MapHelper] Fix default info window open support
+ * b6a4372 - Service request language can now have 2 or 5 characteres
+ * 074cd0a - Increase time between each directions tests
+ * 234ad66 - [Travis] Only build the master branch
+ * 9234b44 - [Service] Add business account support
+ * 0520430 - [Service] Replace kriswallsmith/buzz by widop/http-adapter
+
+### 1.2.0 (2013-10-09)
+
+ * 94a73a1 - [Helper] Remove FORCE_JSON_ENCODE for js marker cluster + rely on json builder
+ * 3fd9afb - [Asset] Enforce javascript variable unicity
+ * edcea0a - [Services] Add xml support
+ * 0305bbc - [Helper] Add InfoBox support
+ * 3089dce - [Helper] Add extension support
+ * 472461d - [Helper][Utils] Make JsonBuilder::setValues more readable
+
+### 1.1.0 (2013-08-22)
+
+ * bdc9014 - [Helper] Add json builder utility class
+ * ca6060c - [Doc] Add a section about geocoder provider registration
+ * 7c485c3 - [Overlays] Add marker cluster support
+ * 2578a5d - [Helper] Fix map language with google loader
+
+### 1.0.0 (2013-06-07)
+
+ * 0845763 - Add Distance Matrix support
+ * d0f2282 - [DirectionsRequest] Add transit travel mode support
+ * 2444de8 - [Map] Allow to specify additional libraries
+ * ebe2210 - Add Places Autocomplete support
+ * b5bcd66 - [Directions] Make route copyrights optional
+ * 1aa0083 - [Travis] Use --prefer-source to avoid random build fail
+
+### 0.9.1 (2013-04-10)
+
+ * 13f108a - [Exception] Rename TemplatingException to HelperException
+ * 4e340c3 - [Helper] Use Google Loader for loading Google Map API v3
+ * ff6b973 - [Helper] Add JS container
+ * 31d7346 - Fix annotation typo
+ * 28ffe07 - PSR2 compatibility
+ * db3d23f - Rename 'Ivory\GoogleMap\Templating\Helper' namespace to 'Ivory\GoogleMap\Helper'
+
+### 0.9.0 (2013-03-23)
diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,14 @@
+Copyright (c) 2011-2014 Eric GELOEN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/README.md b/README.md
@@ -0,0 +1,57 @@
+# README
+
+[![Build Status](https://secure.travis-ci.org/egeloen/ivory-google-map.png?branch=master)](http://travis-ci.org/egeloen/ivory-google-map)
+[![Coverage Status](https://coveralls.io/repos/egeloen/ivory-google-map/badge.png?branch=master)](https://coveralls.io/r/egeloen/ivory-google-map?branch=master)
+
+The Ivory Google Map project provides a Google Map integration for your PHP 5.3+ Project. It allows you to manage map,
+controls, overlays, events & services through the Google Map API v3.
+
+## Documentation
+
+   1. [Installation](http://github.com/egeloen/ivory-google-map/blob/master/doc/installation.md)
+   2. [Usage](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage.md)
+      - [Map](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/map.md)
+      - [Overlays](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/index.md)
+         - [Marker](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/marker.md)
+         - [Info window](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/info_window.md)
+         - [Info box](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/info_box.md)
+         - [Polyline](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/polyline.md)
+         - [Encoded Polyline](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/encoded_polyline.md)
+         - [Polygon](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/polygon.md)
+         - [Rectangle](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/rectangle.md)
+         - [Circle](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/circle.md)
+         - [Ground overlay](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/ground_overlay.md)
+         - [Marker cluster](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/overlays/marker_cluster.md)
+      - [Controls](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/controls/index.md)
+         - [Map type](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/controls/map_type.md)
+         - [Overview](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/controls/overview.md)
+         - [Pan](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/controls/pan.md)
+         - [Rotate](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/controls/rotate.md)
+         - [Scale](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/controls/scale.md)
+         - [Street view](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/controls/street_view.md)
+         - [Zoom](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/controls/zoom.md)
+      - [Layers](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/layers/index.md)
+         - [KML Layer](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/layers/kml_layer.md)
+      - [Events](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/events.md)
+      - [Places](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/places/index.md)
+         - [Autocomplete](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/places/autocomplete.md)
+      - [Services](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/services/index.md)
+         - [Geocoding API](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/services/geocoding/geocoder.md)
+         - [Directions API](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/services/directions/directions.md)
+         - [Distance Matrix API](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/services/distance_matrix/distance_matrix.md)
+         - [Business Account](http://github.com/egeloen/ivory-google-map/blob/master/doc/usage/services/business_account.md)
+
+## Testing
+
+The library is fully unit tested by [PHPUnit](http://www.phpunit.de/) with a code coverage close to **100%**. To execute
+the test suite, check the travis [configuration](https://github.com/egeloen/ivory-google-map/blob/master/.travis.yml).
+
+## Contribution
+
+We love contributors! Ivory is an open source project. If you'd like to contribute, feel free to propose a PR!
+
+## License
+
+The Ivory Google Map is under the MIT license. For the full copyright and license information, please read the
+[LICENSE](https://github.com/egeloen/ivory-google-map/blob/master/LICENSE) file that was distributed with this source
+code.
diff --git a/UPGRADE.md b/UPGRADE.md
@@ -0,0 +1,50 @@
+# UPGRADE
+
+### 1.3 to 1.4
+
+ * The `Ivory\GoogleMap\Helper\Utils\JsonBuilder` have been extracted to a dedicated library for reusability purpose.
+ * The `Ivory\GoogleMap\Helper\MapHelper::renderJsContainerExtra` has been introduced in order to render method's calls
+   after the JS container.
+ * The `Ivory\GoogleMap\Helper\MapHelper::renderJsContainerMap` has been updated to only render the map and so, the
+   method's calls have been moved to the `Ivory\GoogleMap\Helper\MapHelper::renderJsContainerExtra`.
+ * The `Ivory\GoogleMap\Helper\MapHelper::renderJsContainerBoundsExtends` method has been removed/merged into the
+   `Ivory\GoogleMap\Helper\MapHelper::renderJsContainerExtra`.
+ * The method's calls present in the `Ivory\GoogleMap\Helper\MapHelper::renderAfter` has been moved to the
+   `Ivory\GoogleMap\Helper\MapHelper::renderJsContainerExtra`.
+
+### 1.2.0 to 1.3.0
+
+ * The `buzz` property/getter/setter of the `AbstractService` has been removed in favor of the http adapter which
+   allows to use buzz, curl, guzzle, stream, ...
+ * The `AbstractService` constructor has been updated in order to replace the buzz argument by the http adapter one
+   which is now first and mandatory.
+
+### 1.1.0 to 1.2.0
+
+ * The `apiHelper` property/getter/setter of the `MapHelper` has been removed and the constuctor has been updated
+   accordingly.
+ * The `MapHelper::getLibraries` method has been moved to the `CoreExtensionHelper` class.
+
+### 1.0.0 to 1.1.0
+
+ * The `markers` property of the `Map` have been removed in favor of the `markerCluster` property.
+ * The `MapHelper` constructor have been updated to now takes a `MarkerClusterHelperInterface` as 14th arguments
+   instead of the `MarkerHelper`.
+ * The `markerHelper` property/getter/setter of the `MapHelper` has been removed in favor of the `markerClusterHelper`
+   ones.
+ * The `MapHelper::renderJsContainerMarkers` method has been removed in favor of the
+   `renderJsContainerMarkerCluster` one.
+ * The `MapHelper::registerMarkerInfoWindowEvent` method have been moved to the `DefaultMarkerClusterHelper` class and
+   has been renamed to `registerInfoWindowEvent`.
+
+### 0.9.1 to 1.0.0
+
+ * The  `Distance`, `Duration`, `TravelMode` & `UnitSystem` which lived in the `Ivory\GoogleMap\Services\Directions`
+   namespace have been moved in the `Ivory\GoogleMap\Services\Base` one in order to be shared across services.
+ * The `MapHelper` constructor now takes an `ApiHelper` as first argument (all the other parameters have been moved
+   forward).
+
+### 0.9.0 to 0.9.1
+
+ * All helpers classes have been refactored in order to generate a JS container by map.
+ * The `TemplatingException` has been renamed to `HelperException` to be consistent with the namespace.
diff --git a/composer.json b/composer.json
@@ -0,0 +1,37 @@
+{
+    "name": "egeloen/google-map",
+    "description": "Google Map API v3 integration for PHP 5.3+",
+    "keywords": [ "google map" ],
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Eric GELOEN",
+            "email": "[email protected]"
+        }
+    ],
+    "require": {
+        "php": ">=5.3.0",
+        "egeloen/json-builder": "~1.0.0"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "~4.0",
+        "widop/http-adapter": "~1.1.0",
+        "willdurand/geocoder": "~2.0",
+        "satooshi/php-coveralls": "~0.6"
+    },
+    "suggest": {
+        "widop/http-adapter": "Allows to use services",
+        "willdurand/geocoder": "Allows to use geocoding service"
+    },
+    "autoload": {
+        "psr-4": { "Ivory\\GoogleMap\\": "src/" }
+    },
+    "config": {
+        "bin-dir": "bin/"
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "1.4-dev"
+        }
+    }
+}
diff --git a/doc/installation.md b/doc/installation.md
@@ -0,0 +1,79 @@
+# Installation
+
+To install the Ivory Google Map library, you will need [Composer](http://getcomposer.org). It's a PHP 5.3+ dependency
+manager which allows you to declare the dependent libraries your project needs and it will install & autoload them for
+you.
+
+## Set up Composer
+
+Composer comes with a simple phar file. To easily access it from anywhere on your system, you can execute:
+
+```
+$ curl -s https://getcomposer.org/installer | php
+$ sudo mv composer.phar /usr/local/bin/composer
+```
+
+## Define dependencies
+
+### Mandatories dependencies
+
+Create a ``composer.json`` file at the root directory of your project and simply require the
+``egeloen/google-map`` package:
+
+```
+{
+    "require": {
+        "egeloen/google-map": "dev-master"
+    }
+}
+```
+
+### Optional dependencies
+
+If you want to use Geocoding stuff, you will need [Geocoder](http://github.com/willdurand/Geocoder):
+
+```
+{
+    "require": {
+        "willdurand/geocoder": "*"
+    }
+}
+```
+
+If you want to use Directions or Distance Matrix stuff, you will need an
+[http adapter](http://github.com/widop/http-adapter):
+
+```
+{
+    "require": {
+        "widop/http-adapter": "1.0.*"
+    }
+}
+```
+
+## Install dependencies
+
+Now, you have define your dependencies, you can install them:
+
+```
+$ composer install
+```
+
+Composer will automatically download your dependencies & create an autoload file in the ``vendor`` directory.
+
+## Autoload
+
+So easy, you just have to require the generated autoload file and you are already ready to play:
+
+``` php
+<?php
+
+require __DIR__.'/vendor/autoload.php';
+
+use Ivory\GoogleMap;
+
+// ...
+```
+
+The Ivory Google Map library follows the [PSR-4 Standard](http://www.php-fig.org/psr/psr-4/). If you prefer install it
+manually, it can be autoload by any convenient autoloader.