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) {
 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         $Text = preg_replace("/\[url\=([^\[\]]*)\]\s*\[img\](.*?)\[\/img\]\s*\[\/url\]/ism",
 206                                 "[img]$2[/img]\n[url]$1[/url]", $Text);
 207
 208         // Convert it to HTML - don't try oembed
 209         $Text = bbcode($Text, $preserve_nl, false);
 210
 211         // Now convert HTML to Markdown
 212         $md = new Markdownify(false, false, false);
 213         $Text = $md->parseString($Text);
 214
 215         // If the text going into bbcode() has a plain URL in it, i.e.
 216         // with no [url] tags around it, it will come out of parseString()
 217         // looking like: <http://url.com>, which gets removed by strip_tags().
 218         // So take off the angle brackets of any such URL
 219         $Text = preg_replace("/<http(.*?)>/is", "http$1", $Text);
 220
 221         // Remove all unconverted tags
 222         $Text = strip_tags($Text);
 223
 224
 225 /* Old routine
 226
 227         $ev = bbtoevent($Text);
 228
 229         // Replace any html brackets with HTML Entities to prevent executing HTML or script
 230         // Don't use strip_tags here because it breaks [url] search by replacing & with amp
 231
 232         $Text = str_replace("<", "&lt;", $Text);
 233         $Text = str_replace(">", "&gt;", $Text);
 234
 235         // If we find any event code, turn it into an event.
 236         // After we're finished processing the bbcode we'll
 237         // replace all of the event code with a reformatted version.
 238
 239         if($preserve_nl)
 240                 $Text = str_replace(array("\n","\r"), array('',''),$Text);
 241         else
 242                 // Remove the "return" character, as Diaspora uses only the "newline"
 243                 // character, so having the "return" character can cause signature
 244                 // failures
 245                 $Text = str_replace("\r", "", $Text);
 246
 247
 248         // Set up the parameters for a URL search string
 249         $URLSearchString = "^\[\]";
 250         // Set up the parameters for a MAIL search string
 251         $MAILSearchString = $URLSearchString;
 252
 253         // Perform URL Search
 254
 255         // [img]pathtoimage[/img]
 256
 257         // the following was added on 10-January-2012 due to an inability of Diaspora's
 258         // new javascript markdown processor to handle links with images as the link "text"
 259         // It is not optimal and may be removed if this ability is restored in the future
 260
 261         $Text = preg_replace("/\[url\=([$URLSearchString]*)\]\[img\](.*?)\[\/img\]\[\/url\]/ism",
 262                 '![' . t('image/photo') . '](' . '$2' . ')' . "\n" . '[' . t('link') . '](' . '$1' . ')', $Text);
 263
 264         $Text = preg_replace("/\[bookmark\]([$URLSearchString]*)\[\/bookmark\]/ism", '[$1]($1)', $Text);
 265         $Text = preg_replace("/\[bookmark\=([$URLSearchString]*)\](.*?)\[\/bookmark\]/ism", '[$2]($1)', $Text);
 266
 267         $Text = preg_replace("/\[url\]([$URLSearchString]*)\[\/url\]/ism", '[$1]($1)', $Text);
 268         $Text = preg_replace("/\#\[url\=([$URLSearchString]*)\](.*?)\[\/url\]/ism", '[#$2]($1)', $Text);
 269         $Text = preg_replace("/\[url\=([$URLSearchString]*)\](.*?)\[\/url\]/ism", '[$2]($1)', $Text);
 270
 271
 272         $Text = preg_replace("/\[img\](.*?)\[\/img\]/", '![' . t('image/photo') . '](' . '$1' . ')', $Text);
 273         $Text = preg_replace("/\[img\=(.*?)\](.*?)\[\/img\]/", '![' . t('image/photo') . '](' . '$2' . ')', $Text);
 274
 275         // Perform MAIL Search
 276         $Text = preg_replace("(\[mail\]([$MAILSearchString]*)\[/mail\])", '[$1](mailto:$1)', $Text);
 277         $Text = preg_replace("/\[mail\=([$MAILSearchString]*)\](.*?)\[\/mail\]/", '[$2](mailto:$1)', $Text);
 278
 279         $Text = str_replace('*', '\\*', $Text);
 280         $Text = str_replace('_', '\\_', $Text);
 281
 282         $Text = str_replace('`','\\`', $Text);
 283
 284         // Check for bold text
 285         $Text = preg_replace("(\[b\](.*?)\[\/b\])is",'**$1**',$Text);
 286
 287         // Check for italics text
 288         $Text = preg_replace("(\[i\](.*?)\[\/i\])is",'_$1_',$Text);
 289
 290         // Check for underline text
 291         // Replace with italics since Diaspora doesn't have underline
 292         $Text = preg_replace("(\[u\](.*?)\[\/u\])is",'_$1_',$Text);
 293
 294         // Check for strike-through text
 295         $Text = preg_replace("(\[s\](.*?)\[\/s\])is",'**[strike]**$1**[/strike]**',$Text);
 296
 297         // Check for over-line text
 298 //      $Text = preg_replace("(\[o\](.*?)\[\/o\])is",'<span class="overline">$1</span>',$Text);
 299
 300         // Check for colored text
 301         // Remove color since Diaspora doesn't support it
 302         $Text = preg_replace("(\[color=(.*?)\](.*?)\[\/color\])is","$2",$Text);
 303
 304         // Check for sized text
 305         // Remove it since Diaspora doesn't support sizes very well
 306         $Text = preg_replace("(\[size=(.*?)\](.*?)\[\/size\])is","$2",$Text);
 307
 308         // Check for list text
 309         $endlessloop = 0;
 310         while ((((strpos($Text, "[/list]") !== false) && (strpos($Text, "[list") !== false)) ||
 311                ((strpos($Text, "[/ol]") !== false) && (strpos($Text, "[ol]") !== false)) ||
 312                ((strpos($Text, "[/ul]") !== false) && (strpos($Text, "[ul]") !== false)) ||
 313                ((strpos($Text, "[/li]") !== false) && (strpos($Text, "[li]") !== false))) && (++$endlessloop < 20)) {
 314                 $Text = preg_replace_callback("/\[list\](.*?)\[\/list\]/is", 'diaspora_ul', $Text);
 315                 $Text = preg_replace_callback("/\[list=1\](.*?)\[\/list\]/is", 'diaspora_ol', $Text);
 316                 $Text = preg_replace_callback("/\[list=i\](.*?)\[\/list\]/s",'diaspora_ol', $Text);
 317                 $Text = preg_replace_callback("/\[list=I\](.*?)\[\/list\]/s", 'diaspora_ol', $Text);
 318                 $Text = preg_replace_callback("/\[list=a\](.*?)\[\/list\]/s", 'diaspora_ol', $Text);
 319                 $Text = preg_replace_callback("/\[list=A\](.*?)\[\/list\]/s", 'diaspora_ol', $Text);
 320                 $Text = preg_replace_callback("/\[ul\](.*?)\[\/ul\]/is", 'diaspora_ul', $Text);
 321                 $Text = preg_replace_callback("/\[ol\](.*?)\[\/ol\]/is", 'diaspora_ol', $Text);
 322                 $Text = preg_replace("/\[li\]( *)(.*?)\[\/li\]/s", '* $2' ,$Text);
 323         }
 324
 325         // Just get rid of table tags since Diaspora doesn't support tables
 326         $Text = preg_replace("/\[th\](.*?)\[\/th\]/s", '$1' ,$Text);
 327         $Text = preg_replace("/\[td\](.*?)\[\/td\]/s", '$1' ,$Text);
 328         $Text = preg_replace("/\[tr\](.*?)\[\/tr\]/s", '$1' ,$Text);
 329         $Text = preg_replace("/\[table\](.*?)\[\/table\]/s", '$1' ,$Text);
 330
 331         $Text = preg_replace("/\[table border=(.*?)\](.*?)\[\/table\]/s", '$2' ,$Text);
 332 //      $Text = preg_replace("/\[table border=0\](.*?)\[\/table\]/s", '<table border="0" >$1</table>' ,$Text);
 333
 334
 335 //      $Text = str_replace("[*]", "<li>", $Text);
 336
 337         // Check for font change text
 338 //      $Text = preg_replace("(\[font=(.*?)\](.*?)\[\/font\])","<span style=\"font-family: $1;\">$2</span>",$Text);
 339
 340
 341         $Text = preg_replace_callback("/\[code\](.*?)\[\/code\]/is",'stripdcode_br_cb',$Text);
 342
 343         // Check for [code] text
 344         $Text = preg_replace("/(\[code\])+(.*?)(\[\/code\])+/is","\t$2\n", $Text);
 345
 346
 347
 348
 349         // Declare the format for [quote] layout
 350         //      $QuoteLayout = '<blockquote>$1</blockquote>';
 351         // Check for [quote] text
 352         $Text = preg_replace("/\[quote\](.*?)\[\/quote\]/is",">$1\n\n", $Text);
 353         $Text = preg_replace("/\[quote=(.*?)\](.*?)\[\/quote\]/is",">$2\n\n", $Text);
 354
 355         // Images
 356
 357         // html5 video and audio
 358
 359         $Text = preg_replace("/\[video\](.*?)\[\/video\]/", '$1', $Text);
 360
 361         $Text = preg_replace("/\[audio\](.*?)\[\/audio\]/", '$1', $Text);
 362
 363 //      $Text = preg_replace("/\[iframe\](.*?)\[\/iframe\]/", '<iframe src="$1" width="425" height="350"><a href="$1">$1</a></iframe>', $Text);
 364
 365         // [img=widthxheight]image source[/img]
 366 //      $Text = preg_replace("/\[img\=([0-9]*)x([0-9]*)\](.*?)\[\/img\]/", '<img src="$3" style="height:{$2}px; width:{$1}px;" >', $Text);
 367
 368         $Text = preg_replace("/\[youtube\]https?:\/\/www.youtube.com\/watch\?v\=(.*?)\[\/youtube\]/ism",'http://www.youtube.com/watch?v=$1',$Text);
 369         $Text = preg_replace("/\[youtube\]https?:\/\/www.youtube.com\/embed\/(.*?)\[\/youtube\]/ism",'http://www.youtube.com/watch?v=$1',$Text);
 370         $Text = preg_replace("/\[youtube\]https?:\/\/youtu.be\/(.*?)\[\/youtube\]/ism",'http://www.youtube.com/watch?v=$1',$Text);
 371         $Text = preg_replace("/\[youtube\]([A-Za-z0-9\-_=]+)(.*?)\[\/youtube\]/ism", 'http://www.youtube.com/watch?v=$1', $Text);
 372
 373         $Text = preg_replace("/\[vimeo\]https?:\/\/player.vimeo.com\/video\/([0-9]+)(.*?)\[\/vimeo\]/ism",'http://vimeo.com/$1',$Text);
 374         $Text = preg_replace("/\[vimeo\]https?:\/\/vimeo.com\/([0-9]+)(.*?)\[\/vimeo\]/ism",'http://vimeo.com/$1',$Text);
 375         $Text = preg_replace("/\[vimeo\]([0-9]+)(.*?)\[\/vimeo\]/ism", 'http://vimeo.com/$1',$Text);
 376
 377
 378         $Text = str_replace('[nosmile]','',$Text);
 379
 380         // oembed tag
 381         //      $Text = oembed_bbcode2html($Text);
 382
 383         // If we found an event earlier, strip out all the event code and replace with a reformatted version.
 384
 385         if(x($ev,'start')) {
 386
 387                 $sub = format_event_diaspora($ev);
 388
 389                 $Text = preg_replace("/\[event\-summary\](.*?)\[\/event\-summary\]/is",'',$Text);
 390                 $Text = preg_replace("/\[event\-description\](.*?)\[\/event\-description\]/is",'',$Text);
 391                 $Text = preg_replace("/\[event\-start\](.*?)\[\/event\-start\]/is",$sub,$Text);
 392                 $Text = preg_replace("/\[event\-finish\](.*?)\[\/event\-finish\]/is",'',$Text);
 393                 $Text = preg_replace("/\[event\-location\](.*?)\[\/event\-location\]/is",'',$Text);
 394                 $Text = preg_replace("/\[event\-adjust\](.*?)\[\/event\-adjust\]/is",'',$Text);
 395         }
 396
 397         $Text = preg_replace("/\<(.*?)(src|href)=(.*?)\&amp\;(.*?)\>/ism",'<$1$2=$3&$4>',$Text);
 398
 399         $Text = preg_replace_callback('/\[(.*?)\]\((.*?)\)/ism','unescape_underscores_in_links',$Text);
 400
 401 */
 402
 403         // Remove any leading or trailing whitespace, as this will mess up
 404         // the Diaspora signature verification and cause the item to disappear
 405         $Text = trim($Text);
 406
 407         call_hooks('bb2diaspora',$Text);
 408
 409         return $Text;
 410 }
 411
 412 function unescape_underscores_in_links($m) {
 413         $y = str_replace('\\_','_', $m[2]);
 414         return('[' . $m[1] . '](' . $y . ')');
 415 }
 416
 417 function format_event_diaspora($ev) {
 418
 419         $a = get_app();
 420
 421         if(! ((is_array($ev)) && count($ev)))
 422                 return '';
 423
 424         $bd_format = t('l F d, Y \@ g:i A') ; // Friday January 18, 2011 @ 8 AM
 425
 426         $o = 'Friendica event notification:' . "\n";
 427
 428         $o .= '**' . (($ev['summary']) ? bb2diaspora($ev['summary']) : bb2diaspora($ev['desc'])) .  '**' . "\n";
 429
 430         $o .= t('Starts:') . ' ' . '['
 431                 . (($ev['adjust']) ? day_translate(datetime_convert('UTC', 'UTC',
 432                         $ev['start'] , $bd_format ))
 433                         :  day_translate(datetime_convert('UTC', 'UTC',
 434                         $ev['start'] , $bd_format)))
 435                 .  '](' . $a->get_baseurl() . '/localtime/?f=&time=' . urlencode(datetime_convert('UTC','UTC',$ev['start'])) . ")\n";
 436
 437         if(! $ev['nofinish'])
 438                 $o .= t('Finishes:') . ' ' . '['
 439                         . (($ev['adjust']) ? day_translate(datetime_convert('UTC', 'UTC',
 440                                 $ev['finish'] , $bd_format ))
 441                                 :  day_translate(datetime_convert('UTC', 'UTC',
 442                                 $ev['finish'] , $bd_format )))
 443                         . '](' . $a->get_baseurl() . '/localtime/?f=&time=' . urlencode(datetime_convert('UTC','UTC',$ev['finish'])) . ")\n";
 444
 445         if(strlen($ev['location']))
 446                 $o .= t('Location:') . bb2diaspora($ev['location'])
 447                         . "\n";
 448
 449         $o .= "\n";
 450         return $o;
 451 }