Extension:MobileFrontend

**Příručka k rozšířením MediaWiki**
MobileFrontend; Stav rozšíření: stabilní
Implementace	Uživatelské rozhraní, Háček
Popis	Poskytuje pohled vhodný pro mobilní zařízení
Autoři	See repo;
Nejnovější verze	2.4.1
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki	1.33+
PHP	5.5.9+
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření ; Git [?]: Procházení úložiště (Phabricator · GitHub); Kontrola kódu Gerrit; Zobrazení historie Git; Stáhněte si zdrojový soubor tarball; ; README
Příklad	m.mediawiki.org
	Parametry $wgMFStopRedirectCookieHost; $wgMFShowMobileViewToTablets; $wgMFLazyLoadImages; $wgMFRSSFeedLink; $wgMFNamespacesWithLeadParagraphs; $wgMFAmcOutreachMinEditCount; $wgMFEnableMobilePreferences; $wgMFMobileFormatterOptions; $wgMFRemovableClasses; $wgMFNoindexPages; $wgMFShowFirstParagraphBeforeInfobox; $wgMFEnableVEWikitextEditor; $wgMFVaryOnUA; $wgMFLogWrappedInfoboxes; $wgMFDisplayWikibaseDescriptions; $wgMFEnableJSConsoleRecruitment; $wgMobileFrontendFormatCookieExpiry; $wgMFLazyLoadSkipSmallImages; $wgMFSearchAPIParams; $wgMFMobileHeader; $wgMFCustomSiteModules; $wgMFEnableXAnalyticsLogging; $wgMFAutodetectMobileView; $wgMFSiteStylesRenderBlocking; $wgDefaultMobileSkin; $wgMFUseDesktopSpecialEditWatchlistPage; $wgMFEnableFontChanger; $wgMFScriptPath; $wgMFEditNoticesConflictingGadgetName; $wgMFAdvancedMobileContributions; $wgMFFallbackEditor; $wgMFStopMobileRedirectCookieSecureValue; $wgMFSpecialPageTaglines; $wgMFQueryPropModules; $wgMFNamespacesWithoutCollapsibleSections; $wgMFBetaFeedbackLink; $wgMFDefaultEditor; $wgMFAmcOutreach; $wgMFManifestBackgroundColor; $wgMFManifestThemeColor; $wgMFEnableManifest; $wgMFEnableWikidataDescriptions; $wgMFUseWikibase; $wgMFTrackBlockNotices; $wgMFEnableBeta; $wgMobileUrlCallback;
	Použité háčky (hooks) APIGetAllowedParams; APIQuerySiteInfoGeneralInfo; AbuseFilter-builder; AbuseFilter-generateUserVars; AfterBuildFeedLinks; ApiBeforeMain; ArticleParserOptions; AuthChangeFormFields; BeforeDisplayNoArticleText; BeforePageDisplay; BeforePageRedirect; CentralAuthLoginRedirectData; CentralAuthSilentLoginRedirect; ChangeTagsListActive; CustomEditor; GetCacheVaryCookies; GetPreferences; HTMLFileCache::useFileCache; ListDefinedTags; LoginFormValidErrorMessages; MakeGlobalVariablesScript; ManualLogEntryBeforePublish; MediaWikiPerformAction; OutputPageBeforeHTML; OutputPageBodyAttributes; OutputPageParserOutput; PostLoginRedirect; RecentChange_save; RequestContextCreateSkin; ResourceLoaderBeforeResponse; ResourceLoaderSiteModulePages; ResourceLoaderSiteStylesModulePages; SkinAddFooterLinks; SkinAfterBottomScripts; SpecialPageBeforeExecute; SpecialPage_initList; TitleSquidURLs; UserGetDefaultOptions;
	Poskytované háčky (hooks) MobileFrontendBeforeDOM; EnterMobileMode; GetMobileUrl; RequestContextCreateSkinMobile; BeforePageDisplayMobile; MobileLicenseLink; MobileSiteOutputPageBeforeExec; MobileFrontendFeaturesRegistration; MobileSpecialPageStyles; SpecialMobileEditWatchlist::images;
	Přeložte rozšíření MobileFrontend, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

This page is a translated version of the page Extension:MobileFrontend and the translation is 98% complete.

Outdated translations are marked like this.

