Rozšíření:WikimediaMessages

Příručka k rozšířením MediaWiki

WikimediaMessages Stav rozšíření: stabilní
Implementace	Uživatelské rozhraní
Popis	Přidává specifické zprávy a gramatiku Wikimedie, stejně jako specifická přepsání Wikimedie pro licenční nebo právní zprávy
Autoři	Tim Starling Siebrand Mazeland James D. Forrrester Multichill
MediaWiki	1.25+
Změny v databázi	Ne
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Parametry $wgWikimediaMessagesLicensing $wgWikimediaMessagesAnonDonateLink $wgWikimediaStylesSkins
Použité háčky (hooks) BeforePageDisplay CampaignEventsGetPolicyMessageForRegistration CampaignEventsGetPolicyMessageForRegistrationForm DiscussionToolsTermsOfUseMessages EditPageCopyrightWarning FlowTermsOfUseMessages MessageCacheFetchOverrides ResourceLoaderRegisterModules SidebarBeforeOutput SkinAddFooterLinks SkinCopyrightFooterMessage SkinTemplateNavigation::Universal SpecialPageBeforeExecute TorBlockBlockedMsg UploadForm:initial
Čtvrtletní stahování	11 (Ranked 100th)
Veřejné wiki používající rozšíření	933 (Ranked 263rd)
Přeložte rozšíření WikimediaMessages, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

WikimediaMessages přidává specifické zprávy a gramatiku Wikimedie, stejně jako specifická přepisy Wikimedie pro licenční nebo právní zprávy.

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného WikimediaMessages ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/WikimediaMessages
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'WikimediaMessages' );
  

• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Responsibilities

WikimediaMessages has several responsibilities which are documented here.

Cross-project message modification

The WikimediaMessages extension can be used to alter messages so they apply across sites. For example, to set the donate URL to point to "https://donate.wikimedia.org/" the sitesupport-url message can be modified by editing MediaWiki:sitesupport-url, however this will only apply to one wiki. The WikimediaMessages allows you to set the message for all wikis without needing to modify every site.

Note after changing a message you may need to rebuild the localization cache.

Defining new messages

You can define messages that are not defined in any other repository by modifying the associated language JSON files in i18n/wikimedia

Note if you want to override a message defined elsewhere, follow the guidelines for overrides.

Overriding existing messages

If a message exists in a repo and you want to override the message:

1. Define these messages in the wikimediaoverrides folder. Make sure to append the message key of the message you want to override with "wikimedia-". For example: The message "foo" can be overridden using a key "wikimedia-foo"
2. Update the hook onMessageCacheFetchOverrides in Hook.php so that the message for overriding is in the array of messages to override. Make sure to list the key of the message you are wanting to override (e.g. without the "wikimedia-" prefix)

Contact page styles

The WikimediaMessages extension adds the ext.wikimediamessages.contactpage module which adds Wikimedia-specific customisation to Extension:ContactPage.

Site admin helper

Many templates and associated styles were defined over a decade ago, and in many cases for many projects lack maintainers. The ext.wikimediamessages.styles module allows shipping of global styles for common templates across Wikimedia to apply Recommendations_for_night_mode_compatibility_on_Wikimedia_wikis and Recommendations for mobile friendly articles on Wikimedia wikis. The expectation is that community members at their own pace should upstream styles from this module into their own templates.

Finding styles

The styles provided are listed in the modules/ext.wikimediamessage.styles folder. Each file name corresponds with a "key".

The styles are expressed using LESS which is not available on wiki but an administrator can adapt these styles locally.

Disabling styles

In some cases styles won't apply to a project. For example the navbox and hatnote styles are not applicable to a project which uses neither of these templates. To disable the styles in hatnote.less and navbox.less an interface administrator can modify MediaWiki:wikimedia-styles-exclude with the text hatnote|navbox.

When disabling styles we recommend understanding what the styles are doing and first upstreaming relevant styles first.

To disable all styles provided by Wikimedia (not recommended unless you know what you are doing) the message can be set to:

ambox|hatnote|infobox|navbox|theme-night-mainpage|theme-night|theme-night-portal

Applying styles only to specific skins

If you want the styles to not apply to a certain skin, you generate the raw stylesheet prior to disabling a package of styles and copy and paste relevant styles to one of the skin site CSS pages e.g. MediaWiki:Minerva.css, MediaWiki:Vector-2022.css etc..

You can generate the full list of styles by visiting /w/load.php?lang=en&modules=ext.wikimediamessages.styles&debug=1&only=styles on your wiki. For example on English Wikipedia: https://en.wikipedia.org/w/load.php?lang=en&modules=ext.wikimediamessages.styles&debug=1&only=styles.