Allow donations to BNETDocs

Author: carlbennett

etc/config.sample.json

@@ -1,5 +1,6 @@
 {
   "bnetdocs": {
+    "btc_donate_address": "",
     "maintenance": [
       false,
       "BNETDocs has to take a brief moment to do some system maintenance. We'll be back shortly."

src/controllers/Donate.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace BNETDocs\Controllers;
+
+use \BNETDocs\Libraries\VersionInfo;
+use \BNETDocs\Models\Donate as DonateModel;
+use \CarlBennett\MVC\Libraries\Common;
+use \CarlBennett\MVC\Libraries\Controller;
+use \CarlBennett\MVC\Libraries\Router;
+use \CarlBennett\MVC\Libraries\View;
+use \DateTime;
+use \DateTimeZone;
+
+class Donate extends Controller {
+
+  public function &run(Router &$router, View &$view, array &$args) {
+
+    $model              = new DonateModel();
+    $model->btc_address = Common::$config->bnetdocs->btc_donate_address;
+
+    $view->render($model);
+
+    $model->_responseCode = 200;
+    $model->_responseHeaders["Content-Type"] = $view->getMimeType();
+    $model->_responseTTL = 0;
+
+    return $model;
+
+  }
+
+}

src/main.php

@@ -122,6 +122,9 @@ function main() {
     $router->addRoute( // URL: /document/search
       "#^/document/search/?$#", "Document\\Search", "Document\\SearchHtml"
     );
+    $router->addRoute( // URL: /donate
+      "#^/donate/?$#", "Donate", "DonateHtml"
+    );
     $router->addRoute( // URL: /eventlog/index
       "#^/eventlog/index/?$#", "EventLog\\Index", "EventLog\\IndexHtml"
     );

src/models/Donate.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace BNETDocs\Models;
+
+use \CarlBennett\MVC\Libraries\Model;
+
+class Donate extends Model {
+
+  public $btc_address;
+
+}

src/templates/Donate.phtml

@@ -0,0 +1,33 @@
+<?php
+
+namespace BNETDocs\Templates;
+
+use \CarlBennett\MVC\Libraries\Common;
+use \CarlBennett\MVC\Libraries\Pair;
+
+$title       = "Donate";
+$description = "Donate to BNETDocs to show your support for this project!";
+
+$this->opengraph->attach(new Pair("url", "/donate"));
+$this->opengraph->attach(new Pair("type", "article"));
+
+require("./header.inc.phtml");
+?>
+      <article>
+        <header>Disclaimer</header>
+        <section>
+          <p>By donating to BNETDocs, you understand the following:</p>
+          <p><ol>
+            <li>The donation is non-refundable.</li>
+            <li>The donation's purpose is to pay for hosting of this website and all associated costs, and to further the development of open-source software (OSS).</li>
+            <li>A donation is not acceptable as payment for goods, products, or merchant items.</li>
+            <li>In absolutely no scenario will a donation be used to willfully violate Blizzard Entertainment's Terms of Service or Battle.net&trade;'s Terms of Service.</li>
+          </ol></p>
+          <p>Please see our <a href="<?php echo Common::relativeUrlToAbsolute("/legal"); ?>">Legal Policies</a> for more info.</p>
+        </section>
+        <header>Bitcoin (BTC)</header>
+        <section>
+          <p>Please send your donation to: <code><?php echo $this->getContext()->btc_address; ?></code></p>
+        </section>
+      </article>
+<?php require("./footer.inc.phtml"); ?>

src/templates/Legal.phtml

@@ -55,7 +55,12 @@ require("./header.inc.phtml");
             </li>
             <li>BNETDocs reserves the right to modify this legal page at its own discretion with or without notification to its users.</li>
             <li>BNETDocs news posts are considered press articles and all content used within a news post or otherwise news article are considered governed under the United States first amendment and fair use rights.</li>
-            <li>All questions and concerns related to material on this website or other matter should be communicated to <a href="mailto:staff@bnetdocs.org?subject=Legal%20Matter%20Attn.:%20BNETDocs">staff@bnetdocs.org</a>. Responses to this communication medium are not guaranteed.</li>
+            <li>A "Donation" as defined further in this document is a transaction of sending currency to BNETDocs.</p>
+            <li>Donations to BNETDocs are non-refundable and non-transferrable.</li>
+            <li>Donation's purpose is to pay for hosting of this website and all associated costs, and to further the development of open-source software (OSS).</li>
+            <li>Donations are not acceptable as payment for goods, products, or merchant items.</li>
+            <li>In absolutely no scenario will a donation be used to willfully violate Blizzard Entertainment's Terms of Service or Battle.net&trade;'s Terms of Service.</li>
+            <li>All questions and concerns related to material on this website or other matter should be communicated to <a href="mailto:staff@bnetdocs.org?subject=Legal%20Matter%20Attn.:%20BNETDocs">staff@bnetdocs.org</a>. Responses to this communication medium are not guaranteed due to the volume of emails that may be received.</li>
           </ol>
         </section>
       </article>

src/templates/header.inc.phtml

@@ -74,6 +74,7 @@ if (isset($_SESSION['user_id'])) {
       <a href="<?php echo Common::relativeUrlToAbsolute("/credits"); ?>">Contributors</a>
       <a href="<?php echo Common::relativeUrlToAbsolute("/servers"); ?>">Server List</a>
       <a href="<?php echo Common::relativeUrlToAbsolute("/legal"); ?>">Legal Policies</a>
+      <a href="<?php echo Common::relativeUrlToAbsolute("/donate"); ?>">Donate</a>
       <a href="<?php echo Common::relativeUrlToAbsolute("//redux.bnetdocs.org/"); ?>">BNETDocs Redux</a>
       <a>Account Management</a>
 <?php if ($_header_user) { ?>

src/views/DonateHtml.php

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