Namespace and ClassPath rewrites

Core/Documents/Account.class.php

@@ -0,0 +1,67 @@
+<?php
+
+
+namespace Core\Documents;
+
+use Core\Elements\TemplateDocument;
+use Core\Objects\Router\Router;
+
+
+class Account extends TemplateDocument {
+  public function __construct(Router $router, string $templateName) {
+    parent::__construct($router, $templateName);
+    $this->title = "Account";
+    $this->searchable = false;
+    $this->enableCSP();
+  }
+
+  private function createError(string $message) {
+    $this->parameters["view"]["success"] = false;
+    $this->parameters["view"]["message"] = $message;
+  }
+
+  protected function loadParameters() {
+    $this->parameters["view"] = ["success" => true];
+    if ($this->getTemplateName() === "account/reset_password.twig") {
+      if (isset($_GET["token"]) && is_string($_GET["token"]) && !empty($_GET["token"])) {
+        $this->parameters["view"]["token"] = $_GET["token"];
+        $req = new \Core\API\User\CheckToken($this->getContext());
+        $this->parameters["view"]["success"] = $req->execute(array("token" => $_GET["token"]));
+        if ($this->parameters["view"]["success"]) {
+          if (strcmp($req->getResult()["token"]["type"], "password_reset") !== 0) {
+            $this->createError("The given token has a wrong type.");
+          }
+        } else {
+          $this->createError("Error requesting password reset: " . $req->getLastError());
+        }
+      }
+    } else if ($this->getTemplateName() === "account/register.twig") {
+      $settings = $this->getSettings();
+      if ($this->getUser()) {
+        $this->createError("You are already logged in.");
+      } else if (!$settings->isRegistrationAllowed()) {
+        $this->createError("Registration is not enabled on this website.");
+      }
+    } else if ($this->getTemplateName() === "account/login.twig" && $this->getUser()) {
+      header("Location: /admin");
+      exit();
+    } else if ($this->getTemplateName() === "account/accept_invite.twig") {
+      if (isset($_GET["token"]) && is_string($_GET["token"]) && !empty($_GET["token"])) {
+        $this->parameters["view"]["token"] = $_GET["token"];
+        $req = new \Core\API\User\CheckToken($this->getContext());
+        $this->parameters["view"]["success"] = $req->execute(array("token" => $_GET["token"]));
+        if ($this->parameters["view"]["success"]) {
+          if (strcmp($req->getResult()["token"]["type"], "invite") !== 0) {
+            $this->createError("The given token has a wrong type.");
+          } else {
+            $this->parameters["view"]["invited_user"] = $req->getResult()["user"];
+          }
+        } else {
+          $this->createError("Error confirming e-mail address: " . $req->getLastError());
+        }
+      } else {
+        $this->createError("The link you visited is no longer valid");
+      }
+    }
+  }
+}

Core/Documents/Admin.class.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Core\Documents;
+
+use Core\Elements\TemplateDocument;
+use Core\Objects\Router\Router;
+
+class Admin extends TemplateDocument {
+  public function __construct(Router $router) {
+    $user = $router->getContext()->getUser();
+    $template = $user ? "admin.twig" : "redirect.twig";
+    $params = $user ? [] : ["url" => "/login"];
+    $this->title = "Administration";
+    $this->searchable = false;
+    parent::__construct($router, $template, $params);
+    $this->enableCSP();
+  }
+}

Core/Documents/Info.class.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Core\Documents;
+
+use Core\Elements\EmptyHead;
+use Core\Elements\HtmlDocument;
+use Core\Elements\SimpleBody;
+use Core\Objects\Router\Router;
+
+class Info extends HtmlDocument {
+  public function __construct(Router $router) {
+    parent::__construct($router, EmptyHead::class, InfoBody::class);
+    $this->searchable = false;
+  }
+}
+
+class InfoBody extends SimpleBody {
+  protected function getContent(): string {
+    $user = $this->getDocument()->getUser();
+    if ($user && $user->hasGroup(USER_GROUP_ADMIN)) {
+      phpinfo();
+      return "";
+    } else {
+      $message = "You are not logged in or do not have the proper privileges to access this page.";
+      return $this->getDocument()->getRouter()->returnStatusCode(403, [ "message" => $message] );
+    }
+  }
+}

Core/Documents/Install.class.php

