Editing WoW:USERAPI ConfigMode (section)

=== Multimode handler ===
<div style="margin-left: 3%;">

Some addons can have several different layouts and thus different test modes. This is the case of several unit frame addons.

Such addons can publish a more elaborated handler that supports the following calls:

 * '''handlerFunc("ON", mode)''': enter configuration mode ''mode''
 * '''handlerFunc("OFF")''': leave configuration mode
 * '''mode1, mode2, mode3, ... = handlerFunc("GETMODES")''': list available modes.

:{{icon-exclamation}}Note that you HAVE to be prepared to just receive ("ON") without a mode from a "simple" controller addon. In this case, you can e.g. pick the last mode your addon was in, or whatever makes sense to your addon (UF addon in a raid? show raid mode. In a party? show party mode.)

Here is the sample of a unit frame multimode handler:

  -- Create the global table if it does not exist yet
  CONFIGMODE_CALLBACKS = CONFIGMODE_CALLBACKS or {}
  -- Declare our handler
  CONFIGMODE_CALLBACKS["MyUnitFrameAddon"] = function(action, mode)
    if action == "ON" then
      MyUnitFrameAddon:EnableTestMode(mode)  -- note: mode can be nil!
    elseif action == "OFF" then
      MyUnitFrameAddon:DisableTestMode()
    elseif action == "GETMODES" then
      return "party", "raid"
    end
  end

</div>