Version 0.8.1-beta

- stop replacements on match
- better ooc recognition patterns

- keep cases of over-long replacements

.pkgmeta

@@ -4,6 +4,8 @@ enable-nolib-creation: no
 
 externals:
   libs/LibStub: https://repos.wowace.com/wow/libstub/tags/1.0
+  libs/LibDataBroker: https://github.com/tekkub/libdatabroker-1-1
+  libs/LibDBIcon: https://repos.curseforge.com/wow/libdbicon-1-0/trunk/LibDBIcon-1.0
   libs/CallbackHandler-1.0: https://repos.wowace.com/wow/callbackhandler/trunk/CallbackHandler-1.0
   libs/AceAddon-3.0: https://repos.wowace.com/wow/ace3/trunk/AceAddon-3.0
   libs/AceConfig-3.0: https://repos.wowace.com/wow/ace3/trunk/AceConfig-3.0

CHANGELOG.md

@@ -3,9 +3,37 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Upcoming] Version 0.8.0-beta - 2020-06-08
+## Version 0.8.1-beta - 2020-06-16
+### Added
+- stop replacements per mapping
+- more ooc recognition patterns
+### Fixed
+- keep cases of over-long replacements
+
+## Version 0.8.0-beta - 2020-06-14 [Feature Complete]
 ### Added
 - handle replacement via slash command
+- emote and ooc detection
+- de-/activate single mappings
+- move buttons are disabled when already at top/bottom or replacements were deactivated
+- minimap button is darkened when addon is disabled
+- help tab with examples
+### Changed
+- right-click on minimap button quickly de-/activates replacements
+### Fixed
+- mapping to raid warning, instance and battleground chats
+- localized raid target markers
+- capital % substitutions
+- incorrect consolidation
+- Umlaut and accent replacements
+
+## Version 0.7.2-beta - 2020-06-08
+### Added
+- minimap button
+### Changed
+- graphical move arrows
+### Fixed
+- crash on matches with 0-width
 
 ## Version 0.7.1-beta - 2020-06-07
 ### Added

Grichelde.lua

@@ -1,6 +1,7 @@
 --[[---------------------------------------------------------------------------
 
   Grichelde - Text Replacer
+
   Copyright 2020 Teilzeit-Jedi <tj@teilzeit-jedi.de>
 
   This addon is distributed in the hope that it will be useful,
@@ -19,39 +20,46 @@ local _G = _G
 
 -- initialize addon
 local Grichelde = LibStub("AceAddon-3.0"):NewAddon(AddonTable, AddonName, "AceConsole-3.0", "AceEvent-3.0", "AceHook-3.0")
-Grichelde.L = LibStub("AceLocale-3.0"):GetLocale("Grichelde", true)
 Grichelde.version = GetAddOnMetadata(AddonName, "Version")
 Grichelde.build = GetAddOnMetadata(AddonName, "X-Build") or "Experimental"
 Grichelde.classic = _G.WOW_PROJECT_ID == _G.WOW_PROJECT_CLASSIC
 Grichelde.logLevel = 0      -- cannot reference Grichelde.LOG_LEVELs here as they are loaded afterwards
 
 -- publish to global env
-_G.Grichelde = Grichelde
+_G[AddonName] = Grichelde
 
 -- Ace3 callbacks
 function Grichelde:OnInitialize()
+    self.L = LibStub("AceLocale-3.0"):GetLocale(self.name, true)
+
     -- Build Interface Options window
     self.db = self:LoadDatabase()
     self:UpgradeDatabase()
-
-    self.options, self.dialog = self:SetupOptions()
-
-    -- populate UI from database
-    self:RefreshOptions("OnProfileChanged")
-
-    self:SetupSlashCommands()
 end
 
 function Grichelde:OnEnable()
     -- Hook in before message is sent to replace all character occurrences where replacements have been defined in the options
     self:RawHook("SendChatMessage", true)
 
+    self.options, self.dialog = self:SetupOptions()
+    self:RefreshOptions("OnProfileChanged")
+
+    self.ldb, self.icon = self:MinimapButton()
+    self:SetupSlashCommands()
+
     -- tell the world we are listening
-    self:Print(self.L.AddonLoaded, self.COLOR_CODES.PREFIX .. self.L.AddonName .. " " .. self.L.VersionAbbr .. self.version .. self.COLOR_CODES.CLOSE)
+    if self.db.profile.enabled then
+        local namePlusVersion = self:Format(self.L.AddonNamePlusVersion, self.L.AddonName, self.version)
+        self:Print(self.L.AddonLoaded, self.COLOR_CODES.PREFIX .. namePlusVersion .. self.COLOR_CODES.CLOSE)
+    end
 end
 
 function Grichelde:OnDisable()
     self:Unhook("SendChatMessage")
+    self:CloseOptions()
+    self:HideMinimapButton()
+    self:UnregisterChatCommand("grichelde")
+    self:UnregisterChatCommand("gri")
 end
 
 --- Register  slash commands 'gri' and 'grichelde'
@@ -60,18 +68,21 @@ function Grichelde:SetupSlashCommands()
     self:RegisterChatCommand("gri", "HandleSlashCommand")
 end
 
-function Grichelde:HandleSlashCommand(input)
+function Grichelde:HandleSlashCommand(input, ...)
     -- Show the GUI if no input is supplied, otherwise handle the chat input.
     if self.functions.nilOrEmpty(input) then
-        LibStub("AceConfigDialog-3.0"):Open(self.name)
+        self:ToggleOptions()
     else
         -- handle slash ourselves
         self:DebugPrint("Handle slash command: " .. input)
         if input == "mappings" then
-            self:ShowMappings()
+            self:ToogleMappings()
-        end
+        elseif input == "options" then
-        if input == "options" then
+            self:ToggleOptions()
-            self:PrintOptions()
+        elseif input == "profile" then
+            self:PrintProfile()
+        else
+            self:SendChatMessageOverride(input, ...)
         end
     end
 end

Grichelde.toc

@@ -3,7 +3,7 @@
 ## Title: Grichelde
 ## Notes: Replaces characters from the chat box
 ## Notes-de: Ersetzt eingegebene Zeichen in der Chat-Zeile
-## Version: 0.7.1-beta
+## Version: 0.8.1-beta
 ## Author: Teilzeit-Jedi
 ## eMail: tj@teilzeit-jedi.de
 
@@ -11,19 +11,22 @@
 ## X-Curse-Project-ID: 385480
 ## X-License: GPLv3
 ## X-Category: Chat/Communication
-## X-Credits: Teilzeit-Jedi, Nathan Pieper
+## X-Credits: Teilzeit-Jedi
-## X-Embeds: Ace3
+## X-Embeds: LibStub, CallbackHandler, Ace3, LibDataBroker, LibDBIcon
 
-## OptionalDeps: Ace3
+## OptionalDeps: LibStub, CallbackHandler, Ace3, LibDataBroker, LibDBIcon
 ## SavedVariables: GricheldeDB
 
 libs.xml
-localisation.xml
 
 Grichelde.lua
 GricheldeConstants.lua
+
+localisation.xml
+
 GricheldeUtils.lua
 GricheldeDatabase.lua
 GricheldeUpgrade.lua
 GricheldeOptions.lua
+GricheldeMinimap.lua
 GricheldeChat.lua

GricheldeChat.lua

@@ -2,44 +2,107 @@
 local _G = _G
 local Grichelde = _G.Grichelde
 
-local nilOrEmpty, ipairs, spairs, tContains, tFilter, tInsert, tConcat, find, sub, isUpper, isLower, toUpper, toLower, trim, length
+local IsAddOnLoaded, assert, nilOrEmpty, pairs, ipairs, spairs, tContains, tFilter, tInsert, tConcat, tSize, tIsEmpty, find, sub, isUpper, isLower, toUpper, toLower, trim, length, lenUtf8
-    = Grichelde.functions.nilOrEmpty, Grichelde.functions.ipairs, Grichelde.functions.spairs, Grichelde.functions.tContains, Grichelde.functions.tFilter, Grichelde.functions.tInsert, Grichelde.functions.tConcat,
+    = Grichelde.functions.IsAddOnLoaded, Grichelde.functions.assert, Grichelde.functions.nilOrEmpty, Grichelde.functions.pairs, Grichelde.functions.ipairs, Grichelde.functions.spairs, Grichelde.functions.tContains, Grichelde.functions.tFilter, Grichelde.functions.tInsert, Grichelde.functions.tConcat, Grichelde.functions.tSize, Grichelde.functions.tIsEmpty,
-      Grichelde.functions.find, Grichelde.functions.sub, Grichelde.functions.isUpper, Grichelde.functions.isLower, Grichelde.functions.toUpper, Grichelde.functions.toLower, Grichelde.functions.trim, Grichelde.functions.length
+      Grichelde.functions.find, Grichelde.functions.sub, Grichelde.functions.isUpper, Grichelde.functions.isLower, Grichelde.functions.toUpper, Grichelde.functions.toLower, Grichelde.functions.trim, Grichelde.functions.length, Grichelde.functions.lenUtf8
+
+local function cleanseMessage(this, message)
+    local text = message or ""
+    if (IsAddOnLoaded("Misspelled")) then
+        this:DebugPrint("Misspelled detected: cleansing message")
+        text = _G.Misspelled:RemoveHighlighting(message)
+    end
+    return trim(text)
+end
 
 --- Before a chat message is sent, check if replacement is required and replace the text accordingly.
 -- @param message string
 -- @param type string
 -- @param language string
 -- @param channel string
-function Grichelde:SendChatMessage(message, type, language, channel, ...)
+function Grichelde:SendChatMessage(message, type, ...)
-    local replacedText = self:CheckAndReplace(message, type)
+    local text = cleanseMessage(self, message)
-
+    if (self:CheckReplacementAllowed(text, type)) then
-
+        text = self:ReplaceText(text)
-    -- Send text in chunks if length exceeds 255 bytes after replacement
-    local chunks = self:SplitText(replacedText)
-    self:DebugPrint("SendChatMessage : #chunks:", #chunks)
-
-    for _, chunk in ipairs(chunks) do
-        self.hooks["SendChatMessage"](chunk, type, language, channel, ...);
     end
+
+    self:SendChunkifiedChatMessage(text, type, ...)
 end
 
-function Grichelde:CheckAndReplace(message, type)
+--- Always replaces the text accoording to the configuration, even if activation or channel was disabled.
-    local text = message
+--- This is used the the override slash command: "/gri /emote text to replace".
-    if (self:CheckReplacement(text, type)) then
+--- NOTE: type and channel (in case of whispers) are determined from the message text.
-        if (_G.Misspelled) then
+-- @param message string
-            self:DebugPrint("Misspelled detected: cleansing message")
+-- @param type string
-            text = _G.Misspelled:RemoveHighlighting(text)
+function Grichelde:SendChatMessageOverride(message, ...)
+    local text = cleanseMessage(self, message)
+
+    local chatType, lang, channel = text, DEFAULT_CHAT_FRAME.editBox.chatType or "SAY", DEFAULT_CHAT_FRAME.editBox.languageID
+    local msg, type, chan = self:CheckAndExtractMessageTypeTarget(text)
+
+    if msg ~= nil then
+        msg = self:ReplaceText(msg)
+
+        if type ~= nil then
+            self:SendChunkifiedChatMessage(msg, type, lang, chan, ...)
+        else
+            self:SendChunkifiedChatMessage(msg, chatType, lang, channel, ...)
         end
-        text = self:ReplaceText(trim(text))
+    else
+        -- suppress invalid messages/channels/targets
     end
-    return text
 end
 
-function Grichelde:CheckReplacement(text, channel)
+--- Send text in chunks if length exceeds 255 bytes after replacement.
-    -- skip if not enabled
+function Grichelde:SendChunkifiedChatMessage(message, ...)
+    if length(message) > 255 then
+        local chunks = self:SplitText(message)
+        self:DebugPrint("SendChatMessage : #chunks:", #chunks)
+
+        for _, chunk in ipairs(chunks) do
+            self.hooks["SendChatMessage"](chunk, ...);
+        end
+    else
+        self.hooks["SendChatMessage"](message, ...);
+    end
+end
+
+local function IsOneBigEmote(this, text)
+    local firstWord, _ = this:SplitOnFirstMatch(text)
+    assert(firstWord ~= nil, "firstWord is never nil")
+
+    -- emote detection
+    local isOneBigEmote = false
+    -- scheme *emote*
+    if sub(firstWord, 1, 1) == "<" then
+        -- search for emote end
+        local _, emoteEnd = find(text, "%>", 2)
+        isOneBigEmote = (emoteEnd == length(text))
+    end
+    if not isOneBigEmote and sub(firstWord, 1, 1) == "*" then
+        -- search for emote end
+        local _, emoteEnd = find(text, "%*", 2)
+        isOneBigEmote = (emoteEnd == length(text))
+    end
+    -- scheme **emote**
+    if not isOneBigEmote and sub(firstWord, 1, 2) == "**" then
+        -- search for emote end
+        local _, emoteEnd = find(text, "%*%*", 3)
+        isOneBigEmote = (emoteEnd == length(text))
+    end
+
+    -- the whole text is one big emote
+    return isOneBigEmote
+end
+
+--- Checks if a message can be replaced according to configuration.
+-- @return boolean
+function Grichelde:CheckReplacementAllowed(text, channel)
+    self:DebugPrint("CheckReplacementAllowed : text:", text)
+
+    -- skip if disabled
     if (not self.db.profile.enabled) then
-        self:DebugPrint("CheckReplacement : disabled")
+        self:DebugPrint("CheckReplacementAllowed : disabled")
         return false
     end
 
@@ -49,35 +112,139 @@ function Grichelde:CheckReplacement(text, channel)
     end
 
     -- skip if wrong channel
+    local chan = self:ConvertBlizzTypeToOption(channel)
     local allowedChannels = tFilter(self.db.profile.channels,
-        function(_,v) return v == true end,
+        function(_, k, v) return k == chan and v == true end,
-        function(k,_) return k end
+        function(_, k, _) return k end
     )
-    self:DebugPrint("CheckReplacement : allowed channels:", tConcat(allowedChannels, ", "))
+    self:DebugPrint("CheckReplacementAllowed : allowed channels:")
-    local type = self:ConvertBlizChannelToType(channel)
+    self:DebugPrint(allowedChannels)
-    if (type == nil or not tContains(allowedChannels, type)) then
+
-        self:DebugPrint("CheckReplacement : skip channel type:", type)
+    if tIsEmpty(allowedChannels) then
+        self:DebugPrint("CheckReplacementAllowed : skip channel type:", chan)
         return false
     end
 
-    -- don't replace slash commands except chat related commands
+    local firstWord, _ = self:SplitOnFirstMatch(text)
-    if sub(text, 1, 1) == "/" then
+    assert(firstWord ~= nil, "firstWord is never nil")
-        local firstWord, _ = self:SplitOnFirstMatch(text)
+
-        -- todo: adapt allowed slash commands
+    -- don't replace slash commands
-        if (firstWord == nil or not tContains(self.slashCommands, firstWord)) then
+    if sub(firstWord, 1, 1) == "/" then
-            self:DebugPrint("CheckReplacement : ignore slash command")
+        self:DebugPrint("CheckReplacementAllowed : skip other slash commands:", firstWord)
-            return false
+        return false
-        end
     end
 
-    -- in any other case
+    -- emote detection
+    if IsOneBigEmote(self, text) then
+        self:DebugPrint("CheckReplacementAllowed : one big emote")
+        return self.db.profile.channels.emote
+    end
+
+    -- in any other case, treat as ordinary text or emote
     return true
 end
 
-function Grichelde:ConvertBlizChannelToType(channel)
+--- Checks if the text from the Grichelde slash command can be replaced and if so
-    local type = toLower(channel)
+--- returns the replacable text, the chat type and target (player or channel) from the message text.
-    self:DebugPrint("ConvertBlizChannelToType : convert %s to %s", channel, type)
+--- This is used the the override slash command: "/gri /emote text to replace".
-    return type
+-- @param text (string) the whole message
+-- @return message (string) stripped message
+-- @return type (string) chat type
+-- @return channel (string|number) channel number for whispers
+function Grichelde:CheckAndExtractMessageTypeTarget(text)
+    self:DebugPrint("CheckAndExtractMessageTypeTarget : text:", text)
+
+    -- skip if no further text
+    if nilOrEmpty(text) then
+        return nil      -- dont send text at all
+    end
+
+    -- first word should be a chat command
+    if sub(text, 1, 1) == "/" then
+        -- extract chat command
+        local chatCmd, targetAndText = self:SplitOnFirstMatch(text)
+        assert(chatCmd ~= nil, "chatCmd is never nil")
+
+        local type = tFilter(self.SUPPORTED_CHAT_COMMANDS,
+            function(_, k, _) return chatCmd == k end
+        )
+        self:DebugPrint("CheckAndExtractMessageTypeTarget : determined type:")
+        self:DebugPrint(type)
+
+        if not tIsEmpty(type) then
+            -- valid /chattype
+            if type[1] == "WHISPER" then
+                -- special reply handling
+                if "/r" == chatCmd or "/reply" == chatCmd then
+                    -- reuse last type and target if possible
+                    local lastTold, lastToldType = ChatEdit_GetLastToldTarget()
+                    self:DebugPrint("CheckAndExtractMessageTypeTarget : lastTell, lastTellType =", lastTold, lastToldType)
+                    return targetAndText, lastToldType or type[1], lastTold
+                elseif "/tt" == chatCmd then
+                    -- determine target from game world selection
+                    if (not UnitExists("target") or not UnitIsPlayer("target")) then
+                        self:ErrorPrint(self.L.Error_InvalidWhisperTarget)
+                        return nil      -- dont send text at all
+                    end
+
+                    local target = UnitName("target");
+                    if target == nil then
+                        self:ErrorPrint(self.L.Error_InvalidWhisperTarget)
+                        return nil -- dont send text at all
+                    end
+
+                    -- eventually we found our target
+                    self:DebugPrint("CheckAndExtractMessageTypeTarget : target:", target)
+                    return targetAndText, type[1], target
+                else
+                    -- determine target from text
+                    local target, msg = self:SplitOnFirstMatch(targetAndText)
+                    if target == nil then
+                        self:ErrorPrint(self.L.Error_InvalidWhisperTarget)
+                        return nil -- dont send text at all
+                    end
+
+                    -- eventually we found our target
+                    self:DebugPrint("CheckAndExtractMessageTypeTarget : determined target:", target)
+                    return msg, type[1], target
+                end
+            else
+                -- all other chat types
+                return targetAndText, type[1], nil
+            end
+        else
+            -- if not a valid chat command, try as a numbered channel
+            local _, _, channelNumber = find(chatCmd, "^/(%d+)")
+            if channelNumber ~= nil then
+                local channelId = GetChannelName(channelNumber)
+                if channelId ~= nil then
+                    return targetAndText, "CHANNEL", channelId
+                end
+            end
+
+            -- ignore any other slash commands
+            self:ErrorPrint(self.L.Error_InvalidChannel)
+            return nil      -- dont send text at all
+        end
+    elseif IsOneBigEmote(self, text) then
+        self:DebugPrint("CheckAndExtractMessageTypeTarget : determined EMOTE type")
+        return text, "EMOTE", nil
+    else
+        -- in any other case, treat as ordinary text, assume default type and channel
+        return text
+    end
+end
+
+function Grichelde:ConvertBlizzTypeToOption(channel)
+    local option = tFilter(self.BLIZZ_TYPE_TO_OPTIONS,
+        function(_, k, _) return channel == k end
+    )
+    if not tIsEmpty(option) then
+        self:DebugPrint("ConvertBlizzTypeToOption : convert %s to %s", channel, option[1])
+        return option[1]
+    else
+        return nil
+    end
 end
 
 --- Replaces all character occurrences for which replacements have been defined in the options,
@@ -85,33 +252,25 @@ end
 -- @param text string
 -- @return string
 function Grichelde:ReplaceText(text)
-    local lookAheads = {'|', '{', '%'}
+    local lookAheads = {'|', '{', '%', '*', '<', '(', 'o'}
-    local finalText = ""
     local newText = text
+    local finalText = ""
 
-    -- don't replace non-chat related slash commands
+    local currentChar, previousChar
-    local firstWord, line = self:SplitOnFirstMatch(text)
-    if (firstWord ~= nil and tContains(self.slashCommands, firstWord)) then
-        self:DebugPrint("ReplaceText : Found slash command:", firstWord )
-        -- skip chat slash command
-        finalText = finalText .. firstWord .. ' '
-        newText = line
-    end
-
     local current = 1
     local lastStart = 1
 
     while current <= length(newText) do
-        local currentChar = sub(newText, current, current)
+        previousChar = currentChar
+        currentChar = sub(newText, current, current)
         self:TracePrint("current/char : %s,%s", current, currentChar)
 
         if ( not tContains(lookAheads, currentChar)) then
             current = current + 1
         else
-
+            -- lookahead-check for all preservable patterns (itemLinks, textures, emotes, ooc, etc.)
-            -- lookahead-check for itemLinks, textures and raid target icons
             local textAhead = sub(newText, current)
-            local posEnd = self:CheckForPreversableText(textAhead)
+            local posEnd = self:CheckForPreversableText(textAhead, previousChar)
             if posEnd > 0 then
                 self:DebugPrint("ReplaceText : Found an ignore pattern")
 
@@ -136,57 +295,69 @@ function Grichelde:ReplaceText(text)
     finalText = finalText .. replacement
 
     self:DebugPrint("ReplaceText : replaced \"%s\"", text)
-    self:DebugPrint("ReplaceText : with         \"%s\"", finalText)
+    self:DebugPrint("ReplaceText : with        \"%s\"", finalText)
     return finalText
 end
 
 
---- Checks if the text starts with a preversable ignore pattern, such as itemLinks, textures, raid target icons or
+--- Checks if the text starts with a preversable ignore pattern, such as itemLinks, textures, raid target icons,
---- %-substitutons and returns the end location of the match, or 0 if no pattern was found
+--- emotes, ooc or %-substitutons and returns the end location of the match, or 0 if no pattern was found
 -- @param text string
 -- @return number
-function Grichelde:CheckForPreversableText(text)
+function Grichelde:CheckForPreversableText(text, previousChar)
-    self:DebugPrint("CheckForPreversableText : text:", text)
+    self:TracePrint("CheckForPreversableText : text:", text)
 
-    -- do not replace these patterns
+    -- Calling find on ever pattern might be inefficient but its way less code than marching over every character
-    local ignorePatterns = {
+    for _, pattern in ipairs(Grichelde.IGNORE_PATTERNS_CASE_SENSITIVE) do
-        "|[Cc]%x%x%x%x%x%x%x%x.-|r", -- colored items (or links)
-        "|H.-|h", -- item links (http://www.wowwiki.com/ItemLink)
-        "|T.-|t", -- textures
-        "|K.-|k", -- Battle.net
-        "|n", -- newline
-
-        "{rt[1-8]}",  -- rumbered raid target icons
-        "{Star}",     -- named raid target icon 1
-        "{Circle}",   -- named raid target icon 2
-        "{Coin}",     -- named raid target icon 2
-        "{Diamond}",  -- named raid target icon 3
-        "{Triangle}", -- named raid target icon 4
-        "{Moon}",     -- named raid target icon 5
-        "{Square}",   -- named raid target icon 6
-        "{Cross}",    -- named raid target icon 7
-        "{X}",        -- named raid target icon 7
-        "{Skull}",    -- named raid target icon 8
-
-        "%%n",   -- player's name
-        "%%z",   -- player's currnt zone
-        "%%sz",  -- player's current sub-zone
-        "%%loc", -- player's map coordinates
-        "%%t",   -- name of target
-        "%%f",   -- name of focus target
-        "%%m",   -- name of mouseover unit
-        "%%p",   -- name of player pet
-        "%%tt"   -- name of player's target's target
-    }
-
-    -- Calling find on ever pattern might be inefficient but its way less code.
-    for _, pattern in ipairs(ignorePatterns) do
         local pos1, pos2 = find(text, pattern)
         if pos1 == 1 and pos2 ~= nil then
             self:DebugPrint("CheckForPreversableText : Found ignore pattern \"%s\" at (%d, %d)", pattern, pos1, pos2)
             return pos2
         end
     end
+
+    -- emote detection
+    for _, pattern in ipairs(Grichelde.EMOTE_PATTERNS) do
+        local pos1, pos2 = find(text, pattern)
+        if pos1 == 1 and pos2 ~= nil then
+            local emote = sub(text, pos1, pos2)
+            if (not self.db.profile.channels.emote) then
+                self:DebugPrint("CheckForPreversableText : Found emote \"%s\" but preserved it", emote)
+                return pos2
+            else
+                self:DebugPrint("CheckForPreversableText : Found emote \"%s\" at (%d, %d)", emote, pos1, pos2)
+            end
+        end
+    end
+
+    -- %-substitutions
+    local lowerText = toLower(text)
+    for _, pattern in ipairs(Grichelde.IGNORE_PATTERNS_CASE_INSENSITIVE) do
+        local pos1, pos2 = find(lowerText, pattern)
+        if pos1 == 1 and pos2 ~= nil then
+            self:DebugPrint("CheckForPreversableText : Found ignore pattern \"%s\" at (%d, %d)", pattern, pos1, pos2)
+            return pos2
+        end
+    end
+
+    -- Localized raid target markers
+    for _, localizedRT in ipairs(Grichelde.LOCALIZED_RAID_TARGETS) do
+        local translation = toLower(self.L["IgnorePattern_" .. localizedRT])
+        local locPattern = "{" .. translation .. "}"
+        self:TracePrint("CheckForPreversableText : locPattern:", locPattern)
+        local pos1, pos2 = find(lowerText, locPattern)
+        if pos1 == 1 and pos2 ~= nil then
+            self:DebugPrint("CheckForPreversableText : Found localized raid target marker \"%s\" at (%d, %d)", locPattern, pos1, pos2)
+            return pos2
+        end
+    end
+
+    -- ooc detection remaing text is treated as ooc completely!
+    if (previousChar == nil or previousChar == ' ') and find(lowerText, "^ooc[%:%s]") then
+        self:DebugPrint("CheckForPreversableText : ooc for remaing text")
+        return length(text)
+    end
+
     self:DebugPrint("CheckForPreversableText : no ignore pattern found")
     return 0
 end
@@ -201,13 +372,14 @@ function Grichelde:ReplaceCharacters(text)
 
     local result = text
     local consolidate = {}
+    local stopOnMatch = nil
 
     -- replacements are done first
     for replName, replTable in spairs(replacements) do
         local before = result
         local search = replTable.searchText
 
-        if not nilOrEmpty(search) then
+        if not nilOrEmpty(search) and replTable.active then
             local replace = replTable.replaceText
             consolidate[replName] = {}
 
@@ -218,11 +390,15 @@ function Grichelde:ReplaceCharacters(text)
                 local oldResult = result
 
                 local pos1, pos2 = find(oldResult, search, pos)
-                while (pos1 and pos2) do
+                self:TracePrint("ReplaceCharacters : pos1: %d, pos2: %d", pos1, pos2)
-                    self:TracePrint("pos1: %d, pos2: %d", pos1, pos2)
+                while (pos1 and pos2 and pos1 <= pos2) do
+                    if replTable.stopOnMatch and stopOnMatch == nil then
+                        stopOnMatch = replName
+                    end
+
                     local pre = sub(result, 1, pos1 - 1 + offset)
                     local post = sub(result, pos2 + 1 + offset)
-                    self:TracePrint("pre: %s, post: %s", pre, post)
+                    self:TracePrint("ReplaceCharacters : pre: %s, post: %s", pre, post)
 
                     -- actual replacement
                     result = pre .. replace .. post
@@ -233,9 +409,21 @@ function Grichelde:ReplaceCharacters(text)
                         tInsert(consolidate[replName], pos1 + offset)
                     end
 
+                    -- update previous consolidate markers
+                    local diff = length(replace) - length(search)
+                    for key, posList in pairs(consolidate) do
+                        if key ~= replName then
+                            for i, pc in ipairs(posList) do
+                                if pos1 < pc then
+                                    consolidate[key][i] = consolidate[key][i] + diff
+                                end
+                            end
+                        end
+                    end
+
                     -- replacement text can lengthen or shorten the resulting text
                     -- after replacement result and lowerResult can have different sizes
-                    offset = offset + length(replace) - length(search)
+                    offset = offset + diff
                     -- update values for next iteration
                     pos = pos2 + 1
                     pos1, pos2 = find(oldResult, search, pos)
@@ -247,58 +435,72 @@ function Grichelde:ReplaceCharacters(text)
                 local lowerSearch = toLower(search)
 
                 local pos1, pos2 = find(lowerResult, lowerSearch, pos)
-                while (pos1 and pos2) do
+                self:TracePrint("ReplaceCharacters : pos1: %d, pos2: %d", pos1, pos2)
-                    self:TracePrint("pos1: %d, pos2: %d", pos1, pos2)
+                while (pos1 and pos2 and pos1 <= pos2) do
+                    if replTable.stopOnMatch and stopOnMatch == nil then
+                        stopOnMatch = replName
+                    end
+
                     local pre = sub(result, 1, pos1 - 1 + offset)
                     local match = sub(result, pos1 + offset, pos2 + offset)
                     local post = sub(result, pos2 + 1 + offset)
-                    self:TracePrint("pre: %s, match: %s, post: %s", pre, match, post)
+                    self:TracePrint("ReplaceCharacters : pre: %s, match: %s, post: %s", pre, match, post)
 
                     -- keep cases
+                    local utf8, uc, tc = nil, 0, 0
                     local repl = ""
                     local lastCase = nil
                     for p = pos1, pos2 do
-                        self:TracePrint("p: %d", p)
+                        self:TracePrint("ReplaceCharacters : p: %d", p)
                         local c = sub(match, p - pos1 + 1, p - pos1 + 1)
-                        local r = sub(replace, p - pos1 + 1, p - pos1 + 1) or ""
+                        -- put together umlaut or accent
-
+                        if utf8 ~= nil then
-                        if (isUpper(c)) then            -- all UPPER-CASE letter
+                            c = utf8 .. c
-                            lastCase = true
+                            utf8 = nil
-                            repl = repl .. toUpper(r)
-                        elseif (isLower(match)) then    -- all lower_case letter
-                            lastCase = false
-                            repl = repl .. toLower(r)
-                        else                            -- no letter
-                            lastCase = nil
-                            repl = repl .. r
                         end
-                        self:TracePrint("character: %s, %s", c, r)
-                    end
 
-                    self:TracePrint("length %d > %d", length(replace), pos2 - pos1 + 1)
+                        -- if not umlaut or accent
-                    if (length(replace) > pos2 - pos1 + 1) then
+                        if c ~= "\195" then
-                        local remainingReplace = sub(replace, pos2 - pos1 + 2)
+                            local r = sub(replace, p - pos1 + 1 - uc + tc, p - pos1 + 1 - uc + tc) or ""
-                        local nextLetter = sub(post, 1, 1)
+                            if r == "\195" then
-
+                                r = sub(replace, p - pos1 + 1 - uc + tc, p - pos1 + 1 - uc + tc + 1) or ""
-                        self:TracePrint("rest: %s, n: %s, lastCase: %s", remainingReplace, nextLetter, lastCase)
+                                tc = tc + 1
-
-                        if (isUpper(nextLetter)) then
-                            if lastCase == nil or lastCase == false then
-                                repl = repl .. remainingReplace
-                            else
-                                repl = repl .. toUpper(remainingReplace)
                             end
-                        elseif (isLower(nextLetter)) then
+                            self:TracePrint("ReplaceCharacters : character: %s, %s", c, r)
-                            if lastCase == nil or lastCase == true then
+
-                                repl = repl .. remainingReplace
+                            if (isUpper(c)) then            -- UPPER-CASE letter
-                            else
+                                lastCase = true
-                                repl = repl .. toLower(remainingReplace)
+                                repl = repl .. toUpper(r)
+                            elseif (isLower(c)) then        -- lower_case letter
+                                lastCase = false
+                                repl = repl .. toLower(r)
+                            else                            -- no letter
+                                lastCase = nil
+                                repl = repl .. r
                             end
                         else
-                            -- no letter
+                            -- handle UTF8 characters
-                            if lastCase == nil then
+                            utf8 = c
+                            uc = uc + 1
+                        end
+                    end
+
+                    self:TracePrint("ReplaceCharacters : length %d > %d", length(replace), pos2 - pos1 + 1 - uc + tc)
+                    if (length(replace) > pos2 - pos1 + 1 - uc + tc) then
+                        local remainingReplace = sub(replace, pos2 - pos1 + 2 - uc + tc)
+                        local nextLetter = sub(post, 1, 1)
+                        self:TracePrint("ReplaceCharacters : rest: %s, n: %s, lastCase: %s", remainingReplace, nextLetter, lastCase)
+
+                        if lastCase == nil then
+                            if (isUpper(nextLetter)) then
+                                repl = repl .. toUpper(remainingReplace)
+                            else
                                 repl = repl .. remainingReplace
-                            elseif lastCase == false then
+                            end
+                        elseif lastCase == false then
+                            repl = repl .. remainingReplace
+                        else
+                            if (isLower(nextLetter)) then
                                 repl = repl .. toLower(remainingReplace)
                             else
                                 repl = repl .. toUpper(remainingReplace)
@@ -308,16 +510,30 @@ function Grichelde:ReplaceCharacters(text)
 
                     -- actual replacement
                     result = pre .. repl .. post
-                    self:DebugPrint("result: %s", result)
+                    self:DebugPrint("ReplaceCharacters : result: %s", result)
 
                     -- remember positions for consolidate
                     if replTable.consolidate then
                         tInsert(consolidate[replName], pos1 + offset)
+                        self:TracePrint("consolidate[" .. replName .. "] is:")
+                        self:TracePrint(consolidate[replName])
+                    end
+
+                    -- update previous consolidate markers
+                    local diff = length(repl) - length(lowerSearch)
+                    for key, posList in pairs(consolidate) do
+                        if key ~= replName then
+                            for i, pc in ipairs(posList) do
+                                if pos1 < pc then
+                                    consolidate[key][i] = consolidate[key][i] + diff
+                                end
+                            end
+                        end
                     end
 
                     -- replacement text can be longer or shorter the resulting text
                     -- after replacement result and lowerResult can have different sizes
-                    offset = offset + length(repl) - length(lowerSearch)
+                    offset = offset + diff
                     -- update values for next iteration
                     pos = pos2 + 1
                     pos1, pos2 = find(lowerResult, lowerSearch, pos)
@@ -327,18 +543,25 @@ function Grichelde:ReplaceCharacters(text)
             if before ~= result then
                 self:DebugPrint("ReplaceCharacters : replaced \"%s\" with \"%s\"", before, result)
             end
+            if replTable.consolidate then
+                self:DebugPrint("consolidate[" .. replName .. "] is:")
+                self:DebugPrint(consolidate[replName])
+            end
         else
-            self:DebugPrint("ReplaceCharacters : Skip replacement for empty mapping")
+            self:DebugPrint("ReplaceCharacters : Skip replacement for %s", replName)
+        end
+
+        if stopOnMatch ~= nil then
+            break
         end
     end
 
     -- consolidation is done last
     for replName, replTable in spairs(replacements) do
         local before = result
-        --local search = replTable.searchText
         local search = replTable.searchText
 
-        if not nilOrEmpty(search) then
+        if not nilOrEmpty(search) and replTable.active then
             local replace = replTable.replaceText
             local lowerResult = toLower(result)
             local offset = 0
@@ -350,20 +573,20 @@ function Grichelde:ReplaceCharacters(text)
 
                 for _, pos1 in spairs(consolidate[replName]) do
                     local pos2 = pos1 + length(replace) - 1
-                    self:TracePrint("pos1: %d, pos2: %d", pos1, pos2)
+                    self:TracePrint("ReplaceCharacters : pos1: %d, pos2: %d", pos1, pos2)
-                    local match = sub(lowerResult, pos1, pos2)
+                    local match = toLower(replace)
                     local next = sub(lowerResult, pos2 + 1, pos2 + 1 + pos2 - pos1)
-                    self:TracePrint("match: %s, next: %s", match, next)
+                    self:TracePrint("ReplaceCharacters : match: %s, next: %s", match, next)
 
                     local _, p2 = find(next, "^" .. match)
-                    self:TracePrint("p2: %d", p2)
+                    self:TracePrint("ReplaceCharacters : p2: %d", p2)
                     if (p2) then
                         result = sub(result, 1, pos2 + offset) .. sub(result, pos2 + 1 + p2 + offset)
 
                         -- consolidation will shorten the resulting text
                         offset = offset + length(result) - length(lowerResult)
                     end
-                    self:DebugPrint("result: %s", result)
+                    self:DebugPrint("ReplaceCharacters : result: %s", result)
                 end
             end
 
@@ -371,7 +594,11 @@ function Grichelde:ReplaceCharacters(text)
                 self:DebugPrint("ReplaceCharacters : consolidate \"%s\" with \"%s\"", before, result)
             end
         else
-            self:DebugPrint("ReplaceCharacters : Skip consolidation for empty mapping")
+            self:DebugPrint("ReplaceCharacters : Skip consolidation for %s", replName)
+        end
+
+        if stopOnMatch == replName then
+            break
         end
     end
 

GricheldeConstants.lua

@@ -8,8 +8,24 @@ Grichelde.LOG_LEVEL.DEBUG = 1
 Grichelde.LOG_LEVEL.TRACE = 2
 
 Grichelde.MAPPING_OFFSET = 10
+Grichelde.MINIMAP_ENABLED = 1.0
+Grichelde.MINIMAP_DARKENDED = 0.5
+
+Grichelde.ICONS = {}
+Grichelde.ICONS.MOVE_UP = "Interface\\MainMenuBar\\UI-MainMenu-ScrollUpButton-Up"
+Grichelde.ICONS.MOVE_UP_DISABLED = "Interface\\MainMenuBar\\UI-MainMenu-ScrollUpButton-Disabled"
+Grichelde.ICONS.MOVE_DOWN = "Interface\\MainMenuBar\\UI-MainMenu-ScrollDownButton-Up"
+Grichelde.ICONS.MOVE_DOWN_DISABLED = "Interface\\MainMenuBar\\UI-MainMenu-ScrollDownButton-Disabled"
+Grichelde.ICONS.DELETE = "Interface\\Buttons\\UI-Panel-MinimizeButton-Up"
+Grichelde.ICONS.DELETE_DISABLED = "Interface\\Buttons\\UI-Panel-MinimizeButton-Disabled"
 
 -- colors:
+Grichelde.COLORS = {}
+Grichelde.COLORS.NORMAL    = _G.NORMAL_FONT_COLOR
+Grichelde.COLORS.HIGHLIGHT = _G.HIGHLIGHT_FONT_COLOR
+Grichelde.COLORS.RED       = _G.RED_FONT_COLOR
+Grichelde.COLORS.GREEN     = _G.GREEN_FONT_COLOR
+
 Grichelde.COLOR_CODES = {}
 Grichelde.COLOR_CODES.PREFIX      = "|c00FFAA00"
 -- https://github.com/stoneharry/Misc-WoW-Stuff/blob/master/EoC%20Interface/FrameXML/Constants.lua
@@ -25,7 +41,110 @@ Grichelde.COLOR_CODES.LIGHTYELLOW = _G.LIGHTYELLOW_FONT_COLOR_CODE or "|cffffff9
 Grichelde.COLOR_CODES.ORANGE      = _G.ORANGE_FONT_COLOR_CODE      or "|cffff7f3f"
 Grichelde.COLOR_CODES.CLOSE       = _G.FONT_COLOR_CODE_CLOSE       or "|r"
 
-Grichelde.slashCommands = { "/s", "/say", "/e", "/em", "/me", "/emote", "/y", "/yell", "/sh", "/shout", "/p", "/party", "/pl", "/partyleader", "/g", "/gc", "/guild", "/o", "/osay", "/officer", "/raid", "/rsay", "/rl", "/raidleader", "/rw", "/raidwarning", "/i", "/instance", "/bg", "/battleground", "/w", "/whisper", "/t", "/tell", "/send", "/r", "/reply" }
+Grichelde.SLASH_COMMANDS = { "gri", "grichelde" }
+
+Grichelde.SUPPORTED_CHAT_COMMANDS = {
+    ["/s"]               = "SAY",
+    ["/say"]             = "SAY",
+    ["/sprechen"]        = "SAY",
+    ["/c"]               = "CHANNEL",
+    ["/csay"]            = "CHANNEL",
+    ["/e"]               = "EMOTE",
+    ["/em"]              = "EMOTE",
+    ["/me"]              = "EMOTE",
+    ["/emote"]           = "EMOTE",
+    ["/y"]               = "YELL",
+    ["/yell"]            = "YELL",
+    ["/sh"]              = "YELL",
+    ["/shout"]           = "YELL",
+    ["/schreien"]        = "YELL",
+    ["/sch"]             = "YELL",
+    ["/p"]               = "PARTY",
+    ["/party"]           = "PARTY",
+    ["/gruppe"]          = "PARTY",
+    ["/pl"]              = "PARTY",
+    ["/partyleader"]     = "PARTY",
+    ["/g"]               = "GUILD",
+    ["/gc"]              = "GUILD",
+    ["/guild"]           = "GUILD",
+    ["/gilde"]           = "GUILD",
+    ["/o"]               = "OFFICER",
+    ["/osay"]            = "OFFICER",
+    ["/officer"]         = "OFFICER",
+    ["/offizier"]        = "OFFICER",
+    ["/raid"]            = "RAID",
+    ["/rsay"]            = "RAID",
+    ["/rl"]              = "RAID",
+    ["/rsay"]            = "RAID",
+    ["/raidleader"]      = "RAID",
+    ["/schlachtzug"]     = "RAID",
+    ["/rw"]              = "RAID_WARNING",
+    ["/raidwarning"]     = "RAID_WARNING",
+    ["/i"]               = "INSTANCE_CHAT",
+    ["/instance"]        = "INSTANCE_CHAT",
+    ["/instanz"]         = "INSTANCE_CHAT",
+    ["/bg"]              = "BATTLEGROUND",
+    ["/battleground"]    = "BATTLEGROUND",
+    ["/schlachfeld"]     = "BATTLEGROUND",
+    ["/w"]               = "WHISPER",
+    ["/whisper"]         = "WHISPER",
+    ["/t"]               = "WHISPER",
+    ["/tell"]            = "WHISPER",
+    ["/send"]            = "WHISPER",
+    ["/tt"]              = "WHISPER",
+    ["/r"]               = "WHISPER",
+    ["/reply"]           = "WHISPER",
+    ["/fl\195\188stern"] = "WHISPER",
+    ["/antworten"]       = "WHISPER",
+}
+
+Grichelde.BLIZZ_TYPE_TO_OPTIONS = {
+    ["SAY"]          = "say",
+    ["EMOTE"]        = "emote",
+    ["YELL"]         = "yell",
+    ["PARTY"]        = "party",
+    ["GUILD"]        = "guild",
+    ["OFFICER"]      = "officer",
+    ["RAID"]         = "raid",
+    ["RAID_WARNING"] = "raidWarning",
+    ["INSTANCE"]     = "instance",
+    ["BATTLEGROUND"] = "battleground",
+    ["WHISPER"]      = "whisper",
+}
+
+-- do not replace these patterns
+Grichelde.IGNORE_PATTERNS_CASE_SENSITIVE = {
+    "|[Cc]%x%x%x%x%x%x%x%x.-|r", -- colored items (or links)
+    "|H.-|h",     -- item links (http://www.wowwiki.com/ItemLink)
+    "|T.-|t",     -- textures
+    "|K.-|k",     -- Battle.net
+    "|n",         -- newline
+
+    "%(%(.-%)%)",           -- (( ... ))
+    "%(%s*ooc[%:%s].-%)",   -- ( ooc )
+}
+
+-- for separate emote detection
+Grichelde.EMOTE_PATTERNS = {
+    "%*.-%*",     -- emotes *
+    "%*%*.-%*%*", -- emotes **
+    "%<.-%>"      -- emotes < >
+}
+
+Grichelde.IGNORE_PATTERNS_CASE_INSENSITIVE = {
+    "{rt[1-8]}",  -- rumbered raid target icons, localized raid targets are handled differently
+    "%%n",        -- player's name
+    "%%z",        -- player's currnt zone
+    "%%sz",       -- player's current sub-zone
+    "%%loc",      -- player's map coordinates
+    "%%t",        -- name of target
+    "%%f",        -- name of focus target
+    "%%m",        -- name of mouseover unit
+    "%%p",        -- name of player pet
+    "%%tt"        -- name of player's target's target
+}
+
+Grichelde.LOCALIZED_RAID_TARGETS = { "Star", "Circle", "Diamond", "Triangle", "Moon", "Square", "Cross", "Skull" }
 
 local function nilOrEmpty(s)
     return s == nil or s:trim() == ""
@@ -58,12 +177,25 @@ local function spairs(t, orderFunc)
     end
 end
 
-local function tFilter(t, cond, extr)
+local function tFilter(t, condition, extract)
     local filtered = {}
     for key, value in Grichelde.functions.pairs(t) do
-        if cond(key, value) then
+        local cond = false
-            local val = extr(key, value)
+        if condition then
-            Grichelde.functions.tInsert(filtered, #filtered + 1, val)
+            local t = Grichelde.functions.type(condition)
+            if t == "function" then
+                cond = condition(t, key, value)
+            elseif t == "string" or t == "number" then
+                cond = (value == condition)
+            end
+        end
+
+        if cond then
+            local val = value
+            if extract and Grichelde.functions.type(extract) == "function" then
+                val = extract(t, key, value)
+            end
+            Grichelde.functions.tInsert(filtered, val)
         end
     end
     return filtered
@@ -80,6 +212,11 @@ local function tSize(t)
     return size
 end
 
+local function tIsEmpty(t)
+    if (not t) then return true end
+    return Grichelde.functions.tNext(t) == nil
+end
+
 local function tClone(orig)
     local orig_type = Grichelde.functions.type(orig)
     local copy
@@ -97,7 +234,7 @@ local function tClone(orig)
 end
 
 local function isChar(word)
-    return Grichelde.functions.find(word, "%a+")
+    return Grichelde.functions.find(word, "[%z\65-\90\97-\122\195-\197][\128-\191]?")
 end
 
 local function isNumber(digit)
@@ -118,44 +255,79 @@ local function isCapital(word)
         and Grichelde.functions.isLower(Grichelde.functions.sub(word,2))
 end
 
+local function color(color, text)
+    return color .. text .. Grichelde.COLOR_CODES.CLOSE
+end
+
+local function cPrefix(text)
+    return Grichelde.functions.color(Grichelde.COLOR_CODES.PREFIX, text)
+end
+
+local function cYellow(text)
+    return Grichelde.functions.color(Grichelde.COLOR_CODES.NORMAL, text)
+end
+
+local function cGray(text)
+    return Grichelde.functions.color(Grichelde.COLOR_CODES.GRAY, text)
+end
+
+local function cDarkgray(text)
+    return Grichelde.functions.color(Grichelde.COLOR_CODES.DARKGRAY, text)
+end
+
+local function cOrange(text)
+    return Grichelde.functions.color(Grichelde.COLOR_CODES.ORANGE, text)
+end
+
 -- faster function lookups by mapping to local refs
 Grichelde.functions = {}
-Grichelde.functions.type         = _G.type
+Grichelde.functions.IsAddOnLoaded = _G.IsAddOnLoaded
-Grichelde.functions.print        = _G.print
+Grichelde.functions.assert        = _G.assert
-Grichelde.functions.nilOrEmpty   = nilOrEmpty
+Grichelde.functions.type          = _G.type
-Grichelde.functions.pairs        = _G.pairs
+Grichelde.functions.print         = _G.print
-Grichelde.functions.ipairs       = _G.ipairs
+Grichelde.functions.nilOrEmpty    = nilOrEmpty
-Grichelde.functions.spairs       = spairs
+Grichelde.functions.pairs         = _G.pairs
-Grichelde.functions.tContains    = _G.tContains
+Grichelde.functions.ipairs        = _G.ipairs
-Grichelde.functions.tFilter      = tFilter
+Grichelde.functions.spairs        = spairs
-Grichelde.functions.tInsert      = _G.table.insert
+Grichelde.functions.tContains     = _G.tContains
-Grichelde.functions.tConcat      = _G.table.concat
+Grichelde.functions.tFilter       = tFilter
-Grichelde.functions.tSize        = tSize
+Grichelde.functions.tInsert       = _G.table.insert
-Grichelde.functions.tSort        = _G.table.sort
+Grichelde.functions.tConcat       = _G.table.concat
-Grichelde.functions.tClone       = tClone
+Grichelde.functions.tSize         = tSize
-Grichelde.functions.tNext        = _G.next
+Grichelde.functions.tIsEmpty      = tIsEmpty
-Grichelde.functions.setmetatable = _G.setmetatable
+Grichelde.functions.tSort         = _G.table.sort
-Grichelde.functions.getmetatable = _G.getmetatable
+Grichelde.functions.tClone        = tClone
-Grichelde.functions.select       = _G.select
+Grichelde.functions.tNext         = _G.next
-Grichelde.functions.unpack       = _G.unpack
+Grichelde.functions.tWipe         = _G.wipe
-Grichelde.functions.find         = _G.string.find
+Grichelde.functions.setmetatable  = _G.setmetatable
-Grichelde.functions.sub          = _G.string.sub
+Grichelde.functions.getmetatable  = _G.getmetatable
-Grichelde.functions.gsub         = _G.string.gsub
+Grichelde.functions.select        = _G.select
-Grichelde.functions.match        = _G.strmatch
+Grichelde.functions.unpack        = _G.unpack
-Grichelde.functions.join         = _G.strjoin
+Grichelde.functions.find          = _G.string.find
-Grichelde.functions.split        = _G.strsplit
+Grichelde.functions.sub           = _G.string.sub
-Grichelde.functions.toUpper      = _G.strupper
+Grichelde.functions.gsub          = _G.string.gsub
-Grichelde.functions.toLower      = _G.strlower
+Grichelde.functions.match         = _G.strmatch
-Grichelde.functions.isChar       = isChar
+Grichelde.functions.join          = _G.strjoin
-Grichelde.functions.isNumber     = isNumber
+Grichelde.functions.split         = _G.strsplit
-Grichelde.functions.isUpper      = isUpper
+Grichelde.functions.toUpper       = _G.strupper
-Grichelde.functions.isLower      = isLower
+Grichelde.functions.toLower       = _G.strlower
-Grichelde.functions.isCapital    = isCapital
+Grichelde.functions.isChar        = isChar
-Grichelde.functions.format       = _G.string.format
+Grichelde.functions.isNumber      = isNumber
-Grichelde.functions.rep          = _G.string.rep
+Grichelde.functions.isUpper       = isUpper
-Grichelde.functions.trim         = _G.strtrim
+Grichelde.functions.isLower       = isLower
-Grichelde.functions.length       = _G.string.len
+Grichelde.functions.isCapital     = isCapital
-Grichelde.functions.toString     = _G.tostring
+Grichelde.functions.color         = color
-Grichelde.functions.toNumber     = _G.tonumber
+Grichelde.functions.cPrefix       = cPrefix
-Grichelde.functions.max          = _G.math.max
+Grichelde.functions.cYellow       = cYellow
-Grichelde.functions.min          = _G.math.min
+Grichelde.functions.cGray         = cGray
+Grichelde.functions.cDarkgray     = cDarkgray
+Grichelde.functions.cOrange       = cOrange
+Grichelde.functions.format        = _G.string.format
+Grichelde.functions.rep           = _G.string.rep
+Grichelde.functions.trim          = _G.strtrim
+Grichelde.functions.length        = _G.string.len
+Grichelde.functions.lenUtf8       = _G.strlenutf8
+Grichelde.functions.toString      = _G.tostring
+Grichelde.functions.toNumber      = _G.tonumber
+Grichelde.functions.max           = _G.math.max
+Grichelde.functions.min           = _G.math.min

GricheldeDatabase.lua

@@ -10,6 +10,9 @@ function Grichelde:GetDefaultConfig()
         global = {},
         profile = {
             enabled = true,
+            minimapButton = {
+                hide = false
+            },
             channels = {
                 ["*"] = false,
                 say = true,
@@ -21,33 +24,24 @@ function Grichelde:GetDefaultConfig()
             },
             replacements = {
                 ["**"] = {
+                    active = true,
                     order = 9999,
                     searchText = "",
                     replaceText = "",
                     exactCase = false,
                     consolidate = true,
+                    stopOnMatch = false,
                 },
                 replacement_10 = {
                     order = 10,
                     searchText = "s",
                     replaceText = "ch",
-                    exactCase = false,
-                    consolidate = true,
                 },
                 replacement_11 = {
                     order = 11,
                     searchText = "t",
                     replaceText = "ck",
-                    exactCase = false,
-                    consolidate = true,
                 },
-                replacement_12 = {
-                    order = 12,
-                    searchText = "Zark",
-                    replaceText = "toter Schamane",
-                    exactCase = false,
-                    consolidate = true,
-                }
             }
         }
     }
@@ -153,4 +147,4 @@ function Grichelde:ReorderReplacements()
 
     self:DebugPrint("ReorderReplacements : sorted table")
     self:DebugPrint(self.db.profile.replacements)
-end
+end

GricheldeMinimap.lua

@@ -0,0 +1,107 @@
+-- read namespace from global env
+local _G = _G
+local Grichelde = _G.Grichelde
+
+--- add Minimap button
+function Grichelde:MinimapButton()
+    local function clickHandler(_, button)
+        if button == 'LeftButton' then
+            self:ToggleOptions()
+        elseif button == 'RightButton' then
+            self:ToggleActivation()
+        end
+    end
+
+    local function updateTooltip(tooltip)
+        if not tooltip or not tooltip.AddLine then return end
+
+        local tooltipTitle = self:Format(self.L.Minimap_Tooltip_Enabled, self.L.AddonName)
+        if not self.db.profile.enabled then
+            tooltipTitle = self:Format(self.L.Minimap_Tooltip_Disabled, self.L.AddonName)
+        end
+
+        tooltip:SetText(tooltipTitle,
+            Grichelde.COLORS.HIGHLIGHT.r, Grichelde.COLORS.HIGHLIGHT.g, Grichelde.COLORS.HIGHLIGHT.b, Grichelde.COLORS.HIGHLIGHT.a
+        )
+
+        tooltip:AddDoubleLine(self.L.Minimap_Tooltip_Options_Left, self.L.Minimap_Tooltip_Options_Right,
+            Grichelde.COLORS.GREEN.r, Grichelde.COLORS.GREEN.g, Grichelde.COLORS.GREEN.b, Grichelde.COLORS.GREEN.a,
+            Grichelde.COLORS.NORMAL.r, Grichelde.COLORS.NORMAL.g, Grichelde.COLORS.NORMAL.b, Grichelde.COLORS.NORMAL.a
+        )
+        tooltip:AddDoubleLine(self.L.Minimap_Tooltip_Mappings_Left, self.L.Minimap_Tooltip_Mappings_Right,
+            Grichelde.COLORS.GREEN.r, Grichelde.COLORS.GREEN.g, Grichelde.COLORS.GREEN.b, Grichelde.COLORS.GREEN.a,
+            Grichelde.COLORS.NORMAL.r, Grichelde.COLORS.NORMAL.g, Grichelde.COLORS.NORMAL.b, Grichelde.COLORS.NORMAL.a
+        )
+    end
+
+    local darkened = Grichelde.MINIMAP_ENABLED
+    if not self.db.profile.enabled then
+        darkened = Grichelde.MINIMAP_DARKENDED
+    end
+
+    local ldb = LibStub("LibDataBroker-1.1"):NewDataObject(self.name, {
+        type = "launcher",
+        text = self.AddonName,
+        icon = "Interface\\Icons\\Spell_Holy_Silence",
+        --icon = ([[Interface\Addons\%s\%s]]):format(self.name, self.name),
+        OnClick = clickHandler,
+        OnRightClick = function() self:ShowMappings() end,
+        OnTooltipShow = updateTooltip,
+        iconR = darkened,
+        iconG = darkened,
+        iconB = darkened
+    })
+
+    local icon = LibStub("LibDBIcon-1.0")
+    self:DebugPrint("MinimapButton : hidden: ", self.db.profile.minimapButton.hide)
+    icon:Register(self.name, ldb, self.db.profile.minimapButton)
+
+    return ldb, icon
+end
+
+function Grichelde:ToggleMinimapButton()
+    self.db.profile.minimapButton.hide = not self.db.profile.minimapButton.hide
+    self:DebugPrint("ToggleMinimapButton : hidden: ", self.db.profile.minimapButton.hide)
+
+    if self.db.profile.minimapButton.hide then
+        self:HideMinimapButton()
+    else
+        self:ShowMinimapButton()
+    end
+end
+
+function Grichelde:ShowMinimapButton()
+    if self.icon then
+        self.icon:Show(self.name)
+    end
+end
+
+function Grichelde:HideMinimapButton()
+    if self.icon then
+        self.icon:Hide(self.name)
+    end
+end
+
+function Grichelde:ToggleActivation()
+    self.db.profile.enabled = not self.db.profile.enabled
+    -- refresh option UI if open at the moment
+    self.dialog:SelectGroup(self.name, "enabled")
+
+    local formatString = self.L.AddonLoaded
+    local darkened = Grichelde.MINIMAP_ENABLED
+    if not self.db.profile.enabled then
+        formatString = self.L.AddonUnloaded
+        darkened = Grichelde.MINIMAP_DARKENDED
+    end
+
+    if self.dialog ~= nil and self.dialog.OpenFrames[self.name] ~= nil then
+        local namePlusVersion = self:Format(self.L.AddonNamePlusVersion, self.L.AddonName, self.version)
+        local statusText = self:Format(formatString, namePlusVersion)
+        self.dialog.OpenFrames[self.name]:SetStatusText(statusText)
+    end
+
+    self.ldb.iconR = darkened
+    self.ldb.iconG = darkened
+    self.ldb.iconB = darkened
+end
+

GricheldeOptions.lua

@@ -2,8 +2,10 @@
 local _G = _G
 local Grichelde = _G.Grichelde
 
-local nilOrEmpty, pairs, find, match, toString, toNumber
+local nilOrEmpty, pairs, tContains, tWipe, find, match, color, toString, toNumber
-    = Grichelde.functions.nilOrEmpty, Grichelde.functions.pairs, Grichelde.functions.find, Grichelde.functions.match, Grichelde.functions.toString, Grichelde.functions.toNumber
+    = Grichelde.functions.nilOrEmpty, Grichelde.functions.pairs, Grichelde.functions.tContains, Grichelde.functions.tWipe, Grichelde.functions.find, Grichelde.functions.match, Grichelde.functions.color, Grichelde.functions.toString, Grichelde.functions.toNumber
+
+local selectedExample = 1
 
 function Grichelde:CreateOptionsUI()
     return {
@@ -20,24 +22,70 @@ function Grichelde:CreateOptionsUI()
                 type = "toggle",
                 name = self.L.Options_Enabled_Name,
                 desc = self:Format(self.L.Options_Enabled_Desc, self.L.AddonName),
+                set = function() self:ToggleActivation() end,
+                disabled = false,
+            },
+            minimapButton = {
+                order = 1,
+                type = "toggle",
+                name = self.L.Options_Minimap_Button_Name,
+                desc = self.L.Options_Minimap_Button_Desc,
+                set = function(_, _) self:ToggleMinimapButton() end,
+                get = function(_) return not self.db.profile.minimapButton.hide end,
                 disabled = false,
             },
 
-            channels = {
+            replacements = {
                 order = 2,
                 type = "group",
+                name = self.L.Options_Replacements_Group_Name,
+                desc = self.L.Options_Replacements_Group_Desc,
+                args = {
+                    add = {
+                        order = 0,
+                        type = "execute",
+                        confirm = false,
+                        name = self.L.Options_Replacements_Add_Name,
+                        desc = self.L.Options_Replacements_Add_Desc,
+                        func = function(info) self:AddEmptyMapping(info) end,
+                    },
+                    deleteAll = {
+                        order = 1,
+                        type = "execute",
+                        confirm = true,
+                        confirmText = self.L.Options_Replacements_DeleteAll_ConfirmText,
+                        name = self.L.Options_Replacements_DeleteAll_Name,
+                        desc = self.L.Options_Replacements_DeleteAll_Desc,
+                        func = function(info) self:DeleteAllMappings(info) end,
+                    },
+                    header = {
+                        order = 3,
+                        type = "description",
+                        name = self.L.Options_Replacements_Header,
+                    },
+                    spacer1 = {
+                        order = 4,
+                        type = "header",
+                        name = "",
+                    },
+                },
+            },
+
+            channels = {
+                order = 3,
+                type = "group",
                 name = self.L.Options_Channels_Group_Name,
                 desc = self:Format(self.L.Options_Channels_Group_Desc, self.L.AddonName),
                 args = {
                     header = {
                         order = 1,
                         type = "description",
-                        name = self.L.Options_Channels_Header
+                        name = self.L.Options_Channels_Header,
                     },
-                    spacer = {
+                    spacer2 = {
                         order = 2,
                         type = "header",
-                        name = ""
+                        name = "",
                     },
                     say = {
                         order = 10,
@@ -105,45 +153,106 @@ function Grichelde:CreateOptionsUI()
                         name = self.L.Options_Channel_Whisper_Name,
                         desc = self:Format(self.L.Options_Channel_Whisper_Desc, self.L.AddonName),
                     },
-                }
+                },
             },
 
-            replacements = {
+            help = {
-                order = 3,
+                order = -1,
                 type = "group",
-                name = self.L.Options_Replacements_Group_Name,
+                childGroups = "tab",
-                desc = self.L.Options_Replacements_Group_Desc,
+                name = self.L.Options_Help_Group_Name,
+                desc = self.L.Options_Help_Group_Desc,
+                disabled = false,
                 args = {
-                    add = {
+                    basics = {
-                        order = 0,
+                        order = 10,
-                        type = "execute",
+                        type = "group",
-                        confirm = false,
+                        name = self.L.Options_Help_Tab_Basics_Name,
-                        name = self.L.Options_Replacements_Add_Name,
+                        desc = self.L.Options_Help_Tab_Basics_Desc,
-                        desc = self.L.Options_Replacements_Add_Desc,
+                        args = {
-                        func = function(info) self:AddEmptyMapping(info) end
+                            paragraph1 = {
+                                order = 1,
+                                type = "description",
+                                name = self.L.Options_Help_Basics,
+                                fontSize = "medium",
+                            },
+                        },
                     },
-                    deleteAll = {
+                    expert = {
-                        order = 1,
+                        order = 11,
-                        type = "execute",
+                        type = "group",
-                        confirm = true,
+                        name = self.L.Options_Help_Tab_Expert_Name,
-                        confirmText = self.L.Options_Replacements_DeleteAll_ConfirmText,
+                        desc = self.L.Options_Help_Tab_Expert_Desc,
-                        name = self.L.Options_Replacements_DeleteAll_Name,
+                        args = {
-                        desc = self.L.Options_Replacements_DeleteAll_Desc,
+                            paragraph4 = {
-                        func = function(info) self:DeleteAllMappings(info) end
+                                order = 1,
+                                type = "description",
+                                name = self.L.Options_Help_Expert,
+                                fontSize = "medium",
+                            },
+                        },
                     },
-                    header = {
+                    examples = {
-                        order = 3,
+                        order = 12,
+                        type = "group",
+                        name = self.L.Options_Help_Tab_Examples_Name,
+                        desc = self.L.Options_Help_Tab_Examples_Desc,
+                        args = {
+                            note = {
+                                order = 1,
+                                type = "description",
+                                name = self.L.Options_Help_Examples_Note,
+                            },
+                            header = {
+                                order = 2,
+                                type = "description",
+                                name = self.L.Options_Help_Examples0_Header,
+                                fontSize = "medium",
+                                width = 2.5,
+                            },
+                            dropDown = {
+                                order = 3,
+                                type = "select",
+                                name = "",
+                                --width = 1,
+                                values = {
+                                    self.L.Options_Help_Examples1_Select,
+                                    self.L.Options_Help_Examples2_Select,
+                                    self.L.Options_Help_Examples3_Select,
+                                    self.L.Options_Help_Examples4_Select,
+                                    self.L.Options_Help_Examples5_Select,
+                                    self.L.Options_Help_Examples6_Select,
+--                                  self.L.Options_Help_Examples7_Select,
+                                },
+                                set = function(info, val) selectedExample = val end,
+                                get = function(_)
+                                    self.options.args.help.args.examples.args.header.name = self.L["Options_Help_Examples" .. selectedExample .. "_Header"]
+                                    self.options.args.help.args.examples.args.example.name = self.L["Options_Help_Examples" .. selectedExample .. "_Text"]
+                                    self.dialog:SelectGroup(self.name, "help", "examples", "header.name")
+                                    return selectedExample
+                                end,
+                            },
+                            spacer3 = {
+                                order = 4,
+                                type = "header",
+                                name = "",
+                            },
+                            example = {
+                                order = 5,
+                                type = "description",
+                                name = self.L.Options_Help_Examples0_Text,
+                                fontSize = "medium",
+                            },
+                        },
+                    },
+                    disclaimer = {
+                        order = 20,
                         type = "description",
-                        name = self.L.Options_Replacements_Header
+                        name = self.L.Options_Help_Disclaimer,
                     },
-                    spacer = {
+                },
-                        order = 4,
+            },
-                        type = "header",
+        },
-                        name = ""
-                    },
-                }
-            }
-        }
     }
 end
 
@@ -154,85 +263,96 @@ function Grichelde:CreateMapping(offset)
         name = function(info) return self:MappingName(info) end,
         desc = self.L.Options_Mapping_Group_Desc,
         childGroups = "tree",
+        disabled = function(info) return not self:IsMappingActive(info) end,
         args = {
-            searchText = {
+            moveUp = {
                 order = 0,
+                type = "execute",
+                name = "",
+                desc = self.L.Options_Mapping_MoveUp_Desc,
+                image = function(info) return self:GetMoveUpImage(info) end,
+                width = 0.15,
+                func = function(info) self:MoveUp(info) end,
+            },
+            moveDown = {
+                order = 1,
+                type = "execute",
+                name = "",
+                desc = self.L.Options_Mapping_MoveDown_Desc,
+                image = function(info) return self:GetMoveDownImage(info) end,
+                width = 0.15,
+                func = function(info) self:MoveDown(info) end,
+            },
+--[[
+            spacer4 = {
+                order = 2,
+                type = "description",
+                name = "",
+                width = 0.1,
+            },
+]]
+            active = {
+                order = 3,
+                type = "toggle",
+                name = self.L.Options_Mapping_Enabled_Name,
+                desc = self.L.Options_Mapping_Enabled_Desc,
+                width = 2.2,
+            },
+            delete = {
+                order = 4,
+                type = "execute",
+                confirm = true,
+                confirmText = self.L.Options_Mapping_Delete_ConfirmText,
+                name = "",
+                desc = self.L.Options_Mapping_Delete_Desc,
+                image = function(info) return self:GetDeleteImage(info) end,
+                width = 0.1,
+                func = function(info) self:DeleteMapping(info) end,
+            },
+
+            searchText = {
+                order = 10,
                 type = "input",
                 name = self.L.Options_Mapping_SearchText_Name,
                 desc = self.L.Options_Mapping_SearchText_Desc,
             },
             replaceText = {
-                order = 1,
+                order = 11,
                 type = "input",
                 name = self.L.Options_Mapping_ReplaceText_Name,
                 desc = self.L.Options_Mapping_ReplaceText_Desc,
             },
+
             exactCase = {
-                order = 2,
+                order = 20,
                 type = "toggle",
                 name = self.L.Options_Mapping_ExactCase_Name,
                 desc = self.L.Options_Mapping_ExactCase_Desc,
                 width = "full",
             },
             consolidate = {
-                order = 3,
+                order = 21,
                 type = "toggle",
                 name = self.L.Options_Mapping_Consolidate_Name,
                 desc = self.L.Options_Mapping_Consolidate_Desc,
-                width = "full"
+                width = "full",
-            },
-            moveUp = {
-                order = 10,
-                type = "execute",
-                --name = self.L.Options_Mapping_MoveUp_Name,
-                name = "",
-                desc = self.L.Options_Mapping_MoveUp_Desc,
-                image = "Interface\\ChatFrame\\UI-ChatIcon-ScrollUp-Up",
-                width = 0.25,
-                func = function(info) self:MoveUp(info) end
-            },
-            moveDown = {
-                order = 11,
-                type = "execute",
-                --name = self.L.Options_Mapping_MoveDown_Name,
-                name = "",
-                desc = self.L.Options_Mapping_MoveDown_Desc,
-                image = "Interface\\ChatFrame\\UI-ChatIcon-ScrollDown-Up",
-                width = 0.25,
-                func = function(info) self:MoveDown(info) end
-            },
-            spacer = {
-                order = 18,
-                type = "description",
-                name = "",
-                width = 1,
-            },
-            delete = {
-                order = 19,
-                type = "execute",
-                confirm = true,
-                confirmText = self.L.Options_Mapping_Delete_ConfirmText,
-                name = self.L.Options_Mapping_Delete_Name,
-                desc = self.L.Options_Mapping_Delete_Desc,
-                width = 0.5,
-                func = function(info) self:DeleteMapping(info) end
             },
+            stopOnMatch = {
+                order = 22,
+                type = "toggle",
+                name = self.L.Options_Mapping_StopOnMatch_Name,
+                desc = self.L.Options_Mapping_StopOnMatch_Desc,
+                width = "full",
+            }
         }
     }
 end
 
---dropButton:SetWidth(24)
---dropButton:SetHeight(24)
---dropButton:SetPoint("TOPRIGHT", DRight, "TOPRIGHT", -16, -18)
---dropButton:SetNormalTexture([[Interface\ChatFrame\UI-ChatIcon-ScrollDown-Up]])
---dropButton:SetPushedTexture([[Interface\ChatFrame\UI-ChatIcon-ScrollDown-Down]])
---dropButton:SetDisabledTexture([[Interface\ChatFrame\UI-ChatIcon-ScrollDown-Disabled]])
---dropButton:SetHighlightTexture([[Interface\Buttons\UI-Common-MouseHilight]], "ADD")
-
 function Grichelde:SetupOptions()
     -- add DB-backed profiles to UI options
     local options = self:CreateOptionsUI()
     options.args.profiles = LibStub("AceDBOptions-3.0"):GetOptionsTable(self.db)
+    options.args.profiles.order = 8
     options.args.profiles.disabled = false
 
     -- Adding options to blizzard frame
@@ -243,44 +363,112 @@ function Grichelde:SetupOptions()
     return options, dialog
 end
 
+function Grichelde:RefreshOptions(event)
+    self:DebugPrint("RefreshOptions : event:", event)
+    local currentProfile = color(Grichelde.COLOR_CODES.GREEN, self.db:GetCurrentProfile())
+    if event == "OnNewProfile" then
+        self:PrefixedPrint(self.L.Profiles_Created, currentProfile)
+    elseif event == "OnProfileChanged" then
+        self:PrefixedPrint(self.L.Profiles_Loaded, currentProfile)
+    elseif event == "OnProfileDeleted" then
+        self:PrefixedPrint(self.L.Profiles_Deleted, currentProfile)
+    elseif event == "OnProfileCopied" then
+        self:PrefixedPrint(self.L.Profiles_Copied, currentProfile)
+    elseif event == "OnProfileReset" then
+        self:PrefixedPrint(self.L.Profiles_Reset, currentProfile)
+    else
+        self:DebugPrint("Refreshing Profile %s on options change: %s", self.db:GetCurrentProfile(), event)
+    end
+
+    self:ReorderReplacements()
+    self:RefreshReplacements(self.db.profile.replacements)
+end
+
+function Grichelde:ToggleOptions()
+    self:DebugPrint("ToggleOptions : options open: ", not not self.dialog.OpenFrames[self.name])
+    if self.dialog ~= nil and self.dialog.OpenFrames[self.name] ~= nil then
+        self:CloseOptions()
+    else
+        self:OpenOptions()
+    end
+end
+
+function Grichelde:OpenOptions()
+    if self.dialog ~= nil then
+        self.dialog:Open(self.name)
+
+        local formatString = self.L.AddonLoaded
+        if not self.db.profile.enabled then
+            formatString = self.L.AddonUnloaded
+        end
+
+        local namePlusVersion = self:Format(self.L.AddonNamePlusVersion, self.L.AddonName, self.version)
+        local statusText = self:Format(formatString, namePlusVersion)
+        self.dialog.OpenFrames[self.name]:SetStatusText(statusText)
+    end
+end
+
+function Grichelde:CloseOptions()
+    if self.dialog ~= nil then
+        self.dialog:Close(self.name)
+    end
+end
+
+--- If all replacements were disabled
+-- @return (boolean)
 function Grichelde:IsDisabled(info)
-    if info.option.type == "group" then
+    if info and info.option.type == "group" then
         return false
     end
     return not self.db.profile.enabled
 end
 
+--- If all replacements were disabled
+-- @return (boolean)
+function Grichelde:IsMappingActive(info)
+    self:TracePrint("IsMappingActive : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    if info and info.option.type == "group" then
+        return true
+    end
+    if not self.db.profile.enabled then
+        return false
+    end
+
+    local replacements = self.db.profile.replacements or {}
+    local currentName = info[2]
+    local uiElem = info[3]
+
+    self:DebugPrint("IsMappingActive : \"%s\"", currentName)
+    self:DebugPrint(replacements[currentName])
+
+    if (tContains({"moveUp", "moveDown", "active", "delete"}, uiElem)) then
+        return true
+    else
+        return not not replacements[currentName].active
+    end
+end
+
 function Grichelde:MappingName(info)
 --  self:TracePrint("MappingName : info")
 --  self:TracePrint(info)
     local option = self.db.profile.replacements[info[2]]
 
     if nilOrEmpty(option.searchText) and nilOrEmpty(option.replaceText) then
-        return self.L.Options_Mapping_EmptyMapping
+        return color(Grichelde.COLOR_CODES.GRAY, self.L.Options_Mapping_EmptyMapping)
     else
-        return self:Format(self.L.Options_Mapping_Group_Name, option.searchText or "", option.replaceText or "")
+        local name = self:Format(self.L.Options_Mapping_Group_Name, option.searchText or "", option.replaceText or "")
+        if option.active == true then
+            return name
+        else
+            return color(Grichelde.COLOR_CODES.GRAY, name)
+        end
     end
 end
 
-function Grichelde:RefreshOptions(event)
-    self:DebugPrint("RefreshOptions : event:", event)
-    if event == "OnNewProfile" then
-        self:PrefixedPrint(self.L.Profiles_Created, self.COLOR_CODES.GREEN .. self.db:GetCurrentProfile() .. self.COLOR_CODES.CLOSE)
-    elseif event == "OnProfileChanged" then
-        self:PrefixedPrint(self.L.Profiles_Loaded, self.COLOR_CODES.GREEN .. self.db:GetCurrentProfile() .. self.COLOR_CODES.CLOSE)
-    elseif event == "OnProfileDeleted" then
-        self:PrefixedPrint(self.L.Profiles_Deleted, self.COLOR_CODES.GREEN .. self.db:GetCurrentProfile() .. self.COLOR_CODES.CLOSE)
-    elseif event == "OnProfileCopied" then
-        self:PrefixedPrint(self.L.Profiles_Copied, self.COLOR_CODES.GREEN .. self.db:GetCurrentProfile() .. self.COLOR_CODES.CLOSE)
-    elseif event == "OnProfileReset" then
-        self:PrefixedPrint(self.L.Profiles_Reset, self.COLOR_CODES.GREEN .. self.db:GetCurrentProfile() .. self.COLOR_CODES.CLOSE)
-    else
-        self:DebugPrint("Refreshing Profile %s on options change: %s", self.db:GetCurrentProfile(), event)
-    end
-
-    self:ReorderReplacements()
-    self:RefreshReplacements(self.db.profile.replacements)
-end
 
 --- Create UI options for rhe given replacement table (from DB).
 --- Usually called with with self.db.profile.replacements
@@ -411,6 +599,66 @@ function Grichelde:MoveDown(info)
     end
 end
 
+function Grichelde:GetMoveUpImage(info)
+    self:TracePrint("GetMoveUpImage : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    local currentName = info[2]
+    self:DebugPrint("GetMoveUpImage : \"%s\"", currentName)
+
+    local _, replNumber = self:SplitOnFirstMatch(currentName, "_")
+    local currentOrder = toNumber(replNumber)
+
+    if (self:IsMappingActive(info) and currentOrder > Grichelde.MAPPING_OFFSET ) then
+        return Grichelde.ICONS.MOVE_UP
+    else
+        return Grichelde.ICONS.MOVE_UP_DISABLED
+    end
+end
+
+function Grichelde:GetMoveDownImage(info)
+    self:TracePrint("GetMoveDownImage : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    local currentName = info[2]
+    self:DebugPrint("GetMoveDownImage : \"%s\"", currentName)
+
+    local _, replNumber = self:SplitOnFirstMatch(currentName, "_")
+    local currentOrder = toNumber(replNumber)
+
+    local maxRepl = Grichelde.MAPPING_OFFSET
+    local replacements = self.db.profile.replacements or {}
+    for replName, _ in pairs(replacements) do
+        local num = match(replName, "^replacement_(%d+)")
+        if num and maxRepl < toNumber(num) then
+            maxRepl = toNumber(num)
+        end
+    end
+
+    if (self:IsMappingActive(info) and currentOrder < maxRepl) then
+        return Grichelde.ICONS.MOVE_DOWN
+    else
+        return Grichelde.ICONS.MOVE_DOWN_DISABLED
+    end
+end
+
+function Grichelde:GetDeleteImage(info)
+    self:TracePrint("GetDeleteImage : info")
+    for i = 0, #info do
+        self:TracePrint("%d = %s", i, info[i])
+    end
+
+    if (self:IsMappingActive(info)) then
+        return Grichelde.ICONS.DELETE
+    else
+        return Grichelde.ICONS.DELETE_DISABLED
+    end
+end
+
 function Grichelde:DeleteMapping(info)
     self:TracePrint("DeleteMapping : info")
     for i = 0, #info do
@@ -433,9 +681,7 @@ function Grichelde:DeleteAllMappings()
     self:DebugPrint("DeleteAllMappings")
 
     -- do NOT set self.db.profile.replacements = {} it will break defaults
-    for replName, _ in pairs(self.db.profile.replacements or {}) do
+    tWipe(self.db.profile.replacements)
-        self.db.profile.replacements[replName] = nil
-    end
     self:AddEmptyMapping()
 
     self:RefreshOptions("DeleteAllMappings")

GricheldeUpgrade.lua

@@ -2,13 +2,13 @@
 local _G = _G
 local Grichelde = _G.Grichelde
 
-local pairs, find, toNumber = Grichelde.functions.pairs, Grichelde.functions.find, Grichelde.functions.toNumber
+local pairs, find, color, cOrange, toNumber = Grichelde.functions.pairs, Grichelde.functions.find, Grichelde.functions.color, Grichelde.functions.cOrange, Grichelde.functions.toNumber
 
 function Grichelde:Upgrade_To_v060()
-    self:PrefixedPrint(self.L.Upgrade_ToVersion, Grichelde.COLOR_CODES.ORANGE .. "0.6.0" .. Grichelde.COLOR_CODES.CLOSE)
+    self:PrefixedPrint(self.L.Upgrade_ToVersion, cOrange("0.6.0"))
 
     local replacements = self.db.profile.replacements or {}
-    self:DebugPrint("Upgrade_To_060 : old database")
+    self:DebugPrint("Upgrade_To_v060 : old database")
     self:DebugPrint(replacements)
 
     for _, replTable in pairs(replacements) do
@@ -16,16 +16,16 @@ function Grichelde:Upgrade_To_v060()
         replTable["caseSensitive"] = nil
     end
 
-    self:DebugPrint("Upgrade_To_060 : new database")
+    self:DebugPrint("Upgrade_To_v060 : new database")
     self:DebugPrint(replacements)
     return 0, 6, 0
 end
 
 function Grichelde:Upgrade_To_v070()
-    self:PrefixedPrint(self.L.Upgrade_ToVersion, Grichelde.COLOR_CODES.ORANGE .. "0.7.0" .. Grichelde.COLOR_CODES.CLOSE)
+    self:PrefixedPrint(self.L.Upgrade_ToVersion, cOrange("0.7.0"))
 
     local replacements = self.db.profile.replacements or {}
-    self:DebugPrint("Upgrade_To_070 : old database")
+    self:DebugPrint("Upgrade_To_v070 : old replacements")
     self:DebugPrint(replacements)
 
     for _, replTable in pairs(replacements) do
@@ -33,16 +33,39 @@ function Grichelde:Upgrade_To_v070()
         replTable["ignoreCase"] = nil
     end
 
-    self:DebugPrint("Upgrade_To_070 : new database")
+    self:DebugPrint("Upgrade_To_v070 : new replacements")
     self:DebugPrint(replacements)
     return 0, 7, 0
 end
 
---[[
+function Grichelde:Upgrade_To_v072()
-function Grichelde:Upgrade_To_v071()
+    self:PrefixedPrint(self.L.Upgrade_ToVersion, cOrange("0.7.2"))
-    return 0, 7, 1
+
+    self:DebugPrint("Upgrade_To_v072 : old database")
+    self:DebugPrint(self.db.profile)
+
+    self.db.profile["minimapButton"] = { hide = false }
+
+    self:DebugPrint("Upgrade_To_v072 : new database")
+    self:DebugPrint(self.db.profile)
+    return 0, 7, 2
+end
+
+function Grichelde:Upgrade_To_v080()
+    self:PrefixedPrint(self.L.Upgrade_ToVersion, cOrange("0.8.0"))
+
+    local replacements = self.db.profile.replacements or {}
+    self:DebugPrint("Upgrade_To_v080 : old replacements")
+    self:DebugPrint(replacements)
+
+    for _, replTable in pairs(replacements) do
+        replTable["active"] = true
+    end
+
+    self:DebugPrint("Upgrade_To_v080 : new replacements")
+    self:DebugPrint(self.db.profile)
+    return 0, 8, 0
 end
-]]
 
 function Grichelde:UpgradeDatabase()
     local dbVersion = self.db.global.version or "0.0.0"
@@ -63,22 +86,26 @@ function Grichelde:UpgradeDatabase()
             upgrade = upgrade + 1
             major, minor, patch = self:Upgrade_To_v070(dbVersion)
         end
---[[
         if minor == 7 then
-            if patch < 1 then
+            if patch < 2 then
                 upgrade = upgrade + 1
-                major, minor, patch = self:Upgrade_To_v71(dbVersion)
+                major, minor, patch = self:Upgrade_To_v072(dbVersion)
             end
         end
-]]
+        if minor < 8 then
+            upgrade = upgrade + 1
+            major, minor, patch = self:Upgrade_To_v080(dbVersion)
+        end
     end
 
     if upgrade == 0 then
         self:DebugPrint("Database up-to-date")
+        -- bump version number even if no update is required
+        self.db.global.version = self.version
     else
         if not error then
             self.db.global.version = self.version
-            self:PrefixedPrint(Grichelde.COLOR_CODES.GREEN .. self.L.Upgrade_Successful .. Grichelde.COLOR_CODES.CLOSE)
+            self:PrefixedPrint(color(Grichelde.COLOR_CODES.GREEN, self.L.Upgrade_Successful))
         end
     end
 end

GricheldeUtils.lua

@@ -2,8 +2,8 @@
 local _G = _G
 local Grichelde = _G.Grichelde
 
-local type, print, pairs, tSize, select, unpack, find, format, rep, toString
+local type, print, pairs, tSize, select, unpack, find, color, cGray, cDarkgray, cPrefix, format, rep, toString
-    = Grichelde.functions.type, Grichelde.functions.print, Grichelde.functions.pairs, Grichelde.functions.tSize, Grichelde.functions.select, Grichelde.functions.unpack, Grichelde.functions.find, Grichelde.functions.format, Grichelde.functions.rep, Grichelde.functions.toString
+    = Grichelde.functions.type, Grichelde.functions.print, Grichelde.functions.pairs, Grichelde.functions.tSize, Grichelde.functions.select, Grichelde.functions.unpack, Grichelde.functions.find, Grichelde.functions.color,  Grichelde.functions.cGray, Grichelde.functions.cDarkgray, Grichelde.functions.cPrefix, Grichelde.functions.format, Grichelde.functions.rep, Grichelde.functions.toString
 
 -- show strings differently to distinguish them from numbers
 local function plainValue(val)
@@ -60,7 +60,7 @@ local function tPrint(val, indent, known, printFunc)
     end
 end
 
--- split at first word of a text line
+--- Splits at first word of a text line
 function Grichelde:SplitOnFirstMatch(text, delimPattern, start)
     if text == nil then return nil end
     local pattern = "^(.-)" .. (delimPattern or " " ) .."(.*)"
@@ -71,7 +71,7 @@ function Grichelde:SplitOnFirstMatch(text, delimPattern, start)
     return left or text, right
 end
 
--- split at last word of a text line
+--- Splits at last word of a text line
 function Grichelde:SplitOnLastMatch(text, delimPattern, start)
     local pattern = "(.*)" .. (delimPattern or " ") .. "(.-)$"
     local pos = start or 1
@@ -81,10 +81,10 @@ function Grichelde:SplitOnLastMatch(text, delimPattern, start)
     return left, right or text
 end
 
--- split at last word of a text line
+--- Splits at last word of a text line
 function Grichelde:TestMatch(text, pattern)
-    local _, _, left, right = find(text, pattern, 1)
+    local pos1, pos2, left, right = find(text, pattern, 1)
-    self:DebugPrint("TestMatch : left: %s, right: %s", left, right)
+    self:DebugPrint("TestMatch : pos1: %d, pos2: %d, left: %s, right: %s", pos1, pos2, left, right)
 end
 
 function Grichelde:Format(message, ...)
@@ -117,18 +117,22 @@ function Grichelde:Print(...)
 end
 
 function Grichelde:PrefixedPrint(...)
-    print(self.COLOR_CODES.PREFIX .. self.L.AddonName .. self.COLOR_CODES.CLOSE .. ":", self:Format(...))
+    print(cPrefix(self.L.AddonName) .. ":", self:Format(...))
+end
+
+function Grichelde:ErrorPrint(...)
+    print(cPrefix(self.L.AddonName) .. ": " .. color(self.COLOR_CODES.RED, self:Format(...)))
 end
 
 function Grichelde:DebugPrint(obj, ...)
     self:LogPrint(Grichelde.LOG_LEVEL.DEBUG, function(...)
-        print(self.COLOR_CODES.GRAY .. self.L.AddonName .. self.COLOR_CODES.CLOSE .. ":", self:Format(...))
+        print(cGray(self.L.AddonName) .. ":", self:Format(...))
     end, obj, ...)
 end
 
 function Grichelde:TracePrint(obj, ...)
     self:LogPrint(Grichelde.LOG_LEVEL.TRACE, function(...)
-        print(self.COLOR_CODES.DARKGRAY .. self.L.AddonName .. self.COLOR_CODES.CLOSE .. ":", self:Format(...))
+        print(cDarkgray(self.L.AddonName) .. ":", self:Format(...))
     end, obj, ...)
 end
 
@@ -166,24 +170,34 @@ end
 
 --- Print UI options to chat frame
 function Grichelde:PrintOptions()
-    self:PrefixedPrint(self.COLOR_CODES.PREFIX .. self.L.Debug_Options .. self.COLOR_CODES.CLOSE)
+    self:PrefixedPrint(cPrefix(self.L.Debug_Options))
     self:LogPrint(-1, function(...)
-        print(self.COLOR_CODES.PREFIX .. self.L.AddonName .. self.COLOR_CODES.CLOSE .. ":", self:Format(...))
+        print(cPrefix(self.L.AddonName) .. ":", self:Format(...))
     end, self.options.args.replacements.args)
 end
 
+--- Print current DB profile
+function Grichelde:PrintProfile()
+    self:PrefixedPrint(cPrefix(self.L.Debug_Profile))
+    self:LogPrint(-1, function(...)
+        print(cPrefix(self.L.AddonName) .. ":", self:Format(...))
+    end, self.db.profile)
+end
+
 --- Print DB replacements to chat frame
 function Grichelde:PrintMappings()
-    self:PrefixedPrint(self.COLOR_CODES.PREFIX .. self.L.Debug_Mappings .. self.COLOR_CODES.CLOSE)
+    self:PrefixedPrint(cPrefix(self.L.Debug_Mappings))
     self:LogPrint(-1, function(...)
-        print(self.COLOR_CODES.PREFIX .. self.L.AddonName .. self.COLOR_CODES.CLOSE .. ":", self:Format(...))
+        print(cPrefix(self.L.AddonName) .. ":", self:Format(...))
     end, self.db.profile.replacements)
 end
 
---- Open UI windows with replacements in it
+--- Open window with DB replacements in it
-function Grichelde:ShowMappings()
+function Grichelde:ToogleMappings()
-    if self.debugFrame and self.debugFrame:IsShown() then
+    local AceGUI = LibStub("AceGUI-3.0")
-        self.debugFrame:Release(self.debugFrame)
+
+    if self.debugFrame then
+        AceGUI:Release(self.debugFrame)
         self.debugFrame = nil
     else
         local replacements = self.db.profile.replacements or {}
@@ -194,28 +208,40 @@ function Grichelde:ShowMappings()
             end
         end
 
-        local AceGUI = LibStub("AceGUI-3.0")
         local frame = AceGUI:Create("Frame");
         frame:SetTitle(self.L.Debug_Mappings);
         frame:SetStatusText(self:Format(self.L.Debug_Mappings_Found, repls))
         frame:SetWidth(400);
-        frame:SetHeight(600);
+        frame:SetAutoAdjustHeight(true)
-        frame:SetLayout("Fill");
+        --frame:SetFullHeight(true)
-
+        frame:SetLayout("Flow");
-        local function closeFrame() frame:Release(frame) end
+        local function closeFrame(widget) AceGUI:Release(widget); self.debugFrame = nil end
         frame:SetCallback("OnClose", closeFrame)
 
+        local hint = AceGUI:Create("Label");
+        hint:SetText(self.L.Debug_Mappings_Hint)
+        hint:SetFullWidth(true)
+        frame:AddChild(hint);
+
+        local scroll = AceGUI:Create("ScrollFrame");
+        scroll:SetFullWidth(true)
+        scroll:SetFullHeight(true)
+        scroll:SetLayout("Fill");
+
         local configBox = AceGUI:Create("MultiLineEditBox");
+        configBox:SetLabel("")
         local text = ""
         tPrint(replacements, 0, {}, function(s) text = text .. s .. "|n" end)
-        configBox:SetLabel("")
         configBox:SetText(text)
+        configBox:SetFullWidth(true)
+        --configBox:SetFullHeight(true)
         configBox:DisableButton(true)
         --configBox:SetDisabled(true)
-        configBox:SetNumLines(30);
+        configBox:SetNumLines(50);
         configBox:SetFocus()
+        scroll:AddChild(configBox);
 
-        frame:AddChild(configBox);
+        frame:AddChild(scroll);
         self.debugFrame = frame
     end
 end

Libs/LibDBIcon-1.0/LibDBIcon-1.0.lua

@@ -0,0 +1,470 @@
+
+-----------------------------------------------------------------------
+-- LibDBIcon-1.0
+--
+-- Allows addons to easily create a lightweight minimap icon as an alternative to heavier LDB displays.
+--
+
+local DBICON10 = "LibDBIcon-1.0"
+local DBICON10_MINOR = 43 -- Bump on changes
+if not LibStub then error(DBICON10 .. " requires LibStub.") end
+local ldb = LibStub("LibDataBroker-1.1", true)
+if not ldb then error(DBICON10 .. " requires LibDataBroker-1.1.") end
+local lib = LibStub:NewLibrary(DBICON10, DBICON10_MINOR)
+if not lib then return end
+
+lib.objects = lib.objects or {}
+lib.callbackRegistered = lib.callbackRegistered or nil
+lib.callbacks = lib.callbacks or LibStub("CallbackHandler-1.0"):New(lib)
+lib.notCreated = lib.notCreated or {}
+lib.radius = lib.radius or 5
+lib.tooltip = lib.tooltip or CreateFrame("GameTooltip", "LibDBIconTooltip", UIParent, "GameTooltipTemplate")
+local next, Minimap = next, Minimap
+local isDraggingButton = false
+
+function lib:IconCallback(event, name, key, value)
+	if lib.objects[name] then
+		if key == "icon" then
+			lib.objects[name].icon:SetTexture(value)
+		elseif key == "iconCoords" then
+			lib.objects[name].icon:UpdateCoord()
+		elseif key == "iconR" then
+			local _, g, b = lib.objects[name].icon:GetVertexColor()
+			lib.objects[name].icon:SetVertexColor(value, g, b)
+		elseif key == "iconG" then
+			local r, _, b = lib.objects[name].icon:GetVertexColor()
+			lib.objects[name].icon:SetVertexColor(r, value, b)
+		elseif key == "iconB" then
+			local r, g = lib.objects[name].icon:GetVertexColor()
+			lib.objects[name].icon:SetVertexColor(r, g, value)
+		end
+	end
+end
+if not lib.callbackRegistered then
+	ldb.RegisterCallback(lib, "LibDataBroker_AttributeChanged__icon", "IconCallback")
+	ldb.RegisterCallback(lib, "LibDataBroker_AttributeChanged__iconCoords", "IconCallback")
+	ldb.RegisterCallback(lib, "LibDataBroker_AttributeChanged__iconR", "IconCallback")
+	ldb.RegisterCallback(lib, "LibDataBroker_AttributeChanged__iconG", "IconCallback")
+	ldb.RegisterCallback(lib, "LibDataBroker_AttributeChanged__iconB", "IconCallback")
+	lib.callbackRegistered = true
+end
+
+local function getAnchors(frame)
+	local x, y = frame:GetCenter()
+	if not x or not y then return "CENTER" end
+	local hhalf = (x > UIParent:GetWidth()*2/3) and "RIGHT" or (x < UIParent:GetWidth()/3) and "LEFT" or ""
+	local vhalf = (y > UIParent:GetHeight()/2) and "TOP" or "BOTTOM"
+	return vhalf..hhalf, frame, (vhalf == "TOP" and "BOTTOM" or "TOP")..hhalf
+end
+
+local function onEnter(self)
+	if isDraggingButton then return end
+
+	for _, button in next, lib.objects do
+		if button.showOnMouseover then
+			button.fadeOut:Stop()
+			button:SetAlpha(1)
+		end
+	end
+
+	local obj = self.dataObject
+	if obj.OnTooltipShow then
+		lib.tooltip:SetOwner(self, "ANCHOR_NONE")
+		lib.tooltip:SetPoint(getAnchors(self))
+		obj.OnTooltipShow(lib.tooltip)
+		lib.tooltip:Show()
+	elseif obj.OnEnter then
+		obj.OnEnter(self)
+	end
+end
+
+local function onLeave(self)
+	lib.tooltip:Hide()
+
+	if not isDraggingButton then
+		for _, button in next, lib.objects do
+			if button.showOnMouseover then
+				button.fadeOut:Play()
+			end
+		end
+	end
+
+	local obj = self.dataObject
+	if obj.OnLeave then
+		obj.OnLeave(self)
+	end
+end
+
+--------------------------------------------------------------------------------
+
+local onDragStart, updatePosition
+
+do
+	local minimapShapes = {
+		["ROUND"] = {true, true, true, true},
+		["SQUARE"] = {false, false, false, false},
+		["CORNER-TOPLEFT"] = {false, false, false, true},
+		["CORNER-TOPRIGHT"] = {false, false, true, false},
+		["CORNER-BOTTOMLEFT"] = {false, true, false, false},
+		["CORNER-BOTTOMRIGHT"] = {true, false, false, false},
+		["SIDE-LEFT"] = {false, true, false, true},
+		["SIDE-RIGHT"] = {true, false, true, false},
+		["SIDE-TOP"] = {false, false, true, true},
+		["SIDE-BOTTOM"] = {true, true, false, false},
+		["TRICORNER-TOPLEFT"] = {false, true, true, true},
+		["TRICORNER-TOPRIGHT"] = {true, false, true, true},
+		["TRICORNER-BOTTOMLEFT"] = {true, true, false, true},
+		["TRICORNER-BOTTOMRIGHT"] = {true, true, true, false},
+	}
+
+	local rad, cos, sin, sqrt, max, min = math.rad, math.cos, math.sin, math.sqrt, math.max, math.min
+	function updatePosition(button, position)
+		local angle = rad(position or 225)
+		local x, y, q = cos(angle), sin(angle), 1
+		if x < 0 then q = q + 1 end
+		if y > 0 then q = q + 2 end
+		local minimapShape = GetMinimapShape and GetMinimapShape() or "ROUND"
+		local quadTable = minimapShapes[minimapShape]
+		local w = (Minimap:GetWidth() / 2) + lib.radius
+		local h = (Minimap:GetHeight() / 2) + lib.radius
+		if quadTable[q] then
+			x, y = x*w, y*h
+		else
+			local diagRadiusW = sqrt(2*(w)^2)-10
+			local diagRadiusH = sqrt(2*(h)^2)-10
+			x = max(-w, min(x*diagRadiusW, w))
+			y = max(-h, min(y*diagRadiusH, h))
+		end
+		button:SetPoint("CENTER", Minimap, "CENTER", x, y)
+	end
+end
+
+local function onClick(self, b)
+	if self.dataObject.OnClick then
+		self.dataObject.OnClick(self, b)
+	end
+end
+
+local function onMouseDown(self)
+	self.isMouseDown = true
+	self.icon:UpdateCoord()
+end
+
+local function onMouseUp(self)
+	self.isMouseDown = false
+	self.icon:UpdateCoord()
+end
+
+do
+	local deg, atan2 = math.deg, math.atan2
+	local function onUpdate(self)
+		local mx, my = Minimap:GetCenter()
+		local px, py = GetCursorPosition()
+		local scale = Minimap:GetEffectiveScale()
+		px, py = px / scale, py / scale
+		local pos = 225
+		if self.db then
+			pos = deg(atan2(py - my, px - mx)) % 360
+			self.db.minimapPos = pos
+		else
+			pos = deg(atan2(py - my, px - mx)) % 360
+			self.minimapPos = pos
+		end
+		updatePosition(self, pos)
+	end
+
+	function onDragStart(self)
+		self:LockHighlight()
+		self.isMouseDown = true
+		self.icon:UpdateCoord()
+		self:SetScript("OnUpdate", onUpdate)
+		isDraggingButton = true
+		lib.tooltip:Hide()
+		for _, button in next, lib.objects do
+			if button.showOnMouseover then
+				button.fadeOut:Stop()
+				button:SetAlpha(1)
+			end
+		end
+	end
+end
+
+local function onDragStop(self)
+	self:SetScript("OnUpdate", nil)
+	self.isMouseDown = false
+	self.icon:UpdateCoord()
+	self:UnlockHighlight()
+	isDraggingButton = false
+	for _, button in next, lib.objects do
+		if button.showOnMouseover then
+			button.fadeOut:Play()
+		end
+	end
+end
+
+local defaultCoords = {0, 1, 0, 1}
+local function updateCoord(self)
+	local coords = self:GetParent().dataObject.iconCoords or defaultCoords
+	local deltaX, deltaY = 0, 0
+	if not self:GetParent().isMouseDown then
+		deltaX = (coords[2] - coords[1]) * 0.05
+		deltaY = (coords[4] - coords[3]) * 0.05
+	end
+	self:SetTexCoord(coords[1] + deltaX, coords[2] - deltaX, coords[3] + deltaY, coords[4] - deltaY)
+end
+
+local function createButton(name, object, db)
+	local button = CreateFrame("Button", "LibDBIcon10_"..name, Minimap)
+	button.dataObject = object
+	button.db = db
+	button:SetFrameStrata("MEDIUM")
+	button:SetSize(31, 31)
+	button:SetFrameLevel(8)
+	button:RegisterForClicks("anyUp")
+	button:RegisterForDrag("LeftButton")
+	button:SetHighlightTexture(136477) --"Interface\\Minimap\\UI-Minimap-ZoomButton-Highlight"
+	local overlay = button:CreateTexture(nil, "OVERLAY")
+	overlay:SetSize(53, 53)
+	overlay:SetTexture(136430) --"Interface\\Minimap\\MiniMap-TrackingBorder"
+	overlay:SetPoint("TOPLEFT")
+	local background = button:CreateTexture(nil, "BACKGROUND")
+	background:SetSize(20, 20)
+	background:SetTexture(136467) --"Interface\\Minimap\\UI-Minimap-Background"
+	background:SetPoint("TOPLEFT", 7, -5)
+	local icon = button:CreateTexture(nil, "ARTWORK")
+	icon:SetSize(17, 17)
+	icon:SetTexture(object.icon)
+	icon:SetPoint("TOPLEFT", 7, -6)
+	button.icon = icon
+	button.isMouseDown = false
+
+	local r, g, b = icon:GetVertexColor()
+	icon:SetVertexColor(object.iconR or r, object.iconG or g, object.iconB or b)
+
+	icon.UpdateCoord = updateCoord
+	icon:UpdateCoord()
+
+	button:SetScript("OnEnter", onEnter)
+	button:SetScript("OnLeave", onLeave)
+	button:SetScript("OnClick", onClick)
+	if not db or not db.lock then
+		button:SetScript("OnDragStart", onDragStart)
+		button:SetScript("OnDragStop", onDragStop)
+	end
+	button:SetScript("OnMouseDown", onMouseDown)
+	button:SetScript("OnMouseUp", onMouseUp)
+
+	button.fadeOut = button:CreateAnimationGroup()
+	local animOut = button.fadeOut:CreateAnimation("Alpha")
+	animOut:SetOrder(1)
+	animOut:SetDuration(0.2)
+	animOut:SetFromAlpha(1)
+	animOut:SetToAlpha(0)
+	animOut:SetStartDelay(1)
+	button.fadeOut:SetToFinalAlpha(true)
+
+	lib.objects[name] = button
+
+	if lib.loggedIn then
+		updatePosition(button, db and db.minimapPos)
+		if not db or not db.hide then
+			button:Show()
+		else
+			button:Hide()
+		end
+	end
+	lib.callbacks:Fire("LibDBIcon_IconCreated", button, name) -- Fire 'Icon Created' callback
+end
+
+-- We could use a metatable.__index on lib.objects, but then we'd create
+-- the icons when checking things like :IsRegistered, which is not necessary.
+local function check(name)
+	if lib.notCreated[name] then
+		createButton(name, lib.notCreated[name][1], lib.notCreated[name][2])
+		lib.notCreated[name] = nil
+	end
+end
+
+-- Wait a bit with the initial positioning to let any GetMinimapShape addons
+-- load up.
+if not lib.loggedIn then
+	local f = CreateFrame("Frame")
+	f:SetScript("OnEvent", function(f)
+		for _, button in next, lib.objects do
+			updatePosition(button, button.db and button.db.minimapPos)
+			if not button.db or not button.db.hide then
+				button:Show()
+			else
+				button:Hide()
+			end
+		end
+		lib.loggedIn = true
+		f:SetScript("OnEvent", nil)
+	end)
+	f:RegisterEvent("PLAYER_LOGIN")
+end
+
+local function getDatabase(name)
+	return lib.notCreated[name] and lib.notCreated[name][2] or lib.objects[name].db
+end
+
+function lib:Register(name, object, db)
+	if not object.icon then error("Can't register LDB objects without icons set!") end
+	if lib.objects[name] or lib.notCreated[name] then error(DBICON10.. ": Object '".. name .."' is already registered.") end
+	if not db or not db.hide then
+		createButton(name, object, db)
+	else
+		lib.notCreated[name] = {object, db}
+	end
+end
+
+function lib:Lock(name)
+	if not lib:IsRegistered(name) then return end
+	if lib.objects[name] then
+		lib.objects[name]:SetScript("OnDragStart", nil)
+		lib.objects[name]:SetScript("OnDragStop", nil)
+	end
+	local db = getDatabase(name)
+	if db then
+		db.lock = true
+	end
+end
+
+function lib:Unlock(name)
+	if not lib:IsRegistered(name) then return end
+	if lib.objects[name] then
+		lib.objects[name]:SetScript("OnDragStart", onDragStart)
+		lib.objects[name]:SetScript("OnDragStop", onDragStop)
+	end
+	local db = getDatabase(name)
+	if db then
+		db.lock = nil
+	end
+end
+
+function lib:Hide(name)
+	if not lib.objects[name] then return end
+	lib.objects[name]:Hide()
+end
+
+function lib:Show(name)
+	check(name)
+	local button = lib.objects[name]
+	if button then
+		button:Show()
+		updatePosition(button, button.db and button.db.minimapPos or button.minimapPos)
+	end
+end
+
+function lib:IsRegistered(name)
+	return (lib.objects[name] or lib.notCreated[name]) and true or false
+end
+
+function lib:Refresh(name, db)
+	check(name)
+	local button = lib.objects[name]
+	if db then
+		button.db = db
+	end
+	updatePosition(button, button.db and button.db.minimapPos or button.minimapPos)
+	if not button.db or not button.db.hide then
+		button:Show()
+	else
+		button:Hide()
+	end
+	if not button.db or not button.db.lock then
+		button:SetScript("OnDragStart", onDragStart)
+		button:SetScript("OnDragStop", onDragStop)
+	else
+		button:SetScript("OnDragStart", nil)
+		button:SetScript("OnDragStop", nil)
+	end
+end
+
+function lib:GetMinimapButton(name)
+	return lib.objects[name]
+end
+
+do
+	local function OnMinimapEnter()
+		if isDraggingButton then return end
+		for _, button in next, lib.objects do
+			if button.showOnMouseover then
+				button.fadeOut:Stop()
+				button:SetAlpha(1)
+			end
+		end
+	end
+	local function OnMinimapLeave()
+		if isDraggingButton then return end
+		for _, button in next, lib.objects do
+			if button.showOnMouseover then
+				button.fadeOut:Play()
+			end
+		end
+	end
+	Minimap:HookScript("OnEnter", OnMinimapEnter)
+	Minimap:HookScript("OnLeave", OnMinimapLeave)
+
+	function lib:ShowOnEnter(name, value)
+		local button = lib.objects[name]
+		if button then
+			if value then
+				button.showOnMouseover = true
+				button.fadeOut:Stop()
+				button:SetAlpha(0)
+			else
+				button.showOnMouseover = false
+				button.fadeOut:Stop()
+				button:SetAlpha(1)
+			end
+		end
+	end
+end
+
+function lib:GetButtonList()
+	local t = {}
+	for name in next, lib.objects do
+		t[#t+1] = name
+	end
+	return t
+end
+
+function lib:SetButtonRadius(radius)
+	if type(radius) == "number" then
+		lib.radius = radius
+		for _, button in next, lib.objects do
+			updatePosition(button, button.db and button.db.minimapPos or button.minimapPos)
+		end
+	end
+end
+
+function lib:SetButtonToPosition(button, position)
+	updatePosition(lib.objects[button] or button, position)
+end
+
+-- Upgrade!
+for name, button in next, lib.objects do
+	local db = getDatabase(name)
+	if not db or not db.lock then
+		button:SetScript("OnDragStart", onDragStart)
+		button:SetScript("OnDragStop", onDragStop)
+	end
+	button:SetScript("OnEnter", onEnter)
+	button:SetScript("OnLeave", onLeave)
+	button:SetScript("OnClick", onClick)
+	button:SetScript("OnMouseDown", onMouseDown)
+	button:SetScript("OnMouseUp", onMouseUp)
+
+	if not button.fadeOut then -- Upgrade to 39
+		button.fadeOut = button:CreateAnimationGroup()
+		local animOut = button.fadeOut:CreateAnimation("Alpha")
+		animOut:SetOrder(1)
+		animOut:SetDuration(0.2)
+		animOut:SetFromAlpha(1)
+		animOut:SetToAlpha(0)
+		animOut:SetStartDelay(1)
+		button.fadeOut:SetToFinalAlpha(true)
+	end
+end
+lib:SetButtonRadius(lib.radius) -- Upgrade to 40

Libs/LibDBIcon-1.0/lib.xml

@@ -0,0 +1,7 @@
+<Ui xmlns="http://www.blizzard.com/wow/ui/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.blizzard.com/wow/ui/
+..\FrameXML\UI.xsd">
+
+<Script file="LibDBIcon-1.0.lua"/>
+
+</Ui>
+

Libs/LibDataBroker-1.1/LibDataBroker-1.1.lua

@@ -0,0 +1,90 @@
+
+assert(LibStub, "LibDataBroker-1.1 requires LibStub")
+assert(LibStub:GetLibrary("CallbackHandler-1.0", true), "LibDataBroker-1.1 requires CallbackHandler-1.0")
+
+local lib, oldminor = LibStub:NewLibrary("LibDataBroker-1.1", 4)
+if not lib then return end
+oldminor = oldminor or 0
+
+
+lib.callbacks = lib.callbacks or LibStub:GetLibrary("CallbackHandler-1.0"):New(lib)
+lib.attributestorage, lib.namestorage, lib.proxystorage = lib.attributestorage or {}, lib.namestorage or {}, lib.proxystorage or {}
+local attributestorage, namestorage, callbacks = lib.attributestorage, lib.namestorage, lib.callbacks
+
+if oldminor < 2 then
+	lib.domt = {
+		__metatable = "access denied",
+		__index = function(self, key) return attributestorage[self] and attributestorage[self][key] end,
+	}
+end
+
+if oldminor < 3 then
+	lib.domt.__newindex = function(self, key, value)
+		if not attributestorage[self] then attributestorage[self] = {} end
+		if attributestorage[self][key] == value then return end
+		attributestorage[self][key] = value
+		local name = namestorage[self]
+		if not name then return end
+		callbacks:Fire("LibDataBroker_AttributeChanged", name, key, value, self)
+		callbacks:Fire("LibDataBroker_AttributeChanged_"..name, name, key, value, self)
+		callbacks:Fire("LibDataBroker_AttributeChanged_"..name.."_"..key, name, key, value, self)
+		callbacks:Fire("LibDataBroker_AttributeChanged__"..key, name, key, value, self)
+	end
+end
+
+if oldminor < 2 then
+	function lib:NewDataObject(name, dataobj)
+		if self.proxystorage[name] then return end
+
+		if dataobj then
+			assert(type(dataobj) == "table", "Invalid dataobj, must be nil or a table")
+			self.attributestorage[dataobj] = {}
+			for i,v in pairs(dataobj) do
+				self.attributestorage[dataobj][i] = v
+				dataobj[i] = nil
+			end
+		end
+		dataobj = setmetatable(dataobj or {}, self.domt)
+		self.proxystorage[name], self.namestorage[dataobj] = dataobj, name
+		self.callbacks:Fire("LibDataBroker_DataObjectCreated", name, dataobj)
+		return dataobj
+	end
+end
+
+if oldminor < 1 then
+	function lib:DataObjectIterator()
+		return pairs(self.proxystorage)
+	end
+
+	function lib:GetDataObjectByName(dataobjectname)
+		return self.proxystorage[dataobjectname]
+	end
+
+	function lib:GetNameByDataObject(dataobject)
+		return self.namestorage[dataobject]
+	end
+end
+
+if oldminor < 4 then
+	local next = pairs(attributestorage)
+	function lib:pairs(dataobject_or_name)
+		local t = type(dataobject_or_name)
+		assert(t == "string" or t == "table", "Usage: ldb:pairs('dataobjectname') or ldb:pairs(dataobject)")
+
+		local dataobj = self.proxystorage[dataobject_or_name] or dataobject_or_name
+		assert(attributestorage[dataobj], "Data object not found")
+
+		return next, attributestorage[dataobj], nil
+	end
+
+	local ipairs_iter = ipairs(attributestorage)
+	function lib:ipairs(dataobject_or_name)
+		local t = type(dataobject_or_name)
+		assert(t == "string" or t == "table", "Usage: ldb:ipairs('dataobjectname') or ldb:ipairs(dataobject)")
+
+		local dataobj = self.proxystorage[dataobject_or_name] or dataobject_or_name
+		assert(attributestorage[dataobj], "Data object not found")
+
+		return ipairs_iter, attributestorage[dataobj], 0
+	end
+end

Libs/LibDataBroker-1.1/README.textile

@@ -0,0 +1,13 @@
+LibDataBroker is a small WoW addon library designed to provide a "MVC":http://en.wikipedia.org/wiki/Model-view-controller interface for use in various addons.
+LDB's primary goal is to "detach" plugins for TitanPanel and FuBar from the display addon.
+Plugins can provide data into a simple table, and display addons can receive callbacks to refresh their display of this data.
+LDB also provides a place for addons to register "quicklaunch" functions, removing the need for authors to embed many large libraries to create minimap buttons.
+Users who do not wish to be "plagued" by these buttons simply do not install an addon to render them.
+
+Due to it's simple generic design, LDB can be used for any design where you wish to have an addon notified of changes to a table.
+
+h2. Links
+
+* "API documentation":http://github.com/tekkub/libdatabroker-1-1/wikis/api
+* "Data specifications":http://github.com/tekkub/libdatabroker-1-1/wikis/data-specifications
+* "Addons using LDB":http://github.com/tekkub/libdatabroker-1-1/wikis/addons-using-ldb

README.md

@@ -1,11 +1,68 @@
 # Grichelde - Text replacer
 
-Grichelde is a WoW Classic Addon that replaces characters you typed in a chatbox with any replacement text you specified in the addon options.   
+Grichelde is a WoW Classic Addon that replaces any characters or words you typed in a chatbox with any replacement text or word you specified.
+You can define any search and replace text arbitrarily. The replacement is done **before** the text is send to others/in the target channel. 
+It does **not** change txt others have written in the chat/channel.
+
+Its purpose it to simulate a speaking disability of your toon and hereby strengthen immersion in roleplay. 
+Initially started as a helper addon for a roleplaying friend, Grichelde can be used for much more, like 
 
-Intentionally started as a helper addon for a roleplaying friend, Grichelde can be used for much more, like 
 * fixing your common spelling errors :)
 * replacing toon names with their nick names
 * write out abbreviations for you
 * create hilarious moments during roleplay
 
-<!-- Did you ever had an Undead without a jaw and wondered how it might sound like if s/he'd actually speak? --> 
+## Disclaimer
+#### No Warranty
+The addon is provided "AS IS" and comes without warranty of any kind of function or correctness (for more details, consult the GPL 3 license).
+Also the author is not held responsible for any risk or damage the addon or its use might cause, especially lost of progress or data due to crashes of the WoW client.
+
+#### Respect others
+This addon does not encourange or intend to hurt or to tease people with speaking disabilities or language disorders. 
+The responsibility rest on the user completely. Please use the features with care and respect to other players.
+                                 
+## FAQ
+
+#### Where do I start?
+
+Grichelde is active right from the start with default mappings. To open the options UI, either left-click on
+the new minimap icon, or type `/gri` or `/grichelde` in the chatbox. All mappings and channels can be configured there.
+
+#### Does it replace only letters but also whole words?
+
+Grichelde is capable of handling both, even whole sentences can be replaced. 
+Only slash commands, item links, textures, placeholders and ooc-markers are excluded from replacement.
+
+#### My replacement is not taken.
+
+After entering a search or replacement text, you see a button "Okay" next to yout input. This is **not** a validation message, 
+but the save button for text. This is a restriction from the UI library and can be seen in other addons as well. 
+Please click on "Okay" button to save the input permanently.
+
+If it still does not work or gives you errors, please read the next question. 
+
+#### I have to disable the Addon frequently. Is there a more elegant solution
+
+Actually there are two solutions:
+1. A right-click on the minimap button will disable Grichelde instantly. Right-click a second time will activate it again. Easy, isn't it?
+2. You can disable Grichelde permanently and forcefully replace the sentence in the chatbox. I call it "Grichelde-On-Demand" :) 
+   In the chatbox put `/gri` or `/grichelde` in front of your typed text, you can also include the target channel, 
+   i.e. `/gri /guild hello there` and Grichelde will apply the active replacements even if guild channel or Grichelde was disabled.
+
+#### I get errors, what should I do?
+
+Please report your errors on [project website](https://www.curseforge.com/wow/addons/grichelde) at curse forge. Make a screenshot or copy both the error message as well as your recent mappings.
+You can bring up a small windows with your mapping by entering the `/gri mappings` command on copy them.
+
+#### Why that strange name?
+
+Grichelde is the name of an Undead rogue without a jaw, who was played in RP sessions with a guild member.
+She started replacing "s" and "t" letters manually for each line in the chat, which became cumbersome over time.
+(If you ever wondered how an Undead without a jaw sounds like, its really hilarious, you should try it.) 
+Without spelling errors, "Griselde" in German is an old-fashioned female first name.
+
+#### I'm a Pro. Does it support regular expressions?
+
+This is actually an unofficial feature. In general the searchText is passed in as Lua, so yes regex can be used in lookups.
+There are two caveats: first, Lua does not support PCRE syntax, as it would bloat Lua's simplicity and performance (read [here](http://www.lua.org/pil/20.1.html) why).
+Secondly, Grichelde does not support capture groups in the replacement text, so matches get lost. 

libs.xml

@@ -4,12 +4,14 @@
   <Script file="Libs\LibStub\LibStub.lua"/>
   <Include file="Libs\CallbackHandler-1.0\CallbackHandler-1.0.xml"/>
   <Include file="Libs\AceAddon-3.0\AceAddon-3.0.xml"/>
-  <Include file="Libs\AceConfig-3.0\AceConfig-3.0.xml"/>
+  <Include file="Libs\AceLocale-3.0\AceLocale-3.0.xml" />
+  <Include file="Libs\AceEvent-3.0\AceEvent-3.0.xml" />
+  <Include file="Libs\AceHook-3.0\AceHook-3.0.xml"/>
   <Include file="Libs\AceConsole-3.0\AceConsole-3.0.xml"/>
   <Include file="Libs\AceDB-3.0\AceDB-3.0.xml"/>
   <Include file="Libs\AceDBOptions-3.0\AceDBOptions-3.0.xml"/>
   <Include file="Libs\AceGUI-3.0\AceGUI-3.0.xml"/>
-  <Include file="Libs\AceEvent-3.0\AceEvent-3.0.xml" />
+  <Include file="Libs\AceConfig-3.0\AceConfig-3.0.xml"/>
-  <Include file="Libs\AceLocale-3.0\AceLocale-3.0.xml" />
+  <Script file="Libs\LibDataBroker-1.1\LibDataBroker-1.1.lua" />
-  <Include file="Libs\AceHook-3.0\AceHook-3.0.xml"/>
+  <Script file="Libs\LibDBIcon-1.0\LibDBIcon-1.0.lua" />
 </Ui>

localisation/deDE.lua

@@ -1,15 +1,35 @@
-local L = LibStub('AceLocale-3.0'):NewLocale('Grichelde', 'deDE')
+-- read namespace from global env
+local AddonName, _ = ...
+local _G = _G
+local Grichelde = _G.Grichelde
+
+local L = LibStub('AceLocale-3.0'):NewLocale(AddonName, 'deDE')
 if not L then return end
 
+local cYellow = Grichelde.functions.cYellow
+local cGray = Grichelde.functions.cGray
+local cPrefix = Grichelde.functions.cPrefix
+
 -- system messages
 L.AddonName = "Grichelde"
-L.VersionAbbr = "v"
+L.AddonNamePlusVersion = "%s v%s"
-L.AddonLoaded = "%s hilft Euch jetzt bei euren Sprachschwierigkeiten."
+L.AddonLoaded = "%s unterst\195\188tzt Euch jetzt bei euren Sprachschwierigkeiten."
+L.AddonUnloaded = "%s wartet geduldig Euch weiter unterst\195\188tzen zu d\195\188rfen."
 L.Upgrade_ToVersion = "Hebe Databank auf Version %s an."
 L.Upgrade_Successful = "Upgrade erfolgreich."
+
+-- debug
 L.Debug_Options = "Optionen"
 L.Debug_Mappings = "Ersetzungen"
+L.Debug_Mappings_Hint = "Der Inhalt der Textbox dient nur zur Fehlersuche und kann herauskopiert werden. Es werden keine Werte aus dieser Textbox eingelesen oder anderweitig verwertet."
 L.Debug_Mappings_Found = "%d Ersetzungen gefunden"
+L.Debug_Profile = "Profil"
+
+-- errors
+L.Error_InvalidCommand = "Ung\195\188ltiger Befehl"
+L.Error_InvalidChannel = "Ung\195\188ltiger Kanal"
+L.Error_InvalidWhisperTarget = "Ung\195\188ltiger Fl\195\188sterziel"
+L.Error_UnsupportedChannel = "Nicht unterst\195\188tzter Kanal"
 
 -- profiles
 L.Profiles_Available = "Verf\195\188gbare Profile:"
@@ -22,10 +42,20 @@ L.Profiles_Reset = "Profil %s zur\195\188ckgesetzt."
 L.Profiles_Invalid = "Ung\195\188ltiges Profil %s!"
 L.Profiles_DeleteError = "Das aktive Profil kann nicht gel\195\182scht werden!"
 
+-- minimap
+L.Minimap_Tooltip_Enabled = "%s"
+L.Minimap_Tooltip_Disabled = "%s " .. cGray("(inaktiv)")
+L.Minimap_Tooltip_Options_Left = "Linksklick"
+L.Minimap_Tooltip_Options_Right = "\195\150ffnet oder schlie\195\159t die Einstellungen."
+L.Minimap_Tooltip_Mappings_Left = "Rechtsklick"
+L.Minimap_Tooltip_Mappings_Right = "Aktiviert oder Deaktivert jegliche Ersetzungen."
+
 -- options
 L.Options_Title = "%s Einstellungen"
 L.Options_Enabled_Name = "Aktiv"
 L.Options_Enabled_Desc = "Aktiviert %s"
+L.Options_Minimap_Button_Name = "Zeige Minimap-Knopf"
+L.Options_Minimap_Button_Desc = "Zeigt oder versteckt den Knopf an der Miniaturkarte"
 
 L.Options_Channels_Group_Name = "Kan\195\164le"
 L.Options_Channels_Group_Desc = "%s ist in folgenden Kan\195\164len aktiv."
@@ -65,25 +95,107 @@ L.Options_Replacements_Add_Desc = "F\195\188gt eine neue Zuordnung hinzu."
 L.Options_Replacements_DeleteAll_Name = "Alle L\195\182schen"
 L.Options_Replacements_DeleteAll_Desc = "L\195\182scht alle Zuweisungen."
 L.Options_Replacements_DeleteAll_ConfirmText="Wirklich ALLE Zuweisungen l\195\182schen?"
-L.Options_Replacements_Header = "Die Vorkommen links vom Pfeil ( => ) werden in den aktivierten Kan\195\164len gesucht und durch den Text rechts vom Pfeil ersetzt."
+L.Options_Replacements_Header = "Die Vorkommen links vom Pfeil \"=>\" werden in den aktivierten Kan\195\164len gesucht und durch den Text rechts vom Pfeil ersetzt."
-                                .."|nWird die Gro\195\159- und Kleinschreibung ignoriert, wird die Gro\195\159schreibung jedes Zeichens wird bei der Ersetzung \195\188bernommen."
+
-                                .."|nDas Zusammenfassen aufeinanderfolgender Treffer vermeidet unsch\195\182ne Wiederholungen, die durch die Ersetzung entstehen k\195\182nnen."
-                                .."|nMit den beiden Standard-Ersetzung wird so aus \"Tasse\" => \"Ckache\"."
 L.Options_Mapping_Group_Name = "%s => %s"
 L.Options_Mapping_Group_Desc = "Dieses Vorkommen wird in den aktivierten Kan\195\164len ersetzt."
 L.Options_Mapping_EmptyMapping = "(keine)"
+L.Options_Mapping_Enabled_Name = "Aktiv"
+L.Options_Mapping_Enabled_Desc = "Diese Ersetzung wird durchgef\195\188hrt"
 L.Options_Mapping_SearchText_Name = "Suchtext:"
 L.Options_Mapping_SearchText_Desc = "Dieser Text wird in der Chateingabe gesucht."
 L.Options_Mapping_ReplaceText_Name = "Ersetzung:"
 L.Options_Mapping_ReplaceText_Desc = "Jeder Suchtreffer wird mit diesem Text ersetzt."
-L.Options_Mapping_ExactCase_Name = "exakte Gro\195\159- und Kleinschreibung"
+L.Options_Mapping_ExactCase_Name = "Exakte Gro\195\159- und Kleinschreibung"
 L.Options_Mapping_ExactCase_Desc = "Wenn gesetzt, muss die Gro\195\159- und Kleinschreibung des Suchtextes exakt \195\188berein stimmen. Anderfalls wird die Gro\195\159schreibung jedes Zeichens bei der Ersetzung \195\188bernommen."
-L.Options_Mapping_Consolidate_Name = "Fa\195\159e aufeinanderfolgende Treffer zusammen"
+L.Options_Mapping_Consolidate_Name = "Zusammenfassen aufeinanderfolgender Treffer"
 L.Options_Mapping_Consolidate_Desc = "Wenn durch die Ersetzung die Zeichenfolge mehrfach hintereinander steht,|nfasse sie zu einem Vorkommen zusammen."
+L.Options_Mapping_StopOnMatch_Name = "Anhalten nach Treffer"
+L.Options_Mapping_StopOnMatch_Desc = "F\195\188hrt keine nachfolgenden Ersetzungen mehr durch, wenn dieser Eintrag ein Suchtreffer war."
 L.Options_Mapping_MoveUp_Name = "^"
 L.Options_Mapping_MoveUp_Desc = "nach oben verschieben"
 L.Options_Mapping_MoveDown_Name = "v"
 L.Options_Mapping_MoveDown_Desc = "nach unten verschieben"
 L.Options_Mapping_Delete_Name = "L\195\182schen"
 L.Options_Mapping_Delete_Desc = "L\195\182scht diese Zuweisung."
-L.Options_Mapping_Delete_ConfirmText="Diese Zuweisung l\195\182schen?"
+L.Options_Mapping_Delete_ConfirmText="Diese Zuweisung l\195\182schen?"
+
+L.Options_Help_Group_Name = "Hilfe"
+L.Options_Help_Group_Desc = "Hilfstellungen zu den Suchmustern und zur Ersetzungslogik."
+L.Options_Help_Disclaimer = cYellow("Haftungsausschlu\195\159:") .. " Das Addon wird im reinen Ist-Zustand zur Verf\195\188gung gestellt, ohne Garantie auf Funktion und Fehlerfreiheit (f\195\188r mehr Details siehe GPL 3 Lizenzdokument). "
+                            .. "Ferner \195\188bernimmt der Autor keinerlei Haftung oder Gew\195\164hrleistung f\195\188r durch das Addon oder dessen Nutzung entstandene Fehler oder Sch\195\164den, "
+                            .. "insb. den Verlust von Spielfortschritt oder Daten aufgrund von Abst\195\188rzen des WoW-Clients."
+L.Options_Help_Tab_Basics_Name = "Grundlagen"
+L.Options_Help_Tab_Basics_Desc = "Erl\195\164utert die Grundlagen des Addons"
+L.Options_Help_Tab_Expert_Name = "Experte"
+L.Options_Help_Tab_Expert_Desc = "Beleuchtet die Besonderheiten bei der Textsuche."
+L.Options_Help_Tab_Examples_Name = "Beispiele"
+L.Options_Help_Tab_Examples_Desc = "Beispiele f\195\188r bestimmte Szenarien."
+
+L.Options_Help_Basics = cYellow("Reihenfolge")
+                        .. "|nEs sind unbegrenzt viele Textersetzung m\195\182glich, und sie werden in der Reihenfolge der definierten Zuordnungen abgearbeitet, von oben nach unten. "
+                        .. "Ersetzungen sind transitiv, d.h. nachfolgende Zuordnungen beziehen sich nicht auf den Originaltext, sondern das Resultat der vorherigen Ersetzung. "
+                        .. "|nMit der Zuordnung " .. cPrefix("\"a\" => \"b\"") .. " und " .. cPrefix("\"b\" => \"c\"") .. " wird bei Eingabe von " .. cPrefix("\"a\" => \"c\"") .. "."
+                        .. "|n|n" .. cYellow("Exakte Gro\195\159- und Kleinschreibung")
+                        .. "|nBei exakter Gro\195\159- und Kleinschreibung muss die Schreibweise genau \195\188berstimmen, sonst findet keine Textersetzug f\195\188r diese Zuordnung statt. "
+                        .. "Wird die Gro\195\159- und Kleinschreibung ignoriert, wird die Gro\195\159schreibung jedes Zeichens bei der Ersetzung \195\188bernommen. "
+                        .. "|nMit der Zuordnung " .. cPrefix("\"aBcDeF\" => \"uvWXYz\"") .. " wird aus " .. cPrefix("\"abcdef\" => \"uvwxyz\"") .. ", "
+                        .."aus " .. cPrefix("\"ABCDEF\" => \"UVWXYZ\"") .. " und aus " .. cPrefix("\"AbCdEf\" => \"UvWxYz\"") .. "."
+                        .. "|n|n" .. cYellow("Zusammenfassen aufeinanderfolgender Treffer")
+                        .. "|nDas Zusammenfassen aufeinanderfolgender Treffer vermeidet unsch\195\182ne Wiederholungen, die durch die Ersetzung entstehen k\195\182nnen. "
+                        .. "Die Zusammenfassung wird erst nach der Ersetzung vorgenommen, d.h. am vollst\195\164ndig ersetzten Text f\195\188r jede Zuordnung. "
+                        .. "|nMit der Zuordnung " .. cPrefix("\"s\" => \"sch\"") .. " wird aus " .. cPrefix("\"Tasse\" => \"Tasche\"") .. " statt " .. cPrefix("\"Taschsche\"") .. ", "
+                        .. "aber " .. cPrefix("\"schmeissen\" => \"schchmeischen\"") .. ". Solche Randbedingungen beseitigt in der Regel eine weitere Zuordnung wie " .. cPrefix("\"chch\" => \"ch\"") .. "."
+                        .. "|n|n" .. cYellow("Anhalten nach Treffer")
+                        .. "|nEs werden keine weiteren Ersetzungen mehr vorgenommen, wenn die aktuelle Zuordnung zutreffend ist. Alle nachfolgenden Zuordnungen werden dann \195\188bersprungen. Wenn kein Treffer vorliegt, werden die restlichen Zuordnung ganz normal weiter abgearbeitet."
+L.Options_Help_Expert = cYellow("verk\195\188rzende/verl\195\163ngernde Ersetzungen")
+                        .. "|nIst der Ersetzungstext k\195\188rzer als der eigentliche Suchtext, werden die \195\188bersch\195\188\195\159igen Zeichen des Suchtreffers entfernt. "
+                        .. "Ist der Ersetzungstext l\195\163nger, werden die \195\188brigen Zeichen nach dem Treffer hinten drangehangen. Dabei wird die Gro\195\159- und Kleinschreibung des letzten Zeichens ber\195\188cksichtigt, "
+                        .. "ebenso wie die Gro\195\159- und Kleinschreibung des nachfolgenden Zeichens. Gro\195\159geschriebene Abk\195\188rzungen und Ausdr\195\188cke bleiben so einheitlich. "
+                        .. "|nMit der Zuordnung " .. cPrefix("\"Kr\195\164uter\" => \"Gr\195\188nzeugs\"") .. " wird aus " .. cPrefix("\"KR\195\132UTER\" => \"GR\195\156NZEUGS\"") .. " statt " .. cPrefix("\"GR\195\156NZEUgs\"") .. " "
+                        .. "unter Beibehaltung von absichtlicher Gro\195\159schreibung wie " .. cPrefix("\"Kr\195\132utERGarten\" => \"Gr195\156nzEUGSgarten\"") .. " statt " .. cPrefix("\"Gr\195\188nzeugsGarten\"") .. "."
+                        .. "|n|n" .. cYellow("Standby")
+                        .. "|nErsetzungen k\195\182nnen auch nur bei Bedarf durchgef\195\188hrt werden, selbst wenn das Addon oder ein Kanal deaktivert wurde. "
+                        .. "Vor der Eingabe in der Chatbox schreibt man " .. cPrefix("/gri").. " oder " .. cPrefix("/grichelde").. " und optional noch den Zielkanal "
+                        .. "z.B. " .. cPrefix("\"/gri /p hallo da dr\195\188ben\"") .. " und alle aktiven Zuordnungen werden ersetzt, selbst wenn der Gruppenkanal oder das Addon nicht aktiv sind."
+                        .. "|n|n" .. cYellow("Regul\195\164re Ausdr\195\188cke")
+                        .. "|nRegEx sind sehr m\195\163chtige Such- und Ersetzunsgmuster die h\195\163ufig in der Programmierung verwendet werden. Technisch gesehen benutzt das Addon f\195\188r die Suchen des Eingabetextes bereits regul\195\163ren Ausdr\195\188cke. "
+                        .. "Das Eingeben von RegEx als Suchtext ist allerings eine inoffizielle Funktion und hat zwei gro\195\159e Einschr\195\163nkungen: "
+                        .. "|n1. Leider unterst\195\188tzt Lua nicht den vollst\195\163ndigen Umfang von PCRE. Trotzdem k\195\182nnen einige Muster verwendet werden wie Zeilenanfang " .. cPrefix("\"^\"") .. " "
+                        .."oder Zeilenende " .. cPrefix("\"$\"") .. ", Zeichenklassen wie Zahlen " .. cPrefix("\"%d\"") .. " oder (negierte) Auswahlen " .. cPrefix("\"[^%p]\"") .. ". "
+                        .. "|n2. Es werden keine Gruppen im Ersetzungstest unterst\195\188tzt, so da\195\159 Gruppen einfach verloren gehen. Wegen der Gro\195\159- und Kleinschreibung und steigender Komplexit\195\163t ist diese Funktion auch f\195\188r die Zukunft nicht geplant. "
+                        .. "|nIm Beispiel-Reiter gibt es einige Ersetzungen, welche mit regul\195\164ren Ausdr\195\188cke umgesetzt wurden."
+
+L.Options_Help_Examples_Note = cYellow("Hinweis:") .. " Dieses Addon bef\195\188rwortet nicht und beabsichtig nicht Personen mit (Fremd-)Sprachproblemen |nzu verletztem oder herabzuw\195\188rdigen. Die Verantwortung f\195\188r den Einsatz des Addons obliegt dem Benutzer. |nBitte verwendet die Funktion respektvoll und zur\195\188ckhaltend gegen\195\188ber anderen Mitspielern."
+L.Options_Help_Examples0_Header = cYellow("Beispiel")
+L.Options_Help_Examples0_Text = "Bitte ein Beispiel aus der Auswahlbox ausw\195\164hlen."
+L.Options_Help_Examples1_Select = "fehlender Unterkiefer"
+L.Options_Help_Examples1_Header = cYellow("S und P werden durch Zisch- und Klacklaute ersetzt.")
+L.Options_Help_Examples1_Text = cPrefix("s => ch") .. "|n|n" .. cPrefix("t => ck")
+L.Options_Help_Examples2_Select = "Trollifizierung"
+L.Options_Help_Examples2_Header = cYellow("L\195\164\195\159t euch fast wie ein echter Troll klingen.")
+L.Options_Help_Examples2_Text = cPrefix("%.$ => , maan.") .. "|n|n" .. cPrefix("ir => ia") .. "|n|n" .. cPrefix("ch => ck") .. "|n|n" .. cPrefix("g => ch") .. "|n|n" .. cPrefix("qu => kw") .. "|n|n" .. cPrefix("t => d")
+L.Options_Help_Examples3_Select = "Altmodisch"
+L.Options_Help_Examples3_Header = cYellow("Benutzt eine antiquiertere Schreibweise.")
+L.Options_Help_Examples3_Text = cPrefix("ei => ey") .. "|n|n" .. cPrefix("\195\159 => sz")
+L.Options_Help_Examples4_Select = "Abk\195\188rzungen"
+L.Options_Help_Examples4_Header = cYellow("Viel sagen, wenig tippen.")
+L.Options_Help_Examples4_Text = cPrefix("gz => Herzlichen Gl\195\188ckwunsch") .. "|n|n" .. cPrefix("gn8 => Gute Nacht") .. "|n|n" .. cPrefix("afk => Bin mal eben weg (AFK)") .. "|n|n" .. cPrefix("MC => Geschmolzener Kern")
+L.Options_Help_Examples5_Select = "Eigen-, Kose- und Ortsnamen"
+L.Options_Help_Examples5_Header = cYellow("Ersetzt Spielernamen, NPCs oder Orte durch andere Ausdr\195\188cke.")
+L.Options_Help_Examples5_Text = "Exakte Gro\195\159- und Kleinschreibung wird empfohlen|n|n" .. cPrefix("Sylvanas => die rachs\195\188chtige Bansheek\195\182nigin") .. "|n|n" .. cPrefix("R\195\188tzkn\195\188bbel => R\195\188tzi") .. "|n|n" .. cPrefix("Unterstadt => Undercity")
+L.Options_Help_Examples6_Select = "Lispeln"
+L.Options_Help_Examples6_Header = cYellow("Aussprache von S und Z wird zu einem Zischlaut")
+L.Options_Help_Examples6_Text = cPrefix("sch => ch") .. "|n|n" .. cPrefix("s => fs") .. "|n|n" .. cPrefix("z => ts") .. "|n|n" .. cPrefix("chs => x")
+L.Options_Help_Examples7_Select = "Stottern"
+L.Options_Help_Examples7_Header = cYellow("Stottern")
+L.Options_Help_Examples7_Text = "p[%s]-$"
+
+L.IgnorePattern_Star = "Stern"
+L.IgnorePattern_Circle = "Kreis"
+L.IgnorePattern_Diamond = "Diamant"
+L.IgnorePattern_Triangle = "Dreieck"
+L.IgnorePattern_Moon = "Mond"
+L.IgnorePattern_Square = "Quadrat"
+L.IgnorePattern_Cross = "Kreuz"
+L.IgnorePattern_Skull = "Totenkopf"

localisation/enUS.lua

@@ -1,15 +1,35 @@
-local L = LibStub('AceLocale-3.0'):NewLocale('Grichelde', 'enUS', true)
+-- read namespace from global env
+local AddonName, _ = ...
+local _G = _G
+local Grichelde = _G.Grichelde
+
+local L = LibStub('AceLocale-3.0'):NewLocale(AddonName, 'enUS', true)
 if not L then return end
 
+local cYellow = Grichelde.functions.cYellow
+local cGray = Grichelde.functions.cGray
+local cPrefix = Grichelde.functions.cPrefix
+
 -- system messages
 L.AddonName = "Grichelde"
-L.VersionAbbr = "v"
+L.AddonNamePlusVersion = "%s v%s"
-L.AddonLoaded = "%s now helps you with your spelling disabilities."
+L.AddonLoaded = "%s happily assists you with your spelling disabilities now."
+L.AddonUnloaded = "%s patiently waits to support you again when needed."
 L.Upgrade_ToVersion = "Upgrade database to version %s."
 L.Upgrade_Successful = "Upgrade successful."
+
+-- debug
 L.Debug_Options = "Options"
 L.Debug_Mappings = "Mappings"
-L.Debug_Mappings_Found = "%d Mappings found"
+L.Debug_Mappings_Hint = "The content of this input box is used for debugging purposes only and can be copied. No input from this box will be read or processed."
+L.Debug_Mappings_Found = "%d mappings found"
+L.Debug_Profile = "Profile"
+
+-- errors
+L.Error_InvalidCommand = "Invalid command"
+L.Error_InvalidChannel = "Invalid channel"
+L.Error_InvalidWhisperTarget = "Invalid whisper target"
+L.Error_UnsupportedChannel = "Unsupported channel"
 
 -- profiles
 L.Profiles_Available = "Available profiles:"
@@ -22,10 +42,20 @@ L.Profiles_Reset = "Profil %s reset."
 L.Profiles_Invalid = "Invalid profile %s!"
 L.Profiles_DeleteError = "The active profile cannot be deleted!"
 
+-- minimap
+L.Minimap_Tooltip_Enabled = "%s"
+L.Minimap_Tooltip_Disabled = "%s " .. cGray("(inactive)")
+L.Minimap_Tooltip_Options_Left = "Left-Click"
+L.Minimap_Tooltip_Options_Right = "Opens or closes the options UI."
+L.Minimap_Tooltip_Mappings_Left = "Right-Click"
+L.Minimap_Tooltip_Mappings_Right = "Enables or disables any replacements."
+
 -- options
 L.Options_Title = "%s Options"
 L.Options_Enabled_Name = "Enabled"
 L.Options_Enabled_Desc = "Enables %s"
+L.Options_Minimap_Button_Name = "Show minimap button"
+L.Options_Minimap_Button_Desc = "Shows or hides the button on the minimap."
 
 L.Options_Channels_Group_Name = "Channels"
 L.Options_Channels_Group_Desc = "%s is active in the following channels."
@@ -65,13 +95,13 @@ L.Options_Replacements_Add_Desc = "Adds a new replacement mapping."
 L.Options_Replacements_DeleteAll_Name = "Delete All"
 L.Options_Replacements_DeleteAll_Desc = "Deletes all replacement mappings."
 L.Options_Replacements_DeleteAll_ConfirmText = "Do you really want to delete ALL replacement mappings?"
-L.Options_Replacements_Header = "All matches on the lefthand side of the arrow ( => ) will be replaced in activated channels by the text on the righthand side."
+L.Options_Replacements_Header = "All matches on the lefthand side of the arrow \"=>\" will be replaced in activated channels by the text on the righthand side. "
-                                .. "|nIf case sensivity is ignored, the case for each letter of the matching text is taken over when replaced."
+
-                                .. "|nConsolidation of consecutive matches prevent unaesthetic repetitions of letters introduced by replacements."
-                                .. "|nWith both default mappings active, the mapping would be \"Tossing\" => \"Ckoching\"."
 L.Options_Mapping_Group_Name = "%s => %s"
 L.Options_Mapping_Group_Desc = "This lookup will be replaced in activated channels."
 L.Options_Mapping_EmptyMapping = "(none)"
+L.Options_Mapping_Enabled_Name = "active"
+L.Options_Mapping_Enabled_Desc = "This replacement will be processed."
 L.Options_Mapping_SearchText_Name = "Search for:"
 L.Options_Mapping_SearchText_Desc = "This text is looked up in your chat input box."
 L.Options_Mapping_ReplaceText_Name = "Replacement:"
@@ -80,10 +110,92 @@ L.Options_Mapping_ExactCase_Name = "exact case"
 L.Options_Mapping_ExactCase_Desc = "When set, matches must be case-sensitive. Otherwise the case for each letter of the matching text is taken over when replaced."
 L.Options_Mapping_Consolidate_Name = "consolidate consecutive matches"
 L.Options_Mapping_Consolidate_Desc = "If after the replacement a text sequence is repeated|ndirectly after another, treat them as one occurrence."
+L.Options_Mapping_StopOnMatch_Name = "stop on match"
+L.Options_Mapping_StopOnMatch_Desc = "Stops looking for any following replacements, when this one matched."
 L.Options_Mapping_MoveUp_Name = "^"
 L.Options_Mapping_MoveUp_Desc = "move up"
 L.Options_Mapping_MoveDown_Name = "v"
 L.Options_Mapping_MoveDown_Desc = "move down"
 L.Options_Mapping_Delete_Name = "Delete"
 L.Options_Mapping_Delete_Desc = "Deletes this replacement mapping."
-L.Options_Mapping_Delete_ConfirmText = "Delete this replacement mapping?"
+L.Options_Mapping_Delete_ConfirmText = "Delete this replacement mapping?"
+
+L.Options_Help_Group_Name = "Help"
+L.Options_Help_Group_Desc = "Guideance to search patterns and replacement logic."
+L.Options_Help_Disclaimer = cYellow("Disclaimer of warranty:") .. " The addon is provided \"AS IS\" and comes without warranty of any kind of function or correctness (for more details, consult the GPL 3 license). "
+                            .."Also the author is not held responsible for any risk or damage the addon or its use might cause, especially lost of progress or data due to crashes of the WoW client."
+
+L.Options_Help_Tab_Basics_Name = "Basics"
+L.Options_Help_Tab_Basics_Desc = "Some explanatory notes the the basic behaviour."
+L.Options_Help_Tab_Expert_Name = "Expert"
+L.Options_Help_Tab_Expert_Desc = "More details on special search options."
+L.Options_Help_Tab_Examples_Name = "Examples"
+L.Options_Help_Tab_Examples_Desc = "Templates for particular scenarios."
+
+L.Options_Help_Basics = cYellow("Ordering")
+                        .. "|nYou can have an unlimited number of replacements. All mappings will be processed in same order as defined, from top down. "
+                        .. "Replacements are also transitive, so consecutive mappings do not work on the original input but the resulting text from the previous replacements. "
+                        .. "|nBoth mappings " .. cPrefix("\"a\" => \"b\"") .. " and " .. cPrefix("\"b\" => \"c\"") .. " applied, result in the final text " .. cPrefix("\"a\" => \"c\"") .. "."
+                        .. "|n|n" .. cYellow("exact case")
+                        .. "|nIf \"exact case\" is checked, lower and upper case must match exactly to be replaced, otherwise the mapping is skipped. "
+                        .. "If case sensivity is ignored, the case for each letter of the matching text is taken over when replaced. "
+                        .. "|nWith mapping " .. cPrefix("\"aBcDeF\" => \"uvWXYz\"") .. " text results in " .. cPrefix("\"abcdef\" => \"uvwxyz\"") .. ", "
+                        .. "also " .. cPrefix("\"ABCDEF\" => \"UVWXYZ\"") .. " and " .. cPrefix("\"AbCdEf\" => \"UvWxYz\"") .. "."
+                        .. "|n|n" .. cYellow("consolidate consecutive matches")
+                        .. "|nConsolidation of consecutive matches prevent unaesthetic repetitions of letters introduced during replacements. "
+                        .. "Consolidation takes place after all replacements were done, meaning it's applied to the completely replaced text. "
+                        .. "|nWith mapping " .. cPrefix("\"s\" => \"sh\"") .. " text becomes " .. cPrefix("\"tossing\" => \"toshing\"") .. " instead of " .. cPrefix("\"toshshing\"") .. ", yet still " .. cPrefix("\"paths\" => \"pathsh\"") .. ". "
+                        .. "Such edge cases can usually be mitigated with an additional mapping at the end: " .. cPrefix("\"thsh\" => \"thz\"") .. "."
+                        .. "|n|n" .. cYellow("stop on match")
+                        .. "|nNo other replacements are done, when the current mapping matched. This will skip any other consecutive mappings when hit. When no match ocurred, the remaining mappings are processed as usual."
+L.Options_Help_Expert = cYellow("shortening/lengthening replacements")
+                        .. "|nIf the replacement is shorter than the actual match, all remaining characters will be skipped. If the replacement is longer, all remaining characters will be appended. "
+                        .. "The case of the replaced character is considered as well as the case of the next character in the original text. That way capital case abbreviations and expressions will not be distorted. "
+                        .. "|nWith mapping " .. cPrefix("\"Body\" => \"Corpse\"") .. " the input becomes " .. cPrefix("\"BODY\" => \"CORPSE\"") .. " instead of " .. cPrefix("\"CORPse\"") .. " "
+                        .. "but still keeps intended exceptions like " .. cPrefix("\"BodYGuard\" => \"CorPSEGuard\"") .. " instead of " .. cPrefix("\"CorpseGuard\"") .. ". "
+                        .. "|n|n" .. cYellow("On-Demand")
+                        .. "|nFor convenience input text in a chatbox can be forcefully replaced, even if the addon or the channel was disabled. "
+                        .. "In the chatbox put " .. cPrefix("/gri") .. " or " .. cPrefix("/grichelde") .. " in front of your typed text, you can also include the target channel, "
+                        .. "i.e. " .. cPrefix("\"/gri /guild hello there\"") .. " and the active replacements are applied even if the guild channel or global switch was disabled."
+                        .. "|n|n" .. cYellow("Regular Expressions")
+                        .. "|nRegex are very powerful search and replacement patterns commonly used in programming. Technically all searches the addon performs on the input text are done with regular expression methods. "
+                        .. "Entering regex as search text however is an unofficial feature and has two major caveats: "
+                        .. "|n1. Unfornately Lua does not support full PCRE syntax and is very limited. Nethertheless some patterns can be used like start of line " .. cPrefix("\"^\"") .. " or end of line " .. cPrefix("\"$\"") .. ", "
+                        .. "character classes like numbers " .. cPrefix("\"%d\"") .. " or (inversed) sets " .. cPrefix("\"[^%p]\"") .. ". "
+                        .. "|n2. There is no support for capture groups in the replacement text, so matches get lost. Because of case sensivity and complexity there are no plans to support this."
+                        .. "|nAnyway, there are some mappings using RegEx in the Example secion."
+
+
+L.Options_Help_Examples_Note = cYellow("Note:") .. " This addon does not encourange or intend to hurt or to tease people with speaking disabilities or language disorders. The responsibility rest on the user completely. Please use the features with care and respect to other players."
+L.Options_Help_Examples0_Header = cYellow("Example")
+L.Options_Help_Examples0_Text = "Select an example from the dropdown above."
+L.Options_Help_Examples1_Select = "absent jaw"
+L.Options_Help_Examples1_Header = cYellow("S and P will be replaced by sibilant and clack sounds.")
+L.Options_Help_Examples1_Text = cPrefix("s => ch") .. "|n|n" .. cPrefix("t => ck")
+L.Options_Help_Examples2_Select = "trollifier"
+L.Options_Help_Examples2_Header = cYellow("Almost sound like a real Troll.")
+L.Options_Help_Examples2_Text = cPrefix("%.$ => , mon.") .. "|n|n" .. cPrefix("th => d") .. "|n|n" .. cPrefix("you => ya") .. "|n|n" .. cPrefix("ing => in'")
+L.Options_Help_Examples3_Select = "old-fashioned"
+L.Options_Help_Examples3_Header = cYellow("Use an outdate pronounciation.")
+L.Options_Help_Examples3_Text = cPrefix("oi => oy") .. "|n|n" .. cPrefix("do => doe") .. "|n|n" .. cPrefix("go => goe") .. "|n|n" .. cPrefix("you => thou") .. "|n|n" .. cPrefix("yours => thy") .. "|n|n" .. cPrefix("be => bee") .. "|n|n" .. cPrefix("we => wee")
+L.Options_Help_Examples4_Select = "abbreviations"
+L.Options_Help_Examples4_Header = cYellow("Say much, type less.")
+L.Options_Help_Examples4_Text = cPrefix("gz => Congratulations") .. "|n|n" .. cPrefix("gn8 => Good night") .. "|n|n" .. cPrefix("afk => I'm temporarikly not available (AFK)") .. "|n|n" .. cPrefix("MC => Molten Core")
+L.Options_Help_Examples5_Select = "Proper names"
+L.Options_Help_Examples5_Header = cYellow("Replace player names, NPCs or locations.")
+L.Options_Help_Examples5_Text = "exact case is recommended|n|n" .. cPrefix("Sylvanas => the revengeful banshee queen") .. "|n|n" .. cPrefix("Asmongold => Asmon") .. "|n|n" .. cPrefix("Crossroads => X-roads")
+L.Options_Help_Examples6_Select = "lisp"
+L.Options_Help_Examples6_Header = cYellow("S and Z will become a sibilant")
+L.Options_Help_Examples6_Text = cPrefix("s => th") .. "|n|n" .. cPrefix("ch => tsh") .. "|n|n" .. cPrefix("z => tsh") .. "|n|n" .. cPrefix("dg => ck")
+L.Options_Help_Examples7_Select = "stammer"
+L.Options_Help_Examples7_Header = cYellow("stammer")
+L.Options_Help_Examples7_Text = "p[% s]-$"
+
+L.IgnorePattern_Star = "Star"
+L.IgnorePattern_Circle = "Circle"
+L.IgnorePattern_Diamond = "Diamond"
+L.IgnorePattern_Triangle = "Triangle"
+L.IgnorePattern_Moon = "Moon"
+L.IgnorePattern_Square = "Square"
+L.IgnorePattern_Cross = "Cross"
+L.IgnorePattern_Skull = "Skull"

twitch/image-descriptions.txt

@@ -0,0 +1,40 @@
+Sample replacement
+Text is replaced in the "Say" channel.
+
+Replacements
+Create multiple mappings between search text and replacement with additional conditions.
+
+Channel configuration
+individual channel activation
+
+Profiles
+global, per server, per class, per character
+
+New: Examples
+Templates for various situations
+
+
+
+Beispielersetzung
+Eine Texteingabe wird im "Sagen"-Kanal ersetzt.
+
+Zeichenersetzung
+Erzeuge bedingte Zuordnungen zwischen Such- und Ersetzungetext.
+
+Kanälekonfiguration
+einzeln pro Kanal aktivierbar
+
+Profile:
+Global, pro Server, pro Klasse, pro Character
+
+Neu: Beispiele
+Vorlagen für verschiedene Zwecke
+
+
+
+Error Reporting
+In case of errors please send me the exact error message and please also provide the mapping from "/gri mappings" (see next screen).
+
+Debug Mappings
+In case of errors please send me the exact error message and please also provide the mapping from "/gri mappings".
+