What's new in 1.2.0

Version 1.2.0 is a maintenance release which includes the following changes:

• Support for Lion full-screen mode
• Support for Growl 1.3 (which is available on the Mac App Store for Lion)
• Re-enabled support for text-size menu items (requires Safari 5.1 or later)
• Fixes problems with images displayed in Campfire's new 'yeah' and 'drama' sound messages
• Adds support to drag images out of Propane's image-preview window
• Re-enables support for PPC architectures (accidentally removed in 1.1.4)
• Fixes problems with "lock scroll to bottom" behavior during resizing
• Additional css classes and javascript responder callbacks (explained below)

Additional CSS classes

Propane's chat CSS can be tweaked by editing /Library/Application Support/Propane/styles/cf_chat.css.

body.propane_fullscreen

The propane_fullscreen class will be added to the body element whenever you enter Lion full-screen mode. The class is removed from the body when you leave full-screen mode.

I personally use this to bump up the overall size of the chat html while in full-screen mode:

body.propane_fullscreen {
  zoom: 1.2;
}

body.propane_host_[hostname] and body.propane_room_[roomID]

These two dynamically-generated classes are added to the body just before loading any custom Javascript Responder callbacks.

• [hostname] will be replaced with the subdomain of the campfire host. Eg: https://example.campfirenow.com would receive a body class of propane_host_example.
• [roomID] will be replaced with the numeric id of the room. Eg: https://example.campfirenow.com/room/12345 would receive a body class of propane_room_12345.

If you don't know the host or roomID for a given chat, the easiest way to figure that out is to right-click on any message in a chat and select "Copy Transcript Link". This will copy a URL to the pasteboard that looks like this:

https://example.campfirenow.com/room/12345/transcript/message/999999#message_999999

I personally use these styles to change the look of certain chats to remind me to use less 'colorful' language. The CSS below will change the white 'fade' at the bottom of the chat to be a pale red.

body.propane_host_example div.speak {
  background-image: -webkit-gradient(
    linear,
    left bottom,
    left top,
    color-stop(0.0, rgba(256,192,192,1)),
    color-stop(0.5, rgba(256,192,192,0.75)),
    color-stop(1, rgba(256,192,192,0))
  ) ! important;
}

Javascript Responder Callbacks

Propane has a largely-undocumented feature that allows you to add your own javascript callbacks into the running Campfire javascript.

When a room is loaded, Propane will look for a file called ~/Library/Application Support/Propane/unsupported/caveatPatchor.js. If that file is present then Propane will load it into the running chat javascript just after it loads its own javascript hooks.

This is an expert feature which requires an understanding of Campfire's javascript so it's not for the faint-hearted. A sample caveatPatchor.js file can be found at https://gist.github.com/825404

New callbacks specific to Propane 1.2.0

Propane dispatches certain new events to the running Campfire javascript so that "should be scrolled to bottom" state is correctly preserved.

You can use these callbacks if you need your responders to alter their behavior based on tab focus, live resize and full-screen state.

Tab Focus

• onPropaneTabDidGainFocus()
• onPropaneTabWillLoseFocus()

Live resizing

• onPropaneTabWillStartLiveResize()
• onPropaneTabDidEndLiveResize()

Full Screen

• onPropaneToggledFullScreen(inFullScreen) inFullScreen is either true or false.

Text Resizing

Propane uses this to trigger a re-layout of the chat. Not sure why anyone else would need it, but mentioned for completeness.

• onPropaneChangedTextZoomFactor()