X-Git-Url: http://www.aleph1.co.uk/gitweb/?p=yaffs-website;a=blobdiff_plain;f=web%2Fmodules%2Fcontrib%2Fadvanced_help%2Fsrc%2FController%2FAdvancedHelpController.php;fp=web%2Fmodules%2Fcontrib%2Fadvanced_help%2Fsrc%2FController%2FAdvancedHelpController.php;h=8e06706d9709de614d17009836598e21b808e65c;hp=0000000000000000000000000000000000000000;hb=8acec36f19c470dfcda1ae2336826a782f41874c;hpb=e0411c4e83ba0d079034db83c3f7f55be24a0e35 diff --git a/web/modules/contrib/advanced_help/src/Controller/AdvancedHelpController.php b/web/modules/contrib/advanced_help/src/Controller/AdvancedHelpController.php new file mode 100644 index 000000000..8e06706d9 --- /dev/null +++ b/web/modules/contrib/advanced_help/src/Controller/AdvancedHelpController.php @@ -0,0 +1,391 @@ +advanced_help = $advanced_help; + } + + /** + * {@inheritdoc} + */ + public static function create(ContainerInterface $container) { + return new static( + $container->get('plugin.manager.advanced_help') + ); + } + + /** + * Content. + * + * @todo Implement search integration. + * @return array + * Returns module index. + */ + public function main() { + $topics = $this->advanced_help->getTopics(); + $settings = $this->advanced_help->getSettings(); + + // Print a module index. + $modules = $this->advanced_help->getModuleList(); + asort($modules); + + $items = []; + foreach ($modules as $module => $module_name) { + if (!empty($topics[$module]) && empty($settings[$module]['hide'])) { + if (isset($settings[$module]['index name'])) { + $name = $settings[$module]['index name']; + } + elseif (isset($settings[$module]['name'])) { + $name = $settings[$module]['name']; + } + else { + $name = $this->t($module_name); + } + $items[] = $this->l($name, new Url('advanced_help.module_index', ['module' => $module])); + } + } + + return [ + 'help_modules' => [ + '#theme' => 'item_list', + '#items' => $items, + '#title' => $this->t('Module help index'), + ] + ]; + } + + /** + * Build a hierarchy for a single module's topics. + * + * @param $topics array. + * @return array. + */ + private function getTopicHierarchy($topics) { + foreach ($topics as $module => $module_topics) { + foreach ($module_topics as $topic => $info) { + $parent_module = $module; + // We have a blank topic that we don't want parented to itself. + if (!$topic) { + continue; + } + + if (empty($info['parent'])) { + $parent = ''; + } + elseif (strpos($info['parent'], '%')) { + list($parent_module, $parent) = explode('%', $info['parent']); + if (empty($topics[$parent_module][$parent])) { + // If it doesn't exist, top level. + $parent = ''; + } + } + else { + $parent = $info['parent']; + if (empty($module_topics[$parent])) { + // If it doesn't exist, top level. + $parent = ''; + } + } + + if (!isset($topics[$parent_module][$parent]['children'])) { + $topics[$parent_module][$parent]['children'] = []; + } + $topics[$parent_module][$parent]['children'][] = [$module, $topic]; + $topics[$module][$topic]['_parent'] = [$parent_module, $parent]; + } + } + return $topics; + } + + /** + * Helper function to sort topics. + * @param string $id_a + * @param string $id_b + * @return mixed + */ + private function helpUasort($id_a, $id_b) { + $topics = $this->advanced_help->getTopics(); + list($module_a, $topic_a) = $id_a; + $a = $topics[$module_a][$topic_a]; + list($module_b, $topic_b) = $id_b; + $b = $topics[$module_b][$topic_b]; + + $a_weight = isset($a['weight']) ? $a['weight'] : 0; + $b_weight = isset($b['weight']) ? $b['weight'] : 0; + if ($a_weight != $b_weight) { + return ($a_weight < $b_weight) ? -1 : 1; + } + + if ($a['title'] != $b['title']) { + return ($a['title'] < $b['title']) ? -1 : 1; + } + return 0; + } + + /** + * Build a tree of advanced help topics. + * + * @param array $topics + * Topics. + * @param array $topic_ids + * Topic Ids. + * @param int $max_depth + * Maximum depth for subtopics. + * @param int $depth + * Default depth for subtopics. + * + * @return array + * Returns list of topics/subtopics. + */ + private function getTree($topics, $topic_ids, $max_depth = -1, $depth = 0) { + uasort($topic_ids, [$this, 'helpUasort']); + $items = []; + foreach ($topic_ids as $info) { + list($module, $topic) = $info; + $item = $this->l($topics[$module][$topic]['title'], new Url('advanced_help.help', ['module' => $module, 'topic' => $topic])); + if (!empty($topics[$module][$topic]['children']) && ($max_depth == -1 || $depth < $max_depth)) { + $link = [ + '#theme' => 'item_list', + '#items' => advanced_help_get_tree($topics, $topics[$module][$topic]['children'], $max_depth, $depth + 1), + ]; + $item .= \Drupal::service('renderer')->render($link, FALSE); + } + $items[] = $item; + } + + return $items; + } + + + public function moduleIndex($module) { + $topics = $this->advanced_help->getTopics(); + + if (empty($topics[$module])) { + throw new NotFoundHttpException(); + } + + $topics = $this->getTopicHierarchy($topics); + $items = $this->getTree($topics, $topics[$module]['']['children']); + + return [ + 'index' => [ + '#theme' => 'item_list', + '#items' => $items, + ] + ]; + } + + /** + * Set the name of the module in the index page. + * + * @param string $module Module name + * @return string + */ + public function moduleIndexTitle($module) { + return $this->advanced_help->getModuleName($module) . ' help index'; + } + + public function topicPage(Request $request, $module, $topic) { + $is_modal = ($request->query->get(MainContentViewSubscriber::WRAPPER_FORMAT) === 'drupal_modal'); + $info = $this->advanced_help->getTopic($module, $topic); + if (!$info) { + throw new NotFoundHttpException(); + } + + $parent = $info; + $pmodule = $module; + + // Loop checker. + $checked = []; + while (!empty($parent['parent'])) { + if (strpos($parent['parent'], '%')) { + list($pmodule, $ptopic) = explode('%', $parent['parent']); + } + else { + $ptopic = $parent['parent']; + } + + if (!empty($checked[$pmodule][$ptopic])) { + break; + } + + $checked[$pmodule][$ptopic] = TRUE; + + $parent = $this->advanced_help->getTopic($pmodule, $ptopic); + if (!$parent) { + break; + } + + } + + $build = $this->viewTopic($module, $topic, $is_modal); + if (empty($build['#markup'])) { + $build['#markup'] = $this->t('Missing help topic.'); + } + $build['#attached']['library'][] = 'advanced_help/help'; + return $build; + } + + /** + * Load and render a help topic. + * + * @param string $module + * Name of the module. + * @param string $topic + * Name of the topic. + * @todo port the drupal_alter functionality. + * + * @return string + * Returns formatted topic. + */ + public function viewTopic($module, $topic, $is_modal = false) { + $file_info = $this->advanced_help->getTopicFileInfo($module, $topic); + if ($file_info) { + $info = $this->advanced_help->getTopic($module, $topic); + $file = "{$file_info['path']}/{$file_info['file']}"; + $build = [ + '#type' => 'markup', + ]; + + if (!empty($info['css'])) { + $build['#attached']['library'][] = $info['module'] . '/' . $info['css']; + } + + $build['#markup'] = file_get_contents($file); + if (isset($info['readme file']) && $info['readme file']) { + $ext = pathinfo($file, PATHINFO_EXTENSION); + if ('md' == $ext) { + $build['#markup'] = '