comparison LFGFilter.txt @ 3:041bc456db50 v2

v2 - complete rework to use filtering expressions in search string
author ovolkov
date Wed, 21 Jan 2015 19:19:02 +0300
parents 0a42898d1dfa
children 9129e71852b0
comparison
equal deleted inserted replaced
2:db862491a577 3:041bc456db50
1 LFG Filter for Premade Groups 1 LFG Filter for Premade Groups, v2
2 2
3 It's great to have built-in Premade Group finder (aka LFG internally) except all the groups are mixed together and you need to carefully scan list to find that one raid or difficulty you've interested in or use TEXT based filter and risk missing groups you'd want. 3 It's great to have built-in Premade Group finder (aka LFG internally) except all the groups are mixed together and you need to carefully scan list to find that one raid or difficulty you've interested in or use TEXT based filter and risk missing groups you'd want.
4 4
5 This addon does two things right now: 5 == Features ==
6 1) Sorts all groups by raid/difficulty, so, say, all you SoO Mythic groups are together. 6 * Sorts all groups by raid/difficulty, so, say, all you heroic groups for some specific raid are together.
7 2) Allows you to filter search lists to only raid/difficulty you want, removing everything else from list. 7 * Allows you to filter search lists to only results you want, removing everything else from list.
8 8
9 UI and configuration is still work in progress, so you'll have to use slash commands and activity IDs. 9 == Filtering expressions ==
10 To filter results, enter a search expression into filter editbox on group search screen starting with =. Both text and expression will be used if you have some text before =. Expressions are constructed from variables that hold info on each found group and use Lua syntax and if you're unfamiliar with it, a short summary will be presented below. If you make an error while writing expression it will be printed in chat when you try to search and result list will be empty.
10 11
11 /lfgaf - add a list of activities you WANT TO SEE in your search. Enter it without any IDs to remove filters and see full list or enter a list of IDs for all activities you want to see. 12 === Supported variables ===
13 Logical values:
14 * highmaul - group is running Highmaul raid.
15 * normal - group is running normal difficulty.
16 * heroic - group is running heroic difficulty.
17 * my_server - group is running on my server. Useful for searching for trash runs or guild runs if you wish to join them later in mythic.
12 18
13 Some IDs: 19 String values, all strings are automatically converted to lower case to simplify your searches. You can use string functions listed below:
14 4 - Siege of Orgrimmar (Normal) 20 * name - group's name - that big yellow text.
15 41 - Siege of Orgrimmar (Heroic) 21 * comment - longish comment entered by group leader, that place where people usually put "bring curve" or something.
16 42 - Siege of Orgrimmar (Mythic)
17 347 - Throne of Thunder (10 Normal)
18 348 - Throne of Thunder (10 Heroic)
19 349 - Throne of Thunder (25 Heroic)
20 397 - World Bosses (Pandaria)
21 More can be found by opening group search and dumping list of current groups with /run LFGPrintRawResults(), but I'll add visual selection ASAP.
22 Second number is activity ID.
23 22
24 Examples: 23 Number values:
25 Only show SoO Mythic: 24 * ilvl - minimum ilevel required by group.
26 /lfgaf 42 25 * defeated - amount of bosses defeated.
26 * members - people already in group.
27 * tanks - amount of tanks.
28 * healers - amount of healers.
29 * damagers - amount of damagers.
27 30
28 Show all SoO difficulties: 31 === Short summary of Lua syntax ===
29 /lfgaf 4 41 42 32 * and, or, not - logical operators. "highmaul and normal" will find Highmaul normal raids, "highmaul and (normal or heroic)" will find Highmaul normal and heroic and will hide mythic.
33 * == - equal, ~= - not equal, comparison for everything.
34 * < > <= >= - comparison for numbers.
35 * :find - a string function, true if requested substring is present.
36 * :match - a string function, can be used for more complex searches with regular expressions. Look it up in Lua manual.
37 * () can be used to group and define precedence.
38
39 === Examples ===
40 * =highmaul and heroic and defeated == 0
41 ** Fresh Highmaul Heroic.
30 42
31 Change log: 43 * =highmaul and ((normal and (name:find("imp") or defeated == 6)) or (heroic and defeated == 1))
44 ** Find Highmaul raid groups, either normal with 6 bosses defeated or "imp" mentioned in name, or heroic with just one boss defeated.
45
46 * =highmaul and name:find("trash") and name:find("mythic") and my_server
47 ** Find Highmaul mythic trash runs on your server.
48
49 * =members > 3
50 ** Find groups with at least 3 members. It will skip some groups that's just starting, but will also reliably hide recruit ads and other spam.
51
52 == Change log ==
53 2014-01-21 v2
54 * Complete filtering rework: now works with expressions entered directly into group search filter field.
55
32 2014-11-12 v1 56 2014-11-12 v1
33 * Initial implementation: quest details and quest NPC portrait are now anchored to the right of quest list, quest list is no longer hidden when you check quest details. 57 * Initial implementation: sort + activity ID search.