(77 Kb)
Updated: 08-30-12 07:18 PM
File Info
Updated:08-30-12 07:18 PM

Postal  Popular! (More than 5000 hits)

Version: v3.5.0
by: Xinhuan, oscarucb

Postal offers enhanced mailbox support by providing the following features:

  • BlackBook: Adds a contact list next to the To: field.
    • Tracks all your characters (as you log each one on) and list them if they are on the same realm/faction on an "Alts" list
    • Tracks the last 20 players you mailed on a "Recently Mailed" list.
    • Autocomplete names from Alts/Recently Mailed/Contacts/Friends/Guild list. You can choose which of these lists to use.
    • Option to autofill in the last person mailed to the To: field.
    • Option to disable Blizzard's name auto-completion popup.
  • DoNotWant: Shows a clickable visual icon as to whether a mail will be returned or deleted on expiry.
  • CarbonCopy: Allows you to copy the contents of a mail.
  • Express: Adds shortcuts
    • Shift-Click to take item/money from mail
    • Ctrl-Click to return mail
    • Alt-Click to move an item from your inventory to the current outgoing mail (same as right click in default UI)
    • Mousewheel to scroll the inbox
    • Added option to disable multiple item mail tooltips.
  • OpenAll: Allows you to open all mails of selected types at one go in your inbox unattended
    • All AH Cancelled mail
    • All AH Expired mail
    • All AH Outbidded mail
    • All AH Success mail
    • All AH Won mail
    • Non-AH mail with attachments
    • AH settings are divided into neutral and faction-specific settings.
    • Shift-Click on the OpenAll button will open all mail and override your filter settings.
    • Choose to have a number of bag slots always left free when opening mail.
  • Rake: Displays summary of money gained from opening mail
  • Select: Adds checkboxes to the inbox with buttons for selective opening/returning
    • Added mail indicator numbers above the checkboxes.
    • Added help note that you can Shift-Click 2 checkboxes to select everything between them.
    • Added help note that you can Ctrl-Click a checkbox to select all mail from that sender.
    • Choose to have a number of bag slots always left free when opening mail.
  • TradeBlock: Block trades and guild charter signature invites from people while you are at the Inbox
  • Wire: Autoupdate the subject field with money amount if blank.

Postal's menu and settings can be accessed at the upper right corner of your mailbox.

Please post bugs or suggestions at: http://forums.wowace.com/showthread.php?t=3909

Postal Profiles

While this might not be too intuitive to some users, each character that you log on will have its own initial Postal profile (settings). If you wish that some or all your characters share the same profile (and hence share the same contact list), then you can create a New Profile, call it anything you want such as "Shared by Alts", and have all your other characters change to that profile.

Mass Mailing Abilities

Postal does not come with any abilities to send out mass mails (i.e messages to more than 1 person at a time). There is no intention to add such functionality to Postal.

Changes from v3.4.13 to v3.5.0
  • Updated for and works with Mists of Pandaria!
  • Add Control-Click to attach similar items to Express module, by oscarucb.
  • Show buyer/seller name in chat log output when opening AH mails, by jmbarlow.
  • Realign buttons properly in MoP.
  • Blizzard's guild autocomplete is broken, so we implement our own in the Send name editbox in Blackbook module.
  • Fix autocomplete for BattleTag/RealID friends to work.
  • Add Italian localization.

Changes from v3.4.12 to v3.4.13
  • Add solution (provided by paxi) for mailbox not opening past the first 50 mails for users of other addons that also regularly check the mailbox for changes such as "Tradeskillmaster Mailing".
  • Add Brazilian Portugese (ptBR) localization.

Changes from v3.4.10 to v3.4.12
  • Updated the TOC number to 40300.
  • Apply fix for PTR crash when opening a mail containing more than 2^31 gold, by Cybeloras.
  • More accurate timings on when new mail will arrive when someone else is doing CheckInbox() calls, by Mikk.
  • Add option to disable having Mr.Plow addon be triggered on opening/returning mails in Select and OpenAll modules. Defaults to On.

