splitbrain /
dokuwiki
| Conditions | 48 |
| Paths | 2 |
| Total Lines | 266 |
| Lines | 0 |
| Ratio | 0 % |
| Changes | 0 | ||
Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.
For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.
Commonly applied refactorings include:
If many parameters/temporary variables are present:
| 1 | <?php |
||
| 198 | function rss_buildItems(&$rss, &$data, $opt) { |
||
| 199 | global $conf; |
||
| 200 | global $lang; |
||
| 201 | /* @var AuthPlugin $auth */ |
||
| 202 | global $auth; |
||
| 203 | |||
| 204 | $eventData = array( |
||
| 205 | 'rss' => &$rss, |
||
| 206 | 'data' => &$data, |
||
| 207 | 'opt' => &$opt, |
||
| 208 | ); |
||
| 209 | $event = new Event('FEED_DATA_PROCESS', $eventData); |
||
| 210 | if($event->advise_before(false)) { |
||
| 211 | foreach($data as $ditem) { |
||
| 212 | if(!is_array($ditem)) { |
||
| 213 | // not an array? then only a list of IDs was given |
||
| 214 | $ditem = array('id' => $ditem); |
||
| 215 | } |
||
| 216 | |||
| 217 | $item = new FeedItem(); |
||
| 218 | $id = $ditem['id']; |
||
| 219 | if(!$ditem['media']) { |
||
| 220 | $meta = p_get_metadata($id); |
||
| 221 | } else { |
||
| 222 | $meta = array(); |
||
| 223 | } |
||
| 224 | |||
| 225 | // add date |
||
| 226 | if($ditem['date']) { |
||
| 227 | $date = $ditem['date']; |
||
| 228 | } elseif ($ditem['media']) { |
||
| 229 | $date = @filemtime(mediaFN($id)); |
||
| 230 | } elseif (file_exists(wikiFN($id))) { |
||
| 231 | $date = @filemtime(wikiFN($id)); |
||
| 232 | } elseif($meta['date']['modified']) { |
||
| 233 | $date = $meta['date']['modified']; |
||
| 234 | } else { |
||
| 235 | $date = 0; |
||
| 236 | } |
||
| 237 | if($date) $item->date = date('r', $date); |
||
| 238 | |||
| 239 | // add title |
||
| 240 | if($conf['useheading'] && $meta['title']) { |
||
| 241 | $item->title = $meta['title']; |
||
| 242 | } else { |
||
| 243 | $item->title = $ditem['id']; |
||
| 244 | } |
||
| 245 | if($conf['rss_show_summary'] && !empty($ditem['sum'])) { |
||
| 246 | $item->title .= ' - '.strip_tags($ditem['sum']); |
||
| 247 | } |
||
| 248 | |||
| 249 | // add item link |
||
| 250 | switch($opt['link_to']) { |
||
| 251 | case 'page': |
||
| 252 | if($ditem['media']) { |
||
| 253 | $item->link = media_managerURL( |
||
| 254 | array( |
||
| 255 | 'image' => $id, |
||
| 256 | 'ns' => getNS($id), |
||
| 257 | 'rev' => $date |
||
| 258 | ), '&', true |
||
| 259 | ); |
||
| 260 | } else { |
||
| 261 | $item->link = wl($id, 'rev='.$date, true, '&'); |
||
| 262 | } |
||
| 263 | break; |
||
| 264 | case 'rev': |
||
| 265 | if($ditem['media']) { |
||
| 266 | $item->link = media_managerURL( |
||
| 267 | array( |
||
| 268 | 'image' => $id, |
||
| 269 | 'ns' => getNS($id), |
||
| 270 | 'rev' => $date, |
||
| 271 | 'tab_details' => 'history' |
||
| 272 | ), '&', true |
||
| 273 | ); |
||
| 274 | } else { |
||
| 275 | $item->link = wl($id, 'do=revisions&rev='.$date, true, '&'); |
||
| 276 | } |
||
| 277 | break; |
||
| 278 | case 'current': |
||
| 279 | if($ditem['media']) { |
||
| 280 | $item->link = media_managerURL( |
||
| 281 | array( |
||
| 282 | 'image' => $id, |
||
| 283 | 'ns' => getNS($id) |
||
| 284 | ), '&', true |
||
| 285 | ); |
||
| 286 | } else { |
||
| 287 | $item->link = wl($id, '', true, '&'); |
||
| 288 | } |
||
| 289 | break; |
||
| 290 | case 'diff': |
||
| 291 | default: |
||
| 292 | if($ditem['media']) { |
||
| 293 | $item->link = media_managerURL( |
||
| 294 | array( |
||
| 295 | 'image' => $id, |
||
| 296 | 'ns' => getNS($id), |
||
| 297 | 'rev' => $date, |
||
| 298 | 'tab_details' => 'history', |
||
| 299 | 'mediado' => 'diff' |
||
| 300 | ), '&', true |
||
| 301 | ); |
||
| 302 | } else { |
||
| 303 | $item->link = wl($id, 'rev='.$date.'&do=diff', true, '&'); |
||
| 304 | } |
||
| 305 | } |
||
| 306 | |||
| 307 | // add item content |
||
| 308 | switch($opt['item_content']) { |
||
| 309 | case 'diff': |
||
| 310 | case 'htmldiff': |
||
| 311 | if($ditem['media']) { |
||
| 312 | $medialog = new MediaChangeLog($id); |
||
| 313 | $revs = $medialog->getRevisions(0, 1); |
||
| 314 | $rev = $revs[0]; |
||
| 315 | $src_r = ''; |
||
| 316 | $src_l = ''; |
||
| 317 | |||
| 318 | if($size = media_image_preview_size($id, '', new JpegMeta(mediaFN($id)), 300)) { |
||
| 319 | $more = 'w='.$size[0].'&h='.$size[1].'&t='.@filemtime(mediaFN($id)); |
||
| 320 | $src_r = ml($id, $more, true, '&', true); |
||
| 321 | } |
||
| 322 | if($rev && $size = media_image_preview_size($id, $rev, new JpegMeta(mediaFN($id, $rev)), 300)) { |
||
| 323 | $more = 'rev='.$rev.'&w='.$size[0].'&h='.$size[1]; |
||
| 324 | $src_l = ml($id, $more, true, '&', true); |
||
| 325 | } |
||
| 326 | $content = ''; |
||
| 327 | if($src_r) { |
||
| 328 | $content = '<table>'; |
||
| 329 | $content .= '<tr><th width="50%">'.$rev.'</th>'; |
||
| 330 | $content .= '<th width="50%">'.$lang['current'].'</th></tr>'; |
||
| 331 | $content .= '<tr align="center"><td><img src="'.$src_l.'" alt="" /></td><td>'; |
||
| 332 | $content .= '<img src="'.$src_r.'" alt="'.$id.'" /></td></tr>'; |
||
| 333 | $content .= '</table>'; |
||
| 334 | } |
||
| 335 | |||
| 336 | } else { |
||
| 337 | require_once(DOKU_INC.'inc/DifferenceEngine.php'); |
||
| 338 | $pagelog = new PageChangeLog($id); |
||
| 339 | $revs = $pagelog->getRevisions(0, 1); |
||
| 340 | $rev = $revs[0]; |
||
| 341 | |||
| 342 | if($rev) { |
||
| 343 | $df = new Diff(explode("\n", rawWiki($id, $rev)), |
||
| 344 | explode("\n", rawWiki($id, ''))); |
||
| 345 | } else { |
||
| 346 | $df = new Diff(array(''), |
||
| 347 | explode("\n", rawWiki($id, ''))); |
||
| 348 | } |
||
| 349 | |||
| 350 | if($opt['item_content'] == 'htmldiff') { |
||
| 351 | // note: no need to escape diff output, TableDiffFormatter provides 'safe' html |
||
| 352 | $tdf = new TableDiffFormatter(); |
||
| 353 | $content = '<table>'; |
||
| 354 | $content .= '<tr><th colspan="2" width="50%">'.$rev.'</th>'; |
||
| 355 | $content .= '<th colspan="2" width="50%">'.$lang['current'].'</th></tr>'; |
||
| 356 | $content .= $tdf->format($df); |
||
| 357 | $content .= '</table>'; |
||
| 358 | } else { |
||
| 359 | // note: diff output must be escaped, UnifiedDiffFormatter provides plain text |
||
| 360 | $udf = new UnifiedDiffFormatter(); |
||
| 361 | $content = "<pre>\n".hsc($udf->format($df))."\n</pre>"; |
||
| 362 | } |
||
| 363 | } |
||
| 364 | break; |
||
| 365 | case 'html': |
||
| 366 | if($ditem['media']) { |
||
| 367 | if($size = media_image_preview_size($id, '', new JpegMeta(mediaFN($id)))) { |
||
| 368 | $more = 'w='.$size[0].'&h='.$size[1].'&t='.@filemtime(mediaFN($id)); |
||
| 369 | $src = ml($id, $more, true, '&', true); |
||
| 370 | $content = '<img src="'.$src.'" alt="'.$id.'" />'; |
||
| 371 | } else { |
||
| 372 | $content = ''; |
||
| 373 | } |
||
| 374 | } else { |
||
| 375 | if (@filemtime(wikiFN($id)) === $date) { |
||
| 376 | $content = p_wiki_xhtml($id, '', false); |
||
| 377 | } else { |
||
| 378 | $content = p_wiki_xhtml($id, $date, false); |
||
| 379 | } |
||
| 380 | // no TOC in feeds |
||
| 381 | $content = preg_replace('/(<!-- TOC START -->).*(<!-- TOC END -->)/s', '', $content); |
||
| 382 | |||
| 383 | // add alignment for images |
||
| 384 | $content = preg_replace('/(<img .*?class="medialeft")/s', '\\1 align="left"', $content); |
||
| 385 | $content = preg_replace('/(<img .*?class="mediaright")/s', '\\1 align="right"', $content); |
||
| 386 | |||
| 387 | // make URLs work when canonical is not set, regexp instead of rerendering! |
||
| 388 | if(!$conf['canonical']) { |
||
| 389 | $base = preg_quote(DOKU_REL, '/'); |
||
| 390 | $content = preg_replace('/(<a href|<img src)="('.$base.')/s', '$1="'.DOKU_URL, $content); |
||
| 391 | } |
||
| 392 | } |
||
| 393 | |||
| 394 | break; |
||
| 395 | case 'abstract': |
||
| 396 | default: |
||
| 397 | if($ditem['media']) { |
||
| 398 | if($size = media_image_preview_size($id, '', new JpegMeta(mediaFN($id)))) { |
||
| 399 | $more = 'w='.$size[0].'&h='.$size[1].'&t='.@filemtime(mediaFN($id)); |
||
| 400 | $src = ml($id, $more, true, '&', true); |
||
| 401 | $content = '<img src="'.$src.'" alt="'.$id.'" />'; |
||
| 402 | } else { |
||
| 403 | $content = ''; |
||
| 404 | } |
||
| 405 | } else { |
||
| 406 | $content = $meta['description']['abstract']; |
||
| 407 | } |
||
| 408 | } |
||
| 409 | $item->description = $content; //FIXME a plugin hook here could be senseful |
||
| 410 | |||
| 411 | // add user |
||
| 412 | # FIXME should the user be pulled from metadata as well? |
||
| 413 | $user = @$ditem['user']; // the @ spares time repeating lookup |
||
| 414 | if(blank($user)) { |
||
| 415 | $item->author = 'Anonymous'; |
||
| 416 | $item->authorEmail = '[email protected]'; |
||
| 417 | } else { |
||
| 418 | $item->author = $user; |
||
| 419 | $item->authorEmail = $user . '@undisclosed.example.com'; |
||
| 420 | |||
| 421 | // get real user name if configured |
||
| 422 | if($conf['useacl'] && $auth) { |
||
| 423 | $userInfo = $auth->getUserData($user); |
||
| 424 | if($userInfo) { |
||
| 425 | switch($conf['showuseras']) { |
||
| 426 | case 'username': |
||
| 427 | case 'username_link': |
||
| 428 | $item->author = $userInfo['name']; |
||
| 429 | break; |
||
| 430 | default: |
||
| 431 | $item->author = $user; |
||
| 432 | break; |
||
| 433 | } |
||
| 434 | } else { |
||
| 435 | $item->author = $user; |
||
| 436 | } |
||
| 437 | } |
||
| 438 | } |
||
| 439 | |||
| 440 | // add category |
||
| 441 | if(isset($meta['subject'])) { |
||
| 442 | $item->category = $meta['subject']; |
||
| 443 | } else { |
||
| 444 | $cat = getNS($id); |
||
| 445 | if($cat) $item->category = $cat; |
||
| 446 | } |
||
| 447 | |||
| 448 | // finally add the item to the feed object, after handing it to registered plugins |
||
| 449 | $evdata = array( |
||
| 450 | 'item' => &$item, |
||
| 451 | 'opt' => &$opt, |
||
| 452 | 'ditem' => &$ditem, |
||
| 453 | 'rss' => &$rss |
||
| 454 | ); |
||
| 455 | $evt = new Event('FEED_ITEM_ADD', $evdata); |
||
| 456 | if($evt->advise_before()) { |
||
| 457 | $rss->addItem($item); |
||
| 458 | } |
||
| 459 | $evt->advise_after(); // for completeness |
||
| 460 | } |
||
| 461 | } |
||
| 462 | $event->advise_after(); |
||
| 463 | } |
||
| 464 | |||
| 522 |
Loading history...
Let’s assume that you have a directory layout like this:
. |-- OtherDir | |-- Bar.php | `-- Foo.php `-- SomeDir `-- Foo.phpand let’s assume the following content of
Bar.php:If both files
OtherDir/Foo.phpandSomeDir/Foo.phpare loaded in the same runtime, you will see a PHP error such as the following:PHP Fatal error: Cannot use SomeDir\Foo as Foo because the name is already in use in OtherDir/Foo.phpHowever, as
OtherDir/Foo.phpdoes not necessarily have to be loaded and the error is only triggered if it is loaded beforeOtherDir/Bar.php, this problem might go unnoticed for a while. In order to prevent this error from surfacing, you must import the namespace with a different alias: