Davi: 1 revision imported

2024-04-26T05:06:24Z

1 revision imported

← Older revision	Revision as of 05:06, 26 April 2024
(No difference)

wikipedia>SamanthaNguyen: follow Best practices for extensions for PSR-4 + namespaces

2023-12-02T22:36:19Z

follow Best practices for extensions for PSR-4 + namespaces

New page

<noinclude>
<languages/>
</noinclude><includeonly>{{#ifeq:{{{templatemode|}}}|nocats|
|[[Category:MediaWiki hooks{{#translation:}}|{{#if:{{{name|}}}|{{{name}}}|{{#titleparts:{{PAGENAME}}|1|2}}}}]]
[[Category:Hooks added in MediaWiki {{#switch:{{{version|???}}}||?|??|???|????=???|#default={{{version}}}}}{{#translation:}}|{{#if:{{{name|}}}|{{{name}}}|{{#titleparts:{{PAGENAME}}|1|2}}}}]]
{{#if:{{{removed|}}}
|{{Removed|{{{removed}}}|{{{removed-msg|}}}|newvarname={{{newvarname|}}}|newvarlink={{{newvarlink|}}}|name={{#if:{{{name|}}}|{{{name}}}|{{#titleparts:{{PAGENAME}}|1|2}} }}|deprecated={{{deprecated|}}} }}
|{{#if:{{{deprecated|}}}
|{{Deprecated|{{{deprecated}}}|{{{deprecated-msg|}}}|newvarname={{{newvarname|}}}|newvarlink={{{newvarlink|}}}|name={{#if:{{{name|}}}|{{{name}}}|{{#if:{{{deprecated-msg|{{#titleparts:{{PAGENAME}}|1|2}}}}}}} }} }}
|
}}
}}
{{#if:{{{removed|}}} |[[Category:Hooks removed in MediaWiki {{{removed}}}{{#translation:}}|{{#if:{{{name|}}}|{{{name}}}|{{#titleparts:{{PAGENAME}}|1|2}}}}]]}}
{{#if:{{{deprecated|}}}|[[Category:Hooks deprecated in MediaWiki {{{deprecated}}}{{#translation:}}|{{#if:{{{name|}}}|{{{name}}}|{{#titleparts:{{PAGENAME}}|1|2}}}}]]}}
}}
{| style="text-align: {{dir|{{PAGELANGUAGE}}|right|left}}; border: 1px solid #a2a9b1; border-collapse: collapse; margin: auto; clear: both;" cellpadding="5"
|-
! colspan="2" style="background-color: #eaecf0; font-size: 120%; text-align: center; padding: .5em;" | {{#if:{{{name|}}}|{{{name}}}|{{#titleparts:{{PAGENAME}}|1|2}}}}
|-
| colspan="2" style="text-align:center;" | {{#ifexist:MediaWiki {{padleft:|4|{{{version|???}}}}}
|<translate> Available from <tvar name=1>[[Special:MyLanguage/MediaWiki {{padleft:|4|{{{version|???}}}}}|{{Version|lc=1|1={{#switch:{{{version|???}}}||?|??|???|????=???|#default={{{version}}}}} }}]] {{#if:{{{rev|}}}|([[phabricator:rSVN{{{rev}}}|r{{{rev}}}]], [https://static-codereview.wikimedia.org/MediaWiki/{{{rev}}}.html codereview])|{{#if:{{{gerrit|}}}|([[gerrit:q/{{{gerrit}}}|Gerrit change {{{gerrit}}}]])}}}}</tvar></translate>
|<translate> Available from <tvar name=1>{{Version|lc=1|1={{#switch:{{{version|???}}}||?|??|???|????=???|#default={{{version}}}}} }} {{#if:{{{rev|}}}|([[phabricator:rSVN{{{rev}}}|r{{{rev}}}]], [https://static-codereview.wikimedia.org/MediaWiki/{{{rev}}}.html codereview])|{{#if:{{{gerrit|}}}|([[gerrit:q/{{{gerrit}}}|Gerrit change {{{gerrit}}}]])}}}}</tvar></translate>
}}{{#if:{{{removed|}}}| {{#ifexist:MediaWiki {{padleft:|4|{{{removed|???}}}}}
|<translate> Removed in <tvar name=1>[[Special:MyLanguage/MediaWiki {{padleft:|4|{{{removed}}}}}|{{Version|lc=1|1={{{removed}}} }}]] {{#if:{{{gerritremoved|}}}|([[gerrit:q/{{{gerritremoved}}}|Gerrit change {{{gerritremoved}}}]])}}</tvar></translate>
|<translate> Removed in <tvar name=1>{{Version|lc=1|1={{{removed}}} }} {{#if:{{{gerritremoved|}}}|([[gerrit:q/{{{gerritremoved}}}|Gerrit change {{{gerritremoved}}}]])}}</tvar></translate>
}}{{IfNotEn|[[Category:Removed hooks{{#translation:}}|{{#if:{{{name|}}}|{{{name}}}|{{#titleparts:{{PAGENAME}}|1|2}}}}]]}}|}} {{{summary|<translate> Please edit this page to enter a summary.</translate>}}} 
|-
| '''<translate> Define function:</translate>'''
| {{#tag:syntaxhighlight|
public static function on{{replace|{{{name|{{#titleparts:{{PAGENAME}}|1|2}}}}}|[^%w]+|_|regex=yes}}( {{{args|??}}} ) { ... }
|lang="php"}}
|-
| style="vertical-align:top"|'''<translate> Attach hook:</translate>'''
| <translate> In <tvar name=1>{{manual|extension.json}}</tvar>:</translate>
{{#tag:syntaxhighlight|
{
"Hooks": {
"{{{name|{{#titleparts:{{PAGENAME}}|1|2}}}}}": "MediaWiki\\Extension\\MyExtension\\Hooks::on{{replace|{{{name|{{#titleparts:{{PAGENAME}}|1|2}}}}}|[^%w]+||regex=yes}}"
}
}
|lang="json"}}
|-
| style="padding:0.3em" | '''<translate> Called from:</translate>'''
| '''<translate> File(s):</translate>'''{{#if:{{{extension|}}}|<nowiki> </nowiki>[[Extension:{{{extension}}}|{{{extension}}}]] /}} {{Foreach|MediaWikiHook/{{#ifeq:{{{templatemode|{{#if:{{{extension|}}}|nocats|}}}}}|nocats|SourceNoCats|Source}}|delim=, <nowiki/>|{{{source|}}}|{{{source2|}}}|{{{source3|}}}|{{{source4|}}}|{{{source5|}}}|{{{source6|}}}|{{{source7|}}}|{{{source8|}}}|{{{source9|}}}|{{{source10|}}} }}{{#if: {{{sourcefunction|}}}| '''<translate> Function(s):</translate>''' {{#if: {{{sourceclass|}}}|{{class doclink|class={{{sourceclass}}}|text={{{sourcefunction}}}}}|{{{sourcefunction}}}}}{{#if: {{{sourcefunction2|}}}|, {{{sourcefunction2}}}}}}}
|-
| '''<translate> Interface:</translate>'''
| {{#if:{{{name|}}}|[https://doc.wikimedia.org/mediawiki-core/master/php/{{ucfirst:{{replace|{{replace|{{{name}}}|_|__}}|:|__}}}}Hook_8php.html {{replace|{{{name}}}|:|_}}Hook.php]|[https://doc.wikimedia.org/mediawiki-core/master/php/{{ucfirst:{{#titleparts:{{PAGENAME}}|1|2}}}}Hook_8php.html {{ucfirst:{{#titleparts:{{PAGENAME}}|1|2}}Hook.php]}}}}
|}
<div style="text-align:center">
''<translate> For more information about attaching hooks, see <tvar name=1>{{ll|Manual:Hooks}}</tvar>.</translate>''
 
{{#if:{{{nocatdesc|}}}||''<translate> For examples of extensions using this hook, see <tvar name=cat>[[:Category:{{#if:{{{name|}}}|{{{name}}}|{{#titleparts:{{PAGENAME}}|1|2}}}} extensions{{#translation:}}]]</tvar>.</translate>''}}
</div>
</includeonly><noinclude>
{{Documentation|content=
<translate>
== Copy and paste template == 
</translate>
{{MediaWikiHook|templatemode=nocats
|name = MyHook
|version =
|gerrit =
|removed =
|gerritremoved =
|summary =
|args = $x, $y
|source =
|sourcefunction =
|sourceclass =
|newvarname =
|newvarlink =
|nocatdesc =
}}
<pre>
{{MediaWikiHook
|name = MyHook
|version =
|gerrit =
|gerritremoved =
|removed =
|summary =
|args = $x, $y
|source =
|sourcefunction =
|sourceclass =
|newvarname =
|newvarlink =
|nocatdesc =
}}
</pre>

<translate>
== Usage notes == 
</translate>

{{MediaWikiHook/doc}}

<translate>
== Finding a hook's version and Gerrit ID == 


To populate the <tvar name=1><code>version</code></tvar> and <tvar name=2><code>gerrit</code></tvar> attributes of this template, you may need to search the history of the <tvar name=3>{{git file|file=docs/hooks.txt}}</tvar> file.
</translate>

# (<translate> From the top-level of a Git clone of MediaWiki source code</translate>)
# <translate> Find the oldest commit to <tvar name=1><code>hooks.txt</code></tvar> that mentions the hook:</translate>
#* <code>git grep <<translate> hook-name-here</translate>> $(git rev-list --all -- docs/hooks.txt) -- docs/hooks.txt {{!}} tail -n 1</code>
# <translate> Find its Gerrit ID:</translate>
#* <code>git log <<translate> commit-from-above</translate>></code>
## <translate> Copy the change-id from the log entry into the Gerrit search box</translate>
## <translate> Select the relevant change, and get its ID</translate>
# <translate> Find out what release the hook was first included in:</translate>
#* <code>git tag --contains <<translate> commit-from-above</translate>></code>

}}

[[Category:Infobox templates{{#translation:}}|{{PAGENAME}}]]
[[Category:Categorizing templates{{#translation:}}|{{PAGENAME}}]]
[[Category:Hook templates{{#translation:}}|{{PAGENAME}}]]
</noinclude>

Template:MediaWikiHook - Revision history

Davi: 1 revision imported

wikipedia>SamanthaNguyen: follow Best practices for extensions for PSR-4 + namespaces