Extension:MobileFrontend

This page is a translated version of the page Extension:MobileFrontend and the translation is 96% complete.
Outdated translations are marked like this.
Other languages:
Canadian English • ‎Deutsch • ‎English • ‎Tiếng Việt • ‎español • ‎français • ‎polski • ‎português • ‎português do Brasil • ‎русский • ‎中文 • ‎日本語 • ‎한국어

L'extension MobileFrontend :

  • Crée un site séparé dédié aux mobiles, pour le trafic utilisant des appareils mobiles,
    • Les administrateurs système peuvent fournir un habillage différent, par exemple Minerva Neue.
  • fournit des transformations de contenu variées afin de rendre votre contenu plus sympathique,
    • Plus particulièrement le repli des sections ainsi que le réarrangement de contenu ou sa suppression.
  • simplifie le bas de page sur les mobiles et ajoute un lien vers les versions bureau et mobile du site.
  • fournit un moyen de se substituer aux pages spéciales qui ne sont pas adaptées aux mobiles: Special:History, Special:Contributions, Special:Watchlist, Special:Preferences, Special:MobileDiff
  • fournit les pages spéciales Special:Nearby, Special:MobileOptions (pour les préférences d'habillage pour les mobiles), Special:MobileLanguages (pour la sélection de la langue),
  • fournit une mode bêta avec un système de gestion des fonctions pour ajouter des fonctionnalités expérimentales pour les utilisateurs anonymes.


Manuel des extensions MediaWiki
OOjs UI icon advanced.svg
MobileFrontend
État de la version : stable
MediaWiki-Vagrant MobileFrontend Extension.png
Implémentation Interface utilisateur:, Accroche
Description Fournit un affichage adapté aux équipements mobiles
Auteur(s)
Dernière version 2.3.0
Politique de compatibilité branches de version
MediaWiki 1.33+[1]
PHP 5.5.9+
Licence Licence publique générale GNU v2.0 ou supérieur
Téléchargement
README
Exemple m.mediawiki.org
  • $wgMFSearchGenerator
  • $wgMFStopRedirectCookieHost
  • $wgMFShowMobileViewToTablets
  • $wgMFStripResponsiveImages
  • $wgMFLazyLoadImages
  • $wgMFRSSFeedLink
  • $wgMFNamespacesWithLeadParagraphs
  • $wgMFAmcOutreachMinEditCount
  • $wgMFEnableMobilePreferences
  • $wgMFMobileFormatterOptions
  • $wgMFRemovableClasses
  • $wgMFContentProviderTryLocalContentFirst
  • $wgMFShowFirstParagraphBeforeInfobox
  • $wgMFMinCachedPageSize
  • $wgMFContentProviderClass
  • $wgMFVaryOnUA
  • $wgMFLogWrappedInfoboxes
  • $wgMFDisplayWikibaseDescriptions
  • $wgMFAlwaysUseContentProvider
  • $wgMFSchemaEditAttemptStepOversample
  • $wgMFDefaultSkinClass
  • $wgMFEnableJSConsoleRecruitment
  • $wgMobileFrontendFormatCookieExpiry
  • $wgMFAmcOutreach
  • $wgMFResponsiveImageWhitelist
  • $wgMFLazyLoadSkipSmallImages
  • $wgMFSearchAPIParams
  • $wgMFContentProviderScriptPath
  • $wgMFAdvancedMobileContributions
  • $wgMFEnableXAnalyticsLogging
  • $wgMFUseDesktopSpecialHistoryPage
  • $wgMFWatchlistEditCountThreshold
  • $wgMFSiteStylesRenderBlocking
  • $wgMFMcsContentProviderBaseUri
  • $wgMFUseWikibase
  • $wgMobileUrlTemplate
  • $wgMFCollapseSectionsByDefault
  • $wgMFManifestBackgroundColor
  • $wgMFEnableFontChanger
  • $wgMFManifestThemeColor
  • $wgMFEnableManifest
  • $wgMFSchemaSearchSampleRate
  • $wgMFNoMobileCategory
  • $wgMFNearby
  • $wgMFEnableWikidataDescriptions
  • $wgMFNamespacesWithoutCollapsibleSections
  • $wgMFSpecialPageTaglines
  • $wgMFNearbyRange
  • $wgMFEnableBeta
  • $wgMFBetaFeedbackLink
  • $wgMFDefaultEditor
  • $wgMFNoindexPages
  • $wgMFAutodetectMobileView
  • $wgMFUseDesktopSpecialWatchlistPage
  • $wgMFQueryPropModules
  • $wgMFNoMobilePages
  • $wgMFMwApiContentProviderBaseUri
  • $wgMFMobileHeader
  • $wgMFMobileFormatterNamespaceBlacklist
  • $wgMFSpecialCaseMainPage
Traduisez l’extension MobileFrontend sur translatewiki.net
Vérifiez la matrice des utilisations et des versions.
Problèmes Tâches ouvertes · Signalez un bogue

Cette page est conçue pour les utilisateurs terminaux qui veulent l'installer sur leur instance de développement. Si vous êtes partant pour nous aider, construisez-la et améliorez-la; nous vous encourageons à participer.

Prérequis

  • Bien que MediaWiki ne l'exige pas, PHP doit avoir la prise en charge de mbstring pour que cette extension fonctionne (tâche T62174).

Avant d'installer MobileFrontend, si vous faites un usage important des modèles et/ou de styles en ligne (c'est à dire de l'attribut style) vous devez vérifier votre contenu afin qu'il soit compatible avec l'affichage sur mobiles. L'extension TemplateStyles peut être utilisée pour mettre en forme le contenu pour qu'il apparaisse plus agréablement sur les mobiles et les bureaux. MobileFrontend ne corrigera pas cela à votre place par magie !

En particulier, si vous désirez relire votre page d'arrivée (page d'accueil). Voir le Format de la page d'accueil pour mobiles.

