GuildGreet

I disabled Comments on Curse.com. Please leave your comment on curseforge.com.

Why I won't add auto-greeting

It seems that this question will be asked again and again no matter in how many places I say no, so I'll try to put this at the top of the page and make it nice and big so it can't be missed...

I will not add auto-greeting functionality. Not ever. Full stop. If one mouse click is too much work for you to say hi to your friends, why even bother talking to them... This addon is here to make sure you do not miss important events, not to automate interaction with other people.

So please, stop asking for auto greeting.

End of rant

Alternate download link
Just in case Curse has load issues (as occasionally happens on patch day) I have set up an alternate download page carrying the latest version of my addons. You can find it under http://code.google.com/p/guildgreet/downloads/list

Description
Guild Greet is an addon that keeps track of main and alt characters in your guild and reminds you to greet them and congratulate them on level up. You can also store an alias for your guildies.

Credit
This addon was originally written by Greya and I helped him with some of the German localisation. Greya did not seem to update GuildGreet for the pre-BC LUA changes. This was done by Mordikaiin and Rozak.

I had already made some modifications to Greya's version but never published them. I sent Mordikaiin a message suggesting he integrate those in a new release but never heard from him. This is the reason why I am creating this branch of GuildGreet

Extension
I loved the main and alt management features of the original GuildGreet. I extended it to print a list of the main and all alt chars whenever a guildie logged in. This helped me to learn who was who in my guild.

A typical login line would look like the following:

[Urbin] has come online.
GuildGreet: [Urbin: Hunter, 70] Sunh Mymule Juran

Later I extended this feature to allow me to query a certain guild member through the command line (/gg <name>), to print a list of the alts of all members of the guild (/gg guild all) or only those online (/gg guild show).

If you change your guild or your guild needs to reform for some reason, GuildGreet unfortunately looses all its main-alt associations. To help you rebuild the database I added the possibility to print all information to a list from which you can copy-past the information (/gg guild list)

Later I added a keybinding to bring up the GuildGreet configuration dialog (/gg) and the possibility to use the context menu on player names in the chat frame to print the main and alias list for that player.

I also added two greetings (or better goodbyes) for players leaving during the day and a night which can be accesses through the player menu in the chat frame as well.

Friend list support
I have added support for your friends. It works just the same as the guild member features.

User channel support
Many guilds that have co-operations with other guilds have a common user channel. I added support for such a channel to 20100.4, you can enable this in the "General" tab and define the channel name to use. You must join the channel before you can enter it in the configuration. The channel members (except for guild members) will be managed in a separate list and their own tab.

Automatic assignment of main/alt chars based on guild notes
This is a feature requested by Dhugal

If this feature is enabled (checkbox on general tab) *AND* no manual main/alt information has yet been added, then the guild note will be parsed.

The following keywords will be understood:

Main[ <any other text>]
It is important to note that if <any other text> follows, there must be a space after the "Main" keyword. Any other text will be discarded. --> this marks the character with this guild note as a "main" char

alt-<main name>[ <any other text>]
It is important to note that if <any other text> follows, there must be a space after the <main name>. Any other text will be discarded. --> this marks the character with this guild note as an "alt" char to the indicated "main" char

Achievment support
This is a much requested feature and I have finally found the time to add it. GuildGreet will now help you to congratulate your guild mates when the get an achievment. It works just the same as all the other greetings/congratulations.

Marking all guild members as "not new"
When joining a new guild or when first installing GuildGreet while already in a guild, all guild members will be marked as new until they have been greeted once. This is correct if somebody joins a guild you are already a member of, but not all that great in the situation described above. Unfortunately, there is no way for GuildGreet to tell the difference.
There is however a way to get rid of this by typing

/gg unnew

Summary of original features
This part is copied 1:1 from the original GuildGreet page and was written by Greya

This is a guild tool: it's useless if you are not in a guild

As soon as you go online, the addon loads the list of players in your guild and starts to monitor all changes. As soon as a player comes online or joins the guild, the name is added to a small list onscreen.

If you leftclick on the name, one of the possible greetings (at random) is written in the guild channel and the name is removed from the list. if you rightclick on the name, it's removed from the list without sending a greeting. These color codes are used for the list:

• red: players joining the guild both during your session and earlier. These players will also be indicated by the word NEW at the end of the line.
  
• orange: players logging in for the first time during your current session
  
• green: players relogging. They logged on before during your current session
  
