README

手工制作的、多皮肤的、响应式且易于定制的 PyroCMS 3 管理员主题，旨在提供更精细、直观的用户体验。这是一项绝对的心血来潮，旨在实现风格和布局的终极控制。欢迎来到构建 PyroCMS 3 管理员主题的新方式。

简介

这个项目的想法是构建一个可扩展和模块化的管理员主题，具有各种风格组件和布局框架，以实现深度定制和最大程度的代码复用。在编写这个主题的每一行代码或样式时，都仔细地放置以执行功能或提高桌面和移动设备上的整体用户体验。

该主题允许通过皮肤的概念，以更轻量级的方式来定制核心样式，以适应不同的需求。这个项目希望构建一个管理员 UI 风格和布局的目录，社区可以使用和分享。

查看皮肤部分，了解更多关于其工作原理和可用的定制选项。

特性

易于定制和风格化
附带6 种皮肤
支持官方PyroCMS 主题
允许对导航菜单（侧边栏）中的模块进行排序和排除
支持不同的布局（例如，带/不带顶部导航栏）
附带新的登录页面

安装

1- 使用 composer 按以下方式安装主题：

composer require websemantics/pyrocms-theme

2- 安装所有可用的皮肤

composer update

3- 将项目 .env 文件中的 ADMIN_THEME 的值更改

ADMIN_THEME=websemantics.theme.pyrocms

皮肤

该主题的设计是为了通过引入一个新概念，即皮肤，以最少的努力让开发者能够极大地改变样式、布局和用户体验。

皮肤是一种轻量级的方法，可以重新设计和定制默认主题样式以适应您的需求。以下展示的默认主题皮肤，Plus Skin，具有侧边栏，这是该主题提供的许多布局选项之一。

定制可以从更改主题变量到添加额外的样式，或覆盖主题视图。

可用的皮肤

如您所见，该主题附带了许多皮肤；这些皮肤都作为单独的附加包提供，您可以单独要求或通过此主题要求。

官方皮肤

在享受本主题提供的许多皮肤的同时，您仍然可以返回官方 PyroCMS 3 管理员主题，而无需实际切换主题。该项目决定在官方 PyroCMS 主题的基础上进行构建，以保持主题简洁并保证所有 PyroCMS 官方管理员主题默认样式都得到支持。它实际上还更进一步，添加了一些功能来增强外观和用户体验，如下所述：

支持使用 SVG 图片的视网膜显示屏品牌标志
为模块 push 菜单提供了动画增强用户体验（缓慢打开/关闭）
支持图像选择，一种使用select字段类型（单选模式）展示图片的方式
全新的登录页面，带有动画logo

更改活动皮肤

要更改当前活动皮肤，请转到设置然后主题或点击页脚中的主题设置按钮。将展示一个包含预览图片的可用皮肤列表。选择您喜欢的皮肤并点击保存，搞定！

您还可以在项目的.env文件中将PYROCMS_SKIN的值设置为皮肤命名空间，

PYROCMS_SKIN=websemantics.skin.github

如何创建皮肤

假设您想创建一个名为sunshine的新皮肤。简单来说，只需遵循以下步骤，

创建一个新的皮肤插件（需要Builder扩展），

php artisan make:addon vendor.skin.sunshine

从皮肤配置文件中更改皮肤设置，sunshine-skin/resources/config/skin.php。
按照更改活动皮肤部分所述切换到新皮肤。

嵌入式皮肤

皮肤的好处在于，它们不必是自己的插件包。皮肤也可以在包括扩展和模块在内的任何插件类型中指定。

主题找到并使用皮肤所需要的一切是，

皮肤主配置文件addon/resources/config/skin.php，
一个预览图片addon/resources/img/name.png，
皮肤主样式文件，addon/resources/scss/skin.scss。

有关详细信息，请查看Plus Skin。

控制布局

此主题包含一些非常强大的功能，旨在使用sass和主题配置变量来更改皮肤布局，

显示导航栏

在构建皮肤时，您可以决定是否想要导航栏。启用或禁用此功能将显示带有附加切换按钮的导航栏，用于显示或隐藏侧边栏和经典菜单以及其他导航栏项。此外，一些侧边栏链接将被移除，例如由导航栏提供的查看网站、注销等，

侧边栏

此主题允许对侧边栏中的模块进行排序和排除。您可以通过sidebar配置变量在resources/config/config.php中对侧边栏中的模块进行排序。只需在sort数组中列出模块的别名即可，例如，

  'sidebar' => [
    'sort' => [
      'anomaly.module.posts',
      'anomaly.module.pages'
    ]
  ]

这将按默认控制面板导航行为将文章模块显示在侧边栏列表的顶部，然后是页面模块。其余模块将按默认行为列出。

对于排除，请在exclude配置变量中列出所有不希望显示的模块。以下是一个示例，

  'sidebar' => [
    'exclude' => [
      'anomaly.module.addons',
      'anomaly.module.variables'
    ]
  ]

请随意混合使用exclude和sort以实现所需的外观。

切换按钮

主题使用两种类型的切换按钮来折叠侧边栏。默认按钮使用toggle CSS类，并默认使用。一个具有动画效果更复杂的按钮使用hip-toggle类。请查看pyrocms-theme/resources/scss/theme/components/_toggle.scss中的样式。

有关如何使用Hip Toggle按钮与您的皮肤，请查看Github皮肤实现。更多文档即将到来。

灵感

主题的未来扩展，

支持

如果您觉得这个项目有用，请星标⭐此存储库以表示支持，或者只是因为很棒 :)

您还可以进行捐赠。

需要帮助或有问题？请在StackOverflow上发帖。

请不要在问题跟踪器中使用支持/问题。

贡献

本项目接受以下形式的贡献：反馈、错误报告，甚至更好的是拉取请求。

资源

Auto Pyro，PyroCMS 部署工具，旨在提升开发体验。
Template Template，默认构建器扩展模板，用于构建构建器扩展模板。
注册表，列出所有可用的构建器扩展模板。
Awesome PyroCMS，精心挑选的 PyroCMS 插件和资源列表。
PyroCMS Cheatsheet，列出 PyroCMS 3 的命令和功能。
PyroCMS，MVC PHP 内容管理系统，易于使用、主题化和开发。全球各地的个人和组织都在使用它。

websemantics / pyrocms-theme

维护者

详细信息