wiki:xref:dokuwiki:inc:template.php
1<?php 2 3 /** 4 * Функции шаблонов DokuWiki 5 * 6 * @license GPL 2 (http://www.gnu.org/licenses/gpl.html) 7 * @author Andreas Gohr <andi@splitbrain.org> 8 */ 9 10 use dokuwiki\ActionRouter; 11 use dokuwiki\Action\Exception\FatalException; 12 use dokuwiki\Extension\PluginInterface; 13 use dokuwiki\Ui\Admin; 14 use dokuwiki\StyleUtils; 15 use dokuwiki\Menu\Item\AbstractItem; 16 use dokuwiki\Form\Form; 17 use dokuwiki\Menu\MobileMenu; 18 use dokuwiki\Ui\Subscribe; 19 use dokuwiki\Extension\AdminPlugin; 20 use dokuwiki\Extension\Event; 21 use dokuwiki\File\PageResolver; 22 23/** 24* Доступ к файлу шаблона 25* 26* Возвращает путь к указанному файлу внутри текущего шаблона, использует 27* шаблон по умолчанию, если пользовательская версия не существует. 28* 29* @param string $ файл 30* @возвращаемая строка 31* 32* @автор Андреас Гор <andi@splitbrain.org> 33*/ 34 function template($file) 35 { 36 global $conf; 37 38 if (@is_readable(DOKU_INC . 'lib/tpl/' . $conf['template'] . '/' . $file)) 39 return DOKU_INC . 'lib/tpl/' . $conf['template'] . '/' . $file; 40 41 return DOKU_INC . 'lib/tpl/dokuwiki/' . $file; 42 } 43 44/** 45* Удобная функция для доступа к каталогу шаблонов из локальной ФС 46* 47* Заменяет устаревшую константу DOKU_TPLINC. 48* 49* @param string $ tpl Шаблон для использования, по умолчанию текущий 50* @возвращаемая строка 51* 52* @автор Андреас Гор <andi@splitbrain.org> 53*/ 54 function tpl_incdir($tpl = '') 55 { 56 global $conf; 57 if (!$tpl) $tpl = $conf['template']; 58 return DOKU_INC . 'lib/tpl/' . $tpl . '/'; 59 } 60 61/** 62* Удобная функция доступа к каталогу шаблонов из Интернета 63* 64* Заменяет устаревшую константу DOKU_TPL 65* 66* @param string $ tpl Шаблон для использования, по умолчанию текущий 67* @возвращаемая строка 68* 69* @автор Андреас Гор <andi@splitbrain.org> 70*/ 71 function tpl_basedir($tpl = '') 72 { 73 global $conf; 74 if (!$tpl) $tpl = $conf['template']; 75 return DOKU_BASE . 'lib/tpl/' . $tpl . '/'; 76 } 77 78/** 79* Распечатать содержимое 80* 81* Эта функция используется для печати всего обычного контента. 82* (определяется глобальной переменной $ACT) путем вызова соответствующего 83* выходные функции из html.php 84* 85* Все, что не использует основной файл шаблона, не 86* обрабатывается этой функцией. ACL-списки здесь тоже не обрабатываются. 87* 88* @param bool $ prependTOC следует ли здесь отображать оглавление? 89* @return bool true, если есть какой-либо вывод 90* 91* @triggers TPL_ACT_RENDER 92* @triggers TPL_CONTENT_DISPLAY 93* @автор Андреас Гор <andi@splitbrain.org> 94*/ 95 function tpl_content($prependTOC = true) 96 { 97 global $ACT; 98 global $INFO; 99 $INFO['prependTOC'] = $prependTOC; 100 101 ob_start(); 102 Event::createAndTrigger('TPL_ACT_RENDER', $ACT, 'tpl_content_core'); 103 $html_output = ob_get_clean(); 104 Event::createAndTrigger('TPL_CONTENT_DISPLAY', $html_output, function ($html_output) { 105 echo $html_output; 106 }); 107 108 return !empty($html_output); 109 } 110 111/** 112* Действие по умолчанию TPL_ACT_RENDER 113* 114* @return bool 115*/ 116 function tpl_content_core() 117 { 118 $router = ActionRouter::getInstance(); 119 try { 120 $router->getAction()->tplContent(); 121 } catch (FatalException $e) { 122 // there was no content for the action 123 msg(hsc($e->getMessage()), -1); 124 return false; 125 } 126 return true; 127 } 128 129/** 130* Размещает оглавление там, где вызывается функция 131* 132* Если вы используете это, вы, скорее всего, захотите вызвать tpl_content с помощью 133* ложный аргумент 134* 135* @param bool $ return Следует ли вернуть оглавление вместо его печати? 136* @возвращаемая строка 137* 138* @автор Андреас Гор <andi@splitbrain.org> 139*/ 140 function tpl_toc($return = false) 141 { 142 global $TOC; 143 global $ACT; 144 global $ID; 145 global $REV; 146 global $INFO; 147 global $conf; 148 $toc = []; 149 150 if (is_array($TOC)) { 151 // if a TOC was prepared in global scope, always use it 152 $toc = $TOC; 153 } elseif (($ACT == 'show' || str_starts_with($ACT, 'export')) && !$REV && $INFO['exists']) { 154 // get TOC from metadata, render if neccessary 155 $meta = p_get_metadata($ID, '', METADATA_RENDER_USING_CACHE); 156 $tocok = $meta['internal']['toc'] ?? true; 157 $toc = $meta['description']['tableofcontents'] ?? null; 158 if (!$tocok || !is_array($toc) || !$conf['tocminheads'] || count($toc) < $conf['tocminheads']) { 159 $toc = []; 160 } 161 } elseif ($ACT == 'admin') { 162 // try to load admin plugin TOC 163 /** @var AdminPlugin $plugin */ 164 if ($plugin = plugin_getRequestAdminPlugin()) { 165 $toc = $plugin->getTOC(); 166 $TOC = $toc; // avoid later rebuild 167 } 168 } 169 170 Event::createAndTrigger('TPL_TOC_RENDER', $toc, null, false); 171 $html = html_TOC($toc); 172 if ($return) return $html; 173 echo $html; 174 return ''; 175 } 176 177/** 178* Обработка содержимого страницы администратора 179* 180* @return bool 181* 182* @автор Андреас Гор <andi@splitbrain.org> 183*/ 184 function tpl_admin() 185 { 186 global $INFO; 187 global $TOC; 188 global $INPUT; 189 190 $plugin = null; 191 $class = $INPUT->str('page'); 192 if (!empty($class)) { 193 $pluginlist = plugin_list('admin'); 194 195 if (in_array($class, $pluginlist)) { 196 // attempt to load the plugin 197 /** @var AdminPlugin $plugin */ 198 $plugin = plugin_load('admin', $class); 199 } 200 } 201 202 if ($plugin instanceof PluginInterface) { 203 if (!is_array($TOC)) $TOC = $plugin->getTOC(); //if TOC wasn't requested yet 204 if ($INFO['prependTOC']) tpl_toc(); 205 $plugin->html(); 206 } else { 207 $admin = new Admin(); 208 $admin->show(); 209 } 210 return true; 211 } 212 213/** 214* Распечатайте правильные HTML-мета-заголовки 215* 216* Это необходимо разместить в заголовке вашего шаблона. 217* 218* @param bool $ alt Нужно ли добавлять каналы и ссылки альтернативного формата? 219* @return bool 220* @вызывает JsonException 221* 222* @автор Андреас Гор <andi@splitbrain.org> 223* @triggers TPL_METAHEADER_OUTPUT 224*/ 225 function tpl_metaheaders($alt = true) 226 { 227 global $ID; 228 global $REV; 229 global $INFO; 230 global $JSINFO; 231 global $ACT; 232 global $QUERY; 233 global $lang; 234 global $conf; 235 global $updateVersion; 236 /** @var Input $INPUT */ 237 global $INPUT; 238 239 // подготавливаем массив головок 240 $head = []; 241 242 // подготовить seed для js и css 243 $tseed = $updateVersion; 244 $depends = getConfigFiles('main'); 245 $depends[] = DOKU_CONF . "tpl/" . $conf['template'] . "/style.ini"; 246 foreach ($depends as $f) $tseed .= @filemtime($f); 247 $tseed = md5($tseed); 248 249 // обычные вещи 250 $head['meta'][] = ['name' => 'generator', 'content' => 'DokuWiki']; 251 if (actionOK('search')) { 252 $head['link'][] = [ 253 'rel' => 'search', 254 'type' => 'application/opensearchdescription+xml', 255 'href' => DOKU_BASE . 'lib/exe/opensearch.php', 256 'title' => $conf['title'] 257 ]; 258 } 259 260 $head['link'][] = ['rel' => 'start', 'href' => DOKU_BASE]; 261 if (actionOK('index')) { 262 $head['link'][] = [ 263 'rel' => 'contents', 264 'href' => wl($ID, 'do=index', false, '&'), 265 'title' => $lang['btn_index'] 266 ]; 267 } 268 269 if (actionOK('manifest')) { 270 $head['link'][] = [ 271 'rel' => 'manifest', 272 'href' => DOKU_BASE . 'lib/exe/manifest.php' 273 ]; 274 } 275 276 $styleUtil = new StyleUtils(); 277 $styleIni = $styleUtil->cssStyleini(); 278 $replacements = $styleIni['replacements']; 279 if (!empty($replacements['__theme_color__'])) { 280 $head['meta'][] = [ 281 'name' => 'theme-color', 282 'content' => $replacements['__theme_color__'] 283 ]; 284 } 285 286 if ($alt) { 287 if (actionOK('rss')) { 288 $head['link'][] = [ 289 'rel' => 'alternate', 290 'type' => 'application/rss+xml', 291 'title' => $lang['btn_recent'], 292 'href' => DOKU_BASE . 'feed.php' 293 ]; 294 $head['link'][] = [ 295 'rel' => 'alternate', 296 'type' => 'application/rss+xml', 297 'title' => $lang['currentns'], 298 'href' => DOKU_BASE . 'feed.php?mode=list&ns=' . (isset($INFO) ? $INFO['namespace'] : '') 299 ]; 300 } 301 if (($ACT == 'show' || $ACT == 'search') && $INFO['writable']) { 302 $head['link'][] = [ 303 'rel' => 'edit', 304 'title' => $lang['btn_edit'], 305 'href' => wl($ID, 'do=edit', false, '&') 306 ]; 307 } 308 309 if (actionOK('rss') && $ACT == 'search') { 310 $head['link'][] = [ 311 'rel' => 'alternate', 312 'type' => 'application/rss+xml', 313 'title' => $lang['searchresult'], 314 'href' => DOKU_BASE . 'feed.php?mode=search&q=' . $QUERY 315 ]; 316 } 317 318 if (actionOK('export_xhtml')) { 319 $head['link'][] = [ 320 'rel' => 'alternate', 321 'type' => 'text/html', 322 'title' => $lang['plainhtml'], 323 'href' => exportlink($ID, 'xhtml', '', false, '&') 324 ]; 325 } 326 327 if (actionOK('export_raw')) { 328 $head['link'][] = [ 329 'rel' => 'alternate', 330 'type' => 'text/plain', 331 'title' => $lang['wikimarkup'], 332 'href' => exportlink($ID, 'raw', '', false, '&') 333 ]; 334 } 335 } 336 337 // настройка тегов робота, подходящих для разных режимов 338 if (($ACT == 'show' || $ACT == 'export_xhtml') && !$REV) { 339 if ($INFO['exists']) { 340 //delay indexing: 341 if ((time() - $INFO['lastmod']) >= $conf['indexdelay'] && !isHiddenPage($ID)) { 342 $head['meta'][] = ['name' => 'robots', 'content' => 'index,follow']; 343 } else { 344 $head['meta'][] = ['name' => 'robots', 'content' => 'noindex,nofollow']; 345 } 346 $canonicalUrl = wl($ID, '', true, '&'); 347 if ($ID == $conf['start']) { 348 $canonicalUrl = DOKU_URL; 349 } 350 $head['link'][] = ['rel' => 'canonical', 'href' => $canonicalUrl]; 351 } else { 352 $head['meta'][] = ['name' => 'robots', 'content' => 'noindex,follow']; 353 } 354 } elseif (defined('DOKU_MEDIADETAIL')) { 355 $head['meta'][] = ['name' => 'robots', 'content' => 'index,follow']; 356 } else { 357 $head['meta'][] = ['name' => 'robots', 'content' => 'noindex,nofollow']; 358 } 359 360 // установить метаданные 361 if ($ACT == 'show' || $ACT == 'export_xhtml') { 362 // keywords (explicit or implicit) 363 if (!empty($INFO['meta']['subject'])) { 364 $head['meta'][] = ['name' => 'keywords', 'content' => implode(',', $INFO['meta']['subject'])]; 365 } else { 366 $head['meta'][] = ['name' => 'keywords', 'content' => str_replace(':', ',', $ID)]; 367 } 368 } 369 370 // загрузка таблиц стилей 371 $head['link'][] = [ 372 'rel' => 'stylesheet', 373 'href' => DOKU_BASE . 'lib/exe/css.php?t=' . rawurlencode($conf['template']) . '&tseed=' . $tseed 374 ]; 375 376 $script = "var NS='" . (isset($INFO) ? $INFO['namespace'] : '') . "';"; 377 if ($conf['useacl'] && $INPUT->server->str('REMOTE_USER')) { 378 $script .= "var SIG=" . toolbar_signature() . ";"; 379 } 380 jsinfo(); 381 $script .= 'var JSINFO = ' . json_encode($JSINFO, JSON_THROW_ON_ERROR) . ';'; 382 $script .= '(function(H){H.className=H.className.replace(/\bno-js\b/,\'js\')})(document.documentElement);'; 383 $head['script'][] = ['_data' => $script]; 384 385 // загрузить jquery 386 $jquery = getCdnUrls(); 387 foreach ($jquery as $src) { 388 $head['script'][] = [ 389 '_data' => '', 390 'src' => $src 391 ] + ($conf['defer_js'] ? ['defer' => 'defer'] : []); 392 } 393 394 // загружаем наш диспетчер javascript 395 $head['script'][] = [ 396 '_data' => '', 397 'src' => DOKU_BASE . 'lib/exe/js.php' . '?t=' . rawurlencode($conf['template']) . '&tseed=' . $tseed 398 ] + ($conf['defer_js'] ? ['defer' => 'defer'] : []); 399 400 // вызвать событие здесь 401 Event::createAndTrigger('TPL_METAHEADER_OUTPUT', $head, '_tpl_metaheaders_action', true); 402 return true; 403 } 404 405/** 406* печатает массив, созданный tpl_metaheaders 407* 408* $data — это массив различных тегов заголовков. Каждый тег может иметь несколько 409* экземпляры. Атрибуты задаются как пары ключ-значение. Значения будут HTML 410* кодируются автоматически, поэтому их следует предоставлять как есть в массиве $data. 411* 412* Для тегов, имеющих атрибут body, укажите данные body в специальном поле 413* атрибут '_data'. Это поле НЕ БУДЕТ ЭКРАНИРОВАНО автоматически. 414* 415* Встроенные скрипты будут использовать любой одноразовый номер, указанный в переменной среды «NONCE». 416* 417* @param массив $ данные 418* 419* @автор Андреас Гор <andi@splitbrain.org> 420*/ 421 function _tpl_metaheaders_action($data) 422 { 423 $nonce = getenv('NONCE'); 424 foreach ($data as $tag => $inst) { 425 foreach ($inst as $attr) { 426 if (empty($attr)) { 427 continue; 428 } 429 if ($nonce && $tag == 'script' && !empty($attr['_data'])) { 430 $attr['nonce'] = $nonce; // add nonce to inline script tags 431 } 432 echo '<', $tag, ' ', buildAttributes($attr); 433 if (isset($attr['_data']) || $tag == 'script') { 434 echo '>', $attr['_data'] ?? '', '</', $tag, '>'; 435 } else { 436 echo '/>'; 437 } 438 echo "\n"; 439 } 440 } 441 } 442 443/** 444* Вывести данный скрипт как встроенный тег скрипта 445* 446* Эта функция добавит атрибут nonce, если он доступен. 447* 448* Скрипт НЕ экранируется автоматически! 449* 450* @param string $ скрипт 451* @param bool $ return Возврат или прямая печать? 452* @return string | недействительный 453*/ 454 function tpl_inlineScript($script, $return = false) 455 { 456 $nonce = getenv('NONCE'); 457 if ($nonce) { 458 $script = '<script nonce="' . $nonce . '">' . $script . '</script>'; 459 } else { 460 $script = '<script>' . $script . '</script>'; 461 } 462 463 if ($return) return $script; 464 echo $script; 465 } 466 467/** 468* Распечатать ссылку 469* 470* Просто создает ссылку. 471* 472* @param string $ url 473* @param string $ имя 474* @param string $ еще 475* @param bool $ return если true вернуть ссылку html, в противном случае вывести 476* @return bool | строка html ссылки или true, если выводится 477* 478* @автор Андреас Гор <andi@splitbrain.org> 479*/ 480 function tpl_link($url, $name, $more = '', $return = false) 481 { 482 $out = '<a href="' . $url . '" '; 483 if ($more) $out .= ' ' . $more; 484 $out .= ">$name</a>"; 485 if ($return) return $out; 486 echo $out; 487 return true; 488 } 489 490/** 491* Печатает ссылку на WikiPage 492* 493* Обертка вокруг html_wikilink 494* 495* @param string $ id идентификатор страницы 496* @param string | null $ name имя ссылки 497* @param bool $ возврат 498* @return true | строка 499* 500* @автор Андреас Гор <andi@splitbrain.org> 501*/ 502 function tpl_pagelink($id, $name = null, $return = false) 503 { 504 $out = '<bdi>' . html_wikilink($id, $name) . '</bdi>'; 505 if ($return) return $out; 506 echo $out; 507 return true; 508 } 509 510/** 511* получить родительскую страницу 512* 513* Пытается выяснить, какая страница является родительской. 514* возвращает false, если ничего не доступно 515* 516* @param string $ id идентификатор страницы 517* @return false | строка 518* 519* @автор Андреас Гор <andi@splitbrain.org> 520*/ 521 function tpl_getparent($id) 522 { 523 $resolver = new PageResolver('root'); 524 525 $parent = getNS($id) . ':'; 526 $parent = $resolver->resolveId($parent); 527 if ($parent == $id) { 528 $pos = strrpos(getNS($id), ':'); 529 $parent = substr($parent, 0, $pos) . ':'; 530 $parent = $resolver->resolveId($parent); 531 if ($parent == $id) return false; 532 } 533 return $parent; 534 } 535 536/** 537* Распечатать одну из кнопок 538* 539* @param string $ тип 540* @param bool $ возврат 541* @return bool | string html, или false, если данных нет, true, если выведено 542* @see tpl_get_action 543* 544* @автор Адриан Лэнг <mail@adrianlang.de> 545* @deprecated 2017-09-01 см. devel:menus 546*/ 547 function tpl_button($type, $return = false) 548 { 549 dbg_deprecated('see devel:menus'); 550 $data = tpl_get_action($type); 551 if ($data === false) { 552 return false; 553 } elseif (!is_array($data)) { 554 $out = sprintf($data, 'button'); 555 } else { 556 /** 557 * @var string $accesskey 558 * @var string $id 559 * @var string $method 560 * @var array $params 561 */ 562 extract($data); 563 if ($id === '#dokuwiki__top') { 564 $out = html_topbtn(); 565 } else { 566 $out = html_btn($type, $id, $accesskey, $params, $method); 567 } 568 } 569 if ($return) return $out; 570 echo $out; 571 return true; 572 } 573 574/** 575* Как кнопки действий, но ссылки 576* 577* @param string $ тип действие команда 578* @param string $ pre префикс ссылки 579* @param string $ suf суффикс ссылки 580* @param string $ внутренний innerHML ссылки 581* @param bool $ return если true, то возвращает html, в противном случае печатает 582* @return bool | string html или false, если данных нет, true, если выведено 583* 584* @see tpl_get_action 585* @автор Адриан Лэнг <mail@adrianlang.de> 586* @deprecated 2017-09-01 см. devel:menus 587*/ 588 function tpl_actionlink($type, $pre = '', $suf = '', $inner = '', $return = false) 589 { 590 dbg_deprecated('see devel:menus'); 591 global $lang; 592 $data = tpl_get_action($type); 593 if ($data === false) { 594 return false; 595 } elseif (!is_array($data)) { 596 $out = sprintf($data, 'link'); 597 } else { 598 /** 599 * @var string $accesskey 600 * @var string $id 601 * @var string $method 602 * @var bool $nofollow 603 * @var array $params 604 * @var string $replacement 605 */ 606 extract($data); 607 if (strpos($id, '#') === 0) { 608 $linktarget = $id; 609 } else { 610 $linktarget = wl($id, $params); 611 } 612 $caption = $lang['btn_' . $type]; 613 if (strpos($caption, '%s')) { 614 $caption = sprintf($caption, $replacement); 615 } 616 $akey = ''; 617 $addTitle = ''; 618 if ($accesskey) { 619 $akey = 'accesskey="' . $accesskey . '" '; 620 $addTitle = ' [' . strtoupper($accesskey) . ']'; 621 } 622 $rel = $nofollow ? 'rel="nofollow" ' : ''; 623 $out = tpl_link( 624 $linktarget, 625 $pre . ($inner ?: $caption) . $suf, 626 'class="action ' . $type . '" ' . 627 $akey . $rel . 628 'title="' . hsc($caption) . $addTitle . '"', 629 true 630 ); 631 } 632 if ($return) return $out; 633 echo $out; 634 return true; 635 } 636 637/** 638* Проверьте действия и получите данные для кнопок и ссылок 639* 640* @param string $ тип 641* @return массив | bool | строка 642* 643* @автор Адриан Лэнг <mail@adrianlang.de> 644* @автор Андреас Гор <andi@splitbrain.org> 645* @автор Маттиас Гримм <matthiasgrimm@users.sourceforge.net> 646* @deprecated 2017-09-01 см. devel:menus 647*/ 648 function tpl_get_action($type) 649 { 650 dbg_deprecated('see devel:menus'); 651 if ($type == 'history') $type = 'revisions'; 652 if ($type == 'subscription') $type = 'subscribe'; 653 if ($type == 'img_backto') $type = 'imgBackto'; 654 655 $class = '\\dokuwiki\\Menu\\Item\\' . ucfirst($type); 656 if (class_exists($class)) { 657 try { 658 /** @var AbstractItem $item */ 659 $item = new $class(); 660 $data = $item->getLegacyData(); 661 $unknown = false; 662 } catch (RuntimeException $ignored) { 663 return false; 664 } 665 } else { 666 global $ID; 667 $data = [ 668 'accesskey' => null, 669 'type' => $type, 670 'id' => $ID, 671 'method' => 'get', 672 'params' => ['do' => $type], 673 'nofollow' => true, 674 'replacement' => '' 675 ]; 676 $unknown = true; 677 } 678 679 $evt = new Event('TPL_ACTION_GET', $data); 680 if ($evt->advise_before()) { 681 //handle unknown types 682 if ($unknown) { 683 $data = '[unknown %s type]'; 684 } 685 } 686 $evt->advise_after(); 687 unset($evt); 688 689 return $data; 690 } 691 692/** 693* Обертка вокруг tpl_button() и tpl_actionlink() 694* 695* @param string $ тип действие команда 696* @param bool $ ссылка ссылка или кнопка формы? 697* @param string | bool $ wrapper Обертка HTML-элемента 698* @param bool $ return return или print 699* @param string $ pre префикс для ссылок 700* @param string $ suf суффикс для ссылок 701* @param string $ внутренний внутренний HTML для ссылок 702* @return bool | строка 703* 704* @автор Аника Хенке <anika@selfthinker.org> 705* @deprecated 2017-09-01 см. devel:menus 706*/ 707 function tpl_action($type, $link = false, $wrapper = false, $return = false, $pre = '', $suf = '', $inner = '') 708 { 709 dbg_deprecated('see devel:menus'); 710 $out = ''; 711 if ($link) { 712 $out .= tpl_actionlink($type, $pre, $suf, $inner, true); 713 } else { 714 $out .= tpl_button($type, true); 715 } 716 if ($out && $wrapper) $out = "<$wrapper>$out</$wrapper>"; 717 718 if ($return) return $out; 719 echo $out; 720 return (bool)$out; 721 } 722 723/** 724* Распечатать форму поиска 725* 726* Если первый параметр задан как div с идентификатором 'qsearch_out', то будет 727* добавляется, который инструктирует страницу ajax quicksearch включиться и разместить 728* его вывод в этот div. Второй параметр управляет собственным 729* атрибут автозаполнения. Если установлено значение false, этот атрибут будет установлен с 730* значение "off" указывает браузеру отключить встроенные функции 731* функция автодополнения (MSIE и Firefox) 732* 733* @param bool $ ajax 734* @param bool $ автозаполнение 735* @return bool 736* 737* @автор Андреас Гор <andi@splitbrain.org> 738*/ 739 function tpl_searchform($ajax = true, $autocomplete = true) 740 { 741 global $lang; 742 global $ACT; 743 global $QUERY; 744 global $ID; 745 746 // don't print the search form if search action has been disabled 747 if (!actionOK('search')) return false; 748 749 $searchForm = new Form([ 750 'action' => wl(), 751 'method' => 'get', 752 'role' => 'search', 753 'class' => 'search', 754 'id' => 'dw__search', 755 ], true); 756 $searchForm->addTagOpen('div')->addClass('no'); 757 $searchForm->setHiddenField('do', 'search'); 758 $searchForm->setHiddenField('id', $ID); 759 $searchForm->addTextInput('q') 760 ->addClass('edit') 761 ->attrs([ 762 'title' => '[F]', 763 'accesskey' => 'f', 764 'placeholder' => $lang['btn_search'], 765 'autocomplete' => $autocomplete ? 'on' : 'off', 766 ]) 767 ->id('qsearch__in') 768 ->val($ACT === 'search' ? $QUERY : '') 769 ->useInput(false); 770 $searchForm->addButton('', $lang['btn_search'])->attrs([ 771 'type' => 'submit', 772 'title' => $lang['btn_search'], 773 ]); 774 if ($ajax) { 775 $searchForm->addTagOpen('div')->id('qsearch__out')->addClass('ajax_qsearch JSpopup'); 776 $searchForm->addTagClose('div'); 777 } 778 $searchForm->addTagClose('div'); 779 780 echo $searchForm->toHTML('QuickSearch'); 781 782 return true; 783 } 784 785/** 786* Распечатать след навигационной цепочки 787* 788* @param string $ sep Разделитель между записями 789* @param bool $ return return или print 790* @return bool | строка 791* 792* @автор Андреас Гор <andi@splitbrain.org> 793*/ 794 function tpl_breadcrumbs($sep = null, $return = false) 795 { 796 global $lang; 797 global $conf; 798 799 //check if enabled 800 if (!$conf['breadcrumbs']) return false; 801 802 //set default 803 if (is_null($sep)) $sep = '•'; 804 805 $out = ''; 806 807 $crumbs = breadcrumbs(); //setup crumb trace 808 809 $crumbs_sep = ' <span class="bcsep">' . $sep . '</span> '; 810 811 //render crumbs, highlight the last one 812 $out .= '<span class="bchead">' . $lang['breadcrumb'] . '</span>'; 813 $last = count($crumbs); 814 $i = 0; 815 foreach ($crumbs as $id => $name) { 816 $i++; 817 $out .= $crumbs_sep; 818 if ($i == $last) $out .= '<span class="curid">'; 819 $out .= '<bdi>' . tpl_link(wl($id), hsc($name), 'class="breadcrumbs" title="' . $id . '"', true) . '</bdi>'; 820 if ($i == $last) $out .= '</span>'; 821 } 822 if ($return) return $out; 823 echo $out; 824 return (bool)$out; 825 } 826 827/** 828* Иерархическая навигационная цепочка 829* 830* Этот код был предложен в качестве замены обычным хлебным крошкам. 831* Имеет смысл только при наличии глубокой структуры сайта. 832* 833* @param string $ sep Разделитель между записями 834* @param bool $ return return или print 835* @return bool | строка 836* 837* @todo может вести себя странно в языках с письмом справа налево 838* @автор <fredrik@averpil.com> 839* @автор Андреас Гор <andi@splitbrain.org> 840* @автор Найджел Макни <oracle.shinoda@gmail.com> 841* @автор Шон Коутс <sean@caedmon.net> 842*/ 843 function tpl_youarehere($sep = null, $return = false) 844 { 845 global $conf; 846 global $ID; 847 global $lang; 848 849 // check if enabled 850 if (!$conf['youarehere']) return false; 851 852 //set default 853 if (is_null($sep)) $sep = ' » '; 854 855 $out = ''; 856 857 $parts = explode(':', $ID); 858 $count = count($parts); 859 860 $out .= '<span class="bchead">' . $lang['youarehere'] . ' </span>'; 861 862 // always print the startpage 863 $out .= '<span class="home">' . tpl_pagelink(':' . $conf['start'], null, true) . '</span>'; 864 865 // print intermediate namespace links 866 $part = ''; 867 for ($i = 0; $i < $count - 1; $i++) { 868 $part .= $parts[$i] . ':'; 869 $page = $part; 870 if ($page == $conf['start']) continue; // Skip startpage 871 872 // output 873 $out .= $sep . tpl_pagelink($page, null, true); 874 } 875 876 // print current page, skipping start page, skipping for namespace index 877 if (isset($page)) { 878 $page = (new PageResolver('root'))->resolveId($page); 879 if ($page == $part . $parts[$i]) { 880 if ($return) return $out; 881 echo $out; 882 return true; 883 } 884 } 885 $page = $part . $parts[$i]; 886 if ($page == $conf['start']) { 887 if ($return) return $out; 888 echo $out; 889 return true; 890 } 891 $out .= $sep; 892 $out .= tpl_pagelink($page, null, true); 893 if ($return) return $out; 894 echo $out; 895 return (bool)$out; 896 } 897 898/** 899* Распечатать информацию, если пользователь вошел в систему 900* и в этом случае показывать полное имя 901* 902* Можно ли в будущем добавить ссылку на профиль? 903* 904* @return bool 905* 906* @автор Андреас Гор <andi@splitbrain.org> 907*/ 908 function tpl_userinfo() 909 { 910 global $lang; 911 /** @var Input $INPUT */ 912 global $INPUT; 913 914 if ($INPUT->server->str('REMOTE_USER')) { 915 echo $lang['loggedinas'] . ' ' . userlink(); 916 return true; 917 } 918 return false; 919 } 920 921/** 922* Распечатать некоторую информацию о текущей странице 923* 924* @param bool $ ret возвращает содержимое вместо его печати 925* @return bool | строка 926* 927* @автор Андреас Гор <andi@splitbrain.org> 928*/ 929 function tpl_pageinfo($ret = false) 930 { 931 global $conf; 932 global $lang; 933 global $INFO; 934 global $ID; 935 936 // return if we are not allowed to view the page 937 if (!auth_quickaclcheck($ID)) { 938 return false; 939 } 940 941 // prepare date and path 942 $fn = $INFO['filepath']; 943 if (!$conf['fullpath']) { 944 if ($INFO['rev']) { 945 $fn = str_replace($conf['olddir'] . '/', '', $fn); 946 } else { 947 $fn = str_replace($conf['datadir'] . '/', '', $fn); 948 } 949 } 950 $fn = utf8_decodeFN($fn); 951 $date = dformat($INFO['lastmod']); 952 953 // print it 954 if ($INFO['exists']) { 955 $out = '<bdi>' . $fn . '</bdi>'; 956 $out .= ' · '; 957 $out .= $lang['lastmod']; 958 $out .= ' '; 959 $out .= $date; 960 if ($INFO['editor']) { 961 $out .= ' ' . $lang['by'] . ' '; 962 $out .= '<bdi>' . editorinfo($INFO['editor']) . '</bdi>'; 963 } else { 964 $out .= ' (' . $lang['external_edit'] . ')'; 965 } 966 if ($INFO['locked']) { 967 $out .= ' · '; 968 $out .= $lang['lockedby']; 969 $out .= ' '; 970 $out .= '<bdi>' . editorinfo($INFO['locked']) . '</bdi>'; 971 } 972 if ($ret) { 973 return $out; 974 } else { 975 echo $out; 976 return true; 977 } 978 } 979 return false; 980 } 981 982/** 983* Печатает или возвращает имя указанной страницы (текущей, если не указано). 984* 985* Если включено использование заголовка, будет использоваться первый заголовок, в противном случае 986* используется указанный идентификатор. 987* 988* @param string $ id идентификатор страницы 989* @param bool $ ret возвращает содержимое вместо печати 990* @return bool | строка 991* 992* @автор Андреас Гор <andi@splitbrain.org> 993*/ 994 function tpl_pagetitle($id = null, $ret = false) 995 { 996 global $ACT, $conf, $lang; 997 998 if (is_null($id)) { 999 global $ID; 1000 $id = $ID; 1001 } 1002 1003 $name = $id; 1004 if (useHeading('navigation')) { 1005 $first_heading = p_get_first_heading($id); 1006 if ($first_heading) $name = $first_heading; 1007 } 1008 1009 // default page title is the page name, modify with the current action 1010 switch ($ACT) { 1011 // admin functions 1012 case 'admin': 1013 $page_title = $lang['btn_admin']; 1014 // try to get the plugin name 1015 /** @var AdminPlugin $plugin */ 1016 if ($plugin = plugin_getRequestAdminPlugin()) { 1017 $plugin_title = $plugin->getMenuText($conf['lang']); 1018 $page_title = $plugin_title ?: $plugin->getPluginName(); 1019 } 1020 break; 1021 1022 // show action as title 1023 case 'login': 1024 case 'profile': 1025 case 'register': 1026 case 'resendpwd': 1027 case 'index': 1028 case 'search': 1029 $page_title = $lang['btn_' . $ACT]; 1030 break; 1031 1032 // add pen during editing 1033 case 'edit': 1034 case 'preview': 1035 $page_title = "✎ " . $name; 1036 break; 1037 1038 // add action to page name 1039 case 'revisions': 1040 $page_title = $name . ' - ' . $lang['btn_revs']; 1041 break; 1042 1043 // add action to page name 1044 case 'backlink': 1045 case 'recent': 1046 case 'subscribe': 1047 $page_title = $name . ' - ' . $lang['btn_' . $ACT]; 1048 break; 1049 1050 default: // SHOW and anything else not included 1051 $page_title = $name; 1052 } 1053 1054 if ($ret) { 1055 return hsc($page_title); 1056 } else { 1057 echo hsc($page_title); 1058 return true; 1059 } 1060 } 1061 1062/** 1063* Возвращает запрошенный тег EXIF / IPTC из текущего изображения 1064* 1065* Если $tags — это массив, то все заданные теги проверяются до тех пор, пока не будет найден 1066* значение найдено. Если значение не найдено, возвращается $alt. 1067* 1068* Какие тексты известны, определяется в функциях _exifTagNames 1069* и _iptcTagNames() в inc / jpeg.php (Вам необходимо добавить IPTC 1070* к именам последнего) 1071* 1072* Разрешено только в: detail.php 1073* 1074* @param array | string $ tags тег или массив тегов для проверки 1075* @param string $ alt альтернативный вывод, если данные не найдены 1076* @param null | string $ src источник изображения, если не указан, используется глобальный $SRC 1077* @возвращаемая строка 1078* 1079* @автор Андреас Гор <andi@splitbrain.org> 1080*/ 1081 function tpl_img_getTag($tags, $alt = '', $src = null) 1082 { 1083 // Init Exif Reader 1084 global $SRC, $imgMeta; 1085 1086 if (is_null($src)) $src = $SRC; 1087 if (is_null($src)) return $alt; 1088 1089 if (!isset($imgMeta)) { 1090 $imgMeta = new JpegMeta($src); 1091 } 1092 if ($imgMeta === false) return $alt; 1093 $info = cleanText($imgMeta->getField($tags)); 1094 if (!$info) return $alt; 1095 return $info; 1096 } 1097 1098 1099/** 1100* Мусор собирает открытый объект JpegMeta. 1101*/ 1102 function tpl_img_close() 1103 { 1104 global $imgMeta; 1105 $imgMeta = null; 1106 } 1107 1108/** 1109* Выводит HTML-список описаний метатегов текущего изображения 1110*/ 1111 function tpl_img_meta() 1112 { 1113 global $lang; 1114 1115 $tags = tpl_get_img_meta(); 1116 1117 echo '<dl>'; 1118 foreach ($tags as $tag) { 1119 $label = $lang[$tag['langkey']]; 1120 if (!$label) $label = $tag['langkey'] . ':'; 1121 1122 echo '<dt>' . $label . '</dt><dd>'; 1123 if ($tag['type'] == 'date') { 1124 echo dformat($tag['value']); 1125 } else { 1126 echo hsc($tag['value']); 1127 } 1128 echo '</dd>'; 1129 } 1130 echo '</dl>'; 1131 } 1132 1133/** 1134* Возвращает метаданные, настроенные в файле конфигурации mediameta, готовые для создания html 1135* 1136* @return массив с массивами, содержащими записи: 1137* - строка langkey key для поиска в переменной $lang, если не найдена, выводится как есть 1138* - строковый тип значения 1139* - строковое значение тега (неэкранированное) 1140*/ 1141 function tpl_get_img_meta() 1142 { 1143 1144 $config_files = getConfigFiles('mediameta'); 1145 foreach ($config_files as $config_file) { 1146 if (file_exists($config_file)) { 1147 include($config_file); 1148 } 1149 } 1150 $tags = []; 1151 foreach ($fields as $tag) { 1152 $t = []; 1153 if (!empty($tag[0])) { 1154 $t = [$tag[0]]; 1155 } 1156 if (isset($tag[3]) && is_array($tag[3])) { 1157 $t = array_merge($t, $tag[3]); 1158 } 1159 $value = tpl_img_getTag($t); 1160 if ($value) { 1161 $tags[] = ['langkey' => $tag[1], 'type' => $tag[2], 'value' => $value]; 1162 } 1163 } 1164 return $tags; 1165 } 1166 1167/** 1168* Печатает изображение со ссылкой на полноразмерную версию 1169* 1170* Разрешено только в: detail.php 1171* 1172* @triggers TPL_IMG_DISPLAY 1173* @param int $ maxwidth - максимальная ширина изображения 1174* @param int $ maxheight - максимальная высота изображения 1175* @param bool $ link - ссылка на исходный размер? 1176* @param array $ params - дополнительные атрибуты изображения 1177* @return bool Результат TPL_IMG_DISPLAY 1178*/ 1179 function tpl_img($maxwidth = 0, $maxheight = 0, $link = true, $params = null) 1180 { 1181 global $IMG; 1182 /** @var Input $INPUT */ 1183 global $INPUT; 1184 global $REV; 1185 $w = (int)tpl_img_getTag('File.Width'); 1186 $h = (int)tpl_img_getTag('File.Height'); 1187 1188 //изменить размер до указанных максимальных значений 1189 $ratio = 1; 1190 if ($w >= $h) { 1191 if ($maxwidth && $w >= $maxwidth) { 1192 $ratio = $maxwidth / $w; 1193 } elseif ($maxheight && $h > $maxheight) { 1194 $ratio = $maxheight / $h; 1195 } 1196 } elseif ($maxheight && $h >= $maxheight) { 1197 $ratio = $maxheight / $h; 1198 } elseif ($maxwidth && $w > $maxwidth) { 1199 $ratio = $maxwidth / $w; 1200 } 1201 if ($ratio) { 1202 $w = floor($ratio * $w); 1203 $h = floor($ratio * $h); 1204 } 1205 1206 //подготовить URL-адреса 1207 $url = ml($IMG, ['cache' => $INPUT->str('cache'), 'rev' => $REV], true, '&'); 1208 $src = ml($IMG, ['cache' => $INPUT->str('cache'), 'rev' => $REV, 'w' => $w, 'h' => $h], true, '&'); 1209 1210 //подготовить атрибуты 1211 $alt = tpl_img_getTag('Simple.Title'); 1212 if (is_null($params)) { 1213 $p = []; 1214 } else { 1215 $p = $params; 1216 } 1217 if ($w) $p['width'] = $w; 1218 if ($h) $p['height'] = $h; 1219 $p['class'] = 'img_detail'; 1220 if ($alt) { 1221 $p['alt'] = $alt; 1222 $p['title'] = $alt; 1223 } else { 1224 $p['alt'] = ''; 1225 } 1226 $p['src'] = $src; 1227 1228 $data = ['url' => ($link ? $url : null), 'params' => $p]; 1229 return Event::createAndTrigger('TPL_IMG_DISPLAY', $data, '_tpl_img_action', true); 1230 } 1231 1232/** 1233* Действие по умолчанию для TPL_IMG_DISPLAY 1234* 1235* @param массив $ данные 1236* @return bool 1237*/ 1238 function _tpl_img_action($data) 1239 { 1240 global $lang; 1241 $p = buildAttributes($data['params']); 1242 1243 if ($data['url']) echo '<a href="' . hsc($data['url']) . '" title="' . $lang['mediaview'] . '">'; 1244 echo '<img ' . $p . '/>'; 1245 if ($data['url']) echo '</a>'; 1246 return true; 1247 } 1248 1249/** 1250* Эта функция вставляет небольшой gif-файл, который на самом деле является функцией индексатора. 1251* 1252* Должен вызываться где-то в самом конце шаблона main.php 1253* 1254* @return bool 1255*/ 1256 function tpl_indexerWebBug() 1257 { 1258 global $ID; 1259 1260 $p = []; 1261 $p['src'] = DOKU_BASE . 'lib/exe/taskrunner.php?id=' . rawurlencode($ID) . 1262 '&' . time(); 1263 $p['width'] = 2; //no more 1x1 px image because we live in times of ad blockers... 1264 $p['height'] = 1; 1265 $p['alt'] = ''; 1266 $att = buildAttributes($p); 1267 echo "<img $att />"; 1268 return true; 1269 } 1270 1271/** 1272* tpl_getConf($id) 1273* 1274* используйте эту функцию для доступа к переменным конфигурации шаблона 1275* 1276* @param string $ id имя значения для доступа 1277* @param mixed $ notset что возвращать, если настройка недоступна 1278* @return смешанный 1279*/ 1280 function tpl_getConf($id, $notset = false) 1281 { 1282 global $conf; 1283 static $tpl_configloaded = false; 1284 1285 $tpl = $conf['template']; 1286 1287 if (!$tpl_configloaded) { 1288 $tconf = tpl_loadConfig(); 1289 if ($tconf !== false) { 1290 foreach ($tconf as $key => $value) { 1291 if (isset($conf['tpl'][$tpl][$key])) continue; 1292 $conf['tpl'][$tpl][$key] = $value; 1293 } 1294 $tpl_configloaded = true; 1295 } 1296 } 1297 1298 return $conf['tpl'][$tpl][$id] ?? $notset; 1299 } 1300 1301/** 1302* tpl_loadConfig() 1303* 1304* считывает все переменные конфигурации шаблона 1305* эта функция автоматически вызывается tpl_getConf() 1306* 1307* @return false | массив 1308*/ 1309 function tpl_loadConfig() 1310 { 1311 1312 $file = tpl_incdir() . '/conf/default.php'; 1313 $conf = []; 1314 1315 if (!file_exists($file)) return false; 1316 1317 // загрузить файл конфигурации по умолчанию 1318 include($file); 1319 1320 return $conf; 1321 } 1322 1323// методы языка 1324 1323// методы языка 1324 1325/** 1326* tpl_getLang($id) 1327* 1328* используйте эту функцию для доступа к переменным языка шаблона 1329* 1330* @param string $ id ключ языковой строки 1331* @возвращаемая строка 1332*/ 1333 function tpl_getLang($id) 1334 { 1335 static $lang = []; 1336 1337 if (count($lang) === 0) { 1338 global $conf, $config_cascade; // definitely don't invoke "global $lang" 1339 1340 $path = tpl_incdir() . 'lang/'; 1341 1342 $lang = []; 1343 1344 // не включайте один раз 1345 @include($path . 'en/lang.php'); 1346 foreach ($config_cascade['lang']['template'] as $config_file) { 1347 if (file_exists($config_file . $conf['template'] . '/en/lang.php')) { 1348 include($config_file . $conf['template'] . '/en/lang.php'); 1349 } 1350 } 1351 1352 if ($conf['lang'] != 'en') { 1353 @include($path . $conf['lang'] . '/lang.php'); 1354 foreach ($config_cascade['lang']['template'] as $config_file) { 1355 if (file_exists($config_file . $conf['template'] . '/' . $conf['lang'] . '/lang.php')) { 1356 include($config_file . $conf['template'] . '/' . $conf['lang'] . '/lang.php'); 1357 } 1358 } 1359 } 1360 } 1361 return $lang[$id] ?? ''; 1362 } 1363 1364/** 1365* Извлечь файл, зависящий от языка, и передать его в xhtml-рендерер для отображения 1366* эквивалент шаблона p_locale_xhtml() 1367* 1368* @param string $ id идентификатор страницы вики, зависящей от языка 1369* @return string анализирует содержимое страницы вики в формате xhtml 1370*/ 1371 function tpl_locale_xhtml($id) 1372 { 1373 return p_cached_output(tpl_localeFN($id)); 1374 } 1375 1376/** 1377* Добавляет соответствующий путь к имени файла, зависящему от языка 1378* 1379* @param string $ id идентификатор локализованного текста 1380* @return string вики-текст 1381*/ 1382 function tpl_localeFN($id) 1383 { 1384 $path = tpl_incdir() . 'lang/'; 1385 global $conf; 1386 $file = DOKU_CONF . 'template_lang/' . $conf['template'] . '/' . $conf['lang'] . '/' . $id . '.txt'; 1387 if (!file_exists($file)) { 1388 $file = $path . $conf['lang'] . '/' . $id . '.txt'; 1389 if (!file_exists($file)) { 1390 //fall back to english 1391 $file = $path . 'en/' . $id . '.txt'; 1392 } 1393 } 1394 return $file; 1395 } 1396 1397/** 1398* выводит «основной контент» во всплывающем окне медиаменеджера 1399* 1400* В зависимости от действий пользователя это может быть список 1401* файлы в пространстве имен, диалоговое окно редактирования метаданных или 1402* сообщение о ссылках на страницы 1403* 1404* Разрешено только в mediamanager.php 1405* 1406* @triggers МЕДИАМЕНЕДЖЕР_КОНТЕНТ_ВЫВОД 1407* @param bool $ fromajax - установить true при вызове этой функции через ajax 1408* @param string $ сортировка 1409* 1410* @автор Андреас Гор <andi@splitbrain.org> 1411*/ 1412 function tpl_mediaContent($fromajax = false, $sort = 'natural') 1413 { 1414 global $IMG; 1415 global $AUTH; 1416 global $INUSE; 1417 global $NS; 1418 global $JUMPTO; 1419 /** @var Input $INPUT */ 1420 global $INPUT; 1421 1422 $do = $INPUT->extract('do')->str('do'); 1423 if (in_array($do, ['save', 'cancel'])) $do = ''; 1424 1425 if (!$do) { 1426 if ($INPUT->bool('edit')) { 1427 $do = 'metaform'; 1428 } elseif (is_array($INUSE)) { 1429 $do = 'filesinuse'; 1430 } else { 1431 $do = 'filelist'; 1432 } 1433 } 1434 1435 // выводим панель содержимого, обернутую в событие. 1436 if (!$fromajax) echo '<div id="media__content">'; 1437 $data = ['do' => $do]; 1438 $evt = new Event('MEDIAMANAGER_CONTENT_OUTPUT', $data); 1439 if ($evt->advise_before()) { 1440 $do = $data['do']; 1441 if ($do == 'filesinuse') { 1442 media_filesinuse($INUSE, $IMG); 1443 } elseif ($do == 'filelist') { 1444 media_filelist($NS, $AUTH, $JUMPTO, false, $sort); 1445 } elseif ($do == 'searchlist') { 1446 media_searchlist($INPUT->str('q'), $NS, $AUTH); 1447 } else { 1448 msg('Unknown action ' . hsc($do), -1); 1449 } 1450 } 1451 $evt->advise_after(); 1452 unset($evt); 1453 if (!$fromajax) echo '</div>'; 1454 } 1455 1456/** 1457* Печатает центральный столбец в полноэкранном медиа-менеджере 1458* В зависимости от открытой вкладки это может быть список 1459* файлы в пространстве имен, форма загрузки или форма поиска 1460* 1461* @author Катя Арзамасцева <pshns@ukr.net> 1462*/ 1463 function tpl_mediaFileList() 1464 { 1465 global $AUTH; 1466 global $NS; 1467 global $JUMPTO; 1468 global $lang; 1469 /** @var Input $INPUT */ 1470 global $INPUT; 1471 1472 $opened_tab = $INPUT->str('tab_files'); 1473 if (!$opened_tab || !in_array($opened_tab, ['files', 'upload', 'search'])) $opened_tab = 'files'; 1474 if ($INPUT->str('mediado') == 'update') $opened_tab = 'upload'; 1475 1476 echo '<h2 class="a11y">' . $lang['mediaselect'] . '</h2>' . NL; 1477 1478 media_tabs_files($opened_tab); 1479 1480 echo '<div class="panelHeader">' . NL; 1481 echo '<h3>'; 1482 $tabTitle = $NS ?: '[' . $lang['mediaroot'] . ']'; 1483 printf($lang['media_' . $opened_tab], '<strong>' . hsc($tabTitle) . '</strong>'); 1484 echo '</h3>' . NL; 1485 if ($opened_tab === 'search' || $opened_tab === 'files') { 1486 media_tab_files_options(); 1487 } 1488 echo '</div>' . NL; 1489 1490 echo '<div class="panelContent">' . NL; 1491 if ($opened_tab == 'files') { 1492 media_tab_files($NS, $AUTH, $JUMPTO); 1493 } elseif ($opened_tab == 'upload') { 1494 media_tab_upload($NS, $AUTH, $JUMPTO); 1495 } elseif ($opened_tab == 'search') { 1496 media_tab_search($NS, $AUTH); 1497 } 1498 echo '</div>' . NL; 1499 } 1500 1501/** 1502* Печатает третий столбец в полноэкранном медиа-менеджере 1503* В зависимости от открытой вкладки это могут быть сведения о 1504* выбранный файл, диалоговое окно редактирования метаданных или 1505* список ревизий файлов 1506* 1507* @param string $ изображение 1508* @param boolean $ rev 1509* 1510* @author Катя Арзамасцева <pshns@ukr.net> 1511*/ 1512 function tpl_mediaFileDetails($image, $rev) 1513 { 1514 global $conf, $DEL, $lang; 1515 /** @var Input $INPUT */ 1516 global $INPUT; 1517 1518 $removed = ( 1519 !file_exists(mediaFN($image)) && 1520 file_exists(mediaMetaFN($image, '.changes')) && 1521 $conf['mediarevisions'] 1522 ); 1523 if (!$image || (!file_exists(mediaFN($image)) && !$removed) || $DEL) return; 1524 if ($rev && !file_exists(mediaFN($image, $rev))) $rev = false; 1525 $ns = getNS($image); 1526 $do = $INPUT->str('mediado'); 1527 1528 $opened_tab = $INPUT->str('tab_details'); 1529 1530 $tab_array = ['view']; 1531 [, $mime] = mimetype($image); 1532 if ($mime == 'image/jpeg') { 1533 $tab_array[] = 'edit'; 1534 } 1535 if ($conf['mediarevisions']) { 1536 $tab_array[] = 'history'; 1537 } 1538 1539 if (!$opened_tab || !in_array($opened_tab, $tab_array)) $opened_tab = 'view'; 1540 if ($INPUT->bool('edit')) $opened_tab = 'edit'; 1541 if ($do == 'restore') $opened_tab = 'view'; 1542 1543 media_tabs_details($image, $opened_tab); 1544 1545 echo '<div class="panelHeader"><h3>'; 1546 [$ext] = mimetype($image, false); 1547 $class = preg_replace('/[^_\-a-z0-9]+/i', '_', $ext); 1548 $class = 'select mediafile mf_' . $class; 1549 1550 $attributes = $rev ? ['rev' => $rev] : []; 1551 $tabTitle = sprintf( 1552 '<strong><a href="%s" class="%s" title="%s">%s</a></strong>', 1553 ml($image, $attributes), 1554 $class, 1555 $lang['mediaview'], 1556 $image 1557 ); 1558 if ($opened_tab === 'view' && $rev) { 1559 printf($lang['media_viewold'], $tabTitle, dformat($rev)); 1560 } else { 1561 printf($lang['media_' . $opened_tab], $tabTitle); 1562 } 1563 1564 echo '</h3></div>' . NL; 1565 1566 echo '<div class="panelContent">' . NL; 1567 1568 if ($opened_tab == 'view') { 1569 media_tab_view($image, $ns, null, $rev); 1570 } elseif ($opened_tab == 'edit' && !$removed) { 1571 media_tab_edit($image, $ns); 1572 } elseif ($opened_tab == 'history' && $conf['mediarevisions']) { 1573 media_tab_history($image, $ns); 1574 } 1575 1576 echo '</div>' . NL; 1577 } 1578 1579/** 1580* выводит дерево пространства имен во всплывающем окне медиаменеджера 1581* 1582* Разрешено только в mediamanager.php 1583* 1584* @автор Андреас Гор <andi@splitbrain.org> 1585*/ 1586 function tpl_mediaTree() 1587 { 1588 global $NS; 1589 echo '<div id="media__tree">'; 1590 media_nstree($NS); 1591 echo '</div>'; 1592 } 1593 1594/** 1595* Распечатать выпадающее меню со всеми действиями DokuWiki 1596* 1597* Примечание: здесь не будут использоваться красивые URL-адреса. 1598* 1599* @param string $ пусто пустая метка параметра 1600* @param string $ кнопка подписи кнопки отправки 1601* 1602* @автор Андреас Гор <andi@splitbrain.org> 1603* @deprecated 2017-09-01 см. devel:menus 1604*/ 1605 function tpl_actiondropdown($empty = '', $button = '>') 1606 { 1607 dbg_deprecated('see devel:menus'); 1608 $menu = new MobileMenu(); 1609 echo $menu->getDropdown($empty, $button); 1610 } 1611 1612/** 1613* Распечатать информационную строку об использованной лицензии 1614* 1615* @param string $ img распечатать изображение? (|кнопка|значок) 1616* @param bool $ imgonly пропустить текстовое описание? 1617* @param bool $ return, если true, не печатать, а возвращать HTML 1618* @param bool $ обернуть в div с class="license"? 1619* @возвращаемая строка 1620* 1621* @автор Андреас Гор <andi@splitbrain.org> 1622*/ 1623 function tpl_license($img = 'badge', $imgonly = false, $return = false, $wrap = true) 1624 { 1625 global $license; 1626 global $conf; 1627 global $lang; 1628 if (!$conf['license']) return ''; 1629 if (!is_array($license[$conf['license']])) return ''; 1630 $lic = $license[$conf['license']]; 1631 $target = ($conf['target']['extern']) ? ' target="' . $conf['target']['extern'] . '"' : ''; 1632 1633 $out = ''; 1634 if ($wrap) $out .= '<div class="license">'; 1635 if ($img) { 1636 $src = license_img($img); 1637 if ($src) { 1638 $out .= '<a href="' . $lic['url'] . '" rel="license"' . $target; 1639 $out .= '><img src="' . DOKU_BASE . $src . '" alt="' . $lic['name'] . '" /></a>'; 1640 if (!$imgonly) $out .= ' '; 1641 } 1642 } 1643 if (!$imgonly) { 1644 $out .= $lang['license'] . ' '; 1645 $out .= '<bdi><a href="' . $lic['url'] . '" rel="license" class="urlextern"' . $target; 1646 $out .= '>' . $lic['name'] . '</a></bdi>'; 1647 } 1648 if ($wrap) $out .= '</div>'; 1649 1650 if ($return) return $out; 1651 echo $out; 1652 return ''; 1653 } 1654 1655/** 1656* Включает визуализированный HTML-код указанной страницы 1657* 1658* Эта функция полезна для заполнения боковых панелей или подобных функций в 1659* шаблон 1660* 1661* @param string $ pageid Имя страницы, которую вы хотите включить 1662* @param bool $ print Следует ли печатать содержимое или только возвращать его 1663* @param bool $ propagate Искать также и в более высоких пространствах имен? 1664* @param bool $ useacl Включать страницу только в том случае, если списки контроля доступа проверены? 1665* @return bool | null | строка 1666*/ 1667 function tpl_include_page($pageid, $print = true, $propagate = false, $useacl = true) 1668 { 1669 if ($propagate) { 1670 $pageid = page_findnearest($pageid, $useacl); 1671 } elseif ($useacl && auth_quickaclcheck($pageid) == AUTH_NONE) { 1672 return false; 1673 } 1674 if (!$pageid) return false; 1675 1676 global $TOC; 1677 $oldtoc = $TOC; 1678 $html = p_wiki_xhtml($pageid, '', false); 1679 $TOC = $oldtoc; 1680 1681 if ($print) echo $html; 1682 return $html; 1683 } 1684 1685/** 1686* Отобразить форму подписки 1687* 1688* @автор Адриан Лэнг <lang@cosmocode.de> 1689* @устаревший 2020-07-23 1690*/ 1691 function tpl_subscribe() 1692 { 1693 dbg_deprecated(Subscribe::class . '::show()'); 1694 (new Subscribe())->show(); 1695 } 1696 1697/** 1698* Пытается отправить уже созданный контент прямо в браузер 1699* 1700* Оборачивает ob_flush() и flush() 1701* 1702* @автор Андреас Гор <andi@splitbrain.org> 1703*/ 1704 function tpl_flush() 1705 { 1706 if (ob_get_level() > 0) ob_flush(); 1707 flush(); 1708 } 1709 1710/** 1711* Пытается найти файл ресурсов в указанных местах. 1712* 1713* Если указанное местоположение начинается с двоеточия, предполагается, что это медиа 1714* файл, в противном случае предполагается, что он относится к текущему шаблону 1715* 1716* @параметр строка []$ поиск мест для просмотра 1717* @param bool $ abs , если использовать абсолютный URL 1718* @param массив &$imginfo заполнен с помощью getimagesize() 1719* @param bool $ fallback использовать резервное изображение, если цель не найдена, или вернуть «false», если она потенциальная 1720* требуется ложный результат 1721* @возвращаемая строка 1722* 1723* @автор Андреас Гор <andi@splitbrain.org> 1724*/ 1725 function tpl_getMediaFile($search, $abs = false, &$imginfo = null, $fallback = true) 1726 { 1727 $img = ''; 1728 $file = ''; 1729 $ismedia = false; 1730 // перебираем кандидатов, пока не будет найдено совпадение: 1731 foreach ($search as $img) { 1732 if (str_starts_with($img, ':')) { 1733 $file = mediaFN($img); 1734 $ismedia = true; 1735 } else { 1736 $file = tpl_incdir() . $img; 1737 $ismedia = false; 1738 } 1739 1740 if (file_exists($file)) break; 1741 } 1742 1743 // управлять несуществующей целью 1744 if (!file_exists($file)) { 1745 // дать результат для резервного изображения 1746 if ($fallback) { 1747 $file = DOKU_INC . 'lib/images/blank.gif'; 1748 // остановить процесс, если требуется ложный результат (если $fallback равен false) 1749 } else { 1750 return false; 1751 } 1752 } 1753 1754 // извлечь данные изображения, если требуется 1755 if (!is_null($imginfo)) { 1756 $imginfo = getimagesize($file); 1757 } 1758 1759 // создать URL 1760 if ($ismedia) { 1761 $url = ml($img, '', true, '', $abs); 1762 } else { 1763 $url = tpl_basedir() . $img; 1764 if ($abs) $url = DOKU_URL . substr($url, strlen(DOKU_REL)); 1765 } 1766 1767 return $url; 1768 } 1769 1770/** 1771* PHP включает файл 1772* 1773* либо из каталога conf, если он существует, в противном случае используйте 1774* файл в корневом каталоге шаблона. 1775* 1776* Функция учитывает настройки каскада конфигураций и ищет заданные 1777* файл рядом с «основными» файлами конфигурации, в порядке защищенный, локальный, 1778* по умолчанию. 1779* 1780* Примечание: здесь не выполняется экранирование или проверка на работоспособность. Никогда не передавайте пользовательский ввод 1781* к этой функции! 1782* 1783* @param string $ файл 1784* 1785* @автор Андреас Гор <andi@splitbrain.org> 1786* @автор Аника Хенке <anika@selfthinker.org> 1787*/ 1788 function tpl_includeFile($file) 1789 { 1790 global $config_cascade; 1791 foreach (['protected', 'local', 'default'] as $config_group) { 1792 if (empty($config_cascade['main'][$config_group])) continue; 1793 foreach ($config_cascade['main'][$config_group] as $conf_file) { 1794 $dir = dirname($conf_file); 1795 if (file_exists("$dir/$file")) { 1796 include("$dir/$file"); 1797 return; 1798 } 1799 } 1800 } 1801 1802 // все еще здесь? попробуйте шаблон dir 1803 $file = tpl_incdir() . $file; 1804 if (file_exists($file)) { 1805 include($file); 1806 } 1807 } 1808 1809/** 1810* Возвращает тег <link> для различных типов иконок (favicon|mobile|generic) 1811* 1812* @param array $ types - список типов иконок для отображения (favicon|mobile|generic) 1813* @возвращаемая строка 1814* 1815* @автор Аника Хенке <anika@selfthinker.org> 1816*/ 1817 function tpl_favicon($types = ['favicon']) 1818 { 1819 1820 $return = ''; 1821 1822 foreach ($types as $type) { 1823 switch ($type) { 1824 case 'favicon': 1825 $look = [':wiki:favicon.ico', ':favicon.ico', 'images/favicon.ico']; 1826 $return .= '<link rel="shortcut icon" href="' . tpl_getMediaFile($look) . '" />' . NL; 1827 break; 1828 case 'mobile': 1829 $look = [':wiki:apple-touch-icon.png', ':apple-touch-icon.png', 'images/apple-touch-icon.png']; 1830 $return .= '<link rel="apple-touch-icon" href="' . tpl_getMediaFile($look) . '" />' . NL; 1831 break; 1832 case 'generic': 1833 // ideal world solution, which doesn't work in any browser yet 1834 $look = [':wiki:favicon.svg', ':favicon.svg', 'images/favicon.svg']; 1835 $return .= '<link rel="icon" href="' . tpl_getMediaFile($look) . '" type="image/svg+xml" />' . NL; 1836 break; 1837 } 1838 } 1839 1840 return $return; 1841 } 1842 1843/** 1844* Печать полноэкранного медиа-менеджера 1845* 1846* @author Катя Арзамасцева <pshns@ukr.net> 1847*/ 1848 function tpl_media() 1849 { 1850 global $NS, $IMG, $JUMPTO, $REV, $lang, $fullscreen, $INPUT; 1851 $fullscreen = true; 1852 require_once DOKU_INC . 'lib/exe/mediamanager.php'; 1853 1854 $rev = ''; 1855 $image = cleanID($INPUT->str('image')); 1856 if (isset($IMG)) $image = $IMG; 1857 if (isset($JUMPTO)) $image = $JUMPTO; 1858 if (isset($REV) && !$JUMPTO) $rev = $REV; 1859 1860 echo '<div id="mediamanager__page">' . NL; 1861 echo '<h1>' . $lang['btn_media'] . '</h1>' . NL; 1862 html_msgarea(); 1863 1864 echo '<div class="panel namespaces">' . NL; 1865 echo '<h2>' . $lang['namespaces'] . '</h2>' . NL; 1866 echo '<div class="panelHeader">'; 1867 echo $lang['media_namespaces']; 1868 echo '</div>' . NL; 1869 1870 echo '<div class="panelContent" id="media__tree">' . NL; 1871 media_nstree($NS); 1872 echo '</div>' . NL; 1873 echo '</div>' . NL; 1874 1875 echo '<div class="panel filelist">' . NL; 1876 tpl_mediaFileList(); 1877 echo '</div>' . NL; 1878 1879 echo '<div class="panel file">' . NL; 1880 echo '<h2 class="a11y">' . $lang['media_file'] . '</h2>' . NL; 1881 tpl_mediaFileDetails($image, $rev); 1882 echo '</div>' . NL; 1883 1884 echo '</div>' . NL; 1885 } 1886 1887/** 1888* Возвращаем полезные классы макета 1889* 1890* @возвращаемая строка 1891* 1892* @автор Аника Хенке <anika@selfthinker.org> 1893*/ 1894 function tpl_classes() 1895 { 1896 global $ACT, $conf, $ID, $INFO; 1897 /** @var Input $INPUT */ 1898 global $INPUT; 1899 1900 $classes = [ 1901 'dokuwiki', 1902 'mode_' . $ACT, 1903 'tpl_' . $conf['template'], 1904 $INPUT->server->bool('REMOTE_USER') ? 'loggedIn' : '', 1905 (isset($INFO['exists']) && $INFO['exists']) ? '' : 'notFound', 1906 ($ID == $conf['start']) ? 'home' : '' 1907 ]; 1908 return implode(' ', $classes); 1909 } 1910 1911/** 1912* Создать событие для меню инструментов 1913* 1914* @param string $ toolsname имя меню 1915* @param массив $ элементы 1916* @param string $ view например 'main', 'detail', ... 1917* 1918* @автор Аника Хенке <anika@selfthinker.org> 1919* @deprecated 2017-09-01 см. devel:menus 1920*/ 1921 function tpl_toolsevent($toolsname, $items, $view = 'main') 1922 { 1923 dbg_deprecated('see devel:menus'); 1924 $data = ['view' => $view, 'items' => $items]; 1925 1926 $hook = 'TEMPLATE_' . strtoupper($toolsname) . '_DISPLAY'; 1927 $evt = new Event($hook, $data); 1928 if ($evt->advise_before()) { 1929 foreach ($evt->data['items'] as $html) echo $html; 1930 } 1931 $evt->advise_after(); 1932 } 1933
Полный перевод для понимая
1<?php 2 3/** 4* Функции шаблонов DokuWiki 5* 6* @license GPL 2 ( http://www.gnu.org/licenses/gpl.html) 7* @автор Андреас Гор <andi@splitbrain.org> 8*/ 9 10использовать dokuwiki \ ActionRouter ; 11используйте dokuwiki \ Действие \ Исключение \ FatalException ; 12использовать dokuwiki \ Extension \ PluginInterface ; 13используйте dokuwiki \ Ui \ Admin ; 14использовать dokuwiki \ StyleUtils ; 15использовать dokuwiki \ Меню \ Элемент \ AbstractItem ; 16использовать dokuwiki \ Форма \ Форма ; 17используйте dokuwiki \ Menu \ MobileMenu ; 18используйте dokuwiki \ Ui \ Subscribe ; 19используйте dokuwiki \ Extension \ AdminPlugin ; 20использовать dokuwiki \ Extension \ Event ; 21используйте dokuwiki \ File \ PageResolver ; 22 23/** 24* Доступ к файлу шаблона 25* 26* Возвращает путь к указанному файлу внутри текущего шаблона, использует 27* шаблон по умолчанию, если пользовательская версия не существует. 28* 29* @param string $ файл 30* @возвращаемая строка 31* 32* @автор Андреас Гор <andi@splitbrain.org> 33*/ 34 шаблон функции ($ file ) 35{ 36 глобальная $ conf ; 37 38 если (@ is_readable ( DOKU_INC . ' lib / tpl /' . $ conf [ 'template' ] . '/' . $ file )) 39 вернуть DOKU_INC.'lib / tpl /'.$ conf [ ' template' ] . ' /' . $ file ; 40 41 вернуть DOKU_INC.'lib / tpl / dokuwiki /'.$ file ; 42} 43 44/** 45* Удобная функция для доступа к каталогу шаблонов из локальной ФС 46* 47* Заменяет устаревшую константу DOKU_TPLINC. 48* 49* @param string $ tpl Шаблон для использования, по умолчанию текущий 50* @возвращаемая строка 51* 52* @автор Андреас Гор <andi@splitbrain.org> 53*/ 54функция tpl_incdir ($ tpl = '' ) 55{ 56 глобальная $ conf ; 57 если (!$ tpl ) $ tpl = $ conf [ 'шаблон' ]; 58 вернуть DOKU_INC . ' lib / tpl /' . $ tpl . '/' ; 59} 60 61/** 62* Удобная функция доступа к каталогу шаблонов из Интернета 63* 64* Заменяет устаревшую константу DOKU_TPL 65* 66* @param string $ tpl Шаблон для использования, по умолчанию текущий 67* @возвращаемая строка 68* 69* @автор Андреас Гор <andi@splitbrain.org> 70*/ 71функция tpl_basedir ($ tpl = '' ) 72{ 73 глобальная $ conf ; 74 если (!$ tpl ) $ tpl = $ conf [ 'шаблон' ]; 75 вернуть DOKU_BASE.'lib / tpl /'.$ tpl . ' / ' ; 76} 77 78/** 79* Распечатать содержимое 80* 81* Эта функция используется для печати всего обычного контента. 82* (определяется глобальной переменной $ACT) путем вызова соответствующего 83* выходные функции из html.php 84* 85* Все, что не использует основной файл шаблона, не 86* обрабатывается этой функцией. ACL-списки здесь тоже не обрабатываются. 87* 88* @param bool $ prependTOC следует ли здесь отображать оглавление? 89* @return bool true, если есть какой-либо вывод 90* 91* @triggers TPL_ACT_RENDER 92* @triggers TPL_CONTENT_DISPLAY 93* @автор Андреас Гор <andi@splitbrain.org> 94*/ 95функция tpl_content ($ prependTOC = true ) 96{ 97 глобальный $ ACT ; 98 глобальная $ ИНФОРМАЦИЯ ; 99 $ INFO [ 'prependTOC' ] = $ prependTOC ; 100 101 ob_start (); 102 Событие :: createAndTrigger ( 'TPL_ACT_RENDER' , $ ACT , 'tpl_content_core' ); 103 $ html_output = ob_get_clean (); 104 Событие :: createAndTrigger ( 'TPL_CONTENT_DISPLAY' , $ html_output , function ($ html_output ) { 105 echo $ html_output ; 106 }); 107 108 возврат ! пусто ($ html_output ); 109} 110 111/** 112* Действие по умолчанию TPL_ACT_RENDER 113* 114* @return bool 115*/ 116функция tpl_content_core () 117{ 118 $ router = ActionRouter :: getInstance (); 119 пытаться { 120 $ маршрутизатор -> getAction ()-> tplContent (); 121 } поймать ( FatalException $ e ) { 122 // не было контента для действия 123 сообщение ( hsc ($ e -> getMessage ()), -1 ); 124 вернуть ложь ; 125 } 126 вернуть истину ; 127} 128 129/** 130* Размещает оглавление там, где вызывается функция 131* 132* Если вы используете это, вы, скорее всего, захотите вызвать tpl_content с помощью 133* ложный аргумент 134* 135* @param bool $ return Следует ли вернуть оглавление вместо его печати? 136* @возвращаемая строка 137* 138* @автор Андреас Гор <andi@splitbrain.org> 139*/ 140функция tpl_toc ($ return = false ) 141{ 142 глобальный $ TOC ; 143 глобальный $ ACT ; 144 глобальный $ ID ; 145 глобальный $ REV ; 146 глобальная $ ИНФОРМАЦИЯ ; 147 глобальная $ conf ; 148 $ toc = []; 149 150 если ( is_array ($ TOC )) { 151 // если TOC был подготовлен в глобальном масштабе, всегда используйте его 152 $ toc = $ TOC ; 153 } elseif (($ ACT == 'show' || str_starts_with ($ ACT , 'export' )) && !$ REV && $ INFO [ 'exists' ]) { 154 // получить TOC из метаданных, отобразить при необходимости 155 $ meta = p_get_metadata ($ ID , '' , METADATA_RENDER_USING_CACHE ); 156 $ tocok = $ meta [ 'internal' ][ 'toc' ] ?? true ; 157 $ toc = $ meta [ 'description' ][ 'tableofcontents' ] ?? null ; 158 если (!$ tocok || ! is_array ($ toc ) || !$ conf [ 'tocminheads' ] || count ($ toc ) < $ conf [ 'tocminheads' ]) { 159 $ toc = []; 160 } 161 } elseif ($ ACT == 'админ' ) { 162 // попробуем загрузить оглавление плагина администратора 163 /** @var AdminPlugin $plugin */ 164 если ($ plugin = plugin_getRequestAdminPlugin ()) { 165 $ toc = $ plugin -> getTOC (); 166 $ TOC = $ toc ; // избежать последующей перестройки 167 } 168 } 169 170 Событие :: createAndTrigger ( 'TPL_TOC_RENDER' , $ toc , null , false ); 171 $ html = html_TOC ($ toc ); 172 если ($ return ) вернуть $ html ; 173 эхо $ html ; 174 возвращаться '' ; 175} 176 177/** 178* Обработка содержимого страницы администратора 179* 180* @return bool 181* 182* @автор Андреас Гор <andi@splitbrain.org> 183*/ 184функция tpl_admin () 185{ 186 глобальная $ ИНФОРМАЦИЯ ; 187 глобальный $ TOC ; 188 глобальный $ ВХОД ; 189 190 $ плагин = null ; 191 $ класс = $ ВХОД -> стр ( 'страница' ); 192 если (! пусто ($ класс )) { 193 $ pluginlist = plugin_list ( 'admin' ); 194 195 если ( in_array ($ class , $ pluginlist )) { 196 // попытка загрузить плагин 197 /** @var AdminPlugin $plugin */ 198 $ plugin = plugin_load ( 'admin' , $ class ); 199 } 200 } 201 202 если ($ plugin instanceof PluginInterface ) { 203 if (! is_array ($ TOC )) $ TOC = $ plugin -> getTOC (); //если TOC еще не был запрошен 204 если ($ INFO [ 'prependTOC' ]) tpl_toc (); 205 $ плагин -> html (); 206 } еще { 207 $ админ = новый Администратор (); 208 $ админ -> показать (); 209 } 210 вернуть истину ; 211} 212 213/** 214* Распечатайте правильные HTML-мета-заголовки 215* 216* Это необходимо разместить в заголовке вашего шаблона. 217* 218* @param bool $ alt Нужно ли добавлять каналы и ссылки альтернативного формата? 219* @return bool 220* @вызывает JsonException 221* 222* @автор Андреас Гор <andi@splitbrain.org> 223* @triggers TPL_METAHEADER_OUTPUT 224*/ 225функция tpl_metaheaders ($ alt = true ) 226{ 227 глобальный $ ID ; 228 глобальный $ REV ; 229 глобальная $ ИНФОРМАЦИЯ ; 230 глобальный $ JSINFO ; 231 глобальный $ ACT ; 232 глобальный $ ЗАПРОС ; 233 глобальный $ lang ; 234 глобальная $ conf ; 235 глобальная $ updateVersion ; 236 /** @var Вход $INPUT */ 237 глобальный $ ВХОД ; 238 239 // подготавливаем массив головок 240 $ голова = []; 241 242 // подготовить seed для js и css 243 $ tseed = $ updateVersion ; 244 $ зависит = getConfigFiles ( 'main' ); 245 $ зависит [] = DOKU_CONF . "tpl/" . $ conf [ 'template' ] . "/style.ini" ; 246 foreach ($ зависит от $ f ) $ tseed .= @ filemtime ($ f ); 247 $ tseed = md5 ($ tseed ); 248 249 // обычные вещи 250 $ head [ 'meta' ][] = [ 'name' => 'generator' , 'content' => 'DokuWiki' ]; 251 если ( действиеOK ( 'поиск' )) { 252 $ head [ 'ссылка' ][] = [ 253 'rel' => 'поиск' , 254 'тип' => ' приложение / opensearchdescription +xml' , 255 'href' => DOKU_BASE . ' lib / exe / opensearch.php ' , 256 'заголовок' => $ conf [ 'заголовок' ] 257 ]; 258 } 259 260 $ head [ 'link' ][] = [ 'rel' => 'start' , 'href' => DOKU_BASE ]; 261 если ( действиеOK ( 'индекс' )) { 262 $ head [ 'ссылка' ][] = [ 263 'rel' => 'содержимое' , 264 'href' => wl ($ ID , 'do=index' , false , '&' ), 265 'title' => $ lang [ 'btn_index' ] 266 ]; 267 } 268 269 если ( действиеOK ( 'манифест' )) { 270 $ head [ 'ссылка' ][] = [ 271 'rel' => 'манифест' , 272 'href' => DOKU_BASE . ' lib / exe / manifest.php ' 273 ]; 274 } 275 276 $ styleUtil = new StyleUtils (); 277 $ styleIni = $ styleUtil -> cssStyleini (); 278 $ replacements = $ styleIni [ 'replacements' ]; 279 если (! пусто ($ replacements [ '__theme_color__' ])) { 280 $ голова [ 'мета' ][] = [ 281 'имя' => 'цвет темы' , 282 'content' => $ replacements [ '__theme_color__' ] 283 ]; 284 } 285 286 если ($ альт ) { 287 если ( действиеOK ( 'rss' )) { 288 $ head [ 'ссылка' ][] = [ 289 'rel' => 'альтернативный' , 290 'тип' => ' приложение / rss +xml' , 291 'title' => $ lang [ 'btn_recent' ], 292 'href' => DOKU_BASE . ' feed.php ' 293 ]; 294 $ head [ 'ссылка' ][] = [ 295 'rel' => 'альтернативный' , 296 'тип' => ' приложение / rss +xml' , 297 'title' => $ lang [ 'currentns' ], 298 'href' => DOKU_BASE . ' feed.php ?mode=list&ns=' . ( isset ($ INFO ) ? $ INFO [ 'namespace' ] : '' ) 299 ]; 300 } 301 если (($ ACT == 'показать' || $ ACT == 'поиск' ) && $ INFO [ 'записываемый' ]) { 302 $ head [ 'ссылка' ][] = [ 303 'rel' => 'редактировать' , 304 'title' => $ lang [ 'btn_edit' ], 305 'href' => wl ($ ID , 'do=edit' , false , '&' ) 306 ]; 307 } 308 309 если ( actionOK ( 'rss' ) && $ ACT == 'search' ) { 310 $ head [ 'ссылка' ][] = [ 311 'rel' => 'альтернативный' , 312 'тип' => ' приложение / rss +xml' , 313 'title' => $ lang [ 'searchresult' ], 314 'href' => DOKU_BASE . ' feed.php ?mode=search&q=' . $ ЗАПРОС 315 ]; 316 } 317 318 если ( actionOK ( 'export_xhtml' )) { 319 $ head [ 'ссылка' ][] = [ 320 'rel' => 'альтернативный' , 321 'тип' => ' текст / html ' , 322 'title' => $ lang [ 'plainhtml' ], 323 'href' => экспортссылка ($ ID , 'xhtml' , '' , false , '&' ) 324 ]; 325 } 326 327 если ( actionOK ( 'export_raw' )) { 328 $ head [ 'ссылка' ][] = [ 329 'rel' => 'альтернативный' , 330 'тип' => ' текст / обычный ' , 331 'title' => $ lang [ 'wikimarkup' ], 332 'href' => экспортссылка ($ ID , 'raw' , '' , false , '&' ) 333 ]; 334 } 335 } 336 337 // настройка тегов робота, подходящих для разных режимов 338 если (($ ACT == 'show' || $ ACT == 'export_xhtml' ) && !$ REV ) { 339 если ($ INFO [ 'существует' ]) { 340 //задержка индексации: 341 если (( время () - $ INFO [ 'lastmod' ]) >= $ conf [ 'indexdelay' ] && ! isHiddenPage ($ ID )) { 342 $ head [ 'meta' ][] = [ 'name' => 'robots' , 'content' => 'index,follow' ]; 343 } еще { 344 $ head [ 'meta' ][] = [ 'name' => 'robots' , 'content' => 'noindex,nofollow' ]; 345 } 346 $ canonicalUrl = wl ($ ID , '' , true , '&' ); 347 если ($ ID == $ conf [ 'start' ]) { 348 $ canonicalUrl = DOKU_URL ; 349 } 350 $ head [ 'link' ][] = [ 'rel' => 'canonical' , 'href' => $ canonicalUrl ]; 351 } еще { 352 $ head [ 'meta' ][] = [ 'name' => 'robots' , 'content' => 'noindex,follow' ]; 353 } 354 } elseif ( определено ('DOKU_MEDIADETAIL')) { 355 $ head [ 'meta' ][] = [ 'name' => 'robots' , 'content' => 'index,follow' ]; 356 } еще { 357 $ head [ 'meta' ][] = [ 'name' => 'robots' , 'content' => 'noindex,nofollow' ]; 358 } 359 360 // установить метаданные 361 если ($ ACT == 'показать' || $ ACT == 'export_xhtml' ) { 362 // ключевые слова (явные или неявные) 363 если (! пусто ($ INFO [ 'meta' ][ 'subject' ])) { 364 $ head [ 'meta' ][] = [ 'name' => 'keywords' , 'content' => implode ( ',' , $ INFO [ 'meta' ][ 'subject' ])]; 365 } еще { 366 $ head [ 'meta' ][] = [ 'name' => 'keywords' , 'content' => str_replace ( ':' , ',' , $ ID )]; 367 } 368 } 369 370 // загрузка таблиц стилей 371 $ head [ 'ссылка' ][] = [ 372 'rel' => 'таблица стилей' , 373 'href' => DOKU_BASE . ' lib / exe / css.php ?t=' . rawurlencode ($ conf [ 'template' ]) . '&tseed=' . $ tseed 374 ]; 375 376 $ script = "var NS=" . ( isset ($ INFO ) ? $ INFO [ 'namespace' ] : '' ) . "';" ; 377 если ($ conf [ 'useacl' ] && $ INPUT -> сервер -> str ( 'REMOTE_USER' )) { 378 $ скрипт .= "var SIG=" . тулбар_сигнатура () . ";" ; 379 } 380 jsinfo (); 381 $ script .= 'var JSINFO = ' . json_encode ($ JSINFO , JSON_THROW_ON_ERROR ) . ';' ; 382 $ script .= '(function(H){H.className=H.className.replace(/\bno-js\b/, \' js \' )})(document.documentElement);' ; 383 $ head [ 'script' ][] = [ '_data' => $ script ]; 384 385 // загрузить jquery 386 $ jquery = getCdnUrls (); 387 foreach ($ jquery как $ src ) { 388 $ head [ 'скрипт' ][] = [ 389 '_data' => '' , 390 'источник' => $ источник 391 ] + ($ conf [ 'defer_js' ] ? [ 'defer' => 'defer' ] : []); 392 } 393 394 // загружаем наш диспетчер javascript 395 $ head [ 'скрипт' ][] = [ 396 '_data' => '' , 397 'src' => DOKU_BASE . ' lib / exe / js.php ' . '?t=' . rawurlencode ($ conf [ 'шаблон' ]) . '&tseed=' . $ семя 398 ] + ($ conf [ 'defer_js' ] ? [ 'defer' => 'defer' ] : []); 399 400 // вызвать событие здесь 401 Событие :: createAndTrigger ( 'TPL_METAHEADER_OUTPUT' , $ head , '_tpl_metaheaders_action' , true ); 402 вернуть истину ; 403} 404 405/** 406* печатает массив, созданный tpl_metaheaders 407* 408* $data — это массив различных тегов заголовков. Каждый тег может иметь несколько 409* экземпляры. Атрибуты задаются как пары ключ-значение. Значения будут HTML 410* кодируются автоматически, поэтому их следует предоставлять как есть в массиве $data. 411* 412* Для тегов, имеющих атрибут body, укажите данные body в специальном поле 413* атрибут '_data'. Это поле НЕ БУДЕТ ЭКРАНИРОВАНО автоматически. 414* 415* Встроенные скрипты будут использовать любой одноразовый номер, указанный в переменной среды «NONCE». 416* 417* @param массив $ данные 418* 419* @автор Андреас Гор <andi@splitbrain.org> 420*/ 421функция _tpl_metaheaders_action ($ data ) 422{ 423 $ nonce = getenv ( 'NONCE' ); 424 foreach ($ data как $ tag => $ inst ) { 425 foreach ($ inst as $ attr ) { 426 если ( пусто ($ attr )) { 427 продолжать ; 428 } 429 если ($ nonce && $ tag == 'script' && ! empty ($ attr [ '_data' ])) { 430 $ attr [ 'nonce' ] = $ nonce ; // добавить nonce к встроенным тегам скрипта 431 } 432 echo '<' , $ tag , ' ' , buildAttributes ($ attr ); 433 если ( isset ($ attr [ '_data' ]) || $ tag == 'script' ) { 434 echo '>' , $ attr [ '_data' ] ?? '' , '</' , $ tag , '>' ; 435 } еще { 436 эхо '/>' ; 437 } 438 эхо " \n " ; 439 } 440 } 441} 442 443/** 444* Вывести данный скрипт как встроенный тег скрипта 445* 446* Эта функция добавит атрибут nonce, если он доступен. 447* 448* Скрипт НЕ экранируется автоматически! 449* 450* @param string $ скрипт 451* @param bool $ return Возврат или прямая печать? 452* @return string | недействительный 453*/ 454функция tpl_inlineScript ($ script , $ return = false ) 455{ 456 $ nonce = getenv ( 'NONCE' ); 457 если ($ nonce ) { 458 $ скрипт = '<script nonce="' . $ nonce . '">' . $ скрипт . '</script>' ; 459 } еще { 460 $ скрипт = '<скрипт>' . $ скрипт . '</скрипт>' ; 461 } 462 463 если ($ return ) return $ script ; 464 эхо $ скрипт ; 465} 466 467/** 468* Распечатать ссылку 469* 470* Просто создает ссылку. 471* 472* @param string $ url 473* @param string $ имя 474* @param string $ еще 475* @param bool $ return если true вернуть ссылку html, в противном случае вывести 476* @return bool | строка html ссылки или true, если выводится 477* 478* @автор Андреас Гор <andi@splitbrain.org> 479*/ 480функция tpl_link ($ url , $ name , $ more = '' , $ return = false ) 481{ 482 $ out = '<a href="' . $ url . '" ' ; 483 если ($ more ) $ out .= ' ' . $ more ; 484 $ out .= "> $ имя </a>" ; 485 если ($ return ) вернуть $ out ; 486 вывести $ ; 487 вернуть истину ; 488} 489 490/** 491* Печатает ссылку на WikiPage 492* 493* Обертка вокруг html_wikilink 494* 495* @param string $ id идентификатор страницы 496* @param string | null $ name имя ссылки 497* @param bool $ возврат 498* @return true | строка 499* 500* @автор Андреас Гор <andi@splitbrain.org> 501*/ 502функция tpl_pagelink ($ id , $ name = null , $ return = false ) 503{ 504 $ out = '<bdi>' . html_wikilink ( $ id , $ name ) . '</bdi>' ; 505 если ($ return ) вернуть $ out ; 506 вывести $ ; 507 вернуть истину ; 508} 509 510/** 511* получить родительскую страницу 512* 513* Пытается выяснить, какая страница является родительской. 514* возвращает false, если ничего не доступно 515* 516* @param string $ id идентификатор страницы 517* @return false | строка 518* 519* @автор Андреас Гор <andi@splitbrain.org> 520*/ 521функция tpl_getparent ($ id ) 522{ 523 $ resolver = new PageResolver ( 'root' ); 524 525 $ parent = getNS ($ id ). ':' ; 526 $ parent = $ resolver -> resolveId ($ parent ); 527 если ($ родитель == $ идентификатор ) { 528 $ pos = strrpos ( getNS ($ id ), ':' ); 529 $ parent = substr ($ parent , 0 , $ pos ). ':' ; 530 $ parent = $ resolver -> resolveId ($ parent ); 531 если ($ parent == $ id ) вернуть false ; 532 } 533 вернуть $ родитель ; 534} 535 536/** 537* Распечатать одну из кнопок 538* 539* @param string $ тип 540* @param bool $ возврат 541* @return bool | string html, или false, если данных нет, true, если выведено 542* @see tpl_get_action 543* 544* @автор Адриан Лэнг <mail@adrianlang.de> 545* @deprecated 2017-09-01 см. devel:menus 546*/ 547функция tpl_button ($ тип , $ возврат = ложь ) 548{ 549 dbg_deprecated ( 'см. devel:menus' ); 550 $ data = tpl_get_action ($ type ); 551 если ($ данные === ложь ) { 552 вернуть ложь ; 553 } elseif (! is_array ($ data )) { 554 $ out = sprintf ($ data , 'button' ); 555 } еще { 556 /** 557 * @var string $accesskey 558 * @var string $id 559 * @var string $метод 560 * @var массив $params 561 */ 562 извлечь ($ data ); 563 если ($ id === '#dokuwiki__top' ) { 564 $ out = html_topbtn (); 565 } еще { 566 $ out = html_btn ($ type , $ id , $ accesskey , $ params , $ method ); 567 } 568 } 569 если ($ return ) вернуть $ out ; 570 вывести $ ; 571 вернуть истину ; 572} 573 574/** 575* Как кнопки действий, но ссылки 576* 577* @param string $ тип действие команда 578* @param string $ pre префикс ссылки 579* @param string $ suf суффикс ссылки 580* @param string $ внутренний innerHML ссылки 581* @param bool $ return если true, то возвращает html, в противном случае печатает 582* @return bool | string html или false, если данных нет, true, если выведено 583* 584* @see tpl_get_action 585* @автор Адриан Лэнг <mail@adrianlang.de> 586* @deprecated 2017-09-01 см. devel:menus 587*/ 588функция tpl_actionlink ($ type , $ pre = '' , $ suf = '' , $ inner = '' , $ return = false ) 589{ 590 dbg_deprecated ( 'см. devel:menus' ); 591 глобальный $ lang ; 592 $ data = tpl_get_action ($ type ); 593 если ($ данные === ложь ) { 594 вернуть ложь ; 595 } elseif (! is_array ($ data )) { 596 $ out = sprintf ($ data , 'link' ); 597 } еще { 598 /** 599 * @var string $accesskey 600 * @var string $id 601 * @var string $метод 602 * @var bool $nofollow 603 * @var массив $params 604 * @var string $replacement 605 */ 606 извлечь ($ data ); 607 если ( strpos ($ id , '#' ) === 0 ) { 608 $ linktarget = $ id ; 609 } еще { 610 $ linktarget = wl ($ id , $ params ); 611 } 612 $ caption = $ lang [ 'btn_' . $ type ]; 613 если ( strpos ($ caption , '%s' )) { 614 $ caption = sprintf ($ caption , $ replacement ); 615 } 616 $ akey = '' ; 617 $ addTitle = '' ; 618 если ($ accesskey ) { 619 $ akey = 'accesskey="' . $ accesskey . '" ' ; 620 $ addTitle = '[' . strtoupper ($ accesskey ) . ']' ; 621 } 622 $ rel = $ nofollow ? 'rel="nofollow" ' : '' ; 623 $ out = tpl_link ( 624 $ ссылкацель , 625 $ pre . ($ inner ?: $ caption ) . $ suf , 626 'класс="действие' . $ тип . '" ' . 627 $ akey . $ rel . 628 'title="' . hsc ($ caption ) . $ addTitle . '"' , 629 истинный 630 ); 631 } 632 если ($ return ) вернуть $ out ; 633 вывести $ ; 634 вернуть истину ; 635} 636 637/** 638* Проверьте действия и получите данные для кнопок и ссылок 639* 640* @param string $ тип 641* @return массив | bool | строка 642* 643* @автор Адриан Лэнг <mail@adrianlang.de> 644* @автор Андреас Гор <andi@splitbrain.org> 645* @автор Маттиас Гримм <matthiasgrimm@users.sourceforge.net> 646* @deprecated 2017-09-01 см. devel:menus 647*/ 648функция tpl_get_action ($ тип ) 649{ 650 dbg_deprecated ( 'см. devel:menus' ); 651 если ($ type == 'history' ) $ type = 'revisions' ; 652 если ($ type == 'подписка' ) $ type = 'подписка' ; 653 если ($ type == 'img_backto' ) $ type = 'imgBackto' ; 654 655 $ class = ' \\ dokuwiki \\ Меню \\ Элемент \\ ' . ucfirst ($ type ); 656 если ( class_exists ($ class )) { 657 пытаться { 658 /** @var AbstractItem $item */ 659 $ item = новый $ class (); 660 $ data = $ item -> getLegacyData (); 661 $ неизвестно = ложь ; 662 } catch ( RuntimeException $ игнорируется ) { 663 вернуть ложь ; 664 } 665 } еще { 666 глобальный $ ID ; 667 $ данные = [ 668 'accesskey' => null , 669 'тип' => $ тип , 670 'id' => $ ID , 671 'метод' => 'получить' , 672 'params' => [ 'do' => $ type ], 673 'nofollow' => правда , 674 'замена' => '' 675 ]; 676 $ неизвестно = правда ; 677 } 678 679 $ evt = новое событие ( 'TPL_ACTION_GET' , $ data ); 680 если ($ evt -> advice_before ()) { 681 //обработка неизвестных типов 682 если ($ неизвестно ) { 683 $ data = '[неизвестный тип %s]' ; 684 } 685 } 686 $ evt -> advice_after (); 687 снято ($ evt ); 688 689 вернуть $ данные ; 690} 691 692/** 693* Обертка вокруг tpl_button() и tpl_actionlink() 694* 695* @param string $ тип действие команда 696* @param bool $ ссылка ссылка или кнопка формы? 697* @param string | bool $ wrapper Обертка HTML-элемента 698* @param bool $ return return или print 699* @param string $ pre префикс для ссылок 700* @param string $ suf суффикс для ссылок 701* @param string $ внутренний внутренний HTML для ссылок 702* @return bool | строка 703* 704* @автор Аника Хенке <anika@selfthinker.org> 705* @deprecated 2017-09-01 см. devel:menus 706*/ 707функция tpl_action ($ type , $ link = false , $ wrapper = false , $ return = false , $ pre = '' , $ suf = '' , $ inner = '' ) 708{ 709 dbg_deprecated ( 'см. devel:menus' ); 710 $ out = '' ; 711 если ($ ссылка ) { 712 $ out .= tpl_actionlink ($ type , $ pre , $ suf , $ inner , true ); 713 } еще { 714 $ out .= tpl_button ( $ type , true ); 715 } 716 если ($ out && $ wrapper ) $ out = "< $ wrapper > $ out </ $ wrapper >" ; 717 718 если ($ return ) вернуть $ out ; 719 вывести $ ; 720 return ( bool )$ out ; 721} 722 723/** 724* Распечатать форму поиска 725* 726* Если первый параметр задан как div с идентификатором 'qsearch_out', то будет 727* добавляется, который инструктирует страницу ajax quicksearch включиться и разместить 728* его вывод в этот div. Второй параметр управляет собственным 729* атрибут автозаполнения. Если установлено значение false, этот атрибут будет установлен с 730* значение "off" указывает браузеру отключить встроенные функции 731* функция автодополнения (MSIE и Firefox) 732* 733* @param bool $ ajax 734* @param bool $ автозаполнение 735* @return bool 736* 737* @автор Андреас Гор <andi@splitbrain.org> 738*/ 739функция tpl_searchform ($ ajax = true , $ autocomplete = true ) 740{ 741 глобальный $ lang ; 742 глобальный $ ACT ; 743 глобальный $ ЗАПРОС ; 744 глобальный $ ID ; 745 746 // не печатать форму поиска, если действие поиска отключено 747 если (! actionOK ( 'search' )) вернуть false ; 748 749 $ searchForm = новая форма ([ 750 'действие' => wl (), 751 'метод' => 'получить' , 752 'роль' => 'поиск' , 753 'класс' => 'поиск' , 754 'id' => 'dw__search' , 755 ], истинный ); 756 $ searchForm -> addTagOpen ( 'div' )-> addClass ( 'no' ); 757 $ searchForm -> setHiddenField ( 'сделать' , 'поиск' ); 758 $ searchForm -> setHiddenField ( 'id' , $ ID ); 759 $ searchForm -> addTextInput ( 'q' ) 760 -> добавитьКласс ( 'редактировать' ) 761 -> атрибуты ([ 762 'заголовок' => '[F]' , 763 'accesskey' => 'f' , 764 'placeholder' => $ lang [ 'btn_search' ], 765 'autocomplete' => $ autocomplete ? 'on' : 'off' , 766 ]) 767 -> идентификатор ( 'qsearch__in' ) 768 -> val ($ ACT === 'поиск' ? $ QUERY : '' ) 769 -> useInput ( false ); 770 $ searchForm -> addButton ( '' , $ lang [ 'btn_search' ])-> attrs ([ 771 'тип' => 'отправить' , 772 'title' => $ lang [ 'btn_search' ], 773 ]); 774 если ($ ajax ) { 775 $ searchForm -> addTagOpen ( 'div' )-> id ( 'qsearch__out' )-> addClass ( 'ajax_qsearch JSpopup' ); 776 $ searchForm -> addTagClose ( 'div' ); 777 } 778 $ searchForm -> addTagClose ( 'div' ); 779 780 echo $ searchForm -> toHTML ( 'Быстрый поиск' ); 781 782 вернуть истину ; 783} 784 785/** 786* Распечатать след навигационной цепочки 787* 788* @param string $ sep Разделитель между записями 789* @param bool $ return return или print 790* @return bool | строка 791* 792* @автор Андреас Гор <andi@splitbrain.org> 793*/ 794функция tpl_breadcrumbs ($ sep = null , $ return = false ) 795{ 796 глобальный $ lang ; 797 глобальная $ conf ; 798 799 //проверить, включено ли 800 если (!$ conf [ 'хлебные крошки' ]) вернуть false ; 801 802 //установить значение по умолчанию 803 если ( is_null ($ sep )) $ sep = '•' ; 804 805 $ out = '' ; 806 807 $ crumbs = breadcrumbs (); //настройка трассировки крошек 808 809 $ crumbs_sep = ' <span class="bcsep">' . $ sep . '</span> ' ; 810 811 //рендерим крошки, выделяем последнюю 812 $ out .= '<span class="bchead">' . $ lang [ 'хлебные крошки' ] . '</span>' ; 813 $ last = count ($ crubs ); 814 $ я = 0 ; 815 foreach ($ крошки как $ id => $ name ) { 816 $ я ++; 817 $ out .= $ crumbs_sep ; 818 если ($ i == $ last ) $ out .= '<span class="curid">' ; 819 $ out .= '<bdi>' . tpl_link ( wl ( $ id ), hsc ( $ name ), ' class="breadcrumbs" title="' . $ id . '"' , true ) . '</bdi>' ; 820 если ($ i == $ last ) $ out .= '</span>' ; 821 } 822 если ($ return ) вернуть $ out ; 823 вывести $ ; 824 return ( bool )$ out ; 825} 826 827/** 828* Иерархическая навигационная цепочка 829* 830* Этот код был предложен в качестве замены обычным хлебным крошкам. 831* Имеет смысл только при наличии глубокой структуры сайта. 832* 833* @param string $ sep Разделитель между записями 834* @param bool $ return return или print 835* @return bool | строка 836* 837* @todo может вести себя странно в языках с письмом справа налево 838* @автор <fredrik@averpil.com> 839* @автор Андреас Гор <andi@splitbrain.org> 840* @автор Найджел Макни <oracle.shinoda@gmail.com> 841* @автор Шон Коутс <sean@caedmon.net> 842*/ 843функция tpl_youarehere ($ sep = null , $ return = false ) 844{ 845 глобальная $ conf ; 846 глобальный $ ID ; 847 глобальный $ lang ; 848 849 // проверить, включено ли 850 если (!$ conf [ 'youarehere' ]) вернуть false ; 851 852 //установить значение по умолчанию 853 если ( is_null ($ sep )) $ sep = ' » ' ; 854 855 $ out = '' ; 856 857 $ parts = Explode ( ':' , $ ID ); 858 $ count = count ($ parts ); 859 860 $ out .= '<span class="bchead">' . $ lang [ 'выздесь' ] . ' </span>' ; 861 862 // всегда печатать стартовую страницу 863 $ out .= '<span class="home">' . tpl_pagelink ( ':' . $ conf [ 'start' ], null , true ) . '</span>' ; 864 865 // распечатать промежуточные ссылки пространства имен 866 $ часть = '' ; 867 для ($ i = 0 ; $ i < $ count - 1 ; $ i ++) { 868 $ часть .= $ часть [$ i ]. ':' ; 869 $ страница = $ часть ; 870 if ($ page == $ conf [ 'start' ]) continue ; // Пропустить начальную страницу 871 872 // выход 873 $ out .= $ sep . tpl_pagelink ( $ page , null , true ); 874 } 875 876 // распечатать текущую страницу, пропустив начальную страницу, пропустив индекс пространства имен 877 если ( isset ($ страница )) { 878 $ page = ( new PageResolver ( 'root' ))-> resolveId ( $ page ); 879 если ($ страница == $ часть . $ части [$ я ]) { 880 если ($ return ) вернуть $ out ; 881 вывести $ ; 882 вернуть истину ; 883 } 884 } 885 $ страница = $ часть . $ части [$ i ]; 886 если ($ страница == $ конф [ 'старт' ]) { 887 если ($ return ) вернуть $ out ; 888 вывести $ ; 889 вернуть истину ; 890 } 891 $ out .= $ sep ; 892 $ out .= tpl_pagelink ($ page , null , true ); 893 если ($ return ) вернуть $ out ; 894 вывести $ ; 895 return ( bool )$ out ; 896} 897 898/** 899* Распечатать информацию, если пользователь вошел в систему 900* и в этом случае показывать полное имя 901* 902* Можно ли в будущем добавить ссылку на профиль? 903* 904* @return bool 905* 906* @автор Андреас Гор <andi@splitbrain.org> 907*/ 908функция tpl_userinfo () 909{ 910 глобальный $ lang ; 911 /** @var Вход $INPUT */ 912 глобальный $ ВХОД ; 913 914 если ($ INPUT -> сервер -> str ( 'REMOTE_USER' )) { 915 echo $ lang [ 'loggedinas' ] . ' ' . userlink (); 916 вернуть истину ; 917 } 918 вернуть ложь ; 919} 920 921/** 922* Распечатать некоторую информацию о текущей странице 923* 924* @param bool $ ret возвращает содержимое вместо его печати 925* @return bool | строка 926* 927* @автор Андреас Гор <andi@splitbrain.org> 928*/ 929функция tpl_pageinfo ($ ret = false ) 930{ 931 глобальная $ conf ; 932 глобальный $ lang ; 933 глобальная $ ИНФОРМАЦИЯ ; 934 глобальный $ ID ; 935 936 // возвращаем, если нам не разрешено просматривать страницу 937 если (! auth_quickaclcheck ($ ID )) { 938 вернуть ложь ; 939 } 940 941 // подготовить дату и путь 942 $ fn = $ INFO [ 'путь_к_файлу' ]; 943 если (!$ conf [ 'полный_путь' ]) { 944 если ($ ИНФОРМАЦИЯ [ 'рев' ]) { 945 $ fn = str_replace ($ conf [ 'olddir' ] . '/' , '' , $ fn ); 946 } еще { 947 $ fn = str_replace ($ conf [ 'datadir' ] . '/' , '' , $ fn ); 948 } 949 } 950 $ fn = utf8_decodeFN ($ fn ); 951 $ date = dformat ($ INFO [ 'lastmod' ]); 952 953 // распечатать это 954 если ($ INFO [ 'существует' ]) { 955 $ out = '<bdi>' . $ fn . '</bdi>' ; 956 $ out .= ' · ' ; 957 $ out .= $ lang [ 'lastmod' ]; 958 $ out .= ' ' ; 959 $ out .= $ date ; 960 если ($ INFO [ 'редактор' ]) { 961 $ out .= ' ' . $ lang [ 'by' ] . ' ' ; 962 $ out .= '<bdi>' . editorinfo ($ INFO [ 'editor' ]) . '</bdi>' ; 963 } еще { 964 $ out .= ' (' . $ lang [ 'external_edit' ] . ')' ; 965 } 966 если ($ INFO [ 'заблокировано' ]) { 967 $ out .= ' · ' ; 968 $ out .= $ lang [ 'lockedby' ]; 969 $ out .= ' ' ; 970 $ out .= '<bdi>' . editorinfo ($ INFO [ 'locked' ]) . '</bdi>' ; 971 } 972 если ($ рет ) { 973 возврат $ из ; 974 } еще { 975 вывести $ ; 976 вернуть истину ; 977 } 978 } 979 вернуть ложь ; 980} 981 982/** 983* Печатает или возвращает имя указанной страницы (текущей, если не указано). 984* 985* Если включено использование заголовка, будет использоваться первый заголовок, в противном случае 986* используется указанный идентификатор. 987* 988* @param string $ id идентификатор страницы 989* @param bool $ ret возвращает содержимое вместо печати 990* @return bool | строка 991* 992* @автор Андреас Гор <andi@splitbrain.org> 993*/ 994функция tpl_pagetitle ($ id = null , $ ret = false ) 995{ 996 глобальные $ ACT , $ conf , $ lang ; 997 998 если ( is_null ($ id )) { 999 глобальный $ ID ; 1000 $ id = $ ID ; 1001 } 1002 1003 $ имя = $ идентификатор ; 1004 если ( useHeading ( 'навигация' )) { 1005 $ first_heading = p_get_first_heading ($ id ); 1006 если ($ first_heading ) $ name = $ first_heading ; 1007 } 1008 1009 // заголовок страницы по умолчанию — это имя страницы, измените его с помощью текущего действия 1010 переключатель ($ ACT ) { 1011 // административные функции 1012 случай «администратор» : 1013 $ page_title = $ lang [ 'btn_admin' ]; 1014 // попробуем получить имя плагина 1015 /** @var AdminPlugin $plugin */ 1016 если ($ plugin = plugin_getRequestAdminPlugin ()) { 1017 $ plugin_title = $ plugin -> getMenuText ($ conf [ 'lang' ]); 1018 $ page_title = $ plugin_title ?: $ plugin -> getPluginName (); 1019 } 1020 перерыв ; 1021 1022 // показать действие как заголовок 1023 случай «логин» : 1024 кейс «профиль» : 1025 случай «регистр» : 1026 случай 'resendpwd' : 1027 случай «индекс» : 1028 случай «поиск» : 1029 $ page_title = $ lang [ 'btn_' . $ ACT ]; 1030 перерыв ; 1031 1032 // добавить ручку во время редактирования 1033 случай «редактирование» : 1034 случай «предварительный просмотр» : 1035 $ page_title = "✎ " . $ name ; 1036 перерыв ; 1037 1038 // добавить действие к названию страницы 1039 дело «пересмотры» : 1040 $ page_title = $ name . ' - ' . $ lang [ 'btn_revs' ]; 1041 перерыв ; 1042 1043 // добавить действие к названию страницы 1044 случай «обратная ссылка» : 1045 случай «недавний» : 1046 случай «подписаться» : 1047 $ page_title = $ name .'- ' .$ lang [ 'btn_' .$ ACT ]; 1048 перерыв ; 1049 1050 по умолчанию : // SHOW и все остальное, что не включено 1051 $ page_title = $ name ; 1052 } 1053 1054 если ($ рет ) { 1055 вернуть hsc ($ page_title ); 1056 } еще { 1057 echo hsc ($ page_title ); 1058 вернуть истину ; 1059 } 1060} 1061 1062/** 1063* Возвращает запрошенный тег EXIF / IPTC из текущего изображения 1064* 1065* Если $tags — это массив, то все заданные теги проверяются до тех пор, пока не будет найден 1066* значение найдено. Если значение не найдено, возвращается $alt. 1067* 1068* Какие тексты известны, определяется в функциях _exifTagNames 1069* и _iptcTagNames() в inc / jpeg.php (Вам необходимо добавить IPTC 1070* к именам последнего) 1071* 1072* Разрешено только в: detail.php 1073* 1074* @param array | string $ tags тег или массив тегов для проверки 1075* @param string $ alt альтернативный вывод, если данные не найдены 1076* @param null | string $ src источник изображения, если не указан, используется глобальный $SRC 1077* @возвращаемая строка 1078* 1079* @автор Андреас Гор <andi@splitbrain.org> 1080*/ 1081функция tpl_img_getTag ($ tags , $ alt = '' , $ src = null ) 1082{ 1083 // Инициализация Exif-ридера 1084 глобальный $ SRC , $ imgMeta ; 1085 1086 если ( is_null ($ src )) $ src = $ SRC ; 1087 если ( is_null ($ src )) вернуть $ alt ; 1088 1089 если (! isset ($ imgMeta )) { 1090 $ imgMeta = new JpegMeta ($ src ); 1091 } 1092 если ($ imgMeta === false ) вернуть $ alt ; 1093 $ info = cleanText ($ imgMeta -> getField ($ tags )); 1094 если (!$ info ) вернуть $ alt ; 1095 вернуть $ информацию ; 1096} 1097 1098 1099/** 1100* Мусор собирает открытый объект JpegMeta. 1101*/ 1102функция tpl_img_close () 1103{ 1104 глобальный $ imgMeta ; 1105 $ imgMeta = null ; 1106} 1107 1108/** 1109* Выводит HTML-список описаний метатегов текущего изображения 1110*/ 1111функция tpl_img_meta () 1112{ 1113 глобальный $ lang ; 1114 1115 $ теги = tpl_get_img_meta (); 1116 1117 эхо '<dl>' ; 1118 foreach ($ теги как $ теги ) { 1119 $ label = $ lang [$ tag [ 'langkey' ]]; 1120 если (!$ label ) $ label = $ tag [ 'langkey' ]. ':' ; 1121 1122 echo '<dt>' . $ label . '</dt><dd>' ; 1123 если ($ тег [ 'тип' ] == 'дата' ) { 1124 echo dformat ($ тег [ 'значение' ]); 1125 } еще { 1126 echo hsc ($ тег [ 'значение' ]); 1127 } 1128 эхо '</dd>' ; 1129 } 1130 эхо '</dl>' ; 1131} 1132 1133/** 1134* Возвращает метаданные, настроенные в файле конфигурации mediameta, готовые для создания html 1135* 1136* @return массив с массивами, содержащими записи: 1137* - строка langkey key для поиска в переменной $lang, если не найдена, выводится как есть 1138* - строковый тип значения 1139* - строковое значение тега (неэкранированное) 1140*/ 1141функция tpl_get_img_meta () 1142{ 1143 1144 $ config_files = getConfigFiles ( 'mediameta' ); 1145 foreach ($ config_files как $ config_file ) { 1146 если ( file_exists ($ config_file )) { 1147 включить ($ config_file ); 1148 } 1149 } 1150 $ теги = []; 1151 foreach ($ поля как $ тег ) { 1152 $ т = []; 1153 если (! пусто ($ тег [ 0 ])) { 1154 $ т = [$ тег [ 0 ]]; 1155 } 1156 если ( isset ($ тег [ 3 ]) && is_array ($ тег [ 3 ])) { 1157 $ t = array_merge ($ t , $ tag [ 3 ]); 1158 } 1159 $ value = tpl_img_getTag ($ t ); 1160 если ($ значение ) { 1161 $ теги [] = [ 'langkey' => $ тег [ 1 ], 'type' => $ тег [ 2 ], 'value' => $ значение ]; 1162 } 1163 } 1164 вернуть $ теги ; 1165} 1166 1167/** 1168* Печатает изображение со ссылкой на полноразмерную версию 1169* 1170* Разрешено только в: detail.php 1171* 1172* @triggers TPL_IMG_DISPLAY 1173* @param int $ maxwidth - максимальная ширина изображения 1174* @param int $ maxheight - максимальная высота изображения 1175* @param bool $ link - ссылка на исходный размер? 1176* @param array $ params - дополнительные атрибуты изображения 1177* @return bool Результат TPL_IMG_DISPLAY 1178*/ 1179функция tpl_img ($ maxwidth = 0 , $ maxheight = 0 , $ link = true , $ params = null ) 1180{ 1181 глобальный $ IMG ; 1182 /** @var Вход $INPUT */ 1183 глобальный $ ВХОД ; 1184 глобальный $ REV ; 1185 $ w = ( int ) tpl_img_getTag ( 'Файл.Ширина' ); 1186 $ h = ( int ) tpl_img_getTag ( 'Файл.Высота' ); 1187 1188 //изменить размер до указанных максимальных значений 1189Коэффициент $ = 1 ; 1190 если ($ w >= $ h ) { 1191 если ($ максширина && $ w >= $ максширина ) { 1192 $ отношение = $ максимальнаяширина / $ w ; 1193 } elseif ($ maxheight && $ h > $ maxheight ) { 1194 $ отношение = $ максимальная высота / $ h ; 1195 } 1196 } elseif ($ maxheight && $ h >= $ maxheight ) { 1197 $ отношение = $ максимальная высота / $ h ; 1198 } elseif ($ maxwidth && $ w > $ maxwidth ) { 1199 $ отношение = $ максимальнаяширина / $ w ; 1200 } 1201 если ($ отношение ) { 1202 $ w = пол ($ отношение * $ w ); 1203 $ h = пол ( соотношение $ * $ h ); 1204 } 1205 1206 //подготовить URL-адреса 1207 $ url = ml ($ IMG , [ 'cache' => $ INPUT -> str ( 'cache' ), 'rev' => $ REV ], true , '&' ); 1208 $ src = ml ($ IMG , [ 'cache' => $ INPUT -> str ( 'cache' ), 'rev' => $ REV , 'w' => $ w , 'h' => $ h ], true , '&' ); 1209 1210 //подготовить атрибуты 1211 $ alt = tpl_img_getTag ( 'Простой.Заголовок' ); 1212 если ( is_null ($ params )) { 1213 $ р = []; 1214 } еще { 1215 $ p = $ параметры ; 1216 } 1217 если ($ w ) $ p [ 'ширина' ] = $ w ; 1218 если ($ h ) $ p [ 'высота' ] = $ h ; 1219 $ p [ 'class' ] = 'img_detail' ; 1220 если ($ альт ) { 1221 $ p [ 'alt' ] = $ alt ; 1222 $ p [ 'title' ] = $ alt ; 1223 } еще { 1224 $ p [ 'alt' ] = '' ; 1225 } 1226 $ p [ 'источник' ] = $ источник ; 1227 1228 $ data = [ 'url' => ($ link ? $ url : null ), 'params' => $ p ]; 1229 return Event :: createAndTrigger ( 'TPL_IMG_DISPLAY' , $ data , '_tpl_img_action' , true ); 1230} 1231 1232/** 1233* Действие по умолчанию для TPL_IMG_DISPLAY 1234* 1235* @param массив $ данные 1236* @return bool 1237*/ 1238функция _tpl_img_action ($ data ) 1239{ 1240 глобальный $ lang ; 1241 $ p = buildAttributes ($ data [ 'params' ]); 1242 1243 если ($ data [ 'url' ]) echo ' <a href="' . hsc ($ data [ 'url' ]) . '" title="' . $ lang [ 'mediaview' ] . '"> ' ; 1244 echo '<img ' . $ p . '/>' ; 1245 если ($ data [ 'url' ]) echo '</a>' ; 1246 вернуть истину ; 1247} 1248 1249/** 1250* Эта функция вставляет небольшой gif-файл, который на самом деле является функцией индексатора. 1251* 1252* Должен вызываться где-то в самом конце шаблона main.php 1253* 1254* @return bool 1255*/ 1256функция tpl_indexerWebBug () 1257{ 1258 глобальный $ ID ; 1259 1260 $ р = []; 1261 $ p [ 'src' ] = DOKU_BASE . ' lib / exe / taskrunner.php ?id=' . rawurlencode ($ ID ) . 1262 '&' . время (); 1263 $ p [ 'width' ] = 2 ; //больше никаких изображений размером 1x1 пиксель, потому что мы живем во времена блокировщиков рекламы... 1264 $ p [ 'высота' ] = 1 ; 1265 $ p [ 'alt' ] = '' ; 1266 $ att = buildAttributes ($ p ); 1267 echo "<img $ att />" ; 1268 вернуть истину ; 1269} 1270 1271/** 1272* tpl_getConf($id) 1273* 1274* используйте эту функцию для доступа к переменным конфигурации шаблона 1275* 1276* @param string $ id имя значения для доступа 1277* @param mixed $ notset что возвращать, если настройка недоступна 1278* @return смешанный 1279*/ 1280функция tpl_getConf ($ id , $ notset = false ) 1281{ 1282 глобальная $ conf ; 1283 статический $ tpl_configloaded = false ; 1284 1285 $ tpl = $ conf [ 'шаблон' ]; 1286 1287 если (!$ tpl_configloaded ) { 1288 $ tconf = tpl_loadConfig (); 1289 если ($ tconf !== false ) { 1290 foreach ($ tconf as $ key => $ value ) { 1291 если ( isset ($ conf [ 'tpl' ][$ tpl ][$ key ])) продолжить ; 1292 $ conf [ 'tpl' ][$ tpl ][$ key ] = $ value ; 1293 } 1294 $ tpl_configloaded = true ; 1295 } 1296 } 1297 1298 вернуть $ conf [ 'tpl' ][$ tpl ][$ id ] ?? $ notset ; 1299} 1300 1301/** 1302* tpl_loadConfig() 1303* 1304* считывает все переменные конфигурации шаблона 1305* эта функция автоматически вызывается tpl_getConf() 1306* 1307* @return false | массив 1308*/ 1309функция tpl_loadConfig () 1310{ 1311 1312 $ file = tpl_incdir ( ) . ' /conf/default.php ' ;1313 $ conf = []; 1314 1315 если (! file_exists ($ file )) вернуть false ; 1316 1317 // загрузить файл конфигурации по умолчанию 1318 включить ($ файл ); 1319 1320 вернуть $ conf ; 1321} 1322 1323// методы языка 1324 1325/** 1326* tpl_getLang($id) 1327* 1328* используйте эту функцию для доступа к переменным языка шаблона 1329* 1330* @param string $ id ключ языковой строки 1331* @возвращаемая строка 1332*/ 1333функция tpl_getLang ($ id ) 1334{ 1335 статический $ lang = []; 1336 1337 если ( количество ($ язык ) === 0 ) { 1338 global $ conf , $ config_cascade ; // определенно не вызывайте "global $lang" 1339 1340 $ path = tpl_incdir () . 'lang/' ; 1341 1342 $ lang = []; 1343 1344 // не включайте один раз 1345 @include ( $ path.'en / lang.php ' ) ; 1346 foreach ($ config_cascade [ 'lang' ][ 'template' ] как $ config_file ) { 1347 если ( file_exists ($ config_file . $ conf [ 'template' ] . '/ en / lang.php ' )) { 1348 include ($ config_file .$ conf [ 'template' ]. '/ en / lang.php ' ); 1349 } 1350 } 1351 1352 if ($ conf [ 'lang' ] != 'en' ) { 1353 @include ($ path .$ conf [ 'lang' ] . '/ lang.php ' ); 1354 foreach ($ config_cascade [ 'lang' ][ 'template' ] как $ config_file ) { 1355 если ( file_exists ($ config_file . $ conf [ 'template' ] . '/' . $ conf [ 'lang' ] . '/ lang.php ' )) { 1356 include ($ config_file .$ conf [ 'template' ]. '/' .$ conf [ 'lang' ]. '/ lang.php ' ); 1357 } 1358 } 1359 } 1360 } 1361 вернуть $ lang [$ id ] ?? '' ; 1362} 1363 1364/** 1365* Извлечь файл, зависящий от языка, и передать его в xhtml-рендерер для отображения 1366* эквивалент шаблона p_locale_xhtml() 1367* 1368* @param string $ id идентификатор страницы вики, зависящей от языка 1369* @return string анализирует содержимое страницы вики в формате xhtml 1370*/ 1371функция tpl_locale_xhtml ($ id ) 1372{ 1373 вернуть p_cached_output ( tpl_localeFN ($ id )); 1374} 1375 1376/** 1377* Добавляет соответствующий путь к имени файла, зависящему от языка 1378* 1379* @param string $ id идентификатор локализованного текста 1380* @return string вики-текст 1381*/ 1382функция tpl_localeFN ($ id ) 1383{ 1384 $ path = tpl_incdir () . 'lang/' ; 1385 глобальная $ conf ; 1386 $ file = DOKU_CONF.'template_lang /'.$ conf [ 'template' ] . '/' .$ conf [ ' lang' ]. '/' .$ id . '.txt' ; 1387 если (! file_exists ($ file )) { 1388 $ file = $ path .$ conf [ 'lang' ]. '/' .$ id . '.txt' ; 1389 если (! file_exists ($ file )) { 1390 //возвращаемся к английскому 1391 $ file = $ path . 'en/' . $ id . '.txt' ; 1392 } 1393 } 1394 вернуть $ файл ; 1395} 1396 1397/** 1398* выводит «основной контент» во всплывающем окне медиаменеджера 1399* 1400* В зависимости от действий пользователя это может быть список 1401* файлы в пространстве имен, диалоговое окно редактирования метаданных или 1402* сообщение о ссылках на страницы 1403* 1404* Разрешено только в mediamanager.php 1405* 1406* @triggers МЕДИАМЕНЕДЖЕР_КОНТЕНТ_ВЫВОД 1407* @param bool $ fromajax - установить true при вызове этой функции через ajax 1408* @param string $ сортировка 1409* 1410* @автор Андреас Гор <andi@splitbrain.org> 1411*/ 1412функция tpl_mediaContent ($ fromajax = false , $ sort = 'natural' ) 1413{ 1414 глобальный $ IMG ; 1415 глобальная $ AUTH ; 1416 глобальный $ INUSE ; 1417 глобальный $ NS ; 1418 глобальный $ JUMPTO ; 1419 /** @var Вход $INPUT */ 1420 глобальный $ ВХОД ; 1421 1422 $ do = $ INPUT -> extract ( 'do' )-> str ( 'do' ); 1423 если ( in_array ( $ do , [ 'сохранить' , 'отмена' ])) $ do = '' ; 1424 1425 если (!$ сделать ) { 1426 если ($ INPUT -> bool ( 'редактировать' )) { 1427 $ do = 'метаформа' ; 1428 } elseif ( is_array ($ INUSE )) { 1429 $ do = 'filesinuse' ; 1430 } еще { 1431 $ do = 'список_файлов' ; 1432 } 1433 } 1434 1435 // выводим панель содержимого, обернутую в событие. 1436 если (!$ fromajax ) echo '<div id="media__content">' ; 1437 $ данные = [ 'делать' => $ делать ]; 1438 $ evt = новое событие ( 'MEDIAMANAGER_CONTENT_OUTPUT' , $ data ); 1439 если ($ evt -> advice_before ()) { 1440 $ do = $ data [ 'do' ]; 1441 если ($ do == 'filesinuse' ) { 1442 media_filesinuse ($ INUSE , $ IMG ); 1443 } elseif ($ do == 'список файлов' ) { 1444 media_filelist ($ NS , $ AUTH , $ JUMPTO , false , $ sort ); 1445 } elseif ($ do == 'searchlist' ) { 1446 media_searchlist ($ INPUT -> str ( 'q' ), $ NS , $ AUTH ); 1447 } еще { 1448 msg ( 'Неизвестное действие ' . hsc ($ do ), -1 ); 1449 } 1450 } 1451 $ evt -> advice_after (); 1452 снято ($ evt ); 1453 если (!$ fromajax ) echo '</div>' ; 1454} 1455 1456/** 1457* Печатает центральный столбец в полноэкранном медиа-менеджере 1458* В зависимости от открытой вкладки это может быть список 1459* файлы в пространстве имен, форма загрузки или форма поиска 1460* 1461* @author Катя Арзамасцева <pshns@ukr.net> 1462*/ 1463функция tpl_mediaFileList () 1464{ 1465 глобальная $ AUTH ; 1466 глобальный $ NS ; 1467 глобальный $ JUMPTO ; 1468 глобальный $ lang ; 1469 /** @var Вход $INPUT */ 1470 глобальный $ ВХОД ; 1471 1472 $ open_tab = $ INPUT -> str ( 'tab_files' ); 1473 если (!$ open_tab || ! in_array ($ open_tab , [ 'файлы' , 'загрузка' , 'поиск' ])) $ open_tab = 'файлы' ; 1474 если ($ INPUT -> str ( 'mediado' ) == 'update' ) $ open_tab = 'upload' ; 1475 1476 echo '<h2 class="a11y">' . $ lang [ 'mediaselect' ] . '</h2>' . NL ; 1477 1478 media_tabs_files ($ opened_tab ); 1479 1480 echo '<div class="panelHeader">' . NL ; 1481 эхо '<h3>' ; 1482 $ tabTitle = $ NS ?: '[' . $ lang [ 'mediaroot' ] . ']' ; 1483 printf ($ lang [ 'media_' . $ open_tab ], '<strong>' . hsc ($ tabTitle ) . '</strong>' ); 1484 эхо '</h3>' . NL ; 1485 если ($ open_tab === 'поиск' || $ open_tab === 'файлы' ) { 1486 параметры_файлов_вкладки_медиа (); 1487 } 1488 эхо '</div>' . NL ; 1489 1490 echo '<div class="panelContent">' . NL ; 1491 если ($ open_tab == 'файлы' ) { 1492 media_tab_files ($ NS , $ AUTH , $ JUMPTO ); 1493 } elseif ($ opened_tab == 'загрузить' ) { 1494 media_tab_upload ($ NS , $ AUTH , $ JUMPTO ); 1495 } elseif ($ open_tab == 'поиск' ) { 1496 media_tab_search ($ NS , $ AUTH ); 1497 } 1498 эхо '</div>' . NL ; 1499} 1500 1501/** 1502* Печатает третий столбец в полноэкранном медиа-менеджере 1503* В зависимости от открытой вкладки это могут быть сведения о 1504* выбранный файл, диалоговое окно редактирования метаданных или 1505* список ревизий файлов 1506* 1507* @param string $ изображение 1508* @param boolean $ rev 1509* 1510* @author Катя Арзамасцева <pshns@ukr.net> 1511*/ 1512функция tpl_mediaFileDetails ($ image , $ rev ) 1513{ 1514 глобальный $ conf , $ DEL , $ lang ; 1515 /** @var Вход $INPUT */ 1516 глобальный $ ВХОД ; 1517 1518 $ удалено = ( 1519 ! file_exists ( mediaFN ($ image )) && 1520 file_exists ( mediaMetaFN ($ image , '.changes' )) && 1521 $ conf [ 'mediarevisions' ] 1522 ); 1523 если (!$ image || (! file_exists ( mediaFN ($ image )) && !$ removed ) || $ DEL ) return ; 1524 если ($ rev && ! file_exists ( mediaFN ( $ image , $ rev ))) $ rev = false ; 1525 $ ns = getNS ($ image ); 1526 $ do = $ INPUT -> str ( 'mediado' ); 1527 1528 $ open_tab = $ INPUT -> str ( 'tab_details' ); 1529 1530 $ tab_array = [ 'view' ]; 1531 [, $ mime ] = mimetype ($ image ); 1532 если ($ mime == ' изображение / jpeg ' ) { 1533 $ tab_array [] = 'редактировать' ; 1534 } 1535 если ($ conf [ 'mediarevisions' ]) { 1536 $ tab_array [] = 'история' ; 1537 } 1538 1539 если (!$ open_tab || ! in_array ($ open_tab , $ tab_array )) $ open_tab = 'view' ; 1540 если ($ INPUT -> bool ( 'редактировать' )) $ open_tab = 'редактировать' ; 1541 если ($ do == 'restore' ) $ open_tab = 'view' ; 1542 1543 media_tabs_details ($ image , $ opened_tab ); 1544 1545 echo '<div class="panelHeader"><h3>' ; 1546 [$ ext ] = mimetype ($ image , false ); 1547 $ class = preg_replace ( '/[^_\-a-z0-9]+/i' , '_' , $ ext ); 1548 $ class = 'выберите медиафайл mf_' . $ class ; 1549 1550 $ атрибуты = $ rev ? [ 'rev' => $ rev ] : []; 1551 $ tabTitle = sprintf ( 1552 '<strong><a href="%s" class="%s" title="%s">%s</a></strong>' , 1553 мл ($ изображение , $ атрибуты ), 1554 $ класс , 1555 $ lang [ 'mediaview' ], 1556 $ изображение 1557 ); 1558 если ($ open_tab === 'view' && $ rev ) { 1559 printf ($ lang [ 'media_viewold' ], $ tabTitle , dformat ($ rev )); 1560 } еще { 1561 printf ($ lang [ 'media_' .$ opened_tab ],$ tabTitle ); 1562 } 1563 1564 echo '</h3></div>' . NL ; 1565 1566 echo '<div class="panelContent">' . NL ; 1567 1568 если ($ open_tab == 'view' ) { 1569 media_tab_view ($ image , $ ns , null , $ rev ); 1570 } elseif ($ opening_tab == 'edit' && !$ removed ) { 1571 media_tab_edit ($ image , $ ns ); 1572 } elseif ($ opened_tab == 'history' && $ conf [ 'mediarevisions' ]) { 1573 media_tab_history ($ image , $ ns ); 1574 } 1575 1576 эхо '</div>' . NL ; 1577} 1578 1579/** 1580* выводит дерево пространства имен во всплывающем окне медиаменеджера 1581* 1582* Разрешено только в mediamanager.php 1583* 1584* @автор Андреас Гор <andi@splitbrain.org> 1585*/ 1586функция tpl_mediaTree () 1587{ 1588 глобальный $ NS ; 1589 эхо '<div id="media__tree">' ; 1590 media_nstree ($ NS ); 1591 эхо '</div>' ; 1592} 1593 1594/** 1595* Распечатать выпадающее меню со всеми действиями DokuWiki 1596* 1597* Примечание: здесь не будут использоваться красивые URL-адреса. 1598* 1599* @param string $ пусто пустая метка параметра 1600* @param string $ кнопка подписи кнопки отправки 1601* 1602* @автор Андреас Гор <andi@splitbrain.org> 1603* @deprecated 2017-09-01 см. devel:menus 1604*/ 1605функция tpl_actiondropdown ($ empty = '' , $ button = '>' ) 1606{ 1607 dbg_deprecated ( 'см. devel:menus' ); 1608 $ menu = new MobileMenu (); 1609 echo $ menu -> getDropdown ($ empty , $ button ); 1610} 1611 1612/** 1613* Распечатать информационную строку об использованной лицензии 1614* 1615* @param string $ img распечатать изображение? (|кнопка|значок) 1616* @param bool $ imgonly пропустить текстовое описание? 1617* @param bool $ return, если true, не печатать, а возвращать HTML 1618* @param bool $ обернуть в div с class="license"? 1619* @возвращаемая строка 1620* 1621* @автор Андреас Гор <andi@splitbrain.org> 1622*/ 1623функция tpl_license ($ img = 'badge' , $ imgonly = false , $ return = false , $ wrap = true ) 1624{ 1625 глобальная лицензия $ ; 1626 глобальная $ conf ; 1627 глобальный $ lang ; 1628 если (!$ conf [ 'license' ]) вернуть '' ; 1629 если (! is_array ($ license [$ conf [ 'license' ]])) вернуть '' ; 1630 $ lic = $ license [$ conf [ 'license' ]]; 1631 $ target = ($ conf [ 'target' ][ 'extern' ]) ? ' target="' . $ conf [ 'target' ][ 'extern' ] . '"' : '' ; 1632 1633 $ out = '' ; 1634 если ($ wrap ) $ out .= '<div class="license">' ; 1635 если ($ img ) { 1636 $ src = license_img ($ img ); 1637 если ($ ист ) { 1638 $ out .= '<a href="' . $ lic [ 'url' ] . '" rel="лицензия"' . $ target ; 1639 $ out .= '><img src="' . DOKU_BASE . $ src . '" alt="' . $ lic [ 'name' ] . '" /></a>' ; 1640 если (!$ imgonly ) $ out .= ' ' ; 1641 } 1642 } 1643 если (!$ imgonly ) { 1644 $ out .= $ lang [ 'license' ] . ' ' ; 1645 $ out .= '<bdi><a href="' . $ lic [ 'url' ] . '" rel="license" class="urlextern"' . $ target ; 1646 $ out .= '>' . $ lic [ 'имя' ] . '</a></bdi>' ; 1647 } 1648 если ($ wrap ) $ out .= '</div>' ; 1649 1650 если ($ return ) вернуть $ out ; 1651 вывести $ ; 1652 возвращаться '' ; 1653} 1654 1655/** 1656* Включает визуализированный HTML-код указанной страницы 1657* 1658* Эта функция полезна для заполнения боковых панелей или подобных функций в 1659* шаблон 1660* 1661* @param string $ pageid Имя страницы, которую вы хотите включить 1662* @param bool $ print Следует ли печатать содержимое или только возвращать его 1663* @param bool $ propagate Искать также и в более высоких пространствах имен? 1664* @param bool $ useacl Включать страницу только в том случае, если списки контроля доступа проверены? 1665* @return bool | null | строка 1666*/ 1667функция tpl_include_page ($ pageid , $ print = true , $ propagate = false , $ useacl = true ) 1668{ 1669 если ($ распространять ) { 1670 $ pageid = page_findnearest ($ pageid , $ useacl ); 1671 } elseif ($ useacl && auth_quickaclcheck ($ pageid ) == AUTH_NONE ) { 1672 вернуть ложь ; 1673 } 1674 если (!$ pageid ) вернуть false ; 1675 1676 глобальный $ TOC ; 1677 $ oldtoc = $ TOC ; 1678 $ html = p_wiki_xhtml ($ pageid , '' , false ); 1679 $ TOC = $ oldtoc ; 1680 1681 если ($ print ) echo $ html ; 1682 вернуть $ html ; 1683} 1684 1685/** 1686* Отобразить форму подписки 1687* 1688* @автор Адриан Лэнг <lang@cosmocode.de> 1689* @устаревший 2020-07-23 1690*/ 1691функция tpl_subscribe () 1692{ 1693 dbg_deprecated ( Подписаться :: класс . '::show()' ); 1694 ( новая Подписка ())-> показать (); 1695} 1696 1697/** 1698* Пытается отправить уже созданный контент прямо в браузер 1699* 1700* Оборачивает ob_flush() и flush() 1701* 1702* @автор Андреас Гор <andi@splitbrain.org> 1703*/ 1704функция tpl_flush () 1705{ 1706 если ( ob_get_level () > 0 ) ob_flush (); 1707 румянец (); 1708} 1709 1710/** 1711* Пытается найти файл ресурсов в указанных местах. 1712* 1713* Если указанное местоположение начинается с двоеточия, предполагается, что это медиа 1714* файл, в противном случае предполагается, что он относится к текущему шаблону 1715* 1716* @параметр строка []$ поиск мест для просмотра 1717* @param bool $ abs , если использовать абсолютный URL 1718* @param массив &$imginfo заполнен с помощью getimagesize() 1719* @param bool $ fallback использовать резервное изображение, если цель не найдена, или вернуть «false», если она потенциальная 1720* требуется ложный результат 1721* @возвращаемая строка 1722* 1723* @автор Андреас Гор <andi@splitbrain.org> 1724*/ 1725функция tpl_getMediaFile ($ search , $ abs = false , &$ imginfo = null , $ fallback = true ) 1726{ 1727 $ img = '' ; 1728 $ файл = '' ; 1729 $ ismedia = false ; 1730 // перебираем кандидатов, пока не будет найдено совпадение: 1731 foreach ($ поиск как $ img ) { 1732 если ( str_starts_with ($ img , ':' )) { 1733 $ file = mediaFN ($ img ); 1734 $ ismedia = true ; 1735 } еще { 1736 $ file = tpl_incdir () . $ img ; 1737 $ ismedia = false ; 1738 } 1739 1740 если ( file_exists ($ file )) прерывание ; 1741 } 1742 1743 // управлять несуществующей целью 1744 если (! file_exists ($ file )) { 1745 // дать результат для резервного изображения 1746 если ($ откат ) { 1747 $ file = DOKU_INC . ' lib / images / blank.gif ' ; 1748 // остановить процесс, если требуется ложный результат (если $fallback равен false) 1749 } еще { 1750 вернуть ложь ; 1751 } 1752 } 1753 1754 // извлечь данные изображения, если требуется 1755 если (! is_null ($ imginfo )) { 1756 $ imginfo = getimagesize ($ file ); 1757 } 1758 1759 // создать URL 1760 если ($ ismedia ) { 1761 $ url = ml ($ img , '' , true , '' , $ abs ); 1762 } еще { 1763 $ url = tpl_basedir (). $ изображение ; 1764 если ($ abs ) $ url = DOKU_URL.substr ( $ url , strlen ( DOKU_REL )) ;1765 } 1766 1767 вернуть $ url ; 1768} 1769 1770/** 1771* PHP включает файл 1772* 1773* либо из каталога conf, если он существует, в противном случае используйте 1774* файл в корневом каталоге шаблона. 1775* 1776* Функция учитывает настройки каскада конфигураций и ищет заданные 1777* файл рядом с «основными» файлами конфигурации, в порядке защищенный, локальный, 1778* по умолчанию. 1779* 1780* Примечание: здесь не выполняется экранирование или проверка на работоспособность. Никогда не передавайте пользовательский ввод 1781* к этой функции! 1782* 1783* @param string $ файл 1784* 1785* @автор Андреас Гор <andi@splitbrain.org> 1786* @автор Аника Хенке <anika@selfthinker.org> 1787*/ 1788функция tpl_includeFile ($ файл ) 1789{ 1790 глобальный $ config_cascade ; 1791 foreach ([ 'protected' , 'local' , 'default' ] как $ config_group ) { 1792 если ( пусто ($ config_cascade [ 'main' ][$ config_group ])) продолжить ; 1793 foreach ($ config_cascade [ 'main' ][$ config_group ] как $ conf_file ) { 1794 $ dir = имя_каталога ($ conf_file ); 1795 если ( file_exists ( " $ dir / $ file " )) { 1796 include ( " $ dir / $ file " ); 1797 возвращаться ; 1798 } 1799 } 1800 } 1801 1802 // все еще здесь? попробуйте шаблон dir 1803 $ file = tpl_incdir () . $ file ; 1804 если ( file_exists ($ file )) { 1805 включить ($ файл ); 1806 } 1807} 1808 1809/** 1810* Возвращает тег <link> для различных типов иконок (favicon|mobile|generic) 1811* 1812* @param array $ types - список типов иконок для отображения (favicon|mobile|generic) 1813* @возвращаемая строка 1814* 1815* @автор Аника Хенке <anika@selfthinker.org> 1816*/ 1817функция tpl_favicon ($ types = [ 'favicon' ]) 1818{ 1819 1820 $ return = '' ; 1821 1822 foreach ($ типы как $ тип ) { 1823 переключатель ($ тип ) { 1824 случай 'favicon' : 1825 $ look = [ ':wiki:favicon.ico' , ':favicon.ico' , ' изображения / favicon.ico ' ]; 1826 $ return .= '<link rel="значок ярлыка" href="' . tpl_getMediaFile ($ look ) . '" />' . NL ; 1827 перерыв ; 1828 случай «мобильный» : 1829 $ look = [ ':wiki:apple-touch-icon.png' , ':apple-touch-icon.png' , ' изображения / apple-touch-icon.png ' ]; 1830 $ return .= '<link rel="apple-touch-icon" href="' . tpl_getMediaFile ($ look ) . '" />' . NL ; 1831 перерыв ; 1832 случай «общий» : 1833 // идеальное решение, которое пока не работает ни в одном браузере 1834 $ look = [ ':wiki:favicon.svg' , ':favicon.svg' , ' изображения / favicon.svg ' ]; 1835 $ return .= '<link rel="icon" href="' . tpl_getMediaFile ($ look ) . '" type=" image / svg +xml" />' . NL ; 1836 перерыв ; 1837 } 1838 } 1839 1840 возврат $ возврат ; 1841} 1842 1843/** 1844* Печать полноэкранного медиа-менеджера 1845* 1846* @author Катя Арзамасцева <pshns@ukr.net> 1847*/ 1848функция tpl_media () 1849{ 1850 глобальные $ NS , $ IMG , $ JUMPTO , $ REV , $ lang , $ fullscreen , $ INPUT ; 1851 $ полноэкранный = правда ; 1852 require_once DOKU_INC . ' lib / exe / mediamanager.php ' ; 1853 1854 $ rev = '' ; 1855 $ image = cleanID ($ INPUT -> str ( 'image' )); 1856 если ( isset ($ IMG )) $ image = $ IMG ; 1857 если ( isset ($ JUMPTO )) $ image = $ JUMPTO ; 1858 если ( isset ($ REV ) && !$ JUMPTO ) $ rev = $ REV ; 1859 1860 echo '<div id="mediamanager__page">' . NL ; 1861 эхо '<h1>' . $ язык [ 'btn_media' ] . '</h1>' . НЛ ; 1862 html_msgarea (); 1863 1864 echo '<div class="panel namespaces">' . NL ; 1865 echo '<h2>' . $ lang [ 'пространства имен' ] . '</h2>' . NL ; 1866 echo '<div class="panelHeader">' ; 1867 echo $ lang [ 'media_namespaces' ]; 1868 эхо '</div>' . NL ; 1869 1870 echo '<div class="panelContent" id="media__tree">' . NL ; 1871 media_nstree ($ NS ); 1872 эхо '</div>' . NL ; 1873 эхо '</div>' . NL ; 1874 1875 echo '<div class="panel filelist">' . НЛ ; 1876 tpl_mediaFileList (); 1877 эхо '</div>' . NL ; 1878 1879 echo '<div class="panel file">' . NL ; 1880 echo '<h2 class="a11y">' . $ lang [ 'media_file' ] . '</h2>' . NL ; 1881 tpl_mediaFileDetails ($ image , $ rev ); 1882 эхо '</div>' . NL ; 1883 1884 эхо '</div>' . NL ; 1885} 1886 1887/** 1888* Возвращаем полезные классы макета 1889* 1890* @возвращаемая строка 1891* 1892* @автор Аника Хенке <anika@selfthinker.org> 1893*/ 1894функция tpl_classes () 1895{ 1896 глобальные $ ACT , $ conf , $ ID , $ INFO ; 1897 /** @var Вход $INPUT */ 1898 глобальный $ ВХОД ; 1899 1900 $ классы = [ 1901 'dokuwiki' , 1902 'mode_' . $ ACT , 1903 'tpl_' . $ conf [ 'шаблон' ], 1904 $ INPUT -> сервер -> bool ( 'REMOTE_USER' ) ? 'loggedIn' : '' , 1905 ( isset ($ INFO [ 'существует' ]) && $ INFO [ 'существует' ]) ? '' : 'notFound' , 1906 ($ ID == $ conf [ 'start' ]) ? 'home' : '' 1907 ]; 1908 return implode ( ' ' , $ classes ); 1909} 1910 1911/** 1912* Создать событие для меню инструментов 1913* 1914* @param string $ toolsname имя меню 1915* @param массив $ элементы 1916* @param string $ view например 'main', 'detail', ... 1917* 1918* @автор Аника Хенке <anika@selfthinker.org> 1919* @deprecated 2017-09-01 см. devel:menus 1920*/ 1921функция tpl_toolsevent ($ toolsname , $ items , $ view = 'main' ) 1922{ 1923 dbg_deprecated ( 'см. devel:menus' ); 1924 $ data = [ 'view' => $ view , 'items' => $ items ]; 1925 1926 $ hook = 'TEMPLATE_' . strtoupper ($ toolsname ) . '_DISPLAY' ; 1927 $ evt = новое событие ($ hook , $ data ); 1928 если ($ evt -> advice_before ()) { 1929 foreach ($ evt -> data [ 'items' ] as $ html ) echo $ html ; 1930 } 1931 $ evt -> advice_after (); 1932} 1933
Только авторизованные участники могут оставлять комментарии.
wiki/xref/dokuwiki/inc/template.php.txt · Последнее изменение: 2024/08/26 01:24 — vladpolskiy