Rozšíření MobileFrontend pomáhá zlepšit mobilní přítomnost instance MediaWiki.

Mezi funkce patří:

Vytvoří samostatný mobilní web pro váš mobilní provoz.
- Správci systému mohou poskytnout jiný vzhled, např. Vzhled:Minerva Neue .
Nabízí různé transformace obsahu, aby byl váš obsah přátelštější,
- Zejména sbalování sekcí a přeskupování a odstraňování obsahu, včetně umístění úvodního odstavce nad úvodní fotografii nebo informační pole, i když je úvodní odstavec ve zdrojovém kódu stránky pod nimi.
Zjednodušuje mobilní zápatí a přidává odkaz na web pro stolní počítače/mobilní zařízení,
Poskytuje beta režim se systémem správy funkcí pro přidávání experimentálních funkcí pro anonymní uživatele.

Tato stránka je určena pro koncové uživatele, kteří si ji chtějí nainstalovat do své vývojové instance. Pokud nám chcete pomoci s jeho tvorbou a vylepšením, doporučujeme vám zapojit se.

Předpoklady

Pokud před instalací MobileFrontendu hojně využíváte šablony a nebo inline styly (atribut style), měli byste zkontrolovat svůj obsah a zjistit, zda je optimalizovaný pro mobilní zařízení. Rozšíření TemplateStyles lze použít k úpravě obsahu tak, aby se pěkně vykresloval na mobilních zařízeních i počítačích. MobileFrontend to za vás magicky neopraví!

Zejména byste si měli prohlédnout svou vstupní stránku (hlavní stránku). Viz Formátování mobilní domovské stránky.

Instalace

