XWIKI-19751: Move the "watch" button for a page to the page content menu

[surli]

Jira URL

https://jira.xwiki.org/browse/XWIKI-19751

Changes

Description

Goal of this PR is to simplify usage of the watch page feature.
It comes with important changes:

1. the watch location switches in the bell menu area have been removed
2. a new button with a logo and a status has been introduced next to edit button
3. a new modal has been introduced when clicking on the button providing various choices
4. the watch page API have been modified to not just provide boolean value watch / not watched, but to provide a larger panel of possible statuses
5. a REST resource have been provided to allow watching / blocking / removing a filter on a location

Clarifications

First important changes to review in that PR are the breaking API: they're emphasized in the revapi ignores I added. Most of them are about unstable APIs, but one of them is a real breakage I opened a brainstorming on the forum about it and I'd like feedbacks about it.

Next important change to review is the new APIs I provide:

• the REST resource
• the new statuses

Then only in the end the UI should be reviewed: first thing to review about the UI is the logic of the different choices available in the modal. We can easily change later where we put the button and which vocabulary we use, but if there's a flaw in the logic it's more difficult to change later at it will probably impacts the API.

Screenshots & Video

Capture.video.du.30-05-2024.10.11.19.webm

Note: I'm planning to change a bit the big text below the options we see at 20" in particular to provide a real link and more space.

Executed Tests

Ran:

• on module xwiki-platform-notifications: mvn clean install -Pquality,integration-tests,docker
• on module xwiki-platform-legacy-notifications: mvn clean install -Pquality

Expected merging strategy

• Prefers squash: Yes
• Backport on branches: No

[vmassol]

and start introducing a new UIX for the watch button next to the edit button.

Did we discuss the addition of a new menu in the page content? I'm asking since this will clutter the UI more (the top menu will still be there and the net effect would be the addition of a new menu), so we need to be careful.

[surli]

and start introducing a new UIX for the watch button next to the edit button.

Did we discuss the addition of a new menu in the page content? I'm asking since this will clutter the UI more (the top menu will still be there and the net effect would be the addition of a new menu), so we need to be careful.

There's an open proposal on the forum for all this, but no conclusion yet. In any case this PR is a very preliminary draft: the UI will probably change but I need to see the possible actions to test and properly fix the APIs.