Frequently asked questions (FAQ) about MediaWiki usage. If your question is neither answered here nor in thetechnical MediaWiki documentation or theMediaWiki user documentation, then please ask in asupport venue. | ![]() |
Please seeDifferences between Wikipedia, Wikimedia, MediaWiki, and wiki for a detailed answer.
MediaWiki is free software: this means that you may use it for any purpose without legal hindrance. Furthermore, its licensing conditions apply solely to the software itself.This means that although many wikis license their content under a permissive license, you are not obliged to license the content submitted to your wiki in any particular way. Of course, as a project founded to support sites like Wikipedia, we encourage you to license the texts you write under a free license, but, in short, you are not required to.
If you wish to alter or amend the software itself, in general, you are permitted to, but there are some restrictions and you should consultthe full text of the GNU GPL version 2 for details. Because MediaWiki is provided free of charge, there is no warranty, to the extent permitted by applicable law.
Creating a wiki implies installing MediaWiki on a server and having access to manage it.There are different options, depending on your level of expertise:
This site (MediaWiki.org) or the Wikimedia Foundation does not allow individuals to create wikis.
Download the latest stable release of MediaWiki. Files are supplied in a.tar.gz archive. MediaWiki can also beobtained directly from our Git repository.
Installing MediaWiki takes around 10 to 30 minutes, and involves uploading/copying files, and running the installer script to configure the software. SeeManual:Installation guide, where you will also find theminimum system requirements.
Many Linux distributions provide MediaWiki in a packaged format for that distribution. The MediaWiki development team refers you to your Linux distribution for assistance with installing, configuring or using them. The individual communities and companies who maintain such packages should provide installation instructions.
Be warned that third-party distributions may be older versions, so pay close attention to compatibility information for directions and extensions.
It is possible to install more than one wiki on a server provided that:
Or
Or
LocalSettings.php
file for both, you must ensure $wgServer is dynamically set to the correct value.For information on the latter two options, see$wgDBname and$wgDBprefix respectively.
For more information on setting up a wiki family (wikifarm), seeManual:Wiki family.
The main (but not necessarily the easiest) method is to import.SeeWiki importing, below.
(Non-MediaWiki methods, such as Xowa and Kiwix can be found atw:Wikipedia:Database download).
Shell access (SSH) is not required for installing MediaWiki, but it ishighly recommended. Without shell access, it may even be difficult for you to get a backup of your wiki, or to upgrade to a new version. Some maintenance tasks are not possible at all without shell access. Many major extensions work best with shell access.
SeeManual:Extensions for information about installing and writing extensions. SeeCategory:Extensions to find existing extensions.
SeeCreating a custom namespace.
File uploads are an often-used feature of MediaWiki, but are disabled by default in all current release versions. To enable them, first make the upload directory (defaultimages
) writable by the web server (chmod -R 777 ./images
or allow the Apache user to write to it, etc.) then set$wgEnableUploads totrue
inLocalSettings.php
. If you get a "failed to mkdir" error when you try to upload, it probably means that there's a permissions problem.
MediaWiki requires that allowed file upload formats are specified using the$wgFileExtensions configuration directive. Usually this directive is situated inLocalSettings.php
in the root of your MediaWiki installation.
For example, to extend uploading to PDF files, add the following toLocalSettings.php
:
$wgFileExtensions[]='pdf';
To extend uploading to more than one type of file, use the following syntax
$wgFileExtensions=array_merge($wgFileExtensions,['pdf','txt','mp3']);
MediaWiki allows embedded math formulas. SeeExtension:Math for complete setup instructions.
To purge a cached page, such as when making changes to the navigation bar, add&action=purge
to the end of the page's dynamic URL.
E.g.https://www.mediawiki.org/w/index.php?title=Main_Page&action=purge
Or?action=purge
to the end of the page's short form URL:
E.g.https://www.mediawiki.org/wiki/Main_Page?action=purge
Add in yourLocalSettings.php
file the following lines:
$wgParserCacheType = CACHE_NONE;$wgCachePages =false;
Some users have reported that after adding a file format to the allowed extensions list, an error is encountered. The text of the error is similar to the following:
As a possible solution, set the value of$wgMimeDetectorCommand. Under Unix or Linux, this would be
$wgMimeDetectorCommand="file --brief --mime";
Sometimes, the installer fails to create the default user, or theuser
table is lost for some reason. There are a couple of options for solving this:
maintenance/createAndPromote.php --username <new user name> --password <password for that user>
from the shell. Append--bureaucrat
to command line if you want that user to become a bureaucrat, in addition to becoming an administrator.This will create a new user and promote them to an administrator. For help, run the script with the parameter--help
.
INSERT INTO user_groups ( ug_user, ug_group ) VALUES (<id>, 'bureaucrat' ), (<id>, 'sysop' );
<id>
above should be replaced with the appropriate user ID which you can see on the user's preference page.LocalSettings.php
, prepend its value to the table name. For example, if$wgDBprefix
is "XYZ", then the table name to use isXYZuser_groups
![]() | You should not let outsiders access your wiki while you do this, if you use this method. This method may leave your wiki temporarily vulnerable to attack while you do the procedure. |
This method essentially involves letting all users temporarily modify user permissions in order to promote one user
LocalSettings.php
$wgGroupPermissions['user']['userrights'] = true;
$wgGroupPermissions['user']['userrights']=true;
line from your LocalSettings.php. This step isvery important, as until you remove it anyone can alter permissions, which is bad.(i.e. /wiki/Article_Name as opposed to /w/index.php?title=Article_Name)
Yes, it is free in the sense ofFree software. SeeProject:Copyrights for licensing issues regarding the written content of this site.
SeeManual:User rights for general information. SeeManual:Preventing access for methods and strategies for restricting access.
The recommended method is by changing the value of the$wgGroupPermissions
configuration option. EditLocalSettings.php
and add the line:
$wgGroupPermissions['*']['edit']=false;
If you useExtension:AbuseFilter, any admin can also disable IP editing temporarily as needed.
LocalSettings.php
:$wgGroupPermissions['*']['read']=false;
See alsoManual:$wgWhitelistRead. SeeManual:Preventing access#Restrict viewing of all pages for more information.
LocalSettings.php
:$wgGroupPermissions['*']['createaccount']=false;
SeeManual:Preventing access#Restrict account creation for more information.
MediaWiki version: | ≥ 1.5 |
MediaWiki version: | ≥ 1.4 |
The MediaWiki default user preferences are inMainConfigSchema.php Don't edit that file, just use it for reference.
Say if you want to hide minor edits in recent changes by default. MainConfigSchema.php says:
publicconstDefaultUserOptions=[...'hideminor'=>0,...]
To change the preference, put this in yourLocalSettings.php
:
$wgDefaultUserOptions["hideminor"]=1;
To change the default namespaces to be searched, in any version of MediaWiki, set$wgNamespacesToBeSearchedDefault in LocalSettings.php to an array mapping namespace indexes to boolean values. For example, to search the main namespace and the category namespace, use:
$wgNamespacesToBeSearchedDefault=[NS_MAIN=>true,NS_CATEGORY=>true,];
In some cases, after you change a default user preference, you may also want to change the user preferences of all existing user accounts.
If so, use theuserOptions.php script in themaintenance
directory. Use the--dry option for the first run, assess the impact and go from there. (--dry does not write the database.)
php userOptions.php --dry --nowarn hideminor --old 0 --new 1
Also, always backup your database before making these kinds of changes (you do not need to if you are just using--dry).
Yes. It should be. In essence, you will be backing up your old installation and then "restoring" it onto the new machine. Finally, you will have to make additional modifications to update the wiki configuration so that everything points to the new location.
Follow the instructions atManual:Moving a wiki.
![]() | Do not simply overwrite the default logo installed within MediaWiki (/resources/assets/wiki.png ); this file will be overwritten when you upgrade the software. |
The logo that appears in the top left of each page is determined by the$wgLogos configuration line in theLocalSettings.php file.MediaWiki installations prior toMediaWiki 1.35.0, used$wgLogo.
There are two ways to change the logo:
"{$wgUploadPath}/6/62/mylogo.png";
"{$wgScriptPath}/mylogo.jpg";
LocalSettings.php
file.)Then, modify the$wgLogos
array in LocalSettings.php.It should look something like:
$wgLogos=['1x'=>"$wgResourceBasePath/resources/assets/change-your-logo.svg"'icon'=>"$wgResourceBasePath/resources/assets/change-your-logo-icon.svg"];
Replace the paths above with the appropriate new logo path.
If you only want to change the logo on specific pages, override #p-logo CSS's background-image property or use a third-party extension likeExtension:LogoFunctions.
You shouldn't edit the CSS files (such as common.css) directly, because it will make upgrading harder if you need to apply your customizations each time you upgrade the software. Instead you need to edit a wiki page calledMediaWiki:Common.css if you want to apply your CSS changes for all skins, or a wiki page calledMediaWiki:Vector.css if you want to apply the customizations only for the Vector skin.
The content of the MediaWiki:Common.css and MediaWiki:Vector.css pages always overrides the default CSS styles specified in the skin files.
In other words, how do you make the main content div take up 100% of the display, hiding the logo, toolbox, navigation and search engine?
To hide it permanently, copy and paste the following into theMediaWiki:Common.css page:
#column-content{margin:00.6em0;}#content{margin:2.8em000;}#p-logo,.generated-sidebar,#p-lang,#p-tb,#p-search{display:none;}#p-cactions{left:.1em;}
To instead hide the toolbar when the user presses F11, enter this in your wiki'sMediaWiki:Common.js:
document.onkeydown=function(e){if(e==null)e=eventif(testKey(e,122)){//F11appendCSS('#column-content {margin: 0 0 .6em 0;} #content {margin: 2.8em 0 0 0;} #p-logo, .generated-sidebar, #p-lang, #p-tb, #p-search {display:none;} #p-cactions {left: .1em;} #footer {display:none;}');returnfalse;}}functiontestKey(e,intKeyCode){if(window.createPopup)returne.keyCode==intKeyCodeelsereturne.which==intKeyCode}
You can hide display of the categories on each page by modifying yourMediaWiki:Common.css and adding:
.catlinks{display:none;}
By default, clicking the site-logo takes you to the main site-page. If you want to change which internal site-page is the "main" site-page, editMediaWiki:Mainpage.
To make the link of the site-logo link externally to any other arbitrary URL, you can use jQuery code within MediaWiki:Common.js:
$("a.mw-wiki-logo").attr("href","http://www.example.com");$("a.mw-wiki-logo").attr("title","Go to example.com website");
$wgFavicon="$wgScriptPath/path/to/your/favicon.ico";
SeeManual:$wgFavicon for more details.
Tip: The favicon image should be either 16 x 16 pixels or 32 x 32 pixels.
If you are using a rewrite rule in .htaccess to remove "index.php" from the URL, you will also need to add an exception for .ico files. Simply add the following rule to your .htaccess:
RewriteRule.*\.ico$-[L]
This rule must appearbefore the index.php rule.
When uploading the favicon file, be sure the filename is in lowercase. (That is, "favicon.ico", not "Favicon.ico".) A lot of servers (e.g., those on UNIX-like operating systems) will not be able to find the file unless its name is in lowercase.
The contents of the navigation bar which appears to the left of each page using the Vector or the Monobook skin are determined by theMediaWiki:Sidebar page there on your wiki. For information on customising these, please seeManual:Interface/Sidebar.
Put a text in theMediaWiki:Sitenotice page. It will be displayed on top of every article page.
You can also add text toMediaWiki:Anonnotice to create a message that only displays for logged-out users. It is often a good idea to transclude the site notice on the anon notice to make sure that logged-out users still get the information on the site notice.
By default, MediaWiki looks for a page with the titleMain Page and serves this as the default page. This can be changed by altering the contents ofMediaWiki:Mainpage to point to a different title.If this does not change the 'Main Page' link included on the sidebar at install time, editMediaWiki:Sidebar.
Simply click on the "Move" tab, and move the page to the desired page title.
Usually you also want tochange which page is the configured as "main page".
The displayed title of the main page can be changed using the MediaWiki messagesMediaWiki:mainpage-title andMediaWiki:mainpage-title-loggedin (for logged-out and logged-in users respectively). The main page title can be hidden by setting both messages to empty (or only either of them if the title should still be displayed to logged-out or logged-in users).
The table of contents (TOC) is automatically shown once there are four or more headings in the article. There are multiple ways to hide it.
__NOTOC__
in the page's wikitext..toc,#toc{display:none;}
Interface text is altered using the MediaWiki namespace. For each deviation from the default in the site language there is a page MediaWiki:Englishmessagename, and for each deviation from the default in each other language a page MediaWiki:Englishmessagename/languagecode. (Since release 1.9 there are no pages for messages equal to the default.). On creation of a page the edit box autofills with the default. When creating a page to override the default it is useful to first save the default version, to allow diffs with it. See alsoHelp:System message.
-
).Special:Allmessages contains a complete list of messages (error or otherwise), that can be edited.
You may also add ?uselang=qqx or &uselang=qqx to a URL which will display the name of each messages in the interface.
To change the default interface language, alter the value of$wgLanguageCode
inLocalSettings.php
, for example:
$wgLanguageCode="fr";
You may also need tobypass your browser's cache to see the changes.
The new default interface language will be applied to all users who haven't ever customised it.
If you want to provide users the possibility to create and choose pages and interface elements in languages other than the default one of the wiki, you need theTranslate extension, which can make your wiki multilingual.
If you want to change the language settings for all existing users, use theuserOptions.phpmaintenance script. For instance, to have all users with English set use French instead, run:
phpuserOptions.phplanguage--olden--newfr
For a little more control see:User:Subfader/Hide_page_tabs
EditMediaWiki:Common.css on your wiki, and add this:
li#ca-edit{display:none;}
See the page source for the various #ca-* ids used in the content tabs.
SeeManual:User group CSS and JavaScript
MediaWiki version: | ≥ 1.9 |
For example, to remove the Discussion (talk) page tab from the Main Page, on theMediaWiki:Common.css page add:
body.page-Main_Pageli#ca-talk{display:none!important;}
To modifyMediaWiki:Common.css you must be anInterface administrator.
MediaWiki version: | ≥ 1.9 |
For example, to remove the Discussion (talk) page tab on all wikipages, on theMediaWiki:Common.css page add:
#ca-talk{display:none!important;}
Other tabs to remove are#ca-history,#ca-viewsource,#ca-view (Read tab),#ca-nstab-main (Page tab).
Other drop down menu items you can remove are#ca-watch,#ca-move,#ca-delete.
To modifyMediaWiki:Common.css you must be anInterface administrator.
One option is to hide the link using the following CSS in the wiki pageMediaWiki:Common.css in your wiki:
#p-personal#pt-anonuserpage{display:none;}
To remove the login / create account links from the personal_urls you can use this code in yourLocalSettings.php to hook in and remove them:
$wgHooks['SkinTemplateNavigation::Universal'][]=function($skinTemplate,&$links){unset($links['user-menu']['login']);unset($links['user-menu']['login-private']);unset($links['user-menu']['createaccount']);};
To disable a specific special page (such as Special:SpecialPages), you may use:
$wgSpecialPages['Name']=DisabledSpecialPage::getCallback('Name','message');
whereName
is the canonical (English) name of the special page to disable, andmessage
is the message to be shown to users when they try to access the special page.
To disable an action (such as edit), you may use:
$wgActions['edit']=false;
SeeAPI:Restricting API usage to disable an API module.
This is only the basic usages. Usually you may want to disable special pages, actions or API modules conditionally.
You can hide the Powered by MediaWiki image by adding the following to your wiki'sMediaWiki:Common.css:
#footer-poweredbyico{display:none;}
If you want to remove it completely, you can use$wgFooterIcons
to remove it using this in yourLocalSettings.php:
unset($wgFooterIcons['poweredby']);
Note that this will also removeother powered-by icons, e.g. also the one coming from BlueSpice.
If you wish to change the icon images, urls, alt text, or add new icons please see$wgFooterIcons
' documentation.
InstallDiscussionTools to enable automatic reply links on talk pages.
<title>
of each page is? Where do I make changes?Most of the text that you want to change can be found in the namespace of MediaWiki.
In order to change titles, texts, announcements, etc., go toSpecial:AllMessages, where you will see the text associated with the pages you wish to change. You need to log in as an administrator to edit the protected entries in the MediaWiki namespace.
If you want to change the title in your browser, you need to editMediaWiki:Pagetitle. Go there and edit it just like you would any other page in your wiki.
In recent versions of MediaWiki,MediaWiki:Pagetitle is $1 - {{SITENAME}} by default. If {{SITENAME}} is producing the wrong text for you, you need to set$wgSitename in your LocalSettings.php.
Don't forget to clear your browser cache after you change your settings.
Yes. This can be changed using the$wgCapitalLinks configuration setting.
Put "<nowiki></nowiki>
" tags around the URL or tag.
Example:
svn co <nowiki>http://svn.example.com/myproject/</nowiki>
Produces:
svn co http://svn.example.com/myproject/
For adding more selectable special characters, etc., below the edit field, seeExtension:CharInsert.
SeeManual:$wgDefaultSkin for more information on configuring your default skin.
Edit the pageMediaWiki:Print.css on your wiki and add the following code there:
#contenta.external.text:after,#contenta.external.autonumber:after{content:none;}
This will override the styles defined in the CSS files coming with the MediaWiki source code. For more information, seeManual:CSS.
If instead you want to have the external linksunderlined in the printable version, then also add the following code:
#contenta.external{text-decoration:underline!important;}
Try this StackOverflow solution:Printed HTML per-page footnotes
To change the text of the tab, as one example used in Wikipedia, you first open the page "MediaWiki:Mainpage-nstab
".
After you've done that, click Edit and type in the edit box the text you want to be seen later on the main page - that's it. Don't forget to save the page as well.
To change the background color of the MediaWiki interface outside of the page content and tabs, add the following CSS to the MediaWiki page[[MediaWiki:Common.css]]
:
/* Changes the background color of the bottom and left of each page, up to behind half of the logo: */body{background:red;}/* Changes the background color behind the top half of the logo and at top of each page: */#mw-page-base{background:red;}
This will change the background color outside of the tabs, search, and page content tored.SeeManual:CSS for more information.
This example refers to Google Fonts, a repository of free open-source fonts that you can use with MediaWiki.Go tohttps://fonts.google.com/, find fonts that you like, and select them by clicking the "plus" (+) icon.Select one or more fonts to be added.Click the tab for the pop-up notification, and then select "@IMPORT". Copy and paste the resulting CSS into[[MediaWiki:Common.css]]
. The examples below useNoto Sans and Noto Serif. They are default fonts for Android operating system and have good support forUnicode text.
@importurl('https://fonts.googleapis.com/css?family=Noto+Sans|Noto+Serif');/* Changes the default font used for MediaWiki to Noto Sans (does not include headings or monospaced text): */body{font-family:"Noto Sans",sans-serif;}/* Changes the default font used for MediaWiki headings to Noto Serif: */#contenth1,#contenth2{font-family:"Noto Serif",serif;}
Edit the wiki pageMediaWiki:Common.css
on your wiki to include the line.postedit {display: none;}
.SeeManual:Interface/Stylesheets for more information.
To edit a page, simply click theedit link that appears on each page. Using the default Vector skin, this is in the form of a tab at the top of the page. A form will appear, containing the existing markup. When you have finished making modifications, click theSave button to commit your changes.
There are several ways to create a new page:
http://www.example.com/index.php?title=New_page
and click on the "Edit", "Create" or "Create source" link.On some wikis, a failed search for a page will contain a link which allows you to edit that page.
Old versions of page data are retained in the database and can be accessed via the page history features. This is useful for reviewing changes and correcting or reverting undesirable ones, but in some cases, administrators might want to make this information unavailable, for legal reasons, or to reduce the size of the database.
maintenance/deleteOldRevisions.php
maintenance script can mass-delete all old revisions of pages and their associated text records.You can also delete a page, and then restore only the revisions you want.
There are several editing tutorials available, mostly on Wikimedia sister projects, such as Wikipedia. There are also markup references, etc. available onMeta.
MediaWiki includes stylesheets which automatically style a page appropriately when it is printed; using the print or print preview function within your browser ought to render the page in a printable form.
You can also view this printable form using theprintable version link in the sidebar underToolbox orPrint/export if using theCollection extension.
Yes, this is encouraged through the use ofManual:$wgUseInstantCommons.
When you look at your preferences, you see a check box for "raw signature." But the field will only take a certain number of characters. What if you want more?
You will need to create two pages, possibly in your userspace.
If you don't have this structure, you will still be inserting all your signature code into the raw code wherever your signature is used, because the software will insert "SUBST" in your preferences. You may not mind this, in which case you only need one page. If you want the raw code to only display {{FIRST PAGE}}, which looks a lot cleaner, then you need to use the two-page structure.
In wiki terms, asandbox is simply a "play pen"; a page which users can mess about in. This is an ordinary page created in the normal manner, and can be located wherever you like. There is no special sandbox functionality built into MediaWiki.
Users often inquire about the Wikipedia sandboxes, which seem to be self-emptying. This is not quite correct; there are a number of volunteers who runbots to clean these up and return them to a certain state at regular time intervals.
See alsoExtension:SandboxLink which will add a link to user's personal sandbox (i.e. a subpage of personal user page) to personal tools menu.
There are a variety of tools available to help convert content from HTML (and other formats) to MediaWiki markup.
You probably need to install some extensions used on the source wiki, such asScribunto,TemplateStyles,ParserFunctions or sometimesCite. Also, make sure that you copied allsite CSS andJavaScript required by the template.
user
table of the "main" wiki. You can share other tables as well, as long as they don't contain any data dependent on non-shared tables or data specific to one wiki. SeeManual:Shared database for examples and more information.user
table, but it's more difficult to configure and it's tailored toward a Wikimedia-style setup. However, it is easier than attempting to completely merge multipleuser
tables into one.See$wgRawHtml
as well as$wgGroupPermissions
andManual:Preventing access.
![]() | Some HTML tags can be unsafe and may be misused to harm users or create security vulnerabilities. Only allow them if you are certain they are safe. |
SeeHTML restriction for ways to make this safer.
The basic steps to improving MediaWiki (that is,becoming a MediaWiki developer) are:
You might want to use thePywikibot framework.
Set$wgNoFollowLinks =false;
inLocalSettings.php
The OutputPage class includes an addMeta method which can be used to add meta tags. TheRequestContext can be used to get the relevant OutputPage object.
$out->addMeta('description','This is a meta description.');
The Help namespace currently ships in a blank state. It's up to you how much or how little help you give to your site visitors and whether this relates to other aspects of your site. Obviously you can easily link your visitors to help resources elsewhere.
We don't currently have a clean, internationalised set of help pages under a free license. However, if you want to copy in some help information onto your site, about how to use a wiki (a MediaWiki powered wiki) you are free to copy theHelp:Contents from this wiki. This set of pages have been deliberately created for this purpose, with wiki-neutral information, and no license restrictions. SeeProject:PD help.
Several users have reported that, following an upgrade or a moving of their wiki, several images fail to be shown inline. The files exist, and the image description pages show a MIME type ofunknowncode>/unknown
and, in some cases, a warning about potentially dangerous files.
To fix this, run themaintenance/rebuildImages.php
script from the command line. This will set MIME information for each file in the database.
MediaWiki 1.21 and newer implementsresponsive images.Due toa bug, if the server locale is set to one that uses commas instead of dots for representing a decimal point, images may not render on some browsers/devices.This can be confirmed by inspecting a thumbnail of a medium or big image on a page with the browser tools, looking at the HTML code, and see if thesrcset
attribute contains commas instead of dots when representing the1.5x
value.
After upgrading to a more recent version of PHP, it is possible a different MimeMagic.php function is being used to detect file MIME types, particularly the built-in PHP function mime_content_type, which fails to detect PNG files. Search the web formime_content_type png for information on fixing this bug at the PHP level, possibly by editing your magic.mime file.
SeeFile is corrupt or has an invalid extension for more info.
MediaWiki 1.45 is in a development state at present, and has not been packaged into a general release. The code can bedownloaded from Git if desired. Or, if you want the latest development version packaged as an archive, get it atmediawiki-master.tar.gz (GitHub).
Wikipedia and other Wikimedia web sites use the current version of the code in development; at present, this is MediaWiki 1.45.0-wmf.10 (06dce30), pulled from the current development branch. Coupled with the use of several extensions, this means that functionality between these wikis and your particular setup may differ.
Fedora enablesSELinux by default. Instructions for setting SELinux permissions for MediaWikiare available.
Many hosting providers only handle zip archives, and we only provide gz compressed tar archives, thus the archives has to be recompressed before uploading.This should not be a hurdle, but it seems like some archive tools occasionally fail to include all files in large archives.When this happen the vendor folder is left out, leaving the user with the rather non-explanatory error message.
Use a command line tool when recompressing the tar archive into a zip archive.
This is probably related to cookies or session data. SeeLog in problems for information.
If this is happening constantly to all users, it probably means that caching is misconfigured. Setting$wgSessionCacheType = CACHE_DB;
can be used to determine if caching is the cause of the problem. If that solves the problem, you should still investigate what is wrong with your caching configuration.
![]() | Parts of this page (those related to Manual edits to rev_user fields in the database; MediaWiki uses theactor table now) areoutdated.It was written for an older version of MediaWiki and may not apply to the most recent version. If you have checked or updated this page and found the content to be suitable, please remove this notice. See thetalk page for a possible discussion on this. |
At many times you just want to remove a user account out of the wiki either because it belonged to a spammer account or you just feel like it. The appropriate choice is to block the account or rename it if needed. Here is why:
Do I just remove this row from theuser table?
Rob Church posted the following regarding this issue on the wikitech-l mailing list:
If the user has made edits, then removing rows from theuser
table cause theoretical loss of referential integrity.Now, to be honest with you, I can't think of any conditions where this would cause an actual problem; "undefined behaviour" is the phrase we use.
What I'd suggest doing, to be on the safe side, is running a couple of quick updates against the database:
UPDATErevisionSETrev_user=0WHERErev_user=<current_user_id> UPDATEarchiveSETar_user=0WHEREar_user=<current_user_id>What this will do is cause MediaWiki to treat the revisions as having been made anonymously when generating things like page histories, which should eliminate any problems caused by these routines attempting to check user details from other tables.
If the user has caused log entries, i.e. rows in the
If the username is offensive or undesirable, then you could consider renaming it using theRenameUser extension.logging
table, or uploaded images, then the situation becomes trickier, as you'll have to start mopping up all the rows everywhere and it could become a bit of a mess, so if the user's done anything other than edit, I would strongly recommend just blocking them indefinitely.
Another option is to give Admins the'hideuser' right, and indefinitely block the user with theHide username from edits and lists option selected.
Extension:UserMerge is also useful.
By default,$wgArticleCountMethod is set tolink
.This means the number of "Content pages" on theSpecial:Statistics page only counts pages which include at least one internal link.This can be changed by setting$wgArticleCountMethod
toany
.Afterwards, runupdateArticleCount.php and/orinitSiteStats.php.(On Wikimedia websites,initSiteStats.php
is run on the 1st and 15th of each month.)There might still be wrong behavior, see for examplephab:T212706.
$wgSpamRegex is a powerful filter for page content.Adding multiple items to the regex, however, can be awkward. Consider this snippet:
$wgSpamRegexLines[]='display\s*:\s*none';$wgSpamRegexLines[]='overflow\s*:\s*auto';[...]$wgSpamRegex='/('.implode('|',$wgSpamRegexLines).')/i';
This example code allows convenient addition of additional items to the regex without fiddling about each time. It also demonstrates two popular filters, which block some of the most common spam attacks.
SeeManual:Combating spam for an overview of anti-spam measures such as Captcha, content filtering and restricting edition.
SeeManual:Combating vandalism for hints and suggestions on how to deal with wiki vandalism.
Bugs and feature requests should be posted onPhabricator. SeeHow to report a bug.
Nine times out of ten this is because you didn'tclear your cache. The simple test for this is to request a page that hasn't been requested before. Select the part of the URL in the address bar that contains the page title (e.g. Main_Page). Twiddle your fingers on the keyboard for a while, hit enter. Check if the problem is on that page too.
MediaWiki uses both a server-side cache and a client-side cache, so clearing your browser cache is often not enough. See therelevant entry above for more details.
Here are some other things to check:
<?php phpinfo() ?>
. Upload it into your web directory and invoke it with your browser. Check the document root and the path to php.ini.LocalSettings.php
, not to the beginning.If you've exhausted the FAQ above, please try the following:
See the support venues listed onCommunication.