move doc file parsing and rendering from the module level to the help library so that it can be re-used by widgets

2016-09-04 00:50:35 -07:00
parent 0998a108ea
commit 5a1887ed17
3 changed files with 101 additions and 86 deletions
--- a/include/help.php
+++ b/include/help.php
@@ -1,5 +1,98 @@
 <?php

+function get_help_content() {
+	
+	global $lang;
+	
+	$doctype = 'markdown';
+	
+	$text = '';
+
+	if(argc() > 1) {
+		$path = '';
+		for($x = 1; $x < argc(); $x ++) {
+			if(strlen($path))
+				$path .= '/';
+			$path .= argv($x);
+		}
+		$title = basename($path);
+
+		$text = load_doc_file('doc/' . $path . '.md');
+		\App::$page['title'] = t('Help:') . ' ' . ucwords(str_replace('-',' ',notags($title)));
+	
+		if(! $text) {
+			$text = load_doc_file('doc/' . $path . '.bb');
+			if($text)
+				$doctype = 'bbcode';
+			\App::$page['title'] = t('Help:') . ' ' . ucwords(str_replace('_',' ',notags($title)));
+		}
+		if(! $text) {
+			$text = load_doc_file('doc/' . $path . '.html');
+			if($text)
+				$doctype = 'html';
+			\App::$page['title'] = t('Help:') . ' ' . ucwords(str_replace('-',' ',notags($title)));
+		}
+	}
+	
+	if(! $text) {
+		$text = load_doc_file('doc/Site.md');
+		\App::$page['title'] = t('Help');
+	}
+	if(! $text) {
+		$doctype = 'bbcode';
+		$text = load_doc_file('doc/main.bb');
+		\App::$page['title'] = t('Help');
+	}
+		
+	if(! strlen($text)) {
+		header($_SERVER["SERVER_PROTOCOL"] . ' 404 ' . t('Not Found'));
+		$tpl = get_markup_template("404.tpl");
+		return replace_macros($tpl, array(
+			'$message' =>  t('Page not found.' )
+		));
+	}
+	
+	if($doctype === 'html')
+		$content = $text;
+	if($doctype === 'markdown')	{
+		require_once('library/markdown.php');
+		# escape #include tags
+		$text = preg_replace('/#include/ism', '%%include', $text);
+		$content = Markdown($text);
+		$content = preg_replace('/%%include/ism', '#include', $content);
+	}
+	if($doctype === 'bbcode') {
+		require_once('include/bbcode.php');
+		$content = bbcode($text);
+		// bbcode retargets external content to new windows. This content is internal.
+		$content = str_replace(' target="_blank"','',$content);		
+	} 
+	
+	$content = preg_replace_callback("/#include (.*?)\;/ism", 'preg_callback_help_include', $content);
+	return $content;
+	
+}
+
+function preg_callback_help_include($matches) {
+	
+	if($matches[1]) {
+		$include = str_replace($matches[0],load_doc_file($matches[1]),$matches[0]);
+		if(preg_match('/\.bb$/', $matches[1]) || preg_match('/\.txt$/', $matches[1])) {
+			require_once('include/bbcode.php');
+			$include = bbcode($include);
+			$include = str_replace(' target="_blank"','',$include);		
+		} 
+		elseif(preg_match('/\.md$/', $matches[1])) {
+			require_once('library/markdown.php');
+			$include = Markdown($include);
+		}
+		return $include;
+	}
+	
+}
+
+
+
 function load_doc_file($s) {
 	$lang = \App::$language;
 	if(! isset($lang))