kaistaerk/adminlte-bundle

基于AdminLTE 2.4的Symfony 4+管理主题包,支持FOSUserBundle

安装: 3

依赖: 0

建议: 0

安全: 0

星星: 0

观察者: 0

分支: 71

类型:symfony-bundle

dev-master 2024-01-06 10:42 UTC

This package is auto-updated.

Last update: 2024-09-06 12:21:41 UTC


README

此包已不再维护

使用的AdminLTE版本过旧。支持的Symfony和PHP版本都已到EOL。

问题、错误请求甚至拉取请求都不会得到回答或合并。

如果您正在寻找现代替代品,请查看Tabler包: https://github.com/kevinpapst/TablerBundle

Latest Stable Version Total Downloads License

AdminLTE Bundle for Symfony

此仓库包含AvanzuAdminThemeBundle的升级版本,将AdminLTE主题引入到Symfony 4。

简介

最低要求

  • Symfony 4.3
  • PHP > 7.2
  • Twig 2.0

兼容性

3.x版本应与Symfony 5和PHP 8兼容,请留下您的反馈

  • 3.x版本仅与Symfony >= 4.3兼容
  • 此包的2.x版本与Symfony < 4.3兼容

功能

此主题包的一些主要功能

  • 两个主要布局:主应用和安全(登录、忘记密码、注册账户等)
  • 支持Symfony 4.x
  • 支持KNPMenuBundle
  • 支持FOSUserBundle
  • 支持Webpack-Encore构建资源
  • 通过事件驱动处理菜单项、任务和通知
  • 支持以下语言翻译:英语、德语、意大利语、捷克语、西班牙语、俄语、阿拉伯语、芬兰语、日语、瑞典语、葡萄牙语(巴西)、荷兰语、法语、土耳其语、丹麦语、中文、斯洛伐克语、巴斯克语、波兰语、世界语、希伯来语、罗马尼亚语(请帮助将其翻译成更多语言)
  • 基于AdminLTE 2.4.8
  • 使用FontAwesome 5

使用Symfony Flex安装

使用Symfony flex进行安装

composer config extra.symfony.allow-contrib true
composer req "kevinpapst/adminlte-bundle:^3.0"

使用Composer安装

使用“传统”composer方法进行安装

   composer require kevinpapst/adminlte-bundle ^3.0

之后,将默认配置复制到您的 config/packages/ 目录

cp vendor/kevinpapst/adminlte-bundle/config/packages/admin_lte.yaml config/packages/

然后,将包添加到项目中 config/bundles.php 文件中注册的包列表中,以启用该包

<?php

return [
    // ...
    KevinPapst\AdminLTEBundle\AdminLTEBundle::class => ['all' => true],
];

AdminLTEBundle与AvanzuAdminThemeBundle的区别

首先,原始仓库考虑了强大的向后兼容性,只有当保持Symfony 2和3的兼容性时才会进行维护(例如,这里)。

这意味着您不会获得SF4的新特性。由于我在使用webpack-encore的Symfony 4项目中工作,因此我需要一个解决方案。

最初,我尝试向原始存储库发送PR,但那些并不总是被接受例如,这里。因为我非常需要升级版本,我在分叉中管理了一个分支几周,但这并不顺利,我发现自己在我的项目中不断覆盖越来越多的内容,直到我不得不在以下选项之间做出选择

  1. 在我的项目中做所有更改
  2. 在我的分叉存储库中进行更改,并在composer.json中添加“dev-”条目
  3. 清理分叉,将其与我的项目更改合并并发布给社区

对我来说,选择 3 是简单明了的:我现在在这个存储库中以全新的开始进行工作,并有机会打破向后兼容性(对于从AdminThemeBundle迁移的用户)。

主要区别

这个存储库是从原始master创建的,但在此基础上增加了许多增强功能

  • 命令自动发现(参见 #215
  • Symfony4兼容性(参见 #215
  • 动态配置选项(参见 #217
  • 升级到AdminLTE 2.4.8
  • 添加了对 FOSUserBundle 的支持
  • 添加了Symfony Flex配方以简化集成
  • 使用Webpack-Encore编译前端资源
  • 修复了KNPMenu集成
  • 用更简单的版本替换了AliasRouting
  • 更改命名空间以允许与AdminThemeBundle共存以便迁移
  • 更改并扩展了默认配置
  • 对代码库进行了大量清理
  • 更改了所有twig块名称(并添加了额外的布局shim文件以方便迁移)
  • 更改了控制侧边栏,现在可以从admin_lte.yaml或ContextHelper配置内容
  • 一个 演示应用程序,作为新用户的活页文档和更简单的测试
  • 更新composer.json以反映更新的bundle依赖关系
  • 引入了单元测试、phpstan和代码风格规则(所有通过Travis检查)

从AvanzuAdminTheme迁移

请注意:我决定更改一些项目内部结构并移除了原始AdminThemeBundle中的一些功能。我发现一站式解决方案在多个地方更成问题而不是有帮助,因此我抓住了机会将其更新到我自己的主题bundle理解。

如果你之前使用了AvanzuAdminTheme,你将无法“仅替换”composer包。提前规划,你可能需要(根据项目大小)几个小时进行迁移

我自己的项目迁移大约需要4个小时,但我不得不同时将大量定制移动到bundle中(例如,webpack-encore构建)。请参阅PR#202#206以获取迁移示例。

许可和贡献者

在MIT许可下发布,请阅读LICENSE文件以获取更多信息。

此存储库基于AdminThemeBundle的工作,请查看他们的贡献者列表,并给予他们星标!