IceCold: some re-wording of the messages tab, for users who come from the "Customizing Messages" link

2017-07-28T18:20:06Z

some re-wording of the messages tab, for users who come from the "Customizing Messages" link

IceCold: add the Colors page to "Customizing Messages " category

2017-07-28T17:34:36Z

add the Colors page to "Customizing Messages " category

IceCold: added message formatting paragraph

2017-07-28T16:01:01Z

added message formatting paragraph

IceChat: fix typo of channel

2015-04-27T15:41:36Z

fix typo of channel

IceCold: Created page with "The Color settings tabs include several basic tabs and several additional tabs that only exist if certain plugins are installed. 512px == Colors..."

2014-11-22T07:57:07Z

Created page with "The Color settings tabs include several basic tabs and several additional tabs that only exist if certain plugins are installed. 512px == Colors..."

New page

The Color settings tabs include several basic tabs and several additional tabs that only exist if certain [[plugins]] are installed.

[[File:ice9-colors.jpg|512px]]

== Colors Palette ==
At the bottom of the Color settings window there's a palette of 72 colors that are used everywhere in the software. 
Colors are identified by codes. These are numbers between 0 and 71 representing the ordinal place of a color on the palette.
 
The definition of the palette colors is located in the <code>[[Data Folder#XML_files|ColorPalette.xml]]</code> file under the [[Data Folder]]. If you want to change a certain color to another, replace the existing [http://html-color-codes.info/ Hex code] with one of your own, then re-start IceChat 9.

== Themes tab ==
IceChat 9 comes with several basic themes, which are saved under the [[Data Folder]]. Themes can be added, removed and re-added to IceChat 9 from this tab. 
Each theme is combined of two <code>xml</code> files, using the theme name. One is called <code>Colors-<theme name></code> and the other <code>Messages-<theme name></code>.
So the Blue theme will use these two files: <code>Colors-Blue.xml</code> and <code>Messages-Blue.xml</code>.

If you have used [[:Category:IceChat 7|IceChat 7]] and have themes there that you want to use, they can be imported from this tab. Simply point to IceChat 7 Data Folder, and press the Import IceChat 7 themes. Once imported, the themes are listed in the themes list and can be chosen.

If you have made changes to colors in the various tabs on this window, and you want to keep them, you can save them as a new theme. Press the Add new theme button, give the new theme a name, and it will be added to the themes list, and can be retrieved later at any time.

The Remove theme is used to remove a theme from the themes list. If the removed theme is the one currently used, then the default one will be restored and used the next time IceChat 9 is opened.

A previously removed theme can be loaded again into the themes list by using the Load Theme.

== Messages tab ==
This tab handles the colors of messages and actions on different parts of the software. There are two ways to handle the colors of messages/ actions: Basic, which is opened by default, and Advanced, which is the tab to the right of the Basic.

The Advanced tab allows detailed control of parts of a single message/ action, while the Basic allows only a single color for a single message/ action.

Both provide the same set of messages/ actions to be defined.
Messages and actions are divided into several groups in the list for convinience:
<ul>
<li>Cahnnel Messages</li>
<li>Server Messages</li>
<li>Private Messages</li>
<li>Self Messages</li>
<li>[https://en.wikipedia.org/wiki/Client-to-client_protocol CTCP] Messages</li>
<li>[[Settings#DCC_tab|DCC]] Messages</li>
<li>Other Messages</li>
</ul>
=== Basic ===
When you want to change the color of a certain message, select that message from the list, then select a color from the palette. A preview of the message is displayed in the Formatted message preview line.

If you want to change the message background, check the Change background color checkbox (to the left of the Formatted message title) and select a color.

Press Apply to save the changes so far, and go on to make more changes. When you have finished making changes, Save them and leave the Color Settings window.

The Reset to default button restores the original color settings of the message currently selected.

=== Advanced ===
A message is combined of several parts, each can have its own color and background color. These parts are a combination of Identifiers and, for some messages, constant text. 

Each part of a message can have a specific combination of foreground and optionally background colors, starting with a <code>CTRL+K</code> symbol, and ending with that same symbol.

To the right of the messages list on this tab, there a small rectangle with a dynamic legends of the Identifiers that can be used for that message.

==== Identifiers ====
<dl>
<dt>$message</dt>
<dd>This is the text that is relevant to the currently selected message. In case of a Channel Notice this will be the notice sent, in case of an Private Action this will be the action text, and in case of a Self Message this will be the message text. </dd>

<dt>$server</dt>
<dd>The actual server name (as oppose to the network name)</dd>

<dt>$serverip</dt>
<dd>The server IP Address</dd>

<dt>$port</dt>
<dd>The server port</dd>

<dt>$nick</dt>
<dd>This is the nickname that is relevant for the specific type of message or action currently selected. In case of an Channel Invite, that will be the nick who made the invite. In case of a Self Message that will be your own nick.</dd>

<dt>$host</dt>
<dd>The hostname of the $nick</dd>

<dt>$channel</dt>
<dd>The channel name that is relevant to this specific message. In an Channel Invite, this will be the channel to which you are invited. In a Chage Topic message, this will be the channel to which the change of the topic is made.</dd>

<dt>$status</dt>
<dd>The [[Colors#rank|rank*]] of the $nick in that channel.</dd>

<dt>$color</dt>
<dd>This is the color of the $nick's [[Colors#rank|rank*]] in the [[Colors#Nick List tab|Nick List tab]].</dd>

<dt>$account</dt>
<dd>The account name of a user, if that user connects with [[New_Server|SASL]]. TBV </dd>

<dt>$kickee</dt>
<dd>The nick who was kicked</dd>

<dt>$kicker</dt>
<dd>The nick who performed the kick</dd>

<dt>$reason</dt>
<dd>The reason for an Action, such as kick or quit.</dd>

<dt>$mode</dt>
<dd>The channel mode that changed</dd>

<dt>$modeparam</dt>
<dd>The parameters for the changed $mode. For example, +Voice, -Voice, etc.</dd>

<dt>$newnick</dt>
<dd>The new nick name when a nick is changed.</dd>

<dt>$data</dt>
<dd>The whois information</dd>

<dt>$ctcp</dt>
<dd>The Ctcp you wish to request for</dd>

<dt>$file</dt>
<dd>The name of the file trying to be sent</dd>

<dt>$filesize</dt>
<dd>The size in bytes of $file</dd>

</dl>

==== Message Coloring ====

Following is an example for a Channel message format, with detailed explanation.

[[File:ice9-channel-message-color-settings.jpg]]

To change the colors of a Channel Message, select it in the upper list of messages. 
In the Edit message here you can see the current setting of that message, and in the Formatted message below, is the preview of the settings. The Legend on the right list the <code>$color, $status, $nick, $message, $host, $channel</code> Identifiers as valid for this message.

Place the cursor to the left of $message (#4 in the screenshot) and open the Color Picker. Select the Yellow color. A symbol followed by the number 08 is displayed (#2 in the screenshot). Next, for the backgound of this part, type a comma, and then select the Blue color (first on the 2nd line of the palette). A symbol followed by the number 12 is displayed (#3 in the screenshot). Remove the symbol, leaving the number 12 near the comma with no spaces between. The result is displayed on the preview line bellow (#6 in the screenshot). 

You can manually type the color codes using <code>CTRL+K</code> to create the symbol followed by the desired color code number.

A note on the <code>$color$status$nick</code> combination in the example screenshot:

The <code>$color</code>, is the one that paints this part in Dark Blue (#7 in the screenshot). In live channels, this will show each nick name painted with the color of its [[Colors#rank|rank*]] from the [[Colors#Nick List tab|Nick List]].
The <code>$status</code> Identifier will display in live channels the [[Colors#rank|rank*]] (if exists) of the nick who wrote the message.

The result of the above example in live channel looks like this:

[[File:ice9-channel-message.jpg]]

== Server tree/Tabs tab ==
This tab handles the colors of events and messages on the [[Layout#Server_Tree|Server Tree]].
The left side of the tab handles the foreground colors and the right side defines the background colors.

=== Foreground colors ===

<dl>
<dt>Current tab</dt>
<dd>Affect the text color of the current tab on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>New Message</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when there's a new message on the channel. </dd>

<dt>New Action</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when there's a new action on the channel. </dd>

<dt>Channel Join</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone joins a channel. </dd>

<dt>Channel Part</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone parts a channel. </dd>

<dt>Server Quit</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when someone disconnected from the server. </dd>

<dt>Server Message</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when the server has some message. </dd>

<dt>Server Notice</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when the server has some notice. </dd>

<dt>Buddy List</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] when a [[Layout#Buddy_List|buddy]] comes on line or disconnects. </dd>

<dt>Other</dt>
<dd>This color will be displayed on the Channel bar and on the [[Layout#Server_Tree|Server Tree]] for messages other then the ones listed above. </dd>

<dt>Default</dt>
<dd>This is the default color of the text on the [[Layout#Server_Tree|Server Tree]]. Server names and opened channels will have this color when there are no other events that trigger the above defined colors. </dd>
</dl>

=== Background colors ===
Setting different colors for Color 1 and Color 2 for elements creates gradient effect.

<dl>
<dt>Current Tab - Color 1/ Color 2</dt>
<dd>Affect the background color of the current tab on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>Default Tab - Color 1/ Color 2</dt>
<dd>Affect the background color of the tabs other then the current on the [[Layout#Default_Layout|Channel Bar]] and the[[Layout#Default_Layout|Window tabs]] </dd>

<dt>Hover Tab - Color 1/ Color 2</dt>
<dd>This is the color displayed when hovering over a tab other then the current on the [[Layout#Default_Layout|Channel Bar]]. </dd>

<dt>Background</dt>
<dd>The background of the [[Layout#Default_Layout|Channel Bar]]. </dd>
</dl>

== Nick List tab ==
This tab handles the color settings for the different user [[Colors#rank|ranks*]]. Thse colors will be displayed on the [[Layout#Buddy_List|Buddy List]] window. It is also set by default for the [[Colors#Messages_tab|Channel Messages]].

== Other tab ==
This tab handles colors of the software elements (as oppose to IRC elements in other tabs).

=== Background colors ===
<dl>
<dt>Console </dt>
<dd>The background of the [[Layout#Welcome_tab|Console]] tabs. This includes the [[Layout#Welcome_tab|Welcome tab]] and each of the server tabs.</dd>

<dt>Channel </dt>
<dd>The background of the [[Layout#Default_Layout|channel]] tabs. </dd>

<dt>Query/ DCC Chat </dt>
<dd>The background of the tabs which are opened for a private communication: query and DCC chat. </dd>

<dt>Nick List </dt>
<dd>The background of the [[Layout#Nick_List|Nick List]] window. </dd>

<dt>Server List </dt>
<dd>The background of the [[Layout#Server_Tree|Server Tree]] window. </dd>

<dt>Channel List </dt>
<dd>The background of the [[Layout#Favorite_Channels|Favorite Channels]] window. </dd>

<dt>Input Box </dt>
<dd>The background of the [[Layout#Default_Layout|Input Box]]. </dd>

<dt>Side Panel Header - Color 1/ Color 2 </dt>
<dd>The background of the [[Layout#Default_Layout|side windows headers]] and the [[Layout#Default_Layout|buttons on the lower part of the side windows]]. A different Color 1 and Color 2 creates a gradient effect.</dd>

<dt>Menu Bar </dt>
<dd>The background of the Main Menu.</dd>

<dt>Tool Bar </dt>
<dd>The background of the Tool Bar.</dd>

<dt>Status Bar </dt>
<dd>The background of the [[Layout#Default_Layout|Status Bar]].</dd>

</dl>

=== Foreground colors ===
<dl>
<dt>Favorite Channel List </dt>
<dd> </dd>

<dt>Side Panel Header </dt>
<dd>The text color of the [[Layout#Default_Layout|side windows headers]]. </dd>

<dt>Unread text marker </dt>
<dd>Sets the color for the [[Settings#Display_tab|unread text marker]] </dd>

<dt>Status Bar </dt>
<dd>The text of the [[Layout#Default_Layout|Status Bar]].</dd>

<dt>Input Box </dt>
<dd>The text of the [[Layout#Default_Layout|Input Box]]. </dd>

<dt>Hyperlink </dt>
<dd>The color of hyperlinks on the text windows </dd>

</dl>

== High Lite tab ==
This tab only appears if the [[Plugins#High_lite_Plugin|High lite plugin]] is installed. It sets the options for that plugin.

When setting the options for a text to be highlighted, the following elemets are available:
<dl>
<dt>Text to highlight </dt>
<dd>Any string added here, will be highlighted on channels when mentioned. The text can be displayed in color. To set a color for the highlighted text, select one of the colors from the palette in the lower part of the tab. [https://en.wikipedia.org/wiki/Regular_expression regular expression] patterns can be used according to [http://msdn.microsoft.com/en-us/library/az24scfc%28v=vs.90%29.aspx Microsoft examples]. 
If you want to highlight your own nick when mentioned on channels, you can use the Identifier <code>$me</code>.
</dd>

<dt>Command to run </dt>
<dd>TBC </dd>

<dt>Sound to play </dt>
<dd>Any supported [[Settings#Sounds_tab|sound file]] from anywhere on your hard disk can be added. </dd>

<dt>Command to run </dt>
<dd>TBC </dd>

<dt>Highlight only for selected nicks </dt>
<dd>The text will be highlighted only if it was typed by the nicks listed in this line. Several nick names can be listed, separated by a space. </dd>

<dt>Highlight for all, except selected nicks </dt>
<dd>Opposite in meaning to the above: The text here will not be highlighted if it was typed by any of the nick names in this list. Several nick names can be listed, separated by a space.</dd>

<dt>Flash channel tab on highlight </dt>
<dd>If the client is not minimized to the [[Settings#Main_Settings_tab|System Tray]] </dd>

</dl>

== Nick Hilite tab ==
This tab only appears if the [[Plugins#Nick_High_Lite_Plugin|Nick Hilite plugin]] is installed. It sets the options for that plugin.

<dl>
<dt>Nick to highlight </dt>
<dd>Type a nick name, and select a color from the palette at the bottom of the tab. The nick name will be displayed on the [[Layout#Nick_List|Nick List]] with the selected color. </dd>

<dt>Host to highlight </dt>
<dd>If populated, that host or any host that the text is part of, will be displayed on the [[Layout#Nick_List|Nick List]] with the selected color. </dd>

</dl>

<div id="rank">rank* - a local terminology representing a subset of [https://en.wikipedia.org/wiki/Internet_Relay_Chat#Modes user modes] on channel, such as Voice, Op, Half Op, etc. The ranks are listed on the [[Colors#Nick List tab|Nick List tab]]. </div>

[[Category:IceChat 9]]
[[Category:Settings]]
[[Category:UI]]
[[Category:Common Usage]]
[[Category:Advance Usage]]

@@ Line 24: / Line 24: @@
 == Messages tab ==
-This tab handles the colors of messages and actions on different parts of the software. There are two ways to handle the colors of messages/ actions: <em>Basic</em>, which is opened by default, and <em>Advanced</em>, which is the tab to the right of the <em>Basic</em>.
+The Messages tab on the [[Colors]] settings (see above) allows the user to change the colors and formatting of messages and actions on different parts of the software. There are two ways to handle the colors of messages/ actions: <em>Basic</em>, which is opened by default, and <em>Advanced</em>, which is the tab to the right of the <em>Basic</em>.
 The <em>Advanced</em> tab allows detailed control of parts of a single message/ action, while the <em>Basic</em> allows only a single color for a single message/ action.

← Older revision		Revision as of 17:34, 28 July 2017
Line 330:		Line 330:
	[[Category:Common Usage]]		[[Category:Common Usage]]
	[[Category:Advance Usage]]		[[Category:Advance Usage]]
		+	[[Category:Customizing Messages]]

@@ Line 121: / Line 121: @@
 </dl>
-==== Message Coloring ====
+==== Message Coloring and Formatting ====
 Following is an example for a <em>Channel message</em> format, with detailed explanation.
@@ Line 142: / Line 142: @@
 [[File:ice9-channel-message.jpg]]
 == Server tree/Tabs tab ==

@@ Line 31: / Line 31: @@
 Messages and actions are divided into several groups in the list for convinience:
 <ul>
-<li>Cahnnel Messages</li>
+<li>Channel Messages</li>
 <li>Server Messages</li>
 <li>Private Messages</li>

Colors - Revision history

IceCold: some re-wording of the messages tab, for users who come from the "Customizing Messages" link

IceCold: add the Colors page to "Customizing Messages " category

IceCold: added message formatting paragraph

IceChat: fix typo of channel

IceCold: Created page with "The Color settings tabs include several basic tabs and several additional tabs that only exist if certain plugins are installed. 512px == Colors..."