lcharette / uf_userprofile
为UserFrosting V4自定义用户资料字段
Requires
- php: >=7.1
- lcharette/uf_formgenerator: ^2.1.0 || ^3.0.0 || ^4.0.0
README
这个插件使得向用户或组模型添加任何自定义字段变得简单。只需在你的插件中创建一个新的模式即可。你的新资料字段将自动集成到默认的UserFrosting界面中。
帮助和贡献
如果你在使用这个插件时需要帮助或发现了任何错误,请随时提出问题或提交拉取请求。你大部分时间也可以在UserFrosting聊天上找到我,以获得直接支持。
安装
编辑UserFrosting app/sprinkles.json
文件,并将以下内容添加到 require
列表: "lcharette/uf_userprofile": "^3.0.0"
。还要将 FormGenerator
和 UserProfile
添加到 base
列表中。例如
{ "require": { "lcharette/uf_userprofile": "^3.0.0" }, "base": [ "core", "account", "admin", "FormGenerator", "UserProfile" ] }
运行 composer update
然后 php bakery bake
安装插件。
用法
要向任何用户添加自定义资料字段,你只需添加一个符合FormGenerator的架构,包含 form
键以及传统的 验证架构。其余部分将由这个插件生成。
例如,你可以在你的插件内的 schema/userProfile/myFields.json
文件中添加以下内容,以添加 location
、occupation
和 gender
用户字段。与关联的本地键一起,这就是添加新用户字段到你的UserFrosting设置所需做的全部。
{ "location" : { "validators" : { "length" : { "label" : "LOCATION", "min" : 1, "max" : 255, "message" : "VALIDATE.LENGTH_RANGE" } }, "form": { "type": "text", "label": "LOCATION", "icon": "fa-globe" } }, "occupation" : { "validators" : { "length" : { "label" : "OCCUPATION", "min" : 1, "max" : 255, "message" : "VALIDATE.LENGTH_RANGE" } }, "form": { "type": "textarea", "label": "OCCUPATION", "icon": "fa-briefcase" } }, "gender" : { "validators" : {}, "form": { "type": "select", "label": "GENDER", "icon": "fa-transgender", "options" : { "1" : "GENDER.MALE", "2" : "GENDER.FEMALE", "3" : "GENDER.NEUTRAL" } } } }
请注意,架构必须保存在你的插件的 schema/userProfile/
目录中,以便系统自动提取。你可能还需要从UserFrosting根目录运行 php bakery clear-cache
命令,因为这些字段存储在缓存中以获得更好的性能。
你还可以通过在插件的 schema/groupProfile/
目录中保存任何架构来指定 组 自定义字段。
截图
许可证
由Louis Charette提供。版权(c)2020,根据MIT许可证,可免费用于个人和商业软件。