Extension:MobileFrontend

MediaWiki manüel uzantıları

MobileFrontend Sürüm durumu: kararlı
Uygulama	Kullanıcı arayüzü, Kanca
Açıklama	Mobil uyumlu bir görünüm sağlar
Yazar(lar)	See repo
En son sürüm	2.3.0
Uyumluluk politikası	Snapshots releases along with MediaWiki. Master is not backwards compatible.
MediaWiki	1.33+
PHP	5.5.9+
Lisans	GNU Genel Kamu Lisansı 2.0 veya üstü
İndir	Uzantıyı indir Git [?]: Git master'ı indir depoyu göz at (GitHub) geçmişi işleyin veri deposu katkıda bulunanlar (GitHub) kod incelemesi README
Örnek	m.mediawiki.org
Parametreler $wgMFSearchGenerator $wgMFStopRedirectCookieHost $wgMFShowMobileViewToTablets $wgMFStripResponsiveImages $wgMFLazyLoadImages $wgMFRSSFeedLink $wgMFNamespacesWithLeadParagraphs $wgMFAmcOutreachMinEditCount $wgMFEnableMobilePreferences $wgMFMobileFormatterOptions $wgMFRemovableClasses $wgMFContentProviderTryLocalContentFirst $wgMFShowFirstParagraphBeforeInfobox $wgMFMinCachedPageSize $wgMFContentProviderClass $wgMFVaryOnUA $wgMFLogWrappedInfoboxes $wgMFDisplayWikibaseDescriptions $wgMFAlwaysUseContentProvider $wgMFEnableJSConsoleRecruitment $wgMobileFrontendFormatCookieExpiry $wgMFStopMobileRedirectCookieSecureValue $wgMFResponsiveImageWhitelist $wgMFLazyLoadSkipSmallImages $wgMFSearchAPIParams $wgMFContentProviderScriptPath $wgMFAutodetectMobileView $wgMFEnableXAnalyticsLogging $wgMFUseDesktopSpecialHistoryPage $wgMFSchemaEditAttemptStepOversample $wgMFSiteStylesRenderBlocking $wgMFMcsContentProviderBaseUri $wgDefaultMobileSkin $wgMobileUrlTemplate $wgMFCollapseSectionsByDefault $wgMFAmcOutreach $wgMFEnableFontChanger $wgMFAdvancedMobileContributions $wgMFWatchlistEditCountThreshold $wgMFManifestBackgroundColor $wgMFManifestThemeColor $wgMFNearby $wgMFEnableManifest $wgMFSchemaSearchSampleRate $wgMFSpecialPageTaglines $wgMFNearbyRange $wgMFEnableWikidataDescriptions $wgMFBetaFeedbackLink $wgMFDefaultEditor $wgMFUseWikibase $wgMFNamespacesWithoutCollapsibleSections $wgMFUseDesktopSpecialWatchlistPage $wgMFEnableBeta $wgMFNoindexPages $wgMFMwApiContentProviderBaseUri $wgMFTrackBlockNotices $wgMFQueryPropModules $wgMFMobileHeader
Kullanılan kancalar APIAfterExecute APIGetAllowedParams APIQuerySiteInfoGeneralInfo AbuseFilter-builder AbuseFilter-generateUserVars AfterBuildFeedLinks AuthChangeFormFields BeforeInitialize BeforePageDisplay BeforePageRedirect CentralAuthLoginRedirectData CentralAuthSilentLoginRedirect ChangeTagsListActive DifferenceEngineViewHeader Gadgets::allowLegacy GetCacheVaryCookies GetPreferences HTMLFileCache::useFileCache ListDefinedTags LoginFormValidErrorMessages MakeGlobalVariablesScript ManualLogEntryBeforePublish MediaWikiPerformAction OutputPageBeforeHTML OutputPageParserOutput PageRenderingHash RecentChange_save RequestContextCreateSkin ResourceLoaderRegisterModules ResourceLoaderSiteModulePages ResourceLoaderSiteStylesModulePages SkinAddFooterLinks SkinAfterBottomScripts SpecialPageBeforeExecute SpecialPage_initList ThumbnailBeforeProduceHTML TitleSquidURLs UserGetDefaultOptions UserLoginComplete
Sağlanan kancalar MobileFrontendBeforeDOM EnterMobileMode GetMobileUrl RequestContextCreateSkinMobile BeforePageDisplayMobile MobileLicenseLink MobileSiteOutputPageBeforeExec MobileFrontendFeaturesRegistration MobileSpecialPageStyles BeforeSpecialMobileDiffDisplay SpecialMobileEditWatchlist::images
Translatewiki.net adresinde mevcutsa, MobileFrontend uzantısını çevirin
Kullanım ve sürüm matrisini kontrol edin.
Sorunlar	Açık görevler · Hata bildir

