PHPackages                             lcharette/uf\_userprofile - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. lcharette/uf\_userprofile

ActiveUserfrosting-sprinkle[Utility & Helpers](/categories/utility)

lcharette/uf\_userprofile
=========================

Custom Profile Fields for UserFrosting V4

3.0.1(5y ago)88244[1 issues](https://github.com/lcharette/UF_UserProfile/issues)MITPHPPHP >=7.1

Since May 21Pushed 5y ago2 watchersCompare

[ Source](https://github.com/lcharette/UF_UserProfile)[ Packagist](https://packagist.org/packages/lcharette/uf_userprofile)[ Docs](https://github.com/lcharette/UF_UserProfile)[ Fund](https://ko-fi.com/lcharette)[ RSS](/packages/lcharette-uf-userprofile/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (5)Dependencies (1)Versions (17)Used By (0)

Custom User Profile Field Sprinkle for [UserFrosting 4](https://www.userfrosting.com)
=====================================================================================

[](#custom-user-profile-field-sprinkle-for-userfrosting-4)

[![Donate](https://camo.githubusercontent.com/b7dc459938f321309f24018c6839ab1a99d6f0233f063a741ce7be1f607b88f5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f6e6174652d4275792532304d6525323061253230436f666665652d626c75652e737667)](https://ko-fi.com/A7052ICP)[![Latest Version](https://camo.githubusercontent.com/42ae0fe8bbd0a5aee0c9f1d747569588a8b08d9643aa9e43f22c55ca7b708077/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6c63686172657474652f55465f5573657250726f66696c652e737667)](https://github.com/lcharette/UF_UserProfile/releases)[![UserFrosting Version](https://camo.githubusercontent.com/d243b113a8b1764f50f7668212d970eb996110109b81aae3c24363ffb37baaab/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5573657246726f7374696e672d2533453d253230342e332d627269676874677265656e2e737667)](https://github.com/userfrosting/UserFrosting)[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE)[![Build](https://github.com/lcharette/UF_UserProfile/workflows/Build/badge.svg?branch=master)](https://github.com/lcharette/UF_UserProfile/actions?query=workflow%3ABuild)[![Codecov](https://camo.githubusercontent.com/a1c1ac2eb7a0979d1347b16ba0bce95ee5844d273c20212712c2f305942019f7/68747470733a2f2f636f6465636f762e696f2f67682f6c63686172657474652f55465f5573657250726f66696c652f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/lcharette/UF_UserProfile)[![StyleCI](https://camo.githubusercontent.com/bdc19bdf0af76faf1d6ff3cceaab25190025295725b7e4fa202e188ad1cbb230/68747470733a2f2f7374796c6563692e696f2f7265706f732f38333938313833302f736869656c643f6272616e63683d6d6173746572267374796c653d666c6174)](https://styleci.io/repos/83981830)

This Sprinkle makes it easy to add any custom fields to the user or group model. Simply create a new schema in you own sprinkle and you're done. Your new profile fields will be automatically integrated in the default UserFrosting interface.

Help and Contributing
=====================

[](#help-and-contributing)

If you need help using this sprinkle or found any bug, feels free to open an issue or submit a pull request. You can also find me on the [UserFrosting Chat](https://chat.userfrosting.com/) most of the time for direct support.

Installation
============

[](#installation)

Edit UserFrosting `app/sprinkles.json` file and add the following to the `require` list : `"lcharette/uf_userprofile": "^3.0.0"`. Also add `FormGenerator` and `UserProfile` to the `base` list. For example:

```
{
    "require": {
        "lcharette/uf_userprofile": "^3.0.0"
    },
    "base": [
        "core",
        "account",
        "admin",
        "FormGenerator",
        "UserProfile"
    ]
}
```

Run `composer update` then `php bakery bake` to install the sprinkle.

Usage
=====

[](#usage)

To add a custom profile fields to any user, you simply add a [FormGenerator](https://github.com/lcharette/UF_FormGenerator) compliant schema containing the `form` key as well as the traditional [validation schema](https://learn.userfrosting.com/routes-and-controllers/client-input/validation). The rest is generated by this Sprinkle.

For example, you can add the following to a `schema/userProfile/myFields.json` file inside your sprinkle to add a `location`, `occupation` and `gender` user field. With the associated locale keys, that's all you have to do to add a new user field to your UserFrosting setup.

```
{
    "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"
            }
        }
    }
}
```

Note that the schema must be saved inside the `schema/userProfile/` directory of your sprinkle to be picked up automatically by the system. You might also want to run `php bakery clear-cache` command from the UserFrosting root since those fields are stored in cache for better performances.

You can also specify **groups** custom fields by saving any schema in the the `schema/groupProfile/` directory of your sprinkle.

Screenshots
-----------

[](#screenshots)

[![Screenshot 1](/.github/screenshots/UF_UserProfile1.png?raw=true)](/.github/screenshots/UF_UserProfile1.png?raw=true)[![Screenshot 1](/.github/screenshots/UF_UserProfile2.png?raw=true)](/.github/screenshots/UF_UserProfile2.png?raw=true)

License
=======

[](#license)

By [Louis Charette](https://github.com/lcharette). Copyright (c) 2020, free to use in personal and commercial software as per the MIT license.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 97.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~97 days

Recently: every ~286 days

Total

15

Last Release

1963d ago

Major Versions

0.0.1 → 2.0.02017-06-26

2.1.1 → 3.0.02020-05-14

PHP version history (2 changes)0.0.1PHP >=5.6

3.0.0PHP >=7.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2566513?v=4)[Louis Charette](/maintainers/lcharette)[@lcharette](https://github.com/lcharette)

---

Top Contributors

[![lcharette](https://avatars.githubusercontent.com/u/2566513?v=4)](https://github.com/lcharette "lcharette (94 commits)")[![Jamezsss](https://avatars.githubusercontent.com/u/19152517?v=4)](https://github.com/Jamezsss "Jamezsss (2 commits)")

---

Tags

userfrostinguserfrosting-sprinkleprofileuserfrostingSprinkle

### Embed Badge

![Health badge](/badges/lcharette-uf-userprofile/health.svg)

```
[![Health](https://phpackages.com/badges/lcharette-uf-userprofile/health.svg)](https://phpackages.com/packages/lcharette-uf-userprofile)
```

###  Alternatives

[fof/masquerade

User profile builder extension for your Flarum forum.

2025.4k5](/packages/fof-masquerade)[coldtrick/profile_manager

Improved management of user and group profile fields

303.8k1](/packages/coldtrick-profile-manager)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)