List

From TrillWiki

Contents 1 List Controls 2 Global 2.1 Icons 2.2 Colors 2.3 Fonts 3 Contact List Specific 3.1 Icons 3.1.1 Changes in Trillian 3.0 3.1.1.1 Icon sizes 3.1.1.2 Icon packs 3.1.1.3 icon-base 3.1.2 Changes in Trillian 3.1 3.2 Colors 3.2.1 1.0+ 3.3 Fonts 3.4 Changes in Trillian 1.0 3.4.1 Metacontacts 3.4.2 List background 3.5 Super Tooltips (2.0+) 4 The YourOn list 4.1 Icons 4.2 Colors 4.3 Fonts 5 The URL-Grabber 5.1 Icons 5.2 Colors 5.3 Fonts 6 The NickList 6.1 Icons 6.2 Colors 6.3 Fonts

[edit] List Controls

<control name="" type="list">

<icon name="[icon-name]" type="[icon-type]" state="[icon-state]">

<source name="[ bitmap name ]" left="" right="" top="" bottom=""/>

</icon>

<color name="[color-name]" red="" green="" blue=""/>

<font name="[font-name]" source="[font-source]" type="" size="" bold="" italics="" underline=""/>

</control>

[edit] Global

[edit] Icons

You have only two global icons, with 3 states each, the icons are the group icons.
The icon names are all group, the icon types are expanded and collapsed, and the states are normal, hover and select.

[edit] Colors

The colors that have to be in every list are listed below. the name of the color tag contains the pre- and suffix, which is formatted this way: <prefix>-<suffix>, like normal-fore and hover-back.

Prefix	Suffix
	fore	back	border 1.0+
normal	x	x
hover	x	x	x
select	x	x	x
default	x
group	x

[edit] Fonts

The two global fonts are default, and group. The global fonts are needed for every list.

[edit] Contact List Specific

[edit] Icons

In the Contact List (also refered to as Buddy List), Medium (icon-name) and status (icon-type) are retrievable from the table below; icon-state will be normal, hover or select Entries marked with a "W" indicate items not listed in the official STIXE code, but with icons in Whistler. (In-other-words support may be coming Soon™.)