MobileFrontend uzantısı:

• Mobil trafiğiniz için ayrı bir mobil site oluşturur,
  • Sistem hizmetlileri farklı bir görünüm sağlayabilir, ör. Skin:Minerva Neue.
• içeriğinizi daha uyumlu hale getirmek için çeşitli içerik dönüşümleri sağlar,
  • Baş paragraf, sayfanın kaynak kodunda bunların altında olsa bile, ana paragrafın ana fotoğraf veya bilgi kutusunun üzerine yerleştirilmesi dahil olmak üzere, özellikle bölüm daraltma ve içeriğin yeniden düzenlenmesi ve kaldırılması.
• mobil altbilgiyi basitleştirir ve bir masaüstü/mobil site bağlantısı ekler,
• mobil uyumlu olmayan özel sayfaların değiştirilmesini sağlar: Special:History, Special:Contributions, Special:Watchlist, Special:Preferences, Special:MobileDiff
• Special:Nearby, Special:MobileOptions (mobil görünüm tercihleri ​​için), Special:MobileLanguages (dil seçimi için) özel sayfalarını sağlar,
• anonim kullanıcılar için deneysel özellikler eklemek için bir özellik yönetim sistemi içeren bir beta modu sağlar.

Bu sayfa, onu geliştirme örneklerine yüklemek isteyen son kullanıcılar için tasarlanmıştır. Bunu oluşturmamıza ve geliştirmemize yardımcı olmak istiyorsanız, sizi katılmanıza teşvik ediyoruz.

Ön koşullar

• MediaWiki gerektirmese de, PHP'nin bu uzantının çalışması için mbstring desteğine sahip olması gerekir (görev T62174).

MobileFrontend'i kurmadan önce, şablonları ve/veya satır içi stilleri (stil niteliği) yoğun şekilde kullanırsanız, içeriğinizi mobil uyumlu olup olmadığını görmek için incelemelisiniz. TemplateStyles uzantısı, mobil ve masaüstünde güzel bir şekilde işlenmesi için içeriği şekillendirmek için kullanılabilir. MobileFrontend bunu sizin için sihirli bir şekilde düzeltmeyecek!

Özellikle açılış sayfanızı (ana sayfanızı) incelemek isteyebilirsiniz. Mobil ana sayfa biçimlendirmesi sayfasına bakın.

Kurulum

• Vagrant kullanıyorsanız, vagrant roles enable mobilefrontend --provision ile yükleyin

Manüel kurulum

• Download and place the file(s) in a directory called MobileFrontend in your extensions/ folder.
• LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:

  wfLoadExtension( 'MobileFrontend' );
  

• Gerekirse uygun şekilde yapılandırın
•  Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

Yakın Kurulum

MobileFrontend, Küçük bir yapılandırma ile Special:Nearby sayfasını sağlar. Bunun işe yaraması için birkaç isteğe bağlı adım gereklidir:

