Difference between revisions of "Manual:Extension/BlueSpiceWatchList"

__HIDETITLE__
            
            
            <bs:bookshelf src="Book:User manual" />
            
            
            
            __TOC__
            
            
            
            ==What is WatchList?==
            
            
            
            '''Watchlist''' gives a handy overview of the changes to an individually chosen collection of pages.
            
            
            
            ==Putting a page on your watchlist==
            
            
            
            You can put an article or any other page in the wiki onto your watchlist by
            
            
            
            * calling up the page and clicking on "watch" above the article [[File:Btn-Beobachten-en.png]]
            
            
            
            * editing the page and ticking the "Watch this page" box.
            
            
            
            ==Where to find the watchlist?==
            
            
            
            ::: [[File:watchL1.png]]
            
            
            
            You will find your watchlist by clicking on the small arrow next to your username and then clicking on "Watchlist" in the dropdown menu (see the screenshot).
            
            
            
            ==About the watchlist==
            
            
            
            The watchlist can be viewed in different ways. When you call up your watchlist, you will automatically see the view "Watchlist:Changes". This shows you the most recent changes to all of the pages on your watchlist. These changes are listed in reverse chronological order, i.e. the most recent at the top. You can also set up your preferences for your watchlist here, for example you may want to exclude minor changes or those you have made yourself from the display. <br/>The view "View and edit watchlist" gives you a visual list of all the watched articles. In the view "Edit raw watchlist", you will see this list in wiki code. <br/>
            
            '''Handy tips:'''
            
            
            
            * Whenever you watch a page, you will also be watching the associated '''talk page'''. This also works the other way: when you watch a talk page you automatically watch the article.
            
            * You can tailor your watchlist to your needs under your '''Preferences'''.
            
            * You can set up email notification for changes to your watched pages in '''Preferences'''. See also: Email notification.
            
            ** Note that this notification only occurs once. If you do not visit the page following the change, then you will <u>not</u> be informed of further changes to the page.
            
            ** You can change this by resetting the notification marker. Go to your watchlist and click on the button [[File:Button-WatchList-Seiten_zurücksetzen-en.png|Button-WatchList-Seiten_zurücksetzen.png]]. Now you will be informed of changes without having to visit every page.
            
            * Watched articles are also bolded in the Recent changes list.
            
            
            
            ==Removing pages from your watchlist==
            
            
            
            There are various ways of removing a page from your watchlist.
            
            
            
            '''1. Removing individual pages from your watchlist'''
            
            
            
            * Call up the page and click on "Unwatch" above the article [[File:Btn-Nicht-mehr-beobachten-en.png]]
            
            * Alternatively, call up the page and go to the edit mode. Right at the bottom you will see the tick box '''Watch this page'''. Remove the tick from this and the page will no longer be on your watchlist.
            
            
            
            '''2. Removing multiple pages from your watchlist'''
            
            
            
            * Call up your watchlist (as described above). Choose the view "View and edit watchlist". Now you can place ticks by all the pages you want to remove. Confirm your selection by clicking on "Remove titles".
            
            * Another possibility is to call up your watchlist and choose the view "Edit raw watchlist". This shows you the list of articles in wiki code. Mark the articles you no longer want to watch and delete them from the list. Confirm the changes by clicking on "Update watchlist".
            
            
            
            ==Watching category pages==
            
            
            
            Watching a category only refers to changes to the contents of the category page itself, not the automatically created list of articles in the category. Cf. [http://meta.wikimedia.org/wiki/Help:Watching_pages#What_you_cannot_watch MediaWiki.org entry]
            
            
            
            ==See also==
            
            
            
            Our [[WatchList|reference page.{{DISPLAYTITLE:Watchlist}}
            
            
            
            With the '''watchlist''', you can monitor all wiki pages that are important to you. In your [[Manual:Preferences|preferences]], you can customize when and how to be notified about different types of changes related to the pages on your watchlist. Your watchlist is only visible to you. Administrators can see a report of which pages are not on any watchlist. 
            
            ==Watching and unwatching pages==
            
            In the title section of a page, you can add the page to your watchlist.  Click ''Watch'' to add the page to the watchlist. The link description switches to Unwatch. Click ''Unwatch'' to remove the list from your watchlist.
            
            
            
            
            <br />
            
            [[File:Manual:watchlist-link.png|alt=The watchlist switch link|center|650x650px|thumb|The watchlist switch link]]
            
            
            
            ===Automatic additions===
            
            In addition to manually marking a page watched, there are several ways a page can be added automatically. For example, whenever you create or edit a page, that page can be added to the watchlist. You can change the options for this in the ''Watchlist'' settings in your [[Manual:Preferences|Preferences]].{{Box Note|boxtype=important|Note text=If you have deactivated the setting ''Add pages and files I edit to my watchlist '' in the settings, the check box ''Watch this page'' in the save dialog is not automatically activated. If you do not manually activate this checkbox when saving a page, a page that was on your watch list will be removed from the watch list when you save. Conversely, each page is automatically added to your watch list if this check box is selected by default. When saving, always check whether the edited page should (still) be on your watchlist.
            
            
            
            [[File:Manual:watchlist-savepage-DE.png|alt=A page is removed from the watchlist|center|thumb|400x400px|A page is removed from the watchlist]]
            
            }}
            
            
            
            ==Settings==
            
            Go to your [[BlueSpice Layout|user menu]]. Click ''Preferences'' and select the tab ''Watchlist'' to access the following settings:
            
            
            
            *'''Edit watchlist''': Links to the maintenance pages for the watchlist.
            
            *'''Display options:''' Default settings for showing pages in your watchlist that have recently changed. 
            
            **You can set 3-90 days of page changes.
            
            **You can set 250-1000 watchlist results.
            
            *'''Advanced options:''' Settings for automatically adding pages to the watchlist or hiding page changes from the watchlist.
            
            *'''Watchlist token:''' The token can be used to create a public RSS feed to your watchlist. Anyone who knows this token can access the feed. The syntax for the feed URL is:  <code>https://[YourWikiDomain]/w/api.php?action=feedwatchlist&wlowner=[USERNAME]&wltoken=[TOKEN]</code>
            
            
            
            ==Watchlist quick view==
            
            You can open a quick view of your watchlist from the user profile menu. 
            
            
            
            
            <br />
            
            [[File:Manual:usermenu-watchlist.png|alt=Watchlist link in the user menu|center|180x180px|thumb|Watchlist link in the user menu]]
            
            
            
            
            
            This opens an overlay with a filterable and sortable view of your watchlist directly on the current page. The watchlist indicates what pages on your pages have changes that are unread by you. Clicking on the icon for unread changes leads to the version comparison page so that you can quickly review the changes you haven't seen yet.
            
            
            
            [[File:Manual:Mediawiki Extension WatchList.png|alt=Watchlist overlay|center|thumb|450x450px|Watchlist overlay]]
            
            
            
            ==Classic watchlist==
            
            From this overlay display, you can switch to the classic view of the watchlist. This loads the  page ''Special:Watchlist'':
            
            
            
            At the top of the Watchlist page are some important edit links and information about your watchlist settings:
            
            
            
            *'''View relevant changes:''' This is the default watchlist page. It displays the filter menu with the legend.
            
            *'''View and edit watchlist:''' Here you can delete entries from your watchlist.
            
            *'''Edit raw watchlist:''' Loads an editable list  of the page names on your watchlist.
            
            *'''Clear the watchlist:''' Loads a page that clears your watchlist in the next step. Clicking this link will not clear the watchlist yet.
            
            
            
            
            <br />
            
            [[File:Watchlist3.png|Classic view of the watchlist page|alt=Classic view of the watchlist page|center|650x650px|thumb]]{{Box Note|boxtype=note|Note text=Since many social entities are created automatically by the system, changes to pages in the namespace SocialEntity are filtered out by default. You can remove the filter to view changes to pages in this namespace.}}
            
            
            
            ==Notifications==
            
            You can get notifications about all changes on that page.
            
            
            
            To receive notifications, go to your ''[[Manual:Preferences|Preferences]]'' and open the ''Notifications'' tab. You can select to get notifications about the following changes:
            
            
            
            *'''Actions on pages in watchlist:''' A page was edited or deleted.
            
            *'''Entity actions on watched pages:''' A discussion topic or an attachment was added, edited, or deleted.
            
            
            
            ==Sidebar widget==
            
            
            
            The watchlist is, by default, is included in the[[Manual:Extension/BlueSpiceUserSidebar| user sidebar]]. It can be removed by deletiing the entry <code>*WATCHLIST</code>. 
            
            
            
            ==The watchlist tag==
            
            You can include the watchlist in the page content by adding the tag
            
            
            <code><nowiki><bs:watchlist /></nowiki></code>.
            
            '''Example:'''<syntaxhighlight lang="text">
            
            
            <bs:watchlist count="4" maxtitlelength="20" order="time" />
            
            
            </syntaxhighlight>Output:<br />
            
            
            
            
            <bs:watchlist count="4" maxtitlelength="20" order="time" />
            
            
            
            {{Box Links-en|Topic1=[[Reference:BlueSpiceWatchList]]}}
            
            {{Translation}}
            
            
            
            [[Category:Maintenance]]