Completed
Push — master ( 4ff427...097360 )
by Mark
02:38
created

action.php (9 issues)

Upgrade to new PHP Analysis Engine

These results are based on our legacy PHP analysis, consider migrating to our new PHP analysis engine instead. Learn more

1
<?php
0 ignored issues
show
File has mixed line endings; this may cause incorrect results
Loading history...
2
/*
3
 * Copyright (c) 2011-2016 Mark C. Prins <[email protected]>
4
 *
5
 * Permission to use, copy, modify, and distribute this software for any
6
 * purpose with or without fee is hereby granted, provided that the above
7
 * copyright notice and this permission notice appear in all copies.
8
 *
9
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16
 */
17
if (!defined('DOKU_INC')) {
18
	die ();
19
}
20
if (!defined('DOKU_PLUGIN')) {
21
	define('DOKU_PLUGIN', DOKU_INC . 'lib/plugins/');
22
}
23
if (!defined('DOKU_LF')) {
24
	define('DOKU_LF', "\n");
25
}
26
require_once (DOKU_PLUGIN . 'action.php');
27
28
/**
29
 * DokuWiki Plugin dokuwikispatial (Action Component).
30
 *
31
 * @license BSD license
32
 * @author Mark C. Prins <[email protected]>
33
 */
34
class action_plugin_spatialhelper extends DokuWiki_Action_Plugin {
35
36
	/**
37
	 * Register for events.
38
	 *
39
	 * @param Doku_Event_Handler $controller
40
	 *        	DokuWiki's event controller object. Also available as global $EVENT_HANDLER
41
	 */
42
	public function register(Doku_Event_Handler $controller) {
43
		// listen for page add / delete events
44
		// http://www.dokuwiki.org/devel:event:indexer_page_add
45
		$controller->register_hook('INDEXER_PAGE_ADD', 'BEFORE', $this, 'handle_indexer_page_add');
46
		$controller->register_hook('IO_WIKIPAGE_WRITE', 'BEFORE', $this, '_removeFromIndex');
47
48
		// http://www.dokuwiki.org/devel:event:sitemap_generate
49
		$controller->register_hook('SITEMAP_GENERATE', 'BEFORE', $this, 'handle_sitemap_generate_before');
50
		// using after will only trigger us if a sitemap was actually created
51
		$controller->register_hook('SITEMAP_GENERATE', 'AFTER', $this, 'handle_sitemap_generate_after');
52
53
		// handle actions we know of
54
		$controller->register_hook('ACTION_ACT_PREPROCESS', 'BEFORE', $this, 'handle_action_act_preprocess', array());
55
		// handle HTML eg. /dokuwiki/doku.php?id=start&do=findnearby&geohash=u15vk4
56
		$controller->register_hook('TPL_ACT_UNKNOWN', 'BEFORE', $this, '_findnearby', array(
57
				'format' => 'HTML'
58
		));
59
		// handles AJAX/json eg: jQuery.post("/dokuwiki/lib/exe/ajax.php?id=start&call=findnearby&geohash=u15vk4");
60
		$controller->register_hook('AJAX_CALL_UNKNOWN', 'BEFORE', $this, '_findnearby', array(
61
				'format' => 'JSON'
62
		));
63
64
		// listen for media uploads and deletes
65
		$controller->register_hook('MEDIA_UPLOAD_FINISH', 'BEFORE', $this, '_handle_media_uploaded', array());
66
		$controller->register_hook('MEDIA_DELETE_FILE', 'BEFORE', $this, '_handle_media_deleted', array());
67
68
		$controller->register_hook('TPL_METAHEADER_OUTPUT', 'BEFORE', $this, 'handle_metaheader_output');
69
	}
70
71
	/**
72
	 * Update the spatial index for the page.
73
	 *
74
	 * @param Doku_Event $event
75
	 *        	event object by reference
76
	 * @param object $param
77
	 *        	the parameters passed to register_hook when this handler was registered
78
	 */
79
	function handle_indexer_page_add(Doku_Event $event, $param) {
80
		// $event→data['page'] – the page id
81
		// $event→data['body'] – empty, can be filled by additional content to index by your plugin
82
		// $event→data['metadata'] – the metadata that shall be indexed. This is an array where the keys are the metadata indexes and the value a string or an array of strings with the values. title and relation_references will already be set.
83
		$id = $event->data ['page'];
84
		$indexer = & plugin_load('helper', 'spatialhelper_index');
85
		$entries = $indexer->updateSpatialIndex($id);
86
	}
87
88
	/**
89
	 * Update the spatial index, removing the page.
90
	 *
0 ignored issues
show
Unused Code Comprehensibility introduced by
42% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
91
	 * @param Doku_Event $event
92
	 *        	event object by reference
93
	 * @param object $param
94
	 *        	the parameters passed to register_hook when this handler was registered
95
	 */
96
	function _removeFromIndex(Doku_Event & $event, $param) {
97
		// event data:
98
		// $data[0] – The raw arguments for io_saveFile as an array. Do not change file path.
99
		// $data[0][0] – the file path.
100
		// $data[0][1] – the content to be saved, and may be modified.
101
		// $data[1] – ns: The colon separated namespace path minus the trailing page name. (false if root ns)
102
		// $data[2] – page_name: The wiki page name.
103
		// $data[3] – rev: The page revision, false for current wiki pages.
104
105
		// dbglog ( $event->data, "Event data in _removeFromIndex." );
106
		if (@file_exists($event->data [0] [0])) {
107
			// file not new
108
			if (!$event->data [0] [1]) {
109
				// file is empty, page is being deleted
110
				if (empty ($event->data [1])) {
111
					// root namespace
112
					$id = $event->data [2];
113
				} else {
114
					$id = $event->data [1] . ":" . $event->data [2];
115
				}
116
				$indexer = & plugin_load('helper', 'spatialhelper_index');
117
				if ($indexer) {
118
					$indexer->deleteFromIndex($id);
119
				}
120
			}
121
		}
122
	}
123
124
	/**
125
	 * Add a new SitemapItem object that points to the KML of public geocoded pages.
0 ignored issues
show
Unused Code Comprehensibility introduced by
56% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
126
	 *
127
	 * @param Doku_Event $event
128
	 * @param unknown $param
129
	 */
130
	function handle_sitemap_generate_before(Doku_Event $event, $param) {
131
		$path = mediaFN($this->getConf('media_kml'));
132
		$lastmod = @filemtime($path);
133
		$event->data ['items'] [] = new SitemapItem(ml($this->getConf('media_kml'), '', true, '&amp;', true), $lastmod);
134
		// dbglog ( $event->data ['items'], "Added a new SitemapItem object that points to the KML of public geocoded pages." );
135
	}
136
137
	/**
138
	 * Create a spatial sitemap or attach the geo/kml map to the sitemap.
139
	 *
140
	 * @param Doku_Event $event
0 ignored issues
show
Unused Code Comprehensibility introduced by
63% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
141
	 *        	event object by reference, not used
142
	 * @param mixed $param
0 ignored issues
show
Unused Code Comprehensibility introduced by
50% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
143
	 *        	parameter array, not used
144
	 */
145
	function handle_sitemap_generate_after(Doku_Event $event, $param) {
146
		// $event→data['items']: Array of SitemapItem instances, the array of sitemap items that already contains all public pages of the wiki
147
		// $event→data['sitemap']: The path of the file the sitemap will be saved to.
148
0 ignored issues
show
This else statement is empty and can be removed.

This check looks for the else branches of if statements that have no statements or where all statements have been commented out. This may be the result of changes for debugging or the code may simply be obsolete.

These else branches can be removed.

if (rand(1, 6) > 3) {
print "Check failed";
} else {
    //print "Check succeeded";
}

could be turned into

if (rand(1, 6) > 3) {
    print "Check failed";
}

This is much more concise to read.

Loading history...
149
		// dbglog ($event->data['items'], "createSpatialSitemap loading helper" );
150
		if ($helper = & plugin_load('helper', 'spatialhelper_sitemap')) {
151
			// dbglog ( $helper, "createSpatialSitemap loaded helper." );
152
153
			$kml = $helper->createKMLSitemap($this->getConf('media_kml'));
154
			$rss = $helper->createGeoRSSSitemap($this->getConf('media_georss'));
155
156
			return $kml && $rss;
157
		} else {
158
			// dbglog ( $helper, "createSpatialSitemap NOT loaded helper." );
159
		}
160
	}
161
162
	/**
163
	 * trap findnearby action.
164
	 * This addional handler is required as described at: https://www.dokuwiki.org/devel:event:tpl_act_unknown
165
	 *
166
	 * @param Doku_Event $event
167
	 *        	event object by reference
168
	 * @param mixed $param
169
	 *        	not used
170
	 */
171
	function handle_action_act_preprocess(Doku_Event $event, $param) {
172
		if ($event->data != 'findnearby') {
173
					return;
174
		}
175
		$event->preventDefault();
176
	}
177
178
	/**
179
	 * handle findnearby action.
180
	 *
181
	 * @param Doku_Event $event
182
	 *        	event object by reference
183
	 * @param mixed $param
184
	 *        	associative array with keys
185
	 *        	'format'=> HTML | JSON
186
	 */
187
	function _findnearby(Doku_Event & $event, $param) {
188
		if ($event->data != 'findnearby') {
189
					return;
190
		}
191
		$event->preventDefault();
192
193
		global $INPUT;
194
		if ($helper = & plugin_load('helper', 'spatialhelper_search')) {
195
			if ($INPUT->has('lat') && $INPUT->has('lon')) {
196
				$results = $helper->findNearbyLatLon($INPUT->param('lat'), $INPUT->param('lon'));
197
			} elseif ($INPUT->has('geohash')) {
198
				$results = $helper->findNearby($INPUT->str('geohash'));
199
			} else {
200
				$results = array(
201
						'error' => hsc($this->getLang('invalidinput'))
202
				);
203
			}
204
		}
205
206
		$showMedia = $INPUT->bool('showMedia', true);
207
208
		switch ($param['format']) {
209
			case 'JSON' :
210
				$this->printJSON($results);
211
				break;
212
			case 'HTML' :
213
			// fall through to default
214
			default :
215
				$this->printHTML($results, $showMedia);
216
				break;
217
		}
218
	}
219
220
	/**
221
	 * Print seachresults as HTML lists.
222
	 *
223
	 * @param array $searchresults
224
	 */
225
	private function printJSON($searchresults) {
226
		require_once DOKU_INC . 'inc/JSON.php';
227
		$json = new JSON();
228
		header('Content-Type: application/json');
229
		print $json->encode($searchresults);
230
	}
231
232
	/**
233
	 * Print seachresults as HTML lists.
234
	 *
235
	 * @param array $searchresults
236
	 * @param boolean $showMedia
237
	 */
238
	private function printHTML($searchresults, $showMedia = true) {
239
		$pages = ( array ) ($searchresults ['pages']);
240
		$media = ( array ) $searchresults ['media'];
241
		$lat = ( float ) $searchresults ['lat'];
242
		$lon = ( float ) $searchresults ['lon'];
243
		$geohash = ( string ) $searchresults ['geohash'];
244
245
		if (isset ($searchresults ['error'])) {
246
			print '<div class="level1"><p>' . hsc($results ['error']) . '</p></div>';
247
			return;
248
		}
249
250
		// print a HTML list
251
		print '<h1>' . $this->getLang('results_header') . '</h1>' . DOKU_LF;
252
		print '<div class="level1">' . DOKU_LF;
253
		if (!empty ($pages)) {
254
			$pagelist = '<ol>' . DOKU_LF;
255
			foreach ($pages as $page) {
256
				$pagelist .= '<li>' . html_wikilink(':' . $page ['id'], useHeading('navigation') ? null : noNS($page ['id'])) . ' (' . $this->getLang('results_distance_prefix') . $page ['distance'] . '&nbsp;m) ' . $page ['description'] . '</li>' . DOKU_LF;
257
			}
258
			$pagelist .= '</ol>' . DOKU_LF;
259
260
			print '<h2>' . $this->getLang('results_pages') . hsc(' lat;lon: ' . $lat . ';' . $lon . ' (geohash: ' . $geohash . ')') . '</h2>';
261
			print '<div class="level2">' . DOKU_LF;
262
			print $pagelist;
263
			print '</div>' . DOKU_LF;
264
		} else {
265
			print '<p>' . hsc($this->getLang('nothingfound')) . '</p>';
266
		}
267
268
		if (!empty ($media) && $showMedia) {
269
			$pagelist = '<ol>' . DOKU_LF;
270
			foreach ($media as $m) {
271
				$opts = array();
272
				$link = ml($m ['id'], $opts, false, '&amp;', false);
273
				$opts ['w'] = '100';
274
				$src = ml($m ['id'], $opts);
275
				$pagelist .= '<li><a href="' . $link . '"><img src="' . $src . '"></a> (' . $this->getLang('results_distance_prefix') . $page ['distance'] . '&nbsp;m) ' . hsc($desc) . '</li>' . DOKU_LF;
276
			}
277
			$pagelist .= '</ol>' . DOKU_LF;
278
279
			print '<h2>' . $this->getLang('results_media') . hsc(' lat;lon: ' . $lat . ';' . $lon . ' (geohash: ' . $geohash . ')') . '</h2>' . DOKU_LF;
280
			print '<div class="level2">' . DOKU_LF;
281
			print $pagelist;
282
			print '</div>' . DOKU_LF;
283
		}
284
		print '<p>' . $this->getLang('results_precision') . $searchresults ['precision'] . ' m. ';
285
		if (strlen($geohash) > 1) {
286
			$url = wl(getID(), array(
287
					'do' => 'findnearby',
288
					'geohash' => substr($geohash, 0, - 1)
289
			));
290
			print '<a href="' . $url . '" class="findnearby">' . $this->getLang('search_largerarea') . '</a>.</p>' . DOKU_LF;
291
		}
292
		print '</div>' . DOKU_LF;
293
	}
294
295
	/**
0 ignored issues
show
Unused Code Comprehensibility introduced by
50% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
296
	 * add media to spatial index.
297
	 *
298
	 * @param Doku_Event $event
299
	 *        	event object by reference
300
	 * @param unknown $param
301
	 */
302
	function _handle_media_uploaded(Doku_Event & $event, $param) {
303
		// data[0] temporary file name (read from $_FILES)
304
		// data[1] file name of the file being uploaded
305
		// data[2] future directory id of the file being uploaded
306
		// data[3] the mime type of the file being uploaded
307
		// data[4] true if the uploaded file exists already
308
		// data[5] (since 2011-02-06) the PHP function used to move the file to the correct location
309
310
		// dbglog ( $event->data, "_handle_media_uploaded::event data" );
311
312
		// check the list of mimetypes
313
		// if it's a supported type call appropriate index function
0 ignored issues
show
Unused Code Comprehensibility introduced by
39% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
314
		if (substr_compare($event->data [3], 'image/jpeg', 0)) {
315
			$indexer = plugin_load('helper', 'spatialhelper_index');
316
			if ($indexer) {
317
				$indexer->indexImage($event->data [2], $event->data [1]);
318
			}
0 ignored issues
show
Unused Code Comprehensibility introduced by
50% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
319
		}
320
		// TODO add image/tiff
321
		// TODO kml, gpx, geojson...
322
	}
323
324
	/**
325
	 * removes the media from the index.
326
	 */
327
	function _handle_media_deleted(Doku_Event & $event, $param) {
328
		// data['id'] ID data['unl'] unlink return code
329
		// data['del'] Namespace directory unlink return code
330
		// data['name'] file name data['path'] full path to the file
331
		// data['size'] file size
332
333
		// dbglog ( $event->data, "_handle_media_deleted::event data" );
334
335
		// remove the media id from the index
336
		$indexer = & plugin_load('helper', 'spatialhelper_index');
337
		if ($indexer) {
338
			$indexer->deleteFromIndex('media__' . $event->data ['id']);
339
		}
340
	}
341
342
	/**
343
	 * add a link to the spatial sitemap files in the header.
344
	 *
345
	 * @param Doku_Event $event
346
	 *        	the DokuWiki event. $event->data is a two-dimensional
347
	 *        	array of all meta headers. The keys are meta, link and script.
348
	 * @param unknown_type $param
349
	 *
350
	 * @see http://www.dokuwiki.org/devel:event:tpl_metaheader_output
351
	 */
352
	public function handle_metaheader_output(Doku_Event $event, $param) {
353
		// TODO maybe test for exist
354
		$event->data ["link"] [] = array(
355
				"type" => "application/atom+xml",
356
				"rel" => "alternate",
357
				"href" => ml($this->getConf('media_georss')),
358
				"title" => "Spatial ATOM Feed"
359
		);
360
		$event->data ["link"] [] = array(
361
				"type" => "application/vnd.google-earth.kml+xml",
362
				"rel" => "alternate",
363
				"href" => ml($this->getConf('media_kml')),
364
				"title" => "KML Sitemap"
365
		);
366
	}
367
368
	/**
369
	 * Calculate a new coordinate based on start, distance and bearing
370
	 *
371
	 * @param $start array
372
	 *        	- start coordinate as decimal lat/lon pair
373
	 * @param $dist float
374
	 *        	- distance in kilometers
375
	 * @param $brng float
376
	 *        	- bearing in degrees (compass direction)
377
	 */
378
	private function _geo_destination($start, $dist, $brng) {
379
		$lat1 = _toRad($start [0]);
380
		$lon1 = _toRad($start [1]);
381
		// http://en.wikipedia.org/wiki/Earth_radius
382
		// average earth radius in km
383
		$dist = $dist / 6371.01;
384
		$brng = _toRad($brng);
385
386
		$lon2 = $lon1 + atan2(sin($brng) * sin($dist) * cos($lat1), cos($dist) - sin($lat1) * sin($lat2));
387
		$lon2 = fmod(($lon2 + 3 * pi()), (2 * pi())) - pi();
388
389
		return array(
390
				_toDeg($lat2),
391
				_toDeg($lon2)
392
		);
393
	}
394
	private function _toRad($deg) {
395
		return $deg * pi() / 180;
396
	}
397
	private function _toDeg($rad) {
398
		return $rad * 180 / pi();
399
	}
400
}
401