RaidSummon 2.1

What is it?

RaidSummon will queue group/raidmembers that request to be summoned (by whispering you a specific keyword) and notify the warlock with an audio signal and a text message.
Casting "Ritual of Summoning" will then summon the first player in the queue and - if the ritual succeeded (RaidSummon detects failures) - remove him from the list. Casting again will summon the next player and so on.
Additionally, using the "Ritual of Summoning" action while targetting a raid/group-member will perform a normal ritual of summoning on him - preferring the target over already queued raid/group-members.
It is also possible to automatically summon all raidmembers that are not currently in your zone by using the button when nobody is queued or targetted.

TitanPanel: Getting started

If you use TitanPanel, enable the RaidSummon plugin from the panel-options. (Simply enabling the TitanRaidSummon addon in WoWs addon list is not enough.)
The plugin features should be self explanatory.

How to use it

• Target a group or raid member and use "Ritual of Summoning" as usual to summon your target. If the summoning failed (i.e. someone moved while assisting in the ritual), the player will remain queued and you will be alerted by an audio signal.
• Have somebody of your raid/group whisper you with "summon" to queue the player for summoning. You will be notified* about the request and can now summon this player by using the "Ritual of Summoning" action with no player targetted.
• Notification by an audio signal and textmessage. Your "Ritual of Summoning" actionbutton will also list all queued players in its tooltip. If you use TitanPanel, TitanRaidSummon will indicate the name of the first player in queue and, if enabled, flash red/yellow.
• Cast "Ritual of Summoning" when nobody is targetted and the summon queue is empty to summon all members of the raid that are not currently in your zone.
• Right-click the "Ritual of Summoning" action to display a menu with a few of the more important RaidSummon options.

Commandline features

Most of these features/options are also available from the actionbutton-menu, but if you need to check your summoning statistics or define new request-keywords, this is the place to look for it.

Installation/Setup-Options:

• /rsm lang <de|en|fr> (also available from actionbutton-menu)
  Select message-language. This language will be used when RaidSummon needs to /tell a player or send a message to the raid (if enabled). By default, when using English, RaidSummon will listen for players whispering you the word "summon", "port" for German and "invocation" for French. Short requests will be prevented from getting displayed in the chatframe, requests that are longer than a few words will not be processed automatically, as they might contain other important information for the warlock. (I.e. "please summon me for hot elven action" will be displayed.)
  Default: When using the addon for the first time, this will be set to your clients locale.
  
• /rsm minimum <i> (also available from actionbutton-menu)
  Sets the minimum number of shards. If the warlock has less shards than specified, summoning requests will be declined (of course you can still target players and summon them as usual).
  Default: 7
  
• /rsm resetkeywords
  Wipes the list of known keywords. These keywords will be used to determine wheter a whisper is a summoning request or not. No summoning requests can be processed until at least one keyword has been added to the list.
  Default: if the addon loads and no keyword is defined (ie. first load or list wipe and no keyword defined before exit), valid keywords will be "summon", "port" and "invocation".
  
• /rsm addkeyword <keyword>
  Adds a keyword to the list of keywords that trigger a summoning request (keywords may contain spaces)
  Default: "summon", "port", "invocation"
  
• /rsm toggleannounce or /rsm ta (also available from actionbutton-menu)
  Enable or disable summoning messages. If enabled, a message will be sent to your raid/group when you are about to summon somebody, when the actual ritual of summoning begins (requesting players to assist) and when(if) the ritual fails.
  Default: enabled
  
• /rsm togglewhisper or /rsm tw (also available from actionbutton-menu)
  Enable or disable whispers to players. These whispers are not visible from your local chatframe and only serve to inform the player that his summoning request was received and you are about to summon/out of shards and won't summon/afk etc.
  Default: enabled
  
• /rsm togglelisten or /rsm tl (also available from actionbutton-menu)
  Enable or disable request processing. If disabled, raid/group-members will no longer be able to request summons with a simple whisper, but of course you will still be able to target and summon them as usual.
  Default: enabled
  
• /rsm toggleenable or /rsm te
  Enable or disable RaidSummon. If disabled, RaidSummon will no longer monitor your "Ritual of Summoning" casts for success, record any stats, listen for summon requests, queue players or offer the improved "Ritual of Summoning" action. Addons like TitanRaidSummon will still be able to use all RaidSummon features, but won't be notified if a player requests to be summoned.
  
• /rsm togglehidereplies or /rsm thp (also available from actionbutton-menu)
  Show or hide RaidSummons' replies to players requesting summons in the ChatFrame. Note: To enable/disable these message use /rsm tw. This option merely hides the messages from your own chatframe.
  Default: enabled
  
• /rsm togglehiderequests or /rsm thq (also available from actionbutton-menu)
  Show or hide accepted summoning request messages from other players. If enabled, accepted summoning requests will not be displayed in the chatframe. Note: Only requests that were automatically accepted will be hidden. In order for RaidSummon to automatically accept a request, it has to be very brief and contain at least one of the specified keywords (see /rsm addkeyword).
  Default: disabled
  
• /rsm status
  Displays current RaidSummon settings.

Support commands:

• /rsm skip (also available from actionbutton-menu)
  Skips first player in queue without summoning him. The player will be notified by a short message.
• /rsm announce (also available from actionbutton-menu)
  Tells your raid/groupmembers how to get a summon.
  
• /rsm list (also available from actionbutton-menu)
  List all players currently queued for summoning.
• /rsm clear (also available from actionbutton-menu)
  Removes everybody from your queue.
  
• /rsm stats <num>
  Shows total amount of summons as well as the names of the players you summoned. Unless <num> is specified, the top ten summoned players will be listed.
• /rsm raidstats <num>
  As above, but only lists those players that are also currently in your raid or group.
• /rsm postraidstats <num>
  As above, but posts results to raid/group channel.
• /rsm resetstats
  Resets your stats.