Changes from v3.4.9 to v3.4.10
  • Updated the TOC to 40200.

Changes from v3.4.8 to v3.4.9
  • Fix "OpenAll.lua:497: 'end' expected (to close 'function' at line 158)" error in v3.4.8.

Changes from v3.4.7 to v3.4.8
  • Fix another issue with OpenAll not opening all that resulted from the code simplification.

Changes from v3.4.6 to v3.4.7
  • Use a different function to determine if a mail can be returned in the Select module. Should fix return mail issues.
  • Simplify OpenAll's mail refreshing code. Fixes the mailbox not auto-refreshing sometimes when you have more mail than 50 to open.
  • Add menu option to select which chat window to output Postal's text to. Defaults to ChatFrame1.
  • BlackBook will now also record the faction and realm of players you have recently mailed, and only show/use/autocomplete the ones from the same realm/faction as you. This is so that you can use the same profile across multiple servers/factions.
  • The recently mailed list is increased in size from 10 to 20 and the list is wiped with this update.

Changes from v3.4.5 to v3.4.6
  • If new mails are detected while opening mails, OpenAll will now restart from opening the last mail (in patch 4.0.3, the inbox will now refresh itself on a mailbox change with any new mail if at least 60 seconds has passed).
  • Add code to the Select Module to deal with any new mails that might appear at the front of your mailbox at any time, due to flipping inbox pages or a MAIL_INBOX_UPDATE event.
  • CheckInbox() behavior changed slightly. It now fires MAIL_INBOX_UPDATE immediately (synchronous) if called within 60 seconds of the last inbox update, but doesn't do it immediately otherwise (asynchronous). Change code in OpenAll module to take this into account to speed up continuing OpenAll by not waiting an extra 10 seconds while doing mailbox refreshes.

Changes from v3.4.4 to v3.4.5
  • Fix error that happens when you have no friends on your friends list.

Changes from v3.4.3 to v3.4.4
  • Remove RealID friend features from the BlackBook module, along with deleting the realID friend database. Addons are no longer able to obtain real names or any unique realIDs in any manner since patch 4.0.1. Special thanks to Cerala.

Changes from v3.4.2 to v3.4.3
  • The Rake module will now properly report the amount of money taken from the mailbox if you right-clicked on the mailbox in the 3D world while it is already open (this bug is new in patch 4.0.1)
  • BlackBook module will now add your alt to the alts list on login rather than on visiting the mailbox unless Postal is LoD (due to AddonLoader or otherwise).
  • In the OpenAll module, when the mailbox is refreshed during an OpenAll, delay the continuation of OpenAll by 3 seconds to allow for other addons (such as BeanCounter) to do stuff.

Changes from v3.4.0 to v3.4.2
  • Fix the annoying error about passing nil to format's #3 argument. The error itself didn't cause any harm, so I didn't tag a release immediately.
  • In OpenAll and Select modules, when your bag space is nearly reaching the Keep Free Space setting (1 free above it), Postal will now slow down opening mails to 1 second (if opening speed is below 1 second) to avoid opening mails too quickly and thus avoid going below the Keep Free Space setting. It goes back to opening full speed after you hit the Keep Free Space setting.
  • If your inventory is full, OpenAll and Select modules will now loot any items that can combine with any partial stacks in your bags instead of skipping them.

Changes from v3.3.2 to v3.4.0
  • Updated for and works with Cataclysm!
  • New module CarbonCopy. Allows you to copy the contents of a mail into the clipboard.
  • OpenAll module will now really open all your mails - even if you have more than 50 of them. It will now automatically refresh your mailbox and continue opening mails.
  • OpenAll and Select modules will stop spamming your chat in verbose mode when your bags are full.
  • BlackBook module will now remember your Real ID friend's characters.
  • BlackBook module will now show the level and class of your alts, Real ID friends and your guild members in the menus. You may need to log on each alt and visit the mailbox at least once for Postal to remember your alts' level and class.

