Support and Documentation

Custom content types

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 custom content types
Procedure. To create a custom content type:
  1. From the Navigation Menu, expand Admin, and select 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 |mi-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.

Editors can create new items from the custom content type using the Create list in the search panel. For details, see Creating any type of content.

Adding a Boolean field

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

Procedure. 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
Figure 64. Configuration of a Boolean field


Boolean field in content edit form
Figure 65. Boolean field in content edit form


Adding a cluster

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

Procedure. 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 |mi-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
Figure 66. Configuration of a cluster


Cluster in content edit form
Figure 67. Cluster in content edit form


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

non-clustered-fields-at-top.svg
. See also:
Adding a date field

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

Procedure. 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
Figure 68. Configuration of a date field


Date field in content edit form
Figure 69. Date field in content edit form


Adding a file field

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

Procedure. 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
Figure 70. Configuration of a file field


File field in content edit form
Figure 71. File field in 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.)

Procedure. 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
Figure 72. Configuration of a location field


Location field in content edit form
Figure 73. Location field in content edit form


Adding a number field

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

Procedure. 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
Figure 74. Configuration of a number field


Number field in content edit form
Figure 75. Number field in 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. (For information about how editors use reference fields, see Working with the selection field.)

Procedure. 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
Figure 76. Configuration of a reference field


Reference field in content edit form
Figure 77. Reference field in content edit form


Adding a region field

Region fields show a region on a map. (For information about how editors use region fields, see Working with regions.)

Procedure. 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
Figure 78. Configuration of a region field


Region field in content edit form
Figure 79. Region field in 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.)

Procedure. 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
Figure 80. Configuration of a rich-text field


Rich-text field in content edit form
Figure 81. Rich-text field in content edit form


Adding a select field

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

Procedure. 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
Figure 82. Configuration of a select field


Select field in content edit form
Figure 83. Select field in content edit form


Adding a tab

Tabs organize fields into smaller content edit forms within a parent content edit form.

Procedure. To add a tab:
  1. In the Content Type form, from the Items list, select Tab. A form appears.

  2. Under Main, in the Name field, enter a name for the tab.

  3. Add fields to the tab by doing the following:

    1. Under Items, click |mi-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 tab
Figure 84. Configuration of a tab


Tab in content edit form
Figure 85. Tab in content edit form


Fields not assigned to a tab appear in the content edit form's Main tab.

. See also:
Adding a text field

Text fields contain plain text with no formatting.

Procedure. 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
Figure 86. Configuration of a text field


Text field in content edit form
Figure 87. Text field in content edit form