Do not hack MediaWiki core

While hacking MediaWiki core is often a solution proposed on other MediaWiki support forums, it is not an ideal solution. Generally, it will cause you more problems than it solves and will only make future upgrades more difficult to install.

For the purposes of this essay, "core" is meant to include all files that belong to the original MediaWiki installation. That is to say all files except the ones in your "extensions" folder, or other folders which you have added since your installation.

Why you should not modify core files
No matter how easy it is to modify core files to make MediaWiki do what you want it to do, resist the temptation.


 * Doing so will make it complicated, difficult or near impossible to apply site updates such as security and bug fixes.
 * You will make it difficult for those that come after to maintain the site.
 * You could possibly leave your site vulnerable to exploits.
 * Other developers are less inclined to help you if you have hacked your core - if for no other reason than it is difficult for them to know what has been done.

The MediaWiki core has been designed to be modular, so there should be no reason to hack it. If there is a feature you want and it cannot be accomplished outside of modifying core, consider submitting your hack as a patch. Submit a bug report and tell the community the feature you want to accomplish. It will then be tested and your feature may become a part of the MediaWiki core.

Problems faced by wikis which hack their core

 * MediaWiki upgrade times go from 30 minutes to 6 hours
 * Increase in spam and other unwanted attacks due to security holes
 * Missing out on new features due to conflicting hacks to core files
 * Inability to use MediaWiki.org documentation - all of which has been written under the assumption that you have not hacked your core files
 * Repetition of the original problem - as a bug report is a for more reliable way to solve a problem than a core hack - if for no other reason than a group of developers will be looking into the problem and may discover necessary code changes you missed
 * Complaining to developers about your core files not working - and not finding much sympathy - if you hack core files - effective technical support is all but impossible

Exceptions
Are there exceptions to this rule?

Nope.

Okay, maybe. But this is generally for specific wikis or implementations by people who are extremely familiar with the MediaWiki code base, development practices and security model. Those who properly document their changes and practice proper revision control with their code. If you have to ask, chances are you shouldn't.

What to do instead
Rather than hacking MediaWiki core, there are several alternative solutions to consider:
 * Submit a bug report
 * Contribute your improvement to core to the code repository so others can benefit from your fix
 * Develop an extension to accomplish what your hack was intended to do