Wiki source code of Watched Entities
Last modified by Eleni Cojocariu on 2026/10/14 16:24
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Enabling an event type says //what// interests you; watching says //where//. A new account watches nothing, so at first it only hears about events that name it, such as a mention, and about the pages it saves, which automatic page watching starts watching for it. | ||
| 2 | |||
| 3 | You can watch a page, a page together with its children, a whole wiki, or a user. The button next to the "Edit" button of every page shows what applies to the page you are on: | ||
| 4 | |||
| 5 | {{gallery}} | ||
| 6 | [[image:watch-state-followed.png||alt="The watch button in the Followed state"]] | ||
| 7 | [[image:watch-state-blocked.png||alt="The watch button in the Blocked state"]] | ||
| 8 | [[image:watch-state-unset.png||alt="The watch button in the Not set state"]] | ||
| 9 | [[image:watch-state-custom.png||alt="The watch button in the Custom state"]] | ||
| 10 | {{/gallery}} | ||
| 11 | |||
| 12 | * **Followed** means events happening there reach you. | ||
| 13 | * **Blocked** means they do not. | ||
| 14 | * **Not set** means you have expressed nothing about this location. | ||
| 15 | * **Custom** means a filter of yours covers the location but only for some event types or only on one channel, so a single button cannot describe it. | ||
| 16 | |||
| 17 | A state is often inherited rather than set on the page itself: following a wiki makes every page in it followed, and the window that opens when you click the button says so, offering the actions that make sense from there. | ||
| 18 | |||
| 19 | {{image reference="watch-modal-inherited.png" size="large" alt="The watch settings window explaining that the page is followed through a parent"/}} | ||
| 20 | |||
| 21 | Watching is implemented as a filter. Following a location creates a custom filter covering every event type and both channels, which is why what you watch appears in the "Custom Filters" table of your [[notification settings>>doc:documentation.xs.user.notifications.change-notifications-settings.WebHome]]. A narrower filter you wrote yourself is what puts the button in the "Custom" state, and a filter that contradicts the action you ask of the button is disabled rather than silently ignored: following a space you had told the wiki to ignore disables the ignoring filter, and you can switch it back on afterwards. | ||
| 22 | |||
| 23 | Pages you work on are also watched for you, to the extent the "Automatic page watching" setting allows; [[Notification Setting Options>>doc:documentation.xs.user.notifications.change-notifications-settings.options.WebHome]] lists what each of its values does. |
