* */ /** * Plugin Webcode: Show webcode (Css, HTML) in a iframe * */ // must be run within Dokuwiki use ComboStrap\CallStack; use ComboStrap\Dimension; use ComboStrap\LogUtility; use ComboStrap\PluginUtility; use ComboStrap\Site; use ComboStrap\TagAttributes; if (!defined('DOKU_INC')) die(); /** * Webcode */ class syntax_plugin_combo_webcode extends DokuWiki_Syntax_Plugin { const EXTERNAL_RESOURCES_ATTRIBUTE_DISPLAY = 'externalResources'; // In the action bar const EXTERNAL_RESOURCES_ATTRIBUTE_KEY = 'externalresources'; // In the code // Simple cache bursting implementation for the webCodeConsole.(js|css) file // They must be incremented manually when they changed const WEB_CSS_VERSION = 1.1; const WEB_CONSOLE_JS_VERSION = 2.1; const TAG = 'webcode'; /** * The tag that have codes */ const CODE_TAGS = array( syntax_plugin_combo_code::CODE_TAG, "plugin_combo_code", syntax_plugin_combo_codemarkdown::TAG ); /** * The attribute names in the array */ const CODES_ATTRIBUTE = "codes"; const USE_CONSOLE_ATTRIBUTE = "useConsole"; const RENDERING_MODE_ATTRIBUTE = 'renderingmode'; const RENDERING_ONLY_RESULT = "onlyresult"; /** * Marki code */ const MARKI_LANG = 'marki'; const DOKUWIKI_LANG = 'dw'; const MARKIS = [self::MARKI_LANG, self::DOKUWIKI_LANG]; /** * Syntax Type. * * Needs to return one of the mode types defined in $PARSER_MODES in parser.php * @see https://www.dokuwiki.org/devel:syntax_plugins#syntax_types * * container because it may contain header in case of how to */ public function getType() { return 'container'; } public function getPType() { return "stack"; } /** * @return array * Allow which kind of plugin inside * * array('container', 'baseonly','formatting', 'substition', 'protected', 'disabled', 'paragraphs') * */ public function getAllowedTypes() { return array('container', 'baseonly', 'formatting', 'substition', 'protected', 'disabled', 'paragraphs'); } public function accepts($mode) { return syntax_plugin_combo_preformatted::disablePreformatted($mode); } /** * @see Doku_Parser_Mode::getSort() * The mode (plugin) with the lowest sort number will win out * * See {@link Doku_Parser_Mode_code} */ public function getSort() { return 99; } /** * Called before any calls to ConnectTo * @return void */ function preConnect() { } /** * Create a pattern that will called this plugin * * @param string $mode * * All dokuwiki mode can be seen in the parser.php file * @see Doku_Parser_Mode::connectTo() */ public function connectTo($mode) { $pattern = PluginUtility::getContainerTagPattern(self::TAG); $this->Lexer->addEntryPattern($pattern, $mode, PluginUtility::getModeFromTag($this->getPluginComponent())); } // This where the addPattern and addExitPattern are defined public function postConnect() { $this->Lexer->addExitPattern('' . self::TAG . '>', PluginUtility::getModeFromTag($this->getPluginComponent())); } /** * Handle the match * You get the match for each pattern in the $match variable * $state says if it's an entry, exit or match pattern * * This is an instruction block and is cached apart from the rendering output * There is two caches levels * This cache may be suppressed with the url parameters ?purge=true * * The returned values are cached in an array that will be passed to the render method * The handle function goal is to parse the matched syntax through the pattern function * and to return the result for use in the renderer * This result is always cached until the page is modified. * @param string $match * @param int $state * @param int $pos * @param Doku_Handler $handler * @return array|bool * @throws Exception * @see DokuWiki_Syntax_Plugin::handle() * */ public function handle($match, $state, $pos, Doku_Handler $handler) { switch ($state) { case DOKU_LEXER_ENTER : // Default $defaultAttributes = array(); $defaultAttributes['frameborder'] = 1; $defaultAttributes['width'] = '100%'; $defaultAttributes['name'] = "WebCode iFrame"; $defaultAttributes[self::RENDERING_MODE_ATTRIBUTE] = 'story'; // 'height' is set by the javascript if not set // 'width' and 'scrolling' gets their natural value // Parse and create the call stack array $tagAttributes = TagAttributes::createFromTagMatch($match, $defaultAttributes); $callStackArray = $tagAttributes->toCallStackArray(); return array( PluginUtility::STATE => $state, PluginUtility::ATTRIBUTES => $callStackArray ); case DOKU_LEXER_UNMATCHED : return PluginUtility::handleAndReturnUnmatchedData(self::TAG, $match, $handler); case DOKU_LEXER_EXIT: /** * Capture all codes */ $codes = array(); /** * Does the javascript contains a console statement */ $useConsole = false; /** * Callstack */ $callStack = CallStack::createFromHandler($handler); $openingTag = $callStack->moveToPreviousCorrespondingOpeningCall(); $renderingMode = strtolower($openingTag->getAttribute(self::RENDERING_MODE_ATTRIBUTE)); /** * The mime (ie xml,html, ...) and code content are in two differents * call. To be able to set the content to the good type * we keep a trace of it */ $actualCodeType = ""; /** * Loop */ while ($actualTag = $callStack->next()) { $tagName = $actualTag->getTagName(); if (in_array($tagName, self::CODE_TAGS)) { /** * Only rendering mode, we don't display the node * on all node (enter, exit and unmatched) */ if ($renderingMode == self::RENDERING_ONLY_RESULT) { $actualTag->addAttribute(TagAttributes::DISPLAY, "none"); } switch ($actualTag->getState()) { case DOKU_LEXER_ENTER: // Get the code (The content between the code nodes) // We ltrim because the match gives us the \n at the beginning and at the end $actualCodeType = strtolower(trim($actualTag->getType())); // Xml is html if ($actualCodeType == 'xml') { $actualCodeType = 'html'; } // markdown, dokuwiki is marki if (in_array($actualCodeType, ['md', 'markdown', 'dw'])) { $actualCodeType = self::MARKI_LANG; } // The code for a language may be scattered in multiple block if (!isset($codes[$actualCodeType])) { $codes[$actualCodeType] = ""; } continue 2; case DOKU_LEXER_UNMATCHED: $codeContent = $actualTag->getPluginData()[PluginUtility::PAYLOAD]; if (empty($actualCodeType)) { LogUtility::msg("The type of the code should not be null for the code content " . $codeContent, LogUtility::LVL_MSG_WARNING, self::TAG); continue 2; } // Append it $codes[$actualCodeType] = $codes[$actualCodeType] . $codeContent; // Check if a javascript console function is used, only if the flag is not set to true if (!$useConsole == true) { if (in_array($actualCodeType, array('babel', 'javascript', 'html', 'xml'))) { // if the code contains 'console.' $result = preg_match('/' . 'console\.' . '/is', $codeContent); if ($result) { $useConsole = true; } } } // Reset $actualCodeType = ""; break; } } } return array( PluginUtility::STATE => $state, self::CODES_ATTRIBUTE => $codes, self::USE_CONSOLE_ATTRIBUTE => $useConsole, PluginUtility::ATTRIBUTES => $openingTag->getAttributes() ); } return false; } /** * Render the output * @param string $mode * @param Doku_Renderer $renderer * @param array $data - what the function handle() return'ed * @return bool - rendered correctly (not used) * * The rendering process * @see DokuWiki_Syntax_Plugin::render() * */ public function render($mode, Doku_Renderer $renderer, $data) { // The $data variable comes from the handle() function // // $mode = 'xhtml' means that we output html // There is other mode such as metadata where you can output data for the headers (Not 100% sure) if ($mode == 'xhtml') { /** @var Doku_Renderer_xhtml $renderer */ $state = $data[PluginUtility::STATE]; switch ($state) { case DOKU_LEXER_UNMATCHED : $renderer->doc .= PluginUtility::renderUnmatched($data); break; case DOKU_LEXER_EXIT : $codes = $data[self::CODES_ATTRIBUTE]; $callStackArray = $data[PluginUtility::ATTRIBUTES]; $iFrameAttributes = TagAttributes::createFromCallStackArray($callStackArray, self::TAG); // Create the real output of webcode if (sizeof($codes) == 0) { return false; } // Credits bar $bar = '
'; // close the bar $renderer->doc .= "