Extension:MobileFrontend

This page is a translated version of the page Extension:MobileFrontend and the translation is 68% complete.
Other languages:
Deutsch • ‎English • ‎Tiếng Việt • ‎Türkçe • ‎español • ‎français • ‎polski • ‎português • ‎português do Brasil • ‎svenska • ‎русский • ‎中文 • ‎日本語 • ‎한국어

MobileFrontend uzantısı:

  • Mobil trafiğiniz için ayrı bir mobil site oluşturur,
  • içeriğinizi daha uyumlu hale getirmek için çeşitli içerik dönüşümleri sağlar,
    • Ö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.


MediaWiki manüel uzantıları
OOjs UI icon advanced.svg
MobileFrontend
Sürüm durumu: kararlı
MediaWiki-Vagrant MobileFrontend Extension.png
Uygulama Kullanıcı arayüzü, Kanca
Açıklama Mobil uyumlu bir görünüm sağlar
Yazar(lar)
En son sürüm 2.3.0
Uyumluluk politikası sürüm dalları
MediaWiki 1.33+[1]
PHP 5.5.9+
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
README
Örnek m.mediawiki.org
  • $wgMFSearchGenerator
  • $wgMFStopRedirectCookieHost
  • $wgMFShowMobileViewToTablets
  • $wgMFStripResponsiveImages
  • $wgMFLazyLoadImages
  • $wgMFRSSFeedLink
  • $wgMFNamespacesWithLeadParagraphs
  • $wgMFAmcOutreachMinEditCount
  • $wgMFEnableMobilePreferences
  • $wgMFMobileFormatterOptions
  • $wgMFRemovableClasses
  • $wgMFContentProviderTryLocalContentFirst
  • $wgMFShowFirstParagraphBeforeInfobox
  • $wgMFMinCachedPageSize
  • $wgMFContentProviderClass
  • $wgMFVaryOnUA
  • $wgMFLogWrappedInfoboxes
  • $wgMFDisplayWikibaseDescriptions
  • $wgMFAlwaysUseContentProvider
  • $wgMFNoMobilePages
  • $wgMFSchemaEditAttemptStepOversample
  • $wgMFEnableJSConsoleRecruitment
  • $wgMobileFrontendFormatCookieExpiry
  • $wgMFAmcOutreach
  • $wgMFResponsiveImageWhitelist
  • $wgMFLazyLoadSkipSmallImages
  • $wgMFSearchAPIParams
  • $wgMFContentProviderScriptPath
  • $wgMFAdvancedMobileContributions
  • $wgMFEnableXAnalyticsLogging
  • $wgMFUseDesktopSpecialHistoryPage
  • $wgMFWatchlistEditCountThreshold
  • $wgMFSiteStylesRenderBlocking
  • $wgMFMcsContentProviderBaseUri
  • $wgDefaultMobileSkin
  • $wgMobileUrlTemplate
  • $wgMFCollapseSectionsByDefault
  • $wgMFManifestBackgroundColor
  • $wgMFEnableFontChanger
  • $wgMFManifestThemeColor
  • $wgMFEnableManifest
  • $wgMFSchemaSearchSampleRate
  • $wgMFNoMobileCategory
  • $wgMFNearby
  • $wgMFEnableWikidataDescriptions
  • $wgMFUseWikibase
  • $wgMFSpecialPageTaglines
  • $wgMFNearbyRange
  • $wgMFNamespacesWithoutCollapsibleSections
  • $wgMFBetaFeedbackLink
  • $wgMFDefaultEditor
  • $wgMFEnableBeta
  • $wgMFNoindexPages
  • $wgMFUseDesktopSpecialWatchlistPage
  • $wgMFAutodetectMobileView
  • $wgMFQueryPropModules
  • $wgMFMwApiContentProviderBaseUri
  • $wgMFTrackBlockNotices
  • $wgMFMobileFormatterNamespaceBlacklist
  • $wgMFMobileHeader
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

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

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.

 // Choose one of these and add chosen code to bottom of LocalSettings.php file:
 wfLoadSkin( 'MinervaNeue' );
 $wgMFDefaultSkinClass = 'SkinMinerva'; // use Minerva skin (You need to download and install it separately, otherwise you'll get an exception)
 wfLoadSkin( 'Vector' );
 $wgMFDefaultSkinClass = 'SkinVector'; // use Vector skin
 wfLoadSkin( 'Timeless' );
 $wgMFDefaultSkinClass = 'SkinTimeless'; // use Timeless skin

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

Yapılandırma ayarları

Extension:MobileFrontend/Configuration sayfasına bakın

Ek ince ayarlar

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

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.

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 Mobil İç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:

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.[2] 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.

The code below will turn your local MediaWiki mobile site into a Wikivoyage viewer:

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

This is particularly useful for testing different mobile skins using the wgMFDefaultSkinClass config option.

Using the mobile view

WMF sites

On Wikimedia Foundation-run sites, we use Varnish caching servers to check the user agent of your device.

Non-WMF sites

For non-WMF sites, you can either set up your configuration to mimic how things are done at the WMF (doing device detection at the proxy layer and setting specific X-Device headers), or you can simply use "?useformat=mobile" to switch an article to use the mobile view.

Starting from the snapshot version 1.28, the default $wgMFMobileHeader was changed from X-WAP to X-Subdomain. You could either set $wgMFMobileHeader = 'X-WAP'; or modify your cache (Varnish) header setting, as long as they match.

FAQ

The following questions frequently appear on our talk page. Please check this list before posting about them on the talk page or use the existing talk topic, if available, to receive clarifications.

Q: How do I customise the main menu of the Minerva skin?

A: This is tracked in phabricator but you can see Topic:Tiggc18fvd3stmsf has an interim solution.

Q: How do I add HTML to the Minerva skin, for example to add ads or additional script tags?

A: You can do this by editing the template file for the skin (currently include/skins/minerva.mustache). See this discussion for details.

Q: The extension I am using doesn't seem to work on MobileFrontend. Why?

A: It's likely the extension is old and needs to add compatibility to MobileFrontend. Please contact the developer of the extension and point them to ResourceLoader/Writing a MobileFrontend friendly ResourceLoader module. Please do not post to the talk page, as in this case it would be better to file a bug on Phabricator (you can login using your MediaWiki.org username) for a quicker response.

Q: I upgraded MobileFrontend and now I'm getting a fatal exception!

A: You are probably using incompatible versions of MobileFrontend and MediaWiki. In most cases, we can't help you here. Try upgrading MobileFrontend or MediaWiki to resolve your issue.

Q: After upgrading MediaWiki I'm getting an exception wgMFDefaultSkinClass is not setup correctly.

A: MobileFrontend currently assumes you have the Minerva Neue skin installed. If you don't you'll need to install this or configure your mobile skin per instructions above.

For Extension Developers

By default resource modules in extensions will not be loaded in mobile view.

Should a module need to be loaded while in mobile view this guide on writing MobileFrontend friendly modules will be of help.

See also

References

  1. :Fatal error: Uncaught ExtensionDependencyError: MobileFrontend is not compatible with the current MediaWiki core (version 1.32.2), it requires: >= 1.33.0.
  2. Bu YouTube demo videosuna bakın