Mail Options

Accessing Mail Options

Navigation: Mail page (YOM inbox) → "Options" link (in mail functions navigation)

Opens popup window showing Mail Options interface with available actions.

Available Actions

Mail Options page shows 6 quick-action links:

Deletion Actions

1. Delete All Messages:

• Deletes EVERY message in your inbox
• System messages AND player-sent messages
• Read AND unread messages
• PERMANENT (cannot undo!)
• Use when inbox is full and you want fresh start

2. Delete All System Messages:

• Deletes only system messages (msgfrom = 0)
• System notifications, automated messages, server announcements
• Keeps player-sent messages intact
• Good for clearing notification spam

3. Delete All Read Messages:

• Deletes only messages you've already read (seen = 1)
• Keeps unread messages safe
• Good for inbox cleanup while preserving new mail
• Works on both system and player messages

Mark as Read Actions

4. Mark All Messages as Read:

• Marks EVERY message as read (seen = 1)
• Clears "new mail" notification
• Doesn't delete anything
• Use when you want to clear notification badge without reading

5. Mark All System Messages as Read:

• Marks only system messages as read
• Leaves player messages unread
• Good for ignoring system spam while tracking player conversations

6. Mark All Other Messages as Read:

• Marks all player-sent messages as read (msgfrom ≠ 0)
• Leaves system messages unread
• Use when you want to preserve system notifications but clear player mail

How to Use

Step 1: Click "Options" link from mail page

Step 2: Popup window opens showing 6 action links

Step 3: Click desired action (e.g., "Delete all read messages")

Step 4: Action executes immediately (NO confirmation prompt!)

Step 5: You're returned to mailbox with changes applied

Warning: Actions are INSTANT. No "Are you sure?" confirmation. Click carefully!

Common Use Cases

Full Inbox Cleanup:

• Problem: Inbox has 500+ old messages, can't find new ones
• Solution: Click "Delete all read messages" to remove old mail, keep unread

System Message Spam:

• Problem: Tons of system notifications cluttering inbox
• Solution: Click "Delete all system messages" to remove notifications, keep player mail

Clear Notification Badge:

• Problem: "New mail" notification won't go away
• Solution: Click "Mark all messages as read" to clear badge

Fresh Start:

• Problem: Want to delete everything and start over
• Solution: Click "Delete all messages" (nuclear option)

Safety Tips

Before Deleting:

• Review important messages (clan invites, admin warnings, etc.)
• Save any critical info (passwords, codes, etc.) elsewhere
• Remember: deletion is PERMANENT (no trash folder, no undo)

Recommended Workflow:

• Manually read and delete important messages first
• Use Mail Options to bulk-delete remaining spam/old messages
• Prefer "Delete all read messages" over "Delete all messages"

Technical Details

Hook: mailfunctions (adds "Options" link to mail navigation)

Override Forced Nav: Yes (works even when forced navigation active)

Database Operations:

• Delete actions: DELETE FROM mail WHERE [conditions]
• Mark read actions: UPDATE mail SET seen=1 WHERE [conditions]

Performance: Very fast (single SQL query per action)

Comparison to Manual Management

Without Mail Options:

• Delete messages one at a time (click delete 100 times for 100 messages)
• Mark read one at a time (open each message individually)
• Tedious and time-consuming

With Mail Options:

• Delete 100 messages with one click
• Mark 100 messages read with one click
• Fast and efficient

Limitations

• No selective deletion: Can't bulk-delete specific senders or date ranges
• No confirmation: One-click execution, easy to misclick
• No undo: Deleted messages are gone forever
• No trash folder: Can't recover accidentally deleted mail

Use carefully. When in doubt, delete read messages only (safer than "delete all").

FAQ

Q: I accidentally deleted all my messages. Can I get them back?

A: No. Deletion is permanent. No recovery possible. Be more careful next time.

Q: What's the difference between "Mark all as read" and "Delete all"?

A: "Mark as read" keeps messages but changes status (seen=1). "Delete" removes messages entirely.

Q: Can I bulk-delete messages from specific player?

A: No. Mail Options only supports broad categories (all, system, read). For specific senders, delete manually.

Q: Does "Delete all system messages" include petitions/admin warnings?

A: Yes. System messages (msgfrom=0) include ALL automated messages. Save important ones first.