Plugin:TabSRMM/Configure history - Revision history

Dart Raiden at 23:08, 27 October 2022

2022-10-27T23:08:48Z

← Older revision		Revision as of 02:08, 28 October 2022
Line 69:		Line 69:
	</translate>		</translate>

	[[Category:Tutorials]]		[[Category:Tutorials{{#translation:}}\|{{#getdisplaytitle:{{FULLPAGENAME}}}}]]

Dart Raiden at 20:30, 26 September 2022

2022-09-26T20:30:19Z

← Older revision		Revision as of 23:30, 26 September 2022
Line 11:		Line 11:
	</translate>		</translate>

	{{TNT\|Note\|<translate><!--T:4--> Message log options do not include font and color settings, but fonts and colors are also fully customizable in TabSRMM. Read about [[../General settings\|themes]].</translate>}}		{{TNT\|Note\|<translate><!--T:4--> Message log options do not include font and color settings, but fonts and colors are also fully customizable in TabSRMM. Read about [[Plugin:TabSRMM/General settings\|themes]].</translate>}}

	<translate>		<translate>
Line 23:		Line 23:

	<!--T:8-->		<!--T:8-->
	It consists of a list box holding most of the "toggle" settings and a few other controls. It also allows you to invoke the template editor which can be used to modify your [[../Templates\|message log templates]]		It consists of a list box holding most of the "toggle" settings and a few other controls. It also allows you to invoke the template editor which can be used to modify your [[Plugin:TabSRMM/Templates\|message log templates]]

	<!--T:9-->		<!--T:9-->
Line 60:		Line 60:
	To invoke the local options, you can use any of the following two methods:		To invoke the local options, you can use any of the following two methods:
	* Right click the contact in the contact list and choose Messaging settings. This can be used when no message window is open for that contact.		* Right click the contact in the contact list and choose Messaging settings. This can be used when no message window is open for that contact.
	* When a message window is open, you can also choose {{Menu\|Message log\|Settings}} from the menu bar or by clicking the {{Button\|Message log options}} button on the [[../Toolbar\|toolbar]].		* When a message window is open, you can also choose {{Menu\|Message log\|Settings}} from the menu bar or by clicking the {{Button\|Message log options}} button on the [[Plugin:TabSRMM/Toolbar\|toolbar]].

	<!--T:18-->		<!--T:18-->

Dart Raiden at 20:45, 25 September 2022

2022-09-25T20:45:48Z

← Older revision		Revision as of 23:45, 25 September 2022
Line 50:		Line 50:
	* '''load number of previous events''' – exactly this number (or less, if the total number of messages for this contact is lower than the specified number) of events will be loaded. For performance reasons, this is limited to 100 events.		* '''load number of previous events''' – exactly this number (or less, if the total number of messages for this contact is lower than the specified number) of events will be loaded. For performance reasons, this is limited to 100 events.
	* '''load previous events less than [...] minutes old''' – events which are not older than the specified amount of minutes will be loaded.		* '''load previous events less than [...] minutes old''' – events which are not older than the specified amount of minutes will be loaded.
	* '''always trim message log to [...] events''' – optional and when active, it will remove older messages from the top of the history to keep memory footprint low by limiting the size of the document representing the message history. This setting can also be set "per contact".		* '''always trim message log to [...] events''' – optional and when active, it will remove older messages from the top of the history to keep memory footprint low by limiting the size of the document representing the message history. This setting can also be set per contact.

	== The local options == <!--T:15-->		== The local options == <!--T:15-->

Dart Raiden at 18:02, 25 September 2022

2022-09-25T18:02:21Z

← Older revision		Revision as of 21:02, 25 September 2022
Line 7:		Line 7:
	<!--T:3-->		<!--T:3-->
	TabSRMM allows 2 levels of message log options:		TabSRMM allows 2 levels of message log options:
	* '''global''' – set on {{Menu\|Message sessions\|Message log~~[tab]~~}} and affects the settings for all IM chat sessions.		* '''global''' – set on {{Menu\|Message sessions\|Message log}} and affects the settings for all IM chat sessions.
	* '''local''' – these options can be used to override some or all these settings for a given contact. It is useful if you want to change message log formatting for only some of your contacts (or even only a single contact). These options are implemented with an inheritance system which means they inherit all the global options and override only a few of them with local settings.		* '''local''' – these options can be used to override some or all these settings for a given contact. It is useful if you want to change message log formatting for only some of your contacts (or even only a single contact). These options are implemented with an inheritance system which means they inherit all the global options and override only a few of them with local settings.
	</translate>		</translate>

Dart Raiden: Marked this version for translation

2022-09-25T14:53:43Z

Marked this version for translation

← Older revision		Revision as of 17:53, 25 September 2022
Line 40:		Line 40:
	</translate>		</translate>

	{{TNT\|Note\|<translate>The right value is only used for "right to left" (RTL) messages.</translate>}}		{{TNT\|Note\|<translate><!--T:20--> The right value is only used for "right to left" (RTL) messages.</translate>}}

	<translate>		<translate>

Dart Raiden at 14:53, 25 September 2022

2022-09-25T14:53:38Z

← Older revision		Revision as of 17:53, 25 September 2022
Line 55:		Line 55:

	<!--T:16-->		<!--T:16-->
	Local options allow you to configure the message window for an individual contact. This is however completely optional and if you don't want, you'll never have to touch local (or ~~'''~~per contact~~'''~~) options. There are global defaults for everything and these are inherited and used whenever no local option has been set for any given setting.		Local options allow you to configure the message window for an individual contact. This is however completely optional and if you don't want, you'll never have to touch local (or per contact) options. There are global defaults for everything and these are inherited and used whenever no local option has been set for any given setting.

	<!--T:17-->		<!--T:17-->
	~~'''~~To invoke the local options, you can use any of the following two methods:~~'''~~		To invoke the local options, you can use any of the following two methods:
	* Right click the contact in the contact list and choose Messaging settings. This can be used when no message window is open for that contact.		* Right click the contact in the contact list and choose Messaging settings. This can be used when no message window is open for that contact.
	* When a message window is open, you can also choose {{Menu\|Message log\|Settings}} from the menu bar or by clicking the ~~'''~~Message log options~~'''~~ button on the [[../Toolbar\|toolbar]].		* When a message window is open, you can also choose {{Menu\|Message log\|Settings}} from the menu bar or by clicking the {{Button\|Message log options}} button on the [[../Toolbar\|toolbar]].

	<!--T:18-->		<!--T:18-->

Dart Raiden at 14:52, 25 September 2022

2022-09-25T14:52:44Z

← Older revision		Revision as of 17:52, 25 September 2022
Line 38:		Line 38:
	<!--T:11-->		<!--T:11-->
	They control how much the message body will be indented when using the indent option. The value is in pixels and can be hard to find out, cause it depends on the formatting of your templates and the fonts you are using.		They control how much the message body will be indented when using the indent option. The value is in pixels and can be hard to find out, cause it depends on the formatting of your templates and the fonts you are using.
			</translate>

	<~~!--T:12--~~>		{{TNT\|Note\|<translate>The right value is only used for "right to left" (RTL) messages.</translate>}}
	~~'''Note that the~~ right value is only used for "right to left" (RTL) messages.~~'''~~

			<translate>
	=== Load history events === <!--T:13-->		=== Load history events === <!--T:13-->

Dart Raiden: Marked this version for translation

2022-09-25T14:48:37Z

Marked this version for translation

← Older revision		Revision as of 17:48, 25 September 2022
Line 1:		Line 1:
	<languages/>		<languages/>
	{{TNT\|Note\|<translate>This article applies to the standard message log only. People using {{Plugin\|IEView}} or {{Plugin\|HistoryPP\|History++}} to display the message log in TabSRMM can not use most of these options. Formatting is then controlled by the options of these plugins. It is also important to know that these settings are for standard IM chat sessions only. Group chats are a different thing in Miranda and settings for the layout of group chat rooms are therefore separated.</translate>}}		{{TNT\|Note\|<translate><!--T:1--> This article applies to the standard message log only. People using {{Plugin\|IEView}} or {{Plugin\|HistoryPP\|History++}} to display the message log in TabSRMM can not use most of these options. Formatting is then controlled by the options of these plugins. It is also important to know that these settings are for standard IM chat sessions only. Group chats are a different thing in Miranda and settings for the layout of group chat rooms are therefore separated.</translate>}}

	<translate>		<translate>
	== Basic concepts ==		== Basic concepts == <!--T:2-->

			<!--T:3-->
	TabSRMM allows 2 levels of message log options:		TabSRMM allows 2 levels of message log options:
	* '''global''' – set on {{Menu\|Message sessions\|Message log[tab]}} and affects the settings for all IM chat sessions.		* '''global''' – set on {{Menu\|Message sessions\|Message log[tab]}} and affects the settings for all IM chat sessions.
Line 10:		Line 11:
	</translate>		</translate>

	{{TNT\|Note\|<translate>Message log options do not include font and color settings, but fonts and colors are also fully customizable in TabSRMM. Read about [[../General settings\|themes]].</translate>}}		{{TNT\|Note\|<translate><!--T:4--> Message log options do not include font and color settings, but fonts and colors are also fully customizable in TabSRMM. Read about [[../General settings\|themes]].</translate>}}

	<translate>		<translate>
	== The global options ==		== The global options == <!--T:5-->
	</translate>		</translate>

	[[File:TabSRMM message log option.png\|400px\|thumb\|<translate>The global message log option page</translate>]]		[[File:TabSRMM message log option.png\|400px\|thumb\|<translate><!--T:6--> The global message log option page</translate>]]
	<translate>		<translate>
			<!--T:7-->
	You can reach the global message log option page from Miranda main option screen by selecting Message sessions and then navigating to the Message log tab. The screenshot on the right illustrates where to find this option page.		You can reach the global message log option page from Miranda main option screen by selecting Message sessions and then navigating to the Message log tab. The screenshot on the right illustrates where to find this option page.

			<!--T:8-->
	It consists of a list box holding most of the "toggle" settings and a few other controls. It also allows you to invoke the template editor which can be used to modify your [[../Templates\|message log templates]]		It consists of a list box holding most of the "toggle" settings and a few other controls. It also allows you to invoke the template editor which can be used to modify your [[../Templates\|message log templates]]

			<!--T:9-->
	The list box is divided into logical groups to make it easier finding the wanted settings. Right now, there are six groups:		The list box is divided into logical groups to make it easier finding the wanted settings. Right now, there are six groups:
	* '''Message log appearance''' – holds options to control the format of the message log.		* '''Message log appearance''' – holds options to control the format of the message log.
Line 30:		Line 34:
	* '''Message log icons''' – how and if the icons should be used.		* '''Message log icons''' – how and if the icons should be used.

	=== Indent values ===		=== Indent values === <!--T:10-->

			<!--T:11-->
	They control how much the message body will be indented when using the indent option. The value is in pixels and can be hard to find out, cause it depends on the formatting of your templates and the fonts you are using.		They control how much the message body will be indented when using the indent option. The value is in pixels and can be hard to find out, cause it depends on the formatting of your templates and the fonts you are using.

			<!--T:12-->
	'''Note that the right value is only used for "right to left" (RTL) messages.'''		'''Note that the right value is only used for "right to left" (RTL) messages.'''

	=== Load history events ===		=== Load history events === <!--T:13-->

			<!--T:14-->
	This setting controls how TabSRMM loads existing message events into the message history when you open a new session. The following options are possible:		This setting controls how TabSRMM loads existing message events into the message history when you open a new session. The following options are possible:
	* '''load unread events only''' – new messages which were not read before are loaded only. If no such event exists, the message history will be empty.		* '''load unread events only''' – new messages which were not read before are loaded only. If no such event exists, the message history will be empty.
Line 44:		Line 51:
	* '''always trim message log to [...] events''' – optional and when active, it will remove older messages from the top of the history to keep memory footprint low by limiting the size of the document representing the message history. This setting can also be set "per contact".		* '''always trim message log to [...] events''' – optional and when active, it will remove older messages from the top of the history to keep memory footprint low by limiting the size of the document representing the message history. This setting can also be set "per contact".

	== The local options ==		== The local options == <!--T:15-->

			<!--T:16-->
	Local options allow you to configure the message window for an individual contact. This is however completely optional and if you don't want, you'll never have to touch local (or '''per contact''') options. There are global defaults for everything and these are inherited and used whenever no local option has been set for any given setting.		Local options allow you to configure the message window for an individual contact. This is however completely optional and if you don't want, you'll never have to touch local (or '''per contact''') options. There are global defaults for everything and these are inherited and used whenever no local option has been set for any given setting.

			<!--T:17-->
	'''To invoke the local options, you can use any of the following two methods:'''		'''To invoke the local options, you can use any of the following two methods:'''
	* Right click the contact in the contact list and choose Messaging settings. This can be used when no message window is open for that contact.		* Right click the contact in the contact list and choose Messaging settings. This can be used when no message window is open for that contact.
	* When a message window is open, you can also choose {{Menu\|Message log\|Settings}} from the menu bar or by clicking the '''Message log options''' button on the [[../Toolbar\|toolbar]].		* When a message window is open, you can also choose {{Menu\|Message log\|Settings}} from the menu bar or by clicking the '''Message log options''' button on the [[../Toolbar\|toolbar]].

			<!--T:18-->
	This will open a new dialog with two tabbed pages. The first page (''General'') has some generic options to configure the message window layout and functionality. The second page (''Message Log'') holds the settings to configure the message log layout. The items on the second page may be disabled whenever an external message log viewer (IEView or History++) has is active, either globally or for the specific contact only.		This will open a new dialog with two tabbed pages. The first page (''General'') has some generic options to configure the message window layout and functionality. The second page (''Message Log'') holds the settings to configure the message log layout. The items on the second page may be disabled whenever an external message log viewer (IEView or History++) has is active, either globally or for the specific contact only.

			<!--T:19-->
	It should be said, that all local options are implemented as "override" settings. Each setting can be configured individually so you can decide to only set a few options locally and continue to use the global options for the remaining settings. Consequently, each local setting has a "default" value and this is inherited from the global set of options.		It should be said, that all local options are implemented as "override" settings. Each setting can be configured individually so you can decide to only set a few options locally and continue to use the global options for the remaining settings. Consequently, each local setting has a "default" value and this is inherited from the global set of options.
	</translate>		</translate>

	[[Category:Tutorials]]		[[Category:Tutorials]]

Dart Raiden: Created page with " {{TNT|Note|This article applies to the standard message log only. People using {{Plugin|IEView}} or {{Plugin|HistoryPP|History++}} to display the message log in TabSRMM can not use most of these options. Formatting is then controlled by the options of these plugins. It is also important to know that these settings are for standard IM chat sessions only. Group chats are a different thing in Miranda and settings for the layout of group chat rooms ar..."

2022-09-25T14:48:32Z

Created page with "<languages/> {{TNT|Note|<translate>This article applies to the standard message log only. People using {{Plugin|IEView}} or {{Plugin|HistoryPP|History++}} to display the message log in TabSRMM can not use most of these options. Formatting is then controlled by the options of these plugins. It is also important to know that these settings are for standard IM chat sessions only. Group chats are a different thing in Miranda and settings for the layout of group chat rooms ar..."

New page

<languages/>
{{TNT|Note|<translate>This article applies to the standard message log only. People using {{Plugin|IEView}} or {{Plugin|HistoryPP|History++}} to display the message log in TabSRMM can not use most of these options. Formatting is then controlled by the options of these plugins. It is also important to know that these settings are for standard IM chat sessions only. Group chats are a different thing in Miranda and settings for the layout of group chat rooms are therefore separated.</translate>}}

<translate>
== Basic concepts ==

TabSRMM allows 2 levels of message log options:
* '''global''' – set on {{Menu|Message sessions|Message log[tab]}} and affects the settings for all IM chat sessions.
* '''local''' – these options can be used to override some or all these settings for a given contact. It is useful if you want to change message log formatting for only some of your contacts (or even only a single contact). These options are implemented with an inheritance system which means they inherit all the global options and override only a few of them with local settings.
</translate>

{{TNT|Note|<translate>Message log options do not include font and color settings, but fonts and colors are also fully customizable in TabSRMM. Read about [[../General settings|themes]].</translate>}}

<translate>
== The global options ==
</translate>

[[File:TabSRMM message log option.png|400px|thumb|<translate>The global message log option page</translate>]]
<translate>
You can reach the global message log option page from Miranda main option screen by selecting Message sessions and then navigating to the Message log tab. The screenshot on the right illustrates where to find this option page.

It consists of a list box holding most of the "toggle" settings and a few other controls. It also allows you to invoke the template editor which can be used to modify your [[../Templates|message log templates]]

The list box is divided into logical groups to make it easier finding the wanted settings. Right now, there are six groups:
* '''Message log appearance''' – holds options to control the format of the message log.
* '''Support for external plugins''' – this node can be empty, but in some cases, when supported plugins are installed and detected, it will list settings to control them.
* '''Other options''' – message not directly related to the look and feel of the message history
* '''Events to show''' – lets you specify if you want to show additional non-message events like file transfers or URL messages.
* '''Timestamp settings''' – gives you control over the formatting of message timestamps. Please note that this also depends on the format of your templates.
* '''Message log icons''' – how and if the icons should be used.

=== Indent values ===

They control how much the message body will be indented when using the indent option. The value is in pixels and can be hard to find out, cause it depends on the formatting of your templates and the fonts you are using.

'''Note that the right value is only used for "right to left" (RTL) messages.'''

=== Load history events ===

This setting controls how TabSRMM loads existing message events into the message history when you open a new session. The following options are possible:
* '''load unread events only''' – new messages which were not read before are loaded only. If no such event exists, the message history will be empty.
* '''load number of previous events''' – exactly this number (or less, if the total number of messages for this contact is lower than the specified number) of events will be loaded. For performance reasons, this is limited to 100 events.
* '''load previous events less than [...] minutes old''' – events which are not older than the specified amount of minutes will be loaded.
* '''always trim message log to [...] events''' – optional and when active, it will remove older messages from the top of the history to keep memory footprint low by limiting the size of the document representing the message history. This setting can also be set "per contact".

== The local options ==

Local options allow you to configure the message window for an individual contact. This is however completely optional and if you don't want, you'll never have to touch local (or '''per contact''') options. There are global defaults for everything and these are inherited and used whenever no local option has been set for any given setting.

'''To invoke the local options, you can use any of the following two methods:'''
* Right click the contact in the contact list and choose Messaging settings. This can be used when no message window is open for that contact.
* When a message window is open, you can also choose {{Menu|Message log|Settings}} from the menu bar or by clicking the '''Message log options''' button on the [[../Toolbar|toolbar]].

This will open a new dialog with two tabbed pages. The first page (''General'') has some generic options to configure the message window layout and functionality. The second page (''Message Log'') holds the settings to configure the message log layout. The items on the second page may be disabled whenever an external message log viewer (IEView or History++) has is active, either globally or for the specific contact only.

It should be said, that all local options are implemented as "override" settings. Each setting can be configured individually so you can decide to only set a few options locally and continue to use the global options for the remaining settings. Consequently, each local setting has a "default" value and this is inherited from the global set of options.
</translate>

[[Category:Tutorials]]