category tags space separated}} * * @license GPL 2 (http://www.gnu.org/licenses/gpl.html) * @author Matthias Schulte */ /** Count syntax, allows to list tag counts */ class syntax_plugin_tag_count extends DokuWiki_Syntax_Plugin { /** * @return string Syntax type */ function getType() { return 'substition'; } /** * @return int Sort order */ function getSort() { return 305; } /** * @return string Paragraph type */ function getPType() { return 'block';} /** * @param string $mode Parser mode */ function connectTo($mode) { $this->Lexer->addSpecialPattern('\{\{count>.*?\}\}', $mode, 'plugin_tag_count'); } /** * Handle matches of the count syntax * * @param string $match The match of the syntax * @param int $state The state of the handler * @param int $pos The position in the document * @param Doku_Handler $handler The handler * @return array|false Data for the renderer */ function handle($match, $state, $pos, Doku_Handler $handler) { $match = trim(substr($match, 8, -2)); // get given tags [$tags, $nsstring] = array_pad(explode('&', $match,2),2,''); // split to tags and allowed namespaces $allowedNamespaces = explode(' ', $nsstring); // split given namespaces into an array if($allowedNamespaces && $allowedNamespaces[0] == '') { unset($allowedNamespaces[0]); // When exists, remove leading space after the delimiter $allowedNamespaces = array_values($allowedNamespaces); } if (empty($allowedNamespaces)) { $allowedNamespaces = null; } if (!$tags) { $tags = '+'; } /** @var helper_plugin_tag $helper */ if(!($helper = $this->loadHelper('tag'))) { return false; } return [ $helper->parseTagList($tags), $allowedNamespaces ]; } /** * Render xhtml output or metadata * * @param string $format Renderer mode (supported modes: xhtml and metadata) * @param Doku_Renderer $renderer The renderer * @param array $data The data from the handler function * @return bool If rendering was successful. */ function render($format, Doku_Renderer $renderer, $data) { if ($data === false) return false; list($tags, $allowedNamespaces) = $data; // deactivate (renderer) cache as long as there is no proper cache handling // implemented for the count syntax $renderer->nocache(); if($format == "xhtml") { /** @var helper_plugin_tag $helper */ if(!($helper = $this->loadHelper('tag'))) return false; // get tags and their occurrences if($tags[0] == '+') { // no tags given, list all tags for allowed namespaces $occurrences = $helper->tagOccurrences($tags, $allowedNamespaces, true); } else { $occurrences = $helper->tagOccurrences($tags, $allowedNamespaces); } $class = "inline"; // valid: inline, ul, pagelist $col = "page"; $renderer->doc .= ''; $renderer->doc .= ''; $renderer->doc .= ''; $renderer->doc .= ''; $renderer->doc .= ''; if(empty($occurrences)) { // Skip output $renderer->doc .= ''; $renderer->doc .= ''; $renderer->doc .= ''; } else { foreach($occurrences as $tagname => $count) { if($count <= 0) continue; // don't display tags with zero occurrences $renderer->doc .= ''; $renderer->doc .= ''; $renderer->doc .= ''; $renderer->doc .= ''; } } $renderer->doc .= '

'.$this->getLang('tag').'	'.$this->getLang('count').'
'.$this->getLang('empty_output').'
'.$helper->tagLink($tagname).'	'.$count.'

'; } return true; } }