Files
pfUI/modules/firstrun.lua
T
Brues ee17a39445 updatenotify: isolate fork from upstream pfUI traffic + handle dev builds
Switches the addon-message prefix to "pfUI-brues" so we don't share an
inbound queue with upstream pfUI installs at all — they don't register
a listener for this prefix, so our broadcasts get dropped at the engine
level instead of needing branch-string filtering on their end. The
"main" branch tag stays as a tiebreaker for any future fork variant
sharing this prefix.

Source/dev installs leave the toc Version as "@project-version@" until
release tooling substitutes it. pfUI.lua now stamps those as "dev" with
major/minor/fix=0 instead of silently falling back to 1.2.0, and
updatenotify short-circuits on pfUI.version.string == "dev" before
broadcasting so dev installs don't ship a stale low version to everyone
in guild/raid. Single source of truth — the dev marker lives in pfUI.lua.

URLs centralize via the toc's X-Website. updatenotify and firstrun read
it via GetAddOnMetadata + string.format("%s"), and all eight translation
files swap their hardcoded shagu.org references for the same %s slot.

Drive-bys: groupsize math uses ClassicAPI's IsInRaid/IsInGroup; toc
Author typo "modfied" → "modified".
2026-06-22 13:51:00 -05:00

339 lines
12 KiB
Lua

