aboutsummaryrefslogtreecommitdiff
path: root/engine/lib
diff options
context:
space:
mode:
Diffstat (limited to 'engine/lib')
-rw-r--r--engine/lib/entities.php51
-rw-r--r--engine/lib/location.php94
2 files changed, 145 insertions, 0 deletions
diff --git a/engine/lib/entities.php b/engine/lib/entities.php
index 99c8bdca6..b645fc372 100644
--- a/engine/lib/entities.php
+++ b/engine/lib/entities.php
@@ -17,6 +17,9 @@
/// Cache subtype searches
$SUBTYPE_CACHE = NULL;
+ /// Require the locatable interface TODO: Move this into start.php?
+ require_once('location.php');
+
/**
* ElggEntity The elgg entity superclass
* This class holds methods for accessing the main entities table.
@@ -27,6 +30,7 @@
*/
abstract class ElggEntity implements
Notable, // Calendar interface
+ Locatable, // Geocoding interface
Exportable, // Allow export of data
Importable, // Allow import of data
Loggable, // Can events related to this object class be logged
@@ -711,6 +715,53 @@
return $res;
}
+ // LOCATABLE INTERFACE /////////////////////////////////////////////////////////////
+
+ /** Interface to set the location */
+ public function setLocation($location)
+ {
+ $location = sanitise_string($location);
+
+ $this->location = $location;
+
+ return true;
+ }
+
+ /**
+ * Set latitude and longitude tags for a given entity.
+ *
+ * @param float $lat
+ * @param float $long
+ */
+ public function setLatLong($lat, $long)
+ {
+ $lat = sanitise_string($lat);
+ $long = sanitise_string($long);
+
+ $this->set('geo:lat', $lat);
+ $this->set('geo:long', $long);
+
+ return true;
+ }
+
+ /**
+ * Get the contents of the ->geo:lat field.
+ *
+ */
+ public function getLatitude() { return $this->get('geo:lat'); }
+
+ /**
+ * Get the contents of the ->geo:lat field.
+ *
+ */
+ public function getLongitude() { return $this->get('geo:long'); }
+
+ /**
+ * Get the ->location metadata.
+ *
+ */
+ public function getLocation() { return $this->get('location'); }
+
// NOTABLE INTERFACE ///////////////////////////////////////////////////////////////
/**
diff --git a/engine/lib/location.php b/engine/lib/location.php
new file mode 100644
index 000000000..eec665234
--- /dev/null
+++ b/engine/lib/location.php
@@ -0,0 +1,94 @@
+<?php
+
+ /**
+ * Elgg geo-location tagging library.
+ *
+ * @package Elgg
+ * @subpackage Core
+ * @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html GNU Public License version 2
+ * @author Curverider Ltd
+ * @copyright Curverider Ltd 2008
+ * @link http://elgg.org/
+ */
+
+ /**
+ * Define an interface for geo-tagging entities.
+ *
+ */
+ interface Locatable
+ {
+ /** Set a location text */
+ public function setLocation($location);
+
+ /**
+ * Set latitude and longitude tags for a given entity.
+ *
+ * @param float $lat
+ * @param float $long
+ */
+ public function setLatLong($lat, $long);
+
+ /**
+ * Get the contents of the ->geo:lat field.
+ *
+ */
+ public function getLatitude();
+
+ /**
+ * Get the contents of the ->geo:lat field.
+ *
+ */
+ public function getLongitude();
+
+ /**
+ * Get the ->location metadata.
+ *
+ */
+ public function getLocation();
+ }
+
+ /**
+ * Encode a location into a latitude and longitude, caching the result.
+ *
+ * Works by triggering the 'geocode' 'location' plugin hook, and requires a geocoding module to be installed
+ * activated in order to work.
+ *
+ * @param String $location The location, e.g. "London", or "24 Foobar Street, Gotham City"
+ */
+ function elgg_geocode_location($location)
+ {
+ global $CONFIG;
+
+ $location = sanitise_string($location);
+
+ // Look for cached version
+ $cached_location = get_data_row("SELECT * from {$CONFIG->dbprefix}geocode_cache WHERE location='$location'");
+
+ // Trigger geocode event
+ $return = false;
+ $return = trigger_plugin_hook('geocode', 'location', array('location' => $location, $return));
+
+ // If returned, cache and return value
+ if (($return) && (is_array($return)))
+ {
+ $lat = (int)$return['lat'];
+ $long = (int)$return['long'];
+
+ // Put into cache at the end of the page since we don't really care that much
+ execute_delayed_write_query("INSERT DELAYED INTO {$CONFIG->dbprefix}geocode_cache (lat, long) VALUES ({$lat}, {$long}) ON DUPLICATE KEY UPDATE lat={$lat} long={$long}");
+ }
+
+ return $return;
+ }
+
+ // Some distances in degrees (approximate)
+ define("MILE", 0.01515);
+ define("KILOMETER", 0.00932);
+
+
+ // TODO: get objects within x miles by entities, metadata and relationship
+
+ // TODO: List
+
+
+?> \ No newline at end of file