ForeverMailHistory

ForeverMailHistory adds a recipient shortcut menu to the WoW Classic Forever mail compose window. It helps you quickly send mail to recent recipients or other characters on your account.

Features

• Keeps up to 15 recent recipients after mail is successfully sent.
• Adds a dropdown button beside the recipient field with recent recipients and other characters on the same realm and faction.
• Remove a recent recipient by clicking the “×” beside their name.
• Optionally fills in the last recipient automatically. This setting is off by default.
• Records each character’s name, realm, faction, and class when they log in.
• If Syndicator is installed, it can also read character information from Syndicator’s saved data.

How to Use

1. Open the mail compose window.
2. Click the dropdown button beside the recipient field.
3. Select a recent recipient or another character to fill in the recipient field.
4. To enable automatic recipient entry, check Auto-fill last recipient at the bottom of the menu.

Recipients are added to the history only after mail is sent successfully. Failed sends are not recorded. After selecting a recipient, the cursor moves to the subject field if it is empty.

Status Command

Use /fmh to display the number of recent recipients, the number of recorded characters, and whether the dropdown button has been created.

Saved Data

The addon stores its data in the ForeverMailHistoryDB SavedVariables table. This includes recent recipients, character records, the last recipient, and the auto-fill setting.

Removing the addon does not automatically delete its SavedVariables. To clear the data, delete the corresponding ForeverMailHistory.lua SavedVariables file or remove the ForeverMailHistoryDB entry.

Dependencies

The addon uses the WoW mail interface. Blizzard_MailFrame is listed as an optional dependency, and the shortcut button is created when the mail interface is available.

Syndicator is optional. Without it, the addon continues to use characters recorded by ForeverMailHistory.

# ForeverMailHistory

ForeverMailHistory 為 WoW Classic Forever 的郵件寄件視窗新增收件人快捷選單，方便重複寄信給近期聯絡對象或本帳號的其他角色。

## 功能

- 記錄成功寄出的郵件收件人，最近紀錄最多保留 15 位。
- 在郵件收件人欄旁新增下拉按鈕，可選擇最近收件人或同伺服器、同陣營的其他角色。
- 最近收件人旁的「×」按鈕可刪除該筆紀錄。
- 可選擇自動填入上次收件人；此選項預設關閉。
- 登入角色時記錄角色名稱、伺服器、陣營與職業；若已安裝 Syndicator，也會嘗試從其角色資料讀取其他角色。

## 使用方式

1. 開啟郵件寄件視窗。
2. 點擊收件人欄右側的下拉按鈕。
3. 選取最近收件人或本帳號角色，收件人名稱便會填入欄位。
4. 如需自動帶入上次收件人，開啟選單底部的「自動填入上次收件人」選項。

最近收件人只會在郵件成功寄出後新增；寄送失敗不會留下紀錄。選取收件人後，若主旨欄為空，游標會移至主旨欄。

## 狀態指令

輸入 `/fmh` 可查看最近收件人筆數、已記錄角色數，以及收件人下拉按鈕是否已建立。

## 資料保存

資料儲存在 `ForeverMailHistoryDB` SavedVariables 中，包括最近收件人、角色清單、上次收件人與自動填入設定。移除插件不會自動刪除這份 SavedVariables；若要清除紀錄，請刪除對應的 `ForeverMailHistory.lua` SavedVariables 檔案或清除其中的 `ForeverMailHistoryDB`。

## 相依性

插件使用 WoW 郵件介面；TOC 將 `Blizzard_MailFrame` 列為選用相依項，郵件介面載入後會建立快捷按鈕。Syndicator 為選用插件，未安裝時仍可使用本插件已記錄的角色清單。