kaistaerk / adminlte-bundle
基于AdminLTE 2.4的Symfony 4+管理主题包,支持FOSUserBundle
资助包维护!
kevinpapst
paypal.me/kevinpapst
Requires
- php: >=7.1.3
- symfony/asset: >4.3
- symfony/config: >4.3
- symfony/dependency-injection: >4.3
- symfony/event-dispatcher: >4.3
- symfony/http-foundation: >4.3
- symfony/http-kernel: >4.3
- symfony/options-resolver: >4.3
- symfony/security-core: >4.3
- symfony/translation: >4.3
- symfony/twig-bridge: >4.3
- twig/twig: >2.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.10
- knplabs/knp-menu-bundle: ^2.2
- phpspec/prophecy: ^1.6
- phpstan/phpstan: ^0.12
- phpstan/phpstan-phpunit: ^0.12
- phpunit/phpunit: ^7.3
- symfony/framework-bundle: >4.3
Suggests
- knplabs/knp-menu-bundle: Allows easy menu integration
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
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,但那些并不总是被接受例如,这里。因为我非常需要升级版本,我在分叉中管理了一个分支几周,但这并不顺利,我发现自己在我的项目中不断覆盖越来越多的内容,直到我不得不在以下选项之间做出选择
- 在我的项目中做所有更改
- 在我的分叉存储库中进行更改,并在composer.json中添加“dev-”条目
- 清理分叉,将其与我的项目更改合并并发布给社区
对我来说,选择 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的工作,请查看他们的贡献者列表,并给予他们星标!