README

这个扩展是 MMX 创新计划的一部分 - 现代化的 MODX 方法。

依赖关系

此包需要 mmxDatabase 来使用 Eloquent 模型与 MODX 数据库一起工作。

Composer 会自动下载 mmx/database 依赖项。

准备

此包只能通过 Composer 安装。

如果您还没有在 MODX 3 中使用 Composer，只需下载您版本中的 composer.json 即可。

cd /to/modx/root/
wget https://raw.githubusercontent.com/modxcms/revolution/v3.0.5-pl/composer.json

安装

composer require mmx/users --update-no-dev
composer exec mmx-users install

更新

composer update mmx/users --no-dev
composer exec mmx-users install

移除

composer exec mmx-users remove
composer remove mmx/users

如果您不想使用 mmxDatabase，也可以将其移除。

composer exec mmx-database remove && composer remove mmx/database

如何使用

只需在 MODX 管理员中打开 mmxUsers 扩展部分即可享受！

系统设置

您可以通过系统设置更改扩展网格和表单的外观和感觉。请阅读说明并查看默认值。

网格 设置

在这里您可以指定列的顺序和设置。

可用的列有

• group-grid-columns
  • 常规 UserGroup 列，如 id、name、description、rand
  • 具有相同列（id、name 等）的嵌套选项父 UserGroup
  • 具有组用户计数的特殊列：members_count
• user-grid-columns
  • 常规 User 和 Profile 列：id、username、fullname、email 等...
  • 扩展字段的值：extended.key1、extended.key2 等。不可排序。
  • 来自 UserSetting 表的值：setting.key1、setting.key2。可排序！

支持的设置

• type - 列的类型，支持的是
  • boolean 显示是/否图标
  • text 或未设置的其他值
• sortable (true | false) 使列可排序。
• sort (true | false) 将此列指定为默认排序
• dir 指定列排序的方向（如果 sort=true）

标签页 设置

这些设置非常简单 - 您只需指定哪些标签页将可见。

• group-tabs-create
• group-tabs-edit
• user-tabs-create
• user-tabse-edit

请参阅 MODX 管理员中的设置说明。

表单 设置

目前您只能自定义用户表单。我认为没有理由为用户组表单添加此功能，但请随时告诉我您的想法。

user-form-fields-available - 表单的所有可用字段及其设置列表

• 类型:
  • text - 只是常规文本字段
  • email - 这里和下面的文本字段是相同的，但具有指定的 type="..." 属性
  • 密码
  • URL
  • 电话
  • textarea - 你应该知道这是什么，对吧？
  • checkbox - 定义的常规复选框用于布尔值
  • gender - 选择性别变体的选择框
  • image - 这将打开 MODX 浏览器以选择上传的图像
  • country - 选择国家列表的选择框
  • select - 选择具有自定义选项的选择框（别忘了指定 options:["option1","option2"] 或 options:[{"value":1,"text":"Option 1"},{"value": 2,"text":"Option 2"}]）
  • user-password - 具有更改用户密码及确认的特殊组件
• required (true | false) 是否需要此字段为必填项？
• default - 创建新用户时设置的默认值

user-form-fields-user 和 user-form-fields-sudo

2个针对具有 sudo 权限和无权限的管理员系统的设置。

您可以通过美化的 JSON 数组指定现有字段的顺序。

[
    ["username", "fullname", ["active", "sudo"]],
    ["email", ["dob", "gender"]]
]

您将获得一个具有嵌套字段的2列表单，其中一些字段也分为2列。在移动设备上，将显示为1列表单。