some help/tutorials

[saxitoxin]

I'm looking for some help, hopefully a tutorial that explains tags, I have created a few frames, and would like to add som text to them, health, name, lvl, power and so on.
Any push in the right direction is appreciated

[Phanx]

To add a tag to your frame:

local text = frame:CreateFontString(nil, "OVERLAY", "GameFontNormal")
text:SetPoint("BOTTOM", frame, "TOP", 0, 2)
frame:Tag(text, "[name] - Level [level] [creature]")

Pretty straightforward. Just create a font string, and call the :Tag method on your frame, passing it the font string object first, and the tag string second. The font string doesn't have to be parented directly to the frame, but the :Tag method is always on the frame even if you parent the font string to eg. your health bar.

All the predefined tags are in oUF\elements\tags.lua if you want to see exactly what they do, or here is a list:

affix
chi
classification
cpoints
curhp
curmana
curpp
dead
group
holypower
leader
leaderlong
level
maxhp
maxmana
maxpp
missinghp
missingpp
name
offline
pereclipse
perhp
perpp
plus
pvp
rare
resting
sex
shadoworbs
shortclassification
smartlevel
soulshards
status
threat
threatcolor

There are some others defined, but they don't have any events attached, so they will not work properly.

To create your own tag:

oUF.Tags.Events["mytag"] = "SPACE SEPARATED LIST OF EVENTS"

oUF.Tags.Methods["mytag"] = function(unit)
    -- run some code here to get the text and return it
end

As an example, here is the tag I use for unit coloring in my layout:

oUF.Tags.Events["unitcolor"] = "UNIT_HEALTH UNIT_CLASSIFICATION_CHANGED UNIT_CONNECTION UNIT_FACTION UNIT_REACTION"
oUF.Tags.Methods["unitcolor"] = function(unit)
	local color
	if UnitIsDeadOrGhost(unit) or not UnitIsConnected(unit) then
		color = oUF.colors.disconnected
	elseif UnitIsPlayer(unit) then
		local _, class = UnitClass(unit)
		color = oUF.colors.class[class]
	elseif UnitIsTapped(unit) and not UnitIsTappedByPlayer(unit) and not UnitIsTappedByAllThreatList(unit) then
		color = oUF.colors.tapped
	elseif UnitIsEnemy(unit, "player") then
		color = oUF.colors.reaction[1]
	else
		color = oUF.colors.reaction[UnitReaction(unit, "player") or 5]
	end
	return color and ("|cff%02x%02x%02x"):format(color[1] * 255, color[2] * 255, color[3] * 255) or "|cffffffff"
end

[saxitoxin]

I'm doing something wrong, I can't even get the name to show
this is the code I use in my units/target file

local name = frame:CreateFontString(nil, "OVERLAY", "GameFontNormal")
    name:SetPoint("BOTTOM", Portrait, "TOP", 0, 4)
    Portrait:Tag(name, "[name]")

and this is all my code in modules/tags file. copied directly from oUF_SquarePortrait, all I have edited is change the name, and made all core instances into tags

local addon, ns = ...
local cfg = ns.cfg
 
  --container
  local tags = CreateFrame("Frame")
  ns.tags = tags
  
  ---------------------------------------------
  -- FUNCTIONS
  ---------------------------------------------
  
  function tags:CreateDropShadow(parent,edgeFile,edgeSize,padding)
    if parent.dropShadow then return end
    edgeFile = edgeFile or ""
    edgeSize = edgeSize or 8
    padding = padding or 8
    parent.dropShadow = CreateFrame("Frame", nil, parent)
    parent.dropShadow:SetPoint("TOPLEFT",-padding,padding)
    parent.dropShadow:SetPoint("BOTTOMRIGHT",padding,-padding)
    parent.dropShadow:SetBackdrop({ bgFile = nil, edgeFile = edgeFile, tile = false, tileSize = 16, edgeSize = edgeSize, insets = { left = 0, right = 0, top = 0, bottom = 0, }, })  
    local mt = getmetatable(parent).__index
    mt.SetDropShadowColor = function(self,r,g,b,a) self.dropShadow:SetBackdropBorderColor(r or 1, g or 1, b or 1, a or 1) end
  end
 
  --fontstring func
  function tags:NewFontString(parent,family,size,outline,layer)
    local fs = parent:CreateFontString(nil, layer or "OVERLAY")
    fs:SetFont(family,size,outline)
    fs:SetShadowOffset(0, -2)
    fs:SetShadowColor(0,0,0,1)
    return fs
  end
  
  ---------------------------------------------
  -- TAGS
  ---------------------------------------------
  
  --unit name tag
  oUF.Tags.Events["sxui:name"] = "UNIT_NAME_UPDATE UNIT_CONNECTION"
  oUF.Tags.Methods["sxui:name"] = function(unit)
    local name = oUF.Tags.Methods["name"](unit)
    return "|cffffffff"..name.."|r"
  end
 
 
  --unit health tag
  oUF.Tags.Events["sxui:health"] = "UNIT_HEALTH_FREQUENT UNIT_MAXHEALTH"
  oUF.Tags.Methods["sxui:health"] = function(unit)
    local perhp = oUF.Tags.Methods["perhp"](unit)
    return "|cffffffff"..perhp.."|r"
  end

But I still don't get it to work :/

[p3lim]

Your portrait element is not your frame.

[Phanx]

Yep. This right here is your problem:

Originally Posted by saxitoxin local name = frame:CreateFontString(nil, "OVERLAY", "GameFontNormal") name:SetPoint("BOTTOM", Portrait, "TOP", 0, 4) Portrait:Tag(name, "[name]")

As mentioned in my previous post:

Originally Posted by Phanx The font string doesn't have to be parented directly to the frame, but the :Tag method is always on the frame even if you parent the font string to eg. your health bar.

Your Portrait object does not have a :Tag method.