streams/Code/Module/Help.php

<?php

namespace Code\Module;

use App;
use Code\Web\Controller;
use Code\Lib\System;
use Code\Lib\Navbar;
use Code\Render\Theme;


require_once('include/help.php');

/**
 * You can create local site resources in doc/site
 */
class Help extends Controller
{

    public function get()
    {
        Navbar::set_selected('Help');

        if ($_REQUEST['search']) {
            $o = '<div id="help-content" class="generic-content-wrapper">';
            $o .= '<div class="section-title-wrapper">';
            $o .= '<h2>' . t('Documentation Search') . ' - ' . htmlspecialchars($_REQUEST['search']) . '</h2>';
            $o .= '</div>';
            $o .= '<div class="section-content-wrapper">';

            $r = search_doc_files($_REQUEST['search']);
            if ($r) {
                $o .= '<ul class="help-searchlist">';
                foreach ($r as $rr) {
                    $dirname = dirname($rr['v']);
                    $fname = basename($rr['v']);
                    $fname = substr($fname, 0, strrpos($fname, '.'));
                    $path = trim(substr($dirname, 4), '/');

                    $o .= '<li><a href="help/' . (($path) ? $path . '/' : '') . $fname . '" >' . ucwords(str_replace('_', ' ', notags($fname))) . '</a><br>'
                        . '<b><i>' . 'help/' . (($path) ? $path . '/' : '') . $fname . '</i></b><br>'
                        . '...' . str_replace('$Projectname', System::get_platform_name(), $rr['text']) . '...<br><br></li>';
                }
                $o .= '</ul>';
                $o .= '</div>';
                $o .= '</div>';
            }

            return $o;
        }


        if (argc() > 2 && argv(argc() - 2) === 'assets') {
            $path = '';
            for ($x = 1; $x < argc(); $x++) {
                if (strlen($path)) {
                    $path .= '/';
                }
                $path .= argv($x);
            }
            $realpath = 'doc/' . $path;
            //Set the content-type header as appropriate
            $imageInfo = getimagesize($realpath);
            switch ($imageInfo[2]) {
                case IMAGETYPE_JPEG:
                    header("Content-Type: image/jpeg");
                    break;
                case IMAGETYPE_GIF:
                    header("Content-Type: image/gif");
                    break;
                case IMAGETYPE_PNG:
                    header("Content-Type: image/png");
                    break;
                default:
                    break;
            }
            header("Content-Length: " . filesize($realpath));

            // dump the picture and stop the script
            readfile($realpath);
            killme();
        }
        $heading = '';
        if (argc() === 1) {

            $files = self::listdir('doc');

            if ($files) {
                usort($files, [ 'self','usort_basename']);
                foreach ($files as $file) {
                    if (! str_contains(z_mime_content_type($file), 'text')) {
                        continue;
                    }
                    if ((!strpos($file, '/site/')) && file_exists(str_replace('doc/', 'doc/site/', $file))) {
                        continue;
                    }
                    if (strpos($file, 'README')) {
                        continue;
                    }
                    if (preg_match('/\/(..|..-..)\//', $file, $matches)) {
                        $language = $matches[1];
                    } else {
                        $language = t('Unknown language');
                    }
                    if ($language === substr(App::$language, 0, 2)) {
                        $language = '';
                    }

                    $link = str_replace(['doc/', '.mc'], ['help/', ''], $file);
                    if (str_contains($link, '/global/') || str_contains($link, '/media/')) {
                        continue;
                    }
                    $content .= '<div class="nav-pills"><a href="' . $link . '">' . ucfirst(basename($link)) . '</a></div>' . (($language) ? " [$language]" : '') . EOL;
                }
            }
        } else {
            $content = get_help_content();
        }


        return replace_macros(Theme::get_template('help.tpl'), [
            '$title' => t('$Projectname Documentation'),
            '$tocHeading' => t('Contents'),
            '$content' => $content,
            '$heading' => $heading,
            '$language' => $language
        ]);
    }

    public static function usort_basename($a,$b) {
        return strcasecmp(basename($a), basename($b));
    }

    public static function listdir($path)
    {
        $results = [];
        $handle = opendir($path);
        if (!$handle) {
            return $results;
        }
        while (false !== ($file = readdir($handle))) {
            if ($file === '.' || $file === '..') {
                continue;
            }
            if (is_dir($path . '/' . $file)) {
                $results = array_merge($results, self::listdir($path . '/' . $file));
            } else {
                $results[] = $path . '/' . $file;
            }
        }
        closedir($handle);
        return $results;
    }
}