Skip to content

WebFusion Application Preferences & Defaults Reference

xcvista edited this page Mar 7, 2013 · 2 revisions

WebFusion for Mac supports a variety of debug tools and features, that is accessible through command line tools and use of defaults utility.

Table of Contents

Use of the preference keys

Preference keys exposed in the Preferences pane can be modified directly from it.

Use of command-line arguments

See also: Mac OS X open(1)

When launching the application through Terminal, use the following syntax to specify the keys and their values:

 open /Application/WebFusion.app --args -<key> <value> ...

Use of defaults utility

See also: Mac OS X defaults(1)

To list the current preferences:

 defaults read tk.maxius.webfusion

To set a preference

 defaults write tk.maxius.webfusion <key> <type> '<value>'

You must keep the single quotes.

To erase all preferences and reset them to the default value:

 defaults delete tk.maxius.webfusion

Exposed preferences through Preferences screen

General tab

  • Load ___ new items each time.
    • Synopsis: When loading the first page of a list or reloading a list, this is the number of items to be fetched from the server.
    • Key: loadBatchSize
    • Type: Integer
    • Default value: 25
  • When viewing old items, load ___ items each time.
    • Synopsis: When loading the subsequent pages of a list, this is the number of items to be fetched from the server.
    • Key: historyBatchSize
    • Type: Integer
    • Default value: 25
  • Pull content every ___ seconds.
    • Synopsis: This is the frequency of pulling new data from server.
    • Key: pullFrequency
    • Type: NSTimeInterval (typedef'd to double)
    • Default value: 5.0
  • Save last user name.
    • Synopsis: Cause the login box to save the username upon successful login, and reload it in the subsequent session.
    • Key: useSavedUsername
    • Type: Boolean
    • Default value: YES

Advanced tab

  • Show Developer Utilities
    • Synopsis: Show the developer tools and utilities in the application, and "Developer Features" preferences.
    • Key: showDeveloperMenu
    • Type: Boolean
    • Default value: NO

"Developer Features" preferences

  • Responds stalled after ___ seconds.
    • Synopsis: This controls the timeout after which a packet will be highlighted in Packet Inspector.
    • Key: requestStallTimeout
    • Type: NSTimeInterval (typedef'd to double)
    • Default value: 3.0
  • Show JSON data with pretty print.
    • Synopsis: Cause the packet info view to reformat the data if it is JSON.
    • Key: prettyPrintJSON
    • Type: Boolean
    • Default value: YES
  • WebFusion API Root address
    • Synopsis: Change the root address of the WebFusion API. (For server debugging.)
    • Key: server
    • Type: String
    • Default value: https://www.shisoft.net/ajax

Keys involved in Override Mode

Main article: Override Mode

Some keys may behave differently in Override Mode.

  • Key: override
    • Synopsis: Override mode main switch.
    • Type: Boolean
    • Default value: NO
  • Key: username
    • Synopsis: With key password, cause the app to automatically log onto the server.
    • Type: String
    • Default value: nil
  • Key: password
    • Synopsis: With key username, cause the app to automatically log onto the server. When useSavedUsername is set and last known good username exist, that username will be used if not otherwise overridden.
    • Type: String
    • Default value: nil

Other keys

  • Key: username
    • Synopsis: Used to save last known good username when useSavedUsername is set.
    • Type: String
    • Default value: nil
  • Key: launchWithPacketInspector
    • Synopsis: Cause the Packet Inspector to launch with the app.
    • Type: Boolean
    • Default value: NO
  • Key: allowAlternativeServer
    • Synopsis: Enable server change fields in the Preferences pane. It will not prevent a direct write or a direct override of the server preference.
    • Type: Boolean
    • Default value: NO