Changes from v3.3.1 to v3.3.2
  • Updated for patch 3.3.5!
  • Fix friends list in the BlackBook module. The friends menu dropdown will now show all eligible friends on the same faction and realm that Postal can determine (from friends and RealID).

Changes from v3.3.0 to v3.3.1
  • Add option to ignore randoms you interacted with for auto-complete in Blackbook.
  • Fix minor bug where "Processing Message 0:" is printed when performing an Open All.
  • Fixed unintended bug where Postal allowed CoD amounts larger than 10000g to be sent if the Wire module is active (Blizzard just reduces the CoD amount to 10000g if it was larger). This is now fixed and the default UI behavior to disable the Send button if the amount is larger than 10000g is restored (reported by thefluffyrocker).

Changes from v3.2.2 to v3.3.0
  • Updated for patch 3.3!
  • Add backward compatibility for MrPlow API function call change.
  • Tweak mail opening algorithm so that it won't skip mails when the opening speed is really fast (such as 0.3).
  • In BlackBook module, Friends will now auto-complete if Guild disabled and they are in Guild (and vice-versa).
  • Raise frame level of some buttons by 1.
  • Add workaround to Blizzard's patch 3.3 menu buttons showing behind the menu itself hence they appear disabled.

Changes from v3.2.1 to v3.2.2
  • Fix the annoying error about editbox being nil caused by Postman's improper hooking.
  • Change the "Please delete some mail..." standard Blizzard message into a more useful one that:
    • Shows you how MANY mails remain after the current 50.
    • Tells you how long (in seconds) it is until you get to refresh for more.
  • Add a setting for "Keep free space", defaults to keeping 1 regular bagslot free in the Select and OpenAll modules. You may need to slow down your opening speed option or leave more empty bag space due to server/client latency.
  • Make our BlackBook autocomplete complete before Blizzard's reinstated one. Make the Friends/Guild list BlackBook options affect Blizzard's autocomplete instead in its popup menu (if it is enabled).
  • Add an option to turn on or off Postal's auto-complete (default on).

Changes from v3.2.0 to v3.2.1
  • Fix the occasional issue where auto-complete will not start working until at least 2 letters are typed.
  • Fix the Send button not enabling itself when typing in a name to send to after putting items into the mail first.

Changes from v3.1.2 to v3.2.0
  • Updated for patch 3.2!
  • TradeBlock module now also blocks guild charter signature invites while the mailbox is open.
  • New module: DoNotWant. Shows a clickable visual icon as to whether a mail will be returned or deleted on expiry. Allows fast deleting/returning of mail by clicking the icon (bye Lunar festival mail!). Standard popup warnings will still show for deleting items though.
  • Fix name auto-completion in BlackBook module. Now works with Blizzard's one and still retains previous behavior.
  • Additionally, you can now choose which lists (Alts/Recent/Contacts/Friends/Guild) Postal will auto-complete names from, as well as disable Blizzard's name auto-completion popup in the BlackBook module options.
  • Postal now shows a tooltip containing the mail subject on mouseover if the subject line is too long to fit in the default MailFrame.
  • The mailbox will no longer show the silly red "Not all of your mail could be delivered. Please delete some mail to make room." message under our Open and Return buttons in the Select module when you have more than 50 mails. Postal will print it to chat once instead.

Changes from v3.1.1 to v3.1.2
  • Hides the minimap unread mail button if there are no unread mail on closing the mailbox. Does not scan past the first 50 items since only the first 50 are viewable.
  • Change the opening speed menu to show speeds between 0.3 to 1.0 (with 0.05 steps) and 1.0 to 5.0 (with 0.5 steps). Change the default opening speed from 0.75 to 0.50.
  • Add separate OpenAll filters specific to your Faction AH and Neutral AH.

Changes from v3.1.0 to v3.1.1
  • Attempt to fix autocomplete in IME char composition mode.
  • Fix mouse wheel scrolling in the MailFrame.
  • Update passing arguments for some hooks in patch 3.1.

