Creating a Freeform Module

Before creating a freeform module in Brightspot, you should devote some time to designing the module’s purpose. Some modules have the following features:

  • Link to an external web page soliciting user engagement.
  • Button to close the module.

You can create a freeform module at any level of the Content Hierarchy. All assets you create inherit the freeform module from the nearest available level in the content hierarchy.

The following procedure applies to the freeform module that comes with Brightspot. The procedure for your freeform module may be different if you implemented a customized version with a developer.

  1. Under Module Placement, scroll down to the module’s placement (Above, Aside, or Below). For an illustration of these positions, see the diagram in Modules.

  2. From the list box, select Add After. For an explanation of the possible selections for module placement, see Module Placement.

  3. From the Add drop-down list, select Freeform. A Freeform form appears.

  4. Define the link by doing the following:

    1. From the Link list, select one of the following:

      • Internal—The promoted item is part of your Brightspot project.
      • External—The promoted item is at a URL external to your Brightspot project.
    2. In the Main tab, fill out fields. The available fields depend on your choice for type of link in the previous step.

      ../../../../_images/freeform-main.png
    3. In the Advanced tab, do the following:

      1. (For internally linked content only) In the Anchor field, type the name of an internal anchor in the linked item. When rendering the freeform module, Brightspot inserts the link as http://domain.com/page.html#anchor.
      2. From the Target drop-down list, select one of the following:
        • Same Window/Tab—The target item appears in the current browser window or tab.
        • New Window/Tab—The target item appears in a new browser window or tab.
      3. Under Attributes, click Add Attribute and add a name and value of HTML attributes applied to this freeform. Repeat to add additional attributes.
      ../../../../_images/freeform-advanced.png
  5. Add text to the module by doing the following:

    1. Click Add Text. A form appears.
    2. In the Main tab, enter text as described in Rich Text.
    3. Depending on your current theme, there is an Overrides tab with additional fields you can use to further define the module.
    ../../../../_images/rich-text-editor-form.png
  6. Add a button to the module by doing the following:

    1. Click Add Button. A form appears.

    2. In the Text field, type the text to appear on the button.

      ../../../../_images/freeform-button.png
    3. Define the button’s link by doing the following:

      1. From the Link list, select one of the following:

        • Internal—The promoted item is part of your Brightspot project.
        • External—The promoted item is at a URL external to your Brightspot project.
      2. In the Main tab, fill out fields. The available fields depend on your choice for type of link in the previous step.

        ../../../../_images/freeform-main.png
      3. In the Advanced tab, do the following:

        1. (For internally linked content only) In the Anchor field, type the name of an internal anchor in the linked item. When rendering the freeform module, Brightspot inserts the link as http://domain.com/page.html#anchor.
        2. From the Target drop-down list, select one of the following:
          • Same Window/Tab—The target item appears in the current browser window or tab.
          • New Window/Tab—The target item appears in a new browser window or tab.
        3. Under Attributes, click Add Attribute and add a name and value of HTML attributes applied to this freeform. Repeat to add additional attributes.
        ../../../../_images/freeform-advanced.png
  7. Click Publish.