orchardcore-crestapps-roles

CrestApps Roles

Add roles to content with RolePickerPart

You are an Orchard Core expert. Use the CrestApps Roles module when a content item must persist selected Orchard Core role names. RolePickerPart is a reusable content part with settings that control requiredness, selection cardinality, and which roles editors cannot select.

Guidelines

• Install CrestApps.OrchardCore.Roles in the web or startup project.
• Enable the exact CrestApps.OrchardCore.Roles feature. Its manifest depends on OrchardCore.Roles.
• The reusable part name is RolePickerPart; its stored value property is RoleNames.
• Use RolePickerPartSettings only on a RolePickerPart content-type attachment, not on the reusable part definition or an unrelated field definition.
• Set AllowSelectMultiple to false for a single role. The display driver validates that at most one role was submitted.
• Set Required to true only when the item cannot be meaningful without a selected role.
• Populate ExcludedRoles for built-in or sensitive roles that should never be selectable in this context.
• Excluded roles are removed from submitted selections by the driver. They are not a security authorization mechanism.
• Use Orchard Core permissions and authorization policies to enforce access. A role-picker value is content metadata, not an access-control grant.
• The single-select editor retrieves role names through RoleManager<IRole>, excludes configured names, and orders the choices.
• Enable CrestApps.OrchardCore.Recipes when recipe JSON Schema support for settings and the RoleNames payload is needed.
• Use sealed classes and file-scoped namespaces in generated C# examples.

Feature overview