xref: /dokuwiki/inc/template.php (revision b1112787e60be712d508e80baaf0d6f9a861f0ac)
1<?php
2/**
3 * DokuWiki template functions
4 *
5 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
6 * @author     Andreas Gohr <andi@splitbrain.org>
7 */
8
9  if(!defined('DOKU_INC')) define('DOKU_INC',realpath(dirname(__FILE__).'/../').'/');
10  require_once(DOKU_CONF.'dokuwiki.php');
11
12/**
13 * Returns the path to the given template, uses
14 * default one if the custom version doesn't exist
15 *
16 * @author Andreas Gohr <andi@splitbrain.org>
17 */
18function template($tpl){
19  global $conf;
20
21  if(@is_readable(DOKU_INC.'lib/tpl/'.$conf['template'].'/'.$tpl))
22    return DOKU_INC.'lib/tpl/'.$conf['template'].'/'.$tpl;
23
24  return DOKU_INC.'lib/tpl/default/'.$tpl;
25}
26
27/**
28 * Print the content
29 *
30 * This function is used for printing all the usual content
31 * (defined by the global $ACT var) by calling the appropriate
32 * outputfunction(s) from html.php
33 *
34 * Everything that doesn't use the main template file isn't
35 * handled by this function. ACL stuff is not done here either.
36 *
37 * @author Andreas Gohr <andi@splitbrain.org>
38 */
39function tpl_content() {
40  global $ACT;
41
42  ob_start();
43
44  trigger_event('TPL_ACT_RENDER',$ACT,tpl_content_core);
45
46  $html_output = ob_get_clean();
47
48  trigger_event('TPL_CONTENT_DISPLAY',$html_output,ptln);
49}
50
51function tpl_content_core(){
52  global $ACT;
53  global $TEXT;
54  global $PRE;
55  global $SUF;
56  global $SUM;
57  global $IDX;
58
59  switch($ACT){
60    case 'show':
61      html_show();
62      break;
63    case 'preview':
64      html_edit($TEXT);
65      html_show($TEXT);
66      break;
67    case 'recover':
68      html_edit($TEXT);
69      break;
70    case 'edit':
71      html_edit();
72      break;
73    case 'draft':
74      html_draft();
75      break;
76    case 'wordblock':
77      html_edit($TEXT,'wordblock');
78      break;
79    case 'search':
80      html_search();
81      break;
82    case 'revisions':
83      html_revisions();
84      break;
85    case 'diff':
86      html_diff();
87      break;
88    case 'recent':
89      $first = is_numeric($_REQUEST['first']) ? intval($_REQUEST['first']) : 0;
90      html_recent($first);
91      break;
92    case 'index':
93      html_index($IDX); #FIXME can this be pulled from globals? is it sanitized correctly?
94      break;
95    case 'backlink':
96      html_backlinks();
97      break;
98    case 'conflict':
99      html_conflict(con($PRE,$TEXT,$SUF),$SUM);
100      html_diff(con($PRE,$TEXT,$SUF),false);
101      break;
102    case 'locked':
103      html_locked();
104      break;
105    case 'login':
106      html_login();
107      break;
108    case 'register':
109      html_register();
110      break;
111    case 'resendpwd':
112      html_resendpwd();
113      break;
114    case 'denied':
115      print p_locale_xhtml('denied');
116      break;
117    case 'profile' :
118      html_updateprofile();
119      break;
120    case 'admin':
121      tpl_admin();
122      break;
123    default:
124      $evt = new Doku_Event('TPL_ACT_UNKNOWN',$ACT);
125      if ($evt->advise_before())
126        msg("Failed to handle command: ".hsc($ACT),-1);
127      $evt->advise_after();
128      unset($evt);
129  }
130}
131
132/**
133 * Handle the admin page contents
134 *
135 * @author Andreas Gohr <andi@splitbrain.org>
136 */
137function tpl_admin(){
138
139    $plugin = NULL;
140    if ($_REQUEST['page']) {
141        $pluginlist = plugin_list('admin');
142
143        if (in_array($_REQUEST['page'], $pluginlist)) {
144
145          // attempt to load the plugin
146          $plugin =& plugin_load('admin',$_REQUEST['page']);
147        }
148    }
149
150    if ($plugin !== NULL)
151        $plugin->html();
152    else
153        html_admin();
154}
155
156/**
157 * Print the correct HTML meta headers
158 *
159 * This has to go into the head section of your template.
160 *
161 * @param  boolean $alt Should feeds and alternative format links be added?
162 * @author Andreas Gohr <andi@splitbrain.org>
163 */
164function tpl_metaheaders($alt=true){
165  global $ID;
166  global $INFO;
167  global $ACT;
168  global $lang;
169  global $conf;
170  $it=2;
171
172  // the usual stuff
173  ptln('<meta name="generator" content="DokuWiki '.getVersion().'" />',$it);
174  ptln('<link rel="start" href="'.DOKU_BASE.'" />',$it);
175  ptln('<link rel="contents" href="'.wl($ID,'do=index').'" title="'.$lang['index'].'" />',$it);
176
177  if($alt){
178    ptln('<link rel="alternate" type="application/rss+xml" title="Recent Changes" href="'.DOKU_BASE.'feed.php" />',$it);
179    ptln('<link rel="alternate" type="application/rss+xml" title="Current Namespace" href="'.DOKU_BASE.'feed.php?mode=list&amp;ns='.$INFO['namespace'].'" />',$it);
180    ptln('<link rel="alternate" type="text/html" title="Plain HTML" href="'.exportlink($ID, 'xhtml').'" />',$it);
181    ptln('<link rel="alternate" type="text/plain" title="Wiki Markup" href="'.exportlink($ID, 'raw').'" />',$it);
182  }
183
184  // setup robot tags apropriate for different modes
185  if( ($ACT=='show' || $ACT=='export_xhtml') && !$REV){
186    if($INFO['exists']){
187      ptln('<meta name="date" content="'.date('Y-m-d\TH:i:sO',$INFO['lastmod']).'" />',$it);
188      //delay indexing:
189      if((time() - $INFO['lastmod']) >= $conf['indexdelay']){
190        ptln('<meta name="robots" content="index,follow" />',$it);
191      }else{
192        ptln('<meta name="robots" content="noindex,nofollow" />',$it);
193      }
194    }else{
195      ptln('<meta name="robots" content="noindex,follow" />',$it);
196    }
197  }else{
198    ptln('<meta name="robots" content="noindex,nofollow" />',$it);
199  }
200
201  // load stylesheets
202  ptln('<link rel="stylesheet" media="screen" type="text/css" href="'.DOKU_BASE.'lib/exe/css.php" />',$it);
203  ptln('<link rel="stylesheet" media="print" type="text/css" href="'.DOKU_BASE.'lib/exe/css.php?print=1" />',$it);
204
205  // load javascript
206  $js_edit  = ($ACT=='edit' || $ACT=='preview' || $ACT=='recover') ? 1 : 0;
207  $js_write = ($INFO['writable']) ? 1 : 0;
208  if($js_edit && $js_write){
209    ptln('<script type="text/javascript" charset="utf-8">',$it);
210    ptln("NS='".$INFO['namespace']."';",$it+2);
211    if($conf['useacl'] && $_SERVER['REMOTE_USER']){
212      require_once(DOKU_INC.'inc/toolbar.php');
213      ptln("SIG='".toolbar_signature()."';",$it+2);
214    }
215    ptln('</script>',$it);
216  }
217  ptln('<script type="text/javascript" charset="utf-8" src="'.
218       DOKU_BASE.'lib/exe/js.php?edit='.$js_edit.'&amp;write='.$js_write.'"></script>',$it);
219}
220
221/**
222 * Print a link
223 *
224 * Just builds a link.
225 *
226 * @author Andreas Gohr <andi@splitbrain.org>
227 */
228function tpl_link($url,$name,$more=''){
229  print '<a href="'.$url.'" ';
230  if ($more) print ' '.$more;
231  print ">$name</a>";
232}
233
234/**
235 * Prints a link to a WikiPage
236 *
237 * Wrapper around html_wikilink
238 *
239 * @author Andreas Gohr <andi@splitbrain.org>
240 */
241function tpl_pagelink($id,$name=NULL){
242  print html_wikilink($id,$name);
243}
244
245/**
246 * get the parent page
247 *
248 * Tries to find out which page is parent.
249 * returns false if none is available
250 *
251 * @author Matthias Grimm <matthiasgrimm@users.sourceforge.net>
252 */
253function tpl_getparent($ID){
254  global $conf;
255
256  if ($ID != $conf['start']) {
257    $idparts = explode(':', $ID);
258    $pn = array_pop($idparts);    // get the page name
259
260    for ($n=0; $n < 2; $n++) {
261      if (count($idparts) == 0) {
262        $ID = $conf['start'];     // go to topmost page
263        break;
264      }else{
265        $ns = array_pop($idparts);     // get the last part of namespace
266        if ($pn != $ns) {                 // are we already home?
267          array_push($idparts, $ns, $ns); // no, then add a page with same name
268          $ID = implode (':', $idparts); // as the namespace and recombine $ID
269          break;
270        }
271      }
272    }
273
274    if (@file_exists(wikiFN($ID))) {
275      return $ID;
276    }
277  }
278  return false;
279}
280
281/**
282 * Print one of the buttons
283 *
284 * Available Buttons are
285 *
286 *  edit        - edit/create/show/draft button
287 *  history     - old revisions
288 *  recent      - recent changes
289 *  login       - login/logout button - if ACL enabled
290 *  index       - The index
291 *  admin       - admin page - if enough rights
292 *  top         - a back to top button
293 *  back        - a back to parent button - if available
294 *  backtomedia - returns to the mediafile upload dialog
295 *                after references have been displayed
296 *  backlink    - links to the list of backlinks
297 *
298 * @author Andreas Gohr <andi@splitbrain.org>
299 * @author Matthias Grimm <matthiasgrimm@users.sourceforge.net>
300 */
301function tpl_button($type){
302  global $ACT;
303  global $ID;
304  global $NS;
305  global $INFO;
306  global $conf;
307  global $auth;
308
309  switch($type){
310    case 'edit':
311      print html_editbutton();
312      break;
313    case 'history':
314      print html_btn('revs',$ID,'o',array('do' => 'revisions'));
315      break;
316    case 'recent':
317      print html_btn('recent','','r',array('do' => 'recent'));
318      break;
319    case 'index':
320      print html_btn('index',$ID,'x',array('do' => 'index'));
321      break;
322    case 'back':
323      if ($parent = tpl_getparent($ID)) {
324        print html_btn('back',$parent,'b',array('do' => 'show'));
325      }
326      break;
327    case 'top':
328      print html_topbtn();
329      break;
330    case 'login':
331      if($conf['useacl']){
332        if($_SERVER['REMOTE_USER']){
333          print html_btn('logout',$ID,'',array('do' => 'logout',));
334        }else{
335          print html_btn('login',$ID,'',array('do' => 'login'));
336        }
337      }
338      break;
339    case 'admin':
340      if($INFO['perm'] == AUTH_ADMIN)
341        print html_btn('admin',$ID,'',array('do' => 'admin'));
342      break;
343    case 'backtomedia':
344      print html_backtomedia_button(array('ns' => $NS),'b');
345      break;
346    case 'subscription':
347      if($conf['useacl'] && $ACT == 'show' && $conf['subscribers'] == 1){
348        if($_SERVER['REMOTE_USER']){
349          if($INFO['subscribed']){
350            print html_btn('unsubscribe',$ID,'',array('do' => 'unsubscribe',));
351          } else {
352            print html_btn('subscribe',$ID,'',array('do' => 'subscribe',));
353          }
354        }
355      }
356      break;
357    case 'backlink':
358      print html_btn('backlink',$ID,'',array('do' => 'backlink'));
359      break;
360    case 'profile':
361      if($conf['useacl'] && $_SERVER['REMOTE_USER'] &&
362         $auth->canDo('Profile') && ($ACT!='profile')){
363        print html_btn('profile',$ID,'',array('do' => 'profile'));
364      }
365      break;
366    default:
367      print '[unknown button type]';
368  }
369}
370
371/**
372 * Like the action buttons but links
373 *
374 * Available links are
375 *
376 *  edit    - edit/create/show button
377 *  history - old revisions
378 *  recent  - recent changes
379 *  login   - login/logout button - if ACL enabled
380 *  index   - The index
381 *  admin   - admin page - if enough rights
382 *  top     - a back to top button
383 *  back    - a back to parent button - if available
384 * backlink - links to the list of backlinks
385 *
386 * @author Andreas Gohr <andi@splitbrain.org>
387 * @author Matthias Grimm <matthiasgrimm@users.sourceforge.net>
388 * @see    tpl_button
389 */
390function tpl_actionlink($type,$pre='',$suf=''){
391  global $ID;
392  global $INFO;
393  global $REV;
394  global $ACT;
395  global $conf;
396  global $lang;
397  global $auth;
398
399  switch($type){
400    case 'edit':
401      #most complicated type - we need to decide on current action
402      if($ACT == 'show' || $ACT == 'search'){
403        if($INFO['writable']){
404          if($INFO['exists']){
405            tpl_link(wl($ID,'do=edit&amp;rev='.$REV),
406                     $pre.$lang['btn_edit'].$suf,
407                     'class="action edit" accesskey="e" rel="nofollow"');
408          }else{
409            tpl_link(wl($ID,'do=edit&amp;rev='.$REV),
410                     $pre.$lang['btn_create'].$suf,
411                     'class="action create" accesskey="e" rel="nofollow"');
412          }
413        }else{
414          tpl_link(wl($ID,'do=edit&amp;rev='.$REV),
415                   $pre.$lang['btn_source'].$suf,
416                   'class="action source" accesskey="v" rel="nofollow"');
417        }
418      }else{
419          tpl_link(wl($ID,'do=show'),
420                   $pre.$lang['btn_show'].$suf,
421                   'class="action show" accesskey="v" rel="nofollow"');
422      }
423      break;
424    case 'history':
425      tpl_link(wl($ID,'do=revisions'),$pre.$lang['btn_revs'].$suf,'class="action revisions" accesskey="o"');
426      break;
427    case 'recent':
428      tpl_link(wl($ID,'do=recent'),$pre.$lang['btn_recent'].$suf,'class="action recent" accesskey="r"');
429      break;
430    case 'index':
431      tpl_link(wl($ID,'do=index'),$pre.$lang['btn_index'].$suf,'class="action index" accesskey="x"');
432      break;
433    case 'top':
434      print '<a href="#dokuwiki__top" class="action top" accesskey="x">'.$pre.$lang['btn_top'].$suf.'</a>';
435      break;
436    case 'back':
437      if ($ID = tpl_getparent($ID)) {
438        tpl_link(wl($ID,'do=show'),$pre.$lang['btn_back'].$suf,'class="action back" accesskey="b"');
439      }
440      break;
441    case 'login':
442      if($conf['useacl']){
443        if($_SERVER['REMOTE_USER']){
444          tpl_link(wl($ID,'do=logout'),$pre.$lang['btn_logout'].$suf,'class="action logout"');
445        }else{
446          tpl_link(wl($ID,'do=login'),$pre.$lang['btn_login'].$suf,'class="action logout"');
447        }
448      }
449      break;
450    case 'admin':
451      if($INFO['perm'] == AUTH_ADMIN)
452        tpl_link(wl($ID,'do=admin'),$pre.$lang['btn_admin'].$suf,'class="action admin"');
453      break;
454   case 'subscribe':
455   case 'subscription':
456      if($conf['useacl'] && $ACT == 'show' && $conf['subscribers'] == 1){
457        if($_SERVER['REMOTE_USER']){
458          if($INFO['subscribed']) {
459            tpl_link(wl($ID,'do=unsubscribe'),$pre.$lang['btn_unsubscribe'].$suf,'class="action unsubscribe"');
460          } else {
461            tpl_link(wl($ID,'do=subscribe'),$pre.$lang['btn_subscribe'].$suf,'class="action subscribe"');
462          }
463        }
464      }
465      break;
466    case 'backlink':
467      tpl_link(wl($ID,'do=backlink'),$pre.$lang['btn_backlink'].$suf, 'class="action backlink"');
468      break;
469    case 'profile':
470      if($conf['useacl'] && $_SERVER['REMOTE_USER'] &&
471         $auth->canDo('Profile') && ($ACT!='profile')){
472        tpl_link(wl($ID,'do=profile'),$pre.$lang['btn_profile'].$suf, 'class="action profile"');
473      }
474      break;
475    default:
476      print '[unknown link type]';
477  }
478}
479
480/**
481 * Print the search form
482 *
483 * If the first parameter is given a div with the ID 'qsearch_out' will
484 * be added which instructs the ajax pagequicksearch to kick in and place
485 * its output into this div. The second parameter controls the propritary
486 * attribute autocomplete. If set to false this attribute will be set with an
487 * value of "off" to instruct the browser to disable it's own built in
488 * autocompletion feature (MSIE and Firefox)
489 *
490 * @author Andreas Gohr <andi@splitbrain.org>
491 */
492function tpl_searchform($ajax=true,$autocomplete=true){
493  global $lang;
494  global $ACT;
495
496  print '<form action="'.wl().'" accept-charset="utf-8" class="search" id="dw__search"><div class="no">';
497  print '<input type="hidden" name="do" value="search" />';
498  print '<input type="text" ';
499  if($ACT == 'search') print 'value="'.htmlspecialchars($_REQUEST['id']).'" ';
500  if(!$autocomplete) print 'autocomplete="off" ';
501  print 'id="qsearch__in" accesskey="f" name="id" class="edit" />';
502  print '<input type="submit" value="'.$lang['btn_search'].'" class="button" />';
503  if($ajax) print '<div id="qsearch__out" class="ajax_qsearch JSpopup"></div>';
504  print '</div></form>';
505}
506
507/**
508 * Print the breadcrumbs trace
509 *
510 * @author Andreas Gohr <andi@splitbrain.org>
511 */
512function tpl_breadcrumbs(){
513  global $lang;
514  global $conf;
515
516  //check if enabled
517  if(!$conf['breadcrumbs']) return;
518
519  $crumbs = breadcrumbs(); //setup crumb trace
520
521  //reverse crumborder in right-to-left mode
522  if($lang['direction'] == 'rtl') $crumbs = array_reverse($crumbs,true);
523
524  //render crumbs, highlight the last one
525  print $lang['breadcrumb'].':';
526  $last = count($crumbs);
527  $i = 0;
528  foreach ($crumbs as $id => $name){
529    $i++;
530    print ' <span class="bcsep">&raquo;</span> ';
531    if ($i == $last) print '<span class="curid">';
532    tpl_link(wl($id),$name,'class="breadcrumbs" title="'.$id.'"');
533    if ($i == $last) print '</span>';
534  }
535}
536
537/**
538 * Hierarchical breadcrumbs
539 *
540 * This code was suggested as replacement for the usual breadcrumbs.
541 * It only makes sense with a deep site structure.
542 *
543 * @author Andreas Gohr <andi@splitbrain.org>
544 * @author Nigel McNie <oracle.shinoda@gmail.com>
545 * @author Sean Coates <sean@caedmon.net>
546 * @link   http://wiki.splitbrain.org/wiki:tipsandtricks:hierarchicalbreadcrumbs
547 * @todo   May behave strangely in RTL languages
548 */
549function tpl_youarehere(){
550  global $conf;
551  global $ID;
552  global $lang;
553
554  //check if enabled
555  if(!$conf['youarehere']) return;
556
557  $parts     = explode(':', $ID);
558
559  print $lang['youarehere'].': ';
560
561  //always print the startpage
562  if( $a_part[0] != $conf['start']){
563    if($conf['useheading']){
564      $pageName = p_get_first_heading($conf['start']);
565    }else{
566      $pageName = $conf['start'];
567    }
568    tpl_link(wl($conf['start']),$pageName,'title="'.$pageName.'"');
569  }
570
571  $page = '';
572  foreach ($parts as $part){
573        // Skip startpage if already done
574        if ($part == $conf['start']) continue;
575
576          print ' &raquo; ';
577    $page .= $part;
578
579    if(file_exists(wikiFN($page))){
580      if($conf['useheading']){
581        $pageName = p_get_first_heading($page);
582        $partName = $pageName;
583      }else{
584        $pageName = $page;
585        $partName = $part;
586      }
587      tpl_link(wl($page),$partName,'title="'.$pageName.'"');
588    }else{
589      // Print the link, but mark as not-existing, as for other non-existing links
590      tpl_link(wl($page),$part,'title="'.$page.'" class="wikilink2"');
591      //print $page;
592    }
593
594    $page .= ':';
595  }
596}
597
598/**
599 * Print info if the user is logged in
600 * and show full name in that case
601 *
602 * Could be enhanced with a profile link in future?
603 *
604 * @author Andreas Gohr <andi@splitbrain.org>
605 */
606function tpl_userinfo(){
607  global $lang;
608  global $INFO;
609  if($_SERVER['REMOTE_USER'])
610    print $lang['loggedinas'].': '.$INFO['userinfo']['name'];
611}
612
613/**
614 * Print some info about the current page
615 *
616 * @author Andreas Gohr <andi@splitbrain.org>
617 */
618function tpl_pageinfo(){
619  global $conf;
620  global $lang;
621  global $INFO;
622  global $REV;
623
624  // prepare date and path
625  $fn = $INFO['filepath'];
626  if(!$conf['fullpath']){
627    if($REV){
628      $fn = str_replace(realpath($conf['olddir']).DIRECTORY_SEPARATOR,'',$fn);
629    }else{
630      $fn = str_replace(realpath($conf['datadir']).DIRECTORY_SEPARATOR,'',$fn);
631    }
632  }
633  $fn = utf8_decodeFN($fn);
634  $date = date($conf['dformat'],$INFO['lastmod']);
635
636  // print it
637  if($INFO['exists']){
638    print $fn;
639    print ' &middot; ';
640    print $lang['lastmod'];
641    print ': ';
642    print $date;
643    if($INFO['editor']){
644      print ' '.$lang['by'].' ';
645      print $INFO['editor'];
646    }
647    if($INFO['locked']){
648      print ' &middot; ';
649      print $lang['lockedby'];
650      print ': ';
651      print $INFO['locked'];
652    }
653  }
654}
655
656/**
657 * Print a list of namespaces containing media files
658 *
659 * @author Andreas Gohr <andi@splitbrain.org>
660 */
661function tpl_medianamespaces(){
662    global $conf;
663
664  $data = array();
665  search($data,$conf['mediadir'],'search_namespaces',array());
666  print html_buildlist($data,'idx',media_html_list_namespaces);
667}
668
669/**
670 * Print a list of mediafiles in the current namespace
671 *
672 * @author Andreas Gohr <andi@splitbrain.org>
673 */
674function tpl_mediafilelist(){
675  global $conf;
676  global $lang;
677  global $NS;
678  global $AUTH;
679  $dir = utf8_encodeFN(str_replace(':','/',$NS));
680
681  $data = array();
682  search($data,$conf['mediadir'],'search_media',array(),$dir);
683
684  if(!count($data)){
685    ptln('<div class="nothing">'.$lang['nothingfound'].'</div>');
686    return;
687  }
688
689  ptln('<ul>',2);
690  foreach($data as $item){
691    if(!$item['isimg']){
692      // add file icons
693      list($ext,$mime) = mimetype($item['file']);
694      $class = preg_replace('/[^_\-a-z0-9]+/i','_',$ext);
695      $class = ' class="mediafile mf_'.$class.'"';
696    }else{
697      $class = '';
698    }
699
700    ptln('<li><div class="li">',4);
701    ptln('<a href="javascript:mediaSelect(\':'.$item['id'].'\')"'.$class.'>'.
702         utf8_decodeFN($item['file']).
703         '</a>',6);
704
705    //prepare deletion button
706    if($AUTH >= AUTH_DELETE){
707      $ask  = addslashes($lang['del_confirm']).'\\n';
708      $ask .= addslashes($item['id']);
709
710      $del = '<a href="'.DOKU_BASE.'lib/exe/media.php?delete='.rawurlencode($item['id']).'" '.
711             'onclick="return confirm(\''.$ask.'\')" onkeypress="return confirm(\''.$ask.'\')">'.
712             '<img src="'.DOKU_BASE.'lib/images/del.png" alt="'.$lang['btn_delete'].'" '.
713             'title="'.$lang['btn_delete'].'" /></a>';
714    }else{
715      $del = '';
716    }
717
718    if($item['isimg']){
719      $w = (int) $item['meta']->getField('File.Width');
720      $h = (int) $item['meta']->getField('File.Height');
721
722      ptln('('.$w.'&#215;'.$h.' '.filesize_h($item['size']).')',6);
723      ptln($del.'<br />',6);
724      ptln('<div class="imagemeta">',6);
725
726      //build thumbnail
727      print '<a href="javascript:mediaSelect(\':'.$item['id'].'\')">';
728
729      if($w>120 || $h>120){
730        $ratio = $item['meta']->getResizeRatio(120);
731        $w = floor($w * $ratio);
732        $h = floor($h * $ratio);
733      }
734
735      $src = ml($item['id'],array('w'=>$w,'h'=>$h));
736
737      $p = array();
738      $p['width']  = $w;
739      $p['height'] = $h;
740      $p['alt']    = $item['id'];
741      $p['class']  = 'thumb';
742      $att = buildAttributes($p);
743
744      print '<img src="'.$src.'" '.$att.' />';
745      print '</a>';
746
747      //read EXIF/IPTC data
748      $t = $item['meta']->getField('IPTC.Headline');
749      if($t) print '<strong>'.htmlspecialchars($t).'</strong><br />';
750
751      $t = $item['meta']->getField(array('IPTC.Caption','EXIF.UserComment',
752                                         'EXIF.TIFFImageDescription',
753                                         'EXIF.TIFFUserComment'));
754      if($t) print htmlspecialchars($t).'<br />';
755
756      $t = $item['meta']->getField(array('IPTC.Keywords','IPTC.Category'));
757      if($t) print '<em>'.htmlspecialchars($t).'</em><br />';
758
759      //add edit button
760      if($AUTH >= AUTH_UPLOAD && $item['meta']->getField('File.Mime') == 'image/jpeg'){
761        print '<a href="'.DOKU_BASE.'lib/exe/media.php?edit='.rawurlencode($item['id']).'">';
762        print '<img src="'.DOKU_BASE.'lib/images/edit.gif" alt="'.$lang['metaedit'].'" title="'.$lang['metaedit'].'" />';
763        print '</a>';
764      }
765
766      ptln('</div>',6);
767    }else{
768      ptln ('('.filesize_h($item['size']).')',6);
769      ptln($del,6);
770    }
771    ptln('</div></li>',4);
772  }
773  ptln('</ul>',2);
774}
775
776/**
777 * show references to a media file
778 * References uses the same visual as search results and share
779 * their CSS tags except pagenames won't be links.
780 *
781 * @author Matthias Grimm <matthiasgrimm@users.sourceforge.net>
782 */
783function tpl_showreferences(&$data){
784  global $lang;
785
786  $hidden=0; //count of hits without read permission
787
788  if(count($data)){
789    usort($data,'sort_search_fulltext');
790    foreach($data as $row){
791      if(auth_quickaclcheck($row['id']) >= AUTH_READ){
792        print '<div class="search_result">';
793        print '<span class="mediaref_ref">'.$row['id'].'</span>';
794        print ': <span class="search_cnt">'.$row['count'].' '.$lang['hits'].'</span><br />';
795        print '<div class="search_snippet">'.$row['snippet'].'</div>';
796        print '</div>';
797      }else
798        $hidden++;
799    }
800    if ($hidden){
801      print '<div class="mediaref_hidden">'.$lang['ref_hidden'].'</div>';
802    }
803  }
804}
805
806/**
807 * Print the media upload form if permissions are correct
808 *
809 * @author Andreas Gohr <andi@splitbrain.org>
810 */
811function tpl_mediauploadform(){
812  global $NS;
813  global $UPLOADOK;
814  global $AUTH;
815  global $lang;
816
817  if(!$UPLOADOK) return;
818
819  ptln('<form action="'.DOKU_BASE.'lib/exe/media.php" id="dw__upload"'.
820       ' method="post" enctype="multipart/form-data">',2);
821  ptln($lang['txt_upload'].':<br />',4);
822  ptln('<input type="file" name="upload" class="edit" onchange="suggestWikiname();" />',4);
823  ptln('<input type="hidden" name="ns" value="'.hsc($NS).'" /><br />',4);
824  ptln($lang['txt_filename'].'<br />',4);
825  ptln('<input type="text" name="id" class="edit" />',4);
826  ptln('<input type="submit" class="button" value="'.$lang['btn_upload'].'" accesskey="s" />',4);
827  if($AUTH >= AUTH_DELETE){
828    ptln('<label for="dw__ow"><input type="checkbox" name="ow" value="1" id="dw__ow" />'.$lang['txt_overwrt'].'</label>',4);
829  }
830  ptln('</form>',2);
831}
832
833/**
834 * Prints or returns the name of the given page (current one if none given).
835 *
836 * If useheading is enabled this will use the first headline else
837 * the given ID is used.
838 *
839 * @author Andreas Gohr <andi@splitbrain.org>
840 */
841function tpl_pagetitle($id=null, $ret=false){
842  global $conf;
843  if(is_null($id)){
844    global $ID;
845    $id = $ID;
846  }
847
848  $name = $id;
849  if ($conf['useheading']) {
850    $title = p_get_first_heading($id);
851    if ($title) $name = $title;
852  }
853
854  if ($ret) {
855      return hsc($name);
856  } else {
857      print hsc($name);
858  }
859}
860
861/**
862 * Returns the requested EXIF/IPTC tag from the current image
863 *
864 * If $tags is an array all given tags are tried until a
865 * value is found. If no value is found $alt is returned.
866 *
867 * Which texts are known is defined in the functions _exifTagNames
868 * and _iptcTagNames() in inc/jpeg.php (You need to prepend IPTC
869 * to the names of the latter one)
870 *
871 * Only allowed in: detail.php, mediaedit.php
872 *
873 * @author Andreas Gohr <andi@splitbrain.org>
874 */
875function tpl_img_getTag($tags,$alt=''){
876  // Init Exif Reader
877  global $SRC;
878  static $meta = null;
879  if(is_null($meta)) $meta = new JpegMeta($SRC);
880  if($meta === false) return $alt;
881  $info = $meta->getField($tags);
882  if($info == false) return $alt;
883  return $info;
884}
885
886/**
887 * Prints the image with a link to the full sized version
888 *
889 * Only allowed in: detail.php
890 */
891function tpl_img($maxwidth=0,$maxheight=0){
892  global $IMG;
893  $w = tpl_img_getTag('File.Width');
894  $h = tpl_img_getTag('File.Height');
895
896  //resize to given max values
897  $ratio = 1;
898  if($w >= $h){
899    if($maxwidth && $w >= $maxwidth){
900      $ratio = $maxwidth/$w;
901    }elseif($maxheight && $h > $maxheight){
902      $ratio = $maxheight/$h;
903    }
904  }else{
905    if($maxheight && $h >= $maxheight){
906      $ratio = $maxheight/$h;
907    }elseif($maxwidth && $w > $maxwidth){
908      $ratio = $maxwidth/$w;
909    }
910  }
911  if($ratio){
912    $w = floor($ratio*$w);
913    $h = floor($ratio*$h);
914  }
915
916  //prepare URLs
917  $url=ml($IMG,array('cache'=>$_REQUEST['cache']));
918  $src=ml($IMG,array('cache'=>$_REQUEST['cache'],'w'=>$w,'h'=>$h));
919
920  //prepare attributes
921  $alt=tpl_img_getTag('Simple.Title');
922  $p = array();
923  if($w) $p['width']  = $w;
924  if($h) $p['height'] = $h;
925         $p['class']  = 'img_detail';
926  if($alt){
927    $p['alt']   = $alt;
928    $p['title'] = $alt;
929  }else{
930    $p['alt'] = '';
931  }
932  $p = buildAttributes($p);
933
934  print '<a href="'.$url.'">';
935  print '<img src="'.$src.'" '.$p.'/>';
936  print '</a>';
937}
938
939/**
940 * This function inserts a 1x1 pixel gif which in reality
941 * is the inexer function.
942 *
943 * Should be called somewhere at the very end of the main.php
944 * template
945 */
946function tpl_indexerWebBug(){
947  global $ID;
948  global $INFO;
949  if(!$INFO['exists']) return;
950
951  if(isHiddenPage($ID)) return; //no need to index hidden pages
952
953  $p = array();
954  $p['src']    = DOKU_BASE.'lib/exe/indexer.php?id='.rawurlencode($ID).
955                 '&'.time();
956  $p['width']  = 1;
957  $p['height'] = 1;
958  $p['alt']    = '';
959  $att = buildAttributes($p);
960  print "<img $att />";
961}
962
963// configuration methods
964/**
965 * tpl_getConf($id)
966 *
967 * use this function to access template configuration variables
968 */
969function tpl_getConf($id){
970  global $conf;
971  global $tpl_configloaded;
972
973  $tpl = $conf['template'];
974
975  if (!$tpl_configloaded){
976    $tconf = tpl_loadConfig();
977    if ($tconf !== false){
978      foreach ($tconf as $key => $value){
979        if (isset($conf['tpl'][$tpl][$key])) continue;
980        $conf['tpl'][$tpl][$key] = $value;
981      }
982      $tpl_configloaded = true;
983    }
984  }
985
986  return $conf['tpl'][$tpl][$id];
987}
988
989/**
990 * tpl_loadConfig()
991 * reads all template configuration variables
992 * this function is automatically called by tpl_getConf()
993 */
994function tpl_loadConfig(){
995
996  $file = DOKU_TPLINC.'/conf/default.php';
997  $conf = array();
998
999  if (!@file_exists($file)) return false;
1000
1001  // load default config file
1002  include($file);
1003
1004  return $conf;
1005}
1006
1007//Setup VIM: ex: et ts=2 enc=utf-8 :
1008