madtechservices / theme-madmin
MADmin - 基于 Tailwind CSS 的 Backpack v6 UI。
Requires
- backpack/crud: ^6.2.1
Requires (Dev)
- orchestra/testbench: ~5|~6
- phpunit/phpunit: ~9.0
This package is auto-updated.
Last update: 2024-09-18 17:14:02 UTC
README
本软件包为 Backpack for Laravel 管理面板提供主题,使用 Tailwind CSS v3。MADmin 通过注释和文档良好的 CSS 文件易于定制,如果不满意可以轻松编辑。Backpack 的 MADmin 设置软件包允许您从 Backpack 管理面板轻松定制 MADmin。MADmin 主题的前端版本即将推出,并将与 Laravel Jetstream 集成。
截图
安装
自动安装
目前不可用。
手动安装
步骤 1. 使用 Composer 安装
composer require madtechservices/theme-madmin
步骤 2. 前往 config/backpack/ui.php
并更改视图命名空间
- 'view_namespace' => 'backpack::', + 'view_namespace' => 'backpack.theme-madmin::',
步骤 3. (可选) 发布主题配置文件
php artisan vendor:publish --tag="theme-madmin-config"
配置
注意:此处设置的任何值将覆盖在主题使用时在 config/backpack/ui.php 中定义的值。
更改布局:只需选择一个布局
/** * Possible values: horizontal, horizontal_dark, vertical, vertical_dark, horizontal_custom, vertical_custom * Note: horizontal_custom and vertical_custom need to be used with madmin-settings package for backpack which * makes the theme configurable in your backpack admin panel. */ 'layout' => 'horizontal_custom',
更改认证布局:选择登录页面布局
'auth_layout' => 'default', //Possible values: default, illustration, cover, clean, video
添加 CSS:在此处您可以轻松加载自己的额外 CSS 样式。
'styles' => [ base_path('vendor/backpack/theme-madmin/resources/assets/css/color-adjustments.css'), base_path('vendor/backpack/theme-madmin/resources/assets/css/colors.css'), // add your css here ],
添加 JS:在此处您可以轻松包含自己的 JS 文件。
'scripts' => [],
更多配置:充分利用 theme-madmin。
致谢
php artisan backpack:require:theme-madmin
更多配置:通过使用 madmin-settings 软件包,充分利用 theme-madmin。访问 madmin-settings 软件包仓库 https://github.com/madtechservices/madmin-settings
- 配置主题默认值,如
浅色模式、深色模式或系统
- 从 backpack 管理面板添加标志
- 为流行的 backpack 软件包添加自定义布局,如 backpack-permissions、backpack-backup、backpack-filemanager 等。
- 与 Laravel 软件包集成,如 Jetstream、Breeze、Telescope、Debugbar 等。
- 轻松自定义主题颜色。
- 选择主题的字体
- 选择
头部
、侧边栏
应如何显示 - 添加自定义页脚文本并修改其他占位符文本
- 通过在 madmin-settings 软件包中启用或禁用功能,通过 Backpack 管理面板启用或禁用功能,将更多功能添加到您的 backpack 管理面板。
专业版
- 移除页脚中的“由...提供”链接。
- 添加您自己的自定义页脚文本。
- 将您自己的自定义标志添加到登录页面。
- 将您自己的自定义标志添加到管理面板。
- 添加您自己的自定义 favicon。
- 添加您自己的自定义字体。
- 添加您自己的自定义 CSS。
- 添加您自己的自定义 JS。
- 添加您自己的自定义预加载器。
- 添加您自己的自定义登录页面背景。
- 添加您自己的自定义登录页面背景视频。
- 添加您自己的自定义登录页面背景图像。
- 添加您自己的自定义登录页面背景颜色。
- 添加您自己的自定义登录页面背景渐变。
- 添加您自己的自定义登录页面背景图案。
- 添加您自己的自定义登录页面背景图像透明度。
- 添加您自定义的登录页面背景视频不透明度。
- 添加您自定义的登录页面背景图案不透明度。
- 添加您自定义的登录页面背景渐变不透明度。
- 添加您自定义的登录页面背景视频静音。
- 添加您自定义的登录页面背景视频循环。
- 添加您自定义的登录页面背景视频自动播放。
- 添加您自定义的登录页面背景视频控件。
- 添加您自定义的登录页面背景视频开始时间。
- 添加您自定义的登录页面背景视频结束时间。
- 添加您自定义的登录页面背景视频速度。
- 添加您自定义的登录页面背景视频质量。
- 添加您自定义的登录页面背景视频播放速度。
- 添加您自定义的登录页面背景视频播放质量。
- 添加您自定义的登录页面背景视频播放静音。
- 添加您自定义的登录页面背景视频播放循环。
- 添加您自定义的登录页面背景视频播放自动播放。
- 添加您自定义的登录页面背景视频播放控件。
- 添加您自定义的登录页面背景视频播放开始时间。
- 添加您自定义的登录页面背景视频播放结束时间。
- 添加您自定义的登录页面背景视频播放速度。
- 添加您自定义的登录页面背景视频播放质量。
- 添加您自定义的登录页面背景视频播放播放速度。
- 添加您自定义的登录页面背景视频播放播放质量。
- 添加您自定义的登录页面背景视频播放播放静音。
- 添加您自定义的登录页面背景视频播放播放循环。
- 添加您自定义的登录页面背景视频播放播放自动播放。
- 添加您自定义的登录页面背景视频播放播放控件。
- 添加您自定义的登录页面背景视频播放播放开始时间。
- 添加您自定义的登录页面背景视频播放播放结束
- 购买PRO版本以获取完整的白标选项并移除“由...提供”链接。
'options' => [ /** * The available color modes. */ 'colorModes' => [ 'system' => 'la-desktop', 'light' => 'la-sun', 'dark' => 'la-moon', ], /** * The color mode used by default. */ 'defaultColorMode' => 'system', // system, light, dark /** * When true, a switch is displayed to let admins choose their favorite theme mode. * When false, the theme will only use the "defaultColorMode" set above. * In case "defaultColorMode" is null, system is the default. */ 'showColorModeSwitcher' => true, /** * Fix the top-header component (present in "vertical_transparent") and the menu when the layout type is set as "horizontal". * This value is skipped when the layout type is horizontal-overlap, using false as default. */ 'useStickyHeader' => true, /** * When true, the content area will take the whole screen width. */ 'useFluidContainers' => true, /** * When true, the sidebar content for vertical layouts will not scroll with the rest of the content. */ 'sidebarFixed' => false, /** * When true, horizontal layouts will display the classic top bar on top to free some space when multiple nav items are used. */ 'doubleTopBarInHorizontalLayouts' => false, ],
卸载
要卸载此Backpack主题
- 移除composer包。例如:
composer remove backpack/theme-madmin
- 删除配置文件。例如:
rm -rf config/backpack/theme-madmin.php
- 安装新的主题(例如:
php artisan backpack:require:theme-tabler
)或更改config/backpack/ui.php
中的view_namespace
为要激活的主题。例如:theme-tabler。
用法
此包由Backpack 6.0使用,因此您不需要做任何特殊操作来使用它。只需确保已安装,在config/backupack/ui.php
中将它设置为您的主题,它将自动使用。
自定义
要自定义此主题,您可以发布配置文件
php artisan vendor:publish --provider="Madtechservices\ThemeMadmin\ThemeMadminServiceProvider" --tag=config
这将发布配置文件到config/backpack/theme-madmin.php
。您可以按需修改它。
或者,您可以安装madmin-settings包以允许您从Backpack管理面板自定义主题。访问madmin-settings包仓库:https://github.com/madtechservices/madmin-settings。
覆盖
如果您需要以任何方式更改blade文件,您可以轻松地将文件复制粘贴到您的应用程序中,并按需修改该文件。如果您将其复制粘贴到正确的目录中,则您的文件将替代包中的文件。但请记住,您将不会为此文件获得任何更新。
您复制的文件越多,自定义的越多,升级到新版本将越困难。因此,请尽量减少这样做。
# create the custom directory if it's not already there # mkdir -p resources/views/vendor/backpack/theme-madmin mkdir -p resources/views/vendor/madtechservices/theme-madmin # copy the blade file inside the folder we created above #cp -i vendor/backpack/theme-madmin/resources/views/dashboard.blade.php resources/views/vendor/backpack/theme-madmin/dashboard.blade.php cp -i vendor/madtechservices/theme-madmin/resources/views/dashboard.blade.php resources/views/vendor/madtechservices/theme-madmin/dashboard.blade.php
变更日志
变更记录在此GitHub上。请参阅发布选项卡。
贡献
请参阅contributing.md以获取待办事项列表和操作指南。
安全
如果您发现任何与安全相关的问题,请通过电子邮件support@madtechservices.com.au联系,而不是使用问题跟踪器。
致谢
许可协议
本项目遵循MIT协议发布,因此您可以在任何Backpack & Laravel项目之上安装它。请参阅许可文件以获取更多信息。