Adding a tooltip to databroker addon?

[flaicher]

I've been using Artifact Power addon for a while and stripped it down to bare minimum.. It would be perfect for me if I just could figure out how to add a tooltip to show the addon's date.
As documentation for all the stuff I'm interested in addon lua is almost non-existant..

Could some give me a few tips how to get started? With adding the tooltip to this addon.

[Seerah]

Adding a tooltip to an LDB plugin is simple. Create an OnTooltipShow method to your plugin object. It has one parameter, which is the tooltip object. Search any plugin's Lua file for the OnTooltipShow method if you need an example.

[Torhal]

Many LDB-enabled AddOns use LibQTip-1.0 for their tooltips, which doesn't work with OnTooltipShow and use OnEnter and OnLeave instead.

[Seerah]

Oh yeah, I didn't think of that. I guess it would depend on what you (the OP) want to show in your tooltip and how you want it displayed.

[flaicher]

I used OnEnter and OnLeave as those seemed a simpler way to implement the minimal tooltip.
For some reason OnTooltipShow liked to give me errors
Although I might change to OnTooltipShow as addons that have their tooltips made by LibQTip don't want to get beautified by BenikUI (or ElvUI, not sure which one does it).

Thanks Torhal and Seerah

[Phanx]

Keep in mind that while OnEnter/OnLeave/OnClick/etc receive a reference to the actual frame object being entered/left/clicked/etc. as their first argument, OnTooltipShow does not get that -- it only gets a reference to the tooltip object being used to show the tooltip.

These should produce identical results:

local myPlugin = LibStub("LibDataBroker-1.1"):NewDataObject("MyPlugin", {
    text = "Hello world",
    OnEnter = function(frame)
        GameTooltip:SetOwner(frame, "ANCHOR_BOTTOMLEFT")
        GameTooltip:SetText("Hello!")
        GameTooltip:AddLine("This is my tooltip.")
        GameTooltip:Show()
    end,
    OnLeave = function(frame)
        GameTooltip:Hide()
    end
})

local myPlugin = LibStub("LibDataBroker-1.1"):NewDataObject("MyPlugin", {
    text = "Hello world",
    OnTooltipShow = function(tooltip)
        tooltip:SetText("Hello!")
        tooltip:AddLine("This is my tooltip.")
        tooltip:Show()
    end
})