xref: /dokuwiki/inc/html.php (revision 9d2e1be699d573eebda922cf67f030d3d2aa462d) 
1<?php
2/**
3 * HTML output functions
4 *
5 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
6 * @author     Andreas Gohr <andi@splitbrain.org>
7 */
8
9if(!defined('DOKU_INC')) die('meh.');
10if(!defined('NL')) define('NL',"\n");
11
12/**
13 * Convenience function to quickly build a wikilink
14 *
15 * @author Andreas Gohr <andi@splitbrain.org>
16 * @param string  $id      id of the target page
17 * @param string  $name    the name of the link, i.e. the text that is displayed
18 * @param string|array  $search  search string(s) that shall be highlighted in the target page
19 * @return string the HTML code of the link
20 */
21function html_wikilink($id,$name=null,$search=''){
22    static $xhtml_renderer = null;
23    if(is_null($xhtml_renderer)){
24        $xhtml_renderer = p_get_renderer('xhtml');
25    }
26
27    return $xhtml_renderer->internallink($id,$name,$search,true,'navigation');
28}
29
30/**
31 * Helps building long attribute lists
32 *
33 * @deprecated Use buildAttributes instead
34 * @author Andreas Gohr <andi@splitbrain.org>
35 */
36function html_attbuild($attributes){
37    $ret = '';
38    foreach ( $attributes as $key => $value ) {
39        $ret .= $key.'="'.formText($value).'" ';
40    }
41    return trim($ret);
42}
43
44/**
45 * The loginform
46 *
47 * @author   Andreas Gohr <andi@splitbrain.org>
48 */
49function html_login(){
50    global $lang;
51    global $conf;
52    global $ID;
53    global $INPUT;
54
55    print p_locale_xhtml('login');
56    print '<div class="centeralign">'.NL;
57    $form = new Doku_Form(array('id' => 'dw__login'));
58    $form->startFieldset($lang['btn_login']);
59    $form->addHidden('id', $ID);
60    $form->addHidden('do', 'login');
61    $form->addElement(form_makeTextField('u', ((!$INPUT->bool('http_credentials')) ? $INPUT->str('u') : ''), $lang['user'], 'focus__this', 'block'));
62    $form->addElement(form_makePasswordField('p', $lang['pass'], '', 'block'));
63    if($conf['rememberme']) {
64        $form->addElement(form_makeCheckboxField('r', '1', $lang['remember'], 'remember__me', 'simple'));
65    }
66    $form->addElement(form_makeButton('submit', '', $lang['btn_login']));
67    $form->endFieldset();
68
69    if(actionOK('register')){
70        $form->addElement('<p>'.$lang['reghere'].': '.tpl_actionlink('register','','','',true).'</p>');
71    }
72
73    if (actionOK('resendpwd')) {
74        $form->addElement('<p>'.$lang['pwdforget'].': '.tpl_actionlink('resendpwd','','','',true).'</p>');
75    }
76
77    html_form('login', $form);
78    print '</div>'.NL;
79}
80
81/**
82 * inserts section edit buttons if wanted or removes the markers
83 *
84 * @author Andreas Gohr <andi@splitbrain.org>
85 */
86function html_secedit($text,$show=true){
87    global $INFO;
88
89    $regexp = '#<!-- EDIT(\d+) ([A-Z_]+) (?:"([^"]*)" )?\[(\d+-\d*)\] -->#';
90
91    if(!$INFO['writable'] || !$show || $INFO['rev']){
92        return preg_replace($regexp,'',$text);
93    }
94
95    return preg_replace_callback($regexp,
96                'html_secedit_button', $text);
97}
98
99/**
100 * prepares section edit button data for event triggering
101 * used as a callback in html_secedit
102 *
103 * @triggers HTML_SECEDIT_BUTTON
104 * @author Andreas Gohr <andi@splitbrain.org>
105 */
106function html_secedit_button($matches){
107    $data = array('secid'  => $matches[1],
108                  'target' => strtolower($matches[2]),
109                  'range'  => $matches[count($matches) - 1]);
110    if (count($matches) === 5) {
111        $data['name'] = $matches[3];
112    }
113
114    return trigger_event('HTML_SECEDIT_BUTTON', $data,
115                         'html_secedit_get_button');
116}
117
118/**
119 * prints a section editing button
120 * used as default action form HTML_SECEDIT_BUTTON
121 *
122 * @author Adrian Lang <lang@cosmocode.de>
123 */
124function html_secedit_get_button($data) {
125    global $ID;
126    global $INFO;
127
128    if (!isset($data['name']) || $data['name'] === '') return '';
129
130    $name = $data['name'];
131    unset($data['name']);
132
133    $secid = $data['secid'];
134    unset($data['secid']);
135
136    return "<div class='secedit editbutton_" . $data['target'] .
137                       " editbutton_" . $secid . "'>" .
138           html_btn('secedit', $ID, '',
139                    array_merge(array('do'  => 'edit',
140                                      'rev' => $INFO['lastmod'],
141                                      'summary' => '['.$name.'] '), $data),
142                    'post', $name) . '</div>';
143}
144
145/**
146 * Just the back to top button (in its own form)
147 *
148 * @author Andreas Gohr <andi@splitbrain.org>
149 */
150function html_topbtn(){
151    global $lang;
152
153    $ret  = '<a class="nolink" href="#dokuwiki__top"><input type="button" class="button" value="'.$lang['btn_top'].'" onclick="window.scrollTo(0, 0)" title="'.$lang['btn_top'].'" /></a>';
154
155    return $ret;
156}
157
158/**
159 * Displays a button (using its own form)
160 * If tooltip exists, the access key tooltip is replaced.
161 *
162 * @author Andreas Gohr <andi@splitbrain.org>
163 */
164function html_btn($name,$id,$akey,$params,$method='get',$tooltip='',$label=false){
165    global $conf;
166    global $lang;
167
168    if (!$label)
169        $label = $lang['btn_'.$name];
170
171    $ret = '';
172
173    //filter id (without urlencoding)
174    $id = idfilter($id,false);
175
176    //make nice URLs even for buttons
177    if($conf['userewrite'] == 2){
178        $script = DOKU_BASE.DOKU_SCRIPT.'/'.$id;
179    }elseif($conf['userewrite']){
180        $script = DOKU_BASE.$id;
181    }else{
182        $script = DOKU_BASE.DOKU_SCRIPT;
183        $params['id'] = $id;
184    }
185
186    $ret .= '<form class="button btn_'.$name.'" method="'.$method.'" action="'.$script.'"><div class="no">';
187
188    if(is_array($params)){
189        reset($params);
190        while (list($key, $val) = each($params)) {
191            $ret .= '<input type="hidden" name="'.$key.'" ';
192            $ret .= 'value="'.htmlspecialchars($val).'" />';
193        }
194    }
195
196    if ($tooltip!='') {
197        $tip = htmlspecialchars($tooltip);
198    }else{
199        $tip = htmlspecialchars($label);
200    }
201
202    $ret .= '<input type="submit" value="'.hsc($label).'" class="button" ';
203    if($akey){
204        $tip .= ' ['.strtoupper($akey).']';
205        $ret .= 'accesskey="'.$akey.'" ';
206    }
207    $ret .= 'title="'.$tip.'" ';
208    $ret .= '/>';
209    $ret .= '</div></form>';
210
211    return $ret;
212}
213
214/**
215 * show a wiki page
216 *
217 * @author Andreas Gohr <andi@splitbrain.org>
218 */
219function html_show($txt=null){
220    global $ID;
221    global $REV;
222    global $HIGH;
223    global $INFO;
224    //disable section editing for old revisions or in preview
225    if($txt || $REV){
226        $secedit = false;
227    }else{
228        $secedit = true;
229    }
230
231    if (!is_null($txt)){
232        //PreviewHeader
233        echo '<br id="scroll__here" />';
234        echo p_locale_xhtml('preview');
235        echo '<div class="preview"><div class="pad">';
236        $html = html_secedit(p_render('xhtml',p_get_instructions($txt),$info),$secedit);
237        if($INFO['prependTOC']) $html = tpl_toc(true).$html;
238        echo $html;
239        echo '<div class="clearer"></div>';
240        echo '</div></div>';
241
242    }else{
243        if ($REV) print p_locale_xhtml('showrev');
244        $html = p_wiki_xhtml($ID,$REV,true);
245        $html = html_secedit($html,$secedit);
246        if($INFO['prependTOC']) $html = tpl_toc(true).$html;
247        $html = html_hilight($html,$HIGH);
248        echo $html;
249    }
250}
251
252/**
253 * ask the user about how to handle an exisiting draft
254 *
255 * @author Andreas Gohr <andi@splitbrain.org>
256 */
257function html_draft(){
258    global $INFO;
259    global $ID;
260    global $lang;
261    $draft = unserialize(io_readFile($INFO['draft'],false));
262    $text  = cleanText(con($draft['prefix'],$draft['text'],$draft['suffix'],true));
263
264    print p_locale_xhtml('draft');
265    $form = new Doku_Form(array('id' => 'dw__editform'));
266    $form->addHidden('id', $ID);
267    $form->addHidden('date', $draft['date']);
268    $form->addElement(form_makeWikiText($text, array('readonly'=>'readonly')));
269    $form->addElement(form_makeOpenTag('div', array('id'=>'draft__status')));
270    $form->addElement($lang['draftdate'].' '. dformat(filemtime($INFO['draft'])));
271    $form->addElement(form_makeCloseTag('div'));
272    $form->addElement(form_makeButton('submit', 'recover', $lang['btn_recover'], array('tabindex'=>'1')));
273    $form->addElement(form_makeButton('submit', 'draftdel', $lang['btn_draftdel'], array('tabindex'=>'2')));
274    $form->addElement(form_makeButton('submit', 'show', $lang['btn_cancel'], array('tabindex'=>'3')));
275    html_form('draft', $form);
276}
277
278/**
279 * Highlights searchqueries in HTML code
280 *
281 * @author Andreas Gohr <andi@splitbrain.org>
282 * @author Harry Fuecks <hfuecks@gmail.com>
283 */
284function html_hilight($html,$phrases){
285    $phrases = (array) $phrases;
286    $phrases = array_map('preg_quote_cb', $phrases);
287    $phrases = array_map('ft_snippet_re_preprocess', $phrases);
288    $phrases = array_filter($phrases);
289    $regex = join('|',$phrases);
290
291    if ($regex === '') return $html;
292    if (!utf8_check($regex)) return $html;
293    $html = @preg_replace_callback("/((<[^>]*)|$regex)/ui",'html_hilight_callback',$html);
294    return $html;
295}
296
297/**
298 * Callback used by html_hilight()
299 *
300 * @author Harry Fuecks <hfuecks@gmail.com>
301 */
302function html_hilight_callback($m) {
303    $hlight = unslash($m[0]);
304    if ( !isset($m[2])) {
305        $hlight = '<span class="search_hit">'.$hlight.'</span>';
306    }
307    return $hlight;
308}
309
310/**
311 * Run a search and display the result
312 *
313 * @author Andreas Gohr <andi@splitbrain.org>
314 */
315function html_search(){
316    global $QUERY;
317    global $lang;
318
319    $intro = p_locale_xhtml('searchpage');
320    // allow use of placeholder in search intro
321    $intro = str_replace(
322                array('@QUERY@','@SEARCH@'),
323                array(hsc(rawurlencode($QUERY)),hsc($QUERY)),
324                $intro);
325    echo $intro;
326    flush();
327
328    //show progressbar
329    print '<div id="dw__loading">'.NL;
330    print '<script type="text/javascript">/*<![CDATA[*/'.NL;
331    print 'showLoadBar();'.NL;
332    print '/*!]]>*/</script>'.NL;
333    print '</div>'.NL;
334    flush();
335
336    //do quick pagesearch
337    $data = ft_pageLookup($QUERY,true,useHeading('navigation'));
338    if(count($data)){
339        print '<div class="search_quickresult">';
340        print '<h3>'.$lang['quickhits'].':</h3>';
341        print '<ul class="search_quickhits">';
342        foreach($data as $id => $title){
343            print '<li> ';
344            if (useHeading('navigation')) {
345                $name = $title;
346            }else{
347                $ns = getNS($id);
348                if($ns){
349                    $name = shorten(noNS($id), ' ('.$ns.')',30);
350                }else{
351                    $name = $id;
352                }
353            }
354            print html_wikilink(':'.$id,$name);
355            print '</li> ';
356        }
357        print '</ul> ';
358        //clear float (see http://www.complexspiral.com/publications/containing-floats/)
359        print '<div class="clearer"></div>';
360        print '</div>';
361    }
362    flush();
363
364    //do fulltext search
365    $data = ft_pageSearch($QUERY,$regex);
366    if(count($data)){
367        print '<dl class="search_results">';
368        $num = 1;
369        foreach($data as $id => $cnt){
370            print '<dt>';
371            print html_wikilink(':'.$id,useHeading('navigation')?null:$id,$regex);
372            if($cnt !== 0){
373                print ': '.$cnt.' '.$lang['hits'].'';
374            }
375            print '</dt>';
376            if($cnt !== 0){
377                if($num < FT_SNIPPET_NUMBER){ // create snippets for the first number of matches only
378                    print '<dd>'.ft_snippet($id,$regex).'</dd>';
379                }
380                $num++;
381            }
382            flush();
383        }
384        print '</dl>';
385    }else{
386        print '<div class="nothing">'.$lang['nothingfound'].'</div>';
387    }
388
389    //hide progressbar
390    print '<script type="text/javascript">/*<![CDATA[*/'.NL;
391    print 'hideLoadBar("dw__loading");'.NL;
392    print '/*!]]>*/</script>'.NL;
393    flush();
394}
395
396/**
397 * Display error on locked pages
398 *
399 * @author Andreas Gohr <andi@splitbrain.org>
400 */
401function html_locked(){
402    global $ID;
403    global $conf;
404    global $lang;
405    global $INFO;
406
407    $locktime = filemtime(wikiLockFN($ID));
408    $expire = dformat($locktime + $conf['locktime']);
409    $min    = round(($conf['locktime'] - (time() - $locktime) )/60);
410
411    print p_locale_xhtml('locked');
412    print '<ul>';
413    print '<li><div class="li"><strong>'.$lang['lockedby'].':</strong> '.editorinfo($INFO['locked']).'</div></li>';
414    print '<li><div class="li"><strong>'.$lang['lockexpire'].':</strong> '.$expire.' ('.$min.' min)</div></li>';
415    print '</ul>';
416}
417
418/**
419 * list old revisions
420 *
421 * @author Andreas Gohr <andi@splitbrain.org>
422 * @author Ben Coburn <btcoburn@silicodon.net>
423 * @author Kate Arzamastseva <pshns@ukr.net>
424 */
425function html_revisions($first=0, $media_id = false){
426    global $ID;
427    global $INFO;
428    global $conf;
429    global $lang;
430    $id = $ID;
431    /* we need to get one additionally log entry to be able to
432     * decide if this is the last page or is there another one.
433     * see html_recent()
434     */
435    if (!$media_id) $revisions = getRevisions($ID, $first, $conf['recent']+1);
436    else {
437        $revisions = getRevisions($media_id, $first, $conf['recent']+1, 8192, true);
438        $id = $media_id;
439    }
440
441    if(count($revisions)==0 && $first!=0){
442        $first=0;
443        if (!$media_id) $revisions = getRevisions($ID, $first, $conf['recent']+1);
444        else $revisions = getRevisions($media_id, $first, $conf['recent']+1, 8192, true);
445    }
446    $hasNext = false;
447    if (count($revisions)>$conf['recent']) {
448        $hasNext = true;
449        array_pop($revisions); // remove extra log entry
450    }
451
452    if (!$media_id) $date = dformat($INFO['lastmod']);
453    else $date = dformat(@filemtime(mediaFN($id)));
454
455    if (!$media_id) print p_locale_xhtml('revisions');
456
457    $params = array('id' => 'page__revisions', 'class' => 'changes');
458    if ($media_id) $params['action'] = media_managerURL(array('image' => $media_id), '&');
459
460    $form = new Doku_Form($params);
461    $form->addElement(form_makeOpenTag('ul'));
462
463    if (!$media_id) $exists = $INFO['exists'];
464    else $exists = @file_exists(mediaFN($id));
465
466    $display_name = (!$media_id && useHeading('navigation')) ? hsc(p_get_first_heading($id)) : $id;
467    if (!$display_name) $display_name = $id;
468
469    if($exists && $first==0){
470        if (!$media_id && isset($INFO['meta']) && isset($INFO['meta']['last_change']) && $INFO['meta']['last_change']['type']===DOKU_CHANGE_TYPE_MINOR_EDIT)
471            $form->addElement(form_makeOpenTag('li', array('class' => 'minor')));
472        else
473            $form->addElement(form_makeOpenTag('li'));
474        $form->addElement(form_makeOpenTag('div', array('class' => 'li')));
475        $form->addElement(form_makeTag('input', array(
476                        'type' => 'checkbox',
477                        'name' => 'rev2[]',
478                        'value' => 'current')));
479
480        $form->addElement(form_makeOpenTag('span', array('class' => 'date')));
481        $form->addElement($date);
482        $form->addElement(form_makeCloseTag('span'));
483
484        $form->addElement('<img src="'.DOKU_BASE.'lib/images/blank.gif" width="15" height="11" alt="" />');
485
486        if (!$media_id) $href = wl($id);
487        else $href = media_managerURL(array('image' => $id, 'tab_details' => 'view'), '&');
488        $form->addElement(form_makeOpenTag('a', array(
489                        'class' => 'wikilink1',
490                        'href'  => $href)));
491        $form->addElement($display_name);
492        $form->addElement(form_makeCloseTag('a'));
493
494        if ($media_id) $form->addElement(form_makeOpenTag('div'));
495
496        if (!$media_id) {
497            $form->addElement(form_makeOpenTag('span', array('class' => 'sum')));
498            $form->addElement(' – ');
499            $form->addElement(htmlspecialchars($INFO['sum']));
500            $form->addElement(form_makeCloseTag('span'));
501        }
502
503        $form->addElement(form_makeOpenTag('span', array('class' => 'user')));
504        if (!$media_id) $editor = $INFO['editor'];
505        else {
506            $revinfo = getRevisionInfo($id, @filemtime(fullpath(mediaFN($id))), 1024, true);
507            if($revinfo['user']){
508                $editor = $revinfo['user'];
509            }else{
510                $editor = $revinfo['ip'];
511            }
512        }
513        $form->addElement((empty($editor))?('('.$lang['external_edit'].')'):editorinfo($editor));
514        $form->addElement(form_makeCloseTag('span'));
515
516        $form->addElement('('.$lang['current'].')');
517
518        if ($media_id) $form->addElement(form_makeCloseTag('div'));
519
520        $form->addElement(form_makeCloseTag('div'));
521        $form->addElement(form_makeCloseTag('li'));
522    }
523
524    foreach($revisions as $rev){
525        $date = dformat($rev);
526        if (!$media_id) {
527            $info = getRevisionInfo($id,$rev,true);
528            $exists = page_exists($id,$rev);
529        }  else {
530            $info = getRevisionInfo($id,$rev,true,true);
531            $exists = @file_exists(mediaFN($id,$rev));
532        }
533
534        if ($info['type']===DOKU_CHANGE_TYPE_MINOR_EDIT)
535            $form->addElement(form_makeOpenTag('li', array('class' => 'minor')));
536        else
537            $form->addElement(form_makeOpenTag('li'));
538        $form->addElement(form_makeOpenTag('div', array('class' => 'li')));
539        if($exists){
540            $form->addElement(form_makeTag('input', array(
541                            'type' => 'checkbox',
542                            'name' => 'rev2[]',
543                            'value' => $rev)));
544        }else{
545            $form->addElement('<img src="'.DOKU_BASE.'lib/images/blank.gif" width="15" height="11" alt="" />');
546        }
547
548        $form->addElement(form_makeOpenTag('span', array('class' => 'date')));
549        $form->addElement($date);
550        $form->addElement(form_makeCloseTag('span'));
551
552        if($exists){
553            if (!$media_id) $href = wl($id,"rev=$rev,do=diff", false, '&');
554            else $href = media_managerURL(array('image' => $id, 'rev' => $rev, 'mediado' => 'diff'), '&');
555            $form->addElement(form_makeOpenTag('a', array('href' => $href, 'class' => 'diff_link')));
556            $form->addElement(form_makeTag('img', array(
557                            'src'    => DOKU_BASE.'lib/images/diff.png',
558                            'width'  => 15,
559                            'height' => 11,
560                            'title'  => $lang['diff'],
561                            'alt'    => $lang['diff'])));
562            $form->addElement(form_makeCloseTag('a'));
563            if (!$media_id) $href = wl($id,"rev=$rev",false,'&');
564            else $href = media_managerURL(array('image' => $id, 'tab_details' => 'view', 'rev' => $rev), '&');
565            $form->addElement(form_makeOpenTag('a', array('href' => $href, 'class' => 'wikilink1')));
566            $form->addElement($display_name);
567            $form->addElement(form_makeCloseTag('a'));
568        }else{
569            $form->addElement('<img src="'.DOKU_BASE.'lib/images/blank.gif" width="15" height="11" alt="" />');
570            $form->addElement($display_name);
571        }
572
573        if ($media_id) $form->addElement(form_makeOpenTag('div'));
574
575        if ($info['sum']) {
576            $form->addElement(form_makeOpenTag('span', array('class' => 'sum')));
577            if (!$media_id) $form->addElement(' – ');
578            $form->addElement(htmlspecialchars($info['sum']));
579            $form->addElement(form_makeCloseTag('span'));
580        }
581
582        $form->addElement(form_makeOpenTag('span', array('class' => 'user')));
583        if($info['user']){
584            $form->addElement(editorinfo($info['user']));
585            if(auth_ismanager()){
586                $form->addElement(' ('.$info['ip'].')');
587            }
588        }else{
589            $form->addElement($info['ip']);
590        }
591        $form->addElement(form_makeCloseTag('span'));
592
593        if ($media_id) $form->addElement(form_makeCloseTag('div'));
594
595        $form->addElement(form_makeCloseTag('div'));
596        $form->addElement(form_makeCloseTag('li'));
597    }
598    $form->addElement(form_makeCloseTag('ul'));
599    if (!$media_id) {
600        $form->addElement(form_makeButton('submit', 'diff', $lang['diff2']));
601    } else {
602        $form->addHidden('mediado', 'diff');
603        $form->addElement(form_makeButton('submit', '', $lang['diff2']));
604    }
605    html_form('revisions', $form);
606
607    print '<div class="pagenav">';
608    $last = $first + $conf['recent'];
609    if ($first > 0) {
610        $first -= $conf['recent'];
611        if ($first < 0) $first = 0;
612        print '<div class="pagenav-prev">';
613        if ($media_id) {
614            print html_btn('newer',$media_id,"p",media_managerURL(array('first' => $first), '&amp;', false, true));
615        } else {
616            print html_btn('newer',$id,"p",array('do' => 'revisions', 'first' => $first));
617        }
618        print '</div>';
619    }
620    if ($hasNext) {
621        print '<div class="pagenav-next">';
622        if ($media_id) {
623            print html_btn('older',$media_id,"n",media_managerURL(array('first' => $last), '&amp;', false, true));
624        } else {
625            print html_btn('older',$id,"n",array('do' => 'revisions', 'first' => $last));
626        }
627        print '</div>';
628    }
629    print '</div>';
630
631}
632
633/**
634 * display recent changes
635 *
636 * @author Andreas Gohr <andi@splitbrain.org>
637 * @author Matthias Grimm <matthiasgrimm@users.sourceforge.net>
638 * @author Ben Coburn <btcoburn@silicodon.net>
639 * @author Kate Arzamastseva <pshns@ukr.net>
640 */
641function html_recent($first=0, $show_changes='both'){
642    global $conf;
643    global $lang;
644    global $ID;
645    /* we need to get one additionally log entry to be able to
646     * decide if this is the last page or is there another one.
647     * This is the cheapest solution to get this information.
648     */
649    $flags = 0;
650    if ($show_changes == 'mediafiles' && $conf['mediarevisions']) {
651        $flags = RECENTS_MEDIA_CHANGES;
652    } elseif ($show_changes == 'pages') {
653        $flags = 0;
654    } elseif ($conf['mediarevisions']) {
655        $show_changes = 'both';
656        $flags = RECENTS_MEDIA_PAGES_MIXED;
657    }
658
659    $recents = getRecents($first,$conf['recent'] + 1,getNS($ID),$flags);
660    if(count($recents) == 0 && $first != 0){
661        $first=0;
662        $recents = getRecents($first,$conf['recent'] + 1,getNS($ID),$flags);
663    }
664    $hasNext = false;
665    if (count($recents)>$conf['recent']) {
666        $hasNext = true;
667        array_pop($recents); // remove extra log entry
668    }
669
670    print p_locale_xhtml('recent');
671
672    if (getNS($ID) != '')
673        print '<div class="level1"><p>' . sprintf($lang['recent_global'], getNS($ID), wl('', 'do=recent')) . '</p></div>';
674
675    $form = new Doku_Form(array('id' => 'dw__recent', 'method' => 'GET', 'class' => 'changes'));
676    $form->addHidden('sectok', null);
677    $form->addHidden('do', 'recent');
678    $form->addHidden('id', $ID);
679
680    if ($conf['mediarevisions']) {
681        $form->addElement('<div class="changeType">');
682        $form->addElement(form_makeListboxField(
683                    'show_changes',
684                    array(
685                        'pages'      => $lang['pages_changes'],
686                        'mediafiles' => $lang['media_changes'],
687                        'both'       => $lang['both_changes']),
688                    $show_changes,
689                    $lang['changes_type'],
690                    '','',
691                    array('class'=>'quickselect')));
692
693        $form->addElement(form_makeButton('submit', 'recent', $lang['btn_apply']));
694        $form->addElement('</div>');
695    }
696
697    $form->addElement(form_makeOpenTag('ul'));
698
699    foreach($recents as $recent){
700        $date = dformat($recent['date']);
701        if ($recent['type']===DOKU_CHANGE_TYPE_MINOR_EDIT)
702            $form->addElement(form_makeOpenTag('li', array('class' => 'minor')));
703        else
704            $form->addElement(form_makeOpenTag('li'));
705
706        $form->addElement(form_makeOpenTag('div', array('class' => 'li')));
707
708        if ($recent['media']) {
709            $form->addElement(media_printicon($recent['id']));
710        } else {
711            $icon = DOKU_BASE.'lib/images/fileicons/file.png';
712            $form->addElement('<img src="'.$icon.'" alt="'.$recent['id'].'" class="icon" />');
713        }
714
715        $form->addElement(form_makeOpenTag('span', array('class' => 'date')));
716        $form->addElement($date);
717        $form->addElement(form_makeCloseTag('span'));
718
719        $diff = false;
720        $href = '';
721
722        if ($recent['media']) {
723            $diff = (count(getRevisions($recent['id'], 0, 1, 8192, true)) && @file_exists(mediaFN($recent['id'])));
724            if ($diff) {
725                $href = media_managerURL(array('tab_details' => 'history',
726                    'mediado' => 'diff', 'image' => $recent['id'], 'ns' => getNS($recent['id'])), '&');
727            }
728        } else {
729            $href = wl($recent['id'],"do=diff", false, '&');
730        }
731
732        if ($recent['media'] && !$diff) {
733            $form->addElement('<img src="'.DOKU_BASE.'lib/images/blank.gif" width="15" height="11" alt="" />');
734        } else {
735            $form->addElement(form_makeOpenTag('a', array('class' => 'diff_link', 'href' => $href)));
736            $form->addElement(form_makeTag('img', array(
737                            'src'   => DOKU_BASE.'lib/images/diff.png',
738                            'width' => 15,
739                            'height'=> 11,
740                            'title' => $lang['diff'],
741                            'alt'   => $lang['diff']
742                            )));
743            $form->addElement(form_makeCloseTag('a'));
744        }
745
746        if ($recent['media']) {
747            $href = media_managerURL(array('tab_details' => 'history',
748                'image' => $recent['id'], 'ns' => getNS($recent['id'])), '&');
749        } else {
750            $href = wl($recent['id'],"do=revisions",false,'&');
751        }
752        $form->addElement(form_makeOpenTag('a', array('class' => 'revisions_link', 'href' => $href)));
753        $form->addElement(form_makeTag('img', array(
754                        'src'   => DOKU_BASE.'lib/images/history.png',
755                        'width' => 12,
756                        'height'=> 14,
757                        'title' => $lang['btn_revs'],
758                        'alt'   => $lang['btn_revs']
759                        )));
760        $form->addElement(form_makeCloseTag('a'));
761
762        if ($recent['media']) {
763            $href = media_managerURL(array('tab_details' => 'view', 'image' => $recent['id'], 'ns' => getNS($recent['id'])), '&');
764            $class = (file_exists(mediaFN($recent['id']))) ? 'wikilink1' : $class = 'wikilink2';
765            $form->addElement(form_makeOpenTag('a', array('class' => $class, 'href' => $href)));
766            $form->addElement($recent['id']);
767            $form->addElement(form_makeCloseTag('a'));
768        } else {
769            $form->addElement(html_wikilink(':'.$recent['id'],useHeading('navigation')?null:$recent['id']));
770        }
771        $form->addElement(form_makeOpenTag('span', array('class' => 'sum')));
772        $form->addElement(' – '.htmlspecialchars($recent['sum']));
773        $form->addElement(form_makeCloseTag('span'));
774
775        $form->addElement(form_makeOpenTag('span', array('class' => 'user')));
776        if($recent['user']){
777            $form->addElement(editorinfo($recent['user']));
778            if(auth_ismanager()){
779                $form->addElement(' ('.$recent['ip'].')');
780            }
781        }else{
782            $form->addElement($recent['ip']);
783        }
784        $form->addElement(form_makeCloseTag('span'));
785
786        $form->addElement(form_makeCloseTag('div'));
787        $form->addElement(form_makeCloseTag('li'));
788    }
789    $form->addElement(form_makeCloseTag('ul'));
790
791    $form->addElement(form_makeOpenTag('div', array('class' => 'pagenav')));
792    $last = $first + $conf['recent'];
793    if ($first > 0) {
794        $first -= $conf['recent'];
795        if ($first < 0) $first = 0;
796        $form->addElement(form_makeOpenTag('div', array('class' => 'pagenav-prev')));
797        $form->addElement(form_makeTag('input', array(
798                    'type'  => 'submit',
799                    'name'  => 'first['.$first.']',
800                    'value' => $lang['btn_newer'],
801                    'accesskey' => 'n',
802                    'title' => $lang['btn_newer'].' [N]',
803                    'class' => 'button show'
804                    )));
805        $form->addElement(form_makeCloseTag('div'));
806    }
807    if ($hasNext) {
808        $form->addElement(form_makeOpenTag('div', array('class' => 'pagenav-next')));
809        $form->addElement(form_makeTag('input', array(
810                        'type'  => 'submit',
811                        'name'  => 'first['.$last.']',
812                        'value' => $lang['btn_older'],
813                        'accesskey' => 'p',
814                        'title' => $lang['btn_older'].' [P]',
815                        'class' => 'button show'
816                        )));
817        $form->addElement(form_makeCloseTag('div'));
818    }
819    $form->addElement(form_makeCloseTag('div'));
820    html_form('recent', $form);
821}
822
823/**
824 * Display page index
825 *
826 * @author Andreas Gohr <andi@splitbrain.org>
827 */
828function html_index($ns){
829    global $conf;
830    global $ID;
831    $ns  = cleanID($ns);
832    #fixme use appropriate function
833    if(empty($ns)){
834        $ns = dirname(str_replace(':','/',$ID));
835        if($ns == '.') $ns ='';
836    }
837    $ns  = utf8_encodeFN(str_replace(':','/',$ns));
838
839    echo p_locale_xhtml('index');
840    echo '<div id="index__tree">';
841
842    $data = array();
843    search($data,$conf['datadir'],'search_index',array('ns' => $ns));
844    echo html_buildlist($data,'idx','html_list_index','html_li_index');
845
846    echo '</div>';
847}
848
849/**
850 * Index item formatter
851 *
852 * User function for html_buildlist()
853 *
854 * @author Andreas Gohr <andi@splitbrain.org>
855 */
856function html_list_index($item){
857    global $ID;
858    $ret = '';
859    $base = ':'.$item['id'];
860    $base = substr($base,strrpos($base,':')+1);
861    if($item['type']=='d'){
862        $ret .= '<a href="'.wl($ID,'idx='.rawurlencode($item['id'])).'" title="' . $item['id'] . '" class="idx_dir"><strong>';
863        $ret .= $base;
864        $ret .= '</strong></a>';
865    }else{
866        // default is noNSorNS($id), but we want noNS($id) when useheading is off FS#2605
867        $ret .= html_wikilink(':'.$item['id'], useHeading('navigation') ? null : noNS($item['id']));
868    }
869    return $ret;
870}
871
872/**
873 * Index List item
874 *
875 * This user function is used in html_buildlist to build the
876 * <li> tags for namespaces when displaying the page index
877 * it gives different classes to opened or closed "folders"
878 *
879 * @author Andreas Gohr <andi@splitbrain.org>
880 */
881function html_li_index($item){
882    if($item['type'] == "f"){
883        return '<li class="level'.$item['level'].'">';
884    }elseif($item['open']){
885        return '<li class="open">';
886    }else{
887        return '<li class="closed">';
888    }
889}
890
891/**
892 * Default List item
893 *
894 * @author Andreas Gohr <andi@splitbrain.org>
895 */
896function html_li_default($item){
897    return '<li class="level'.$item['level'].'">';
898}
899
900/**
901 * Build an unordered list
902 *
903 * Build an unordered list from the given $data array
904 * Each item in the array has to have a 'level' property
905 * the item itself gets printed by the given $func user
906 * function. The second and optional function is used to
907 * print the <li> tag. Both user function need to accept
908 * a single item.
909 *
910 * Both user functions can be given as array to point to
911 * a member of an object.
912 *
913 * @author Andreas Gohr <andi@splitbrain.org>
914 */
915function html_buildlist($data,$class,$func,$lifunc='html_li_default',$forcewrapper=false){
916    if (count($data) === 0) {
917        return '';
918    }
919
920    $start_level = $data[0]['level'];
921    $level = $start_level;
922    $ret   = '';
923    $open  = 0;
924
925    foreach ($data as $item){
926
927        if( $item['level'] > $level ){
928            //open new list
929            for($i=0; $i<($item['level'] - $level); $i++){
930                if ($i) $ret .= "<li class=\"clear\">";
931                $ret .= "\n<ul class=\"$class\">\n";
932                $open++;
933            }
934            $level = $item['level'];
935
936        }elseif( $item['level'] < $level ){
937            //close last item
938            $ret .= "</li>\n";
939            while( $level > $item['level'] && $open > 0 ){
940                //close higher lists
941                $ret .= "</ul>\n</li>\n";
942                $level--;
943                $open--;
944            }
945        } elseif ($ret !== '') {
946            //close previous item
947            $ret .= "</li>\n";
948        }
949
950        //print item
951        $ret .= call_user_func($lifunc,$item);
952        $ret .= '<div class="li">';
953
954        $ret .= call_user_func($func,$item);
955        $ret .= '</div>';
956    }
957
958    //close remaining items and lists
959    $ret .= "</li>\n";
960    while($open-- > 0) {
961        $ret .= "</ul></li>\n";
962    }
963
964    if ($forcewrapper || $start_level < 2) {
965        // Trigger building a wrapper ul if the first level is
966        // 0 (we have a root object) or 1 (just the root content)
967        $ret = "\n<ul class=\"$class\">\n".$ret."</ul>\n";
968    }
969
970    return $ret;
971}
972
973/**
974 * display backlinks
975 *
976 * @author Andreas Gohr <andi@splitbrain.org>
977 * @author Michael Klier <chi@chimeric.de>
978 */
979function html_backlinks(){
980    global $ID;
981    global $lang;
982
983    print p_locale_xhtml('backlinks');
984
985    $data = ft_backlinks($ID);
986
987    if(!empty($data)) {
988        print '<ul class="idx">';
989        foreach($data as $blink){
990            print '<li><div class="li">';
991            print html_wikilink(':'.$blink,useHeading('navigation')?null:$blink);
992            print '</div></li>';
993        }
994        print '</ul>';
995    } else {
996        print '<div class="level1"><p>' . $lang['nothingfound'] . '</p></div>';
997    }
998}
999
1000/**
1001 * Get header of diff HTML
1002 * @param string $l_rev   Left revisions
1003 * @param string $r_rev   Right revision
1004 * @param string $id      Page id, if null $ID is used
1005 * @param bool   $media   If it is for media files
1006 * @return array HTML snippets for diff header
1007 */
1008function html_diff_head($l_rev, $r_rev, $id = null, $media = false) {
1009    global $lang;
1010    if ($id === null) {
1011        global $ID;
1012        $id = $ID;
1013    }
1014    $media_or_wikiFN = $media ? 'mediaFN' : 'wikiFN';
1015    $ml_or_wl = $media ? 'ml' : 'wl';
1016    $l_minor = $r_minor = '';
1017
1018    if(!$l_rev){
1019        $l_head = '&mdash;';
1020    }else{
1021        $l_info   = getRevisionInfo($id,$l_rev,true, $media);
1022        if($l_info['user']){
1023            $l_user = editorinfo($l_info['user']);
1024            if(auth_ismanager()) $l_user .= ' ('.$l_info['ip'].')';
1025        } else {
1026            $l_user = $l_info['ip'];
1027        }
1028        $l_user  = '<span class="user">'.$l_user.'</span>';
1029        $l_sum   = ($l_info['sum']) ? '<span class="sum">'.hsc($l_info['sum']).'</span>' : '';
1030        if ($l_info['type']===DOKU_CHANGE_TYPE_MINOR_EDIT) $l_minor = 'class="minor"';
1031
1032        $l_head_title = ($media) ? dformat($l_rev) : $id.' ['.dformat($l_rev).']';
1033        $l_head = '<a class="wikilink1" href="'.$ml_or_wl($id,"rev=$l_rev").'">'.
1034        $l_head_title.'</a>'.
1035        '<br />'.$l_user.' '.$l_sum;
1036    }
1037
1038    if($r_rev){
1039        $r_info   = getRevisionInfo($id,$r_rev,true, $media);
1040        if($r_info['user']){
1041            $r_user = editorinfo($r_info['user']);
1042            if(auth_ismanager()) $r_user .= ' ('.$r_info['ip'].')';
1043        } else {
1044            $r_user = $r_info['ip'];
1045        }
1046        $r_user = '<span class="user">'.$r_user.'</span>';
1047        $r_sum  = ($r_info['sum']) ? '<span class="sum">'.hsc($r_info['sum']).'</span>' : '';
1048        if ($r_info['type']===DOKU_CHANGE_TYPE_MINOR_EDIT) $r_minor = 'class="minor"';
1049
1050        $r_head_title = ($media) ? dformat($r_rev) : $id.' ['.dformat($r_rev).']';
1051        $r_head = '<a class="wikilink1" href="'.$ml_or_wl($id,"rev=$r_rev").'">'.
1052        $r_head_title.'</a>'.
1053        '<br />'.$r_user.' '.$r_sum;
1054    }elseif($_rev = @filemtime($media_or_wikiFN($id))){
1055        $_info   = getRevisionInfo($id,$_rev,true, $media);
1056        if($_info['user']){
1057            $_user = editorinfo($_info['user']);
1058            if(auth_ismanager()) $_user .= ' ('.$_info['ip'].')';
1059        } else {
1060            $_user = $_info['ip'];
1061        }
1062        $_user = '<span class="user">'.$_user.'</span>';
1063        $_sum  = ($_info['sum']) ? '<span class="sum">'.hsc($_info['sum']).'</span>' : '';
1064        if ($_info['type']===DOKU_CHANGE_TYPE_MINOR_EDIT) $r_minor = 'class="minor"';
1065
1066        $r_head_title = ($media) ? dformat($_rev) : $id.' ['.dformat($_rev).']';
1067        $r_head  = '<a class="wikilink1" href="'.$ml_or_wl($id).'">'.
1068        $r_head_title.'</a> '.
1069        '('.$lang['current'].')'.
1070        '<br />'.$_user.' '.$_sum;
1071    }else{
1072        $r_head = '&mdash; ('.$lang['current'].')';
1073    }
1074
1075    return array($l_head, $r_head, $l_minor, $r_minor);
1076}
1077
1078/**
1079 * show diff
1080 *
1081 * @author Andreas Gohr <andi@splitbrain.org>
1082 * @param  string $text - compare with this text with most current version
1083 * @param  bool   $intro - display the intro text
1084 * @param  string $type type of the diff (inline or sidebyside)
1085 */
1086function html_diff($text='',$intro=true,$type=null){
1087    global $ID;
1088    global $REV;
1089    global $lang;
1090    global $INPUT;
1091    global $INFO;
1092
1093    if(!$type) {
1094        $type = $INPUT->str('difftype');
1095        if (empty($type)) {
1096            $type = get_doku_pref('difftype', $type);
1097            if (empty($type) && $INFO['ismobile']) {
1098                $type = 'inline';
1099            }
1100        }
1101    }
1102    if($type != 'inline') $type = 'sidebyside';
1103
1104    // we're trying to be clever here, revisions to compare can be either
1105    // given as rev and rev2 parameters, with rev2 being optional. Or in an
1106    // array in rev2.
1107    $rev1 = $REV;
1108
1109    $rev2 = $INPUT->ref('rev2');
1110    if(is_array($rev2)){
1111        $rev1 = (int) $rev2[0];
1112        $rev2 = (int) $rev2[1];
1113
1114        if(!$rev1){
1115            $rev1 = $rev2;
1116            unset($rev2);
1117        }
1118    }else{
1119        $rev2 = $INPUT->int('rev2');
1120    }
1121
1122    $r_minor = '';
1123    $l_minor = '';
1124
1125    if($text){                      // compare text to the most current revision
1126        $l_rev   = '';
1127        $l_text  = rawWiki($ID,'');
1128        $l_head  = '<a class="wikilink1" href="'.wl($ID).'">'.
1129            $ID.' '.dformat((int) @filemtime(wikiFN($ID))).'</a> '.
1130            $lang['current'];
1131
1132        $r_rev   = '';
1133        $r_text  = cleanText($text);
1134        $r_head  = $lang['yours'];
1135    }else{
1136        if($rev1 && isset($rev2) && $rev2){            // two specific revisions wanted
1137            // make sure order is correct (older on the left)
1138            if($rev1 < $rev2){
1139                $l_rev = $rev1;
1140                $r_rev = $rev2;
1141            }else{
1142                $l_rev = $rev2;
1143                $r_rev = $rev1;
1144            }
1145        }elseif($rev1){                // single revision given, compare to current
1146            $r_rev = '';
1147            $l_rev = $rev1;
1148        }else{                        // no revision was given, compare previous to current
1149            $r_rev = '';
1150            $revs = getRevisions($ID, 0, 1);
1151            $l_rev = $revs[0];
1152            $REV = $l_rev; // store revision back in $REV
1153        }
1154
1155        // when both revisions are empty then the page was created just now
1156        if(!$l_rev && !$r_rev){
1157            $l_text = '';
1158        }else{
1159            $l_text = rawWiki($ID,$l_rev);
1160        }
1161        $r_text = rawWiki($ID,$r_rev);
1162
1163        list($l_head, $r_head, $l_minor, $r_minor) = html_diff_head($l_rev, $r_rev);
1164    }
1165
1166    $df = new Diff(explode("\n",hsc($l_text)),explode("\n",hsc($r_text)));
1167
1168    if($type == 'inline'){
1169        $tdf = new InlineDiffFormatter();
1170    } else {
1171        $tdf = new TableDiffFormatter();
1172    }
1173
1174    if($intro) print p_locale_xhtml('diff');
1175
1176    if (!$text) {
1177        ptln('<div class="diffoptions">');
1178
1179        $form = new Doku_Form(array('action'=>wl()));
1180        $form->addHidden('id',$ID);
1181        $form->addHidden('rev2[0]',$l_rev);
1182        $form->addHidden('rev2[1]',$r_rev);
1183        $form->addHidden('do','diff');
1184        $form->addElement(form_makeListboxField(
1185                            'difftype',
1186                            array(
1187                                'sidebyside' => $lang['diff_side'],
1188                                'inline'     => $lang['diff_inline']),
1189                            $type,
1190                            $lang['diff_type'],
1191                            '','',
1192                            array('class'=>'quickselect')));
1193        $form->addElement(form_makeButton('submit', 'diff','Go'));
1194        $form->printForm();
1195
1196        $diffurl = wl($ID, array(
1197                        'do'       => 'diff',
1198                        'rev2[0]'  => $l_rev,
1199                        'rev2[1]'  => $r_rev,
1200                        'difftype' => $type,
1201                      ));
1202        ptln('<p><a class="wikilink1" href="'.$diffurl.'">'.$lang['difflink'].'</a></p>');
1203        ptln('</div>');
1204    }
1205    ?>
1206    <div class="table">
1207    <table class="diff diff_<?php echo $type?>">
1208    <tr>
1209    <th colspan="2" <?php echo $l_minor?>>
1210    <?php echo $l_head?>
1211    </th>
1212    <th colspan="2" <?php echo $r_minor?>>
1213    <?php echo $r_head?>
1214    </th>
1215    </tr>
1216    <?php echo html_insert_softbreaks($tdf->format($df)); ?>
1217    </table>
1218    </div>
1219    <?php
1220}
1221
1222function html_insert_softbreaks($diffhtml) {
1223  // search the diff html string for both:
1224  // - html tags, so these can be ignored
1225  // - long strings of characters without breaking characters
1226  return preg_replace_callback('/<[^>]*>|[^<> ]{12,}/','html_softbreak_callback',$diffhtml);
1227}
1228
1229function html_softbreak_callback($match){
1230  // if match is an html tag, return it intact
1231  if ($match[0]{0} == '<') return $match[0];
1232
1233  // its a long string without a breaking character,
1234  // make certain characters into breaking characters by inserting a
1235  // breaking character (zero length space, U+200B / #8203) in front them.
1236  $regex = <<< REGEX
1237(?(?=                                 # start a conditional expression with a positive look ahead ...
1238&\#?\\w{1,6};)                        # ... for html entities - we don't want to split them (ok to catch some invalid combinations)
1239&\#?\\w{1,6};                         # yes pattern - a quicker match for the html entity, since we know we have one
1240|
1241[?/,&\#;:]+                           # no pattern - any other group of 'special' characters to insert a breaking character after
1242)                                     # end conditional expression
1243REGEX;
1244
1245  return preg_replace('<'.$regex.'>xu','\0&#8203;',$match[0]);
1246}
1247
1248/**
1249 * show warning on conflict detection
1250 *
1251 * @author Andreas Gohr <andi@splitbrain.org>
1252 */
1253function html_conflict($text,$summary){
1254    global $ID;
1255    global $lang;
1256
1257    print p_locale_xhtml('conflict');
1258    $form = new Doku_Form(array('id' => 'dw__editform'));
1259    $form->addHidden('id', $ID);
1260    $form->addHidden('wikitext', $text);
1261    $form->addHidden('summary', $summary);
1262    $form->addElement(form_makeButton('submit', 'save', $lang['btn_save'], array('accesskey'=>'s')));
1263    $form->addElement(form_makeButton('submit', 'cancel', $lang['btn_cancel']));
1264    html_form('conflict', $form);
1265    print '<br /><br /><br /><br />'.NL;
1266}
1267
1268/**
1269 * Prints the global message array
1270 *
1271 * @author Andreas Gohr <andi@splitbrain.org>
1272 */
1273function html_msgarea(){
1274    global $MSG, $MSG_shown;
1275    /** @var array $MSG */
1276    // store if the global $MSG has already been shown and thus HTML output has been started
1277    $MSG_shown = true;
1278
1279    if(!isset($MSG)) return;
1280
1281    $shown = array();
1282    foreach($MSG as $msg){
1283        $hash = md5($msg['msg']);
1284        if(isset($shown[$hash])) continue; // skip double messages
1285        print '<div class="'.$msg['lvl'].'">';
1286        print $msg['msg'];
1287        print '</div>';
1288        $shown[$hash] = 1;
1289    }
1290
1291    unset($GLOBALS['MSG']);
1292}
1293
1294/**
1295 * Prints the registration form
1296 *
1297 * @author Andreas Gohr <andi@splitbrain.org>
1298 */
1299function html_register(){
1300    global $lang;
1301    global $conf;
1302    global $INPUT;
1303
1304    print p_locale_xhtml('register');
1305    print '<div class="centeralign">'.NL;
1306    $form = new Doku_Form(array('id' => 'dw__register'));
1307    $form->startFieldset($lang['btn_register']);
1308    $form->addHidden('do', 'register');
1309    $form->addHidden('save', '1');
1310    $form->addElement(form_makeTextField('login', $INPUT->post->str('login'), $lang['user'], '', 'block', array('size'=>'50')));
1311    if (!$conf['autopasswd']) {
1312        $form->addElement(form_makePasswordField('pass', $lang['pass'], '', 'block', array('size'=>'50')));
1313        $form->addElement(form_makePasswordField('passchk', $lang['passchk'], '', 'block', array('size'=>'50')));
1314    }
1315    $form->addElement(form_makeTextField('fullname', $INPUT->post->str('fullname'), $lang['fullname'], '', 'block', array('size'=>'50')));
1316    $form->addElement(form_makeTextField('email', $INPUT->post->str('email'), $lang['email'], '', 'block', array('size'=>'50')));
1317    $form->addElement(form_makeButton('submit', '', $lang['btn_register']));
1318    $form->endFieldset();
1319    html_form('register', $form);
1320
1321    print '</div>'.NL;
1322}
1323
1324/**
1325 * Print the update profile form
1326 *
1327 * @author Christopher Smith <chris@jalakai.co.uk>
1328 * @author Andreas Gohr <andi@splitbrain.org>
1329 */
1330function html_updateprofile(){
1331    global $lang;
1332    global $conf;
1333    global $INPUT;
1334    global $INFO;
1335    /** @var auth_basic $auth */
1336    global $auth;
1337
1338    print p_locale_xhtml('updateprofile');
1339
1340    $fullname = $INPUT->post->str('fullname', $INFO['userinfo']['name'], true);
1341    $email = $INPUT->post->str('email', $INFO['userinfo']['mail'], true);
1342    print '<div class="centeralign">'.NL;
1343    $form = new Doku_Form(array('id' => 'dw__register'));
1344    $form->startFieldset($lang['profile']);
1345    $form->addHidden('do', 'profile');
1346    $form->addHidden('save', '1');
1347    $form->addElement(form_makeTextField('login', $_SERVER['REMOTE_USER'], $lang['user'], '', 'block', array('size'=>'50', 'disabled'=>'disabled')));
1348    $attr = array('size'=>'50');
1349    if (!$auth->canDo('modName')) $attr['disabled'] = 'disabled';
1350    $form->addElement(form_makeTextField('fullname', $fullname, $lang['fullname'], '', 'block', $attr));
1351    $attr = array('size'=>'50');
1352    if (!$auth->canDo('modMail')) $attr['disabled'] = 'disabled';
1353    $form->addElement(form_makeTextField('email', $email, $lang['email'], '', 'block', $attr));
1354    $form->addElement(form_makeTag('br'));
1355    if ($auth->canDo('modPass')) {
1356        $form->addElement(form_makePasswordField('newpass', $lang['newpass'], '', 'block', array('size'=>'50')));
1357        $form->addElement(form_makePasswordField('passchk', $lang['passchk'], '', 'block', array('size'=>'50')));
1358    }
1359    if ($conf['profileconfirm']) {
1360        $form->addElement(form_makeTag('br'));
1361        $form->addElement(form_makePasswordField('oldpass', $lang['oldpass'], '', 'block', array('size'=>'50')));
1362    }
1363    $form->addElement(form_makeButton('submit', '', $lang['btn_save']));
1364    $form->addElement(form_makeButton('reset', '', $lang['btn_reset']));
1365    $form->endFieldset();
1366    html_form('updateprofile', $form);
1367    print '</div>'.NL;
1368}
1369
1370/**
1371 * Preprocess edit form data
1372 *
1373 * @author   Andreas Gohr <andi@splitbrain.org>
1374 *
1375 * @triggers HTML_EDITFORM_OUTPUT
1376 */
1377function html_edit(){
1378    global $INPUT;
1379    global $ID;
1380    global $REV;
1381    global $DATE;
1382    global $PRE;
1383    global $SUF;
1384    global $INFO;
1385    global $SUM;
1386    global $lang;
1387    global $conf;
1388    global $TEXT;
1389    global $RANGE;
1390
1391    if ($INPUT->has('changecheck')) {
1392        $check = $INPUT->str('changecheck');
1393    } elseif(!$INFO['exists']){
1394        // $TEXT has been loaded from page template
1395        $check = md5('');
1396    } else {
1397        $check = md5($TEXT);
1398    }
1399    $mod = md5($TEXT) !== $check;
1400
1401    $wr = $INFO['writable'] && !$INFO['locked'];
1402    $include = 'edit';
1403    if($wr){
1404        if ($REV) $include = 'editrev';
1405    }else{
1406        // check pseudo action 'source'
1407        if(!actionOK('source')){
1408            msg('Command disabled: source',-1);
1409            return;
1410        }
1411        $include = 'read';
1412    }
1413
1414    global $license;
1415
1416    $form = new Doku_Form(array('id' => 'dw__editform'));
1417    $form->addHidden('id', $ID);
1418    $form->addHidden('rev', $REV);
1419    $form->addHidden('date', $DATE);
1420    $form->addHidden('prefix', $PRE . '.');
1421    $form->addHidden('suffix', $SUF);
1422    $form->addHidden('changecheck', $check);
1423
1424    $data = array('form' => $form,
1425                  'wr'   => $wr,
1426                  'media_manager' => true,
1427                  'target' => ($INPUT->has('target') && $wr) ? $INPUT->str('target') : 'section',
1428                  'intro_locale' => $include);
1429
1430    if ($data['target'] !== 'section') {
1431        // Only emit event if page is writable, section edit data is valid and
1432        // edit target is not section.
1433        trigger_event('HTML_EDIT_FORMSELECTION', $data, 'html_edit_form', true);
1434    } else {
1435        html_edit_form($data);
1436    }
1437    if (isset($data['intro_locale'])) {
1438        echo p_locale_xhtml($data['intro_locale']);
1439    }
1440
1441    $form->addHidden('target', $data['target']);
1442    $form->addElement(form_makeOpenTag('div', array('id'=>'wiki__editbar', 'class'=>'editBar')));
1443    $form->addElement(form_makeOpenTag('div', array('id'=>'size__ctl')));
1444    $form->addElement(form_makeCloseTag('div'));
1445    if ($wr) {
1446        $form->addElement(form_makeOpenTag('div', array('class'=>'editButtons')));
1447        $form->addElement(form_makeButton('submit', 'save', $lang['btn_save'], array('id'=>'edbtn__save', 'accesskey'=>'s', 'tabindex'=>'4')));
1448        $form->addElement(form_makeButton('submit', 'preview', $lang['btn_preview'], array('id'=>'edbtn__preview', 'accesskey'=>'p', 'tabindex'=>'5')));
1449        $form->addElement(form_makeButton('submit', 'draftdel', $lang['btn_cancel'], array('tabindex'=>'6')));
1450        $form->addElement(form_makeCloseTag('div'));
1451        $form->addElement(form_makeOpenTag('div', array('class'=>'summary')));
1452        $form->addElement(form_makeTextField('summary', $SUM, $lang['summary'], 'edit__summary', 'nowrap', array('size'=>'50', 'tabindex'=>'2')));
1453        $elem = html_minoredit();
1454        if ($elem) $form->addElement($elem);
1455        $form->addElement(form_makeCloseTag('div'));
1456    }
1457    $form->addElement(form_makeCloseTag('div'));
1458    if($wr && $conf['license']){
1459        $form->addElement(form_makeOpenTag('div', array('class'=>'license')));
1460        $out  = $lang['licenseok'];
1461        $out .= ' <a href="'.$license[$conf['license']]['url'].'" rel="license" class="urlextern"';
1462        if($conf['target']['extern']) $out .= ' target="'.$conf['target']['extern'].'"';
1463        $out .= '>'.$license[$conf['license']]['name'].'</a>';
1464        $form->addElement($out);
1465        $form->addElement(form_makeCloseTag('div'));
1466    }
1467
1468    if ($wr) {
1469        // sets changed to true when previewed
1470        echo '<script type="text/javascript">/*<![CDATA[*/'. NL;
1471        echo 'textChanged = ' . ($mod ? 'true' : 'false');
1472        echo '/*!]]>*/</script>' . NL;
1473    } ?>
1474    <div class="editBox">
1475
1476    <div class="toolbar group">
1477        <div id="draft__status"><?php if(!empty($INFO['draft'])) echo $lang['draftdate'].' '.dformat();?></div>
1478        <div id="tool__bar"><?php if ($wr && $data['media_manager']){?><a href="<?php echo DOKU_BASE?>lib/exe/mediamanager.php?ns=<?php echo $INFO['namespace']?>"
1479            target="_blank"><?php echo $lang['mediaselect'] ?></a><?php }?></div>
1480    </div>
1481    <?php
1482
1483    html_form('edit', $form);
1484    print '</div>'.NL;
1485}
1486
1487/**
1488 * Display the default edit form
1489 *
1490 * Is the default action for HTML_EDIT_FORMSELECTION.
1491 */
1492function html_edit_form($param) {
1493    global $TEXT;
1494
1495    if ($param['target'] !== 'section') {
1496        msg('No editor for edit target ' . hsc($param['target']) . ' found.', -1);
1497    }
1498
1499    $attr = array('tabindex'=>'1');
1500    if (!$param['wr']) $attr['readonly'] = 'readonly';
1501
1502    $param['form']->addElement(form_makeWikiText($TEXT, $attr));
1503}
1504
1505/**
1506 * Adds a checkbox for minor edits for logged in users
1507 *
1508 * @author Andreas Gohr <andi@splitbrain.org>
1509 */
1510function html_minoredit(){
1511    global $conf;
1512    global $lang;
1513    global $INPUT;
1514    // minor edits are for logged in users only
1515    if(!$conf['useacl'] || !$_SERVER['REMOTE_USER']){
1516        return false;
1517    }
1518
1519    $p = array();
1520    $p['tabindex'] = 3;
1521    if($INPUT->bool('minor')) $p['checked']='checked';
1522    return form_makeCheckboxField('minor', '1', $lang['minoredit'], 'minoredit', 'nowrap', $p);
1523}
1524
1525/**
1526 * prints some debug info
1527 *
1528 * @author Andreas Gohr <andi@splitbrain.org>
1529 */
1530function html_debug(){
1531    global $conf;
1532    global $lang;
1533    /** @var auth_basic $auth */
1534    global $auth;
1535    global $INFO;
1536
1537    //remove sensitive data
1538    $cnf = $conf;
1539    debug_guard($cnf);
1540    $nfo = $INFO;
1541    debug_guard($nfo);
1542    $ses = $_SESSION;
1543    debug_guard($ses);
1544
1545    print '<html><body>';
1546
1547    print '<p>When reporting bugs please send all the following ';
1548    print 'output as a mail to andi@splitbrain.org ';
1549    print 'The best way to do this is to save this page in your browser</p>';
1550
1551    print '<b>$INFO:</b><pre>';
1552    print_r($nfo);
1553    print '</pre>';
1554
1555    print '<b>$_SERVER:</b><pre>';
1556    print_r($_SERVER);
1557    print '</pre>';
1558
1559    print '<b>$conf:</b><pre>';
1560    print_r($cnf);
1561    print '</pre>';
1562
1563    print '<b>DOKU_BASE:</b><pre>';
1564    print DOKU_BASE;
1565    print '</pre>';
1566
1567    print '<b>abs DOKU_BASE:</b><pre>';
1568    print DOKU_URL;
1569    print '</pre>';
1570
1571    print '<b>rel DOKU_BASE:</b><pre>';
1572    print dirname($_SERVER['PHP_SELF']).'/';
1573    print '</pre>';
1574
1575    print '<b>PHP Version:</b><pre>';
1576    print phpversion();
1577    print '</pre>';
1578
1579    print '<b>locale:</b><pre>';
1580    print setlocale(LC_ALL,0);
1581    print '</pre>';
1582
1583    print '<b>encoding:</b><pre>';
1584    print $lang['encoding'];
1585    print '</pre>';
1586
1587    if($auth){
1588        print '<b>Auth backend capabilities:</b><pre>';
1589        print_r($auth->cando);
1590        print '</pre>';
1591    }
1592
1593    print '<b>$_SESSION:</b><pre>';
1594    print_r($ses);
1595    print '</pre>';
1596
1597    print '<b>Environment:</b><pre>';
1598    print_r($_ENV);
1599    print '</pre>';
1600
1601    print '<b>PHP settings:</b><pre>';
1602    $inis = ini_get_all();
1603    print_r($inis);
1604    print '</pre>';
1605
1606    print '</body></html>';
1607}
1608
1609/**
1610 * List available Administration Tasks
1611 *
1612 * @author Andreas Gohr <andi@splitbrain.org>
1613 * @author Håkan Sandell <hakan.sandell@home.se>
1614 */
1615function html_admin(){
1616    global $ID;
1617    global $INFO;
1618    global $conf;
1619    /** @var auth_basic $auth */
1620    global $auth;
1621
1622    // build menu of admin functions from the plugins that handle them
1623    $pluginlist = plugin_list('admin');
1624    $menu = array();
1625    foreach ($pluginlist as $p) {
1626        /** @var DokuWiki_Admin_Plugin $obj */
1627        if($obj =& plugin_load('admin',$p) === null) continue;
1628
1629        // check permissions
1630        if($obj->forAdminOnly() && !$INFO['isadmin']) continue;
1631
1632        $menu[$p] = array('plugin' => $p,
1633                'prompt' => $obj->getMenuText($conf['lang']),
1634                'sort' => $obj->getMenuSort()
1635                );
1636    }
1637
1638    // data security check
1639    // @todo: could be checked and only displayed if $conf['savedir'] is under the web root
1640    echo '<a style="border:none; float:right;"
1641            href="http://www.dokuwiki.org/security#web_access_security">
1642            <img src="data/security.png" alt="Your data directory seems to be protected properly."
1643             onerror="this.parentNode.style.display=\'none\'" /></a>';
1644
1645    print p_locale_xhtml('admin');
1646
1647    // Admin Tasks
1648    if($INFO['isadmin']){
1649        ptln('<ul class="admin_tasks">');
1650
1651        if($menu['usermanager'] && $auth && $auth->canDo('getUsers')){
1652            ptln('  <li class="admin_usermanager"><div class="li">'.
1653                    '<a href="'.wl($ID, array('do' => 'admin','page' => 'usermanager')).'">'.
1654                    $menu['usermanager']['prompt'].'</a></div></li>');
1655        }
1656        unset($menu['usermanager']);
1657
1658        if($menu['acl']){
1659            ptln('  <li class="admin_acl"><div class="li">'.
1660                    '<a href="'.wl($ID, array('do' => 'admin','page' => 'acl')).'">'.
1661                    $menu['acl']['prompt'].'</a></div></li>');
1662        }
1663        unset($menu['acl']);
1664
1665        if($menu['plugin']){
1666            ptln('  <li class="admin_plugin"><div class="li">'.
1667                    '<a href="'.wl($ID, array('do' => 'admin','page' => 'plugin')).'">'.
1668                    $menu['plugin']['prompt'].'</a></div></li>');
1669        }
1670        unset($menu['plugin']);
1671
1672        if($menu['config']){
1673            ptln('  <li class="admin_config"><div class="li">'.
1674                    '<a href="'.wl($ID, array('do' => 'admin','page' => 'config')).'">'.
1675                    $menu['config']['prompt'].'</a></div></li>');
1676        }
1677        unset($menu['config']);
1678    }
1679    ptln('</ul>');
1680
1681    // Manager Tasks
1682    ptln('<ul class="admin_tasks">');
1683
1684    if($menu['revert']){
1685        ptln('  <li class="admin_revert"><div class="li">'.
1686                '<a href="'.wl($ID, array('do' => 'admin','page' => 'revert')).'">'.
1687                $menu['revert']['prompt'].'</a></div></li>');
1688    }
1689    unset($menu['revert']);
1690
1691    if($menu['popularity']){
1692        ptln('  <li class="admin_popularity"><div class="li">'.
1693                '<a href="'.wl($ID, array('do' => 'admin','page' => 'popularity')).'">'.
1694                $menu['popularity']['prompt'].'</a></div></li>');
1695    }
1696    unset($menu['popularity']);
1697
1698    // print DokuWiki version:
1699    ptln('</ul>');
1700    echo '<div id="admin__version">';
1701    echo getVersion();
1702    echo '</div>';
1703
1704    // print the rest as sorted list
1705    if(count($menu)){
1706        usort($menu, 'p_sort_modes');
1707        // output the menu
1708        ptln('<div class="clearer"></div>');
1709        print p_locale_xhtml('adminplugins');
1710        ptln('<ul>');
1711        foreach ($menu as $item) {
1712            if (!$item['prompt']) continue;
1713            ptln('  <li><div class="li"><a href="'.wl($ID, 'do=admin&amp;page='.$item['plugin']).'">'.$item['prompt'].'</a></div></li>');
1714        }
1715        ptln('</ul>');
1716    }
1717}
1718
1719/**
1720 * Form to request a new password for an existing account
1721 *
1722 * @author Benoit Chesneau <benoit@bchesneau.info>
1723 * @author Andreas Gohr <gohr@cosmocode.de>
1724 */
1725function html_resendpwd() {
1726    global $lang;
1727    global $conf;
1728    global $INPUT;
1729
1730    $token = preg_replace('/[^a-f0-9]+/','',$INPUT->str('pwauth'));
1731
1732    if(!$conf['autopasswd'] && $token){
1733        print p_locale_xhtml('resetpwd');
1734        print '<div class="centeralign">'.NL;
1735        $form = new Doku_Form(array('id' => 'dw__resendpwd'));
1736        $form->startFieldset($lang['btn_resendpwd']);
1737        $form->addHidden('token', $token);
1738        $form->addHidden('do', 'resendpwd');
1739
1740        $form->addElement(form_makePasswordField('pass', $lang['pass'], '', 'block', array('size'=>'50')));
1741        $form->addElement(form_makePasswordField('passchk', $lang['passchk'], '', 'block', array('size'=>'50')));
1742
1743        $form->addElement(form_makeButton('submit', '', $lang['btn_resendpwd']));
1744        $form->endFieldset();
1745        html_form('resendpwd', $form);
1746        print '</div>'.NL;
1747    }else{
1748        print p_locale_xhtml('resendpwd');
1749        print '<div class="centeralign">'.NL;
1750        $form = new Doku_Form(array('id' => 'dw__resendpwd'));
1751        $form->startFieldset($lang['resendpwd']);
1752        $form->addHidden('do', 'resendpwd');
1753        $form->addHidden('save', '1');
1754        $form->addElement(form_makeTag('br'));
1755        $form->addElement(form_makeTextField('login', $INPUT->post->str('login'), $lang['user'], '', 'block'));
1756        $form->addElement(form_makeTag('br'));
1757        $form->addElement(form_makeTag('br'));
1758        $form->addElement(form_makeButton('submit', '', $lang['btn_resendpwd']));
1759        $form->endFieldset();
1760        html_form('resendpwd', $form);
1761        print '</div>'.NL;
1762    }
1763}
1764
1765/**
1766 * Return the TOC rendered to XHTML
1767 *
1768 * @author Andreas Gohr <andi@splitbrain.org>
1769 */
1770function html_TOC($toc){
1771    if(!count($toc)) return '';
1772    global $lang;
1773    $out  = '<!-- TOC START -->'.DOKU_LF;
1774    $out .= '<div id="dw__toc">'.DOKU_LF;
1775    $out .= '<h3 class="toggle">';
1776    $out .= $lang['toc'];
1777    $out .= '</h3>'.DOKU_LF;
1778    $out .= '<div>'.DOKU_LF;
1779    $out .= html_buildlist($toc,'toc','html_list_toc','html_li_default',true);
1780    $out .= '</div>'.DOKU_LF.'</div>'.DOKU_LF;
1781    $out .= '<!-- TOC END -->'.DOKU_LF;
1782    return $out;
1783}
1784
1785/**
1786 * Callback for html_buildlist
1787 */
1788function html_list_toc($item){
1789    if(isset($item['hid'])){
1790        $link = '#'.$item['hid'];
1791    }else{
1792        $link = $item['link'];
1793    }
1794
1795    return '<a href="'.$link.'">'.hsc($item['title']).'</a>';
1796}
1797
1798/**
1799 * Helper function to build TOC items
1800 *
1801 * Returns an array ready to be added to a TOC array
1802 *
1803 * @param string $link  - where to link (if $hash set to '#' it's a local anchor)
1804 * @param string $text  - what to display in the TOC
1805 * @param int    $level - nesting level
1806 * @param string $hash  - is prepended to the given $link, set blank if you want full links
1807 * @return array the toc item
1808 */
1809function html_mktocitem($link, $text, $level, $hash='#'){
1810    return  array( 'link'  => $hash.$link,
1811            'title' => $text,
1812            'type'  => 'ul',
1813            'level' => $level);
1814}
1815
1816/**
1817 * Output a Doku_Form object.
1818 * Triggers an event with the form name: HTML_{$name}FORM_OUTPUT
1819 *
1820 * @author Tom N Harris <tnharris@whoopdedo.org>
1821 * @param string     $name The name of the form
1822 * @param Doku_Form  $form The form
1823 */
1824function html_form($name, &$form) {
1825    // Safety check in case the caller forgets.
1826    $form->endFieldset();
1827    trigger_event('HTML_'.strtoupper($name).'FORM_OUTPUT', $form, 'html_form_output', false);
1828}
1829
1830/**
1831 * Form print function.
1832 * Just calls printForm() on the data object.
1833 * @param Doku_Form $data The form
1834 */
1835function html_form_output($data) {
1836    $data->printForm();
1837}
1838
1839/**
1840 * Embed a flash object in HTML
1841 *
1842 * This will create the needed HTML to embed a flash movie in a cross browser
1843 * compatble way using valid XHTML
1844 *
1845 * The parameters $params, $flashvars and $atts need to be associative arrays.
1846 * No escaping needs to be done for them. The alternative content *has* to be
1847 * escaped because it is used as is. If no alternative content is given
1848 * $lang['noflash'] is used.
1849 *
1850 * @author Andreas Gohr <andi@splitbrain.org>
1851 * @link   http://latrine.dgx.cz/how-to-correctly-insert-a-flash-into-xhtml
1852 *
1853 * @param string $swf      - the SWF movie to embed
1854 * @param int $width       - width of the flash movie in pixels
1855 * @param int $height      - height of the flash movie in pixels
1856 * @param array $params    - additional parameters (<param>)
1857 * @param array $flashvars - parameters to be passed in the flashvar parameter
1858 * @param array $atts      - additional attributes for the <object> tag
1859 * @param string $alt      - alternative content (is NOT automatically escaped!)
1860 * @return string         - the XHTML markup
1861 */
1862function html_flashobject($swf,$width,$height,$params=null,$flashvars=null,$atts=null,$alt=''){
1863    global $lang;
1864
1865    $out = '';
1866
1867    // prepare the object attributes
1868    if(is_null($atts)) $atts = array();
1869    $atts['width']  = (int) $width;
1870    $atts['height'] = (int) $height;
1871    if(!$atts['width'])  $atts['width']  = 425;
1872    if(!$atts['height']) $atts['height'] = 350;
1873
1874    // add object attributes for standard compliant browsers
1875    $std = $atts;
1876    $std['type'] = 'application/x-shockwave-flash';
1877    $std['data'] = $swf;
1878
1879    // add object attributes for IE
1880    $ie  = $atts;
1881    $ie['classid'] = 'clsid:D27CDB6E-AE6D-11cf-96B8-444553540000';
1882
1883    // open object (with conditional comments)
1884    $out .= '<!--[if !IE]> -->'.NL;
1885    $out .= '<object '.buildAttributes($std).'>'.NL;
1886    $out .= '<!-- <![endif]-->'.NL;
1887    $out .= '<!--[if IE]>'.NL;
1888    $out .= '<object '.buildAttributes($ie).'>'.NL;
1889    $out .= '    <param name="movie" value="'.hsc($swf).'" />'.NL;
1890    $out .= '<!--><!-- -->'.NL;
1891
1892    // print params
1893    if(is_array($params)) foreach($params as $key => $val){
1894        $out .= '  <param name="'.hsc($key).'" value="'.hsc($val).'" />'.NL;
1895    }
1896
1897    // add flashvars
1898    if(is_array($flashvars)){
1899        $out .= '  <param name="FlashVars" value="'.buildURLparams($flashvars).'" />'.NL;
1900    }
1901
1902    // alternative content
1903    if($alt){
1904        $out .= $alt.NL;
1905    }else{
1906        $out .= $lang['noflash'].NL;
1907    }
1908
1909    // finish
1910    $out .= '</object>'.NL;
1911    $out .= '<!-- <![endif]-->'.NL;
1912
1913    return $out;
1914}
1915
1916/**
1917 * Prints HTML code for the given tab structure
1918 *
1919 * @param array  $tabs        tab structure
1920 * @param string $current_tab the current tab id
1921 */
1922function html_tabs($tabs, $current_tab = null) {
1923    echo '<ul class="tabs">'.NL;
1924
1925    foreach($tabs as $id => $tab) {
1926        html_tab($tab['href'], $tab['caption'], $id === $current_tab);
1927    }
1928
1929    echo '</ul>'.NL;
1930}
1931/**
1932 * Prints a single tab
1933 *
1934 * @author Kate Arzamastseva <pshns@ukr.net>
1935 * @author Adrian Lang <mail@adrianlang.de>
1936 *
1937 * @param string $href - tab href
1938 * @param string $caption - tab caption
1939 * @param boolean $selected - is tab selected
1940 */
1941
1942function html_tab($href, $caption, $selected=false) {
1943    $tab = '<li>';
1944    if ($selected) {
1945        $tab .= '<strong>';
1946    } else {
1947        $tab .= '<a href="' . hsc($href) . '">';
1948    }
1949    $tab .= hsc($caption)
1950         .  '</' . ($selected ? 'strong' : 'a') . '>'
1951         .  '</li>'.NL;
1952    echo $tab;
1953}
1954
1955