1. Tarayıcı güvenliği nedeniyle, SSL üzerinden güvenli bir site çalıştırmanız gerekecektir. HTTP üzerinden bir kullanıcının konumunu talep etmek mümkün değildir.
2. GeoData uzantıyı kurun
3. update.php çalıştırın
4. LocalSettings.php'de $wgMFNearby = true; ekleyin
5. Madde koordinatlarını belirleyin:
   1. coordinates ayrıştırıcı işlevini kullanarak maddelerinize konum verileri ekleyin, örneğin {{#coordinates:37.786971|-122.399677|primary}}. Sözdizimi ayrıntıları için, GeoData belgelerine bakın.
   2. Alternatif olarak LocalSettings.php dosyanıza $wgMFNearbyEndpoint ayarlayarak Yakındaki için ayrı bir MediaWiki kurulumu kullanabilirsiniz. Örneğin, $wgMFNearbyEndpoint = 'https://en.m.wikipedia.org/w/api.php';, İngilizce Vikipedi maddelerin koordinatlarını kullanacaktır. Yakındaki uç nokta, belirli bir konumla ilgili içeriği bulmak için kullanılacaktır.

Bir görünüm kurun

MobileFrontend, mevcut masaüstü web sitenizin yanında gidebilmeniz için mobil olarak biçimlendirilmiş bir web sitesi sağlar. Onu istediğiniz gibi kaplayabilirsiniz.

// Şunlardan birini seçin ve seçilen kodu LocalSettings.php dosyasının altına ekleyin:
wfLoadSkin( 'MinervaNeue' );
$wgMFDefaultSkinClass = 'SkinMinerva'; // Minerva görünümü kullanın (Ayrı olarak indirip yüklemeniz gerekir, aksi takdirde bir istisna alırsınız)
wfLoadSkin( 'Vector' );
$wgMFDefaultSkinClass = 'SkinVector'; // Vector görünümü kullanın
wfLoadSkin( 'Timeless' );
$wgMFDefaultSkinClass = 'SkinTimeless'; // Timeless görünümü kullanın

Aşağıdaki görünümler MobileFrontend ile uyumludur:

• Skin:Minerva Neue (kararlı, WMF vikilerinde varsayılan)
• Skin:Vector (varsayılan masaüstü görünümü, mobil için deneysel bir yanıt modu kullanır)
• Skin:Timeless (deneysel görünüm)

Yapılandırma ayarları

Extension:MobileFrontend/Yapılandırma sayfasına bakın

Ek ince ayarlar

Bu isteğe bağlı uyumlu uzantıları ekleyerek MobileFrontend'den en iyi şekilde yararlanın:

• Extension:GeoData - Special:Nearby alın ve maddelerinize coğrafi etiket ekleyin.
• Extension:PageImages - Aramaya ve yakındaki sonuçlara resimler ekler.
• Extension:VisualEditor - Mobil deneyiminize görsel düzenleme ekleyin.

Yerel özelleştirmeler

CSS stili

Mobil temanıza CSS uygulamak için, MediaWiki:Common.css'nin karşılığı olan MediaWiki:Mobile.css' sayfasını düzenleyin. Stil sayfasının çalışması için MediaWiki:Mobile.js dosyanıza mw.loader.using('mobile.site.styles') eklemeniz gerekebilir.

MobileFrontend, küresel MediaWiki:Common.css'yi yüklemez, kullanıcı stil sayfalarından herhangi birini de yüklemez.

Daha fazla bilgi

Mobil uzantıyı bir masaüstü tarayıcısında test etmek isterseniz veya cihazınız mobil sürümü oluşturmuyorsa, aşağıdaki anahtar/değer çiftini URL sorgu dizesine ekleyebilirsiniz: ?useformat=mobile. Örneğin: https://en.wikipedia.org/wiki/Chuck_Schuldiner?useformat=mobile

Uzantıyı sitenin tamamında etkinleştirmeden bir sayfanın mobil sürümünü görüntülemek isterseniz, dizeyi o sayfaya da URL'ye ekleyebilirsiniz.

MobileFrontend'in eski özellikleri

MobileFrontend geleneksel olarak çok büyük bir uzantı olmuştur. Birçok özellik ya gereksinimlerini aştı ya da gelecekteki bir tarihte işe yarayacak. Bunlar aşağıda listelenmiştir.

API

API'ler MobileFrontend uzantısı tarafından sağlanır, ancak uzun vadede bunları kullanımdan kaldırarak Sayfa İçerik Hizmeti kullanacağımızı umuyoruz. Bu API'leri kendi sorumluluğunuzda kullanın. Kaybolabilirler (yine de, kaybolduklarında size yeterince haber vereceğiz)!

MobileView API'si

Extension:MobileFrontend/MobileViewAPI sayfasına bakın.

Genişletilmiş action=parse

action=parse ekstra parametreleri kabul eder:

mobileformat=

Oluşturulan sayfanın HTML'sini mobil biçimde 1.23+ döndürün. MediaWiki 1.23'ten önce, modern telefonlar için HTML çıkışı almak üzere mobileformat=html veya aptal telefonlar için WML çıkışı almak üzere mobileformat=wml belirtebiliyordunuz (ayrıntılar için posta listesi mesajına bakın).

noimages

Mobil çıkışdaki resimlerini devre dışı bırakın.

mainpage

Mobil ana sayfa dönüşümlerini uygulayın.

Örnek:

api.php?action=parse&page=Therion_(band)&mobileformat=&prop=text [ApiSandbox'ta deneyin]

meta=siteinfo

Sitenin mobil sürümünün etki alanı (normal etki alanıyla aynı olabilir veya olmayabilir) genel site bilgisi bilgilerinin mobileserver anahtarı altında mevcuttur.

Geliştiriciler/sistem hizmetlileri için

Kurulum

Uzantı ile ne yaptığınıza bağlı olarak, npm install çalıştırmanız ve precommit kancasını çalıştırmak için php composer'ı kurmanız gerekebilir.

Yabancı bir vikideki maddeletle test etme (canlı veriler)

MobileFrontend artık diğer MediaWiki örneklerinden makaleler oluşturmak için yerel olarak yapılandırılabilir. Bu, çeşitli şablonlara ve Wikibase tanımlayıcılarına bağımlı olabilecek maddeleri üretimden yerel örneğinize aktarmak yerine sorunları yerel olarak ayıklamanıza yardımcı olabilir. Bu, üretim kullanımı için tavsiye edilmez.

Aşağıdaki kod yerel MediaWiki mobil sitenizi bir Vikigezgin görüntüleyicisine dönüştürecektir:

$wgMFContentProviderClass = 'MobileFrontend\ContentProviders\MwApiContentProvider';
$wgMFMwApiContentProviderBaseUri = 'https://en.m.wikivoyage.org/w/api.php';

Bu, wgMFDefaultSkinClass yapılandırma seçeneğini kullanarak farklı mobil görünümleri test etmek için özellikle yararlıdır.

Mobil görünümü kullanma

WMF siteleri

Wikimedia Vakfı tarafından işletilen sitelerde, cihazınızın kullanıcı aracısını kontrol etmek için Varnish önbellekleme sunucularını kullanıyoruz.

WMF olmayan siteler

WMF olmayan siteler için, yapılandırmanızı WMF'de işlerin nasıl yapıldığını taklit edecek şekilde ayarlayabilir (proxy katmanında cihaz algılama ve belirli X-Device başlıklarını ayarlama) veya yalnızca "?useformat=mobile" bir maddeyi mobil görünümü kullanmak üzere değiştirmek için kullanabilirsiniz.

Anlık görüntü sürüm 1.28'den başlayarak, varsayılan $wgMFMobileHeader, X-WAP'tan X-Subdomain'e değiştirildi. $wgMFMobileHeader = 'X-WAP'; ayarlayabilir veya eşleştikleri sürece önbellek (Varnish) başlık ayarınızı değiştirebilirsiniz.

SSS

Aşağıdaki sorular sıklıkla tartışma sayfamızda görünür. Lütfen bunlar hakkında tartışma sayfasında yayımlamadan önce bu listeyi kontrol edin veya açıklama almak için varsa mevcut tartışma konusunu kullanın.

S: Minerva görünümünün ana menüsünü nasıl özelleştirebilirim?

C: Bu Phabricator'da izleniyor ancak Topic:Tiggc18fvd3stmsf geçici bir çözüme sahip bakabilirsiniz.

S: Örneğin reklamlar veya ek betik etiketleri eklemek için Minerva görünümüne HTML'yi nasıl eklerim?

C: Görünüm için şablon dosyasını düzenleyerek bunu yapabilirsiniz (şu anda include/skins/minerva.mustache). Ayrıntılar için bu tartışmaya bakın.

S: Kullandığım uzantı MobileFrontend üzerinde çalışmıyor. Neden?

C: Muhtemelen uzantı eski ve MobileFrontend'e uyumluluk eklemesi gerekiyor. Lütfen uzantının geliştiricisiyle iletişime geçin ve onları ResourceLoader/MobileFrontend dostu ResourceLoader modülü yazma sayfasına yönlendirin. Lütfen tartışma sayfasına mesaj göndermeyin, bu durumda daha hızlı yanıt almak için Phabricator'da bir hata bildirmek (MediaWiki.org kullanıcı adınızı kullanarak oturum açabilirsiniz) daha iyi olur.

S: MobileFrontend'i yükselttim ve şimdi ölümcül bir istisna yaşıyorum!

C: Muhtemelen MobileFrontend ve MediaWiki'nin uyumsuz sürümlerini kullanıyorsunuz. Çoğu durumda size burada yardımcı olamayız. Sorununuzu çözmek için MobileFrontend veya MediaWiki'yi yükseltmeyi deneyin.

S: MediaWiki'yi yükselttikten sonra bir istisna alıyorum wgMFDefaultSkinClass doğru kurulmamış.

C: MobileFrontend şu anda Minerva Neue görünümün kurulu olduğunu varsaymaktadır. Bunu yapmazsanız, bunu yüklemeniz veya mobil görünümünüzü yukarıdaki talimatlara göre yapılandırmanız gerekir.

Uzantı Geliştiricileri İçin

Varsayılan olarak, uzantılardaki kaynak modülleri mobil görünümde yüklenmeyecektir.

Mobil görünümde iken bir modülün yüklenmesi gerekirse MobileFrontend uyumlu modüller yazma hakkındaki bu kılavuz yardımcı olacaktır.

Ayrıca bakınız

• MobileFrontend tarafından desteklenen mobil web tarayıcıları
• Extension:TextExtracts
• Wikimedia'nın MobileFrontend yapılandırma dosyası
• Commons:Category:MediaWiki extension MobileFrontend