@@ -0,0 +1,931 @@
+<?php
+
+namespace Core\Documents {
+
+  use Documents\Install\InstallBody;
+  use Documents\Install\InstallHead;
+  use Core\Elements\HtmlDocument;
+  use Core\Objects\Router\Router;
+
+  class Install extends HtmlDocument {
+    public function __construct(Router $router) {
+      parent::__construct($router, InstallHead::class, InstallBody::class);
+      $this->databaseRequired = false;
+    }
+  }
+}
+
+namespace Documents\Install {
+
+  use Core\Configuration\Configuration;
+  use Core\Configuration\CreateDatabase;
+  use Core\Driver\SQL\Query\Commit;
+  use Core\Driver\SQL\Query\RollBack;
+  use Core\Driver\SQL\Query\StartTransaction;
+  use Core\Driver\SQL\SQL;
+  use Core\Elements\Body;
+  use Core\Elements\Head;
+  use Core\Elements\Link;
+  use Core\Elements\Script;
+  use Core\External\PHPMailer\Exception;
+  use Core\External\PHPMailer\PHPMailer;
+  use Core\Objects\ConnectionData;
+
+  class InstallHead extends Head {
+
+    public function __construct($document) {
+      parent::__construct($document);
+    }
+
+    protected function initSources() {
+      $this->loadJQuery();
+      $this->loadBootstrap();
+      $this->loadFontawesome();
+      $this->addJS(Script::CORE);
+      $this->addCSS(Link::CORE);
+      $this->addJS(Script::INSTALL);
+    }
+
+    protected function initMetas(): array {
+      return array(
+        array('name' => 'viewport', 'content' => 'width=device-width, initial-scale=1.0'),
+        array('name' => 'format-detection', 'content' => 'telephone=yes'),
+        array('charset' => 'utf-8'),
+        array("http-equiv" => 'expires', 'content' => '0'),
+        array("name" => 'robots', 'content' => 'noarchive'),
+      );
+    }
+
+    protected function initRawFields(): array {
+      return array();
+    }
+
+    protected function initTitle(): string {
+      return "WebBase - Installation";
+    }
+
+  }
+
+  class InstallBody extends Body {
+
+    // Status enum
+    const NOT_STARTED = 0;
+    const PENDING = 1;
+    const SUCCESSFUL = 2;
+    const ERROR = 3;
+
+    // Step enum
+    const CHECKING_REQUIREMENTS = 1;
+    const INSTALL_DEPENDENCIES = 2;
+    const DATABASE_CONFIGURATION = 3;
+    const CREATE_USER = 4;
+    const ADD_MAIL_SERVICE = 5;
+    const FINISH_INSTALLATION = 6;
+
+    //
+    private string $errorString;
+    private int $currentStep;
+    private array $steps;
+
+    function __construct($document) {
+      parent::__construct($document);
+      $this->errorString = "";
+      $this->currentStep = InstallBody::CHECKING_REQUIREMENTS;
+      $this->steps = array();
+    }
+
+    function isDocker(): bool {
+      return file_exists("/.dockerenv");
+    }
+
+    private function getParameter($name): ?string {
+      if (isset($_REQUEST[$name]) && is_string($_REQUEST[$name])) {
+        return trim($_REQUEST[$name]);
+      }
+
+      return NULL;
+    }
+
+    private function composerInstall(bool $dryRun = false): array {
+      $command = "composer install";
+      if ($dryRun) {
+        $command .= " --dry-run";
+      }
+
+      $fds = [
+        "1" => ["pipe", "w"],
+        "2" => ["pipe", "w"],
+      ];
+
+      $dir = $this->getExternalDirectory();
+      $env = null;
+      if (!getenv("HOME")) {
+        $env = ["COMPOSER_HOME" => $dir];
+      }
+
+      $proc = proc_open($command, $fds, $pipes, $dir, $env);
+      $output = stream_get_contents($pipes[1]) . stream_get_contents($pipes[2]);
+      $status = proc_close($proc);
+      return [$status, $output];
+    }
+
+    private function getExternalDirectory(bool $absolute = true): string {
+      if ($absolute) {
+        return implode(DIRECTORY_SEPARATOR, [WEBROOT, "Core", "External"]);
+      } else {
+        return implode(DIRECTORY_SEPARATOR, ["Core", "External"]);
+      }
+    }
+
+    private function getCurrentStep(): int {
+
+      if (!$this->checkRequirements()["success"]) {
+        return self::CHECKING_REQUIREMENTS;
+      }
+
+      $externalDir = $this->getExternalDirectory();
+      $autoload = implode(DIRECTORY_SEPARATOR, [$externalDir, "vendor", "autoload.php"]);
+      if (!is_file($autoload)) {
+        return self::INSTALL_DEPENDENCIES;
+      } else {
+        list ($status, $output) = $this->composerInstall(true);
+        if ($status !== 0) {
+          $this->errorString = "Error executing 'composer install --dry-run'. Please verify that the command succeeds locally and then try again. Status Code: $status, Output: $output";
+          return self::CHECKING_REQUIREMENTS;
+        } else {
+          if (!contains($output, "Nothing to install, update or remove")) {
+            return self::INSTALL_DEPENDENCIES;
+          }
+        }
+      }
+
+      $context = $this->getDocument()->getContext();
+      $config = $context->getConfig();
+
+      // Check if database configuration exists
+      if (!$config->getDatabase()) {
+        return self::DATABASE_CONFIGURATION;
+      }
+
+      $sql = $context->getSQL();
+      if (!$sql || !$sql->isConnected()) {
+        return self::DATABASE_CONFIGURATION;
+      }
+
+      $countKeyword = $sql->count();
+      $res = $sql->select($countKeyword)->from("User")->execute();
+      if ($res === FALSE) {
+        return self::DATABASE_CONFIGURATION;
+      } else {
+        if ($res[0]["count"] > 0) {
+          $step = self::ADD_MAIL_SERVICE;
+        } else {
+          return self::CREATE_USER;
+        }
+      }
+
+      if ($step === self::ADD_MAIL_SERVICE) {
+        $req = new \Core\API\Settings\Get($context);
+        $success = $req->execute(array("key" => "^mail_enabled$"));
+        if (!$success) {
+          $this->errorString = $req->getLastError();
+          return self::DATABASE_CONFIGURATION;
+        } else if (isset($req->getResult()["settings"]["mail_enabled"])) {
+          $step = self::FINISH_INSTALLATION;
+
+          $req = new \Core\API\Settings\Set($context);
+          $success = $req->execute(array("settings" => array("installation_completed" => "1")));
+          if (!$success) {
+            $this->errorString = $req->getLastError();
+          } else {
+            $req = new \Core\API\Notifications\Create($context);
+            $req->execute(array(
+                "title" => "Welcome",
+                "message" => "Your Web-base was successfully installed. Check out the admin dashboard. Have fun!",
+                "groupId" => USER_GROUP_ADMIN
+              )
+            );
+            $this->errorString = $req->getLastError();
+          }
+        }
+      }
+
+      return $step;
+    }
+
+    private function command_exist(string $cmd): bool {
+      $return = shell_exec(sprintf("which %s 2>/dev/null", escapeshellarg($cmd)));
+      return !empty($return);
+    }
+
+    private function checkRequirements(): array {
+
+      $msg = $this->errorString;
+      $success = true;
+      $failedRequirements = array();
+
+      if (!is_writeable(WEBROOT)) {
+        $failedRequirements[] = sprintf("<b>%s</b> is not writeable. Try running <b>chmod 700 %s</b>", WEBROOT, WEBROOT);
+        $success = false;
+      }
+
+      if (function_exists("posix_getuid")) {
+        $userId = posix_getuid();
+        if (fileowner(WEBROOT) !== $userId) {
+          $username = posix_getpwuid($userId)['name'];
+          $failedRequirements[] = sprintf("<b>%s</b> is not owned by current user: $username ($userId). " .
+              "Try running <b>chown -R $userId %s</b> or give the required directories write permissions: " .
+              "<b>core/Configuration</b>, <b>core/Cache</b>, <b>core/External</b>",
+            WEBROOT, WEBROOT);
+          $success = false;
+        }
+      }
+
+      if (!function_exists("yaml_emit")) {
+        $failedRequirements[] = "<b>YAML</b> extension is not installed.";
+        $success = false;
+      }
+
+      $requiredVersion = '8.0';
+      if (version_compare(PHP_VERSION, $requiredVersion, '<')) {
+        $failedRequirements[] = "PHP Version <b>>= $requiredVersion</b> is required. Got: <b>" . PHP_VERSION . "</b>";
+        $success = false;
+      }
+
+      if (!$this->command_exist("composer")) {
+        $failedRequirements[] = "<b>Composer</b> is not installed or cannot be found.";
+        $success = false;
+      }
+
+      if (!$success) {
+        $msg = "The following requirements failed the check:<br>" .
+          $this->createUnorderedList($failedRequirements);
+        $this->errorString = $msg;
+      }
+
+      return array("success" => $success, "msg" => $msg);
+    }
+
+    private function installDependencies(): array {
+      list ($status, $output) = $this->composerInstall();
+      return ["success" => $status === 0, "msg" => $output];
+    }
+
+    private function databaseConfiguration(): array {
+
+      $host = $this->getParameter("host");
+      $port = $this->getParameter("port");
+      $username = $this->getParameter("username");
+      $password = $this->getParameter("password");
+      $database = $this->getParameter("database");
+      $type = $this->getParameter("type");
+      $encoding = $this->getParameter("encoding") ?? "UTF8";
+      $success = true;
+
+      $missingInputs = array();
+      if (empty($host)) {
+        $success = false;
+        $missingInputs[] = "Host";
+      }
+
+      if (empty($port)) {
+        $success = false;
+        $missingInputs[] = "Port";
+      }
+
+      if (empty($username)) {
+        $success = false;
+        $missingInputs[] = "Username";
+      }
+
+      if (is_null($password)) {
+        $success = false;
+        $missingInputs[] = "Password";
+      }
+
+      if (empty($database)) {
+        $success = false;
+        $missingInputs[] = "Database";
+      }
+
+      if (empty($type)) {
+        $success = false;
+        $missingInputs[] = "Type";
+      }
+
+      $supportedTypes = array("mysql", "postgres");
+      if (!$success) {
+        $msg = "Please fill out the following inputs:<br>" .
+          $this->createUnorderedList($missingInputs);
+      } else if (!is_numeric($port) || ($port = intval($port)) < 1 || $port > 65535) {
+        $msg = "Port must be in range of 1-65535.";
+        $success = false;
+      } else if (!in_array($type, $supportedTypes)) {
+        $msg = "Unsupported database type. Must be one of: " . implode(", ", $supportedTypes);
+        $success = false;
+      } else {
+        $connectionData = new ConnectionData($host, $port, $username, $password);
+        $connectionData->setProperty('database', $database);
+        $connectionData->setProperty('encoding', $encoding);
+        $connectionData->setProperty('type', $type);
+        $connectionData->setProperty('isDocker', $this->isDocker());
+        $sql = SQL::createConnection($connectionData);
+        $success = false;
+        if (is_string($sql)) {
+          $msg = "Error connecting to database: $sql";
+        } else if (!$sql->isConnected()) {
+          if (!$sql->checkRequirements()) {
+            $driverName = $sql->getDriverName();
+            $installLink = "https://www.php.net/manual/en/$driverName.setup.php";
+            $link = $this->createExternalLink($installLink);
+            $msg = "$driverName is not enabled yet. See: $link";
+          } else {
+            $msg = "Error connecting to database:<br>" . $sql->getLastError();
+          }
+        } else {
+
+          $msg = "";
+          $success = true;
+          $queries = CreateDatabase::createQueries($sql);
+          array_unshift($queries, new StartTransaction($sql));
+          $queries[] = new Commit($sql);
+          foreach ($queries as $query) {
+            try {
+              if (!$query->execute()) {
+                $msg = "Error creating tables: " . $sql->getLastError();
+                $success = false;
+              }
+            } finally {
+              if (!$success) {
+                (new RollBack($sql))->execute();
+              }
+            }
+
+            if (!$success) {
+              break;
+            }
+          }
+
+          if ($success) {
+            $context = $this->getDocument()->getContext();
+            $config = $context->getConfig();
+            if (Configuration::create(\Site\Configuration\Database::class, $connectionData) === false) {
+              $success = false;
+              $msg = "Unable to write database file";
+            } else {
+              $config->setDatabase($connectionData);
+              if (!$context->initSQL()) {
+                $success = false;
+                $msg = "Unable to verify database connection after installation";
+              } else {
+                $req = new \Core\API\Routes\GenerateCache($context);
+                if (!$req->execute()) {
+                  $success = false;
+                  $msg = "Unable to write route file: " . $req->getLastError();
+                }
+              }
+            }
+          }
+
+          $sql->close();
+        }
+      }
+
+      return array("success" => $success, "msg" => $msg);
+    }
+
+    private function createUser(): array {
+
+      $context = $this->getDocument()->getContext();
+      if ($this->getParameter("prev") === "true") {
+        $success = $context->getConfig()->delete("Database");
+        $msg = $success ? "" : error_get_last();
+        return array("success" => $success, "msg" => $msg);
+      }
+
+      $username = $this->getParameter("username");
+      $password = $this->getParameter("password");
+      $confirmPassword = $this->getParameter("confirmPassword");
+      $email = $this->getParameter("email") ?? "";
+
+      $success = true;
+      $missingInputs = array();
+
+      if (empty($username)) {
+        $success = false;
+        $missingInputs[] = "Username";
+      }
+
+      if (empty($password)) {
+        $success = false;
+        $missingInputs[] = "Password";
+      }
+
+      if (empty($confirmPassword)) {
+        $success = false;
+        $missingInputs[] = "Confirm Password";
+      }
+
+      if (!$success) {
+        $msg = "Please fill out the following inputs:<br>" .
+          $this->createUnorderedList($missingInputs);
+      } else {
+        $req = new \Core\API\User\Create($context);
+        $success = $req->execute(array(
+          'username' => $username,
+          'email' => $email,
+          'password' => $password,
+          'confirmPassword' => $confirmPassword,
+        ));
+
+        $msg = $req->getLastError();
+        if ($success) {
+          $sql = $context->getSQL();
+          $success = $sql->insert("UserGroup", array("group_id", "user_id"))
+            ->addRow(USER_GROUP_ADMIN, $req->getResult()["userId"])
+            ->execute();
+          $msg = $sql->getLastError();
+        }
+      }
+
+      return array("msg" => $msg, "success" => $success);
+    }
+
+    private function addMailService(): array {
+
+      $context = $this->getDocument()->getContext();
+      if ($this->getParameter("prev") === "true") {
+        $sql = $context->getSQL();
+        $success = $sql->delete("User")->execute();
+        $msg = $sql->getLastError();
+        return array("success" => $success, "msg" => $msg);
+      }
+
+      if ($this->getParameter("skip") === "true") {
+        $req = new \Core\API\Settings\Set($context);
+        $success = $req->execute(array("settings" => array("mail_enabled" => "0")));
+        $msg = $req->getLastError();
+      } else {
+
+        $address = $this->getParameter("address");
+        $port = $this->getParameter("port");
+        $username = $this->getParameter("username");
+        $password = $this->getParameter("password");
+        $success = true;
+
+        $missingInputs = array();
+        if (empty($address)) {
+          $success = false;
+          $missingInputs[] = "SMTP Address";
+        }
+
+        if (empty($port)) {
+          $success = false;
+          $missingInputs[] = "Port";
+        }
+
+        if (empty($username)) {
+          $success = false;
+          $missingInputs[] = "Username";
+        }
+
+        if (is_null($password)) {
+          $success = false;
+          $missingInputs[] = "Password";
+        }
+
+        if (!$success) {
+          $msg = "Please fill out the following inputs:<br>" .
+            $this->createUnorderedList($missingInputs);
+        } else if (!is_numeric($port) || ($port = intval($port)) < 1 || $port > 65535) {
+          $msg = "Port must be in range of 1-65535.";
+          $success = false;
+        } else {
+          $success = false;
+
+          $mail = new PHPMailer(true);
+          $mail->IsSMTP();
+          $mail->SMTPAuth = true;
+          $mail->Username = $username;
+          $mail->Password = $password;
+          $mail->Host = $address;
+          $mail->Port = $port;
+          $mail->SMTPSecure = 'tls';
+          $mail->Timeout = 10;
+
+          try {
+            $success = $mail->SmtpConnect();
+            if (!$success) {
+              $error = empty($mail->ErrorInfo) ? "Unknown Error" : $mail->ErrorInfo;
+              $msg = "Could not connect to SMTP Server: $error";
+            } else {
+              $success = true;
+              $msg = "";
+              $mail->smtpClose();
+            }
+          } catch (Exception $error) {
+            $msg = "Could not connect to SMTP Server: " . $error->errorMessage();
+          }
+
+          if ($success) {
+            $req = new \Core\API\Settings\Set($context);
+            $success = $req->execute(array("settings" => array(
+              "mail_enabled" => "1",
+              "mail_host" => "$address",
+              "mail_port" => "$port",
+              "mail_username" => "$username",
+              "mail_password" => "$password",
+            )));
+            $msg = $req->getLastError();
+          }
+        }
+      }
+
+      return array("success" => $success, "msg" => $msg);
+    }
+
+    private function performStep(): array {
+
+      switch ($this->currentStep) {
+
+        case self::CHECKING_REQUIREMENTS:
+          return $this->checkRequirements();
+
+        case self::INSTALL_DEPENDENCIES:
+          return $this->installDependencies();
+
+        case self::DATABASE_CONFIGURATION:
+          return $this->databaseConfiguration();
+
+        case self::CREATE_USER:
+          return $this->createUser();
+
+        case self::ADD_MAIL_SERVICE:
+          return $this->addMailService();
+
+        default:
+          return array(
+            "success" => false,
+            "msg" => "Invalid step number"
+          );
+      }
+    }
+
+    private function createProgressSidebar(): string {
+      $items = array();
+      foreach ($this->steps as $num => $step) {
+
+        $title = $step["title"];
+        $status = $step["status"];
+        $currentStep = ($num == $this->currentStep) ? " id=\"currentStep\"" : "";
+
+        switch ($status) {
+          case self::PENDING:
+            $statusIcon = $this->createIcon("spinner");
+            $statusText = "Loading…";
+            $statusColor = "muted";
+            break;
+
+          case self::SUCCESSFUL:
+            $statusIcon = $this->createIcon("check-circle");
+            $statusText = "Successful";
+            $statusColor = "success";
+            break;
+
+          case self::ERROR:
+            $statusIcon = $this->createIcon("times-circle");
+            $statusText = "Failed";
+            $statusColor = "danger";
+            break;
+
+          case self::NOT_STARTED:
+          default:
+            $statusIcon = $this->createIcon("circle", "far");
+            $statusText = "Pending";
+            $statusColor = "muted";
+            break;
+        }
+
+        $items[] = "
+          <li class=\"list-group-item d-flex justify-content-between lh-condensed\"$currentStep>
+            <div>
+              <h6 class=\"my-0\">$title</h6>
+              <small class=\"text-$statusColor\">$statusText</small>
+            </div>
+            <span class=\"text-$statusColor\">$statusIcon</span>
+          </li>";
+      }
+
+      return implode("", $items);
+    }
+
+    private function createFormItem($formItem, $inline = false): string {
+
+      $title = $formItem["title"];
+      $name = $formItem["name"];
+      $type = $formItem["type"];
+
+      $attributes = array(
+        "name" => $name,
+        "id" => $name,
+        "class" => "form-control"
+      );
+
+      if (isset($formItem["required"]) && $formItem["required"]) {
+        $attributes["required"] = "";
+      }
+
+      if ($type !== "select") {
+        $attributes["type"] = $type;
+
+        if (isset($formItem["value"]) && $formItem["value"]) {
+          $attributes["value"] = $formItem["value"];
+        }
+
+        if ($type === "number") {
+          if (isset($formItem["min"]) && is_numeric($formItem["min"]))
+            $attributes["min"] = $formItem["min"];
+          if (isset($formItem["max"]) && is_numeric($formItem["max"]))
+            $attributes["max"] = $formItem["max"];
+          if (isset($formItem["step"]) && is_numeric($formItem["step"]))
+            $attributes["step"] = $formItem["step"];
+        } else {
+          if (isset($formItem["default"])) {
+            $attributes["value"] = $formItem["default"];
+          }
+        }
+      }
+
+      // $attributes = html_attributes($attributes);
+      if ($type === "select") {
+        $items = $formItem["items"] ?? array();
+        $options = [];
+        foreach ($items as $key => $val) {
+          $options[] = html_tag_ex("option", ["value" => $key], $val, true, false);
+        }
+
+        $element = html_tag_ex("select", $attributes, $options, false);
+      } else {
+        $element = html_tag_short("input", $attributes);
+      }
+
+      $label = html_tag_ex("label", ["for" => $name], $title, true, false);
+      $className = ($inline ? "col-md-6 mb-3" : "d-block my-3");
+      return html_tag_ex("div", ["class" => $className], $label . $element, false);
+    }
+
+    private function createProgressMainview(): string {
+
+      $isDocker = $this->isDocker();
+      $defaultHost = ($isDocker ? "db" : "localhost");
+      $defaultUsername = ($isDocker ? "root" : "");
+      $defaultPassword = ($isDocker ? "webbasedb" : "");
+      $defaultDatabase = ($isDocker ? "webbase" : "");
+
+      $views = array(
+        self::CHECKING_REQUIREMENTS => array(
+          "title" => "Application Requirements",
+          "progressText" => "Checking requirements, please wait a moment…"
+        ),
+        self::INSTALL_DEPENDENCIES => array(
+          "title" => "Installing Dependencies",
+          "progressText" => "Please wait while required dependencies are being installed…",
+        ),
+        self::DATABASE_CONFIGURATION => array(
+          "title" => "Database configuration",
+          "form" => array(
+            array("title" => "Database Type", "name" => "type", "type" => "select", "required" => true, "items" => array(
+              "mysql" => "MySQL", "postgres" => "PostgreSQL"
+            )),
+            array("title" => "Username", "name" => "username", "type" => "text", "required" => true, "default" => $defaultUsername),
+            array("title" => "Password", "name" => "password", "type" => "password", "default" => $defaultPassword),
+            array("title" => "Database", "name" => "database", "type" => "text", "required" => true, "default" => $defaultDatabase),
+            array("type" => "row", "items" => array(
+              array(
+                "title" => "Address", "name" => "host", "type" => "text", "required" => true,
+                "value" => "localhost", "row" => true, "default" => $defaultHost
+              ),
+              array(
+                "title" => "Port", "name" => "port", "type" => "number", "required" => true,
+                "value" => "3306", "min" => "1", "max" => "65535", "row" => true
+              )
+            )),
+            array(
+              "title" => "Encoding", "name" => "encoding", "type" => "text", "required" => false,
+              "value" => "UTF8"
+            ),
+          )
+        ),
+        self::CREATE_USER => array(
+          "title" => "Create a User",
+          "form" => array(
+            array("title" => "Username", "name" => "username", "type" => "text", "required" => true),
+            array("title" => "Email", "name" => "email", "type" => "text"),
+            array("title" => "Password", "name" => "password", "type" => "password", "required" => true),
+            array("title" => "Confirm Password", "name" => "confirmPassword", "type" => "password", "required" => true),
+          ),
+          "previousButton" => true
+        ),
+        self::ADD_MAIL_SERVICE => array(
+          "title" => "Optional: Add Mail Service",
+          "form" => array(
+            array("title" => "Username", "name" => "username", "type" => "text", "required" => true),
+            array("title" => "Password", "name" => "password", "type" => "password"),
+            array("type" => "row", "items" => array(
+              array(
+                "title" => "SMTP Address", "name" => "address", "type" => "text", "required" => true,
+                "value" => "localhost", "row" => true
+              ),
+              array(
+                "title" => "Port", "name" => "port", "type" => "number", "required" => true,
+                "value" => "587", "min" => "1", "max" => "65535", "row" => true
+              )
+            )),
+          ),
+          "skip" => true,
+          "previousButton" => true
+        ),
+        self::FINISH_INSTALLATION => array(
+          "title" => "Finish Installation",
+          "text" => "Installation finished, you can now customize your own website, check the source code and stuff."
+        )
+      );
+
+      if (!isset($views[$this->currentStep])) {
+        return "";
+      }
+
+      $currentView = $views[$this->currentStep];
+      $prevDisabled = !isset($currentView["previousButton"]) || !$currentView["previousButton"];
+      $spinnerIcon = $this->createIcon("spinner");
+      $title = $currentView["title"];
+
+      $html = "<h4 class=\"mb-3\">$title</h4><hr class=\"mb-4\" />";
+
+      if (isset($currentView["text"])) {
+        $text = $currentView["text"];
+        $html .= "<div class=\"my-3\">$text</i></div>";
+      }
+
+      if (isset($currentView["progressText"])) {
+        $progressText = $currentView["progressText"];
+        $hidden = (!in_array($this->currentStep, [self::CHECKING_REQUIREMENTS, self::INSTALL_DEPENDENCIES]))
+          ? " hidden" : "";
+        $html .= "<div id=\"progressText\" class=\"my-3$hidden\">$progressText$spinnerIcon</i></div>";
+      }
+
+      if (isset($currentView["form"])) {
+        $html .= "<form id=\"installForm\">";
+
+        foreach ($currentView["form"] as $formItem) {
+
+          if ($formItem["type"] === "row") {
+            $html .= "<div class=\"row\">";
+            foreach ($formItem["items"] as $item) {
+              $html .= $this->createFormItem($item, true);
+            }
+            $html .= "</div>";
+          } else {
+            $html .= $this->createFormItem($formItem);
+          }
+        }
+
+        $html .= "</form>";
+      }
+
+      $buttons = array(
+        array("title" => "Go Back", "type" => "info", "id" => "btnPrev", "float" => "left", "disabled" => $prevDisabled)
+      );
+
+      if ($this->currentStep != self::FINISH_INSTALLATION) {
+        if (in_array($this->currentStep, [self::CHECKING_REQUIREMENTS, self::INSTALL_DEPENDENCIES])) {
+          $buttons[] = array("title" => "Retry", "type" => "success", "id" => "btnRetry", "float" => "right", "hidden" => true);
+        } else {
+          $buttons[] = array("title" => "Submit", "type" => "success", "id" => "btnSubmit", "float" => "right");
+        }
+      } else {
+        $buttons[] = array("title" => "Finish", "type" => "success", "id" => "btnFinish", "float" => "right");
+      }
+
+      if (isset($currentView["skip"])) {
+        $buttons[] = array("title" => "Skip", "type" => "secondary", "id" => "btnSkip", "float" => "right");
+      }
+
+      $buttonsLeft = "";
+      $buttonsRight = "";
+
+      foreach ($buttons as $button) {
+        $title = $button["title"];
+        $type = $button["type"];
+        $id = $button["id"];
+        $float = $button["float"];
+        $disabled = (isset($button["disabled"]) && $button["disabled"]) ? " disabled" : "";
+        $hidden = (isset($button["hidden"]) && $button["hidden"]) ? " hidden" : "";
+        $button = "<button type=\"button\" id=\"$id\" class=\"btn btn-$type m-1$hidden\"$disabled>$title</button>";
+
+        if ($float === "left") {
+          $buttonsLeft .= $button;
+        } else {
+          $buttonsRight .= $button;
+        }
+      }
+
+      $html .=
+        "<div class=\"row\">
+          <div class=\"col-6 float-left text-left\">$buttonsLeft</div>
+          <div class=\"col-6 float-right text-right\">$buttonsRight</div>
+        </div>";
+
+      return $html;
+    }
+
+    function getCode(): string {
+      $html = parent::getCode();
+
+      $this->steps = array(
+        self::CHECKING_REQUIREMENTS => array(
+          "title" => "Checking requirements",
+          "status" => self::ERROR
+        ),
+        self::INSTALL_DEPENDENCIES => array(
+          "title" => "Install dependencies",
+          "status" => self::NOT_STARTED
+        ),
+        self::DATABASE_CONFIGURATION => array(
+          "title" => "Database configuration",
+          "status" => self::NOT_STARTED
+        ),
+        self::CREATE_USER => array(
+          "title" => "Create User",
+          "status" => self::NOT_STARTED
+        ),
+        self::ADD_MAIL_SERVICE => array(
+          "title" => "Add Mail Service",
+          "status" => self::NOT_STARTED
+        ),
+        self::FINISH_INSTALLATION => array(
+          "title" => "Finish Installation",
+          "status" => self::NOT_STARTED
+        ),
+      );
+
+      $this->currentStep = $this->getCurrentStep();
+
+      // set status
+      for ($step = self::CHECKING_REQUIREMENTS; $step < $this->currentStep; $step++) {
+        $this->steps[$step]["status"] = self::SUCCESSFUL;
+      }
+
+      if ($this->currentStep == self::FINISH_INSTALLATION) {
+        $this->steps[$this->currentStep]["status"] = self::SUCCESSFUL;
+      }
+
+      // POST
+      if ($_SERVER['REQUEST_METHOD'] == 'POST') {
+        if (!isset($_REQUEST['status'])) {
+          $response = $this->performStep();
+        } else {
+          $response = ["error" => $this->errorString];
+        }
+        $response["step"] = $this->currentStep;
+        die(json_encode($response));
+      }
+
+      $progressSidebar = $this->createProgressSidebar();
+      $progressMainView = $this->createProgressMainview();
+
+      $errorStyle = ($this->errorString ? '' : ' style="display:none"');
+      $errorClass = ($this->errorString ? ' alert-danger' : '');
+
+      $html .= "
+        <body class=\"bg-light\">
+          <div class=\"container\">
+            <div class=\"py-5 text-center\">
+              <h2>WebBase - Installation</h2>
+              <p class=\"lead\">
+                Process the following steps and fill out the required forms to install your WebBase-Installation.
+              </p>
+            </div>
+
+          <div class=\"row\">
+            <div class=\"col-md-4 order-md-2 mb-4\">
+              <h4 class=\"d-flex justify-content-between align-items-center mb-3\">
+                <span class=\"text-muted\">Progress</span>
+              </h4>
+
+              <ul class=\"list-group mb-3\">
+                $progressSidebar
+              </ul>
+            </div>
+            <div class=\"col-md-8 order-md-1\">
+              $progressMainView
+              <div class=\"alert$errorClass mt-4\" id=\"status\"$errorStyle>$this->errorString</div>
+            </div>
+          </div>
+        </div>
+      </body>";
+
+      return $html;
+    }
+  }
+}