With this plugin, you can instruct IRCmagic to send special greet and part messages to people who enter (join) or leave (part) channels you are in. You can also tell it to play any system-7 sound file when a person joins or parts a channel you are in. You can even have it speak any phrase (using Mac OS Text-to-Speech) when someone joins or parts. You can create nickname-specific greets, channel-specific greets, use the default greeting, or a combination of all of these.
How AutoGreet Works
When someone joins or parts from a channel you are in, the AutoGreet plugin scans your greets for one matching that persons nickname. If none is found, the AutoGreet plugin scans the settings for one matching the channel name. If none is found, the AutoGreet plugin uses the Default greeting (if the Default greet is enabled).
This mechanism allows you to have a default greeting for everyone, and override the default greeting for a particular channel, and override the channel greeting for a particular nickname.
To enable or disable this feature, type the following into any Ircle window, or click the Settings button on the IRCmagic Main Window.
/autogreet on
/autogreet off
To change AutoGreet settings, type the following into any Ircle widow, or click the appropriate button on the IRCmagic Main Window.
/autogreet
IRCmagic displays the following window:
The Nicknames / Channels scrolling list contains all of the greets that the AutoGreet plugin knows about. Assuming you follow the convention of prepending the # character to channel names, channel greets are listed at the top of the list, and nickname greets are listed after channels. Enabled greets have a check mark next to them. Disabled greets do not have a check mark next to them.
To add a greet to the list, click the Add button.
To edit an existing greet, hilite the greet you want to edit by clicking it in the list, then click the Edit button.
To remove a greet, hilite the greet you want to remove by clicking it in the list, then click the Delete button.
Deleting a greet permanently removes it from the list. In most cases, you will probably want to disable the greet rather than delete it.
To enable a greet, select the greet you want to enable by clicking it in the list, then click the Enable button. IRCmagic enables the greet and displays a check mark next to it in the list.
To disable a greet, select the greet you want to disable by clicking it in the list, then click the Disable button. IRCmagic disables the greet and removes the check mark next to it in the list.
When either the Add or Edit button is clicked, the following window is displayed, allowing you to edit the settings for the greet:
The Enabled checkbox indicates whether this greet is enabled or disabled. If the greet is disabled, the AutoGreet plugin will not use it.
The Greet Filename field contains the name of the greet. This name does not necessarily have to contain the nickname (or mask) for the target nickname or channel. This contents of this edit field are used to name the greet file and to show the greet in the scrolling list in the AutoGreet Setup window.
The text in the Nick / Channel / Mask field is used to match nicknames, channels, or masks when people join or part to determine whether the greet should be used. Depending on the type of greet you are creating, you can specify a nickname, a channel name, or a mask.
Channel names must start with the "#" character in order for AutoGreet to treat them as a channel name. Masks must contain a valid user mask in the form of "nickname!username@hostname". You may use the wildcard character (*) in masks.
Join Settings
The Type edit field contains the message that is displayed when someone joins a channel you are in.
The Speak edit field may contain any text you wish to be spoken (using Mac OS Text to Speech). Use the Speech control panel to change your speech settings. The edit field may contain custom message tags. For more information on custom message tags, see Custom Messages. Use the Try button to listen to the message.
The Sound: area holds a sound that is played when this greet is used. Click the Set button to choose a sound. Click the Clear button to remove a sound.
Part Settings
The Type edit field contains the message that is displayed when someone parts a channel you are in.
The Speak edit field may contain any text you wish to be spoken (using Mac OS Text to Speech). Use the Speech control panel to change your speech settings. The edit field may contain custom message tags. For more information on custom message tags, see How Custom Messages Work. Use the Try button to listen to the message.
The Sound: area holds a sound that is played when this greet is used. Click the Set button to choose a sound. Click the Clear button to remove a sound.
Sounds must be standard Macintosh "System 7" sounds, and are played locally on your machine.