Table des matières
Syndiquer son forum
Avec SMF, il est tout à fait possible de syndiquer son contenu. Ce qui est désigné par le terme “syndication” est le fait d'activer des fils RSS ou flux RSS (en anglais, RSS feeds). Un flux ou fil RSS correspond à un fichier dynamique, mis à jour en permanence, qui récupère certaines informations de votre site, blog, forum, … Ce système est aujourd'hui très répendu, car il est très avantageux pour l'utilisateur et le webmestre. Pour syndiquer un forum dans des pages externes localisées dans un même domaine, voir Utilisation de SSI.php.
Activer le flux RSS
Sous SMF 1.0:
- Rendez-vous dans votre Centre d'administration ⇒ Configuration des caractéristiques et options
- Dans la rubrique
Caractéristiques de Base du Forum, cochez la case Activer les nouvelles aux formats XML/RSS. - Optionnellement, vous pouvez aussi limiter le nombre de caractères par message dans la case Longueur maximale des messages. Entrez
0pour ne pas limiter le nombre de caractères par message. Par défaut, le paramètre est réglé sur255caractères. - Enregistrez les changements.
Sous SMF 1.1:
- Rendez-vous dans votre Centre d'administration ⇒ Nouvelles et infolettres
- Cliquez sur l'onglet Paramètres.
- Cochez la case Activer les flux XML/RSS.
- Optionnellement, vous pouvez aussi limiter le nombre de caractères par message dans la case Longueur maximale des messages. Entrez
0pour ne pas limiter le nombre de caractères par message. Par défaut, le paramètre est réglé sur255caractères. - Enregistrez les changements.
Votre fil RSS est désormais accessible par l'URL http://www.votresite.com/votre_forum/index.php?action=.xml;type=rss. Affichez cette adresse sur votre site ou donnez-la à ceux qui vous la demande afin qu'ils puissent ajouter votre flux dans leur aggrégateur.
Annoncer son fil
Annoncer votre fil RSS signifie d'ajouter l'URL de votre flux RSS dans l'entête <head> de votre site. Cette opération a plusieurs avantages. Avec une URL incomplète, les aggrégateurs tenteront de détecter par eux-mêmes l'adresse complète vers un flux RSS. Certains navigateurs, comme Mozilla Firefox et Opera, détecteront aussi automatiquement votre fil et en indiqueront l'existance par une icône.
Sous Mozilla Firefox, lorsqu'il détecte un flux RSS, l'icône suivante apparaît dans le coin inférieur droit du navigateur:
Sous Opera, la présence d'un flux RSS est indiqué par la présence d'une icône dans la barre d'adresse du navigateur:
Mais comment annoncer son fil RSS dans l'entête de son forum? La procédure est très simple:
- À l'aide d'un éditeur de texte simple, ouvrez le fichier
/Themes/votre_thème/index.template.php. - Recherchez le code suivant:
// Show all the relative links, such as help, search, contents, and the like. echo ' <link rel="help" href="', $scripturl, '?action=help" target="_blank" /> <link rel="search" href="' . $scripturl . '?action=search" /> <link rel="contents" href="', $scripturl, '" />';
- Au-dessous, ajoutez ceci:
// If RSS/XML news is enabled, indicate that an RSS feed is available if (!empty($modSettings['xmlnews_enable'])) echo ' <link rel="alternate" type="application/rss+xml" title="RSS" href="', $scripturl, '?action=.xml;type=rss" />';
- Enregistrez vos modifications.
Fonctions avancées
Ce qui a été décrit précédemment est la base, le strict minimum pour activer et annoncer son flux RSS sous SMF. Toutefois, vous pouvez passer des paramètres supplémentaires à l'URL de votre flux pour accéder à des fonctions supplémentaires. Les paramètres s'ajoutent à la fin de l'URL. Par exemple:
<a href="http://www.simplemachines-fr.org/forum/index.php?action=.xml;type=rss2;sa=news">http://www.simplemachines-fr.org/forum/index.php?action=.xml<span style="color: green; font-weight: bold">;type=rss2;sa=news</span></a>
Chaque paramètre (à l'exception du type de flux) peut être omis. S'il n'est pas renseigné, alors la valeur par défaut est utilisée. Les paramètres sont séparés par des point-virgules (;). Ci-dessous sont décrits les différents paramètres qu'il est possible de renseigner dans l'URL.
Type de flux [obligatoire]
- Paramètre:
type=[rss|rss2]
Le paramètre type vous permet de choisir le format dans lequel est publié votre fil. Deux formats sont disponibles: RSS 0.93 (rss) ou RSS 2.0 (rss2). Privilégiez le format RSS 0.93 si votre agrégateur ne comprend pas le format RSS 2.0. Si le paramètre type n'est pas renseigné dans l'URL de votre fil, vous obtiendrez très certainement des erreurs dans votre agrégateur et vous ne serez pas capable de récupérer les informations en provenance de votre forum.
Afficher les messages récents
- Fonction: Afficher les plus récentes interventions sur votre forum
- Paramètre:
sa=recent - Comportement par défaut: Afficher les 5 derniers messages postés dans l'ensemble du forum
- Paramètres optionnels:
limit=X: limiter le nombre de messages à récupérer à X messages (X > ou = 5 et < ou = 255)board=Y: limiter la récupération des dernières interventions à la section dont l'ID est Y
Si aucun paramètre supplémentaire n'a été renseigné, c'est le comportement par défaut.
Afficher les sujets récents (genre nouvelles)
- Fonction: Afficher le premier message des sujets les plus récents sur votre forum
- Paramètre:
sa=news - Comportement par défaut: Afficher les 5 derniers sujets postés dans l'ensemble du forum
- Paramètres optionnels:
limit=X: limiter le nombre de messages à récupérer à X messages (X > ou = 5 et < ou = 255)board=Y: limiter la récupération des dernières interventions à la section dont l'ID est Y
Afficher les derniers membres inscrits
- Fonction: Afficher les derniers membres s'étant inscrits sur votre forum
- Paramètre:
sa=members - Comportement par défaut: Afficher les 5 derniers membres inscrits
- Paramètre optionnel:
limit=X: limiter le nombre membres à afficher
Afficher un profil
- Fonction: Afficher le profil d'un membre de votre forum
- Paramètre:
sa=profile - Paramètre supplémentaire requis:
u=X: Afficher le profil du membre X