Difference between pages "Help:Blocking users" and "Help:Bots"

From Funtoo
(Difference between pages)
Jump to: navigation, search
 
 
Line 1: Line 1:
 
{{PD Help Page}}
 
{{PD Help Page}}
'''Blocking users''' is an action that [[Help:Sysops and permissions|sysops]] can perform upon users or IP addresses to prevent them from editing the wiki.
 
  
==Blocking==
+
A '''bot''' is a computer program that automatically retrieves or updates wiki pages when it is executed. In general, bots are used for repetitive maintenance tasks, whose volume and characteristics are too large to be performed manually by users.
Blocking users is fairly straightforward, visit [[Special:BlockIP]] and follow these steps:
+
  
# '''IP Address or username''': Enter in the username, IP address, or [[Help:Range blocks|IP range]] to block in the "User" field. If blocking a username, make sure to check the spelling since nonexistent users can be blocked as well. Instead of typing this information in manually, it is also possible to click on a "block" link in recent changes, contributions pages, or history pages, which will automatically fill in this field with the appropriate username or IP address. A "Block this user" link is also present in the toolbox when viewing User and User talk pages.
+
Developing and executing bots is normally outside the role of normal users, requires programming experience and must be done in coordination with the wiki's [[Help:Sysops and permissions|admins]].  
# '''Expiration''': Select when the block should expire from the drop-down, or manually type in an expiration time of the block. When manually typing in a time, follow the [http://www.gnu.org/software/tar/manual/html_node/Date-input-formats.html GNU standard format]. The default options in the drop-down may be modified at [[MediaWiki:Ipboptions]].
+
# '''Reason (optional)''': The reason selected from the drop-down combined with the other/additional reason specified will be used as the message displayed to the blocked user when they try to edit. The default reasons in the drop-down may be modified at [[MediaWiki:Ipbreason-dropdown]].
+
# '''Select additional block options (optional)''': Depending on if a username or IP is being blocked and other options that may have been enabled, some or all of these options will be displayed on the form. Please see [[Manual:Block and unblock#Configuration settings related to blocking]] for information of how to enable or disable some of the following options.
+
#* ''Block anonymous users only'': This option is only available when blocking an IP address. When selected, registered users who try to edit using a blocked IP address will still be able to edit. Otherwise, they will be unable to edit as well.
+
#* ''Prevent account creation'': Selecting this option will prevent the blocked username or IP address from creating new accounts.
+
#* ''Automatically block the last IP address used by this user, and any subsequent IPs they try to edit from'': This option is only available when blocking a username. When selected, the user's IP will become "autoblocked" (these show up as numbers such as #17 on [[Special:IPBlockList|the active block list]]) for a short period of time and any other IP addresses that the blocked user tries to edit from will be blocked as well.
+
#* ''Prevent user from sending e-mail'': This option is only available when blocking a username. When this option is selected, the user will be unable to use the [[Special:EmailUser]] interface.
+
#* ''Hide username from the block log, active block list and user list'': When selected, the blocked username or IP address will not be added to the [[Special:Log/block|block log]], the [[Special:IPBlockList|active block list]], or the [[Special:ListUsers|user list]]. Other users with the ability to view these hidden entries will still be able to see and unblock the username or IP address. This option is not enabled in a default installation of MediaWiki; the person putting the block in place must have the ''hideuser'' permission.  See {{mediawiki|Manual:User_rights|Manual:User rights}}.
+
#* ''Watch this user's user and talk pages'': When selected, this adds the blocked user's user page and user talk page to your watchlist.
+
# Double-check everything you entered and click on '''Block this user'''. A message should appear saying if the block was successful or unsuccessful.
+
  
==Unblocking==
+
By default, bot edits are hidden in [[Special:RecentChanges|{{ns:special}}:{{MediaWiki:Recentchanges}}]].  
To unblock a username or IP address, go to the [[Special:IPBlockList|active block list]] and click on the (unblock) link next to the user or IP you wish to unblock. Then, enter in an optional reason and click on the unblock button. A message should appear saying if the unblock was successful or unsuccessful.
+
  
