Quantcast
Download
(22 Kb)
Download
Updated: 09/22/22 03:34 PM
Pictures
File Info
Compatibility:
Firesong (8.2.0)
Updated:09/22/22 03:34 PM
Created:05/27/20 03:27 PM
Monthly downloads:271
Total downloads:4,815
Favorites:6
MD5:
Auto Ranks  Updated this week!
Version: 2.5.3
by: peniku8 [More]
Auto Ranks:

A must have for every trade guild admin:
Auto Ranks does exactly what its name suggests: it automatically allocates guild member ranks depending on the players' sales and/or donations. Okay, it's semi-auto, you have to trigger it manually (button in the settings or via hotkey). Highly customizable.



Shissu's Guild Tools is no longer needed to run this addon and you can delete all Shissu addons if you like. ShissuHistoryScanner will be included and installed with Auto Ranks from now on.


Main functions:
- Promote and or demote guild members based on their MM or ATT sales
- Promote and or demote guild members based on their donations (requires Shissu's History Manager)
- Promote new members to the next rank after a set amount of days
- Send automated mails on certain actions
- Process all of your guilds at once with different settings for each
- Preset manager: Create unlimited settings presets (names are compatible with colour codes)

Features:
Rank allocation:
- Independently customizable time frames for sales and donations
- Automatically excludes ranks and members with administrative guild permissions
- Option to exclude members with a note on their name
- Option to specify a keyword to search for in the note
- Chat notifications for every action (optional)
- New member rank option: don't demote anybody back to the lowest rank in the guild
- Permanent rank: option to not demote anybody FROM the highest non administrative rank in your guild
- Track last donation: calculates a "this week" donation from the last donation in the logs
(- The current week donation will be calculated with the foruma: 7/DaysAgo * donation; Example: 20k donation 14 days ago->current donation=10k)
- Demotion limit: Specify an upper limit for how many ranks you want to demote a member at once

Message settings:
- Two messages can be configured for scenario LowestRank->2ndLowest and AnyRank->2ndLowest
- Include keywords to insert the recipient's actual sales and donation stats into the message
- Auto Ranks will display a list of players that couldn't be contacted, if sending a mail fails
- Note: message text and settings are not part of presets

Addon Behaviour:
- When both MM and ATT are active, MM stats are prefered. When neither is, an error message is shown.
- When a new preset is created, it is automatically loaded as well
- When a preset is loaded, changes will save automatically to the active preset
- When a preset is deleted, the first preset in the list will be loaded
- The addon handles one rank change every two seconds
- The sales and donation stats added to the messages will be in the respective time frames for the rank options

- More info on how to fill in the numbers is given via tooltips
- You need to reload your UI to update the message previews (limitation of libAddonMenu)
- Pictures here show how I have it set up for my guild Pact Veteran Trade as guideline
- I'd advise to reset your addon settings when you change your ranking structure, the order of your guilds or the language of your client.

Dependencies:
-LibAddonMenu-2.0
-Master Merchant (3.6 or higher) or Arkadius' Trade Tools
-ShissuHistoryScanner (Integrated into this addon)
If you're having issues with the addon, delete "ShissuHistoryScanner" from your addon folder or uninstall Shissu's Guild Tools.
2.5.3
-API bump

2.5.2
-API bump

2.5.1
-API bump

2.5
-Integrated ShissuHistoryScanner into the addon, which means:
-you can delete all Shissu addons from your addon folder if you like or
-uninstall Shissu Guild Tools from Minion
-you can keep using SGT if you so desire, it shouldn't cause any issues

2.4.14
-Added support for Master Merchant 3.6

2.4.13
-API bump

2.4.12
-Added a summary after sending out mails, which shows players that ignore you or have a full inbox

2.4.11
-Minor tweaks for the new Automate integration

2.4.10
-Added a callback manager event "AutoRanksDone" for smoother integration with other addons

2.4.9
-API bump

2.4.8
-Added the "Demotion Limit" option, which makes it possible to limit the number of demotions a single member can get at once
-Added a refresh routine for presets. Presets need to be re-written when there is a new option added to AutoRanks, which requires reloading the UI once, when a preset is loaded the first time after the AR update was installed
-Regrouped some settings in a new submenu

2.4.7
-Added the function to specify a keyword for the 'Ignore members with a note' option

2.4.6
-Added message previews to the settings menu (you need to reload your UI for those to update)

2.4.5
-Added a safety net to prevent errors when multiple people activate AutoRanks for the same guild at the same time

2.4.4
-Fixed the German translation and improved it a bit

2.4.3
-Added German translation

2.4.2
-Added strings for localization

2.4.1
-Minor bugfixes

2.4.0
-Added a dynamic messaging function
-Added a button to remove presets
-Re-ordered the settings panel a bit

2.3.1
-Optimized the preset manager
-Added chat indications on which preset is currently active

2.3.0
-Added the preset manager, so you can use mutliple addon configurations on the fly

2.2.5
-API bump for Markarth

2.2.4
-Now ignores recruits with a membership time longer than 3 times the 'Rank period' setting, to avoid false promotions when a player joins, who has been in the guild before (SGT needs a few minutes to update the data, so Auto Ranks thinks the new member has been in the guild for a long time already)

2.2.3
-Code optimization

2.2.2
-API bump

2.2
-Added the "[New member] rank period" option
-Changed the way the "New member rank" checkbox is saved. Double check your settings!

2.1.2
-Code optimization

2.1
-Under the hood changes and improvements

2.0
-Public release
Archived Files (27)
File Name
Version
Size
Uploader
Date
2.5.3
22kB
peniku8
06/06/22 05:31 PM
2.5.2
22kB
peniku8
03/18/22 03:26 PM
2.5.1
22kB
peniku8
11/08/21 08:03 PM
2.5
22kB
peniku8
09/19/21 05:44 PM
2.4.14
14kB
peniku8
09/14/21 04:17 PM
2.4.13
14kB
peniku8
08/30/21 04:53 PM
2.4.12
14kB
peniku8
03/23/21 05:40 PM
2.4.11
13kB
peniku8
03/14/21 11:32 AM
2.4.10
13kB
peniku8
03/09/21 03:25 PM
2.4.9
13kB
peniku8
03/08/21 01:44 PM
2.4.8
13kB
peniku8
12/21/20 06:11 PM
2.4.7
12kB
peniku8
12/08/20 05:37 PM
2.4.6
12kB
peniku8
12/06/20 10:12 AM
2.4.5
12kB
peniku8
11/27/20 04:26 PM
2.4.4
12kB
peniku8
11/22/20 05:29 PM
2.4.3
12kB
peniku8
11/20/20 08:22 AM
2.4.1
8kB
peniku8
11/16/20 05:17 PM
2.3.1
7kB
peniku8
11/13/20 01:53 PM
2.3.1
7kB
peniku8
11/11/20 08:54 PM
2.2.5
6kB
peniku8
11/03/20 06:39 AM
2.2.4
6kB
peniku8
09/04/20 04:14 AM
2.2.3
6kB
peniku8
09/01/20 06:06 PM
2.2.2
6kB
peniku8
08/30/20 04:45 PM
2.2
6kB
peniku8
08/09/20 01:34 PM
2.1.2
6kB
peniku8
07/06/20 05:27 AM
2.1
6kB
peniku8
07/02/20 02:16 PM
2.0
6kB
peniku8
05/27/20 03:39 PM


Post A Reply Comment Options
Unread 09/06/22, 04:01 AM  
xen32
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 90
Uploads: 1
Re: Re: Empty Rank Settings

Originally Posted by peniku8
Originally Posted by vaultdwellr
The rank settings for my first guild are empty. The rest of the guilds I'm in show up fine. Does anyone know what might cause that?
What's the guild's name? Did you try the addon with all other addons disabled? Does the issue still persist?
I have something similar, first settings for guild were empty, BUT processing worked according to old rules. New rank I added was not showing up (completely restarted the game). Deleted saved variables, new rank is still now showing up.
Report comment to moderator  
Reply With Quote
Unread 08/29/22, 03:47 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 44
Uploads: 7
Re: Empty Rank Settings

Originally Posted by vaultdwellr
The rank settings for my first guild are empty. The rest of the guilds I'm in show up fine. Does anyone know what might cause that?
What's the guild's name? Did you try the addon with all other addons disabled? Does the issue still persist?
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Recruit", "Auto Ranks", "AdBlock" and others
Report comment to moderator  
Reply With Quote
Unread 08/02/22, 05:45 PM  
vaultdwellr

Forum posts: 0
File comments: 1
Uploads: 0
Empty Rank Settings

The rank settings for my first guild are empty. The rest of the guilds I'm in show up fine. Does anyone know what might cause that?
Report comment to moderator  
Reply With Quote
Unread 03/18/22, 03:20 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 44
Uploads: 7
Re: Re: Re: Question about new member rank

Originally Posted by jeffk42
Yes, I know this and I did read, thank you. When this issue was occurring, I had a Leader and an Officer rank, plus a "Legend" (normal user, THIS rank had the "Permanent" box checked), and then what's listed below as "Rank 1", which did NOT have a permanent checkbox in the settings. This rank (Rank 1) is the one that was not demoting.

Again, this is not a major issue to me since it got resolved at some point, but I just wanted to put it out there that it isn't merely me not paying attention or not reading, as you've suggested. There was something stopping people from getting demoted from a NORMAL rank that did NOT have the permanent checkbox showing in the gui.
That's why this is part of the addon description
- I'd advise to reset your addon settings when you 1)Change the order of your guilds or 2)Change the language of your client
Since some options are rank specific, the UI for them disappears but the settings are still saved and active. That requires a full reset.
Edit: I just realized I wrote 'Change the order of your guilds' and not 'Change the order of your ranks'. I will correct that, since you should reset the addon in both cases.

Originally Posted by jeffk42
EDIT: I looked through the add-on code, and I think my needs may just be different than your intent.
Yea, the option says 'promotes after x days'. And that's what it does. It does not say 'ignores requirements', because it doesn't do that.
But I think my use case isn't that different from yours. My lowest rank is the 'Recruit' rank, 2nd rank is 'FeesDue' and all ranks above are various trader ranks. Everybody assigned to the FeesDue rank gets a message through AutoRanks.

Let's make an example:
-NewGuy42 and NewGuy69 join the guild.
-New member rank period is set to 3 days and sales requirements for FeesDue are not filled in. -Requirements for the lowest trader rank are 100k.
-"Promotions only" is active for the guild
-NewGuy42 sells for 120k on the first day and is promoted to 'Trader'
-NewGuy69 sells for 1k per day and gets promoted to "FeesDue" after 3 days, because he didn't meet the requirements yet. He gets a message stating that he needs to step up his game or he might get removed. The message also contains his sales so far (all automatic through AutoRanks).

-The week ends and a new week starts, I load my 'demotions' preset, which is essentially the same preset as my normal preset, but it disables the lowest rank and sets requirements for the 'FeesDue' rank to 0
→everybody not meeting the requirements of any of the ranks in the previous week gets demoted to 'FeesDue' and recieves a message
-NewMembers are left alone, because the rank is disabled

I only load and execute the 'Demotions' preset once a week after the trader swap. For the remainder of the week I let my 'Promotions' preset do the work
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Recruit", "Auto Ranks", "AdBlock" and others
Last edited by peniku8 : 03/18/22 at 03:22 PM.
Report comment to moderator  
Reply With Quote
Unread 03/18/22, 06:28 AM  
jeffk42

Forum posts: 0
File comments: 6
Uploads: 0
Re: Re: Question about new member rank

Originally Posted by peniku8
The highest rank displayed in the ranks options menu is the highest non officer rank. It has an extra option, which all other ranks don't have, which is called 'permanent rank', which is exactly what you're describing: nobody gets demoted from that rank. It says that on the tooltip though. If you disable that option this will no longer occur. I suggest paying closer attention to the UI and reading more. I also think I mentioned the '0 sales' thing in a tooltip somewhere. Everything is already explained in the addon itself
Yes, I know this and I did read, thank you. When this issue was occurring, I had a Leader and an Officer rank, plus a "Legend" (normal user, THIS rank had the "Permanent" box checked), and then what's listed below as "Rank 1", which did NOT have a permanent checkbox in the settings. This rank (Rank 1) is the one that was not demoting.

Again, this is not a major issue to me since it got resolved at some point, but I just wanted to put it out there that it isn't merely me not paying attention or not reading, as you've suggested. There was something stopping people from getting demoted from a NORMAL rank that did NOT have the permanent checkbox showing in the gui.
Last edited by jeffk42 : 03/18/22 at 06:29 AM.
Report comment to moderator  
Reply With Quote
Unread 03/18/22, 06:21 AM  
jeffk42

Forum posts: 0
File comments: 6
Uploads: 0
Re: Re: Question about new member rank

Originally Posted by peniku8
You understand that the addon promotes guild members to the highest rank, which they fulfil the requirements for, yes?
You put a requirement of 0 sales for rank 6. Every new member fulfils that requirement, because they have 0 sales. Leave the requirements for rank 6 blank or put '1' in there, depending on what you wanna do with that rank.
Yes, I understand how it works. My intent for rank 6 is this:

All new members go into "New Members" rank. After 14 days, they are promoted to whatever rank is appropriate for them. If they have 0 sales/donations, then yes they should be in Rank 6 (this is the "about to be cut" rank).

The "Rank Period" for New Members tooltip says members will be promoted out of the New Members rank after a set amount of days, and I have it set at 14. So my expectation based on your description is that regardless of sales/donation data, if a user joined 3 days ago, or 10 days ago, they should always stay in New Members. Once they've been in the guild for 14+ days, then the next time I process ranks, they should be bounced out of New Members and placed into the appropriate rank based on sales/donations.

EDIT: I looked through the add-on code, and I think my needs may just be different than your intent. The way you have it set up, people in "New Members" will ALWAYS get promoted up as soon as their sales reach the threshold of a higher rank, and if that happens, the time limit is ignored. I was expecting the time limit to be the deciding factor, i.e. it doesn't matter what you sell, you're always a "New Member" for 14 days. THEN after 14 days, you get promoted.

The way I was expecting, having zeroes in Rank 6 wouldn't matter because the time slider would be the deciding factor. But the way you wrote it, the sales is the deciding factor, and the zeroes in Rank 6 make sure everyone gets promoted.

I think I can work around that.

EDIT EDIT: Okay final edit, lol. I ended up just adding a line into the code to ignore any members that joined less than <Rank Period> days ago, regardless of their sales/donations. Here's my reasoning (fully admitting that my use case is likely different than others):

I use another add-on to color usernames in the guild roster by their rank. New members are pink, those in the "last chance" rank are red, "Legends" are green, etc etc. When I go to clear out the inactives to make room for new members, anyone that's still in the first 14 days of membership is automatically exempt from removal, they have 2 weeks to get acclimated and start selling or contributing. So let's say the "last chance" rank contains anyone that sells less than 5000 gold for the previous week. Well, when @NewGuy42 joins the guild and sells a 4k item, and then I run AutoRanks the next day, he gets put into the "last chance" group and his username turns red even though he's still protected by the "First 14 days" rule.

Now, when I go through to clear inactives, I can't just scan the roster for reds. I have to look at each red and check their join date and make sure it's over 14 days. With the modification I made, @NewGuy42 is still pink so I know at a glance that I can ignore his performance.

Anyway, that's what works for me. Thanks again for the work you put into the add-on.
Last edited by jeffk42 : 03/18/22 at 10:13 AM.
Report comment to moderator  
Reply With Quote
Unread 03/17/22, 07:38 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 44
Uploads: 7
Re: Question about new member rank

Originally Posted by jeffk42
Every time I processed the ranks (weekly after trader flip), everything worked as normal (New members was disabled so I didn't have that to worry about), but no one EVER was demoted out of "Rank 1". All other ranks worked perfectly fine as expected. People could get promoted into Rank 1. But no one ever left it. I had to go in manually every week and remove the members that no longer qualified.

Now, that said... I recently changed the rankings because I needed to add another protected rank. So now it's Leader, three protected ranks, 5 sales-based ranks, and new members. The three protected ranks are disabled. Once I made this change, Rank 1 behaves as expected, with members being correctly demoted out of it.
The highest rank displayed in the ranks options menu is the highest non officer rank. It has an extra option, which all other ranks don't have, which is called 'permanent rank', which is exactly what you're describing: nobody gets demoted from that rank. It says that on the tooltip though. If you disable that option this will no longer occur. I suggest paying closer attention to the UI and reading more. I also think I mentioned the '0 sales' thing in a tooltip somewhere. Everything is already explained in the addon itself
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Recruit", "Auto Ranks", "AdBlock" and others
Report comment to moderator  
Reply With Quote
Unread 03/17/22, 07:31 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 44
Uploads: 7
Re: Question about new member rank

Originally Posted by jeffk42
Hi, thanks so much for this add-on, it saves me a ton of time every week!

I was having two issues with it that I thought I'd bring up. The first is with the new member rank, maybe I'm misusing it?

The new member rank settings are as follows:

Enabled: ON
New member rank: ON
Rank period: 14
Sales requirement (blank)
Donation Requirement (blank)

Whenever I process ranks, it goes through and promotes ALL of my new member ranked users. It completely empties out the rank every time even though there are people in there with join dates as recently as the same day.

As a workaround I had left it disabled for several months and I was just promoting out of that rank manually after the users reach 14 days. Recently I tried it again, same issue - it promoted all 30-40 members that were in that rank.

The other issue I had sort of resolved itself for me, but I thought I'd mention it anyway. I had the 10 ranks like this:

Leader
Protected 1
Protected 2
Rank 1: sales=3000000, donations=100000
Rank 2: sales=2000000, donations=75000
Rank 3: sales=1000000, donations=50000
Rank 4: sales=500000, donations=25000
Rank 5: sales=100000, donations=10000
Rank 6: sales=0, donations=0
New Members

Only the "Rank" ones were enabled. Every time I processed the ranks (weekly after trader flip), everything worked as normal (New members was disabled so I didn't have that to worry about), but no one EVER was demoted out of "Rank 1". All other ranks worked perfectly fine as expected. People could get promoted into Rank 1. But no one ever left it. I had to go in manually every week and remove the members that no longer qualified.

Now, that said... I recently changed the rankings because I needed to add another protected rank. So now it's Leader, three protected ranks, 5 sales-based ranks, and new members. The three protected ranks are disabled. Once I made this change, Rank 1 behaves as expected, with members being correctly demoted out of it.
You understand that the addon promotes guild members to the highest rank, which they fulfil the requirements for, yes?
You put a requirement of 0 sales for rank 6. Every new member fulfils that requirement, because they have 0 sales. Leave the requirements for rank 6 blank or put '1' in there, depending on what you wanna do with that rank.
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Recruit", "Auto Ranks", "AdBlock" and others
Report comment to moderator  
Reply With Quote
Unread 02/09/22, 07:48 AM  
jeffk42

Forum posts: 0
File comments: 6
Uploads: 0
Question about new member rank

Hi, thanks so much for this add-on, it saves me a ton of time every week!

I was having two issues with it that I thought I'd bring up. The first is with the new member rank, maybe I'm misusing it?

The new member rank settings are as follows:

Enabled: ON
New member rank: ON
Rank period: 14
Sales requirement (blank)
Donation Requirement (blank)

Whenever I process ranks, it goes through and promotes ALL of my new member ranked users. It completely empties out the rank every time even though there are people in there with join dates as recently as the same day.

As a workaround I had left it disabled for several months and I was just promoting out of that rank manually after the users reach 14 days. Recently I tried it again, same issue - it promoted all 30-40 members that were in that rank.

The other issue I had sort of resolved itself for me, but I thought I'd mention it anyway. I had the 10 ranks like this:

Leader
Protected 1
Protected 2
Rank 1: sales=3000000, donations=100000
Rank 2: sales=2000000, donations=75000
Rank 3: sales=1000000, donations=50000
Rank 4: sales=500000, donations=25000
Rank 5: sales=100000, donations=10000
Rank 6: sales=0, donations=0
New Members

Only the "Rank" ones were enabled. Every time I processed the ranks (weekly after trader flip), everything worked as normal (New members was disabled so I didn't have that to worry about), but no one EVER was demoted out of "Rank 1". All other ranks worked perfectly fine as expected. People could get promoted into Rank 1. But no one ever left it. I had to go in manually every week and remove the members that no longer qualified.

Now, that said... I recently changed the rankings because I needed to add another protected rank. So now it's Leader, three protected ranks, 5 sales-based ranks, and new members. The three protected ranks are disabled. Once I made this change, Rank 1 behaves as expected, with members being correctly demoted out of it.
Last edited by jeffk42 : 02/09/22 at 09:14 AM.
Report comment to moderator  
Reply With Quote
Unread 09/16/21, 04:22 PM  
EchoTiger

Forum posts: 0
File comments: 6
Uploads: 0
Originally Posted by peniku8
Originally Posted by EchoTiger
Heyah!

I believe MasterMerchant now uses a different way to store data, (LibGuildStore) rather than the old MM##Data files.
But I caught Auto-Ranks trying to demote everyone to the lowest rank, so I assume it's because of the MM change

Was curious if Auto-Ranks would be updated for this change?
I heavily rely on it to manage members in my trade guild. xD

Thanks for reading!
I'm on it
Thanks for the quick update!
Report comment to moderator  
Reply With Quote
Unread 09/14/21, 04:19 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 44
Uploads: 7
Re: Re: auto ranks disappeared after update?

It was pretty late when I did this yesterday and confused folders and addons and ended up uploading the AutoRecruit file here. I added the correct file now!
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Recruit", "Auto Ranks", "AdBlock" and others
Report comment to moderator  
Reply With Quote
Unread 09/14/21, 03:48 PM  
jeffk42

Forum posts: 0
File comments: 6
Uploads: 0
Re: auto ranks disappeared after update?

Originally Posted by arps
minion says it's installed but the game not seeing it all? Was working fine pre-update?
Looks like maybe the developer updated Auto Ranks with the wrong code (the code from Auto Recruit). My Auto Ranks has been replaced with Auto Recruit, even though I never installed the latter.

Hopefully it'll get fixed soon.
Report comment to moderator  
Reply With Quote
Unread 09/14/21, 01:59 PM  
arps

Forum posts: 0
File comments: 13
Uploads: 0
auto ranks disappeared after update?

minion says it's installed but the game not seeing it all? Was working fine pre-update?
Report comment to moderator  
Reply With Quote
Unread 09/08/21, 04:25 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 44
Uploads: 7
Originally Posted by EchoTiger
Heyah!

I believe MasterMerchant now uses a different way to store data, (LibGuildStore) rather than the old MM##Data files.
But I caught Auto-Ranks trying to demote everyone to the lowest rank, so I assume it's because of the MM change

Was curious if Auto-Ranks would be updated for this change?
I heavily rely on it to manage members in my trade guild. xD

Thanks for reading!
I'm on it
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Recruit", "Auto Ranks", "AdBlock" and others
Report comment to moderator  
Reply With Quote
Unread 09/05/21, 08:24 AM  
EchoTiger

Forum posts: 0
File comments: 6
Uploads: 0
Heyah!

I believe MasterMerchant now uses a different way to store data, (LibGuildStore) rather than the old MM##Data files.
But I caught Auto-Ranks trying to demote everyone to the lowest rank, so I assume it's because of the MM change

Was curious if Auto-Ranks would be updated for this change?
I heavily rely on it to manage members in my trade guild. xD

Thanks for reading!
Last edited by EchoTiger : 09/05/21 at 08:24 AM.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: