{{Header}}
{{title|
title=Donation Systray
}}
{{#seo:
|description=A systray icon encouraging donations.
}}
{{intro|
A systray icon encouraging donations.
}}
{{draft}}

= Introduction =
Implementation idea for a donations-based open source business model.

<u>Status:</u> Stalled. No specific plans at this time.

Related: [[Dev/Open Source Business Models|Open Source Business Models]]

= Intended User Experience =
The donation systray is intended to be a low friction and low pressure reminder rather than a persistent nag screen. A neutral systray icon is shown in a single appropriate environment rather than in every VM. The icon should not visually reveal whether the user donated already, selected an exemption, or has not interacted with it yet.

Users can interact with the systray using either left-click or right-click. Left-click should perform the primary action and open donation information. Right-click should open a menu with dismissal and reminder options. Users who already donated can select that option on the honor system. Users who are eligible for an exemption can select that option as a long term dismissal. Users who do not want to decide immediately can postpone the reminder for a week or a month. Users who do not want to interact with it right now can close it for the current session.

The overall goal is to keep the feature respectful, predictable, and easy to dismiss while still making donations more visible.

= Donation Verification vs Non-Verification =
* '''Verification:''' '''No,''' the actual donation status will not be verified. This is to avoid having to invent code to do that.
* '''Honor based:''' '''Yes.'''
* '''Fake donate:''' Will users be able to select "I donated already" without actually having donated? '''Yes.'''

= Screenshot Issue =
* Issue: If the user takes a screenshot, the systray icons should not look different for users who donated versus those who did not donate yet.
* Previous idea: The systray would have an invisible countdown from 60 seconds to 0 seconds. Once 0 is reached, the systray terminates itself so it vanishes from the systray.
* UX issue: A 60 second countdown could make the systray feel unstable or broken. The icon disappearing by itself could be surprising, confusing, or annoying. It could also vanish before the user has decided what to do.
* Better solution: Do not make the systray icon reflect donation state. Always show the same neutral systray icon regardless of whether the user donated already, selected an exemption, or has not interacted with it yet.
* Result: Screenshots should not reveal donation status through different systray icon states.

= Systray Left Click Action =
* Left-click should perform the primary action.
* Proposed behavior:
** Open the donation pag. In practice this will use open-link-confirmation.
** Keep the systray icon state neutral and unchanged.
* Or... Left click = same as right click?

= Systray Right Click Action =
* Right-click should open the systray menu.
* Proposed menu entries:
** Donate.
** I donated already.
** I am eligible for an exemption.
** Remind me in 1 week.
** Remind me in 1 month.
** Technical information about this systray.
** Do not show this systray or wizard again.
** Exit.
* Behavior:
** Selecting "I donated already" dismisses the reminder on an honor basis.
** Selecting "I am eligible for an exemption" dismisses the reminder long term.
** Selecting a reminder option postpones the next reminder accordingly.
** Selecting "Exit" closes the systray for the current session.

= Systray Hover Effect =
* Show a short, neutral tooltip when hovering over the systray icon.
* Proposed tooltip text:
** "Support the project through donations (optional)."
* The tooltip must not reveal donation status.
* The tooltip should remain identical regardless of whether the user:
** Donated already
** Selected an exemption
** Has not interacted yet
* Avoid persuasive or pressure-inducing language.
* Keep wording concise and informative.
* No animations or changing text on hover.
* Goal: Provide gentle awareness without creating annoyance or exposing user choices.

= Qubes Specific =
* In Qubes-Whonix:
** Undecided. Perhaps:
*** Show the donation systray inside the <code>anon-whonix</code> App Qube only to avoid duplicate systray icons.

= Non-Qubes-Whonix Specific =
* Avoid duplicate systray icons in different VMs.
** Only run in the default VM.
** Skip if running in a "[[Multiple Kicksecure|multiple VM]]". I.e., not the default VM but a VM with a local internal IP different from the default internal IP.

= TODO =
* Define exemption.
* Deprecate exemption?
* Systray or wizard?

= See Also =
* {{VideoLink|videoid=PCzrrVyAypk|style=subtle|text=YouTube video}}
* screenshot: https://www.reddit.com/r/kde/comments/1f42sew/kde_is_asking_for_donations_in_plasma/

onetime only
resets each yet December 01
match style if possible

{{Footer}}
[[Category:Development]]