STIXE name: listCTact (For compatibility with plugins that don't correctly enumerate skins, skinners should use this name for their contact list control)

Status		Medium
	META	AIM	ICQ	IRC	MSN	YAHOO	JABBER	Novell	SKYPE
online	x	x	x	x	x	x	x	x	x
offline	x	x	x	x	x	x	x	x	x
recent-offline	x	x	x	x	x	x	x	x	x
recent-online	x	x	x	x	x	x	x	x	x
free for chat			x				x
idle	x	x	x		x	x		x
away	x	x	x	x	x	x	x	x	x
not available			x						x
busy					x	x		x
dnd			x				x		x
occupied			x
stepped out						x
maybe				x
on the phone					x	x
out to lunch					x	x
invisible	x		x		x	x	x	x	x
chat							x
skype me									x
xa							x
auth			x		W	W			W
webcam					W	x

Note: STIXE also supports the following mediums which we assume CS will create, but we have not listed here: Exchange, Sametime, SurfSimple, and VibePhone. Refer to STIXE/elements/extras/<medium>.dtd if you wish to add support for these. Furthermore, third party medium plugins exist, such as: Sametime, EQIM, NETSEND, SILC, etc. Refer to their pages for required icons. (see our list of medium plugins)

Also, there are a few more icons, with icon-types:

• "notinlist" an orphaned contact not associated with any connection for that medium (New in 3.1)
• "icon-base" a base icon for that medium over which the status icons are overlaid. (New in 3.0)
• "activebuddy" (special AIM/ICQ bots)
• "mobile" (a special version of AIM / yahoo for use with mobile devices (PDAs etc]]
• "event" (if the user has windows set to "notify me via the systray", this is the icon that flashes in the contact list to notify them that the user has sent them a message/xfer etc)
• "many" (if an IRC buddy is logged onto multiple servers, this state will be used)

Furthermore, there are plugins such as My IRC Chats that use icons in the list control if you have them. (In this case, type="chatroom" for name="IRC")

The following icons are placed next to the status icon, instead of replacing it.

• "alert" (if you have set an alert for a buddy (right click->Set Alerts...), this icon will display next to the medium icon)
• "warning" (if the user has been warned on AIM)
• "block" (if the user is blocked on your contact list (you have blocked them]]

The icon-name property is not needed for these. The states are, once again, normal, hover and select.

[edit] Changes in Trillian 3.0

[edit] Icon sizes

Trillian 3.0 added multiple sizes to list icons. It basically means a LOT of duplication of code. Hopefully in the future, it won't depend on the exact numbers given here and we'll be able to make arbitrary sizes, but for now, this is all that seems to work.

<control name="[name]" type="list">

<!-- Standard <icon> code. -->

<!-- Also, put your color / etc code here

NOTE: these icons are used when buddy-icon mode is off, (i.e. in Basic)

and in the subcontacts for metacontacts. -->

<size name="16">

<!-- More <icon> code. -->

<!-- Used when user selects "Tiny"

(Well, tiny by Kid's standards.. huge by Microscopic standards :D -->

</size>

<size name="24">

<!-- More <icon> code. -->

<!-- Used when user selects "Small" -->

</size>

<size name="32">

<!-- More <icon> code. -->

<!-- Used when user selects "Medium" -->

</size>

<size name="48">

<!-- More <icon> code. -->

<!-- Used when user selects "Large" -->

</size>

</control>

[edit] Icon packs

The one upside is that STIXE 3.0 introduced some back-end code for Icon packs, to allow skins to not have to include all of this code if they link in to STIXE. So, while the above <size> code adds a LOT of code for skinners, that code only needs to be done by those creating icon packs.

[edit] icon-base

Also, there is an addition of a new icon type when defining the new large, medium, small, and tiny icons. New type is "icon-base" and it means we can FINALLY have the extra icon states as overlays. Usage is:

<icon name="META/AIM/MSN/ETC" type="icon-base">

This icon base is used when using Picture mode and is currently used when a contact doesn't have a buddy icon. Away/Idle etc are then just overlayed onto this base icon (or buddy icon if they're using one).

[edit] Changes in Trillian 3.1

Trillian 3.1 added the "notinlist* (a.k.a. Orphaned) contact type listed above.

[edit] Colors

You will need the following colors:

• group-fore (colour of group names)
• idle-fore
• recent-online-fore
• recent-offline-fore
• online-fore
• offline-fore
• away-fore
• maybe-fore
• many-fore
• blocked-fore
• activebuddy-fore

• not available-fore
• occupied-fore
• dnd-fore
• busy-fore
• brb-fore
• on the phone-fore
• out to lunch-fore
• not at home-fore
• not at desk-fore
• not in office-fore
• on vacation-fore
• stepped out-fore

[edit] 1.0+

• section-hover-back (the "my contacts" etc stuff)
• section-hover-fore
• section-select-back
• section-select-fore
• section-back
• section-fore

• metacontact-recent-online-fore
• metacontact-recent-offline-fore
• metacontact-online-fore
• metacontact-offline-fore
• metacontact-away-fore

• update-fore

• You will also need the global colors.

[edit] Fonts

You will need the following fonts:

• group
• default
• online
• offline
• away
• idle
• not available
• recent-online
• recent-offline
• blocked
• maybe

[edit] Changes in Trillian 1.0

[edit] Metacontacts

Trillian 1.0 introduced metacontacts (a cross between contacts and groups -- it is a groups of contacts, but behaves like a contact in that it shows away state, etc). In Trillian 3.0, this is a pro-only feature.

• metacontact-online
• metacontact-offline
• metacontact-recent-online
• metacontact-recent-offline
• metacontact-away

Logically, you will also need the global fonts.

[edit] List background

As of 1.0, buddylist controls can also have background code. Normal background code sets the graphics for a single section of the contact list, but a new <background name="background"> was introduced to be able to set the background for the entire list control.

Also in 1.0, there are a couple of extra settings:

<settings name="sectionLeftMargin" value=""/>

<settings name="sectionRightMargin" value=""/>

<settings name="sectionTopMargin" value=""/>

<settings name="sectionBottomMargin" value=""/>

These set padding in the sections (my contacts etc), i.e. distance from edge of control of the *contents* of the section (not the title)

[edit] Super Tooltips (2.0+)

Trillian 2.0 Brings us "super tooltips"

These are just some extra fonts colours and settings tags to go in the list control, with is an image, courtesy of KId, to explain what each of these does

font names:

• tooltip-title
• tooltip-subtitle
• tooltip-group
• tooltip

Settings:

• tooltipLeftMargin
• tooltipRightMargin
• tooltipTopMargin
• tooltipBottomMargin
• tooltipMiddleRightMargin
• tooltipMiddleLeftMargin

Colours:

• tooltip-border
• tooltip-edge
• tooltip-back
• tooltip-fore
• tooltip-title
• tooltip-subtitle
• tooltip-group

[edit] The YourOn list

[edit] Icons

The following icons should be created for the channels (connection) list (Note: you don't need the icon-name property - these go in icon-type):

• container
• connected
• disconnected
• privmsg
• channel
• dccconf
• edccconf
• edcc
• dccgroup
• minimize
• file-pending
• file-sending
• file-error
• file-complete

And, of course, you need to have the global icons.

[edit] Colors

• nickglow-fore
• textglow-fore

And, you need the global colors.

[edit] Fonts

Now, for the fonts, you only need the global fonts.

[edit] The URL-Grabber

[edit] Icons

Now, this will be easy, this list doesn't need as many icons as the Buddy List and YourOn list did! Basically, you have two icons where the "icon-type"s are web, and urlgrabber (no icon-name), both these icons have 3 states: normal, hover and select.

[edit] Colors

The only colors needed for this list, are the global colors.

[edit] Fonts

Now, for the fonts, you only need the global fonts, I told you this one was gonna be easy!

[edit] The NickList

[edit] Icons

For the IRC and AIM nick list, you need the following icons: op, voice and normal (and half-ops as of 3.0, note the plural.) (Note: you don't need the icon-name property - these go in icon-type). For states use normal, hover and select. And, of course, you'll need the global icons.

[edit] Colors

You will only need the global colors.

[edit] Fonts

You'll only need the global fonts.