Developer hub/fa



This is a high-level overview of MediaWiki development, including links to the key documents, resources and tools available to MediaWiki developers. It is written for skilled LAMP developers who have experience using MediaWiki.


 * If you want to use Wikimedia web APIs, visit Web APIs hub (work in progress).
 * برای آشنایی مقدماتی با توسعهٔ مدیاویکی، روش هکر مدیاویکی شدن را بخوانید.
 * برای کمک به نصب یا سفارشی‌سازی مدیاویکی، را ببینید.
 * برای کمک به استفاده از مدیاویکی را ببینید.

دید کلی
MediaWiki is developed in an open source style using the PHP programming language primarily for the LAMP platform. بخش بزرگی از توسعهٔ هسته با مشارکت آنلاین انجام می‌شود.


 * بحث دربارهٔ توسعه در چند میلینگ لیست و کانال آی‌آرسی انجام می‌شود. The main developer list is wikitech-l. The main developer IRC channels are #mediawiki and #wikimedia-dev. برای شناخت افرادی که در میلینگ‌لیست‌ها و کانال‌های آی‌آرسی حضور دارند، مقالهٔ توسعه‌دهندگان را بخوانید.
 * Source code is managed using the Git revision control system. برای دید کلی دربارهٔ نحوهٔ استفادهٔ توسعه‌دهندگان از گیت، مقالهٔ گیت را بخوانید. Read the wikitech:Help:Access article if you'd like access.


 * Code review is performed on, see this tutorial to get set up with git and gerrit in order to submit patches.
 * Developers extending or interfacing with MediaWiki (instead of working on the core code) have several convenient extension points, including the API, the Hooks system and Skins – see the #Extending MediaWiki section of this page for an overview.

اسناد کلیدی


کد، توسعه و سبک

 * Development policy یک نمای کلی از سیاست های کلیدی توسعه
 * قراردادهای کدنویسی – آموزش نحوهٔ نوشتن کد به سبک مدیاویکی.
 * امنیت برای توسعه‌دهندگان – آموزش نحوهٔ امن نگه‌داشتن مدیاویکی
 * Pre-commit checklist – read this checklist before committing code.
 * Code review guide – a guide for reviewers of commits to the MediaWiki source code.
 * Requests for Comment (RfC) – read about or suggest new features for the MediaWiki ecosystem

اشکال زدایی و تست

 *  – an overview of bug tracking in the MediaWiki project.
 * نحوهٔ اشکال‌زدایی – راهنمای اشکال‌زدایی مدیاویکی.
 * Manual:Errors and symptoms – an overview of common MediaWiki errors and their correlating symptoms.
 *  – learn to write UI tests for MediaWiki using Selenium.
 * Unit testing – learn to write unit tests for MediaWiki using PHPUnit.
 *  – security issues are reported to [mailto:security@wikimedia.org security@wikimedia.org].



معماری

 * Manual:Code – an overview of the key parts of MediaWiki's source code.
 * Database layout – an overview of MediaWiki's database schemas.
 * Global object variables – a partial list of key global variables.
 * Localisation – learn about MediaWiki's internationalisation system.
 * Manual namespace on this wiki – documentation for developers.
 * [//doc.wikimedia.org/mediawiki-core/master/php/ MediaWiki Class Reference] – technical documentation generated from the MediaWiki source code. (Note: The class reference is a large, slow-to-load page.)
 *  – manuals, guides, collections of selected articles.

زیرسامانه‌ها

 * API – MediaWiki's API provides direct, high-level access to the data contained in the MediaWiki databases
 * ContentHandler – MediaWiki's framework for supporting custom types of page content.
 *  – an overview of using databases in MediaWiki, including a brief guide to the database abstraction layer.
 *  – MediaWiki's framework for processing long-running tasks asynchronously.
 *  – MediaWiki's framework for providing localized application messages with PHP or JavaScript.

توسعه مدیاویکی
MediaWiki has been designed to allow for modification without changing the "core code". This makes it easy to update to a new version of MediaWiki without having to manually merge in old extension code changes. There are six main extension points that allow developers to change or extend what MediaWiki can do. The extension points are:


 * API – access the data and metadata of MediaWiki instances through its powerful "Action" web API
 * Hooks – every time a given event happens, do something.
 * Parser Functions – create a new command like:
 * Skins – change the look and feel of MediaWiki.
 * Special Pages – add a new special page.
 * Tag Extensions – create a new tag like:

Help for extension developers

 * Manual:Developing extensions – a guide to developing extensions.
 * Project:WikiProject Extensions
 * Extensions FAQ
 * See Category:Extensions, for a list of extensions.
 * Manual:$wgExtensionFunctions – use to defer setup (or run other callbacks) for extensions until after the MediaWiki core is setup.
 * Extension:BoilerPlate - a blank extension template

Help for skin developers

 * Manual:Skinning Part 1 – instructions on how to create a skin for MediaWiki.
 * Manual:Skin configuration – a guide to configuring skins for a wiki.

Help for library code reuse

 * Manual:Developing libraries – a guide to packaging third-party libraries for use with MediaWiki

Third-party wiki uses

 * - For Enterprise wikis
 * - For Academic wikis