Browser property change | Convertigo Documentation

Allows changing some properties of the embedded browser.

This statement allows a transaction to change some of the properties of the Mozilla-based Convertigo HTML decoder. For each property, you can specify if the property has to be modified and the new value of this property, or if the property keeps its unchanged value.

Property	Type	Category	Description
Attachment enable value	AttachmentMode	standard	Forces the Attachment retrieval property on (enabled) or off (disabled), or leaves it unchanged. By default, attachment files are not downloaded when transfer dialogs open, in Studio or Server. Using this statement, Attachment retrieval property value can be changed and has the following effects: • If set to force on, attachment files are automatically downloaded when transfer dialogs open and are recoverable by the Get attachment extraction rule. • If set to force off, attachment files are never downloaded when transfer dialogs open. • If set to no change, it keeps the default value (disabled) or the previously set value, if another Browser property change statement changed the value previously in the same context.
Comment	String	standard	Describes the object comment to include in the documentation report. This property generally contains an explanation about the object.
Image rendering enable value	ImageMode	standard	Forces the browser Image rendering property on (enabled) or off (disabled), or leaves it unchanged. By default, the Image rendering property value depends on the environment: • in Studio, Image rendering property is enabled by default, • in Server, the default value is based on a property configured in Administration Console Configuration page, in advanced properties of HTML parser configuration tab. Using this statement, Image rendering property value can be changed and has the following effects: • If set to force off, the HTML decoder does not render images, which speeds up the process. It is used mostly for production server mode, so another way to do the same behavior is to always set this property to no change with a default value configured to false in the Administration Console. • If set to force on, the HTML decoder always renders images, which slows down a little the process. • If set to no change, it keeps the default value or the previously set value, if another Browser property change statement changed the value previously in the same context.
Is active	boolean	standard	Defines whether the statement is active.
JavaScript enable value	JavascriptMode	standard	Forces the browser JavaScript property on (enabled) or off (disabled), or leaves it unchanged. By default, the JavaScript code present in target HTML pages is executed, in Studio or Server, and the resulting DOM reflects the JavaScript execution. Using this statement, JavaScript property value can be changed and has the following effects: • If set to force on, embedded JavaScript code in target HTML pages is executed. • If set to force off, embedded JavaScript code in target pages is not executed. • If set to no change, it keeps the default value (enabled) or the previously set value, if another Browser property change statement changed the value previously in the same context. In most cases, JavaScript property should be enabled but for specific Web Clipping projects, we recommend disabling JavaScript to prevent a double JavaScript execution (one in the HTML decoder and one in the user’s browser).
Plugin enable value	PluginMode	standard	Forces the browser Plugin feature property on (enabled) or off (disabled), or leaves it unchanged. By default, the Plugin feature property value depends on the environment: • in Studio, Plugin feature property is enabled by default, • in Server, the default value is based on a property configured in Administration Console Configuration page, in advanced properties of HTML parser configuration tab. Using this statement, Plugin feature property value can be changed and has the following effects: • If set to force off, the plugins such as Flash player are disabled, which speeds up the process. It is used mostly for production server mode, so another way to do the same behavior is to always set this property to no change with a default value configured to false in the Administration Console. • If set to force on, the plugins such as Flash player are enabled, which slows down a little the process. • If set to no change, it keeps the default value or the previously set value, if another Browser property change statement changed the value previously in the same context.
Remove cookies	boolean	standard	Removes all cookies from the browser. This property is not exactly a browser setting. When this property is set to true, all cookies are removed from the Convertigo context and HTML decoder.
Window open enable value	WindowOpenMode	standard	Forces the browser Window open property on (enabled with option to open “in new window” or “in same window”), off (disabled) or leaves it unchanged. JavaScript window.open function is disabled by default to prevent pop-up windows to be displayed. Using this statement, Window open property value can be changes and has the following effects. If Window open property is set to force on, pop-up windows are enabled. If enabled, two cases are possible: • set to Force on same window: pop-up windows are opened replacing the parent window in the HTML decoder (only one browser window opened), • set to Force on new window: pop-up windows are opened as new tabs next to the parent window in the HTML decoder (several tabs opened in parallel in the same browser). In this case, tabs opened can be accessed and manipulated thanks to Tab management statement. If Window open property is set to force off, pop-up windows are disabled. If Window open property is set to no change, it keeps the default value (disabled) or the previously set value, if another Browser property change statement changed the value previously in the same context.
Convertigo mode	ConvertigoMode	expert	Applies changes on Studio, Engine, or both. Defines in which mode the browser setting must be active: • Studio mode: settings only valid in Convertigo Studio, • Engine mode: settings only valid in Convertigo Server, • Both modes: settings valid in Convertigo Server as well as in Studio (default value).