Installation

  • Si vous utilisez Vagrant , installez avec vagrant roles enable mobilefrontend --provision
Installation manuelle
  • Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé MobileFrontend dans votre dossier extensions/.

Configurer Nearby

MobileFrontend fournit la page Special:Nearby avec un petit paramètrage. Pour que celle-ci puisse fonctionner, certaines étapes facultatives sont nécessaires :

  1. A cause de la sécurité des navigateurs, vous devrez exécuter votre site sécurisé sous SSL — il n'est pas possible de demander l'emplacement d'un utilisateur sur HTTP.
  2. Installez l'extension GeoData
  3. Exécutez update.php
  4. Dans LocalSettings.php ajoutez $wgMFNearby = true;
  5. Déterminez les coordonnées de l'article :
    1. Ajoutez des données à vos articles à une ou plusieurs pages {{#coordinates:37.786971|-122.399677|primary}}. Voir la documentation de $geodata pour les détails de la syntaxe. For syntax details, see the documentation for GeoData .
    2. Alternativement vous pouvez utiliser une installation MediaWiki séparée pour Nearby en déclarant $wgMFNearbyEndpoint dans votre fichier LocalSettings.php . Par exemple, $wgMFNearbyEndpoint = 'https://en.m.wikipedia.org/w/api.php'; utilisera les coordonnées des articles de la Wikipedia anglaise. Le point de proximité sera utilisé pour trouver le contenu relatif à un emplacement donné.

Configurer un habillage

MobileFrontend vous fournit un site web formaté pour les mobiles, qui reste cohérent avec le site existant pour le bureau. Vous pouvez y changer l'habillage comme vous le voulez.

 // 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

Les habillages suivants sont compatibles avec MobileFrontend :

  • Minerva Neue (stable, par défaut sur les wikis de la WMF)
  • Vector (habillage par défaut pour le bureau, utilise un mode expérimental dynamique pour les mobiles)
  • Timeless (habillage expérimental)

Paramètres de configuration

Voir Extension:MobileFrontend/Configuration

Ajustements supplémentaires

Obtenir le meilleur de MobileFrontend en ajoutant ces dépendances facultatives supplémentaires :

Personalisations locale

Mise en forme CSS

Pour appliquer le CSS à votre thème mobile, modifiez MediaWiki:Mobile.css, la contrepartie de MediaWiki:Common.css.

MobileFrontend ne charge aucun des fichiers MediaWiki:Common.css globaux, ni aucune des feuilles de style de l'utilisateur.

En savoir plus

Si vous souhaitez tester l'extension mobile sur un navigateur de bureau ou si votre appareil ne gère pas la version mobile, vous pouvez ajouter la paire clé-valeur suivante à la chaîne de la requête : ?useformat=mobile, par exemple, https://en.wikipedia.org/wiki/Chuck_Schuldiner?useformat=mobile

Si vous désirez afficher une page en bêta sans l'activer sur tout le site, vous pouvez ajouter la chaîne de requête de n'importe quelle page.

Anciennes fonctions de MobileFrontend

MobileFrontend a été traditionnellement une très grosse extension. Beaucoup de fonctionnalités ont soit surpassé leurs besoins ou vont le faire à une date prochaine. Elles sont listées ci-dessous.

API

Les APIs sont fournies par l'extension MobileFrontend, mais à long terme nous espérons les rendre obsolètes en faveur du service de contenu mobile. Utilisez ces APIs à vos propres risques. Elles peuvent disparaître (bien que nous vous fournirons assez d'informations en temps voulu) !

API MobileView

Voir Extension:MobileFrontend/MobileViewAPI .

action=parse étendu

action=parse accepte les paramètres supplémentaires :

mobileformat=
Renvoie la page HTML générée dans un format pour mobiles 1.23+. Avant MediaWiki 1.23, vous pouviez spécifier mobileformat=html pour générer le HTML pour les téléphones modernes ou mobileformat=wml pour générer le WML pour les téléphones muets (lire le message de la liste de diffusion pour les détails).
noimages
Désactive les images pour la sortie mobile.
mainpage
Applique les transformations sur la page d'accueil pour les mobiles.

Exemple :

meta=siteinfo

Le domaine de la version mobile du site (qui peut être ou pas, le même que le domaine standard) est disponible sous la clé mobileserver dans les informations générales siteinfo.

Pour les développeurs/administrateurs système

Configuration

Il se peut que vous deviez exécuter npm install et installer PHP Composer pour que l'accroche avant validation puisse fonctionner, au regard de ce que vous faites avec l'extension.

Tester avec les articles d'un wiki externe (données actuelles)

MobileFrontend peut maintenant être configuré localement pour générer les articles à partir d'autres instances de MediaWiki.[2] Cela peut vous aider à déboguer les problèmes localement au lieu d'importer les articles qui peuvent avoir des dépendances sur divers modèles et identifiants Wikibase de la production à votre instance locale. Ceci n'est pas recommandé dans l'environnement de production.

Le code ci-dessous va transformer votre site mobile MediaWiki local en un afficheur Wikivoyage :

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

Ceci est particulièrement utile pour tester différents habillages pour mobile en utilisant l'option de configuration wgMFDefaultSkinClass.

Utiliser l'affichage pour mobiles

Sites WMF

Sur les sites de la Fondation Wikimedia, nous utilisons les serveurs de cache Varnish pour vérifier l'agent utilisateur de votre appareil.

Sites non-WMF

Pour les sites non WMF, vous pouvez soit faire votre configuration en imitant la façon dont les choses se font au WMF (faire la détection de périphérique au niveau de la couche proxy et définir des en-têtes X-Device spécifiques), ou vous pouvez simplement utiliser ?Useformat=mobile pour forcer un article à utiliser la vue mobile.

A partir de l'instantané de la version 1.28, la valeur par défaut $wgMFMobileHeader a été changée de X-WAP en X-Subdomain. Vous pouvez soit initialiser $wgMFMobileHeader = 'X-WAP'; ou modifier les paramètres de l'entête du cache (Varnish). Aussi longtemps qu'ils correspondent.

FAQ

Les questions suivantes apparaissent fréquemment sur notre page de discussion. Veuillez vérifier cette liste avant de publier le sujet sur la page de discussion, ou utilisez le sujet de discussion existant, pour recevoir des clarifications.

Question: comment personnaliser le menu principal de l'habillage Minerva ?

Réponse : ceci est suivi dans Phabricator mais vous pouvez voir Topic:Tiggc18fvd3stmsf une solution intermédiaire.

Question: comment puis-je ajouter du code HTML à l'habillage Minerva, par exemple pour introduire des annonces ou des balises de script supplémentaires ?

Réponse : vous pouvez faire cela en modifiant le fichier du modèle (actuellement include/skins/minerva.mustache). Voir cette discussion pour les détails.

Question: l'extension que j'utilise semble ne pas fonctionner sous MobileFrontend. Pourquoi ?

Réponse : il est vraisemblable que l'extension est ancienne et a besoin de compatibilité avec MobileFrontend. Veuillez contacter les développeurs de l'extension en les orientant vers l'écriture d'un module ResourceLoader compatible MobileFrontend. Veuillez ne pas publier sur la page de discussion, car dans ce cas, il serait préférable de rapporter le bogue sur Phabricator (vous pouvez vous connecter en utilisant votre nom d'utilisateur MediaWiki.org) pour une réponse plus rapide.

Question: j'ai mis à jour MobileFrontend et maintenant j'obtient une exception fatale !

Réponse : Vous utilisez probablement des versions incompatibles de MobileFrontend et MediaWiki. Dans la plupart des cas, nous ne pouvons pas vous aider ici. Essayez de faire la mise à jour de MobileFrontend ou de MediaWiki pour résoudre votre problème.

Question: après avoir fait la mise à jour de MediaWiki j'obtiens l'exception que wgMFDefaultSkinClass n'est pas configuré correctement.

Réponse : MobileFrontend suppose actuellement que l'habillage Habillage:Minerva Neue a été installé. Sinon, vous devrez installer ceci ou configurer votre habillage mobile à l'aide des instructions ci-dessus.

Pour les développeurs d'extensions

Par défaut, les modules de ressources des extensions ne seront pas chargés dans les affichages pour mobiles.

Si un module doit être chargé dans la vue mobile le guide sur l'écriture des modules compatibles MobileFrontend vous aidera.

Voir aussi

Références

  1. :Fatal error: Uncaught ExtensionDependencyError: MobileFrontend is not compatible with the current MediaWiki core (version 1.32.2), it requires: >= 1.33.0.
  2. Voir cette vidéo de démonstration YouTube