Help With RWD Special Objects
About RWD Configuration Forms
RWD 7 features a number of objects that can be used to display content in new and powerful ways. In addition to added functionality, these new objects operate differently than previous RWD objects in that they are made up of code libraries that are sent to the web visitor's web browser along with the raw data (JSON) contained in the conference or calendar to be viewed, and then are 'built' by the browser itself to display the data.
In contrast to previous RWD objects which are defined and created on the server, this new breed of RWD objects has the distinct advantage of off-loading the processing required to construct the web view from the server to the user's browser. As well, these objects have a wide variety of configurable attributes that can be set to customize the appearance of the object when displayed in your website, as well as to control the features and behavour of the object for a given purpose.
Previous RWD objects can be customized to some degree using parameters in the link URL, however the new objects have a much larger number of possible customization parameters associated with them, and using a string of parameters in the link URL would be rather arduous. As such, in order to allow for as much customizability as possible, we've created configuration forms that can be used to greatly customize the objects.
These forms can be associated with a given conference or calendar or other content object by using a parameter in the URL that is entered into the RWD form.
Alternatively, the Site Administrator can create a configuration form for each object that suits most purposes likely to be needed by the builders in the system by entering the path to each of these forms in the RWDe Site Administrator Form. When this is done, all users who call any of the new objects from their pages or Mashups will see the object displayed in the browser according to the site-wide configuration forms defined by the RWDe Site Administrator in the RWDe Site Administrators form (.sitepref).
While configuration forms are not required for the object to function, if none is used, the object will be displayed according to a set of hard-coded default settings that may or may not be appropriate for your use.
If a particular user wishes to display an object in a manner that is different from the settings defined by the RWDe Site Administrator, they can be given a configuration form that can be used in a specific instance on the website. Of course, this override capability will require assistance from an administrator as the average user is not trained in the process and will not have access to the configuration forms which are stored in the Site Administrator's picker that can only be opened from the root container for the site.
Configuration forms can be associated with a particular object by EITHER:
1) Entering the absolute path and configuration form name in the RWD Site Administrator Form (.sitepref) as the default configuration form for all widgets. The images below highlight settings for a Calendar Widget but all new objects work in the same way except for the Digital Sign (please see Digitial Sign documentation for more information).
2) Entering the syntax ?config=[absolute path/configuration form name] after the Object (Conference or Calendar) URL in the RWD Mashup Panel Link To field to force an override to the customized configuration form.