Topics

Custom content types


In This Guide

Brightspot comes with over one dozen content types that fit almost every electronic publication. You can also create your own custom content types from the basic fields types, such as text and date.

Custom content types are helpful in the following situations:

  • Creating abbreviated content edit forms that require just a few fields.
  • Re-ordering content edit forms to better match an editorial workflow.

Creating a custom content type

To create a custom content type:

  1. Click menu > Admin > Content Types.
  2. In the Content Types widget, click New. A content edit form appears.
  3. In the Main field, enter a name for this content type.
  4. Under Items, click add_circle_outline, and select one of the field types.
  5. Complete the form for the selected field type. (The following sections describe how to configure the available field types.)
  6. Repeat steps 4–5 to add additional fields.
  7. Rearrange the fields by dragging them into the order you want them to appear in the content edit form.
  8. Click Save.

Adding a Boolean field

Boolean fields provide a yes/no or on/off indication.

To add a Boolean field:

  1. In the Content Type form, from the Items list, select Boolean Field. A form appears.
  2. Under Main, in the Name field, enter a name for this field.
  3. (Optional) Under Advanced, in the Note field, enter a short explanatory note that appears in the content edit form.
Configuration of a Boolean field.png
Configuration of a Boolean field
Boolean field in content edit form.png
Boolean field in content edit form

Adding a cluster

Clusters provide accordions containing groups of fields. Editors can open and close clusters.

To add a cluster:

  1. In the Content Type form, from the Items list, select Cluster. A form appears.
  2. Under Main, in the Name field, enter a name for the cluster.
  3. Add fields to the cluster by doing the following:

    1. Under Fields, click add_circle_outline|, and select a field type.
    2. Complete the form for the field type.
    3. Repeat steps a–c to add additional fields.
Configuration of a cluster.png
Configuration of a cluster
Cluster on a content edit form.png
Cluster on a content edit form

Fields not assigned to a cluster always appear above clusters in the content edit form.

Fields not included in a cluster


Adding a date field

Date fields provide a calendar that editors use to select a date.

To add a date field:

  1. In the Content Type form, from the Items list, select Date Field. A form appears.
  2. Under Main, in the Name field, enter a name for this field.
  3. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. Toggle on Required if this is a required field.
Configuration of a date field.png
Configuration of a date field
Date field on a content edit form.png
Date field on a content edit form

Adding a file field

File fields enable editors to upload images, videos, attachments, and other types of files.

To add a file field:

  1. In the Content Type form, from the Items list, select File Field. A form appears.
  2. Under Main, in the Name field, enter a name for this field.
  3. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. Toggle on Required if this is a required field.
Configuration of a file field.png
Configuration of a file field
File field on a content edit form.png
File field on a content edit form

Adding a location field

Location fields show a location on a map. (For information about how editors use location fields, see Specifying a location.)

To add a location field:

  1. In the Content Type form, from the Items list, select Location Field. A form appears.
  2. Under Main, in the Name field, enter a name for this field.
  3. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. Toggle on Required if this is a required field.
Configuration of a location field.png
Configuration of a location field
Location field on a content edit form.png
Location field on a content edit form

Adding a number field

A number field requires an editor to enter only integers (numbers without a decimal point).

To add a number field:

  1. In the Content Type form, from the Items list, select Number Field. A form appears.
  2. Under Main, in the Name field, enter a name for this field.
  3. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. Enter minimal and maximal values. Brightspot displays an error message in the content edit form if an editor enters a number outside of this range.
    3. Toggle on Required if this is a required field.
Configuration of a number field.png
Configuration of a number field
Number field on a content edit form.png
Number field on a content edit form

Adding a reference field

A reference field enables editors to select an item existing in Brightspot. A common example of a reference field is selecting an author for an article or a blogger for a blog post.

