README

此模块旨在使在 Magento 2 管理界面中创建网格和表单变得愉快且快速。
它不使用任何 UI 组件。状态：

他们转过拐角，那里是 Eeyore 的房子，看起来非常舒适。
"你在那里，" 猪小妹说。
"内外都很棒，" Pooh 骄傲地说。
Eeyore 进去 ... 然后又出来了。
"这是一件了不起的事情，" 他说。 "这是我自己的房子，我建在我说的地方，所以风肯定把它吹到这里。风把它吹过那片树林，吹到这里，这里和以前一样好。事实上，有些地方更好。"
"好多了，" Pooh 和猪小妹一起说。
"这表明只要稍微努力一下就能做到什么，" Eeyore 说。 "你看，Pooh？你看，Piglet？先动脑筋，然后努力工作。看看它！这就是建房子的方法，" Eeyore 骄傲地说。

• 艾伦·亚历山大·米尔恩，"波尔的房子"

概述

Hyva_Admin 是一个 Magento 2 模块，提供了一种创建管理网格的新方法。
所有现有的网格和表单都不会受到影响。它们保持不变。
Hyva_Admin 存在是为了在创建新网格时改善开发者的体验。

将来，Hyva_Admin 也将支持创建表单（此 问题 跟踪进度）。

与前端 Hyvä-Themes 的关系

此模块不需要使用 Hyva-Theme 作为店面。它是一个独立的模块。它只与 Hyvä 前端主题共享三件事

• 开发应该是有趣的这种想法
• 框架应该支持开发者而不是创造不必要的额外工作
• 它在底层使用 tailwind css 和 alpinejs，但你可能在使用 Hyva_Admin 时甚至不会注意到

你可以安装此模块并享受它，而无需拥有 Hyvä-Themes 许可证。话虽如此，我强烈建议你获得店面 Hyvä 许可证，让那里的工作也变得有趣和快速。

理由

当使用 Magento 2 UI 组件创建管理网格和表单时，我总是感觉内心在一点点死去。从我的角度来看，这是一个糟糕的系统，原因很多，我不想在这里详细说明。不使用 UI 组件的替代店面（PWA Studio，Hyva Themes）对于前端开发者来说很棒，但不幸的是，我主要做后端工作。我创建的 UI 接口主要是为店主和管理员。

我希望有一种方法来完成我的工作（包括构建网格和表单），而不会感觉我必须与框架作斗争。
我希望感到有力量，快速高效地完成工作。经过多年的抱怨 Magento，我对 Willem Wigman 使用 Hyvä 前端主题所做的工作印象深刻。他激励我停止抱怨，并亲自采取行动，最终构建了我需要的工具。因此，有了 Hyva_Admin。

安装

该模块可以通过添加仓库作为源并要求它来通过composer安装。

composer require hyva-themes/module-magento2-admin

如果您只是想尝试Hyva_Admin网格以获取感觉，您还可以安装一个声明示例网格的测试模块。

composer require hyva-themes/module-magento2-admin-test

需求

只要在模板中分配了$escaper，它就应该与大多数Magento 2版本兼容。

快速入门

注意：概述和逐步说明以及API参考可以在文档文件夹中找到。

安装完成后，可以通过添加一些布局XML和一个网格配置文件来将网格添加到任何管理页面。
布局XML必须包含以下两点

• 一个<update handle="hyva_admin_grid"/>声明，用于加载alpine.js和tailwind。
• 一个Hyva\Admin\Block\Adminhtml\HyvaGrid块，其名称作为块参数（或作为布局中的块名称）。

之后，必须在目录[Your_Module]/view/adminhtml/hyva-grid中创建一个网格配置，其中文件名对应于传递给网格块的名称（文件名后添加.xml后缀）。

网格配置将需要包含一个网格源规范。目前这可以是仓库列表方法或\Hyva\Admin\Api\HyvaGridArrayProviderInterface实现。

在不进行进一步配置的情况下，将显示提供的记录的所有字段作为网格列。然后可以按需排除列，或者，作为替代方案，指定要显示的列的包含列表。在许多情况下，默认设置将足够好，无需进行超出网格源的进一步配置。

还可以按需配置网格行操作、批量操作、分页和过滤。

更多信息可以在Hyva Admin文档中找到。

稳定性

该模块尚未完成所有功能。然而，API将保持稳定，除非发现一些真正的缺陷。
将以向后兼容的方式添加新功能。

贡献

非常欢迎PR。
请基于主分支提交贡献。目前，支持的最老PHP版本是7.4。

版权 & 许可

版权 2021 Vinai Kopp & Hyvä Themes BV

该模块根据BSD-3 Clause license发布。

结束语

“我知道这看起来很容易，”小猪对自己说，
“但并不是每个人都能做到。”

• 艾伦·亚历山大·米尔恩，"波尔的房子"