include/bb2diaspora.php

   1 <?php
   2
   3 require_once("include/oembed.php");
   4 require_once("include/event.php");
   5 require_once("library/markdown.php");
   6 require_once("include/html2bbcode.php");
   7 require_once("include/bbcode.php");
   8 require_once("include/markdownify/markdownify.php");
   9
  10
  11 function get_bb_tag_pos($s, $name, $occurance = 1) {
  12
  13         if($occurance < 1)
  14                 $occurance = 1;
  15
  16         $start_open = -1;
  17         for($i = 1; $i <= $occurance; $i++) {
  18                 if( $start_open !== false)
  19                         $start_open = strpos($s, '[' . $name, $start_open + 1); // allow [name= type tags
  20         }
  21
  22         if( $start_open === false)
  23                 return false;
  24
  25         $start_equal = strpos($s, '=', $start_open);
  26         $start_close = strpos($s, ']', $start_open);
  27
  28         if( $start_close === false)
  29                 return false;
  30
  31         $start_close++;
  32
  33         $end_open = strpos($s, '[/' . $name . ']', $start_close);
  34
  35         if( $end_open === false)
  36                 return false;
  37
  38         $res = array( 'start' => array('open' => $start_open, 'close' => $start_close),
  39                       'end' => array('open' => $end_open, 'close' => $end_open + strlen('[/' . $name . ']')) );
  40         if( $start_equal !== false)
  41                 $res['start']['equal'] = $start_equal + 1;
  42
  43         return $res;
  44 }
  45
  46 function bb_tag_preg_replace($pattern, $replace, $name, $s) {
  47
  48         $string = $s;
  49
  50         $occurance = 1;
  51         $pos = get_bb_tag_pos($string, $name, $occurance);
  52         while($pos !== false && $occurance < 1000) {
  53
  54                 $start = substr($string, 0, $pos['start']['open']);
  55                 $subject = substr($string, $pos['start']['open'], $pos['end']['close'] - $pos['start']['open']);
  56                 $end = substr($string, $pos['end']['close']);
  57                 if($end === false)
  58                         $end = '';
  59
  60                 $subject = preg_replace($pattern, $replace, $subject);
  61                 $string = $start . $subject . $end;
  62
  63                 $occurance++;
  64                 $pos = get_bb_tag_pos($string, $name, $occurance);
  65         }
  66
  67         return $string;
  68 }
  69
  70 // we don't want to support a bbcode specific markdown interpreter
  71 // and the markdown library we have is pretty good, but provides HTML output.
  72 // So we'll use that to convert to HTML, then convert the HTML back to bbcode,
  73 // and then clean up a few Diaspora specific constructs.
  74
  75 function diaspora2bb($s) {
  76
  77         // for testing purposes: Collect raw markdown articles
  78         // $file = tempnam("/tmp/friendica/", "markdown");
  79         // file_put_contents($file, $s);
  80
  81         $s = html_entity_decode($s,ENT_COMPAT,'UTF-8');
  82
  83         // Too many new lines. So deactivated the following line
  84         // $s = str_replace("\r","\n",$s);
  85         // Simply remove cr.
  86         $s = str_replace("\r","",$s);
  87
  88         // <br/> is invalid. Replace it with the valid expression
  89         $s = str_replace("<br/>","<br />",$s);
  90
  91         $s = preg_replace('/\@\{(.+?)\; (.+?)\@(.+?)\}/','@[url=https://$3/u/$2]$1[/url]',$s);
  92
  93         // Escaping the hash tags - doesn't always seem to work
  94         // $s = preg_replace('/\#([^\s\#])/','\\#$1',$s);
  95         // This seems to work
  96         $s = preg_replace('/\#([^\s\#])/','&#35;$1',$s);
  97
  98         $s = Markdown($s);
  99
 100         $s = str_replace('&#35;','#',$s);
 101 // we seem to have double linebreaks
 102 //      $s = str_replace("\n",'<br />',$s);
 103
 104         $s = html2bbcode($s);
 105 //      $s = str_replace('&#42;','*',$s);
 106
 107         // protect the recycle symbol from turning into a tag, but without unescaping angles and naked ampersands
 108         $s = str_replace('&#x2672;',html_entity_decode('&#x2672;',ENT_QUOTES,'UTF-8'),$s);
 109
 110         // Convert everything that looks like a link to a link
 111         $s = preg_replace("/([^\]\=]|^)(https?\:\/\/)([a-zA-Z0-9\:\/\-\?\&\;\.\=\_\~\#\%\$\!\+\,]+)/ism", '$1[url=$2$3]$2$3[/url]',$s);
 112
 113         //$s = preg_replace("/([^\]\=]|^)(https?\:\/\/)(vimeo|youtu|www\.youtube|soundcloud)([a-zA-Z0-9\:\/\-\?\&\;\.\=\_\~\#\%\$\!\+\,]+)/ism", '$1[url=$2$3$4]$2$3$4[/url]',$s);
 114         $s = bb_tag_preg_replace("/\[url\=?(.*?)\]https?:\/\/www.youtube.com\/watch\?v\=(.*?)\[\/url\]/ism",'[youtube]$2[/youtube]','url',$s);
 115         $s = bb_tag_preg_replace("/\[url\=https?:\/\/www.youtube.com\/watch\?v\=(.*?)\].*?\[\/url\]/ism",'[youtube]$1[/youtube]','url',$s);
 116         $s = bb_tag_preg_replace("/\[url\=?(.*?)\]https?:\/     \/vimeo.com\/([0-9]+)(.*?)\[\/url\]/ism",'[vimeo]$2[/vimeo]','url',$s);
 117         $s = bb_tag_preg_replace("/\[url\=https?:\/\/vimeo.com\/([0-9]+)\](.*?)\[\/url\]/ism",'[vimeo]$1[/vimeo]','url',$s);
 118         // remove duplicate adjacent code tags
 119         $s = preg_replace("/(\[code\])+(.*?)(\[\/code\])+/ism","[code]$2[/code]", $s);
 120
 121         // Don't show link to full picture (until it is fixed)
 122         $s = scale_external_images($s, false);
 123
 124         return $s;
 125 }
 126
 127
 128 function stripdcode_br_cb($s) {
 129         return '[code]' . str_replace('<br />', "\n\t", $s[1]) . '[/code]';
 130 }
 131
 132
 133 //////////////////////
 134 // The following "diaspora_ul" and "diaspora_ol" are only appropriate for the
 135 // pre-Markdownify conversion. If Markdownify isn't used, use the non-Markdownify
 136 // versions below
 137 //////////////////////
 138 /*
 139 function diaspora_ul($s) {
 140         // Replace "[*]" followed by any number (including zero) of
 141         // spaces by "* " to match Diaspora's list format
 142         if( strpos($s[0], "[list]") === 0 )
 143                 return '<ul class="listbullet" style="list-style-type: circle;">' . preg_replace("/\[\*\]( *)/", "* ", $s[1]) . '</ul>';
 144         elseif( strpos($s[0], "[ul]") === 0 )
 145                 return '<ul class="listbullet" style="list-style-type: circle;">' . preg_replace("/\[\*\]( *)/", "* ", $s[1]) . '</ul>';
 146         else
 147                 return $s[0];
 148 }
 149
 150
 151 function diaspora_ol($s) {
 152         // A hack: Diaspora will create a properly-numbered ordered list even
 153         // if you use '1.' for each element of the list, like:
 154         //              1. First element
 155         //              1. Second element
 156         //              1. Third element
 157         if( strpos($s[0], "[list=1]") === 0 )
 158                 return '<ul class="listdecimal" style="list-style-type: decimal;">' . preg_replace("/\[\*\]( *)/", "1. ", $s[1]) . '</ul>';
 159         elseif( strpos($s[0], "[list=i]") === 0 )
 160                 return '<ul class="listlowerroman" style="list-style-type: lower-roman;">' . preg_replace("/\[\*\]( *)/", "1. ", $s[1]) . '</ul>';
 161         elseif( strpos($s[0], "[list=I]") === 0 )
 162                 return '<ul class="listupperroman" style="list-style-type: upper-roman;">' . preg_replace("/\[\*\]( *)/", "1. ", $s[1]) . '</ul>';
 163         elseif( strpos($s[0], "[list=a]") === 0 )
 164                 return '<ul class="listloweralpha" style="list-style-type: lower-alpha;">' . preg_replace("/\[\*\]( *)/", "1. ", $s[1]) . '</ul>';
 165         elseif( strpos($s[0], "[list=A]") === 0 )
 166                 return '<ul class="listupperalpha" style="list-style-type: upper-alpha;">' . preg_replace("/\[\*\]( *)/", "1. ", $s[1]) . '</ul>';
 167         elseif( strpos($s[0], "[ol]") === 0 )
 168                 return '<ul class="listdecimal" style="list-style-type: decimal;">' . preg_replace("/\[\*\]( *)/", "1. ", $s[1]) . '</ul>';
 169         else
 170                 return $s[0];
 171 }
 172 */
 173
 174 //////////////////////
 175 // Non-Markdownify versions of "diaspora_ol" and "diaspora_ul"
 176 //////////////////////
 177 function diaspora_ul($s) {
 178         // Replace "[\\*]" followed by any number (including zero) of
 179         // spaces by "* " to match Diaspora's list format
 180         return preg_replace("/\[\\\\\*\]( *)/", "* ", $s[1]);
 181 }
 182
 183 function diaspora_ol($s) {
 184         // A hack: Diaspora will create a properly-numbered ordered list even
 185         // if you use '1.' for each element of the list, like:
 186         // 1. First element
 187         // 1. Second element
 188         // 1. Third element
 189         return preg_replace("/\[\\\\\*\]( *)/", "1. ", $s[1]);
 190 }
 191
 192
 193 function bb2diaspora($Text,$preserve_nl = false, $fordiaspora = true) {
 194
 195         // Re-enabling the converter again.
 196         // The bbcode parser now handles youtube-links (and the other stuff) correctly.
 197         // Additionally the html code is now fixed so that lists are now working.
 198
 199         // Converting images with size parameters to simple images. Markdown doesn't know it.
 200         $Text = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/ism", '[img]$3[/img]', $Text);
 201
 202         // the following was added on 10-January-2012 due to an inability of Diaspora's
 203         // new javascript markdown processor to handle links with images as the link "text"
 204         // It is not optimal and may be removed if this ability is restored in the future
 205         if ($fordiaspora)
 206                 $Text = preg_replace("/\[url\=([^\[\]]*)\]\s*\[img\](.*?)\[\/img\]\s*\[\/url\]/ism",
 207                                         "[url]$1[/url]\n[img]$2[/img]", $Text);
 208
 209         // Convert it to HTML - don't try oembed
 210         $Text = bbcode($Text, $preserve_nl, false);
 211
 212         // Now convert HTML to Markdown
 213         $md = new Markdownify(false, false, false);
 214         $Text = $md->parseString($Text);
 215
 216         // If the text going into bbcode() has a plain URL in it, i.e.
 217         // with no [url] tags around it, it will come out of parseString()
 218         // looking like: <http://url.com>, which gets removed by strip_tags().
 219         // So take off the angle brackets of any such URL
 220         $Text = preg_replace("/<http(.*?)>/is", "http$1", $Text);
 221
 222         // Remove all unconverted tags
 223         $Text = strip_tags($Text);
 224
 225
 226 /* Old routine
 227
 228         $ev = bbtoevent($Text);
 229
 230         // Replace any html brackets with HTML Entities to prevent executing HTML or script
 231         // Don't use strip_tags here because it breaks [url] search by replacing & with amp
 232
 233         $Text = str_replace("<", "&lt;", $Text);
 234         $Text = str_replace(">", "&gt;", $Text);
 235
 236         // If we find any event code, turn it into an event.
 237         // After we're finished processing the bbcode we'll
 238         // replace all of the event code with a reformatted version.
 239
 240         if($preserve_nl)
 241                 $Text = str_replace(array("\n","\r"), array('',''),$Text);
 242         else
 243                 // Remove the "return" character, as Diaspora uses only the "newline"
 244                 // character, so having the "return" character can cause signature
 245                 // failures
 246                 $Text = str_replace("\r", "", $Text);
 247
 248
 249         // Set up the parameters for a URL search string
 250         $URLSearchString = "^\[\]";
 251         // Set up the parameters for a MAIL search string
 252         $MAILSearchString = $URLSearchString;
 253
 254         // Perform URL Search
 255
 256         // [img]pathtoimage[/img]
 257
 258         // the following was added on 10-January-2012 due to an inability of Diaspora's
 259         // new javascript markdown processor to handle links with images as the link "text"
 260         // It is not optimal and may be removed if this ability is restored in the future
 261
 262         $Text = preg_replace("/\[url\=([$URLSearchString]*)\]\[img\](.*?)\[\/img\]\[\/url\]/ism",
 263                 '![' . t('image/photo') . '](' . '$2' . ')' . "\n" . '[' . t('link') . '](' . '$1' . ')', $Text);
 264
 265         $Text = preg_replace("/\[bookmark\]([$URLSearchString]*)\[\/bookmark\]/ism", '[$1]($1)', $Text);
 266         $Text = preg_replace("/\[bookmark\=([$URLSearchString]*)\](.*?)\[\/bookmark\]/ism", '[$2]($1)', $Text);
 267
 268         $Text = preg_replace("/\[url\]([$URLSearchString]*)\[\/url\]/ism", '[$1]($1)', $Text);
 269         $Text = preg_replace("/\#\[url\=([$URLSearchString]*)\](.*?)\[\/url\]/ism", '[#$2]($1)', $Text);
 270         $Text = preg_replace("/\[url\=([$URLSearchString]*)\](.*?)\[\/url\]/ism", '[$2]($1)', $Text);
 271
 272
 273         $Text = preg_replace("/\[img\](.*?)\[\/img\]/", '![' . t('image/photo') . '](' . '$1' . ')', $Text);
 274         $Text = preg_replace("/\[img\=(.*?)\](.*?)\[\/img\]/", '![' . t('image/photo') . '](' . '$2' . ')', $Text);
 275
 276         // Perform MAIL Search
 277         $Text = preg_replace("(\[mail\]([$MAILSearchString]*)\[/mail\])", '[$1](mailto:$1)', $Text);
 278         $Text = preg_replace("/\[mail\=([$MAILSearchString]*)\](.*?)\[\/mail\]/", '[$2](mailto:$1)', $Text);
 279
 280         $Text = str_replace('*', '\\*', $Text);
 281         $Text = str_replace('_', '\\_', $Text);
 282
 283         $Text = str_replace('`','\\`', $Text);
 284
 285         // Check for bold text
 286         $Text = preg_replace("(\[b\](.*?)\[\/b\])is",'**$1**',$Text);
 287
 288         // Check for italics text
 289         $Text = preg_replace("(\[i\](.*?)\[\/i\])is",'_$1_',$Text);
 290
 291         // Check for underline text
 292         // Replace with italics since Diaspora doesn't have underline
 293         $Text = preg_replace("(\[u\](.*?)\[\/u\])is",'_$1_',$Text);
 294
 295         // Check for strike-through text
 296         $Text = preg_replace("(\[s\](.*?)\[\/s\])is",'**[strike]**$1**[/strike]**',$Text);
 297
 298         // Check for over-line text
 299 //      $Text = preg_replace("(\[o\](.*?)\[\/o\])is",'<span class="overline">$1</span>',$Text);
 300
 301         // Check for colored text
 302         // Remove color since Diaspora doesn't support it
 303         $Text = preg_replace("(\[color=(.*?)\](.*?)\[\/color\])is","$2",$Text);
 304
 305         // Check for sized text
 306         // Remove it since Diaspora doesn't support sizes very well
 307         $Text = preg_replace("(\[size=(.*?)\](.*?)\[\/size\])is","$2",$Text);
 308
 309         // Check for list text
 310         $endlessloop = 0;
 311         while ((((strpos($Text, "[/list]") !== false) && (strpos($Text, "[list") !== false)) ||
 312                ((strpos($Text, "[/ol]") !== false) && (strpos($Text, "[ol]") !== false)) ||
 313                ((strpos($Text, "[/ul]") !== false) && (strpos($Text, "[ul]") !== false)) ||
 314                ((strpos($Text, "[/li]") !== false) && (strpos($Text, "[li]") !== false))) && (++$endlessloop < 20)) {
 315                 $Text = preg_replace_callback("/\[list\](.*?)\[\/list\]/is", 'diaspora_ul', $Text);
 316                 $Text = preg_replace_callback("/\[list=1\](.*?)\[\/list\]/is", 'diaspora_ol', $Text);
 317                 $Text = preg_replace_callback("/\[list=i\](.*?)\[\/list\]/s",'diaspora_ol', $Text);
 318                 $Text = preg_replace_callback("/\[list=I\](.*?)\[\/list\]/s", 'diaspora_ol', $Text);
 319                 $Text = preg_replace_callback("/\[list=a\](.*?)\[\/list\]/s", 'diaspora_ol', $Text);
 320                 $Text = preg_replace_callback("/\[list=A\](.*?)\[\/list\]/s", 'diaspora_ol', $Text);
 321                 $Text = preg_replace_callback("/\[ul\](.*?)\[\/ul\]/is", 'diaspora_ul', $Text);
 322                 $Text = preg_replace_callback("/\[ol\](.*?)\[\/ol\]/is", 'diaspora_ol', $Text);
 323                 $Text = preg_replace("/\[li\]( *)(.*?)\[\/li\]/s", '* $2' ,$Text);
 324         }
 325
 326         // Just get rid of table tags since Diaspora doesn't support tables
 327         $Text = preg_replace("/\[th\](.*?)\[\/th\]/s", '$1' ,$Text);
 328         $Text = preg_replace("/\[td\](.*?)\[\/td\]/s", '$1' ,$Text);
 329         $Text = preg_replace("/\[tr\](.*?)\[\/tr\]/s", '$1' ,$Text);
 330         $Text = preg_replace("/\[table\](.*?)\[\/table\]/s", '$1' ,$Text);
 331
 332         $Text = preg_replace("/\[table border=(.*?)\](.*?)\[\/table\]/s", '$2' ,$Text);
 333 //      $Text = preg_replace("/\[table border=0\](.*?)\[\/table\]/s", '<table border="0" >$1</table>' ,$Text);
 334
 335
 336 //      $Text = str_replace("[*]", "<li>", $Text);
 337
 338         // Check for font change text
 339 //      $Text = preg_replace("(\[font=(.*?)\](.*?)\[\/font\])","<span style=\"font-family: $1;\">$2</span>",$Text);
 340
 341
 342         $Text = preg_replace_callback("/\[code\](.*?)\[\/code\]/is",'stripdcode_br_cb',$Text);
 343
 344         // Check for [code] text
 345         $Text = preg_replace("/(\[code\])+(.*?)(\[\/code\])+/is","\t$2\n", $Text);
 346
 347
 348
 349
 350         // Declare the format for [quote] layout
 351         //      $QuoteLayout = '<blockquote>$1</blockquote>';
 352         // Check for [quote] text
 353         $Text = preg_replace("/\[quote\](.*?)\[\/quote\]/is",">$1\n\n", $Text);
 354         $Text = preg_replace("/\[quote=(.*?)\](.*?)\[\/quote\]/is",">$2\n\n", $Text);
 355
 356         // Images
 357
 358         // html5 video and audio
 359
 360         $Text = preg_replace("/\[video\](.*?)\[\/video\]/", '$1', $Text);
 361
 362         $Text = preg_replace("/\[audio\](.*?)\[\/audio\]/", '$1', $Text);
 363
 364 //      $Text = preg_replace("/\[iframe\](.*?)\[\/iframe\]/", '<iframe src="$1" width="425" height="350"><a href="$1">$1</a></iframe>', $Text);
 365
 366         // [img=widthxheight]image source[/img]
 367 //      $Text = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/", '<img src="$3" style="height:{$2}px; width:{$1}px;" >', $Text);
 368
 369         $Text = preg_replace("/\[youtube\]https?:\/\/www.youtube.com\/watch\?v\=(.*?)\[\/youtube\]/ism",'http://www.youtube.com/watch?v=$1',$Text);
 370         $Text = preg_replace("/\[youtube\]https?:\/\/www.youtube.com\/embed\/(.*?)\[\/youtube\]/ism",'http://www.youtube.com/watch?v=$1',$Text);
 371         $Text = preg_replace("/\[youtube\]https?:\/\/youtu.be\/(.*?)\[\/youtube\]/ism",'http://www.youtube.com/watch?v=$1',$Text);
 372         $Text = preg_replace("/\[youtube\]([A-Za-z0-9\-_=]+)(.*?)\[\/youtube\]/ism", 'http://www.youtube.com/watch?v=$1', $Text);
 373
 374         $Text = preg_replace("/\[vimeo\]https?:\/\/player.vimeo.com\/video\/([0-9]+)(.*?)\[\/vimeo\]/ism",'http://vimeo.com/$1',$Text);
 375         $Text = preg_replace("/\[vimeo\]https?:\/\/vimeo.com\/([0-9]+)(.*?)\[\/vimeo\]/ism",'http://vimeo.com/$1',$Text);
 376         $Text = preg_replace("/\[vimeo\]([0-9]+)(.*?)\[\/vimeo\]/ism", 'http://vimeo.com/$1',$Text);
 377
 378
 379         $Text = str_replace('[nosmile]','',$Text);
 380
 381         // oembed tag
 382         //      $Text = oembed_bbcode2html($Text);
 383
 384         // If we found an event earlier, strip out all the event code and replace with a reformatted version.
 385
 386         if(x($ev,'start')) {
 387
 388                 $sub = format_event_diaspora($ev);
 389
 390                 $Text = preg_replace("/\[event\-summary\](.*?)\[\/event\-summary\]/is",'',$Text);
 391                 $Text = preg_replace("/\[event\-description\](.*?)\[\/event\-description\]/is",'',$Text);
 392                 $Text = preg_replace("/\[event\-start\](.*?)\[\/event\-start\]/is",$sub,$Text);
 393                 $Text = preg_replace("/\[event\-finish\](.*?)\[\/event\-finish\]/is",'',$Text);
 394                 $Text = preg_replace("/\[event\-location\](.*?)\[\/event\-location\]/is",'',$Text);
 395                 $Text = preg_replace("/\[event\-adjust\](.*?)\[\/event\-adjust\]/is",'',$Text);
 396         }
 397
 398         $Text = preg_replace("/\<(.*?)(src|href)=(.*?)\&amp\;(.*?)\>/ism",'<$1$2=$3&$4>',$Text);
 399
 400         $Text = preg_replace_callback('/\[(.*?)\]\((.*?)\)/ism','unescape_underscores_in_links',$Text);
 401
 402 */
 403
 404         // Remove any leading or trailing whitespace, as this will mess up
 405         // the Diaspora signature verification and cause the item to disappear
 406         $Text = trim($Text);
 407
 408         call_hooks('bb2diaspora',$Text);
 409
 410         return $Text;
 411 }
 412
 413 function unescape_underscores_in_links($m) {
 414         $y = str_replace('\\_','_', $m[2]);
 415         return('[' . $m[1] . '](' . $y . ')');
 416 }
 417
 418 function format_event_diaspora($ev) {
 419
 420         $a = get_app();
 421
 422         if(! ((is_array($ev)) && count($ev)))
 423                 return '';
 424
 425         $bd_format = t('l F d, Y \@ g:i A') ; // Friday January 18, 2011 @ 8 AM
 426
 427         $o = 'Friendica event notification:' . "\n";
 428
 429         $o .= '**' . (($ev['summary']) ? bb2diaspora($ev['summary']) : bb2diaspora($ev['desc'])) .  '**' . "\n";
 430
 431         $o .= t('Starts:') . ' ' . '['
 432                 . (($ev['adjust']) ? day_translate(datetime_convert('UTC', 'UTC',
 433                         $ev['start'] , $bd_format ))
 434                         :  day_translate(datetime_convert('UTC', 'UTC',
 435                         $ev['start'] , $bd_format)))
 436                 .  '](' . $a->get_baseurl() . '/localtime/?f=&time=' . urlencode(datetime_convert('UTC','UTC',$ev['start'])) . ")\n";
 437
 438         if(! $ev['nofinish'])
 439                 $o .= t('Finishes:') . ' ' . '['
 440                         . (($ev['adjust']) ? day_translate(datetime_convert('UTC', 'UTC',
 441                                 $ev['finish'] , $bd_format ))
 442                                 :  day_translate(datetime_convert('UTC', 'UTC',
 443                                 $ev['finish'] , $bd_format )))
 444                         . '](' . $a->get_baseurl() . '/localtime/?f=&time=' . urlencode(datetime_convert('UTC','UTC',$ev['finish'])) . ")\n";
 445
 446         if(strlen($ev['location']))
 447                 $o .= t('Location:') . bb2diaspora($ev['location'])
 448                         . "\n";
 449
 450         $o .= "\n";
 451         return $o;
 452 }