Custom assets path.

Added the ability to specify a custom assets path to the instantiated Web
object.

Author: Maikuolan

Changelog.md

@@ -9,3 +9,7 @@ __*Why "v3.0.0" instead of "v1.0.0?"*__ Prior to phpMussel v3, the "phpMussel Co
 [2020.07.31; Maikuolan]: Improved the way that the (generated by ...) notice, displayed at the footer of HTML pages, is rendered.
 
 [2020.10.09; Maikuolan]: Aesthetic patch + added a new theme.
+
+### v3.1.0
+
+[2020.10.30; New Feature; Maikuolan]: Added the ability to specify a custom assets path to the instantiated Web object.

src/Web.php

@@ -8,7 +8,7 @@
  * License: GNU/GPLv2
  * @see LICENSE.txt
  *
- * This file: Upload handler (last modified: 2020.07.31).
+ * This file: Upload handler (last modified: 2020.10.30).
  */
 
 namespace phpMussel\Web;
@@ -30,6 +30,11 @@ class Web
      */
     private $AssetsPath = __DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'assets' . DIRECTORY_SEPARATOR;
 
+    /**
+     * @var string A path for any custom front-end asset files.
+     */
+    public $CustomAssetsPath = '';
+
     /**
      * @var string The path to the upload handler's L10N files.
      */
@@ -49,6 +54,7 @@ class Web
      * Construct the loader.
      *
      * @param \phpMussel\Core\Loader $Loader The instantiated loader object, passed by reference.
+     * @param \phpMussel\Core\Scanner $Scanner The instantiated scanner object, passed by reference.
      */
     public function __construct(\phpMussel\Core\Loader &$Loader, \phpMussel\Core\Scanner &$Scanner)
     {
@@ -300,11 +306,20 @@ public function scan()
         }
 
         /** Determine which template file to use. */
-        if (is_readable($this->AssetsPath . 'template_' . $this->Loader->Configuration['web']['theme'] . '.html')) {
-            $TemplateFile = $this->AssetsPath . 'template_' . $this->Loader->Configuration['web']['theme'] . '.html';
-        } elseif (is_readable($this->AssetsPath . 'template_default.html')) {
-            $TemplateFile = $this->AssetsPath . 'template_default.html';
+        if ($this->CustomAssetsPath) {
+            if (is_readable($this->CustomAssetsPath . 'template_' . $this->Loader->Configuration['web']['theme'] . '.html')) {
+                $TemplateFile = $this->CustomAssetsPath . 'template_' . $this->Loader->Configuration['web']['theme'] . '.html';
+            } elseif (is_readable($this->CustomAssetsPath . 'template_default.html')) {
+                $TemplateFile = $this->CustomAssetsPath . 'template_default.html';
+            }
         } else {
+            if (is_readable($this->AssetsPath . 'template_' . $this->Loader->Configuration['web']['theme'] . '.html')) {
+                $TemplateFile = $this->AssetsPath . 'template_' . $this->Loader->Configuration['web']['theme'] . '.html';
+            } elseif (is_readable($this->AssetsPath . 'template_default.html')) {
+                $TemplateFile = $this->AssetsPath . 'template_default.html';
+            }
+        }
+        if (empty($TemplateFile)) {
             $TemplateFile = '';
         }