Stáhněte soubor/y a vložte je do adresáře pojmenovaného MobileFrontend 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/MobileFrontend
```
Na konec vašeho souboru LocalSettings.php přidejte následující kód:
```
wfLoadExtension( 'MobileFrontend' );
```
V případě potřeby nakonfigurujte podle potřeby
Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Instalace Vagrant:

Pokud používáte Vagrant , instalujte s těmito parametry vagrant roles enable mobilefrontend --provision

Nastavení Nearby

Funkce Nearby v MobileFrontendu byla v MediaWiki 1.40 odstraněna. Místo toho je k dispozici přepsaná verze této funkce na Extension:NearbyPages.

Nastavení vzhledu

MobileFrontend vám poskytuje webové stránky ve formátu pro mobilní zařízení, které fungují vedle vašich stávajících webových stránek pro stolní počítače. Můžete si je libovolně upravovat.

Vyberte si jeden z těchto pár řádků a přidejte ho na konec souboru LocalSettings.php.

Note that some of these skins might already be getting loaded in LocalSettings.php, in which case those lines do not need to be repeated.

wfLoadSkin( 'MinervaNeue' );
$wgDefaultMobileSkin = 'minerva'; // používáte vzhled Minerva (Ve verzi 1.37 a starší je nutné si je stáhnout a nainstalovat samostatně, jinak se zobrazí výjimka.)

wfLoadSkin( 'Vector' );
$wgDefaultMobileSkin = 'vector'; // používáte vzhled Vector

wfLoadSkin( 'Timeless' );
$wgDefaultMobileSkin = 'timeless'; // používáte vzhled Timeless

Následující vzhledy jsou kompatibilní s MobileFrontendem:

Vzhled:Minerva Neue (stabilní, výchozí na wikinách WMF)
Vzhled:Vector (výchozí vzhled pro stolní počítače, používá experimentální responzivní režim pro mobilní zařízení)
Vzhled:Timeless (experimentální vzhled)
Vzhled:MonoBook
Skin:Citizen - citlivý vzhled

Nastavení konfigurace

Podívejte se na stránku Extension:MobileFrontend/Configuration

Všechny možnosti konfigurace jsou podrobně popsány v souboru README.md.

Další úpravy

Využijte MobileFrontendu naplno přidáním těchto volitelných kompatibilních rozšíření:

Extension:GeoData - získejte Special:Nearby a označte své články geotagy.
Extension:PageImages - přidá obrázky do výsledků vyhledávání a do výsledků v okolí.
Extension:VisualEditor - přidejte vizuální úpravy do svého mobilního prostředí.

Místní úpravy

Styl CSS

Verze MediaWiki:

≤ 1.40

Chcete-li použít CSS na mobilní šablonu, upravte MediaWiki:Mobile.css, což je protějšek souboru MediaWiki:Common.css. Aby stylový list fungoval, budete možná muset k vašim MediaWiki:Mobile.js přidat mw.loader.using('mobile.site.styles').

MobileFrontend nenačítá globální soubor MediaWiki:Common.css, ani žádný z uživatelských stylů.

Další informace

Pokud chcete mobilní rozšíření otestovat v prohlížeči na počítači nebo vaše zařízení mobilní verzi nezobrazuje, můžete k řetězci dotazu URL přidat následující pár klíč-hodnota: ?useformat=mobile. Například: https://en.wikipedia.org/wiki/MediaWiki?useformat=mobile

Pokud chcete zobrazit mobilní verzi stránky, aniž byste rozšíření povolili na celém webu, můžete řetězec přidat i k URL adrese na dané stránce.

Starší funkce MobileFrontendu

MobileFrontend byl tradičně velmi rozsáhlým rozšířením. Mnoho funkcí buď překonalo své požadavky, nebo je překonají v budoucnu. Tyto funkce jsou uvedeny níže.

API

Rozhraní API poskytuje rozšíření MobileFrontend, ale dlouhodobě očekáváme, že je ukončíme ve prospěch služby obsahu stránek. Používání těchto API je na vlastní nebezpečí. Mohou zmizet (i když vás o tom včas upozorníme)!

Rozšíření action=parse

action=parse přijímá další parametry:

mobileformat=: Vrátí vykreslený HTML kód stránky v mobilním formátu 1.23+.
mainpage: Použití transformace hlavní stránky pro mobilní zařízení.

Příklad:

api.php?action=parse&page=Therion_(band)&mobileformat=&prop=text [zkuste v ApiSandbox]

Výsledek

{
    "parse": {
        "title": "Therion (band)",
	    "text": {
            "*": "<div><table class=\"infobox vcard plainlist\" style=\"width:22em\"><tr><th colspan=\"2\" style=\"text-align:center;font-size:125%;font-weight:bold;background-color: #b0c4de\"><span class=\"fn org\">Therion</span></th>\n</tr><tr><td colspan=\"2\" style=\"text-align:center\"><a href=\"/wiki/File:2130860153_281d30b3bf_b.jpg\" class=\"image\">
            ...

meta=siteinfo

Doména mobilní verze webu (která může, ale nemusí být stejná jako běžná doména) je k dispozici pod klíčem mobileserver v obecných informacích siteinfo.

Pro vývojáře/sysadministrátory

Nastavení

Možná budete muset spustit npm install a nainstalovat PHP Composer, aby se spustil háček precommit, v závislosti na tom, co s rozšířením děláte.

Testování s články na zahraniční wiki (živá data)

Podívejte se na stránku Extension:MobileFrontendContentProvider .

Používání mobilního zobrazení

Stránky WMF

Na stránkách provozovaných Wikimedia Foundation používáme cachovací servery Varnish k ověřování uživatelského agenta vašeho zařízení.

Stránky mimo WMF

U webů, které nepoužívají WMF, můžete buď nastavit konfiguraci tak, aby napodobovala procesy ve WMF (detekce zařízení na proxy vrstvě a nastavení specifických záhlaví X-Device), nebo můžete jednoduše použít „?useformat=mobile“ k přepnutí článku do mobilního zobrazení. Viz Extension:MobileFrontend/Configuring browser auto-detection .

Počínaje verzí snapshotu 1.28 byl výchozí hlavičkový soubor $wgMFMobileHeader změněn z X-WAP na X-Subdomain. Můžete buď nastavit $wgMFMobileHeader = 'X-WAP';, nebo upravit nastavení záhlaví mezipaměti (Varnish), pokud se shodují.

Používání Apache (.htaccess nebo httpd.conf)

Chcete-li nastavit mobilní doménu, přidejte následující pravidlo do souboru .htaccess nebo httpd.conf

<IfModule mod_headers.c>
<If "req('Host') =~ /^mobile./i">
RequestHeader set X-Subdomain "mobile"
</If>
</IfModule>

Ve vašem souboru hosts (za předpokladu, že váš desktopový web je na serveru localhost):

127.0.0.1  mobile.localhost

V LocalSettings.php:

wfLoadExtension('MobileFrontend');

$wgMFAutodetectMobileView = true;
$wgMobileUrlCallback = fn( $domain ) => "mobile.$domain";

Pokud nyní přejdete na stránku mobile.localhost, měli byste vidět mobilní verzi webu.

Časté dotazy

Následující otázky se často objevují na naší diskusní stránce. Před zveřejněním příspěvku na diskusní stránce si prosím zkontrolujte tento seznam, nebo pokud je k dispozici, použijte existující téma diskuse k získání vysvětlení.

Otázka: Jak zjistím, že se mobilní web nachází v kódu frontendu?

Odpověď: V ideálním případě byste to dělat neměli. Pro detekci mobilního uživatele je lepší použít mw.config.get('skin') nebo window.matchMedia('(max-width: 1119px)').matches. Můžete také využít stabilní třídu mw-mf, která je přítomna v elementu BODY, pokud je mobilní web aktivní.

Pokud váš kód provádí úpravy obsahu, může být nutné jej aktualizovat tak, aby zohledňoval značky MobileFrontendu, a to kontrolou DOMu na přítomnost určitých prvků.

Upozorňujeme, že ačkoliv mw.config.get( 'wgMFMode' ) existuje a může být použit rozšířeními jako poslední možnost (prozatím), neměl by být považován za stabilní pro použití gadgety.

Otázka: Jak si mohu přizpůsobit hlavní nabídku vzhledu Minerva?

Odpověď: Toto je sledováno ve Phabricatoru, ale za prozatímní řešení můžete vidět Extension talk:MobileFrontend/2017#h-MODIFY THE MAIN MENU-2017-01-04T02:24:00.000Z.

Otázka: Jak přidám HTML do vzhledu Minervy, například pro přidání reklam nebo dalších skriptových tagů?

Odpověď: Můžete to provést úpravou souboru šablony pro vzhled (aktuálně include/skins/minerva.mustache). Podrobnosti naleznete v této diskusi.

Otázka: Rozšíření, které používám, na MobileFrontendu zřejmě nefunguje. Proč?

Odpověď: Je pravděpodobné, že rozšíření je staré a potřebuje přidat kompatibilitu s MobileFrontendem. Kontaktujte prosím vývojáře rozšíření a odkažte ho na ResourceLoader/Psaní modulu ResourceLoader přátelského k MobileFrontendu. Prosím, neposílejte příspěvky na diskusní stránku, protože v tomto případě by bylo lepší nahlásit chybu na Pharbacator (můžete se přihlásit pomocí svého uživatelského jména na MediaWiki.org) pro rychlejší odpověď.

Otázka: Aktualizoval jsem MobileFrontend a teď se mi zobrazuje fatální výjimka!

Odpověď: Pravděpodobně používáte nekompatibilní verze MobileFrontendu a MediaWiki. Ve většině případů vám zde nemůžeme pomoci. Zkuste aktualizovat MobileFrontend nebo MediaWiki, abyste problém vyřešili.

Otázka: Po aktualizaci MediaWiki se mi zobrazuje výjimka: wgMFDefaultSkinClass není správně nastavená.

A: MobileFrontend v současné době předpokládá, že máte nainstalovaný vzhled Minerva Neue . Pokud ne, budete si ho muset nainstalovat nebo nakonfigurovat mobilní vzhled dle výše uvedených pokynů.

Pro vývojáře rozšíření

Ve výchozím nastavení se moduly zdrojů v rozšířeních v mobilním zobrazení nenačtou.

Pokud je potřeba načíst modul v mobilním zobrazení, pomůže vám tato příručka pro psaní modulů optimalizovaných pro MobileFrontende.

Související odkazy

Mobilní webové prohlížeče podporované MobileFrontendem
Extension:TextExtracts
Commons:Category:MediaWiki extension MobileFrontend
Extension:MobileDetect
Extension:Progressive web application - proměňte jakoukoli wiki v mobilní aplikaci

Poznámky pod čarou

↑ :Fatal error: Uncaught ExtensionDependencyError: MobileFrontend is not compatible with the current MediaWiki core (version 1.32.2), it requires: >= 1.33.0.

Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version.

Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích:

Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.

[1] :Fatal error: Uncaught ExtensionDependencyError: MobileFrontend is not compatible with the current MediaWiki core (version 1.32.2), it requires: >= 1.33.0.

[1]