====== 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 [[SSI]]. ===== 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 ''0'' pour ne pas limiter le nombre de caractères par message. Par défaut, le paramètre est réglé sur ''255'' caractè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 ''0'' pour ne pas limiter le nombre de caractères par message. Par défaut, le paramètre est réglé sur ''255'' caractères. * Enregistrez les changements. Votre fil RSS est désormais accessible par l'URL [[http://www.simplemachines.org/community/index.php?action=.xml;type=rss|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 '''' 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 [[http://www.getfirefox.com|Mozilla Firefox]] et [[http://www.opera.com|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:\\ {{syndication_fx.png}} 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:\\ {{syndication_opera.png}} \\ **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 '
	
	
	';

* Au-dessous, ajoutez ceci:

	// If RSS/XML news is enabled, indicate that an RSS feed is available
	if (!empty($modSettings['xmlnews_enable']))
		echo '
		';

* 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: http://www.simplemachines-fr.org/forum/index.php?action=.xml;type=rss2;sa=news 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 * //Exemple:// [[http://www.simplemachines-fr.org/forum/index.php?action=.xml;sa=recent;limit=10;board=1|http://www.simplemachines-fr.org/forum/index.php?action=.xml;sa=recent[;limit=10;board=1]]] 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 * //Exemple:// [[http://www.simplemachines-fr.org/forum/index.php?action=.xml;sa=news;limit=10;board=1|http://www.simplemachines-fr.org/forum/index.php?action=.xml;sa=news[;limit=10;board=1]]] ==== 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 * //Exemple:// [[http://www.simplemachines-fr.org/forum/index.php?action=.xml;sa=members;limit=10|http://www.simplemachines-fr.org/forum/index.php?action=.xml;sa=members[;limit=10]]] ==== 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 * //Exemple:// [[http://www.simplemachines-fr.org/forum/index.php?action=.xml;sa=profile;u=7|http://www.simplemachines-fr.org/forum/index.php?action=.xml;sa=profile;u=7]]