==What it means to be blocked==
+
== Framework and interface for bot development ==
Blocked users are unable to [[Help:Editing pages|edit pages]], [[Help:Managing files|upload files]], [[Help:Moving a page|move pages]], and perform other actions that additional {{mediawiki|Manual:User_rights|user rights}} would grant. Effectively, this makes the wiki read only for those users. Sysops or others with access to the blocking and unblocking interface may still block and unblock others (including themselves) while blocked.
+
Bots do not access the wiki through the normal graphical user interface. MediaWiki has an API (Application Programming Interface) available for this purpose. An API is a protocol for standardised communication between two computer programs. Check {{mediawiki|API:Client code}} for more information.
  
==See Also==
+
To access a wiki through the API a bot must have a user account, which has been granted 'bot' [[Help:Assigning permissions|permissions]].
*{{mediawiki|Manual:Block and unblock}}
+
  
{{Languages|Help:Blocking users}}
+
=== pywikipediabot ===
[[Category:Help|Blocking users]]
+
{{mediawiki|meta:pywikipediabot}} provides a framework for the development of bots, which are commonly used to perform maintenance tasks such as adding a footer to some categorized pages ({{mediawiki|meta:pywikipediabot/add_text.py|add_text.py}}), adding some [[Help:Links|wikilinks]] ({{mediawiki|meta:pywikipediabot/replace.py|replace.py}}), moving old contents of [[Help:Talk pages|talk pages]] to [[Help:Subpages|subpages]] ({{mediawiki|meta:pywikipediabot/archivebot.py|archivebot.py}}), editing [[Help:Categories|categories]] ({{mediawiki|meta:pywikipediabot/category.py|category.py}}), or managing [[Help:Templates|templates]] ({{mediawiki|meta:pywikipediabot/template.py|template.py}}).
 +
 
 +
== The MassEditRegex extension ==
 +
[[:mw:Extension:MassEditRegex|Extension:MassEditRegex]] provides an alternative way to perform mass edits using regular expressions, through a special page in the wiki. Only admins can normally use this extension.
 +
 
 +
== See also ==
 +
* {{mediawiki|meta:Bot}}
 +
 
 +
{{Languages}}
 +
 
 +
[[Category:Help|{{PAGENAME}}]]
 
[[Category:Wiki Development]]
 
[[Category:Wiki Development]]

Revision as of 17:29, 11 January 2014

PD Important note: When you edit this page, you agree to release your contribution into the public domain. If you don't want this or can't do this because of license restrictions, please don't edit. This page is one of the Public Domain Help Pages, which can be freely copied into fresh wiki installations and/or distributed with MediaWiki software; see Help:Contents for an overview of all pages. See Project:PD help/Copying for instructions. PD


A bot is a computer program that automatically retrieves or updates wiki pages when it is executed. In general, bots are used for repetitive maintenance tasks, whose volume and characteristics are too large to be performed manually by users.

Developing and executing bots is normally outside the role of normal users, requires programming experience and must be done in coordination with the wiki's admins.

By default, bot edits are hidden in Special:Recent changes.

Contents

Framework and interface for bot development

Bots do not access the wiki through the normal graphical user interface. MediaWiki has an API (Application Programming Interface) available for this purpose. An API is a protocol for standardised communication between two computer programs. Check API:Client code for more information.

To access a wiki through the API a bot must have a user account, which has been granted 'bot' permissions.

pywikipediabot

meta:pywikipediabot provides a framework for the development of bots, which are commonly used to perform maintenance tasks such as adding a footer to some categorized pages (add_text.py), adding some wikilinks (replace.py), moving old contents of talk pages to subpages (archivebot.py), editing categories (category.py), or managing templates (template.py).

The MassEditRegex extension

Extension:MassEditRegex provides an alternative way to perform mass edits using regular expressions, through a special page in the wiki. Only admins can normally use this extension.

See also

Language: English