Plugin:TabSRMM/Configure history

From Miranda NG
Jump to navigation Jump to search
Other languages:
This article applies to the standard message log only. People using IEView or 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.

Basic concepts

TabSRMM allows 2 levels of message log options:

  • global – set on 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.
Message log options do not include font and color settings, but fonts and colors are also fully customizable in TabSRMM. Read about themes.

The global options

The global message log 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.

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 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.

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 Message log → Settings from the menu bar or by clicking the Message log options button on the 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.