Add welcome front page

Author: carlbennett

src/controllers/FrontPage.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace BNETDocs\Controllers;
+
+use \BNETDocs\Models\FrontPage as FrontPageModel;
+use \CarlBennett\MVC\Libraries\Controller;
+use \CarlBennett\MVC\Libraries\Router;
+use \CarlBennett\MVC\Libraries\View;
+
+class FrontPage extends Controller {
+
+  public function &run( Router &$router, View &$view, array &$args ) {
+
+    $model = new FrontPageModel();
+
+    $view->render( $model );
+
+    $model->_responseCode = 200;
+    $model->_responseHeaders['Content-Type'] = $view->getMimeType();
+    $model->_responseTTL = 300;
+
+    return $model;
+
+  }
+
+}

src/controllers/Legacy.php

@@ -46,7 +46,7 @@ public function &run(Router &$router, View &$view, array &$args) {
     }
 
     if (is_null($model->url)) {
-      $model->url = '/news';
+      $model->url = '/welcome';
       $model->is_legacy = false;
       $code = 302;
     } else {

src/main.php

@@ -1,7 +1,7 @@
 <?php
 /**
  *  BNETDocs, the documentation and discussion website for Blizzard protocols
- *  Copyright (C) 2003-2018  "Arta", Don Cullen "Kyro", Carl Bennett, others
+ *  Copyright (C) 2003-2019  "Arta", Don Cullen "Kyro", Carl Bennett, others
  *  This file is part of BNETDocs.
  *
  *  BNETDocs is free software: you can redistribute it and/or modify
@@ -258,6 +258,9 @@ function main() {
     $router->addRoute( // URL: /user/update
       "#^/user/update/?$#", "User\\Update", "User\\UpdateHtml"
     );
+    $router->addRoute( // URL: /welcome
+      "#^/welcome/?$#", "FrontPage", "FrontPageHtml"
+    );
     $router->addRoute("#.*#", "PageNotFound", "PageNotFoundHtml"); // URL: *
   }
 

src/models/FrontPage.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace BNETDocs\Models;
+
+use \CarlBennett\MVC\Libraries\Model;
+
+class FrontPage extends Model {}

src/templates/FrontPage.phtml

@@ -0,0 +1,24 @@
+<?php
+
+namespace BNETDocs\Templates;
+
+use \CarlBennett\MVC\Libraries\Common;
+use \CarlBennett\MVC\Libraries\Pair;
+
+$title       = "Welcome";
+$description = "Welcome to the documentation and discussion for the Classic Battle.net protocol";
+
+$this->opengraph->attach(new Pair("url", "/welcome"));
+$this->opengraph->attach(new Pair("type", "article"));
+
+require("./header.inc.phtml");
+?>
+      <article>
+        <header>Welcome to BNETDocs!</header>
+        <section>
+          <p>TODO: make this page fuller.</p>
+          <p>i Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla vitae suscipit ex. Phasellus tempus scelerisque pulvinar. Donec sollicitudin porta sapien quis accumsan. Quisque ipsum lectus, tempor eget purus eu, bibendum interdum ligula. Morbi quis magna a leo volutpat malesuada. Nulla hendrerit elementum nisl, eget lobortis massa tincidunt in. Pellentesque vestibulum accumsan vulputate. Sed arcu augue, congue ut sapien vitae, pharetra facilisis lacus. Aenean elit metus, cursus vel mauris in, condimentum elementum nisl.</p>
+          <p>Praesent quam magna, pretium vitae fermentum sed, iaculis ut lectus. Vestibulum dapibus purus vitae bibendum volutpat. Quisque pretium, orci ut facilisis ullamcorper, nulla lectus sodales ex, vel bibendum dui lectus et risus. Vivamus quis vestibulum magna. Mauris tristique arcu mauris, id consequat est convallis vel. Nam at diam sed nisi maximus sodales at nec nunc. Etiam sagittis tellus eget fermentum rutrum. Vivamus et fermentum lacus. Duis dapibus libero quis fermentum feugiat.</p>
+        </section>
+      </article>
+<?php require("./footer.inc.phtml"); ?>

src/templates/footer.inc.phtml

@@ -9,7 +9,7 @@ use \CarlBennett\MVC\Libraries\Common;
 ?>
     </main>
     <footer class="main-page<?php if (isset($slim_ui) && $slim_ui) { ?> slim<?php } ?>">
-      <p><?php if ( VersionInfo::$version->bnetdocs ) { ?><a href="https://github.com/BNETDocs/bnetdocs-web/tree/<?php echo VersionInfo::$version->bnetdocs[1]; ?>" rel="external" title="Contribute to the BNETDocs source code!">BNETDocs <?php echo VersionInfo::$version->bnetdocs[0]; ?></a><?php } else { ?>(Development)<?php } ?> &copy; 2003-2018 BNETDocs | <a href="<?php echo Common::relativeUrlToAbsolute("/legal"); ?>" rel="external" title="BNETDocs Legal Policies">Legal page</a></p>
+      <p><?php if ( VersionInfo::$version->bnetdocs ) { ?><a href="https://github.com/BNETDocs/bnetdocs-web/tree/<?php echo VersionInfo::$version->bnetdocs[1]; ?>" rel="external" title="Contribute to the BNETDocs source code!">BNETDocs <?php echo VersionInfo::$version->bnetdocs[0]; ?></a><?php } else { ?>(Development)<?php } ?> &copy; 2003-2019 BNETDocs | <a href="<?php echo Common::relativeUrlToAbsolute("/legal"); ?>" rel="external" title="BNETDocs Legal Policies">Legal page</a></p>
       <p style="font-size:smaller;">
 BNETDocs is a documentation and discussion website for Blizzard Entertainment's
 Battle.net&trade; and in-game protocols. You hereby acknowledge that BNETDocs

src/templates/header.inc.phtml

@@ -99,10 +99,11 @@ $_campaign_vultr = (
 <?php } ?>
   </head>
   <body>
-    <header class="main-page"><img src="<?php echo Common::relativeUrlToAbsolute("/a/VSZX0bJ.png"); ?>" style="float:left;margin-right:6px;height:32px;"/> BNETDocs<span id="mobile-nav">&#9776;</span><?php echo $_campaign_vultr; ?></header>
+    <header class="main-page"><a href="<?php echo Common::relativeUrlToAbsolute('/welcome'); ?>"><img src="<?php echo Common::relativeUrlToAbsolute("/a/VSZX0bJ.png"); ?>" style="float:left;margin-right:6px;height:32px;"/> BNETDocs</a> <span id="mobile-nav">&#9776;</span><?php echo $_campaign_vultr; ?></header>
 <?php if (!(isset($slim_ui) && $slim_ui)) { ?>
     <nav>
       <a>Portal</a>
+      <a href="<?php echo Common::relativeUrlToAbsolute("/welcome"); ?>">Welcome</a>
       <a href="<?php echo Common::relativeUrlToAbsolute("/news"); ?>">News</a>
       <a href="<?php echo Common::relativeUrlToAbsolute("/credits"); ?>">Contributors</a>
       <a href="<?php echo Common::relativeUrlToAbsolute("/user/index"); ?>">Members</a>

src/views/FrontPageHtml.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace BNETDocs\Views;
+
+use \BNETDocs\Models\FrontPage as FrontPageModel;
+use \CarlBennett\MVC\Libraries\Exceptions\IncorrectModelException;
+use \CarlBennett\MVC\Libraries\Model;
+use \CarlBennett\MVC\Libraries\Template;
+use \CarlBennett\MVC\Libraries\View;
+
+class FrontPageHtml extends View {
+
+  public function getMimeType() {
+    return "text/html;charset=utf-8";
+  }
+
+  public function render(Model &$model) {
+    if (!$model instanceof FrontPageModel) {
+      throw new IncorrectModelException();
+    }
+    (new Template($model, "FrontPage"))->render();
+  }
+
+}