Custom assets path.

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

Author: Maikuolan

Changelog.md

@@ -17,3 +17,5 @@ __*Why "v3.0.0" instead of "v1.0.0?"*__ Prior to phpMussel v3, the "phpMussel Co
 ### v3.1.0
 
 [2020.10.30; Maikuolan]: Redesigned the login pips and refactored some CSS.
+
+[2020.10.30; New Feature; Maikuolan]: Added the ability to specify a custom assets path to the instantiated FrontEnd object.

src/FrontEnd.php

@@ -8,7 +8,7 @@
  * License: GNU/GPLv2
  * @see LICENSE.txt
  *
- * This file: Front-end handler (last modified: 2020.10.26).
+ * This file: Front-end handler (last modified: 2020.10.30).
  */
 
 namespace phpMussel\FrontEnd;
@@ -36,6 +36,11 @@ class FrontEnd
      */
     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 front-end L10N files.
      */
@@ -131,6 +136,7 @@ class FrontEnd
      * 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)
     {
@@ -1680,7 +1686,7 @@ public function view(string $Page = '')
             );
 
             /** Initialise array for fetching logs data. */
-            $FE['LogFiles'] = ['Files' => $this->logsRecursiveList($this->AssetsPath), 'Out' => ''];
+            $FE['LogFiles'] = ['Files' => $this->logsRecursiveList(), 'Out' => ''];
 
             /** Text mode switch link base. */
             $FE['TextModeSwitchLink'] = '';
@@ -1848,6 +1854,14 @@ private function getAssetPath(string $Asset, bool $CanFail = false): string
             return '';
         }
 
+        /** Custom assets. */
+        if ($this->CustomAssetsPath) {
+            $Try = $this->Loader->buildPath($this->CustomAssetsPath . DIRECTORY_SEPARATOR . $Asset);
+            if (is_readable($Try)) {
+                return $Try;
+            }
+        }
+
         /** Non-default assets. */
         if (
             $this->Loader->Configuration['frontend']['theme'] !== 'default' &&