Custom Content Edit Forms

You can create custom Content Edit Forms at the site and global levels, and then assign those forms to individual roles.

Creating Custom Content Edit Forms

You can create a customized content edit form for a particular content type, and then assign the form to a role or role-site combination. This feature is useful when you want to show or hide certain tabs or fields depending on a user’s role, or if you want to make some tabs or fields read-only. For example, for articles, you can have one version of the content edit form without the Overrides tab for your users in the reporter role, and another version of the form that includes the Overrides tab for your SEO admin users.

  1. From the Navigation Menu, select Admin > Sites & Settings. The Content Forms widget appears on the left side of the page.

    ../../../_images/content-forms-widget.png
  2. From the drop-down list, select the type of content for which you want to create a customized content edit form, and then click New. The New Content Form widget appears.

    ../../../_images/new-content-edit-form.png
  3. In the Name field, type a name for the form. This name appears in the Create drop-down list in the Search Panel.

  4. From the Scope drop-down list, select one of the following:

    • None—The content form is unavailable to all sites.
    • Global—The content form is available to assign to any site.
  5. From the Accesses drop-down list, select the level of access for all tabs and fields on the form. (This setting applies to the entire form; you can override this setting at the tab and field levels in the following steps.)

  6. Under Visible Items, do the following:

    • Hide a visible tab by dragging it to the Hidden Items list. (Don’t hide tabs containing fields that are required in the default content edit form.)
    • Show a hidden tab by dragging it to the Visible Items list.
    • Reorder the visible tabs by dragging them to the required position.
    • Change placement of widgets on the content edit form.
  7. To add a new tab to the form, do the following:

    1. Click Add Tab. A new tab field appears.
    2. In the Name field, type a name for the tab.
    3. From the Access drop-down list, and using Access Options Table as a reference, select one of the access options.
    4. Repeat steps a–c to add additional tabs.
  8. To customize a tab and its fields, do the following:

    1. Click to expand the tab. Fields for the tab’s name, access level, and fields appear.

      ../../../_images/content-form-tab-open.png
    2. In the Name field, type a name for the tab.

    3. From the Access drop-down list, and using Access Options Table as a reference, select one of the access options.

    4. Hide a visible field by dragging it to the Hidden Items list. (Don’t hide a field that is required in the default content edit form.)

    5. Show a hidden field by dragging it to the Visible Items list.

    6. Reorder the visible items by dragging them to the required position.

    7. Group fields within the tab by doing the following:

      1. Click Add Group. A new group field appears.
      2. In the Name field, type a name for the group.
      3. From the Access drop-down list, and using Access Options Table as a reference, select one of the access options.
      4. Drag fields into the group and in the desired order.
    8. For each field in the tab whose access you want to modify, do the following:

      1. Click to expand the field.
      2. Using Access Options Table as a reference, select one of the access options.
  9. To change the placement of a widget on the content edit form:

    1. Click to expand the widget.

    2. From the Placement drop-down list, select one of the placement options.

      ../../../_images/widget-placement-dropdown.png
  10. Click Save.

Brightspot saves the custom content edit form, and the form appears in the Content Forms widget. You can assign the form to a role; for details, see Assigning Custom Content Edit Forms to a Role.

The following table describes the access options at the tab and field level.

Access Options Table
Access Option Tab level Group level Field level
Inherited Fields in the tab have the same read and write access as the default form for the content type. Fields in the group have the same read and write access as the containing tab. Field has the same read and write access as the containing group or tab.
Read Only Fields in the tab have read-only access. Fields in the group have read-only access. Field has read-only access.
Read & Write Fields in the tab have read and write access. Fields in the group have read and write access. Field has read and write access.

Modifying Custom Content Edit Forms

  1. From the Navigation Menu, select Admin > Sites & Settings. The Content Forms widget appears on the left side of the page.
  2. Click the form you want to modify. Brightspot displays the form in the Edit Content Form widget.
  3. Modify the form; see Creating Custom Content Edit Forms for details.

Deleting Custom Content Edit Forms

  1. From the Navigation Menu, select Admin > Sites & Settings. The Content Forms widget appears on the left side of the page.
  2. Click the form you want to delete. The Edit Content Form widget appears.
  3. Click Archive.

Assigning Custom Content Edit Forms to a Role

Brightspot generates default Content Edit Forms based on the fields in the underlying content type. For example, if an article has fields for headline, author, body, and image, the default content edit form for articles displays those four fields. Whenever you create a new article, you see the default content edit form.

You can display different versions of content edit forms based on a user’s role or role-site combination. Referring to the following diagram, when creating a new article—

  • A user not assigned to any role sees the form’s default version with four fields.
  • A user assigned to the role Contributor sees the version with three fields.
  • A user assigned to the role Contributor and working on the site aliens.com sees the version with two fields.
../../../_images/content-edit-form-hierarchy.svg
  1. From the Navigation Menu, select Admin > Users & Roles. The Roles widget appears on the left side of the page.

    ../../../_images/roles-widget.png
  2. Click the role to which you want to assign the form. The Edit Tool Role widget appears.

  3. Under the Main tab, from the Global Content Forms drop-down list, select the content edit forms appropriate for this role. (The available content forms are those that were given Global scope when the forms were created.)

  4. If you want to assign different content edit forms to different sites for this role, do the following:

    1. Under the Main tab, under Site Specific Content Forms, click Add Site Specific Content Forms. A Site Specific Content Forms form appears.

      ../../../_images/site-specific-content-edit-form.png
    2. From the Sites drop-down list, select the sites to which the content edit form applies.

    3. From the Content Forms drop-down list, select the appropriate content edit forms. (The available content forms are those that were given Global scope when the forms were created.)

    4. Repeat steps a–c to add additional site-specific content edit forms.

  5. Click Save.