pfUI:RegisterModule("firstrun", function ()
pfUI.firstrun = CreateFrame("Frame", "pfFirstRunWizard", UIParent)
pfUI.firstrun.steps = {}
pfUI.firstrun:RegisterEvent("PLAYER_ENTERING_WORLD")
pfUI.firstrun:SetScript("OnEvent", function() pfUI.firstrun:NextStep() end)
local autoconfig = false
function pfUI.firstrun:AddStep(name, func)
if not name then return end
table.insert(pfUI.firstrun.steps, { name = name, func = func})
end
local cur, max = 0, 0
function pfUI.firstrun:NextStep()
local windowcount = 0
for i, step in pairs(pfUI.firstrun.steps) do
if not pfUI_init[step.name] then
windowcount = windowcount + 1
end
end
max = windowcount > max and windowcount or max
for _, step in pairs(pfUI.firstrun.steps) do
local name = step.name
if not pfUI_init[name] then
cur = cur + 1
local f = step.func()
f.progress:SetMinMaxValues(0, max)
f.progress:SetValue(cur)
f.ptext:SetText(cur .. " / " .. max)
f.name = name
f:Show()
if autoconfig == true then
f.next:Click()
end
if cur == max then
f.next:SetText(T["Finish"])
autoconfig = false
cur = 0
max = 0
end
return
end
end
end
-- main function to create wizard windows
local function CreateFirstRunPage()
local f = CreateFrame("Frame", nil, UIParent)
f:SetPoint("CENTER", 0, 0)
f:SetFrameStrata("TOOLTIP")
f:SetMovable(true)
f:EnableMouse(true)
f:RegisterForDrag("LeftButton")
f:SetWidth(380)
f:SetHeight(180)
f:SetScript("OnDragStart",function()
this:StartMoving()
end)
f:SetScript("OnDragStop",function()
this:StopMovingOrSizing()
end)
CreateBackdrop(f, nil, nil, .85)
CreateBackdropShadow(f)
-- text
f.text = f:CreateFontString("Status", "OVERLAY", "GameFontNormal")
f.text:SetFontObject(GameFontWhite)
f.text:SetJustifyV("TOP")
f.text:SetJustifyH("CENTER")
f.text:SetPoint("TOPLEFT", f, "TOPLEFT", 10, -10)
f.text:SetPoint("BOTTOMRIGHT", f, "BOTTOMRIGHT", -10, 10)
f.progress = CreateFrame("StatusBar", nil, f)
f.progress:SetPoint("BOTTOMLEFT", 100, 10)
f.progress:SetPoint("BOTTOMRIGHT", -100, 10)
f.progress:SetHeight(12)
f.progress:SetStatusBarTexture(pfUI.media["img:bar"])
f.progress:SetStatusBarColor(.2,1,.8,1)
f.progress:SetMinMaxValues(1,9)
f.progress:SetValue(3)
CreateBackdrop(f.progress)
f.ptext = f.progress:CreateFontString("Status", "LOW", "GameFontNormal")
f.ptext:SetFontObject(GameFontWhite)
f.ptext:SetAllPoints()
f.ptext:SetText("0/0")
f.next = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.next:SetWidth(80)
f.next:SetHeight(20)
f.next:SetPoint("BOTTOMLEFT", f.progress.backdrop, "BOTTOMRIGHT", 8, 0)
f.next:SetText(T["Next"])
f.next:SetScript("OnClick", function()
if f.NextScript then f.NextScript() end
pfUI_init[f.name] = true
f:Hide()
pfUI.firstrun:NextStep()
end)
SkinButton(f.next)
f.abort = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.abort:SetWidth(80)
f.abort:SetHeight(20)
f.abort:SetPoint("BOTTOMRIGHT", f.progress.backdrop, "BOTTOMLEFT", -8, 0)
f.abort:SetText(T["Cancel"])
f.abort:SetScript("OnClick", function()
f:Hide()
end)
SkinButton(f.abort)
f:Hide()
return f
end
-- welcome dialog
pfUI.firstrun:AddStep("init", function()
local f = CreateFirstRunPage()
f.text:SetText(string.format(T["Welcome to |cff33ffccpf|cffffffffUI|r!\n\nI'm the first run wizard that will guide you through some basic configuration. If you're lazy, feel free to hit the \"Defaults\" button. If you wish to run this dialog again, go to the settings and hit the \"Reset Firstrun\" button.\n\nVisit |cff33ffcc%s|r to check for the latest version."], GetAddOnMetadata(pfUI.name, "X-Website")))
return f
end)
-- choose profile
pfUI.firstrun:AddStep("profile", function()
local f = CreateFirstRunPage()
f.text:SetText(T["A new installation of |cff33ffccpf|rUI ships with 4 prebuilt design profiles. Click below if you wish to load one of these profiles."])
f.Modern = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.Modern:SetWidth(120)
f.Modern:SetHeight(20)
f.Modern:SetPoint("BOTTOM", -65, 100)
f.Modern:SetTextColor(1,1,1)
f.Modern:SetText("Modern")
f.Modern:SetScript("OnClick", function()
_G["pfUI_config"] = CopyTable(pfUI_profiles["Modern"])
pfUI_init.selected_profile = "Modern"
pfUI:LoadConfig()
ReloadUI()
end)
SkinButton(f.Modern)
f.Nostalgia = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.Nostalgia:SetWidth(120)
f.Nostalgia:SetHeight(20)
f.Nostalgia:SetPoint("BOTTOM", 65, 100)
f.Nostalgia:SetTextColor(1,1,1)
f.Nostalgia:SetText("Nostalgia")
f.Nostalgia:SetScript("OnClick", function()
_G["pfUI_config"] = CopyTable(pfUI_profiles["Nostalgia"])
pfUI_init.selected_profile = "Nostalgia"
pfUI:LoadConfig()
ReloadUI()
end)
SkinButton(f.Nostalgia)
f.Legacy = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.Legacy:SetWidth(120)
f.Legacy:SetHeight(20)
f.Legacy:SetPoint("BOTTOM", 65, 75)
f.Legacy:SetTextColor(1,1,1)
f.Legacy:SetText("Legacy")
f.Legacy:SetScript("OnClick", function()
_G["pfUI_config"] = CopyTable(pfUI_profiles["Legacy"])
pfUI_init.selected_profile = "Legacy"
pfUI:LoadConfig()
ReloadUI()
end)
SkinButton(f.Legacy)
f.Slim = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.Slim:SetWidth(120)
f.Slim:SetHeight(20)
f.Slim:SetPoint("BOTTOM", -65, 75)
f.Slim:SetTextColor(1,1,1)
f.Slim:SetText("Slim")
f.Slim:SetScript("OnClick", function()
_G["pfUI_config"] = CopyTable(pfUI_profiles["Slim"])
pfUI_init.selected_profile = "Slim"
pfUI:LoadConfig()
ReloadUI()
end)
SkinButton(f.Slim)
f.Slider = CreateFrame("Slider", "pfFirstRunWizardScaleSlider", f, "OptionsSliderTemplate")
f.Slider.text = f.Slider:CreateFontString("Status", "LOW", "GameFontWhite")
f.Slider.text:SetPoint("TOP", f.Slider, "BOTTOM", 0, 2)
f.Slider.text:SetText(T["Scale"])
f.Slider:SetWidth(240)
f.Slider:SetHeight(20)
f.Slider:SetPoint("BOTTOM", 0, 50)
f.Slider:SetOrientation('HORIZONTAL')
f.Slider:SetMinMaxValues(0.5, 2.0)
f.Slider:SetValue(UIParent:GetScale())
f.Slider:SetScript("OnMouseUp", function()
local scale = round(this:GetValue(),2)
SetCVar("uiScale", scale)
SetCVar("useUiScale", 1)
UIParent:SetScale(scale)
this:SetValue(scale)
end)
f.Slider:SetScript("OnValueChanged", function()
local scale = round(this:GetValue(),2)
this:SetValue(scale)
end)
f.Slider:SetScript("OnUpdate", function()
local scale = round(this:GetValue(),2)
this.text:SetText(T["Scale"] .. ": " .. scale * 100 .. "%")
end)
SkinSlider(f.Slider)
return f
end)
-- optimized cvars dialog
pfUI.firstrun:AddStep("cvars", function()
local f = CreateFirstRunPage()
f.text:SetText(T["|cff33ffccBlizzard: \"Interface Options\"|r\n\nDo you want me to set up the recommended Blizzard UI settings? This will enable settings that can be found in the Interface section of your client. Options like Buff Durations, Instant Quest Text, Auto Selfcast and others will be set."])
f.checkbox = CreateFrame("CheckButton", "pfCheckBoxCVAR", f, "UICheckButtonTemplate")
f.checkbox:SetChecked(true)
f.checkbox.text = f:CreateFontString("Status", "LOW", "GameFontNormal")
f.checkbox.text:SetPoint("LEFT", f.checkbox, "RIGHT", 5, 0)
f.checkbox.text:SetText(" " .. T["Setup Optimized Game Settings"])
f.checkbox:SetPoint("BOTTOMLEFT", (f:GetWidth() - f.checkbox.text:GetStringWidth() - 20) / 2, 50)
SkinCheckbox(f.checkbox, 18)
f.NextScript = function()
if f.checkbox:GetChecked() then
pfUI.SetupCVars()
end
end
return f
end)
-- right chat dialog
pfUI.firstrun:AddStep("chat_right", function()
local f = CreateFirstRunPage()
f.text:SetText(T["|cff33ffccChat: \"Loot & Spam\"|r\n\nDo you want me to create and manage a specific Chatframe called \"Loot & Spam\"? This chat will display world channels, loot information and miscellaneous messages, that would otherwise clutter your main chatframe."])
f.checkbox = CreateFrame("CheckButton", "pfCheckBoxChatRight", f, "UICheckButtonTemplate")
f.checkbox:SetChecked(true)
f.checkbox.text = f:CreateFontString("Status", "LOW", "GameFontNormal")
f.checkbox.text:SetPoint("LEFT", f.checkbox, "RIGHT", 5, 0)
f.checkbox.text:SetText(" " .. T["Enable \"Loot & Spam\" Window"])
f.checkbox:SetPoint("BOTTOMLEFT", (f:GetWidth() - f.checkbox.text:GetStringWidth() - 20) / 2, 50)
SkinCheckbox(f.checkbox, 18)
f.NextScript = function()
if not pfUI.chat then message("Couldn't apply settings. Chat module is disabled.") end
pfUI.chat.SetupRightChat(f.checkbox:GetChecked())
end
return f
end)
-- chat position dialog
pfUI.firstrun:AddStep("chat_position", function()
local f = CreateFirstRunPage()
f.text:SetText(T["|cff33ffccChat: \"Layout\"|r\n\nDo you want me to adjust the layout of your chatframes? This would make sure, that every window is placed on its dedicated position."])
f.checkbox = CreateFrame("CheckButton", "pfCheckBoxChatPosition", f, "UICheckButtonTemplate")
f.checkbox:SetChecked(true)
f.checkbox.text = f:CreateFontString("Status", "LOW", "GameFontNormal")
f.checkbox.text:SetPoint("LEFT", f.checkbox, "RIGHT", 5, 0)
f.checkbox.text:SetText(" " .. T["Align Chat Windows"])
f.checkbox:SetPoint("BOTTOMLEFT", (f:GetWidth() - f.checkbox.text:GetStringWidth() - 20) / 2, 50)
SkinCheckbox(f.checkbox, 18)
f.NextScript = function()
if not pfUI.chat then message("Couldn't apply settings. Chat module is disabled.") end
if f.checkbox:GetChecked() then
pfUI.chat.SetupPositions()
end
end
return f
end)
-- chat channels dialog
pfUI.firstrun:AddStep("chat_channels", function()
local f = CreateFirstRunPage()
f.text:SetText(T["|cff33ffccChat: \"Channels\"|r\n\nDo you want me to setup the chat channels of your chatframes? This would set important or personal messages to the left chat and world channels and lootinformation to the right chat."])
f.checkbox = CreateFrame("CheckButton", "pfCheckBoxChatChannels", f, "UICheckButtonTemplate")
f.checkbox:SetChecked(true)
f.checkbox.text = f:CreateFontString("Status", "LOW", "GameFontNormal")
f.checkbox.text:SetPoint("LEFT", f.checkbox, "RIGHT", 5, 0)
f.checkbox.text:SetText(" " .. T["Setup All Chat Channels"])
f.checkbox:SetPoint("BOTTOMLEFT", (f:GetWidth() - f.checkbox.text:GetStringWidth() - 20) / 2, 50)
SkinCheckbox(f.checkbox, 18)
f.NextScript = function()
if not pfUI.chat then message("Couldn't apply settings. Chat module is disabled.") end
if f.checkbox:GetChecked() then
pfUI.chat.SetupChannels()
end
end
return f
end)
-- finalize dialog
pfUI.firstrun:AddStep("finalize", function()
-- Set default positions for new modules based on the active profile.
-- Only write positions that haven't been saved yet (don't override user preferences).
local function SetDefaultPosition(name, anchor, xpos, ypos)
if not pfUI_config.position[name] then
pfUI_config.position[name] = {
anchor = anchor,
parent = "UIParent",
xpos = xpos,
ypos = ypos,
}
end
end
local positions = (pfUI_profiles[pfUI_init.selected_profile or "Modern"] or pfUI_profiles["Modern"]).new_module_positions
or pfUI_profiles["Modern"].new_module_positions
for frameName, pos in pairs(positions) do
SetDefaultPosition(frameName, pos.anchor, pos.xpos, pos.ypos)
end
local f = CreateFirstRunPage()
f.text:SetText(T["Your interface is now set up.\n\nFor advanced configuration, just open the |cff33ffccpf|rUI settings via the escape menu or type \"|cffffffaa/pfui|r\" into the chat.\n\n Have a nice trip!\n\n|cffaaaaaa- Shagu"])
return f
end)
end)