Changes from v3.0.0 to v3.1.0

You are recommended to '''delete your old Postal folder''' before installing the new one because it is a Ace3 rewrite and there are a lot of old files and libraries that are no longer needed.
  • Framework: Upgraded from Ace2 to Ace3.
  • Libraries: DewdropLib is gone. Now uses UIDropDownMenu in the default UI.
  • Profile system: Now actually works. The old Postal saved profiles in character specific SVs, so it was useless for copying or sharing.
  • Localization: Now uses the wowace localization app at http://www.wowace.com/projects/postal/localization/ to auto-generate the locale files. As such, all 8 locale files are now merged into 1 file since it no longer needs to be maintained manually.
  • Slash command /postal: Removed. I don't think anyone used it.
  • DejaVu module: Removed. Its functions are now in BlackBook module.

Note: Your old settings (from v3.0.0) are NOT migrated. It should only take at most 30 seconds to look at the 10 or so settings anyway.
Optional Files (0)

Archived Files (21)
File Name
12-17-11 03:34 AM
12-03-11 11:32 AM
07-02-11 11:07 AM
05-22-11 03:34 AM
05-22-11 01:24 AM
05-07-11 11:03 AM
04-27-11 06:13 PM
11-10-10 04:43 AM
10-18-10 10:04 AM
10-12-10 12:27 PM
09-25-10 10:16 PM
07-03-10 06:11 AM
03-21-10 02:22 PM
12-09-09 12:40 PM
10-10-09 01:15 PM
08-30-09 12:04 PM
08-10-09 12:30 PM
05-21-09 05:40 PM
04-15-09 09:42 PM
02-14-09 12:44 PM
10-14-08 12:28 PM

Post A Reply Comment Options
Unread 08-11-09, 06:25 PM  
A Kobold Labourer
Csalago's Avatar
AddOn Author - Click to view AddOns

Forum posts: 1
File comments: 85
Uploads: 7
found a bug.

if you add items to the new mail first, and then have it autofillin a recipient name, the send button does not appear. if you do the name first, and then add the items, it's fine.
Report comment to moderator  
Reply With Quote
Unread 08-11-09, 11:02 AM  
A Kobold Labourer

Forum posts: 1
File comments: 1
Uploads: 0
Visually Cickable Icon... ?!?

OK, this is probably blindingly obvious to everyone else but I cannot get my head past the ambiguity in the description... I consider the "DoNotWant" icon very useful in alerting me to mail that will be deleted as opposed to returned on expiry - I circulate copious amounts of mail between my alts. The icon is described as "visual" and, though I have difficulties imagining what a "non-visual" icon would look like, this is not my immediate issue... The icon is also described as clickable - but with NO description of happens when it is clicked... I am highly imaginative but this just complicates the issue... So, finally, my question: what is the functionality of this icon in its guise as a button?
Report comment to moderator  
Reply With Quote
Unread 08-10-09, 08:13 PM  
A Kobold Labourer

Forum posts: 0
File comments: 14
Uploads: 0
Thanks alot for the update!
Report comment to moderator  
Reply With Quote
Unread 08-10-09, 06:57 PM  
A Defias Bandit

Forum posts: 2
File comments: 3
Uploads: 0
Originally posted by Xinhuan
Hi all, I'll have an update out for Postal within the hour. Hang tight!
Goodies for everyone!
Bless you, my friend - was looking several times everyday.

Now I get to go try it out!

An early Christmas in Azeroth!
Report comment to moderator  
Reply With Quote
Unread 08-10-09, 06:18 PM  
Priestess of the Moon
Spectrezh's Avatar
Premium Member

Forum posts: 8
File comments: 45
Uploads: 0
yay thank you for the update!!!

Report comment to moderator  
Reply With Quote
Unread 08-10-09, 05:21 PM  
A Deviate Faerie Dragon

