NOTE: the functionality described below is the same as that in T169613, which introduced the New Filters on RC Page. The only differences are: 1) Improved wording for messages (see below), and 2) everything happens on Watchlist and works with Watchlist preferences, 3) we added an actual opt-out button to the notice saying you can opt out.
When the New Filters graduate out of beta on Watchlist, we will:
- Introduce the new filters to users getting them for the first time. This applies only to users that didn't have the beta feature enabled, but now will see the new feature since it become the default.
- Provide a path to disable the new feature. We expect users to like the new filters, but providing them some flexibility to go back to the old system provides them an emergency exit to some issues (e.g., a specific gadget breaking the new tool), avoiding unnecessary stress.
==The Introduction Popover
- After graduation, when a user who was not previously opted in to the beta visits Watchlist for the first time, a popover will appear introducing the new features.
- The popover remains visible for 4 seconds, and then disappears.
- The user can also dismiss the popover by 1) clicking the "OK, got it" button, 2) clicking a link to navigate away from the page 3) clicking the page anywhere outside the popover.
- Once it is dismissed or disappears on its own, the Introduction should not be shown to that user on that wiki again.
- Different messages are shown to ORES vs. non-ORES wikis (wording below--!!Please note that I've suggested changed wording in both the message headlines and body text.!!).
- A "Learn more" link is provided. The link opens a new tab/browser and goes to the [[ https://www.mediawiki.org/wiki/Edit_Review_Improvements/Filters_for_Special:Recent_Changes | RC Filters page on mediawiki ]].
- The design of the popover will be based the same as the one we show for Recent Changes
-- The image used in the panel will be animated. A non-looping animated Gif for the animation is available at F5053416
{F18498285}
==The preferences Notice
After the user dismisses the Introduction, another popover gives the user notice that the new features can be disabled.
- The Notice appears below and points at the Preferences link in the top navigation.
- If the user does nothing, the popover will vanish automatically after 3 seconds.
- If the user clicks the popover, clicks the page off the popover or navigates to a different page, the popover disappears.
- The Notice will not be repeated for that user on that wiki.
{F18497531}
==Wording for popovers and notice
[INTRODUCTION, ORES VERSION]
**Welcome to improved Watchlist filtering**
Review edits more efficiently using new filters, an improved interface, user-defined highlighting and the power of machine learning.
[INTRODUCTION, NON-ORES]
**Welcome to improved Watchlist filtering**
Review edits more efficiently using new filters, a more powerful interface, user-defined highlighting and other improvements.
[NOTICE]
Access the Watchlist tab in preferences any time to disable the improved version of Watchlist.
== Implementation
For logged-in users, it should use preferences, as usual.
For anonymous users, it should use jquery.jStorage, with a TTL. I suggest a year.