]> git.mxchange.org Git - friendica.git/blobdiff - src/Core/Theme.php
Merge pull request #13480 from Raroun/fix_13457
[friendica.git] / src / Core / Theme.php
index 6f0d9d43603a54e683ffbf7f3b6fb1b053069d19..2f78dad4b5ec1b47f02ad26193a424dec042f78c 100644 (file)
@@ -1,7 +1,22 @@
 <?php
-
 /**
- * @file src/Core/Theme.php
+ * @copyright Copyright (C) 2010-2023, the Friendica project
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
  */
 
 namespace Friendica\Core;
@@ -10,16 +25,14 @@ use Friendica\DI;
 use Friendica\Model\Profile;
 use Friendica\Util\Strings;
 
-require_once 'boot.php';
-
 /**
  * Some functions to handle themes
  */
 class Theme
 {
-       public static function getAllowedList()
+       public static function getAllowedList(): array
        {
-               $allowed_themes_str = Config::get('system', 'allowed_themes');
+               $allowed_themes_str = DI::config()->get('system', 'allowed_themes');
                $allowed_themes_raw = explode(',', str_replace(' ', '', $allowed_themes_str));
                $allowed_themes = [];
                if (count($allowed_themes_raw)) {
@@ -36,11 +49,11 @@ class Theme
 
        public static function setAllowedList(array $allowed_themes)
        {
-               Config::set('system', 'allowed_themes', implode(',', array_unique($allowed_themes)));
+               DI::config()->set('system', 'allowed_themes', implode(',', array_unique($allowed_themes)));
        }
 
        /**
-        * @brief Parse theme comment in search of theme infos.
+        * Parse theme comment in search of theme infos.
         *
         * like
         * \code
@@ -54,7 +67,7 @@ class Theme
         * @param string $theme the name of the theme
         * @return array
         */
-       public static function getInfo($theme)
+       public static function getInfo(string $theme): array
        {
                $theme = Strings::sanitizeFilePathItem($theme);
 
@@ -73,9 +86,9 @@ class Theme
                        return $info;
                }
 
-               $stamp1 = microtime(true);
+               DI::profiler()->startRecording('file');
                $theme_file = file_get_contents("view/theme/$theme/theme.php");
-               DI::profiler()->saveTimestamp($stamp1, "file", System::callstack());
+               DI::profiler()->stopRecording();
 
                $result = preg_match("|/\*.*\*/|msU", $theme_file, $matches);
 
@@ -83,7 +96,7 @@ class Theme
                        $comment_lines = explode("\n", $matches[0]);
                        foreach ($comment_lines as $comment_line) {
                                $comment_line = trim($comment_line, "\t\n\r */");
-                               if ($comment_line != "") {
+                               if (strpos($comment_line, ':') !== false) {
                                        list($key, $value) = array_map("trim", explode(":", $comment_line, 2));
                                        $key = strtolower($key);
                                        if ($key == "author") {
@@ -110,7 +123,7 @@ class Theme
        }
 
        /**
-        * @brief Returns the theme's screenshot.
+        * Returns the theme's screenshot.
         *
         * The screenshot is expected as view/theme/$theme/screenshot.[png|jpg].
         *
@@ -118,7 +131,7 @@ class Theme
         * @return string
         * @throws \Friendica\Network\HTTPException\InternalServerErrorException
         */
-       public static function getScreenshot($theme)
+       public static function getScreenshot(string $theme): string
        {
                $theme = Strings::sanitizeFilePathItem($theme);
 
@@ -131,7 +144,13 @@ class Theme
                return DI::baseUrl() . '/images/blank.png';
        }
 
-       public static function uninstall($theme)
+       /**
+        * Uninstalls given theme name
+        *
+        * @param string $theme Name of theme
+        * @return bool true on success
+        */
+       public static function uninstall(string $theme)
        {
                $theme = Strings::sanitizeFilePathItem($theme);
 
@@ -143,6 +162,8 @@ class Theme
                        if (function_exists($func)) {
                                $func();
                        }
+
+                       Hook::delete(['file' => "view/theme/$theme/theme.php"]);
                }
 
                $allowed_themes = Theme::getAllowedList();
@@ -150,10 +171,18 @@ class Theme
                if ($key !== false) {
                        unset($allowed_themes[$key]);
                        Theme::setAllowedList($allowed_themes);
+                       return true;
                }
+               return false;
        }
 
-       public static function install($theme)
+       /**
+        * Installs given theme name
+        *
+        * @param string $theme Name of theme
+        * @return bool true on success
+        */
+       public static function install(string $theme): bool
        {
                $theme = Strings::sanitizeFilePathItem($theme);
 
@@ -182,7 +211,7 @@ class Theme
        }
 
        /**
-        * @brief Get the full path to relevant theme files by filename
+        * Get the full path to relevant theme files by filename
         *
         * This function searches in order in the current theme directory, in the current theme parent directory, and lastly
         * in the base view/ folder.
@@ -191,13 +220,13 @@ class Theme
         * @return string Path to the file or empty string if the file isn't found
         * @throws \Exception
         */
-       public static function getPathForFile($file)
+       public static function getPathForFile(string $file): string
        {
                $a = DI::app();
 
                $theme = $a->getCurrentTheme();
 
-               $parent = Strings::sanitizeFilePathItem($a->theme_info['extends'] ?? $theme);
+               $parent = Strings::sanitizeFilePathItem($a->getThemeInfoValue('extends', $theme));
 
                $paths = [
                        "view/theme/$theme/$file",
@@ -215,15 +244,14 @@ class Theme
        }
 
        /**
-        * @brief Return relative path to theme stylesheet file
+        * Return relative path to theme stylesheet file
         *
         * Provide a sane default if nothing is chosen or the specified theme does not exist.
         *
         * @param string $theme Theme name
-        *
         * @return string
         */
-       public static function getStylesheetPath($theme)
+       public static function getStylesheetPath(string $theme): string
        {
                $theme = Strings::sanitizeFilePathItem($theme);
 
@@ -242,4 +270,78 @@ class Theme
 
                return 'view/theme/' . $theme . '/style.pcss' . (!empty($query_params) ? '?' . http_build_query($query_params) : '');
        }
+
+       /**
+        * Returns the path of the provided theme
+        *
+        * @param string $theme Theme name
+        * @return string|null
+        */
+       public static function getConfigFile(string $theme)
+       {
+               $theme = Strings::sanitizeFilePathItem($theme);
+
+               $a = DI::app();
+               $base_theme = $a->getThemeInfoValue('extends') ?? '';
+
+               if (file_exists("view/theme/$theme/config.php")) {
+                       return "view/theme/$theme/config.php";
+               }
+               if ($base_theme && file_exists("view/theme/$base_theme/config.php")) {
+                       return "view/theme/$base_theme/config.php";
+               }
+               return null;
+       }
+
+       /**
+        * Returns the background color of the provided theme if available.
+        *
+        * @param string   $theme Theme name
+        * @param int|null $uid   Current logged-in user id
+        * @return string|null
+        */
+       public static function getBackgroundColor(string $theme, int $uid = null)
+       {
+               $theme = Strings::sanitizeFilePathItem($theme);
+
+               $return = null;
+
+               // silently fail if theme was removed or if $theme is funky
+               if (file_exists("view/theme/$theme/theme.php")) {
+                       include_once "view/theme/$theme/theme.php";
+
+                       $func = "{$theme}_get_background_color";
+                       if (function_exists($func)) {
+                               $return = $func($uid);
+                       }
+               }
+
+               return $return;
+       }
+
+       /**
+        * Returns the theme color of the provided theme if available.
+        *
+        * @param string   $theme
+        * @param int|null $uid   Current logged-in user id
+        * @return string|null
+        */
+       public static function getThemeColor(string $theme, int $uid = null)
+       {
+               $theme = Strings::sanitizeFilePathItem($theme);
+
+               $return = null;
+
+               // silently fail if theme was removed or if $theme is funky
+               if (file_exists("view/theme/$theme/theme.php")) {
+                       include_once "view/theme/$theme/theme.php";
+
+                       $func = "{$theme}_get_theme_color";
+                       if (function_exists($func)) {
+                               $return = $func($uid);
+                       }
+               }
+
+               return $return;
+       }
 }