Forum posts: 18
File comments: 58
Uploads: 0
THANK YOU for fixing auto complete! I can't live without it.

Already sent 10 crystallized life to some character named "ba" on my realm instead of the full name of my AH mule.

Hopefully they'll come back in 30 days.

<3 autocomplete
Report comment to moderator  
Reply With Quote
Unread 08-10-09, 04:17 PM  
An Aku'mai Servant

Forum posts: 36
File comments: 8
Uploads: 0
Awesome work! Thank you!

You're great!
Bacon. 'Nuff said.
Report comment to moderator  
Reply With Quote
Unread 08-10-09, 03:31 PM  
A Murloc Raider

Forum posts: 9
File comments: 6
Uploads: 0
Awesome work, thank you for the update...one of the best add-ons around!
Report comment to moderator  
Reply With Quote
Unread 08-10-09, 12:23 PM  
A Kobold Labourer

Forum posts: 1
File comments: 1
Uploads: 0
Thank you

I knew you would get one out, I missed Postal so bad so thank you very much. I tried the other ones and they weren't the same so I just ran with I had and hoped
Report comment to moderator  
Reply With Quote
Unread 08-10-09, 11:45 AM  
Harshmage's Avatar
Premium Member
AddOn Author - Click to view AddOns

Forum posts: 9
File comments: 24
Uploads: 1
Originally posted by Xinhuan
Hi all, I'll have an update out for Postal within the hour. Hang tight!
Goodies for everyone!
Cool beans! When you get yours up, the mini patch I hacked together will go down. No need for a branch when I really don't know what on earth I'm doing.
Report comment to moderator  
Reply With Quote
Unread 08-10-09, 11:36 AM  
A Chromatic Dragonspawn
Xinhuan's Avatar
AddOn Author - Click to view AddOns

Forum posts: 174
File comments: 212
Uploads: 14
Hi all, I'll have an update out for Postal within the hour. Hang tight!
Goodies for everyone!
Author of Postal, Omen3, GemHelper, BankItems, WoWEquip, GatherMate, GatherMate2, Routes and Cartographer_Routes
Report comment to moderator  
Reply With Quote
Unread 08-10-09, 10:18 AM  
An Aku'mai Servant

Forum posts: 36
File comments: 8
Uploads: 0
don't shoot the messenger, but

You could just weenie out and

ESC > Interface Options > Help > Show LUA errors

and just uncheck the box.

No, it doesn't fix the problem, but it does remove the annoying pop-up.
Bacon. 'Nuff said.
Report comment to moderator  
Reply With Quote
Unread 08-10-09, 09:43 AM  
A Murloc Raider

Forum posts: 9
File comments: 30
Uploads: 0
Full functioning workaround

Hi -

After reading the comments here I came accross http://www.wowinterface.com/download...oComplete.html , So I thought I'd try both together to see what happened.

The alts' flyout is still grayed out - but now I can save an alt to the drop down between sessions which I couldn't do before. The remaining postal functions remain intact all work perfectly

I use Bug Sack so I don't get popups and errors are stored in the sack

These are the contents of my bugsack with both mods running

[2009/08/10 11:37:45-159-x1]: Postal-3.1.2\Modules\BlackBook.lua:41: Usage: RawHook([object], method, [handler], [hookSecure]): Attempting to hook a non existing target
AceHook-3.0-5:208: in function <...Inventory\Externals\Ace3\AceHook-3.0\AceHook-3.0.lua:115>
AceHook-3.0-5:322: in function `RawHook'
Postal-3.1.2\Modules\BlackBook.lua:41: in function <Interface\AddOns\Postal\Modules\BlackBook.lua:17>
<in C code>: ?
<string>:"safecall Dispatcher[1]":3: in function <[string "safecall Dispatcher[1]"]:3>
<in C code>: ?
<string>:"safecall Dispatcher[1]":9: in function <[string "safecall Dispatcher[1]"]:5>
(tail call): ?:
AceAddon-3.0-5:531: in function `EnableAddon'
AceAddon-3.0-5:543: in function `EnableAddon'
AceAddon-3.0-5:621: in function <...ventory\Externals\Ace3\AceAddon-3.0\AceAddon-3.0.lua:607>
<in C code>: in function `LoadAddOn'
Interface\FrameXML\UIParent.lua:229: in function `UIParentLoadAddOn':
Interface\FrameXML\UIParent.lua:252: in function `CombatLog_LoadUI':
Interface\FrameXML\UIParent.lua:499: in function <Interface\FrameXML\UIParent.lua:471>:


