Skip to main content
Version: 2.0

Users

Feature NameCrestApps Users Core
Feature IDCrestApps.OrchardCore.Users

Extends the Orchard Core Users module by adding functionality to cache users.

:::note Note This feature is enabled by dependency only. :::

User Display Name​

Feature NameUser Display Name
Feature IDCrestApps.OrchardCore.Users.DisplayName

Provides a way to display a user's display name.

To set the display name format, navigate to Settings → User Display Name.

The screencast below enables User Display Name, selects the First Middle Last name format with required first and last names, and shows the matching name fields appearing on the user editor.

The next screencast shows the full effect end to end. It configures the First Middle Last name format with First name and Last name set to Required, edits the current user's own profile to set those names, then opens the Content Items list where the author badge that previously showed only the username now shows the user's full name.

If you want to display the user display name in your project via code, you may do so by using the IDisplayNameProvider interface.

Liquid Support​

When the "Liquid" feature is enabled, a new helper to display the user's display name will become available (i.e, display_name). Here is an example:

{{ Model.User | display_name }}

When both the Users and User Display Name features are enabled, the search functionality within the Users UI will expand to include fields such as display name, first name, middle name, or last name in the search results.

Additionally, when the UserPickerField field is used, the display text will show the display name.

Re-indexing Users​

A recipe step is available to re-index users. This step will update all enabled users by default using a batch size of 250. To re-index all of your users run the following recipe:

{
  "steps": [
    {
        "name": "indexUsers",
        "includeDisabledUsers": false,
        "batchSize": 250
    }
  ]
}

The includeDisabledUsers parameter within the indexUsers step is optional and allows for the indexing of disabled users if desired. Moreover, the batchSize parameter provides the ability to adjust the update batch size. The default value is set at 250 and can be increased to 1000 if necessary.

User Avatar​

Feature NameUser Avatar
Feature IDCrestApps.OrchardCore.Users.Avatars

Provides a way to display a user's avatar.

To change the default settings, navigate to Settings → User Avatars.