साँचा:Extension
This template employs intricate features of template syntax.
You are encouraged to familiarize yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. Remember that you can conduct experiments, and should test all improvements, in either the general sandbox or your user space before changing anything here. |
Uses Lua: |
This template uses TemplateStyles: |
इस साँचे को इस विकि के सभी एक्सटेंशनों पर जोड़ा जाना चाहिए (मगर सिर्फ उनके मूल पृष्ठों पर)। यह एक काम का इन्फोबॉक्स जोड़ेगा (नीचे देखें) और एक्सटेंशन को अपने आप श्रेणी:सभी एक्सटेंशन में उचित स्थिति और कार्यान्वयन प्रकार श्रेणी के साथ जोड़ देगा। It autofills some fields of the infobox with extension data collected by wikitech:Tool:Extjsonuploader.
प्रयोग
प्रतिलिपि बनाकर चिपकाएँ: {{Extension |templatemode = |name = |status = |type1 = |type2 = |hook1 = |hook2 = |newhook1 = |newhook2 = |username = |author = |description = |image = |imagesize = |version = |update = |version preview = |update preview = |compatibility policy = |mediawiki = |php = |needs-updatephp = |composer = |virtual domain = |table1 = |table2 = |license = |download = |repo = |readme = |changelog = |help = |example = |namespace = |parameters = |tags = |rights = |compatibility = |phabricator = |translate = |vagrant-role = }}पैरामीटर वैल्यू संबंधित सहायता के लिए नीचे देखें। |
|
सामग्री के पैरामीटर
इस सेक्शन में उन पैरामीटरों के विवरण हैं जो ज्ञानसंदूक के कंटेंट पर निर्भर हैं। templatemode और दूसरे नियंत्रण पैरामीटर संबंधित सहायता के लिए नियंत्रण पैरामीटर देखें।
पैरामीटर | विवरण |
---|---|
name | एक्सटेंशन का नाम |
status |
प्रकाशन की वर्तमान स्थिति कुल:
अगर स्थिति उपरोक्त के अलावा कुछ भी होता है, उसे अनदेखा कर दिया जाएगा और साँचे पर 'अनजान' का डिफ़ॉल्ट वैल्यू दिखाया जाएगा। जब वैल्यू को छोड़ दिया जाता है, इसे अनजान के रूप में श्रेणीबद्ध किया जाएगा। जब वैल्यू अमान्य हो, इसे एक विशेष श्रेणी में डाल दिया जाएगा ताकि त्रुटि पकड़ी जाए और उसे ठीक कर दिया जाए। |
type1 type2 type3 type4 type5 type6 | कार्यान्वयन का प्रकार
इस एक्सटेंशन को बनाते समय उपयुक्त कार्यान्वयन नीति। इस पैरामीटर की मदद से श्रेणियाँ बनाई जाती हैं जिससे प्रोग्रामर्स मीडियाविकि पर कार्यान्वयन की नीतियों और क्रमों के उदाहरण देखकर सीख सकते हैं। हालाँकि इस पैरामीटर के वैल्यू कभी-कभी एक्सटेंशन के उपयोग के मामले के समान होते हैं, यह इस पैरामीटर का लक्ष्य नहीं है। अगर इस पैरामीटर के लिए चुना गया वैल्यू किसी आवश्यकता या संभव उपयोग के मामले को पूरा नहीं करता है, हम सलाह देंगे कि आप ज़रूरत के अनुसार अतिरिक्त श्रेणियों की कड़ियाँ जोड़ें। type1, type2 पैरामीटरों के लिए स्वीकृत वैल्यू हैं:
'type' के लिए कोई भी दूसरा वैल्यू अमान्य होगा, और एक्सटेंशन को Category:Extensions with invalid or missing type/hi में जोड़ दिया जाएगा। नोट: कई एक्सटेंशनों के एक से ज़्यादा प्रकार होते हैं। अगर यह आपके एक्सटेंशन पर लागू होता है,|type= को |type1=|type2=|type3=... से बदल दें। आप किसी एक्सटेंशन के लिए अधिकतम छः प्रकार परिभाषित कर सकते हैं। |
hook1 hook2 hook3 hook4 ... |
एक्सटेंशन द्वारा इस्तेमाल किए गए हर हुक का नाम
इस फील्ड में वैल्यू डालने से आपके एक्सटेंशन को बढ़ावा मिलेगा और दूसरे डेवलपरों को मदद मिलेगी। हर प्रलेखित हुक अपने आप एक्सटेंशन को एक श्रेणी में डाल देगा जहाँ उन सभी एक्सटेंशनों की सूची है जो उस हुक का इस्तेमाल करते हैं। श्रेणी को हर हुक के पृष्ठ से ऑटोलिंक किया जाता है ताकि प्रोग्रामर आसानी से ऐसे एक्सटेंशनों के उदाहरण ढूँढ़ पाएँ जो किसी विशिष्ट हुक का इस्तेमाल करते हैं। कई हुक्स के लिए, पहला हुक hook1 पर लिखें, दूसरा hook 2 और आगे। |
newhook1 newhook2 newhook3 newhook4 ... newhook90 |
एक्सटेंशन द्वारा प्रदान किए गए हर हुक का नाम आपको ये हुक्स Extension hook registry पर भी जोड़ देने चाहिए। |
username | MediaWiki.org पर लेखक का नाम (अगर लागू हो तो)। May be omitted, but if present it will be used to link to the author's user & user_talk page. It should be provided without namespace and without [[]]s. |
The extension author's name, if different from their MediaWiki.org username. मुक्त टेक्स्ट। अगर छोड़ दिया जाता है तो 'username' फ़ील्ड का इस्तेमाल किया जाएगा (अगर वह मौजूद हो तो)। | |
description | संक्षिप्त विवरण |
image | एक्सटेंशन का स्क्रीनशॉट या लोगो। इसे नामस्थान और [[]]-ओं के बिना दिया जाना चाहिए। |
imagesize | ऐच्छिक, चित्र का आकार (डिफ़ॉल्ट आकार 220px है) |
version | नवीनतम संस्करण |
update | आखिरी अपडेट का दिनांक |
version preview | Preview version |
update preview | Date of the last update to the preview version |
compatibility policy | अनुकूलता नीति (स्वीकृत वैल्यू हैं $2, $3 और $x)। (बैकलॉग ) |
mediawiki | मीडियाविकि का आवश्यक संस्करण। Most extensions should not need to use this — it defaults to the value of the 'requires' property of extension.json. See also Category:Extensions without MediaWiki version and Category:Extensions with manual MediaWiki version . |
php | PHP का आवश्यक संस्करण |
needs-updatephp |
Extensions that conform to MediaWiki extension standards come with a schema change script which you need to start manually (once) before starting and accessing the MediaWiki through your browser, and after you copied all the extension files to
$IP stands for the Installation Path (or "directory") of your MediaWiki installation, the same directory that holds LocalSettings.php , index.php etc.. |
composer | मानक प्रारूप में एक्सटेंशन के Composer पैकेज का नाम। अगर एक्सटेंशन के "composer.json" फ़ाइल में इसे सेट किया जाता है तो इसे अपने आप जोड़ दिया जाएगा (यानी उस मामले में इस पैरामीटर की ज़रूरत नहीं होगी)। इसे Packagist पर एक्सटेंशन के पृष्ठ से जोड़ दिया जाएगा। |
virtual domain | The virtual database domain used by the extension. |
table1 table2 table3 table4 ... table30 | एक्सटेंशन द्वारा इस्तेमाल किए गए हर टेबल का नाम जो मूल हिस्से से बाहर है Links to a subpage of your extension page. For instance, "table1 = cu_changes" at Extension:CheckUser will link to Extension:CheckUser/cu_changes table . Don't list core tables such as page or revision ; only list tables that are added by extensions. |
license | इस एक्सटेंशन के लिए लाइसेंस, जो https://spdx.org/licenses/ के कोड्स में से एक होता है, जैसे GPL-2.0-or-later , GPL-2.0-only या GPL-3.0-or-later , आदि। |
download | डाउनलोड की कड़ी: Git, {{WikimediaDownload/hi }}। |
repo | उस Gerrit रिपॉज़िटरी का नाम जिसमें एक्सटेंशन का कोड रखा गया है, अगर वह पृष्ठ के नाम से अलग है। इसे सेट करने से |डाउनलोड= अपने आप सेट हो जाता है, और साँचा अपने आप उचित extension.json फ़ाइल से डेटा निकाल सकता है। |
readme | readme फ़ाइल की बाहरी कड़ी, जैसे https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
changelog | बदलाव लॉग फ़ाइल की बाहरी कड़ी, जैसे Extension:GeoGebra/Changelog |
help | Link to user-help for the extension. If not provided, will look for Help:Extension:ExtensionName . If provided, full wikitext link should be given (because you may want to link to e.g. an external page). |
example | काम करने वाले एक्सटेंशन का उदाहरण, वेबसाइट का स्क्रीनशॉट |
namespace | नामस्थान जिसमें यह एक्सटेंशन रखा जाता हो |
parameters | LocalSettings.php के लिए उपलब्ध पैरामीटर |
आपके एक्सटेंशन द्वारा उपयुक्त टैग्स (जैसे <tag1>, <tag2>)। | |
rights | एक्सटेंशन द्वारा जोड़े जाने वाले अधिकार। इसे लाइसेंस से भ्रमित न करें! अधिकार के उदाहरण हैं makebot या desysop , न कि GFDL या LGPL या GPL - ये लाइसेंस हैं! |
compatibility | Additional compatibility information, for instance compatibility charts. It's encouraged to add any client-side compatibility information here too, especially when diverging from expectations of full support for a browser. |
bugzilla | Bugzilla पर मीडियाविकि एक्सटेंशन कम्पोनेंट का नाम |
phabricator | Phabricator परियोजना का नाम |
translate |
Optional parameter to link the exact page where (message group id with which) the extension will be translatable on translatewiki.net if enabled. If the default link is incorrect, manually set it to:
|
vagrant-role | MediaWiki-Vagrant role |
CheckUsageNameOverride | 'उपयोग जाँचें' कड़ी के लिए पृष्ठ के नाम को ओवर्राइड करें। |
नियंत्रण पैरामीटर
पैरामीटर | विवरण |
---|---|
templatemode |
Controls auto-categorisation of host page. Normally left blank. Alternate values are:
|
Using the infobox
Existing extension pages
If you want to add the infobox to an existing page, copy and paste the code at the top of this page.
Create a new extension page
If you want to create a new extension page, enter the name below and click the button. A new page will be created with the infobox template already in place.
A developer sharing their code in the MediaWiki code repository should expect:
- Feedback / Criticism / Code reviews
- Review and comments by other developers on things like framework use, security, efficiency and usability.
- Developer tweaking
- Other developers modifying your submission to improve or clean-up your code to meet new framework classes and methods, coding conventions and translations.
- Improved access for wiki sysadmins
- If you do decide to put your code on the wiki, another developer may decide to move it to the MediaWiki code repository for easier maintenance. You may then create a विकासक खाता to continue maintaining it.
- Future versions by other developers
- New branches of your code being created automatically as new versions of MediaWiki are released. You should backport to these branches if you want to support older versions.
- Incorporation of your code into other extensions with duplicate or similar purposes — incorporating the best features from each extension.
- Credit
- Credit for your work being preserved in future versions — including any merged extensions.
- Similarly, you should credit the developers of any extensions whose code you borrow from — especially when performing a merger.
Any developer who is uncomfortable with any of these actions occurring should not host in the code repository. You are still encouraged to create a summary page for your extension on the wiki to let people know about the extension, and where to download it.
Enhancing this template
If you would like to improve on this template, thanks! This is a complicated template so here is some help along the way:
The Create extension button
To improve the create extension button behavior:
- Template:Extension/Sample : The boilerplate extension that is preloaded into newly-created pages.
- Template:Extension/CreateExtensionInputBox : An input box that can be inserted wherever you want users to easily create extensions. For documentation on the
<inputbox>
tag, please see Extension:InputBox .
Infobox parameters
In general:
- To make this template easy to use, each label in the infobox is linked to documentation on the template parameter(s) it displays. If you add a parameter, please be sure to also add it to the content parameter documentation and link its label to that documentation.
To change/correct/add to the implementation type parameters:
- Check the talk page - there have been some extensive discussions about this field.
- The valid types and what they link to are defined at Module:Extension
To change the behavior of the hook parameters:
- Template:Extension/HookInUse: Adds links and categories for a hook in use. Multiple hooks in use are implemented by calling this template with Template:Foreach.
- Template:Extension/HookInUseNoCats: Used instead of Template:Extension/HookInUse when this template is used in
templatemode=nocats
. Templates used with Template:Foreach can only take one parameter so we need to wrap the call to Template:Extension/HookInUse with another template that sets the mode.
परीक्षण का मामला
जाँचें कि निम्न पृष्ठ साँचे को संपादित करने के बाद ठीक हैं कि नहीं।
TemplateData
TemplateData | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
यह यथादृश्य सम्पादिका और दूसरे उपकरणों द्वारा उपयोग इस साँचे के TemplateData प्रलेख है। Extension An infobox for a MediaWiki extension.
|
Maintenance: vulnerabilities, archived