1<?php 2/** 3 * Include Plugin: Display a wiki page within another wiki page 4 * 5 * Action plugin component, for cache validity determination 6 * 7 * @license GPL 2 (http://www.gnu.org/licenses/gpl.html) 8 * @author Christopher Smith <chris@jalakai.co.uk> 9 * @author Michael Klier <chi@chimeric.de> 10 */ 11if(!defined('DOKU_INC')) die(); // no Dokuwiki, no go 12 13if(!defined('DOKU_PLUGIN')) define('DOKU_PLUGIN',DOKU_INC.'lib/plugins/'); 14require_once(DOKU_PLUGIN.'action.php'); 15 16/** 17 * All DokuWiki plugins to extend the parser/rendering mechanism 18 * need to inherit from this class 19 */ 20class action_plugin_include extends DokuWiki_Action_Plugin { 21 22 var $supportedModes = array('xhtml', 'i'); 23 var $helper = null; 24 25 function action_plugin_include() { 26 $this->helper = plugin_load('helper', 'include'); 27 } 28 29 /** 30 * return some info 31 */ 32 function getInfo() { 33 return array( 34 'author' => 'Gina Häußge, Michael Klier, Christopher Smith', 35 'email' => 'dokuwiki@chimeric.de', 36 'date' => @file_get_contents(DOKU_PLUGIN . 'blog/VERSION'), 37 'name' => 'Include Plugin', 38 'desc' => 'Improved cache handling for included pages and redirect-handling', 39 'url' => 'http://wiki.splitbrain.org/plugin:include', 40 ); 41 } 42 43 /** 44 * plugin should use this method to register its handlers with the dokuwiki's event controller 45 */ 46 function register(&$controller) { 47 $controller->register_hook('PARSER_CACHE_USE','BEFORE', $this, '_cache_prepare'); 48// $controller->register_hook('PARSER_CACHE_USE','AFTER', $this, '_cache_result'); // debugging only 49 $controller->register_hook('HTML_EDITFORM_OUTPUT', 'BEFORE', $this, 'handle_form'); 50 $controller->register_hook('HTML_CONFLICTFORM_OUTPUT', 'BEFORE', $this, 'handle_form'); 51 $controller->register_hook('HTML_DRAFTFORM_OUTPUT', 'BEFORE', $this, 'handle_form'); 52 $controller->register_hook('ACTION_SHOW_REDIRECT', 'BEFORE', $this, 'handle_redirect'); 53 $controller->register_hook('PARSER_HANDLER_DONE', 'BEFORE', $this, 'handle_parser'); 54 $controller->register_hook('TPL_TOC_RENDER', 'BEFORE', $this, 'handle_toc'); 55 } 56 57 /** 58 * Supplies the current section level to the include syntax plugin 59 * 60 * @author Michael Klier <chi@chimeric.de> 61 */ 62 function handle_parser(&$event, $param) { 63 global $ID; 64 65 // check for stored toplevel ID in helper plugin 66 // if it's missing lets see if we have to do anything at all 67 if(!isset($this->helper->toplevel_id)) { 68 $ins =& $event->data->calls; 69 $num = count($ins); 70 for($i=0; $i<$num; $i++) { 71 if(($ins[$i][0] == 'plugin') && ($ins[$i][1][0] == 'include_include')) { 72 if(!isset($this->helper->toplevel_id)) $this->helper->toplevel_id = $ID; 73 $this->helper->parse_instructions($ID, $ins); 74 } 75 } 76 } 77 } 78 79 /** 80 * Add a hidden input to the form to preserve the redirect_id 81 */ 82 function handle_form(&$event, $param) { 83 if (array_key_exists('redirect_id', $_REQUEST)) { 84 $event->data->addHidden('redirect_id', cleanID($_REQUEST['redirect_id'])); 85 } 86 } 87 88 /** 89 * Modify the data for the redirect when there is a redirect_id set 90 */ 91 function handle_redirect(&$event, $param) { 92 if (array_key_exists('redirect_id', $_REQUEST)) { 93 $event->data['id'] = cleanID($_REQUEST['redirect_id']); 94 $event->data['title'] = ''; 95 } 96 } 97 98 /** 99 * prepare the cache object for default _useCache action 100 */ 101 function _cache_prepare(&$event, $param) { 102 global $ID; 103 global $conf; 104 105 $cache =& $event->data; 106 107 // we're only interested in instructions of the current page 108 // without the ID check we'd get the cache objects for included pages as well 109 if(!isset($cache->page) && ($cache->page != $ID)) return; 110 if(!isset($cache->mode) || !in_array($cache->mode, $this->supportedModes)) return; 111 112 // get additional depends 113 $depends = p_get_metadata($ID, 'relation haspart'); 114 if(empty($depends)) return; 115 116 $key = ''; 117 foreach(array_keys($depends) as $page) { 118 if(strpos($page,'/') || cleanID($page) != $page) { 119 continue; 120 } else { 121 $file = wikiFN($page); 122 if(!in_array($cache->depends['files'], array($file)) && @file_exists($file)) { 123 $cache->depends['files'][] = $file; 124 $acl = (AUTH_READ <= auth_quickaclcheck($page)) ? 'READ' : 'NONE'; 125 $key .= '#' . $page . '|' . $acl; 126 } 127 } 128 } 129 130 // empty $key implies no includes, so nothing to do 131 if(empty($key)) return; 132 133 // mark the cache as being modified by the include plugin 134 $cache->include = true; 135 136 // set new cache key & cache name 137 // now also dependent on included page ids and their ACL_READ status 138 $cache->key .= $key; 139 $cache->cache = getCacheName($cache->key, $cache->ext); 140 } 141 142 function _cache_result(&$event, $param) { 143 $cache =& $event->data; 144 if (empty($cache->include)) return; 145 //global $debug; 146 //$debug['cache_result'][] = $event->result ? 'true' : 'false'; 147 } 148} 149//vim:ts=4:sw=4:et:enc=utf-8: 150