X-Git-Url: https://git.mxchange.org/?p=core.git;a=blobdiff_plain;f=inc%2Fclasses%2Fmain%2Ftemplate%2Fmenu%2Fclass_MenuTemplateEngine.php;h=4f1dd50dd2baed10de46227287fd4e644ba7d6ce;hp=ef169e409e05cd25db67c447bbba817c0bac63d7;hb=c3021952494266e05bfa9046baf9bcd11bfe7d13;hpb=1c2504276f9bea28da8d391ea74267a5f0172ecc diff --git a/inc/classes/main/template/menu/class_MenuTemplateEngine.php b/inc/classes/main/template/menu/class_MenuTemplateEngine.php index ef169e40..4f1dd50d 100644 --- a/inc/classes/main/template/menu/class_MenuTemplateEngine.php +++ b/inc/classes/main/template/menu/class_MenuTemplateEngine.php @@ -2,11 +2,11 @@ /** * A Menu template engine class * - * @author Roland Haeder + * @author Roland Haeder * @version 0.0.0 - * @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 Core Developer Team + * @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2015 Core Developer Team * @license GNU GPL 3.0 or any newer version - * @link http://www.ship-simu.org + * @link http://www.shipsimu.org * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by @@ -60,7 +60,7 @@ class MenuTemplateEngine extends BaseTemplateEngine implements CompileableTempla /** * Menu instance */ - private $menuInstance = null; + private $menuInstance = NULL; /** * Current main node @@ -68,9 +68,9 @@ class MenuTemplateEngine extends BaseTemplateEngine implements CompileableTempla private $curr = array(); /** - * Content from depency + * Content from dependency */ - private $depencyContent = array(); + private $dependencyContent = array(); /** * Protected constructor @@ -85,9 +85,8 @@ class MenuTemplateEngine extends BaseTemplateEngine implements CompileableTempla /** * Creates an instance of the class TemplateEngine and prepares it for usage * - * @param $appInstance A manageable application - * @param $menuInstance A RenderableMenu instance - * @return $tplInstance An instance of TemplateEngine + * @param $menuInstance A RenderableMenu instance + * @return $templateInstance An instance of TemplateEngine * @throws BasePathIsEmptyException If the provided $templateBasePath is empty * @throws InvalidBasePathStringException If $templateBasePath is no string * @throws BasePathIsNoDirectoryException If $templateBasePath is no @@ -95,54 +94,52 @@ class MenuTemplateEngine extends BaseTemplateEngine implements CompileableTempla * @throws BasePathReadProtectedException If $templateBasePath is * read-protected */ - public final static function createMenuTemplateEngine (ManageableApplication $appInstance, RenderableMenu $menuInstance) { + public static final function createMenuTemplateEngine (RenderableMenu $menuInstance) { // Get a new instance - $tplInstance = new MenuTemplateEngine(); + $templateInstance = new MenuTemplateEngine(); - // Get language and file I/O instances from application - $langInstance = $appInstance->getLanguageInstance(); - $ioInstance = $appInstance->getFileIoInstance(); + // Get the application instance from registry + $applicationInstance = Registry::getRegistry()->getInstance('app'); // Determine base path - $templateBasePath = $tplInstance->getConfigInstance()->getConfigEntry('application_base_path') . $appInstance->getRequestInstance()->getRequestElement('app') . '/'; + $templateBasePath = $templateInstance->getConfigInstance()->getConfigEntry('application_base_path') . $applicationInstance->getRequestInstance()->getRequestElement('app') . '/'; // Is the base path valid? if (empty($templateBasePath)) { // Base path is empty - throw new BasePathIsEmptyException($tplInstance, self::EXCEPTION_UNEXPECTED_EMPTY_STRING); + throw new BasePathIsEmptyException($templateInstance, self::EXCEPTION_UNEXPECTED_EMPTY_STRING); } elseif (!is_string($templateBasePath)) { // Is not a string - throw new InvalidBasePathStringException(array($tplInstance, $templateBasePath), self::EXCEPTION_INVALID_STRING); + throw new InvalidBasePathStringException(array($templateInstance, $templateBasePath), self::EXCEPTION_INVALID_STRING); } elseif (!is_dir($templateBasePath)) { // Is not a path - throw new BasePathIsNoDirectoryException(array($tplInstance, $templateBasePath), self::EXCEPTION_INVALID_PATH_NAME); + throw new BasePathIsNoDirectoryException(array($templateInstance, $templateBasePath), self::EXCEPTION_INVALID_PATH_NAME); } elseif (!is_readable($templateBasePath)) { // Is not readable - throw new BasePathReadProtectedException(array($tplInstance, $templateBasePath), self::EXCEPTION_READ_PROTECED_PATH); + throw new BasePathReadProtectedException(array($templateInstance, $templateBasePath), self::EXCEPTION_READ_PROTECED_PATH); } - // Get configuration instance - $configInstance = FrameworkConfiguration::getInstance(); - // Set the base path - $tplInstance->setTemplateBasePath($templateBasePath); - - // Set the language and IO instances - $tplInstance->setLanguageInstance($langInstance); - $tplInstance->setFileIoInstance($ioInstance); + $templateInstance->setTemplateBasePath($templateBasePath); // Set template extensions - $tplInstance->setRawTemplateExtension($configInstance->getConfigEntry('raw_template_extension')); - $tplInstance->setCodeTemplateExtension($configInstance->getConfigEntry('menu_template_extension')); + $templateInstance->setRawTemplateExtension($templateInstance->getConfigInstance()->getConfigEntry('raw_template_extension')); + $templateInstance->setCodeTemplateExtension($templateInstance->getConfigInstance()->getConfigEntry('menu_template_extension')); // Absolute output path for compiled templates - $tplInstance->setCompileOutputPath($configInstance->getConfigEntry('base_path') . $configInstance->getConfigEntry('compile_output_path')); + $templateInstance->setCompileOutputPath($templateInstance->getConfigInstance()->getConfigEntry('base_path') . $templateInstance->getConfigInstance()->getConfigEntry('compile_output_path')); // Set the menu instance - $tplInstance->setMenuInstance($menuInstance); + $templateInstance->setMenuInstance($menuInstance); + + // Init a variable stacker + $stackInstance = ObjectFactory::createObjectByConfiguredName('menu_stacker_class'); + + // Set it + $templateInstance->setStackInstance($stackInstance); // Return the prepared instance - return $tplInstance; + return $templateInstance; } /** @@ -242,7 +239,7 @@ class MenuTemplateEngine extends BaseTemplateEngine implements CompileableTempla * @return void * @throws XmlNodeMismatchException If current main node mismatches the closing one */ - public function endElement ($resource, $nodeName) { + public function finishElement ($resource, $nodeName) { // Make all lower-case $nodeName = strtolower($nodeName); @@ -276,291 +273,445 @@ class MenuTemplateEngine extends BaseTemplateEngine implements CompileableTempla // Is this string empty? if (empty($characters)) { // Then skip it silently - return false; + return; } // END - if - // Unfinished work! - $this->partialStub('Handling extra characters is not yet supported! length='.strlen($characters)); + // Assign the found characters to variable and use the last entry from + // stack as the name + parent::assignVariable($this->getStackInstance()->getNamed('current_node'), $characters); } /** - * Handles the template depency for given node + * Handles the template dependency for given node * - * @param $node The node we should load a depency template - * @param $templateDepency A template to load to satisfy depencies + * @param $node The node we should load a dependency template + * @param $templateDependency A template to load to satisfy dependencies * @return void */ - private function handleTemplateDepency ($node, $templateDepency) { - // Is the template depency set? - if ((!empty($templateDepency)) && (!isset($this->depencyContent[$node]))) { + private function handleTemplateDependency ($node, $templateDependency) { + // Is the template dependency set? + if ((!empty($templateDependency)) && (!isset($this->dependencyContent[$node]))) { // Get a temporay menu template instance - $templateInstance = ObjectFactory::createObjectByConfiguredName('menu_template_class', array($this->getApplicationInstance(), $this->getMenuInstance())); + $templateInstance = ObjectFactory::createObjectByConfiguredName('menu_template_class', array($this->getMenuInstance())); // Then load it - $templateInstance->loadMenuTemplate($templateDepency); + $templateInstance->loadMenuTemplate($templateDependency); - // Get an XmlParser instance + // Parse the XML content $templateInstance->renderXmlContent(); - // Parse the template's content contents - $this->depencyContent[$node] = $templateInstance->getRawTemplateData(); + // Save the parsed raw content in our dependency array + $this->dependencyContent[$node] = $templateInstance->getRawTemplateData(); } // END - if } /** * Intializes the menu * - * @param $templateDepency A template to load to satisfy depencies + * @param $templateDependency A template to load to satisfy dependencies * @return void * @todo Add cache creation here */ - private function initMenu ($templateDepency = '') { + private function initMenu ($templateDependency = '') { // Get web template engine - $this->setTemplateInstance(ObjectFactory::createObjectByConfiguredName('web_template_class', array($this->getApplicationInstance()))); - - // Handle the depency template - $this->handleTemplateDepency('menu', $templateDepency); - - // Load the header template for this page - $this->getTemplateInstance()->loadCodeTemplate('menu_global_start'); + $this->setTemplateInstance(ObjectFactory::createObjectByConfiguredName('html_template_class', array($this->getApplicationInstance()))); - // Set the variable group to page - $this->setVariableGroup('menu'); + // Handle the dependency template + $this->handleTemplateDependency('menu', $templateDependency); - // Set its content in this template instance - $this->assignVariable('menu_start', $this->getTemplateInstance()->getRawTemplateData()); + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'menu'); } /** - * Finishes the menu + * Starts the menu entries * + * @param $templateDependency A template to load to satisfy dependencies * @return void */ - private function finishMenu () { - // Load the header template for this page - $this->getTemplateInstance()->loadCodeTemplate('menu_global_end'); - - // Set the variable group to page - $this->setVariableGroup('menu'); + private function startEntryList () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'entry-list'); + } - // Set its content in this template instance - $this->assignVariable('menu_end', $this->getTemplateInstance()->getRawTemplateData()); + /** + * Starts the menu block header + * + * @return void + */ + private function startBlockHeader () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'block-header'); } /** - * Starts the menu entries by loading a (maybe) provided template depency + * Starts the menu block footer * - * @param $templateDepency A template to load to satisfy depencies * @return void */ - private function startEntryList ($templateDepency = '') { - // Handle the depency template - $this->handleTemplateDepency('entries', $templateDepency); + private function startBlockFooter () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'block-footer'); + } - // Load the header template for this page - $this->getTemplateInstance()->loadCodeTemplate('menu_entries_start'); + /** + * Starts the menu property 'block-list' + * + * @return void + */ + private function startBlockList () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'block-list'); + } - // Set the variable group to page - $this->setVariableGroup('menu'); + /** + * Starts the menu property 'block' + * + * @return void + */ + private function startBlock () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'block'); + } - // Set its content in this template instance - $this->assignVariable('entries_start', $this->getTemplateInstance()->getRawTemplateData()); + /** + * Starts the menu property 'title' + * + * @return void + */ + private function startTitle () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'title'); } /** - * Finishes the menu entries + * Starts the menu property 'title-id' * * @return void */ - private function finishEntryList () { - // Load the header template for this page - $this->getTemplateInstance()->loadCodeTemplate('menu_entries_end'); + private function startTitleId () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'title-id'); + } - // Set the variable group to page - $this->setVariableGroup('menu'); + /** + * Starts the menu property 'title-class' + * + * @return void + */ + private function startTitleClass () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'title-class'); + } - // Set its content in this template instance - $this->assignVariable('entries_end', $this->getTemplateInstance()->getRawTemplateData()); + /** + * Starts the menu property 'title-text' + * + * @return void + */ + private function startTitleText () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'title-text'); } /** - * Starts the menu block header + * Starts the menu property 'entry' * * @return void */ - private function startBlockHeader () { - // Do we have a template instance? - if (is_null($this->getTemplateInstance())) { - // Init template instance for underlaying web templates - $templateInstance = ObjectFactory::createObjectByConfiguredName('web_template_class'); + private function startEntry () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'entry'); + } - // Set it in this template engine - $this->setTemplateInstance($templateInstance); - } // END - if + /** + * Starts the menu property 'entry-id' + * + * @return void + */ + private function startEntryId () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'entry-id'); + } - // Load the header template for this page - $this->getTemplateInstance()->loadCodeTemplate('menu_header_start'); + /** + * Starts the menu property 'anchor' + * + * @return void + */ + private function startAnchor () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'anchor'); + } - // Set the variable group to page - $this->setVariableGroup('menu'); + /** + * Starts the menu property 'anchor-id' + * + * @return void + */ + private function startAnchorId () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'anchor-id'); + } - // Set its content in this template instance - $this->assignVariable('header', $this->getTemplateInstance()->getRawTemplateData()); + /** + * Starts the menu property 'anchor-text' + * + * @return void + */ + private function startAnchorText () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'anchor-text'); } /** - * Finishes the menu block header + * Starts the menu property 'anchor-title' * * @return void */ - private function finishBlockHeader () { - // Load the header template for this page - $this->getTemplateInstance()->loadCodeTemplate('menu_header_end'); + private function startAnchorTitle () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'anchor-title'); + } - // Set the variable group to page - $this->setVariableGroup('menu'); + /** + * Starts the menu property 'anchor-href' + * + * @return void + */ + private function startAnchorHref () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'anchor-href'); + } - // Set its content in this template instance - $this->assignVariable('header_end', $this->getTemplateInstance()->getRawTemplateData()); + /** + * Starts the menu property 'footer-id' + * + * @return void + */ + private function startFooterId () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'footer-id'); } /** - * Starts the menu block footer + * Starts the menu property 'footer-class' * * @return void */ - private function startBlockFooter () { - // Do we have a template instance? - if (is_null($this->getTemplateInstance())) { - // Init template instance for underlaying web templates - $templateInstance = ObjectFactory::createObjectByConfiguredName('web_template_class'); + private function startFooterClass () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'footer-class'); + } - // Set it in this template engine - $this->setTemplateInstance($templateInstance); - } // END - if + /** + * Starts the menu property 'footer-text' + * + * @return void + */ + private function startFooterText () { + // Push the node name on the stacker + $this->getStackInstance()->pushNamed('current_node', 'footer-text'); + } - // Load the footer template for this page - $this->getTemplateInstance()->loadCodeTemplate('menu_footer_start'); + /** + * Finishes the title node by added another template to the menu + * + * @return void + */ + private function finishTitle () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); + } - // Set the variable group to page - $this->setVariableGroup('menu'); + /** + * Finishes the title-id node by + * + * @return void + */ + private function finishTitleId () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); + } - // Set its content in this template instance - $this->assignVariable('footer', $this->getTemplateInstance()->getRawTemplateData()); + /** + * Finishes the title-class node + * + * @return void + */ + private function finishTitleClass () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); } /** - * Finishes the menu block footer + * Finishes the title-class node * * @return void */ - private function finishBlockFooter () { - // Load the footer template for this page - $this->getTemplateInstance()->loadCodeTemplate('menu_footer_end'); + private function finishTitleText () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); + } - // Set the variable group to page - $this->setVariableGroup('menu'); + /** + * Finishes the footer-text node + * + * @return void + */ + private function finishFooterText () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); + } - // Set its content in this template instance - $this->assignVariable('footer_end', $this->getTemplateInstance()->getRawTemplateData()); + /** + * Finishes the footer-class node + * + * @return void + */ + private function finishFooterClass () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); } /** - * Starts the menu property 'title' + * Finishes the footer-id node * * @return void */ - private function startTitle () { - $this->partialStub('Cleared due to XML rewrite.'); + private function finishFooterId () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); } /** - * Finishes the title node by added another template to the menu + * Finishes the anchor-href node * * @return void */ - private function finishTitle () { - $this->partialStub('Cleared due to XML rewrite.'); + private function finishAnchorHref () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); } /** - * Starts the menu text + * Finishes the anchor-title node * * @return void */ - private function startText () { - // Do we have a template instance? - if (is_null($this->getTemplateInstance())) { - // Init template instance for underlaying web templates - $templateInstance = ObjectFactory::createObjectByConfiguredName('web_template_class'); + private function finishAnchorTitle () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); + } - // Set it in this template engine - $this->setTemplateInstance($templateInstance); - } // END - if + /** + * Finishes the anchor-text node + * + * @return void + */ + private function finishAnchorText () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); + } - // Load the text template for this page - $this->getTemplateInstance()->loadCodeTemplate('menu_text_start'); + /** + * Finishes the anchor-id node + * + * @return void + */ + private function finishAnchorId () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); + } - // Set the variable group to page - $this->setVariableGroup('menu'); + /** + * Finishes the anchor node + * + * @return void + */ + private function finishAnchor () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); + } - // Set its content in this template instance - $this->assignVariable('text', $this->getTemplateInstance()->getRawTemplateData()); + /** + * Finishes the entry-id node + * + * @return void + */ + private function finishEntryId () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); } /** - * Finishes the menu text + * Finishes the entry node * * @return void */ - private function finishText () { - // Load the text template for this page - $this->getTemplateInstance()->loadCodeTemplate('menu_text_end'); + private function finishEntry () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); + } - // Set the variable group to page - $this->setVariableGroup('menu'); + /** + * Finishes the block node + * + * @return void + */ + private function finishBlock () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); + } - // Set its content in this template instance - $this->assignVariable('text_end', $this->getTemplateInstance()->getRawTemplateData()); + /** + * Finishes the block-list node + * + * @return void + */ + private function finishBlockList () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); } /** - * Starts the menu property 'entry' + * Finishes the menu entries * * @return void */ - private function startEntry () { - $this->partialStub('Cleared due to XML rewrite.'); + private function finishEntryList () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); } /** - * Finishes the entry node by added another template to the menu + * Finishes the menu block header * * @return void */ - private function finishEntry () { - $this->partialStub('Cleared due to XML rewrite.'); + private function finishBlockHeader () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); } /** - * Starts the menu property 'anchor' + * Finishes the menu block footer * - * @param $id Id of the anchor - * @param $link Link text of the anchor - * @param $title Link title of the anchor * @return void */ - private function startAnchor () { - $this->partialStub('Please implement this method.'); + private function finishBlockFooter () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); } /** - * Finishes the anchor node by added another template to the menu + * Finishes the menu * * @return void */ - private function finishAnchor () { - $this->partialStub('Please implement this method.'); + private function finishMenu () { + // Pop the last entry + $this->getStackInstance()->popNamed('current_node'); } /** @@ -570,7 +721,7 @@ class MenuTemplateEngine extends BaseTemplateEngine implements CompileableTempla */ public function getMenuCacheFqfn () { // Get the FQFN ready - $fqfn = sprintf("%s%s%s/%s.%s", + $fqfn = sprintf('%s%s%s/%s.%s', $this->getConfigInstance()->getConfigEntry('base_path'), $this->getGenericBasePath(), 'menus/_cache',