Extension:FeaturedFeeds
 État de la version : stable |
|
|---|---|
 |
|
| Implémentation | Extraction de données, API, Accroche |
| Description | Ajoute des flux de syndication de contenu en vedette du wiki |
| Auteur(s) | Max Semenik (MaxSemdiscussion) |
| Dernière version | continuous updates |
| MediaWiki | 1.19+ |
| PHP | 5.4+ |
| Modifie la base de données |
Non |
| Licence | WTFPL v2.0 |
| Téléchargement | CHANGELOG |
|
|
| Téléchargements trimestriels | 6 (Ranked 133rd) |
| Utilisé par les wikis publics | 876 (Ranked 273rd) |
| Traduire l’extension FeaturedFeeds sur translatewiki.net si elle y est disponible | |
| Problèmes | Tâches ouvertes · Signaler un bogue |
FeaturedFeeds est une extension qui crée des flux quotidiens (Atom ou RSS) du contenu mis en vedette du wiki (allant des articles de qualité ou des articles en vedette aux Média du jour).
Les flux sont ajoutés à la page principale du site et sont disponibles via le module API featuredfeed. Voir aussi (en anglais) : Extension:FeaturedFeeds/WMF deployment
Utilisation des flux en vedette (FeaturedFeeds)
Cette extension exige que les wikis utilisent un processus automatisé pour publier leur contenu présenté quotidiennement (ou au moins très souvent).
Installation
- Téléchargez et placez le(s) fichier(s) dans un répertoire appelé
FeaturedFeedsdans votre dossierextensions/.
Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/FeaturedFeeds - Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
wfLoadExtension( 'FeaturedFeeds' );
Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.
Configuration
A wiki must have some means of caching set up to use FeaturedFeeds, or everything will be super slow.
Paramètres
| Variable name | Description |
|---|---|
$wgFeaturedFeeds
|
Contains array of feed definitions in the following format:
'feed name' => [
'page' => <message name>,
'title' => <message name>,
'description' => <message name>,
'entryName' => <message name>,
]
Mandatory items:
Also see below for optional settings. |
$wgFeaturedFeedsDefaults
|
Provides default values for some parameters of every feed from $wgFeaturedFeeds.
Default value: [
'limit' => 10,
'inUserLanguage' => false,
]
|
$wgDisplayFeedsInSidebar
|
Whether links to feeds should be displayed in sidebar on main page |
Configuration du site
- Voir la sous-page complète pour plus de détails sur la configuration des projets Wikimedia (en anglais)
Message names
Each feed has the following messages controlling its behavior (replace * with feed name, chosen among those above):
| Message | Description | Example |
|---|---|---|
| ffeed-*-page | Title of the page that contains day's featured content. Has one optional parameter, $1, which gets substituted with feed language code for use in multilingual feeds (currently, only on Commons).
|
Wikipedia:Today's featured article/{{#time:F j, Y}}
|
| ffeed-*-title | Feed name | Wikipedia featured articles feed |
| ffeed-*-short-title | Short feed name, could be used on sidebar in the future | Featured articles |
| ffeed-*-desc | More lengthy feed description | Best articles on Wikipedia!!! |
| ffeed-*-entry | Title of each day's entry | {{CURRENTMONTHNAME}} {{CURRENTDAY}} Wikipedia featured article
|
How to set up a feed
Create a page named MediaWiki:Ffeed-*-page containing the page title (again, replace * with the feed's name). Two cases are possible here:
- The wiki has a new page for each day, e.g. Wikipedia:Today's featured article/novembre 21, 2024 on the English Wikipedia. In such case, the title can use date and time magic words or
#timeparser functions to incorporate the date in the page title. The title in the example here isWikipedia:Today's featured article/{{#time:F j, Y}}. - The wiki uses a single template that uses date magic internally to display proper content. In such cases, either point
MediaWiki:Ffeed-*-pageto that template directly, or, if it has<noinclude>sections not intended for readers to see, point it to a page that contains a transclusion of the said template and nothing else.
If you need to translate or tweak interface messages of a feed, do that before creating
MediaWiki:Ffeed-*-page, otherwise your new feed might take up to one hour to catch up these changes.How to publish feeds in the sidebar
Just create page MediaWiki:Ffeed-enable-sidebar-links with content other than a dash (-) or an empty string. A section called "Featured content feeds" will appear in the sidebar on the main page.
Module API
www.mediawiki.org n'a pas de flux en vedette, donc la documentation de l'API générée sur ce wiki n'est pas très utile
Au lieu de cela, consultez la documentation de l'API générée sur enwiki, qui répertorie les flux qu'elle fournit et contient un exemple fonctionnel.
| Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki. |
| Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets : Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer. |