intentor/laravel-theme

为 Laravel 5 的简单主题管理器。

v1.2 2015-08-27 19:18 UTC

This package is not auto-updated.

Last update: 2024-09-28 17:49:10 UTC


README

为 Laravel 5 的简单主题管理器

当前项目已停止维护。不过,您可以随意将其分支出来继续开发!

内容

  1. 介绍
  2. 安装
  3. 快速开始
  4. 最佳实践
  5. 限制
  6. 更新日志
  7. 支持
  8. 许可证

介绍

Laravel 主题 提供了一种简单的方式来管理 Laravel 应用程序上的主题。

与 Laravel 5 兼容。

安装

Laravel 5.0

在您的 Laravel 安装中的 composer.json 文件中,添加以下 require 行

{
    "require": {
        "intentor/laravel-theme": "~1.0"
    }
}

运行 composer update 以将包添加到您的 Laravel 应用程序。

config/app.php 中,添加服务提供者和外观

    'providers' => [
		'Intentor\LaravelTheme\ServiceProvider',
    ]

	//...

    'aliases' => [
        'Form' => 'Intentor\LaravelTheme\Facade',
    ]

Laravel 5.1+

在您的 Laravel 安装中的 composer.json 文件中,添加以下 require 行

{
    "require": {
        "intentor/laravel-theme": "~1.0"
    }
}

运行 composer update 以将包添加到您的 Laravel 应用程序。

config/app.php 中,添加服务提供者和外观

    'providers' => [
        Intentor\LaravelTheme\ServiceProvider::class,
    ]

    //...

    'aliases' => [
        'Form' => Intentor\LaravelTheme\Facade::class,
    ]

快速开始

创建主题

要创建主题,首先在应用程序的 resources 文件夹中添加一个 themes 文件夹。

themes 文件夹内,您创建的任何文件夹都将代表一个主题。对于每个主题文件夹,添加一个 views 文件夹,在其中创建该特定主题的所有视图。

文件夹结构将如下所示

resources
└── themes
    ├── [theme folder]
    |   └── views
    |
    └── [another theme folder]
        └── views

设置主题

要设置主题,在任何想要更改主题的地方调用 Theme::set('theme_name')

注意:主题的名称是位于 resources/themes 文件夹中的代表主题的文件夹的名称。

显示视图

要显示视图,只需调用 view('view_name') 而不指定任何与主题相关的引用。

添加资产

要将资产添加到页面,只需将它们包含在指向其位于 public 文件夹中的位置的链接中。

最佳实践

1. 在 public 文件夹的特定文件夹中添加主题的任何资产(图像、CSS、JS 等)。

2. 如果您正在使用任务管理器(如 GulpGrunt),则建议在主题中的 assets 文件夹中添加资产,然后将文件移动到公共位置。

resources
└── themes
    ├── [theme folder]
    |   ├── css/sass/less
    |   ├── img
    |   ├── js
    |   └── views
    |
    └── [another theme folder]
        ├── css/sass/less
        ├── img
        ├── js
        └── views

3. 在 resources/views 文件夹中创建共享视图。

4. 主题中的视图始终覆盖共享视图。

限制

  1. 鉴于主题的视图位于 public 文件夹之外,资产管理可能会有些笨拙。

更新日志

请参阅 CHANGELOG.md

支持

发现错误?请在该 GitHub 项目页面 上创建一个问题或如果您有修复或扩展,请发送拉取请求。

您也可以通过 support@intentor.com.br 发送消息,讨论有关组件的更复杂问题。

许可证

本产品遵循MIT许可证(MIT)。有关更多信息,请参阅LICENSE