These results are based on our legacy PHP analysis, consider migrating to our new PHP analysis engine instead. Learn more
1 | <?php |
||
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 | public 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); |
||
0 ignored issues
–
show
|
|||
86 | } |
||
87 | |||
88 | /** |
||
89 | * Update the spatial index, removing the page. |
||
90 | * |
||
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 | public 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. |
||
126 | * |
||
127 | * @param Doku_Event $event |
||
128 | * @param unknown $param |
||
129 | */ |
||
130 | public 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, '&', 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 |
||
141 | * event object by reference, not used |
||
142 | * @param mixed $param |
||
143 | * parameter array, not used |
||
144 | */ |
||
145 | public 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 | if ($helper = & plugin_load('helper', 'spatialhelper_sitemap')) { |
||
149 | // dbglog($helper, "createSpatialSitemap loaded helper."); |
||
0 ignored issues
–
show
Unused Code
Comprehensibility
introduced
by
67% 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. ![]() |
|||
150 | |||
151 | $kml = $helper->createKMLSitemap($this->getConf('media_kml')); |
||
152 | $rss = $helper->createGeoRSSSitemap($this->getConf('media_georss')); |
||
153 | |||
154 | if (!empty ($this->getConf('sitemap_namespaces'))) { |
||
155 | $namespaces = array_map('trim',explode("\n",$this->getConf('sitemap_namespaces'))); |
||
156 | foreach ($namespaces as $namespace) { |
||
157 | $kmlN = $helper->createKMLSitemap($namespace . $this->getConf('media_kml')); |
||
158 | $rssN = $helper->createGeoRSSSitemap($namespace . $this->getConf('media_georss')); |
||
159 | dbglog( $kmlN && $rssN, "handle_sitemap_generate_after, created KML / GeoRSS sitemap in $namespace, succes: "); |
||
160 | } |
||
161 | } |
||
162 | return $kml && $rss; |
||
163 | } else { |
||
164 | dbglog($helper, "createSpatialSitemap NOT loaded helper."); |
||
165 | } |
||
166 | } |
||
167 | |||
168 | /** |
||
169 | * trap findnearby action. |
||
170 | * This addional handler is required as described at: https://www.dokuwiki.org/devel:event:tpl_act_unknown |
||
171 | * |
||
172 | * @param Doku_Event $event |
||
173 | * event object by reference |
||
174 | * @param mixed $param |
||
175 | * not used |
||
176 | */ |
||
177 | public function handle_action_act_preprocess(Doku_Event $event, $param) { |
||
178 | if ($event->data != 'findnearby') { |
||
179 | return; |
||
180 | } |
||
181 | $event->preventDefault(); |
||
182 | } |
||
183 | |||
184 | /** |
||
185 | * handle findnearby action. |
||
186 | * |
||
187 | * @param Doku_Event $event |
||
188 | * event object by reference |
||
189 | * @param mixed $param |
||
190 | * associative array with keys |
||
191 | * 'format'=> HTML | JSON |
||
192 | */ |
||
193 | public function _findnearby(Doku_Event & $event, $param) { |
||
194 | if ($event->data != 'findnearby') { |
||
195 | return; |
||
196 | } |
||
197 | $event->preventDefault(); |
||
198 | |||
199 | global $INPUT; |
||
200 | if ($helper = & plugin_load('helper', 'spatialhelper_search')) { |
||
201 | if ($INPUT->has('lat') && $INPUT->has('lon')) { |
||
202 | $results = $helper->findNearbyLatLon($INPUT->param('lat'), $INPUT->param('lon')); |
||
203 | } elseif ($INPUT->has('geohash')) { |
||
204 | $results = $helper->findNearby($INPUT->str('geohash')); |
||
205 | } else { |
||
206 | $results = array( |
||
207 | 'error' => hsc($this->getLang('invalidinput')) |
||
208 | ); |
||
209 | } |
||
210 | } |
||
211 | |||
212 | $showMedia = $INPUT->bool('showMedia', true); |
||
213 | |||
214 | switch ($param['format']) { |
||
215 | case 'JSON' : |
||
216 | $this->printJSON($results); |
||
0 ignored issues
–
show
The variable
$results does not seem to be defined for all execution paths leading up to this point.
If you define a variable conditionally, it can happen that it is not defined for all execution paths. Let’s take a look at an example: function myFunction($a) {
switch ($a) {
case 'foo':
$x = 1;
break;
case 'bar':
$x = 2;
break;
}
// $x is potentially undefined here.
echo $x;
}
In the above example, the variable $x is defined if you pass “foo” or “bar” as argument for $a. However, since the switch statement has no default case statement, if you pass any other value, the variable $x would be undefined. Available Fixes
![]() |
|||
217 | break; |
||
218 | case 'HTML' : |
||
219 | // fall through to default |
||
220 | default : |
||
221 | $this->printHTML($results, $showMedia); |
||
222 | break; |
||
223 | } |
||
224 | } |
||
225 | |||
226 | /** |
||
227 | * Print seachresults as HTML lists. |
||
228 | * |
||
229 | * @param array $searchresults |
||
230 | */ |
||
231 | private function printJSON($searchresults) { |
||
232 | require_once DOKU_INC . 'inc/JSON.php'; |
||
233 | $json = new JSON(); |
||
234 | header('Content-Type: application/json'); |
||
235 | print $json->encode($searchresults); |
||
236 | } |
||
237 | |||
238 | /** |
||
239 | * Print seachresults as HTML lists. |
||
240 | * |
||
241 | * @param array $searchresults |
||
242 | * @param boolean $showMedia |
||
243 | */ |
||
244 | private function printHTML($searchresults, $showMedia = true) { |
||
245 | $pages = ( array ) ($searchresults ['pages']); |
||
246 | $media = ( array ) $searchresults ['media']; |
||
247 | $lat = ( float ) $searchresults ['lat']; |
||
248 | $lon = ( float ) $searchresults ['lon']; |
||
249 | $geohash = ( string ) $searchresults ['geohash']; |
||
250 | |||
251 | if (isset ($searchresults ['error'])) { |
||
252 | print '<div class="level1"><p>' . hsc($results ['error']) . '</p></div>'; |
||
0 ignored issues
–
show
The variable
$results does not exist. Did you mean $searchresults ?
This check looks for variables that are accessed but have not been defined. It raises an issue if it finds another variable that has a similar name. The variable may have been renamed without also renaming all references. ![]() |
|||
253 | return; |
||
254 | } |
||
255 | |||
256 | // print a HTML list |
||
257 | print '<h1>' . $this->getLang('results_header') . '</h1>' . DOKU_LF; |
||
258 | print '<div class="level1">' . DOKU_LF; |
||
259 | if (!empty ($pages)) { |
||
260 | $pagelist = '<ol>' . DOKU_LF; |
||
261 | foreach ($pages as $page) { |
||
262 | $pagelist .= '<li>' . html_wikilink(':' . $page ['id'], useHeading('navigation') ? null : noNS($page ['id'])) . ' (' . $this->getLang('results_distance_prefix') . $page ['distance'] . ' m) ' . $page ['description'] . '</li>' . DOKU_LF; |
||
263 | } |
||
264 | $pagelist .= '</ol>' . DOKU_LF; |
||
265 | |||
266 | print '<h2>' . $this->getLang('results_pages') . hsc(' lat;lon: ' . $lat . ';' . $lon . ' (geohash: ' . $geohash . ')') . '</h2>'; |
||
267 | print '<div class="level2">' . DOKU_LF; |
||
268 | print $pagelist; |
||
269 | print '</div>' . DOKU_LF; |
||
270 | } else { |
||
271 | print '<p>' . hsc($this->getLang('nothingfound')) . '</p>'; |
||
272 | } |
||
273 | |||
274 | if (!empty ($media) && $showMedia) { |
||
275 | $pagelist = '<ol>' . DOKU_LF; |
||
276 | foreach ($media as $m) { |
||
277 | $opts = array(); |
||
278 | $link = ml($m ['id'], $opts, false, '&', false); |
||
279 | $opts ['w'] = '100'; |
||
280 | $src = ml($m ['id'], $opts); |
||
281 | $pagelist .= '<li><a href="' . $link . '"><img src="' . $src . '"></a> (' . $this->getLang('results_distance_prefix') . $page ['distance'] . ' m) ' . hsc($desc) . '</li>' . DOKU_LF; |
||
0 ignored issues
–
show
The variable
$page seems to be defined by a foreach iteration on line 261 . Are you sure the iterator is never empty, otherwise this variable is not defined?
It seems like you are relying on a variable being defined by an iteration: foreach ($a as $b) {
}
// $b is defined here only if $a has elements, for example if $a is array()
// then $b would not be defined here. To avoid that, we recommend to set a
// default value for $b.
// Better
$b = 0; // or whatever default makes sense in your context
foreach ($a as $b) {
}
// $b is now guaranteed to be defined here.
![]() |
|||
282 | } |
||
283 | $pagelist .= '</ol>' . DOKU_LF; |
||
284 | |||
285 | print '<h2>' . $this->getLang('results_media') . hsc(' lat;lon: ' . $lat . ';' . $lon . ' (geohash: ' . $geohash . ')') . '</h2>' . DOKU_LF; |
||
286 | print '<div class="level2">' . DOKU_LF; |
||
287 | print $pagelist; |
||
288 | print '</div>' . DOKU_LF; |
||
289 | } |
||
290 | print '<p>' . $this->getLang('results_precision') . $searchresults ['precision'] . ' m. '; |
||
291 | if (strlen($geohash) > 1) { |
||
292 | $url = wl(getID(), array( |
||
293 | 'do' => 'findnearby', |
||
294 | 'geohash' => substr($geohash, 0, - 1) |
||
295 | )); |
||
296 | print '<a href="' . $url . '" class="findnearby">' . $this->getLang('search_largerarea') . '</a>.</p>' . DOKU_LF; |
||
297 | } |
||
298 | print '</div>' . DOKU_LF; |
||
299 | } |
||
300 | |||
301 | /** |
||
302 | * add media to spatial index. |
||
303 | * |
||
304 | * @param Doku_Event $event |
||
305 | * event object by reference |
||
306 | * @param unknown $param |
||
307 | */ |
||
308 | public function _handle_media_uploaded(Doku_Event & $event, $param) { |
||
309 | // data[0] temporary file name (read from $_FILES) |
||
310 | // data[1] file name of the file being uploaded |
||
311 | // data[2] future directory id of the file being uploaded |
||
312 | // data[3] the mime type of the file being uploaded |
||
313 | // data[4] true if the uploaded file exists already |
||
314 | // data[5] (since 2011-02-06) the PHP function used to move the file to the correct location |
||
315 | |||
316 | dbglog($event->data, "_handle_media_uploaded::event data"); |
||
317 | |||
318 | // check the list of mimetypes |
||
319 | // if it's a supported type call appropriate index function |
||
320 | if (substr_compare($event->data [3], 'image/jpeg', 0)) { |
||
321 | $indexer = plugin_load('helper', 'spatialhelper_index'); |
||
322 | if ($indexer) { |
||
323 | $indexer->indexImage($event->data [2], $event->data [1]); |
||
324 | } |
||
325 | } |
||
326 | // TODO add image/tiff |
||
327 | // TODO kml, gpx, geojson... |
||
328 | } |
||
329 | |||
330 | /** |
||
331 | * removes the media from the index. |
||
332 | */ |
||
333 | public function _handle_media_deleted(Doku_Event & $event, $param) { |
||
334 | // data['id'] ID data['unl'] unlink return code |
||
335 | // data['del'] Namespace directory unlink return code |
||
336 | // data['name'] file name data['path'] full path to the file |
||
337 | // data['size'] file size |
||
338 | |||
339 | dbglog($event->data, "_handle_media_deleted::event data"); |
||
340 | |||
341 | // remove the media id from the index |
||
342 | $indexer = & plugin_load('helper', 'spatialhelper_index'); |
||
343 | if ($indexer) { |
||
344 | $indexer->deleteFromIndex('media__' . $event->data ['id']); |
||
345 | } |
||
346 | } |
||
347 | |||
348 | /** |
||
349 | * add a link to the spatial sitemap files in the header. |
||
350 | * |
||
351 | * @param Doku_Event $event |
||
352 | * the DokuWiki event. $event->data is a two-dimensional |
||
353 | * array of all meta headers. The keys are meta, link and script. |
||
354 | * @param unknown_type $param |
||
355 | * |
||
356 | * @see http://www.dokuwiki.org/devel:event:tpl_metaheader_output |
||
357 | */ |
||
358 | public function handle_metaheader_output(Doku_Event $event, $param) { |
||
359 | // TODO maybe test for exist |
||
360 | $event->data ["link"] [] = array( |
||
361 | "type" => "application/atom+xml", |
||
362 | "rel" => "alternate", |
||
363 | "href" => ml($this->getConf('media_georss')), |
||
364 | "title" => "Spatial ATOM Feed" |
||
365 | ); |
||
366 | $event->data ["link"] [] = array( |
||
367 | "type" => "application/vnd.google-earth.kml+xml", |
||
368 | "rel" => "alternate", |
||
369 | "href" => ml($this->getConf('media_kml')), |
||
370 | "title" => "KML Sitemap" |
||
371 | ); |
||
372 | } |
||
373 | |||
374 | /** |
||
375 | * Calculate a new coordinate based on start, distance and bearing |
||
376 | * |
||
377 | * @param $start array |
||
378 | * - start coordinate as decimal lat/lon pair |
||
379 | * @param $dist float |
||
380 | * - distance in kilometers |
||
381 | * @param $brng float |
||
382 | * - bearing in degrees (compass direction) |
||
383 | */ |
||
384 | private function _geo_destination($start, $dist, $brng) { |
||
0 ignored issues
–
show
|
|||
385 | $lat1 = _toRad($start [0]); |
||
386 | $lon1 = _toRad($start [1]); |
||
387 | // http://en.wikipedia.org/wiki/Earth_radius |
||
388 | // average earth radius in km |
||
389 | $dist = $dist / 6371.01; |
||
390 | $brng = _toRad($brng); |
||
391 | |||
392 | $lon2 = $lon1 + atan2(sin($brng) * sin($dist) * cos($lat1), cos($dist) - sin($lat1) * sin($lat2)); |
||
0 ignored issues
–
show
|
|||
393 | $lon2 = fmod(($lon2 + 3 * pi()), (2 * pi())) - pi(); |
||
394 | |||
395 | return array( |
||
396 | _toDeg($lat2), |
||
397 | _toDeg($lon2) |
||
398 | ); |
||
399 | } |
||
400 | private function _toRad($deg) { |
||
0 ignored issues
–
show
|
|||
401 | return $deg * pi() / 180; |
||
402 | } |
||
403 | private function _toDeg($rad) { |
||
0 ignored issues
–
show
|
|||
404 | return $rad * 180 / pi(); |
||
405 | } |
||
406 | } |
||
407 |
This check looks for variable assignements that are either overwritten by other assignments or where the variable is not used subsequently.
Both the
$myVar
assignment in line 1 and the$higher
assignment in line 2 are dead. The first because$myVar
is never used and the second because$higher
is always overwritten for every possible time line.