Eloquence is a chat mod which attempts to filter as much of the stupidity out of the chat window as it can. PLEASE READ THE FULL DESCRIPTION, IT WILL ANSWER MOST QUESTIONS YOU MIGHT HAVE.
Jan 6, '10
Added in the newest instance abbreviations. I'll be putting in some time attempting to fix up the bugs. I should probably let you know that I really only use Elo to filter others chat, as in make it seem as though they actually have a working knowledge of the English language. I don't filter myself, nor do I use any of the RP elements of Elo. So, while I will be working on all things that have been reported here, I should say that my main concern is and will always be the parts that I actually use. If there are any RP players/other people out there that have or would like to dabble in WoW API coding and would like to help me fix up those parts of Elo that I don't use on a daily basis, send me a PM here and I'll get back to you. Thanks :)
________________________________
UPDATE: A new faster way to tell Elo to skip Profession and Achievement links that I've just discovered is to put the words "htrade" and "hachievement" into the Elo Skipword category detailed at the bottom of this description. As WoW links (the part you don't see without using Devtools :D) are configured like this (using First Aid for an example) :
|cffffd000|Htrade:27028:375:375:3111EE:xG{_yK|h[First Aid]|h|r
by telling Elo to skip htrade, it will automatically skip all Profession links, since Elo can see all those parts of chat you normally don't see. Same for Achievements.
Don't know why it never occurred to me to try that before. This will make it much faster to set up a skipword for each alt you may have. :) I still am working on figuring out how the code originally skipped links prior to Prof/Achieve links being added to the game, and adding them into it thus sparing the end user from having to make Elo Skipword lists in the first place.
It should be noted that this is still NOT, I repeat NOT a FULLY functional version. I have updated the TOC file and fixed the XML so the addon stops throwing errors. I've even added in most, I repeat MOST of the Northrend abbreviations, the ones that were easiest to get done anyway. Certain ones such as AN for Azjol Nerub or UP for Utgarde Pinnacle I haven't quite figured out how to get to work only when in LFG context as yet. /Shrug I'm working with legacy code here, and I'm still fairly new to Lua, sorry.
Thank you to all those still using this addon, I appreciate your continued support. Enjoy :)
________________________________
What Is It?
Eloquence is a linguistic mod that gives you control over communication. You can apply different levels of chat filters for yourself and others, trim long messages into clickable links, modify channel headers, apply colors to players' names, and manage spam in lots of ways.
I. Filters
Eloquence's biggest feature is the selectable filter settings. Anyone can appreciate its spell-checking and caps-squashing filters, while roleplayers will enjoy the various dialects. You can filter your own chat to other players, or you can keep your filtered experience totally private.
AVAILABLE FILTERS
Spell Book
The most basic yet important filter. Corrects common spelling and grammatical errors, reduces out-of-control repetition, and keeps people from shouting with all caps.
Decompression Engine
Expands Warcraft and MMO acronyms. Translates cryptic expressions like "288 lw lfw!" and "LF1M SMA PREF TANK!!!" into plain English
Emote Whiz
Verbalizes smilies, emoticons, and other ideogrammatic expressions.
Mouthwash
Replaces profanity and offensive words with more acceptable euphemisms.
Fantasy Writer
Rewrites many modern, out-of-character expressions with those found in fantasy literature.
Dialectician
Each speaker will speak in an accent or dialect based on his or her race. Eloquence detects player's races through a variety of means, but sometimes this isn't possible. Players of an unknown race are filtered using Fantasy Writer.
ALLIANCE DIALECTS
Human: In-character speech with some phrases like "King's honor, friend."
Dwarf: Everything's in Scots! "Ah'm no' shuir if that wull wirk, laddie."
Night Elf: Some Darnassian like "Asha'falah" and slightly formal language (few contractions).
Gnome: Quirky, brainy vocabulary and folksy cliches.
Draenei: Few contractions and some Draenei words.
HORDE DIALECTS
Orc: A few Orcish words and phrases like "Lok'tar" and "Zug zug".
Tauren: Formal language with some race-specific sayings like "Winds be at your back!"
Troll: Thick Jamaican basilectic patois with some Trollish like "Tas'dingo!"
Undead: A slight hiss that intensifies when they get excited. Several Forsaken sayings.
Blood Elf: Proud and cocky, with some phrases in Thelassian.
II. Chat Links
Eloquence offers two styles of Clickable Chat Links that trims long messages and tags them at the end. Clicking them will reveal the original (long) message. This way you can keep enchanters and guild recruiters from clogging your chat window! (Due to the way links are handled, it doesn't work on messages that contain linked items).
III. Headers
a. Eloquence can shorten common channel headers like "[1. General]" into a number "[4.]" or letter "[G.]". Several display styles are available.
b. Eloquence can color players' names based on their class and add their level, if Eloquence knows them. You can have players whose classes are unknown are assigned a random color if you wish. Eloquence can also color player's names inside chat messages for easy recognition.
IV. Display Options
Eloquence features multiple miscellaneous display options to give you more control over what you see in your chat window. The options window has checkboxes for suppressing chat spam, duel announcements, drunk/sober messages, coin spam, brackets, and PvP ranks.
V. Player Data
Some features need Eloquence to know something about a player speaking. These are the race-specific Level 4 filter and the "Names of Known Players" setting. If these options are enabled, Eloquence will passively gather info on your friends, party/raid/guild members, and players you mouse-over. You can also have Eloquence actively gather data when you change zones and talk to NPCs. A slider lets you choose how long to keep data. You can see how many player entries Eloquence has gathered, and purge the list if you wish.
VI. Text Commands
You can apply custom filters. For example, typing "/elo add gz = grats" (without quotes) will tell Eloquence to turn "gz" (as a whole word) into "grats". Custom filters are applied before Eloquence's are, so you can override the defaults this way too. For example, type "/elo add woot = woot" to keep Eloquence from altering the word "woot".
You can tell Eloquence to not filter certain players or channels. Type "/elo skip Thrakzor" (without quotes) to let Thrakzor's chat appear normally. Type "/elo channel Addon" to keep the custom channel "Addon" from being filtered at all.
You can also tell Eloquence to skip specific words. Type "/elo skipword (X)" (without quotes) to let any chat with word X appear unfiltered. EX: "/elo skipword achievement" will tell Eloquence NOT to filter any messages that appear in the chat frame with the word achievement in them. You will have to do this for every toon you have for now, I will work on getting profiles into the code in the future, if necessary (if I fix the links bug then this becomes much less of a hassle heh)
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...