• blue: players gaining a higher level both during your session and then earlier. These players will also be indicated by the word LEVEL at the end of the line.
  
• purple: players getting a higher guildrank then previous session and earlier. These players will also be indicated by the word RANK at the end of the line.
  

Notes:

• the list shown on the screen can be dragged anywhere you want by using the red titlebar to drag.
  
• the onscreen list shows a maximum of 5 players by default, but GuildGreet will store the names of any further players needing a greeting.
  
• mousing over the names in the list will display a tooltip with usefull information regarding the player
  

For detailed information on changing the configuration (like greeting texts), see the file manual.txt

Greeting guild and channel members
This feature was requested by Yongpeng

There are two key bindings that can be used to send a greeting to your guild chat and your selected channel and to say goodbye to the two channels. You can also greet selectively using slash commands. You can configure a guild name alias which can be used in the guild greetings instead of the full guild name.

Temporarily supressing certain greetings
This feature was requested by Oakayam

If a category (log-in, relog, joining of guild, level up, guild rank promotion) has no greetings defined, a character will not be placed in the greet list upon a corresponding event.
However, you might want to supress a certain category without deleting all its greetings. This is now possible as you can supress the corresponding events for each category (meaning a player who levels up will not be placed in the greet list if the level-up category is being suppressed)

Todo and request list
[will not implement]

• prepend main name in chat in main-class-colour (suggested by nimisha) [will not implement, as it does not make sense]
• I will not add auto-greeting, even though it has been requested by many. If you are too lazy to click the mouse to greet your friends, what is that greeting worth...

[unlikely to be implemented in the future]

• add smart main name matching algorithm when automatically building main-alt relations (suggested by Kortanis) [not likely to be implemented in the near future]
• fubar/titan plugin instead of GreetList (suggested by Kobihunt) [not likely to be implemented in the near future]
• Synch between officers (suggested by Kobihunt) [not likely to be implemented in the near future]
• add auto-assignment notes to guild/officer notes (suggested by Kobihunt) [not likely to be implemented in the near future]
• add guild roster support (suggested by Kobihunt) [not likely to be implemented in the near future]
• add an invisible character to the end of each message, so people can filter them to stop clutter in their chat frame (" " (alt-255) or " " (alt-0160)) (suggested by Natronx77) [not likely to be implemented in the near future]
• add a "fader time" after which old entries are removed from the greet list (suggested by ImmortalDragon2) [not likely to be implemented in the near future]
• toggle addon on/off (suggested by ImmortalDragon2) [already partially implemented]
• add automatic main-alt detection based on special guild rank (suggested by Kortanis) [not likely to be implemented in the near future]
• add support to monitor multiple channels (suggested by Epophis) [not likely to be implemented in the near future]
• auto-assignment without the need for the [main] tag (suggested by Kobihunt) [not likely to be implemented in the near future]
• let the user decide whether to use the "public" channel or whisper for each event instead of globally (suggrested by nighttar) [not likely to be implemented in the near future]
• support "alt - <name>" as well (suggested by mdsandler) [not likely to be implemented in the near future]
• allow for more than 500 guild members (reported by Dima_todd) [probably a Blizzard limitation; not likely to be implemented in the near future; besides I couldn't test this]
• I suggest adding the option of sending "greetings" via /tells, and "congratulations" via 'g'chat (suggested by techsgtchen) [not likely to be implemented in the near future]

[under consideration]

• some people get erratic greetings if they have a guild member in the friends list (reported by Oakayam, jrc3 but could so far not reproduce)
• people that are in GLDG_DataChannel from an old channel being monitored are still detected coming online when a new channel has been chosen (reported by Epophis)
• add option to not congratulate alts (suggested by Thomas Richter)
• detect player leaving guild, to avoid spamming "you are not in a guild" (reported by felorah)

[planned]

• remove colour sets (just one colour for guild, friends and channel

Important hint
In the interface options (Game options) there is a setting in the Social section called Guild member alert. Make sure that this features is enabled as GuildGreet will not detect guild members coming online or going offline if this is disabled. GuildGreet will warn you once if this is disabled and suggest to turn it on. If you don't do it then, you can still manually check this by using /gg alert.

REPORTING ERRORS
If you encounter errors, please report them by including the following information:

• the file name and line number where the error ocurred
• the function name in which the error ocurred
• the exact error message
• the call stack of the functions

Some of this information is not available using the default Blizzard error frame but if you use an addon like Swatter from Auctioneer you should get all this information. If you don't have it, just provide what you can get.