momentumstudio / laravel-theme
允许开发者将视图拆分为多个可切换的主题。
0.2.0
2020-09-10 14:56 UTC
Requires
- php: ^7.2.0
- laravel/framework: ^5.5.0|^6|^7|^8
Requires (Dev)
- momentumstudio/coding-standards: 1.4.5
- orchestra/testbench: ^3.5.0|^4.0.0|^5.0.0|^6.0.0
- phpstan/phpstan: 0.12.42
- phpstan/phpstan-strict-rules: 0.12.5
README
Laravel 主题
此项目受MIT许可。
Momentum Studio的Laravel Theme是一个允许开发者在运行时切换模板集的包。允许用户设置自己的主题,或者简单地尝试将新主题提供给少数用户。
- 将您的主题路径添加到Laravel的默认
ViewFinder
,确保它能够支持其他主题相关包。 - 使用简单的Facade来设置您的当前主题。
- 可以通过环境变量或您自己的配置文件覆盖配置。
安装和用法
需求
- PHP 7.2+
- Laravel 5.5+
使用Composer将Laravel Theme作为依赖项安装到您的Laravel项目中
composer require momentumstudio/laravel-theme
该包将自动注册自己。您可以使用以下命令发布配置文件:
php artisan vendor:publish --provider="MomentumStudio\LaravelTheme\LaravelThemeServiceProvider"
或者,您可以直接在您的.env
文件中设置环境变量
DEFAULT_THEME=default
THEMES_PATH=themes
这是默认配置文件的内容
return [
/**
* Set default theme to be chosen on startup
* Set to `null` to use default views (resources/views)
*/
'default' => env('DEFAULT_THEME', null),
/**
* Set the base directory to find themes
*/
'path' => env('THEMES_PATH', base_path('themes')),
];
您可以将default
设置为null
,以继续使用resources/views
,直到在运行时设置其他设置。 适用于将此包导入现有项目。
然后,要在运行时设置主题,请调用提供的Facade的set
方法
\MomentumStudio\LaravelTheme\Facades\Theme::set('directory-name');
这将搜索您的主题路径,查找与名称匹配的模板,当调用Laravel的view()
(或等效方法)时。
例如,将我的主题设置为mytheme
并调用view('my-view')
将首先搜索themes/mytheme/my-view.blade.php
,然后再回退到resources/views/my-view.blade.php
。
贡献
请参阅CONTRIBUTING.md以获取有关如何帮助的详细信息!