To add a reference field:

  1. In the Content Type form, from the Items list, select Reference Field. A form appears.
  2. Under Main, in the Name field, enter a name for this field.
  3. From the Count field, select one of the following:

    • One—Editor can select only one item.
    • Many—Editor can select more than one item.
    • Many (Sortable)—Editor can select more than one item, and then rearrange the selections into a desired order.
  4. From the Types list, select the content types used to populate the reference field. For example, if you want editors to be able to select an author, select the Author content type.
  5. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. Toggle on Unique if the field's selection must be different from selections entered in this field in other items. For example, an editor selects Blogger A in this field; editors cannot select Blogger A in this field when creating other items of this content type.
    3. Toggle on Search Filter to allow type-ahead searching. As an editor types characters in the field, Brightspot shows only the matching entries. This feature is useful for reference fields with many possible selections.
    4. Toggle on Required if this is a required field.
Configuration of a reference field.png
Configuration of a reference field
Reference field on a content edit form.png
Reference field on a content edit form

Adding a region field

Region fields show a region on a map.

To add a region field:

  1. In the Content Type form, from the Items list, select Region Field. A form appears.
  2. Under Main, in the Name field, enter a name for this field.
  3. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. Toggle on Required if this is a required field.
Configuration of a region field.png
Configuration of a region field
Region field on a content edit form.png
Region field on a content edit form

Adding a rich-text field

Editors use rich-text fields to apply formatting to text. (For information about how editors use rich-text fields, see Rich-text editor.)

To add a rich-text field:

  1. In the Content Type form, from the Items list, select Rich Text Field. A form appears.
  2. Under Main, in the Name field, enter a name for this field.
  3. From the Toolbar field, select one of the available toolbars.
  4. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. In the Character Count Minimum and Character Count Maximum fields, enter the minimal and maximal number of characters allowed in this field. Brightspot displays an error message in the content edit form if an editor enters text with length outside of this range.
    3. In the Suggested Minimum and Suggested Maximum fields, enter the recommended minimal and maximal number of characters for this field. Brightspot accepts the text even if it is shorter or longer than these values.
    4. Toggle on Required if this is a required field.
Configuration of a rich-text field.png
Configuration of a rich-text field
Rich-text field on a content edit form.png
Rich-text field on a content edit form

Adding a select field

A select field enables editors to select from a specific set of choices.

To add a select field:

  1. In the Content Type form, from the Items list, select Select Field. A form appears.
  2. Under Main, in the Name field, enter a name for this field.
  3. From the Count field, select one of the following:

    • One—Editor can select only one item.
    • Many—Editor can select more than one item.
    • Many (Sortable)—Editor can select more than one item, and then rearrange the selections into a desired order.
  4. In the Choices field, add the choices available for this field.
  5. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. Toggle on Required if this is a required field.
Configuration of a select field.png
Configuration of a select field
Select field on a content edit form.png
Select field on a content edit form

Adding a text field

Text fields contain plain text with no formatting.

To add a text field:

  1. In the Content Type form, from the Items list, select Text Field. A form appears.
  2. Under Main, in the Name field, enter a name for this field.
  3. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. In the Character Count Minimum and Character Count Maximum fields, enter the minimal and maximal number of characters allowed in this field. Brightspot displays an error message in the content edit form if an editor enters text with length outside of this range.
    3. In the Suggested Minimum and Suggested Maximum fields, enter the recommended minimal and maximal number of characters for this field. Brightspot accepts the text even if it is shorter or longer than these values.
    4. Toggle on Unique if the text entered must be different from text entered in this field in other items. For example, an editor entered Crystal Goblet in this field; editors cannot enter Crystal Goblet in this field when creating other items of this content type.
    5. Toggle on Search Filter to allow type-ahead searching. As an editor types characters in the field, Brightspot shows matching entries previously entered in this field.
    6. Toggle on Required if this is a required field.
Configuration of a text field.png
Configuration of a text field
Text field on a content edit form.png
Text field on a content edit form