Do not hack MediaWiki core/cs

Zatímco hackování jádra MediaWiki je často řešením navrhovaným na jiných fórech podpory MediaWiki, není to ideálním řešením. Obecně vám způsobí více problémů, než vyřeší a pouze ztíží instalaci budoucích upgradů.

Pro účely tohoto článku "jádro" (core) zahrnuje všechny soubory, které patří k původní instalaci MediaWiki. To znamená všechny soubory kromě LocalSettings.php, docker-compose.override.yml, souborů ve vaší složce "extensions" nebo "skins" nebo jiných složkách, které jste přidali od instalace.



Proč byste neměli upravovat základní soubory
Odolejte pokušení, bez ohledu na to, jak snadné je upravit základní soubory, aby MediaWiki dělala to, co chcete.


 * Pokud tak učiníte, bude komplikované, obtížné nebo téměř nemožné aplikovat aktualizace stránek, jako je zabezpečení a opravy chyb.
 * Těm, kteří přijdou poté, ztížíte údržbu webu.
 * Svůj web můžete učinit zranitelný vůči zneužití.
 * Ostatní vývojáři jsou méně nakloněni vám pomoci, pokud jste hackli své jádro – pokud z jiného důvodu, je pro ně obtížné zjistit, co se stalo.

Jádro MediaWiki bylo navrženo jako modulární, takže by neměl být důvod ho hackovat. Pokud existuje funkce, kterou chcete, a nelze ji provést mimo úpravu jádra, zvažte vývoj rozšíření nebo odeslání vašeho hacku jako opravy. Odešlete hlášení o chybě a sdělte komunitě funkci, kterou chcete dosáhnout. Poté bude testována a vaše funkce se může stát součástí jádra MediaWiki.



Problémy, kterým čelí wikiny, které mají hacknuté jádro

 * Časy aktualizace MediaWiki se pohybují od 30 minut do 6 hodin nebo dokonce 6 týdnů, pokud váš  ukazuje, že bylo změněno 13650 řádků.
 * Zvýšení spamu a dalších nežádoucích útoků kvůli bezpečnostním dírám.
 * Chybí vám nové funkce kvůli konfliktním hackům do základních souborů.
 * Nemožnost používat dokumentaci MediaWiki.org – vše bylo napsáno za předpokladu, že jste nenapadli své základní soubory (pokud samozřejmě nenapíšete dokumentaci specificky pro to, jak provozovat MediaWiki, když je tento konkrétní hack používán).
 * Opakování původního problému – protože hlášení o chybě je mnohem spolehlivější způsob, jak vyřešit problém než základní hack – pokud z jiného důvodu nebude problém zkoumat skupina vývojářů a může objevit potřebné změny kódu, které jste přehlédli.
 * Stěžovat si vývojářům na to, že vaše základní soubory nefungují – a nenacházet mnoho sympatií – pokud hacknete základní soubory – účinná technická podpora je téměř nemožná.

Výjimky
Existují výjimky z tohoto pravidla?

Ani náhodou.

Dobře, velmi zřídka. Ale to je obecně pro konkrétní wikiny nebo implementace lidmi, kteří jsou extrémně obeznámeni s kódovou základnou MediaWiki, vývojovými postupy a bezpečnostním modelem. Ti, kteří řádně dokumentují své změny a praktikují správnou kontrolu revizí pomocí svého kódu. Pokud se musíte ptát, je pravděpodobné, že byste neměli.

Rozšíření
Všimněte si, že většina této stránky se vztahuje také na důležitá rozšíření. Je špatný nápad přímo začít hackovat rozšíření Semantic MediaWiki nebo kterékoli z rozšíření používané na Wikipedii a dalších webech Wikimedie.

Výjimkou může být situace, kdy se rozšíření instaluje hlavně zkopírováním jeho kódu z této wiki (místo jeho získání z softwarového úložiště). To znamená, že není příliš vážně udržován.



Co dělat místo toho
Rather than hacking MediaWiki core, there are several alternative solutions to consider, more or less in this order:


 * 1) MediaWiki is a powerful beast out of the box, you can do a lot with MediaWiki's interface messages such as   and many many others, see also other pages on this wiki for e.g. JavaScript and CSS additions and changes.
 * 1) Develop an extension to accomplish what your hack was intended to do, or simply use one of the existing hooks
 * 1) Submit a bug report
 * 1) Contribute your improvement to core to the code repository so others can benefit from your fix