############################################################## ## MOD Title: Google Yahoo MSN Sitemaps and RSS (GYM) ## MOD Author: dcz http://www.phpbb-seo.com/ ## ## ## MOD Description: Solution modulaire pour générer des plans sitemap Google et des flux RSS 2.0 pour phpbb et mxBB PORTAL ## Ce mod va créer un SitemapIndex Google établissant la liste des Sitemaps Google installés. ## Il génère également des flux RSS 2.0 ainsi qu'une liste Yahoo urllist.txt. ## Utilise un système de cache supportant pleinement la compression Gun-zip, ## ainsi que de la mise en forme XSLTransform pour les plans de site Google et les flux RSS. ## ## MOD Version: 1.2.0RC4 ## ## Installation Level: (Easy) ## Installation Time: 2 Minutes ## Files To Edit: 1 in most cases ## language/lang_english/lang_admin.php ## Included Files: 13 ## sitemap.php, ## rss.php, ## urllist.php, ## templates/subSilver/admin/admin_mx_ggsitemap.tpl ## language/lang_english/lang_ggs_admin.php ## language/lang_english/lang_ggs_main.php ## admin/admin_mx_ggsitemap.php ## includes/ggs_functions.php ## includes/google_forum.php ## includes/rss_forum.php ## includes/yahoo_forum.php ## db_install.php ## db_uninstall.php ## ## License: http://opensource.org/licenses/gpl-license.php GNU General Public License v2 ############################################################## ## For security purposes, please check: http://www.phpbb.com/mods/ ## for the latest version of this MOD. Although MODs are checked ## before being allowed in the MODs Database there is no guarantee ## that there are no security problems within the MOD. No support ## will be given for MODs not found within the MODs Database which ## can be found at http://www.phpbb.com/mods/ ############################################################## ## Author Notes: - FR ## __________________ ## ## Vous trouverez des informations plus détaillées sur mx Google sitemaps sur http://www.phpbb-seo.com/forums/gym-sitemaps/ ## ## New in - 1.2.0RC4 ## - Séléction de la méthode de conversion UTF-8 ## - Compatible mxBB 2.8. ## New in - 1.2.0RC3 ## - Le module prende désormais en charge les autorisation de phpBB pour les flux RSS. ## - RSS 2.0 100% valide. ## - Conversion UTF-8 avancée, méthode phpBB3. ## - Gestion du style XSLT améliorée, plus de JS pour la navigation. ## - La mise en forme XSLT peut être forcée poru FF2 et IE7. ## - Bbcode, liens actifs, smilies peuvent désormais être désactivés sur les flux RSS. ## - Filtres BBcode avancé poru les flux RSS. ## - Ajout de deux méthodes de césure. ## New in - 1.2.0RC2 ## - Fix pour la censure dans les titres des plans Google. ## New in 1.2.0RC1 : ## - Le module a été totalement re-codé et renommé. ## - Ajout d'un cache pour tous les types de sorties, avec support complet Gun-zip. ## - Ajout de flux RSS 2.0. ## - Ajout de la liste yahoo! urllist.txt. ## - Ajout de moultes options dans l'ACP. ## - Optimisation du code. ## ## New in 1.0.1 : ## - Ajout de listes d'exclusions pour ne pas lister certains forums publics ## - Support pour Category hierarchy 2.1.4e (Fichier premoddé). ## ## New in 1.0.0 : ## - Rien, mise à jour de la version pour soumission à la modDB de phpbb.com ## ## New in 1.0.0RC2 : ## - Nouveau chapitre dans l'acp, pour une meilleure intégration ## le module avec mx Sitemaps. ## ## New in 1.0.0RC1 : ## - Ajout de vérifs en cas de forums vides. ## ## New in 1.0.0B2 : ## - Options de pagination avancée pour les sujets du forum. ## Vous pouvez maintenant choisir combien de pages doivent êtres prises en compte ## en partant de la première et de la dernière page. ## ## ## _________________________________________________________________________________ ## Ce mod va vraiment aider au référencement de votre site dans Google Yahoo et MSN. ## ## * Ce mod est au départ inspiré de celui de jhaskins's : Google sitemap generator ## (< jhaskins AT streetrod3 DOT com > (Joe Haskins) http://www.streetrod3.com) ## mais il a été totalement re-codé pour un résultat tout à fait différent. ## ## * Premièrement, le code est fait pour être le plus rapide possible, tout en donnant les informations requises. ## Toutes les listes peuvent être mises en cache, ce qui permet de lister plus de liens encore. ## Le cache peut lui-même utiliser la compression Gun-zip, les plans sont alors mis en cache, compressés ## et envoyés tels quels à la demande. Ce qui veut dire que 50 ko de transfert peuvent suffire pour un plan ## de site Google contenant 10 000 URLs. ## Ce code est prêt pour de très gros forums. ## ## * Toutes les requêtes sql potentiellement gourmandes sont découpées en plusieurs cycles de requêtes, ## configurable dans l'ACP pour chaque type de listes ## Possibilité de limiter l'affichage de certains forums publics ## (ainsi que certaines pages publiques de mxBB ou catégories de KB, le cas échéant), configurable dans l'acp. ## ## * Possibilité de limiter le nombre total d'URL par sitemap, configurable dans l'ACP. ## Tous les liens sont classés par dernière activité, configurable dans l'ACP. ## Mod rewrite pour les URLs des sitemaps, configurable dans l'ACP. (Requiert Apache et mod_rewrite ou IIS et isapi_rewrite) ## Mod Rewrite pour les liens listés, en 4 niveaux, aucun, simple, mixed et advanced, configurable dans l'acp. ## Les mod Rewrite phpBB SEO 0.2.x seront détectés automatiquement. ## Plusieurs options de priorité pour phpbb, configurable dans l'ACP. ## ## * Possibilité de lister (et limiter) les pages de sujets, configurable dans l'ACP. ## La pagination est limitée de cette façon : ## Vous pouvez définir une limite haute et une limite basse dans l'ACP. ## ## "début" "fin" ## | | ## | bas haut | ## | | | | ## v v v v ## 1, 2, 3 ... 10, 11, 12 ## ## ## * Seulement le contenu public et valide est listé. Sitemaps 100% valides. ## ## * Marche directement pour phpBB et mxBB PORTAL sans modifications (presque, depuis l'ajout d'une clé $lang pour le titre du menu dans l'ACP). ## Détecte automatiquement tout nouveau module sitemap, rendant possible l'ajout de nouvelles sitemaps très facile. ## ## * Fichiers prémoddés pour de nombreux standard d'URL pour phpBB comme abl2know, webmedic, et bien d'autres ... ## La nouvelle methode de réécriture d'URL permet de régler simplement les URLs utilisées. ## Les mod Rewrite phpBB SEO 0.2.x seront détectés automatiquement ( http://www.phpbb-seo.com/forums/ ). ## ## Sitemaps crées : ## - Une sitemapindex établissant la liste de toutes les sitemapes installées, ## - Une sitemap listant les forums publics, ## - Une sitemap par forum public, listant les sujets. ## Quand mxBB PORTAL est installé ## - Ajoute les entrées nécessaires dans le SitemapIndex, ## - Ajoute les options nécessaires à mxBB dans l'ACP permettant de définir l'ID de page mx sur laquelle se trouve KB. ## - Une sitemap listant toutes les pages publiques de mx. ## Flux RSS 2.0 crées : ## - Un flux RSS établissant la liste de tous les flux installés, ## - Un flux RSS général, listant les URLs des forums publics, ## - Un flux RSS par forum public, listant les sujets, ## - Un flux RSS général listant les messages de tous les forums, ## - Un flux RSS général listant les éléments de tous les plug-ins éventuellement installés. ## ## NOT tested with EasyMod, but should work :-) ############################################################## ## MOD History: ## ## 2007-04-15 - 1.2.0RC4 ## - UTF-8 conversion method is now selectable ## - mxBB 2.8 Compatible ## - Some SQL optimization ## - Better authorisation method ## - fixed urllist.php ## 2007-03-05 - 1.2.0RC3 ## - RSS now able to display private forums. ## - 100% RSS 2.0 valid output. ## - Advanced UTF-8 conversion backported from phpBB3. ## - Enhanced the XSLt styling, no more JS to User friendly links. ## - RSS XSLt styling can be forced for for FF2 and IE7. ## - Bbcode, active links, smilies can now be desactivated on RSS feeds. ## - Advanced BBcode filtering for rss feeds. ## - Added two summarize methods. ## 2006-01-27 - 1.2.0RC2 ## - Fixed censoring issue in GYM sitemaps. ## 2006-01-16 - 1.2.0RC1 ## - The module was rewritten from scratch and renamed. ## - Added cache for all type of outputs with full gun-zip support. ## - Added RSS 2.0 feeds. ## - Added yahoo! urllist.txt. ## - Added Zillions options in ACP. ## - Optimized the code. ## ## 2006-06-14 - 1.0.1 ## - Added exclusion settings based on forum ID (mxBB Pages IDs and KB's Categories IDs) ## - Changed the SQL Queries previously needing a SWITCH. ## - Added Category hierarchy 2.1.4e support (Premodded file). ## - Fixed paths to allow any mxBB installation type. ## - Added a check to find out if KB's mxBB Page Id was set. ## ## 2006-04-28 - 1.0.0 ## - Juste une update de la version pour la soumission à phpbb.com ## - Bug Fix : Pagination des sujets, une page de trop. ## ## 2006-04-26 - Second release candidate 1.0.0RC2 ## - Mostly intended to be more friendly with my other plans ## - Some code clean up, Acp side and paths mostly ## - Added common_GGsitemaps.php file in the release. ## ## 2006-02-28 - First release candidate 1.0.0RC1 ## - Added some checks to make sure sitemaps are not empty ## - Made the install phbbb.com compliant. ## - Minors bug fixes and code opt. ## - Added uninstall jhaskins's Google sitemap generator file. ## ## ## 2006-02-24 - Second beta Version 1.0.0B2 ## - Added advanced pagination control for topics ## - Better handeling of eventual sql errors ## - Install and uninstall script both for phpBB and mxBB PORTAL ## - Cosmetic in acp ## - Minors bug fixes and code opt. ## ## ## 2006-02-22 - First beta Version 1.0.0B1 ## ## ############################################################## ## Before Adding This MOD To Your Forum, You Should Back Up All Files Related To This MOD ############################################################## # #-----[ DIY INSTRUCTIONS ]------------------------------------------ # __________________________________ NOTE : VERIFICATION DE MISE A JOUR __________________________________ Si votre forum utilise le mod Extreme Styles (alias "XS") ( http://www.phpbbstyles.com/viewtopic.php?t=356 ), vous pouvez profiter du système automatisé de vérification des mises à jour. Uploadez : contrib/xs_gym_sitemaps.cfg dans le dossier admin/ de votre forum, la vérification de mise à jour du mod XS sera étendue à ce mod. ____________________ NOTE : translations/ ____________________ Les fichiers langues ainsi que du dossier ggs_style/ en français se trouvent dans le dossier : translations/ de cette archive. _____________________________ === > Mise à jour <=== _____________________________ Pour mettre à jour depuis toutes les versions, vous devrez tout d'abord désinstaller le module, en effaçant tous les fichiers qu'il utilise, puis suivre la procédure d'installation. Si vous mettez à jour depuis une version anterieurs à la 1.2.0RC3, vous devrez égallement metre à jour les rewriterules du module, en installant les nouvelles à la place des anciennes. Vous devrez réentrer vos réglages dans l'ACP. Vous devrez également ré-uploader contrib/xs_gym_sitemaps.cfg dans le dossier admin/ de phpBB si vous utilisez XS mod. ____________________ NOTE : URL Rewriting ____________________ Si vous n'utilisez pas de réécriture d'URL pour votre forum et pour le plan de site, ignorez ce qui suit dans ce DIY INSTRUCTIONS jusqu'à INSTALLATION POUR VOTRE FORUM Voici les RewriteRules à ajouter dans le .htaccess de la racine du domaine. En fonction de votre hébergeur, il se peut que vous ayez à retirer les "/" se trouvant devant les noms de fichier.php Exemple : RewriteRule ^rss-?(l|s)?-?(m)?\.([xml|xml\.gz]+)$ rss.php?$1&$2 [L] Deux différents types d'installation : _____________________________________ Vous pouvez utiliser les fichiers sitemap.php, rss.php et urllist.php en dehors du dossier d'installation de phpBB (ou mxBB) pour peut qu'il soit installé dans un dossier. Pour cela, vous devrez ouvrir le ficher que vous voudirez déplacez, et remplacer : $phpbb_root_path = './'; Par : $phpbb_root_path = './phpbb/'; En remplaçant, bien entendu, 'phpbb' par le nom du dossier dans lequel phpBB serait alors installé. Pour mxBB, il faudrait trouver : $mx_root_path = './'; Et remplacer par : $mx_root_path = './portal/'; En remplaçant, bien entendu, 'portal' par le nom du dossier dans lequel mxBB serait alors installé. AVERTISSEMENT : ___________________________________________________________________________________________________________ Les module calculent l'emplacement des fichiers sitemap.php, rss.php et urllist.php, il est possible que certaines configurations de serveur posent un problème avec ce calcul. Pas souvent, mais si c'est le cas, vous devrez configurer ce chemin manuellement. Pour sitemap.php : $paths['sitemap_url'] doit contenir l'URL complète du dossier d'installation de sitemap.php (www.example.com/folder/ ou www.example.com) : $paths['sitemap_url'] = 'www.example.com/folder/'; Juste avant : if (defined('IN_PORTAL')) { Vous pouvez hardcoder ce chemin si le calcul de l'emplacement pose problème. Le même principe s'applique alors avec rss.php, et $paths['rss_url'], et urllist.php et $paths['yahoo_url']. _____________________________________________________________________________________________________________ Vous devrez alors modifier les chemins des Rewriterules qui suivent en conséquence, comme chacun de ces trois fichiers (sitemap.php, rss.php et urllist.php) pourait ne pas finir au même endroit. Ce qui importe dans les Rewriterules, c'est le chemin jusqu'au fichier cible (rss.php, sitemap.php et urllist.php). Dans ces fichiers, ce qui importe est le chemin jusqu'au dossier de phpBB (ou mxBB). ______ OPEN : ______ .htaccess ______________________________________________________________ >>> VOS FICHIERS GYM SONT INSTALLES A LA RACINE DU DOMAINE <<< ______________________________________________________________ Après les RewriteRules du forum, ajoutez : _________________________________________ ######################################################### # GYM SITEMAPS AND RSS REWRITE RULES # ######################################################### # AUTHOR : dcz http://www.phpbb-seo.com/ # STARTED : 2006/02/22 ######################## # RSS main RewriteRule ^rss-?(l|s)?-?(m)?\.(xml(\.gz)?)$ /rss.php?$1&$2 [L] # RSS forums RewriteRule ^forums-rss-?(l|s)?-?(m)?\.(xml(\.gz)?)$ /rss.php?forum&c&$1&$2 [L] # RSS all RewriteRule ^([a-zA-Z0-9_-]+)-rss([0-9]*)-?(l|s)?-?(m)?\.(xml(\.gz)?)$ /rss.php?$1=$2&$3&$4 [L] # RSS forum topics RewriteRule ^.+-rf([0-9]+)-?(l|s)?-?(m)?\.(xml(\.gz)?)$ /rss.php?forum=$1&$2&$3 [L] # SitemapIndex RewriteRule ^sitemaps\.(xml(\.gz)?)$ /sitemap.php [L] # Sitemap modules RewriteRule ^([a-zA-Z0-9_-]+)-sitemap\.(xml(\.gz)?)$ /sitemap.php?$1 [L] # Forum Sitemaps RewriteRule ^.+-gf([0-9]+)\.(xml(\.gz)?)$ /sitemap.php?forum=$1 [L] # Yahoo! urllist.txt RewriteRule ^urllist\.(txt(\.gz)?)$ /urllist.php [L] ######################################################### # END GYM SITEMAPS AND RSS REWRITE RULES # ######################################################### ____________________________________________________________ >>> VOS FICHIERS GYM SONT INSTALLES DANS UN SOUS-DOSSIER <<< ____________________________________________________________ Après les RewriteRules du forum, ajoutez : _________________________________________ ######################################################### # GYM SITEMAPS AND RSS REWRITE RULES # ######################################################### # AUTHOR : dcz http://www.phpbb-seo.com/ # STARTED : 2006/02/22 ######################## # RSS main RewriteRule ^phpbb/rss-?(l|s)?-?(m)?\.(xml(\.gz)?)$ /phpbb/rss.php?$1&$2 [L] # RSS forums RewriteRule ^phpbb/forums-rss-?(l|s)?-?(m)?\.(xml(\.gz)?)$ /phpbb/rss.php?forum&c&$1&$2 [L] # RSS all RewriteRule ^phpbb/([a-zA-Z0-9_-]+)-rss([0-9]*)-?(l|s)?-?(m)?\.(xml(\.gz)?)$ /phpbb/rss.php?$1=$2&$3&$4 [L] # RSS forum topics RewriteRule ^phpbb/.+-rf([0-9]+)-?(l|s)?-?(m)?\.(xml(\.gz)?)$ /phpbb/rss.php?forum=$1&$2&$3 [L] # SitemapIndex RewriteRule ^phpbb/sitemaps\.(xml(\.gz)?)$ /phpbb/sitemap.php [L] # Sitemap modules RewriteRule ^phpbb/([a-zA-Z0-9_-]+)-sitemap\.(xml(\.gz)?)$ /phpbb/sitemap.php?$1 [L] # Forum Sitemaps RewriteRule ^phpbb/.+-gf([0-9]+)\.(xml(\.gz)?)$ /phpbb/sitemap.php?forum=$1 [L] # Yahoo! urllist.txt RewriteRule ^phpbb/urllist\.(txt(\.gz)?)$ /phpbb/urllist.php [L] ######################################################### # END GYM SITEMAPS AND RSS REWRITE RULES # ######################################################### _____________________________________________ >>>> INSTALLATION POUR VOTRE FORUM <<<<< _____________________________________________ _______________________________________________________________ === > mxBB PORTAL install (Pour phpbb sautez cette partie) <=== _______________________________________________________________ NOTE : Les fichiers pour une installation avec mxbb (prenant dans le même temps en charge le listing de phpBB) se trouvent dans le dossier mxBB/ du package. 1) Si mxBB est installé dans un dossier, vous devrez remplacer : $mx_root_path = './'; Par : $mx_root_path = './portal/'; En remplaçant, bien entendu, 'phpbb' par le nom du dossier dans lequel mxBB serait alors installé. Au début de rss.php, sitemap.php et urllist.php. 2) Uploadez mxBB/mx_ggsitemaps/sitemap.php, mxBB/mx_ggsitemaps/rss.php and mxBB/mx_ggsitemaps/urllist.php à la racine de votre serveur (i.e.www.example.com/sitemap.php) 3) Upload mxBB/mx_ggsitemaps/ggs_style/*.* à l'endroit ou se trouve rss.php et sitemap.php. 4) copy mxBB/mx_ggsitemaps/*.* to modules/mx_ggsitemaps/*.* 5) CHMOD modules/mx_ggsitemaps/gs_cache/ à 0777 6) Rendez vous à l'ACP et installez le module mx_ggsitemap _______________________________________________________ ===> phpBB install (Pour mxBB sautez cette partie) <=== _______________________________________________________ NOTE : Les fichiers pour une installation avec phpbb seul se trouvent dans le dossier root/ du package. Si phpBB est installé dans un sous-dossier, et que vous avez d'autres pages à la racine, vous pouvez utiliser la modularité de ce système pour ajouter tous vos plans de sites Google dans le même index. Mis à part le codage ou la demande de code, vous devrez alors mettre le fichier sitemap.php à la racine, car Google ne prend pas en compte des URLs pointant vers des niveaux supérieurs à celui du fichier source. Pour ce faire, vous devrez ouvrir le ficher sitemap.php, et remplacer : $phpbb_root_path = './'; Par : $phpbb_root_path = './phpbb/'; En remplaçant, bien entendu, 'phpbb' par le nom du dossier dans lequel phpBB serait alors installé. Notez que la même opération est possible pour rss.php et urllist.php, et qu'il peut être pratique de les mettre tous au même endroit. Une fois que vous aurez uploadé tous les fichiers au bon endroit : 1) Upload root/ggs_style/*.* à l'endroit ou se trouve rss.php et sitemap.php. 2) CHMOD mx_ggsitemaps/gs_cache/ à 0777 3) Upload contrib/db_install.php to db_install.php 4) Connectez vous en admin, et lancez le script http://www.yourdomain.com/phpbbfolder/db_install.php pour installer la partie SQL 5) Effacez db_install.php. Pour désinstaller : copy root/db_uninstall.php to root/db_uninstall.php Et allez sur http://www.yourdomain.com/phpbbfolder/db_uninstall.php en tant qu'administrateur. # #-----[ COPY ]------------------------------------------ # copy root/sitemap.php to sitemap.php copy root/rss.php to rss.php copy root/urllist.php to urllist.php copy root/language/lang_english/lang_google_sitemap.php to language/lang_english/lang_ggs_admin.php copy root/language/lang_french/lang_google_sitemap.php to language/lang_english/lang_ggs_main.php copy root/language/lang_english/lang_google_sitemap.php to language/lang_french/lang_ggs_admin.php copy root/language/lang_french/lang_google_sitemap.php to language/lang_french/lang_ggs_main.php copy root/admin/admin_mx_ggsitemap.php to admin/admin_mx_ggsitemap.php copy root/mx_ggsitemaps/includes/index_forum.php to mx_ggsitemaps/includes/yahoo_forum.php copy root/mx_ggsitemaps/includes/index_forum.php to mx_ggsitemaps/includes/rss_forum.php copy root/mx_ggsitemaps/includes/sitemap_forum.php to mx_ggsitemaps/includes/google_forum.php copy root/mx_ggsitemaps/includes/common_GGsitemaps.php to mx_ggsitemaps/includes/ggs_functions.php copy root/templates/subSilver/admin_mx_ggsitemap.tpl to templates/subSilver/admin/admin_mx_ggsitemap.tpl # #-----[ OPEN ]------------------------------------------ # Vous pouvez sauter cette partie si vous ne vous souciez pas de voir le titre # du menu de mx Google Sitemaps dans ACP traduit. Tout le reste sera traduit de toutes façons. language/lang_french/lang_admin.php # #-----[ FIND ]------------------------------------------ # ?> # #-----[ BEFORE, ADD ]------------------------------------------ # // BEGIN mx Google Sitemaps www.phpBB.SEO.com $lang['Google_SiteMaps'] = "GYM Sitemaps & RSS"; // END mx Google Sitemaps www.phpBB.SEO.com # #-----[ SAVE/CLOSE ALL FILES ]------------------------------------------ # # EoM