You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

93 lines
3.2 KiB

2 years ago
4 years ago
4 years ago
4 years ago
4 years ago
  1. [![No Maintenance Intended](http://unmaintained.tech/badge.svg)](http://unmaintained.tech/)
  2. RSS-Fusion
  3. ----------
  4. **Fusion de flux RSS multiples.**
  5. * Sans base de données
  6. * Script auto hébergeable
  7. * Gestion des flux RSS/ATOM
  8. * Flux global
  9. * Surcharge de personnalisation
  10. Démo et exemple d'utilisation
  11. ----------
  12. Un **[exemple d'utilisation en ligne]** est parfois disponible, selon la sucharge du serveur en mousse qui l'héberge. Les sources de cet exemple sont disponibles **[par ici].**
  13. Par défaut
  14. ----------
  15. * Système de mise en cache des flux (durée = 1h)
  16. * Données triées par date/heure décroissante
  17. * Possibilité de spécifier des mots clés ("star and bad words")
  18. Prérequis
  19. ---------
  20. * Serveur Web (tel que Apache2)
  21. * A partir de PHP 5.4 avec les modules suivants : `cUrl`, `JSON`, `SimpleXML`, `DOMDocument` (et potentiellement quelques autres selon votre configuration)
  22. Installation
  23. ------------
  24. Récupération des sources
  25. ```
  26. $ git clone https://git.framasoft.org/Erase/RSS-Fusion.git
  27. ```
  28. ou en [téléchargeant l'archive zip]
  29. ~~Vérifier/assigner les droits en écriture au sein du répertoire :~~
  30. * ~~`/data`~~
  31. Personnalisation
  32. ----------
  33. En se basant sur les paramètres précisés dans le fichier `/system/config/default.php`, il est possible de surcharger les informations en les précisant dans le fichier `/system/config/localconfig.php`, notamment les mots clés.
  34. Le reste des traitements à personnaliser peuvent se baser sur ceux présents dans le fichier `index.php`
  35. Informations annexes
  36. --------
  37. * RSS-Fusion utilise la librairie [SimplePie] pour parser les flux RSS.
  38. * Les données en caches sont dans le répertoire `/system/cache`
  39. * La recherche des mots-clés se fait sur le titre et la description de chaque élément des flux RSS
  40. * Deux types de mots clés sont pris en charge : **star** pour des éléments à mettre en avant et **bad** pour des éléments à masquer
  41. Structuration des éléments des flux
  42. --------
  43. ```
  44. array(11) {
  45. ["link"] => URL de l'élément
  46. ["title"] => Titre de l'élément
  47. ["permalink"] => Permalien de l'élément
  48. ["description"] => Description de l'élément
  49. ["pubdate"] => Timestamp de publication
  50. ["date_read"] => Date de publication au format jour-mois-année heures:minutes
  51. ["category"] => Catégorie de l'élément
  52. ["base"] => URL du flux RSS source
  53. ["show"] => true (default) | false (bad word) | star (star word)
  54. ["enclosure"] => Elément inclus
  55. }
  56. ```
  57. Licence
  58. -------
  59. En dehors des différentes licences spécifiques aux outils utilisés, le reste du code est distribué sous licence [Creative Commons BY-NC-SA 4.0]
  60. Auteur
  61. ------
  62. * [Un simple développeur paysagiste] :) avec un peu de temps libre et aucune prétention - contact_at_green-effect.fr
  63. [//]: #
  64. [téléchargeant l'archive zip]: <https://framagit.org/Erase/RSS-Fusion/repository/archive.zip>
  65. [SimplePie]: <http://simplepie.org/>
  66. [Creative Commons BY-NC-SA 4.0]: <http://creativecommons.org/licenses/by-nc-sa/4.0/>
  67. [Un simple développeur paysagiste]: <http://www.green-effect.fr>
  68. [exemple d'utilisation en ligne]: <http://rss-fusion.green-effect.fr/>
  69. [par ici]: <https://framagit.org/Erase/RSS-Fusion-Demo>