devdojo/themes

该包最新版本(0.0.11)没有可用的许可证信息。

这是一个为Laravel提供的主题包

0.0.11 2024-08-04 22:28 UTC

README

这是一个将主题支持添加到您的Laravel应用的包

添加主题

themes 包将在 resources/themes 文件夹中查找任何包含同名字符的 .json 文件夹。 (您可以在配置中更改主题文件夹的位置)

例如,如果您有一个名为 sample-theme 的文件夹,在该文件夹中还有一个名为 sample-theme.json 的文件,其内容如下

{
    "name": "Sample Theme",
    "version": "1.0"
}

该包将将其检测为新的主题。您还可以包含您主题的示例截图,这将是 sample-theme.jpg (800x500像素)以获得最佳效果

实际上,您可以在以下位置检查 sample-theme 仓库: https://github.com/thedevdojo/sample-theme

您可以通过将特定主题的 active 列设置为 1 来激活此主题。然后像这样使用它

return view('theme::welcome')

这将然后在当前活动主题文件夹中查找名为 welcome.blade.php 的新视图 :D

主题配置

您可以通过运行以下命令将配置发布到项目中:

php artisan vendor:publish

您将想要发布主题配置,您现在将在 config/themes.php 中看到一个新配置,其外观如下

<?php

return [

    'folder' => resource_path('themes'),
    'publish_assets' => true,
    'create_tables' => true

];

现在,您可以选择将主题文件夹放置在备用位置。默认情况下,它将放在 resources 文件夹中;但是,您可以将它更改为您喜欢的任何位置。

警告:如果您将主题文件夹添加到 resources/views 文件夹,并运行 php artisan optimize,您可能会收到错误,表明找不到某些组件。这是因为它将在视图文件夹中的所有 .blade.php 文件中搜索。因此,这可能不是放置主题的最佳位置。相反,此包将只注册活动主题的视图。

此外,您可以将 publish_assets 设置为 truefalse。如果设置为 true,则每次扫描主题目录时,它将发布主题中的 assets 文件夹到新的 themes 文件夹中的公共文件夹内。将其设置为 false,则不再发生此操作。