loading table of contents...

7.13.3.1. Fixed Search Widget

Widget types based on the class fixedSearchWidgetType display the result of exactly one preconfigured search. Because this widget type does not offer any editable state, you should provide the search to execute when you define the widget type. In this way, you can define fixed search widget types showing checked-out documents or the most recently edited pages or arbitrary other searches.

For each type, you should at least specify the name under which the type can be selected in the dropdown box when adding a new widget. At your option, you may also set a title or a description to be shown for your type.

Because you can define multiple types, you must also provide different widget type IDs. You can then use a plain widgetState element with the chosen type ID and placement attributes to instantiate the widget.

An example configuration of this widget might look like this:

<editor:configureDashboardPlugin>
  <editor:widgets>
    <editor:widgetState widgetTypeId="editedByOthers"/>
  </editor:widgets>

  <editor:types>
    <editor:fixedSearchWidgetType
            id="editedByOthers"
            name="Edited by others">
      <editor:search>
        <editor:searchState editedByOthers="true"
                            editedByMe="false"
                            notEdited="false"
                            approved="false"
                            published="false"/>
      </editor:search>
    </editor:fixedSearchWidgetType>
  </editor:types>
</editor:configureDashboardPlugin>

Example 7.51. Fixed Search widget Configuration