kfoobar / laravel-theme
Laravel主题支持
v1.0.0
2023-12-22 12:52 UTC
Requires
- php: ^8
- ext-json: *
- illuminate/config: ^8.0||^9.0||^10.0
- illuminate/database: ^8.0||^9.0||^10.0
- illuminate/support: ^8.0||^9.0||^10.0
README
轻量级Laravel 8/9/10包,添加简单主题支持。
安装
您可以使用Composer安装此包。
composer require kfoobar/laravel-theme
包将自动注册自己。
发布配置文件(可选)
运行以下命令发布配置文件:
php artisan vendor:publish --tag theme-config
添加默认文件夹(可选)
包将自动从 config/themes/*
加载配置文件和视图文件 resources/views/themes/*
。要创建这些文件夹,请运行以下命令:
php artisan theme:install
它是如何工作的?
该包帮助您根据您设置的主题加载配置文件和显示视图文件。
您可以在 .env
文件中设置您想使用的主题
APP_THEME=light
配置文件
该包可以帮助您管理主题的多个配置文件。根据您设置的主题,设置将自动合并到 config/theme.php
文件中。
在后台,该包将加载 config/themes/light.php
并合并到 config/theme.php
。这使您能够使用相同的配置键,无论您设置了什么主题
config('theme.logo')
视图文件
通过在控制器中使用 theme()
代替 view()
,该包还可以帮助您根据您设置的主题加载正确的视图文件。
public function index() { return theme('index'); }
当使用 theme()
函数时,该包将尝试从以下路径和顺序加载视图文件:
/resources/views/themes/light/index.blade.php
/resources/views/theme/default/index.blade.php
/resources/views/index.blade.php
与Tailwind CSS一起使用
该包本身不支持Tailwind CSS,但我们推荐使用此包
npm install -D tw-colors
完整的文档可以在以下链接找到:https://github.com/L-Blondy/tw-colors
贡献
欢迎贡献!
许可
MIT许可(MIT)。有关更多信息,请参阅许可文件。