A Web Widget is a tool that you configure, which allows users to opt-in to a list on a website. Once you configure the settings, custom code is generated for an embedded or pop-out widget.

In this chapter we explain how to create and manage widgets. Learn about each in the following topics.

  • Web Widget Manager

  • Widget Wizard

    You may access these tools from the Web menu in the Textboom toolbar or from the quick link image icon on the Dashboard.

    Web Widget Manager


    The Widget Manager displays a listing of all widgets for your account. You can filter by OC (Operating Company), Agency, Client, or Status. You can edit, disable, re-enable, and delete widgets. You may also perform a search for a specific word or number. The listing will change to match any filters that you apply, and you can combine several filters to make your report very specific. To clear away any filter, you can perform a reset at any time.

    You may access this feature by choosing Web > Widget Manager from the toolbar.


    You can also access the SMS Campaigns by utilizing the quick link icons that are located under the toolbar on the Dashboard.


    After choosing this menu item, you’ll see a page having the characteristics which we describe below.



    On the left side of the report control panel, you’ll find a group of filters (below). Choose from one or more of these drop-down menus to filter by OC (Operating Company), Agency, Client, or Status.


    Along with these filters, you’ll also find a Search field. Here you can enter a specific value, such as “GOSSIP” or “57111”. Click the Go button (found at the extreme right of the page) to initiate the search. Any records containing the value in the Search field will appear in the results.


    Click the Go button to update the listing; click the Reset button to revert back to the original filter settings.

    Add, Enable, Disable, or Delete Widgets

    In the upper right corner of the page, locate these icons:


    Check the box next to any record, and then click the icon that corresponds to the function you want to apply:

  • New – add a new widget.

  • Enable – enables a record that has been previously been disabled.

  • Disable – Click this icon to disable the widget. A disabled widget cannot be used again until it is enabled.

  • Delete – click this icon to delete the widget. A deleted widget is both disabled and invisible.

    Column Headings

    The figure below displays the first few column headings. Underneath these headings, you will see a list of all your widgets.


    Managing Widgets

    At the extreme right end of each record in the listing you’ll find a series of small icons:


    Click this icon to preview the widget in a popup window.

    Click this icon to edit the widget (you will exit the Widget Manager).


    Click this icon to disable the widget. A disabled widget cannot be used again until it is enabled.

    Click this icon to delete the widget. A deleted widget is both disabled and invisible.

    Create a Web Widget


    The Widget feature is a tool for creating an HTML widget that you can insert into a forms or display as a popup. We provide you with many options, and yet it’s quite easy to setup.

    You may access the Widget feature by choosing Web > Widget Wizard from the toolbar.


    Or by clicking on New in the Widget Manager.


    After choosing this menu item, you will see a page much like the figure below.

    Configuring the Widget

    Notice the Widget Look & Feel section on the left side of the page. To begin, follow these steps:


      1. The default size for the widget is 300 pixels wide by 400 pixels high. If you want to specify different dimensions, enter new values for Size in the width (W) and height

        (H) fields.

      2. Next you may optionally choose different colors for Text, System Message Text, or the Frame. Click the circular icon next to these fields and choose the color.

      3. Typically, the width of a frame border is only a few pixels.

        If you want a thicker border, then enter the value (in pixels) for Frame Width.

      4. If you like, change the colors for the Button, Button Text, and Help Text.

      5. You might like to choose a different Font Style from the drop-down list, and also change the Font Size.

    Widget Profile and Content

    In the center of the page, you’ll see a number of fields that you use to create the widget profile and content:


    Follow these steps:

    1. Click the Client drop-down list, and then select the correct client name.

    2. Enter a Widget Name.

    3. Optionally, enter the Widget Notes.

    4. Click the Browse button for the Header Image. This image will appear at the top of the widget. If you don’t want a header image, check the No Header Image box.

    5. Next, enter the Header Title Text. Using the small toolbar in this panel, you may also change the font family, font size, and other formatting options. You can also resize this panel (and the others below) by grabbing the lower right corner of the panel and dragging it outward.

    6. You can also enter the Footer Text. As before, you may change the formatting using the small toolbar in this panel. (steps continue below the next figure).


    7. Optionally, you can enter a Term and Condition Title and a Terms and Conditions link.

    8. If you like, you may enter a Privacy Policy Title and a Privacy Policy link.

    9. If you want something different than the default, then enter the text in the Submit Button Label field.

    10. If you want to place a button that can close the widget without submitting, check the Include Close Button box. Optionally, enter the text for the label in the Close Button Label field.

    11. Click Next to move on to the Data Fields step of the wizard.

      Data Fields

      In this step, you’ll add fields to the widget. Here is the first view of the page:


      Add data fields to the widget by following these steps:

      1. Choose the field type from the Field 1 drop-down listing.

      2. Check the Required box if this data field is mandatory.

      3. Optionally, in Field Title, enter a different label for the data field.

      4. If you want a narrower or wider field, decrease or increase the value of Screen Size.

      5. You may also add Help Text, which will display a hint when the user hovers over the field with the mouse pointer.

      6. The first field is now complete. To add another, click the Add link.

      7. To configure another field, follow the same steps above for the second field.

      8. You can move a field downward by clicking the Down link.

      9. Click the Clear to wipe the properties of a field; click Remove to delete a field.

      10. Click Next to move on the Database & SMS Campaign step.

    Database & SMS Campaign

    In this step, you’ll choose (or create) the database in which you want to associate with this widget. If no database exists, you may create one by following these steps:

    1. Click Create New Database.

    2. Enter a Database Name.

    3. Check the box for Send Subscription Renewal Msg? if you want to send a monthly renewal message to your database.

    4. Click Submit to commit your changes; click Cancel to discard.

    You may choose to avoid database selection entirely by selecting the No Destination Database radio button. If you do want to associate an existing database with this widget, then look to see that at least one database already exists in the Available listing. Follow the steps below to manage your databases.


    To choose one or more existing databases:

    1. Click the database name in the Available listing, then click the right arrow to move the database name to the Selected listing.

    2. If you want to take action when a duplicate entry is found in a database, check the If Record already exists in box. Then, decide if you want to check all databases by clicking the All Selected Databases radio button.

    3. In the Double Registration Message field, enter the text that you want to send if a duplicate record is found.

    Submit Actions

    At the bottom of the Database page, you can choose to perform one of several actions after the user clicks the Submit button in the widget. Simply follow these steps:

    Confirmation Message

    1. To display a confirmation message, first check the box for Confirmation Message.

    2. If you want to simply display a message within the widget, click the option for Send confirmation message to the widget and enter the Confirmation Message.

    3. Instead, if you want to redirect to another page to display the message, click the option for Go to a confirmation page, enter the URL, and then (optionally) choose to display the target web page in a New Window.

    Text message to recipient’s phone

    1. You might also want to send a confirmation text message to the phone number in the database record. If so, then check the box for Send Text Message to the Record’s phone.

    2. Enter the Confirmation Message.

    Activate a SMS Campaign

    1. You can also initiate a campaign by checking the box for Activate a SMS Campaign.

    2. From the drop-down listing, choose the campaign you want to activate.

    When you are done, click Next to move on to the final step of the wizard, Generate Code.

    Generate Code

    This is the last step, in which you generate the code for use in your campaign. You have two options: You can generate code for the widget to appear either in a popup window or a form. Here is the view of the page:


    Widget Popup

    1. If you want the widget to appear as a popup, click the Generate Popup Code button.

    2. Click the Copy button and then paste the code into a text editor of HTML editor.

    Widget Form

    1. If you want to embed the widget into a form, click the Generate Form Code button.

    2. Click the Copy button and then paste the code into a text editor of HTML editor. Click the Save button to commit your changes and complete the wizard.