GuildGreet Extended

GreetList

Alternate download link
As Curse has been very unstable for downloads lately, I have set up an alternate download page carrying the latest version of my addons. You can find it under http://www.ursbeeli.ch/m_addons.shtml

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 (http://wow-en.curse-gaming.com/downloads/details/2113/guildgreet/, <file type="link">2113</file>) 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 (http://wow-en.curse-gaming.com/downloads/details/5485/guild-greet-2-0-3/, <file type="link">5485</file>).

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

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 list

• Use /who interface to get details for channel names
• allow time dependent greetings similar to goodbye feature (suggested by Balsta) [not likely to be implemented in the near 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]
• 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)
• 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 a "fader time" after which old entries are removed from the greet list (suggested by ImmortalDragon2)
• toggle addon on/off (suggested by ImmortalDragon2) [already partially implemented]
• add automatic main-alt detection based on special guild rank (suggested by Kortanis)
• add support to monitor multiple channels (suggested by Epophis)
• auto-assignment without the need for the [main] tag (suggested by Kobihunt)
• add more flexible replacement codes for the greetings such as <guild rank>, <character name> and <level> instead of %s (suggested by AcmeHeroesInc)
• The no grats on login function doesn't seem to be working properly. Even with the box checked in the options I still have folks that login and before I can click it to greet them it changes to grats. Then I am saying grats for them making a level they may have made a week ago... very confusing to them. (reported by Twidget_7243)
• let the user decide whether to use the "public" channel or whisper for each event instead of globally (suggrested by nighttar)

Important hint
In the interface options (advanced options) there is a setting in the Chat 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.

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 http://www.auctioneeraddon.com/dl/ you should get all this information. If you don't have it, just provide what you can get.

Furthermore, to make it easier for me to reproduce the error, please follow the steps below:

1. delete your saved variable guildgreet.lua file again
2. delete your interface/addon/guildgreet folder
3. redownload and reinstall GuildGreet 20103.9 from curse
4. start WoW and try to reproduce the error
5. list every single step/click you do from the moment you are logged in until the error occurs (maybe, also tell me what you are not doing, i.e. which fields you leave along)

Also, I might tell you to enable GuildGreetDump temporarily and then send me the C:\Programme\World of Warcraft\WTF\Account\<accountname>\SavedVariables\GuildGreetDump.lua file so I can look at some special debug output that I may put into certain versions of the addon. Do not enable debugging to GuildGreetDump unless told to do so by me, as it will create a huge data file if you let it run for a long time.

20400.4

• finally fixed the "no grats on login" function (reported by Twidget_2743, suggestion on how to fix by Martin)