maybe this can help someone else -

Thanks for a great mod and all your hard work.
Last edited by Aesop : 08-10-09 at 09:55 AM.
Report comment to moderator  
Reply With Quote
Unread 08-09-09, 10:59 PM  
A Deviate Faerie Dragon

Forum posts: 11
File comments: 174
Uploads: 0
All credit for this "dirty" fix (as he calls it) goes to Groumf over at WoWAce forums:

Locate the Blackbook.lua file:

1) Scroll down to the lines:

self:RawHook("PlayerNameAutocomplete", true)
self:RawHookScript(SendMailNameEditBox, "OnCharComposition")

Change to

--self:RawHook("PlayerNameAutocomplete", true)
self:RawHookScript(SendMailNameEditBox, "OnTextChanged", "PlayerNameAutocomplete")

--self:RawHookScript(SendMailNameEditBox, "OnCharComposition")

2) Scroll to:

function Postal_BlackBook:PlayerNameAutocomplete(...)
if not self:PlayerNameAutocompleteReal(...) then
return self.hooks["PlayerNameAutocomplete"](...)

Change to:

function Postal_BlackBook:PlayerNameAutocomplete(editbox, userInput, ...)

if ( userInput ) then

if not self:PlayerNameAutocompleteReal(editbox, userInput, ...) then

return self.hooks[SendMailNameEditBox].OnTextChanged(editbox, userInput, ...)



3) Scroll to:

function Postal_BlackBook:PlayerNameAutocompleteReal(editbox, char, skipFriends, skipGuild, ...)

AFTER "local textlen = strlen(text)" and BEFORE "-- Check alt list"

Add the following:

if previousEditBoxNameLen >= textlen then
previousEditBoxNameLen = textlen
return true

previousEditBoxNameLen = textlen

4) At the top locate:

"local enableAltsMenu"

Immediately after, add:

local previousEditBoxNameLen = 0

5) Scroll to:

function Postal_BlackBook:Reset(event)

After the line "self:UnregisterEvent("PLAYER_LEAVING_WORLD")"

add the following line:

previousEditBoxNameLen = 0

Done correctly (I did it), this should get rid of the LUA error on login and retain alt/friend list autocompletion prioritization.
Report comment to moderator  
Reply With Quote
Unread 08-09-09, 06:25 AM  
A Kobold Labourer

Forum posts: 0
File comments: 1
Uploads: 0
3.2 Temporary Fix

In order to get Postal to come up without an LUA error, one will need to modify two files. The first is in the ACE 3.0 definitions. the second is the authors usage of the ACE pack.

In the Modules directory, goto Blackbook.lua, delete line 41, here we eliminate a part of the function:

self:RawHook("PlayerNameAutocomplete", true)

At the top level of the addon postal directory, in the Postal.lua, goto line 35-44, here we eliminate the function definition:

BlackBook = {
AutoFill = true,
contacts = {},
recent = {},
global = {
BlackBook = {
alts = {},

We lose the alt/type-ahead functionality, but we no longer have a nag screen.

Good Luck!
Last edited by racingsquirrel : 08-09-09 at 06:28 AM.
Report comment to moderator  
Reply With Quote
Post A Reply

Category Jump:

Support AddOn Development!

You have just downloaded by the author . If you like this AddOn why not consider supporting the author? This author has set up a donation account. Donations ensure that authors can continue to develop useful tools for everyone.