Treasury System
Addon to Roster 1.6
This was written for addon version 1.2
Banker mule identification tag
Hide treasury contents from non-members
Installation
Unzip the zip into the addons folder, which should create and fill the “treasurySystem”folder.
It’s assumed that you have already successfully installed the
addonAdmin
and
authenticationSystem
addons.
If not, go back to www.wowroster.net, go to the 3rd party forum and grab them.
Both of these addons are required in order to run this one.
Ok, so you’re looking at the main roster page.
Click on the [Addons Admin] link in your roster menu.
Enter your password (set in roster’s conf.php, it’s the one used for roster’s guild update) and hit Submit.
You should be in the Addon Admin Area now.
Click on the [Install] link in the Treasury System row.
The page will reload and just above the addon admin interface you should see three rows that say:
Table: treasurysystem_orders created
Table: treasurysystem_items_price created
Table: treasurysystem_settings created
The previously red square ‘light’ next to the ‘Treasury System’ name in Addon Admin should now be green.
You should now also see 2 new options where [Install] was before.
[Uninstall] [Configure Addon]
Configuration
Click on the Addons Admin link in your roster menu.
Enter your password (set in roster’s conf.php, it’s the one used for roster’s guild update) and hit Submit.
You should be in the Addon Admin Area now.
Click on the [Configure Addon] link in the Treasury System row.
You should be in the Treasury System Admin Area now.
Roster Field
The roster field is the location of the identifying name of the guild’s bank character(s).
This could be the character name, something in the note or officer’s note or a guild rank.
Examples
Guild [A Righteous Few] has 2 bank chars, one called “Treasuress” and one called “Treasurer”.
In this case, searching for something in the [name] might be a bit unpractical as they have only a limited number of identical features (“treasure” would work), so it’s better to use a different field than [name] to identify them as bank chars.
This guild created a [rank] called “banker” and assigned that rank to both bank chars and selected [Guild Rank] from the dropdown list.
This is probably the safest way but due to game restrictions (you only have a limited number of ranks, so adding or converting one might not be worth it) this might not be possible on different guilds.
Guild [The Alpha and the Omega] has 3 bank chars, called “Aqbank”, “Zgbank”, “Mcbank” and “Stuffbank”.
In this case, the names have sufficient identical features to get a quick search done and the setting won’t confuse other guild admins (or yourself later on).
So this guild chose the [name] field.
Guild [Dawn of the End] has 2 bank chars, called “Arestoteles”, “Doteb”.
This guild has put “GuildBank” into these three char’s officer’s notes. That’s pretty safe and works, so they selected [officers note] in the dropdown menu.
The normal [note] would have had the same effect, only that the word “GuildBank” would have been put into the normal note and normal notes can be edited by guild members with fewer privileges required.
Just note that the [officers note] and normal [note] are different fields in the game and therefore different fields in the roster too.
Banker mule identification
tag
Here you enter the name/word that identifies your banker(s).
To make this clear, let’s demonstrate it with the example guilds:
[A Righteous Few] => [Rank] “Banker”
[The Alpha and the Omega] => [Name] commonality: “bank”
[Dawn of the End] => [Officers Note] “GuildBank”
The values in the quotes are what each guild has entered into this field for themselves.
Items
displayed per page
You have the choice of how many (maximal) items should be displayed on one page. If there’s more than that number of items, a new page will be generated.
5 seems to be a reasonable setting for a resolution of 1024x768 which is common these days, 3 if you still feel its crowded or more if you feel like scrolling down a lot but want to flip trough less pages.
Less items per page = More pages in total, less crowded screen.
More items per page = Less pages in total but you’ve got to scroll down a lot to see all the items.
Display
price column
This setting is whether to show the price column on the right or to hide it.
The reason of why to put a price on guild bank items is that the guild bank doesn’t grow gold on its own (mule & gold… anyone remember that story written by the Grimm Brothers?) and having a well stocked guild purse gives the guild the power to acquire good items on the AH or trade with other guilds for recipes/mats, loan gold to its members for stuff like mounts etc.
Some guilds also use DKP, so there is an option to put a fix DKP price on any item in the treasury. (Either gold or DKP, not both on the same item)
Hide
treasury contents from non-members
This option enables you to hide your guild bank from non-guild members that happen to visit your page. Your guildies will be able to see and do everything as usual once they’re logged in on your board.
Not logged in people will see a message telling them that this is a guild member exclusive area.
Super Users
First of all, add all bank chars to this list.
That’s just required for some internal workings of the treasury to work.
Now to explain the secondary purpose of this:
Whoever you designate as a super user (=>add to the list), will be able to do administrative tasks on the treasury when logged in.
Super Users can add/remove/change prices and disapprove orders by having the power to cancel anyone’s order.
The cancelling feature is necessary to unblock orders by people that have just left the guild but had orders up, and mainly to keep a balance and stop certain people from getting into the habit to finance their char (items, mats) with bank items.
The Super Users can’t order stuff so they will be a second account on the board that someone holds. (If you like, a forum alt ;-P )
Last but not least, don’t forget to hit the [Save] button once you’re done configuring.
Upgrading
Let’s assume you’ve had Treasury System v1.0 and I release Treasury System v1.1.
To upgrade you’ll have to replace the treasurySystem folder in the addons directory with the new one.
Then log into the Addon Admin interface and you’ll see:
A yellow square ‘light’ next to ‘Treasury System’, the new version number below that and a new option: [Upgrade]
If the version difference is only 0.1 or if I state the compatibility of direct upgrades on the Treasury System thread on the wowroster.net forum and its within that range, all you’ll have to do to upgrade is click that link.
You will see messages that the upgrade script has successfully run and that’s it.
You didn’t lose your settings or orders/past orders and prices.
If it’s not possible to directly upgrade from your version to the new version, click on [Uninstall], that will delete all treasurysystem_ tables, then click on [Install] and you’re on the new version.
Usage
It’s pretty much self-explanatory for the most part, with buttons and drop down lists, but there are a few things that should be mentioned.
Item Name
This is the only search field that allows individual input. Whatever you enter here is being searched for in the item name and tooltip field!
Just like in Google you can use special signs to change the outcome of the search.
Example: Let’s say there is an item called “Abyssal Crest”.
You want to see if the guild has that item but can’t remember the full word or spelling.
If you enter abys , you wont get a hit, if you enter: abys* instead you’ll get everything that starts with abys.
You want to see if there are essences in the bank, so you enter essence and you’ll get all essences.
If you want to get every essence besides living essence, enter: essence –living
Prices
You can set prices when you’re logged in with a char designated as Super User.
You can switch from gold to DKP and vice versa by using the dropdown box and entering values into the appropriate fields.
You can switch the display of a price for an item off by setting its price to 0
Once you have set a price for an item, that price is stored not for this single individual item but for all items with this name. You won’t have to set the price again if you give the item away and get a new one again.
Prices can be set per single item or stack. If you set stack you have to make sure to select the right size of stack, the treasury doesn’t know that one type of item only allows a stack of 5 and another sort a stack of 20.
NoteIt
NoteIt is a WoW addon written by Zugreg (can be found on curse-gaming.com) which allows extension of any Item’s tooltip.
Using NoteIt and UniUploader it is possible to attach order info from the Treasury to the ordered items.
The addon included with the Treasury is version 1.05 and was successfully tested with WoW 1.9 (I use it all the time)
There may be a more recent version and if the author hasn’t changed the lua structure they should run fine with this too.
NoteIt can be used by the banker character holders to reduce the amount of alt-tabbing to check whom to assign which item, quantity and price…
The Order Status screen in the Treasury was developed as alternative or aid for this function.
Installation
Install NoteIt like any other WoW addon, by extracting the NoteIt folder from the ZIP file into the Interface/Addons folder in WoW’s directory.
In the Addons window in the char selection screen in World of Warcraft, tick the “load outdated addons” box to be able to load it and set it to load for the banker char’s only by selecting his name from the upper left dropdown box and ticking NoteIt.
Short – activate NoteIt only for your bankers -.
Make an order, if there isn’t one currently.
Change the URL to www.yourdomain.com/roster/addons/treasurySystem/treasuryUUreport.php?TreasurerName=Bankername1,Bankername2
Add only the banker’s names you own (to get the orders that are directed at your banker), you can add as many as you have, also enter the name as it is in the game. The orders will show up individually for each banker.
Note: Obviously there will be problems with banker names that contain special characters as they are not allowed in their native state in any URL. It will most likely not work in this case.
You should now see lua code and recognize certain parts of your order, such as the item name, quantity and price if applicable, treasurer, name of who ordered it etc. If that’s ok you’re ready for the next step.
In UniUploader change to Advanced Mode, select the Advanced tab, tick the [x]Retrieve Data tickbox under Website è WoW and enter the full URL from the previous testing step into the text field.
Tick [x]before WoW launch, so you get the most recent orders before launching the game.
Usage
Start WoW trough UU from now on and you’ll always have the latest order info on your bankers.
So you’re logged in as your banker in the game. Enter: /ni into the chat window and NoteIt will pop up. I suggest you make a macro for that and place it onto one of the hotbars.
You should see the orders in NoteIt and when you move the mouse over an ordered item you should also see the info in the tooltip.