momentumstudio/laravel-theme

允许开发者将视图拆分为多个可切换的主题。

0.2.0 2020-09-10 14:56 UTC

This package is auto-updated.

Last update: 2024-09-22 22:44:26 UTC


README

Logo Image

Laravel 主题

此项目受MIT许可。

Momentum Studio的Laravel Theme是一个允许开发者在运行时切换模板集的包。允许用户设置自己的主题,或者简单地尝试将新主题提供给少数用户。

  • 将您的主题路径添加到Laravel的默认ViewFinder,确保它能够支持其他主题相关包。
  • 使用简单的Facade来设置您的当前主题。
  • 可以通过环境变量或您自己的配置文件覆盖配置。

安装和用法

需求

使用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以获取有关如何帮助的详细信息!