Extension: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) | |
| En son sürüm | 2.4.1 |
| Uyumluluk politikası | MediaWiki ile birlikte anlık görüntüler yayımlanır. Master geriye dönük olarak uyumlu değil. |
| MediaWiki | 1.33+[1] |
| PHP | 5.5.9+ |
| Lisans | GNU Genel Kamu Lisansı 2.0 veya üstü |
| İndir | README |
| Örnek | m.mediawiki.org |
|
|
|
|
| Translatewiki.net adresinde mevcutsa, MobileFrontend uzantısını çevirin | |
| Sorunlar | Açık görevler · Hata bildir |
MobileFrontend uzantısı:
| Bu uzantı Web ekibi tarafından sağlanmaktadır. |
Features include:
- 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,
- 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. If you are keen to help us build it and improve it we encourage you to get involved.
Ön koşullar
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
- Dosyaları indirin ve
extensions/klasörünüzdekiMobileFrontendadlı dizine yerleştirin.
Developers and code contributors should install the extension from Git instead, using:cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MobileFrontend
- LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
wfLoadExtension( 'MobileFrontend' );
- Gerekirse uygun bir ş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.
Vagrant kurulumu:
- Vagrant kullanıyorsanız,
vagrant roles enable mobilefrontend --provisionile yükleyin
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:
- 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.
- GeoData uzantıyı kurun
- update.php çalıştırın
LocalSettings.php'de$wgMFNearby = true;ekleyin- Madde koordinatlarını belirleyin:
coordinatesayrış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.- Alternatif olarak
LocalSettings.phpdosyanıza$wgMFNearbyEndpointayarlayarak 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' );
$wgDefaultMobileSkin = 'minerva'; // Minerva görünümü kullanın (1.37 ve daha eski sürümlerde ayrıca indirip yüklemeniz gerekir, aksi takdirde bir istisna alırsınız)
wfLoadSkin( 'Vector' );
$wgDefaultMobileSkin = 'vector'; // Vector görünümü kullanın
wfLoadSkin( 'Timeless' );
$wgDefaultMobileSkin = 'timeless'; // 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)
- Skin:MonoBook
- Skin:Citizen - responsive skin
Yapılandırma ayarları
Extension:MobileFrontend/Yapılandırma sayfasına bakın
All configuration options are detailed in the README.md file.
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
| MediaWiki sürümü: | ≤ 1.40 |
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/MediaWiki?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)!
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.
mainpage- Mobil ana sayfa dönüşümlerini uygulayın.
Örnek:
| Sonuç |
|---|
{
"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
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)
Extension:MobileFrontendContentProvider sayfasına bakın.
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. See Extension:MobileFrontend/Tarayıcı otomatik algılamayı yapılandırma.
$wgMFMobileHeader = 'X-WAP'; ayarlayabilir veya eşleştikleri sürece önbellek (Varnish) başlık ayarınızı değiştirebilirsiniz.Using Apache (.htaccess or httpd.conf)
To set up a mobile domain, add the following rule to .htaccess or httpd.conf
<IfModule mod_headers.c>
<If "req('Host') =~ /^mobile./i">
RequestHeader set X-Subdomain "mobile"
</If>
</IfModule>
In your hosts file (assuming your desktop site is on localhost):
127.0.0.1 mobile.localhost
In LocalSettings.php:
wfLoadExtension('MobileFrontend');
$wgMFAutodetectMobileView = true;
$wgMobileUrlCallback = fn( $domain ) => "mobile.$domain";
Now if you navigate to mobile.localhost you should see the mobile site.
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.
Q: How do I detect the mobile site in frontend code?
A: Ideally you shouldn't need to do this.
It is preferable to use mw.config.get('skin') or window.matchMedia('(max-width: 1119px)').matches to detect a mobile user.
You can also make use of the stable mw-mf class which is present on the BODY element if the mobile site is active.
If your code makes modifications to content, you may need to update your code to consider MobileFrontend markup by inspecting the DOM for presence of certain elements.
Please note while mw.config.get( 'wgMFMode' ) exists and can be used by extensions as a last resort (for now) it should not be considered stable for use by gadgets.
S: Minerva görünümünün ana menüsünü nasıl özelleştirebilirim?
C: Bu Phabricator'da izleniyor ancak Extension talk:MobileFrontend/2017#h-MODIFY THE MAIN MENU-2017-01-04T02:24:00.000Z 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.
See this discussion for details.
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
- Commons:Category:MediaWiki extension MobileFrontend
- Extension:MobileDetect
- Extension:Progressive web application - turn any wiki into a mobile app
Kaynakça
- ↑ :Fatal error: Uncaught ExtensionDependencyError: MobileFrontend is not compatible with the current MediaWiki core (version 1.32.2), it requires: >= 1.33.0.
| Bu uzantı bir veya daha fazla Wikimedia projelerinde kullanılıyor. Bu, muhtemelen uzantının kararlı olduğu ve bu tür yüksek trafikli web siteleri tarafından kullanılacak kadar iyi çalıştığı anlamına gelir. Nerede kurulduğunu görmek için bu uzantının adını Wikimedia'nın CommonSettings.php ve InitialiseSettings.php yapılandırma dosyalarında arayın. Belirli bir vikide yüklü olan uzantılar listesinin tamamı vikinin Special:Version sayfasında görülebilir. |
| This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |