madtechservices/theme-madmin

MADmin - 基于 Tailwind CSS 的 Backpack v6 UI。

安装: 9

依赖: 0

建议者: 0

安全: 0

星级: 1

关注者: 1

分支: 0

开放问题: 1

语言:JavaScript

v0.0.23 2024-01-18 06:42 UTC

This package is auto-updated.

Last update: 2024-09-18 17:14:02 UTC


README

Latest Version on Packagist Total Downloads The Whole Fruit Manifesto

本软件包为 Backpack for Laravel 管理面板提供主题,使用 Tailwind CSS v3。MADmin 通过注释和文档良好的 CSS 文件易于定制,如果不满意可以轻松编辑。Backpack 的 MADmin 设置软件包允许您从 Backpack 管理面板轻松定制 MADmin。MADmin 主题的前端版本即将推出,并将与 Laravel Jetstream 集成。

截图

在此处添加 MADmin 的图像... all-layouts

安装

自动安装

目前不可用。

手动安装

步骤 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主题

  1. 移除composer包。例如:composer remove backpack/theme-madmin
  2. 删除配置文件。例如:rm -rf config/backpack/theme-madmin.php
  3. 安装新的主题(例如: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项目之上安装它。请参阅许可文件以获取更多信息。