lcharette / uf_userprofile

为UserFrosting V4自定义用户资料字段

资助包维护!
Ko Fi

安装: 822

依赖: 0

建议者: 0

安全: 0

星标: 8

关注者: 2

分支: 4

开放问题: 1

类型:userfrosting-sprinkle

3.0.1 2021-02-14 18:16 UTC

This package is auto-updated.

Last update: 2024-09-05 09:03:40 UTC


README

Donate Latest Version UserFrosting Version Software License Build Codecov StyleCI

这个插件使得向用户或组模型添加任何自定义字段变得简单。只需在你的插件中创建一个新的模式即可。你的新资料字段将自动集成到默认的UserFrosting界面中。

帮助和贡献

如果你在使用这个插件时需要帮助或发现了任何错误,请随时提出问题或提交拉取请求。你大部分时间也可以在UserFrosting聊天上找到我,以获得直接支持。

安装

编辑UserFrosting app/sprinkles.json 文件,并将以下内容添加到 require 列表: "lcharette/uf_userprofile": "^3.0.0"。还要将 FormGeneratorUserProfile 添加到 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 文件中添加以下内容,以添加 locationoccupationgender 用户字段。与关联的本地键一起,这就是添加新用户字段到你的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/ 目录中保存任何架构来指定 自定义字段。

截图

Screenshot 1 Screenshot 1

许可证

Louis Charette提供。版权(c)2020,根据MIT许可证,可免费用于个人和商业软件。