Beardric's Promotomatic Wondertron

1. What Is It?
   
2. What Does It Do?
   
3. Options
   
4. Slash Commands
   
5. Localization Notes
   

1. What Is It?
   This addon has two purposes. It allows you to easily promote guild members to a specified rank and then demote them to their original rank. It also provides a one-click button for inviting your group members
   
   
2. What Does It Do?
   Defending the Faith (US Uther) provides guild repairs for learning new encounters. In order to turn on this option, we promote each group member to a special rank called "Bought the Farm". After the raid, we demote people to their original rank. There are two difficulties with this. First, it is annoying to \gpromote many people at once. Secondly, we have to remember everyone's original rank. The Promotomatic Wonder solves both these issues. The Promote Button will promote all group members in your guild to a rank you specify. This also activates the Demote Button, which will demote every guild member to their original rank (even if they are no longer in your group.) The Promotomatic Wondertron will even remind you to demote people if you forget!
   
   As if the promote and demote buttons weren't enough. The Promotomatic Wondertron also features an Invite button and Disband Button. When you press the Invite Button, it will look for a calendar event with a starting time close to the current time. If it finds one, it invites those who accepted that event. If it doesn't find an event, then it invites all max level characters in your guild. The disband button provides a one-click way to remove everyone from your group. This feature is mostly for disbanding raids, in case people forget to leave. Who hasn't logged in the morning after a raid and wondered why their quests are taking so long? The disband button also works for parties of course.
   There are slash commands to click each button from the chat window too!
   
   
3. Options
   

• Invite Delay: The Promotomatic Wondertron will warn people before it invites them so that they have adequate time to leave their current group and accept your invite. You can set the delay time between 1 and 999 seconds.
  
• Demote Delay: The Promotomatic Wondertron will warn people before it demotes them as a reminder to repair their armor before they lose their guild repair option. You can set the warning time between 1 and 999 seconds.
  
• Reminder Delay: If you are not in a group, but you have promotions active, the Promotomatic Wondertron will think that you forgot to demote your group members. It will keep bugging - ahem reminding - you until activate the Demote Button. You can tell the Promotomatic Wondertron how often to remind you, between 1 and 999 minutes.
  
• Lower Offset & Upper Offset: When you active the Invite Button on your Promotomatic Wondertron, it will begin searching for calendar events that have a scheduled time close to the current time. The Lower Offset tells the Promotomatic Wondertron how many minutes prior to the current time it should begin its search. Conversely, the Upper Offset is how many minutes *after* the current time it should stop looking. If the Promotomatic Wondertron finds no events in that time frame, it enters Guild Invite mode, inviting all maximum level characters in the guild to group with you. The Offsets can be set between 1 and 999 minutes.
  
  

1. Slash Commands
   

• /pwshow: Turn on the Promotomatic Wondertron display.
• /pwinvite : Activate the Invite Button
• /pwdisband: Activate the Disband Button
• /pwpromote: Activate the Promote Button
• /pwdemote : Activate the Demote Button
  
  

1. Localization Notes
   You can customize the Promotomatic Wondertron's messages by editing the localization file for your region. For US players, this is the "Locale-en-US.lua" file inside the Interface\AddOns\Promotomatic sub-folder of your WoW directory. You can also use this file to customize the reminder sound.