{"id":15331,"date":"2025-04-05T06:52:15","date_gmt":"2025-04-05T13:52:15","guid":{"rendered":"https:\/\/speculoos.world\/news\/2025\/04\/opensim-helpers-se-dote-dune-documentation-et-dun-site-adequats\/"},"modified":"2025-04-05T07:16:26","modified_gmt":"2025-04-05T14:16:26","slug":"opensim-helpers-se-dote-dune-documentation-et-dun-site-adequats","status":"publish","type":"post","link":"https:\/\/speculoos.world\/fr\/lab\/w4os-fr\/2025\/04\/opensim-helpers-se-dote-dune-documentation-et-dun-site-adequats\/","title":{"rendered":"OpenSim Helpers se dote d&rsquo;une documentation et d&rsquo;un site ad\u00e9quats"},"content":{"rendered":"<p><strong>OpenSim Helpers<\/strong>, la biblioth\u00e8que au c\u0153ur du plugin <strong>w4os<\/strong>, dispose enfin d&rsquo;instructions d&rsquo;installation correctes &#8211; et de son propre site web <a class=\"\" href=\"https:\/\/opensimulator-helpers.dev\/\" target=\"_blank\" rel=\"noopener\">: https:\/\/opensimulator-helpers.dev\/<\/a>. Cela \u00e9tait attendu depuis longtemps. <\/p>\n<p>Suite aux commentaires des utilisateurs, nous avons travaill\u00e9 dur pour rendre l&rsquo;installation des aides autonomes plus simple. Comme d&rsquo;habitude, il s&rsquo;agit d&rsquo;un travail en cours, mais il s&rsquo;agit d\u00e9j\u00e0 d&rsquo;une am\u00e9lioration consid\u00e9rable. <\/p>\n<p><strong>OpenSim Helpers<\/strong> (anciennement <em>Flexible Helpers Scripts<\/em>) est une collection de scripts et de biblioth\u00e8ques web utilis\u00e9s avec une installation d&rsquo;OpenSimulator. Ils sont utilis\u00e9s par les grilles ou les simulateurs autonomes pour fournir des fonctionnalit\u00e9s qui ne sont pas incluses dans le noyau d&rsquo;OpenSim et qui n\u00e9cessitent une impl\u00e9mentation c\u00f4t\u00e9 web &#8211; telles que la recherche, les transactions financi\u00e8res et la transmission de messages hors ligne. <\/p>\n<p>Les aides sont fournies avec le plugin w4os, mais elles sont \u00e9galement disponibles en tant que biblioth\u00e8que autonome, ce qui permet de les int\u00e9grer dans n&rsquo;importe quel site web, qu&rsquo;il utilise ou non un syst\u00e8me de gestion de contenu (CMS). Dans ce cas, ils sont g\u00e9n\u00e9ralement install\u00e9s dans un sous-dossier, comme <code>example.org\/helpers<\/code>. <\/p>\n<p>En option, les aides peuvent \u00e9galement \u00eatre install\u00e9es ind\u00e9pendamment, avec une interface web comme w4os, pour am\u00e9liorer les performances.<\/p>\n<h2 class=\"wp-block-heading\">Caract\u00e9ristiques actuelles<\/h2>\n<ul class=\"wp-block-list\">\n<li><strong>Recherche dans le monde<\/strong> &#8211; Recherchez des lieux, des terrains \u00e0 vendre, des petites annonces et des \u00e9v\u00e9nements \u00e0 partir du panneau de recherche classique de l&rsquo;utilisateur.<\/li>\n<li><strong>Monnaie<\/strong> &#8211; Permet des transactions telles que la vente de terres ou d&rsquo;objets, le paiement d&rsquo;avatars. Peut \u00eatre configur\u00e9 avec des services tiers comme Gloebit ou Podex, ou m\u00eame localement. (M\u00eame la fausse monnaie est n\u00e9cessaire pour des fonctions telles que la vente gratuite de terres ou la cr\u00e9ation de groupes).  <\/li>\n<li><strong>Outil foncier<\/strong> &#8211; Permettre les transactions parcellaires (gratuit ou payant)<\/li>\n<li><strong>Transfert des messages hors ligne<\/strong> &#8211; Transf\u00e9rez les messages instantan\u00e9s hors ligne vers les adresses \u00e9lectroniques des avatars (activation n\u00e9cessaire dans les param\u00e8tres de la visionneuse).<\/li>\n<li><strong>Guide de destination<\/strong> &#8211; Prise en charge du guide de destination de la visionneuse v3<\/li>\n<\/ul>\n<h2 class=\"wp-block-heading\">Instructions d&rsquo;installation<\/h2>\n<p>Les aides OpenSim consistent en des scripts, certains nouvellement \u00e9crits et d&rsquo;autres initialement rassembl\u00e9s \u00e0 partir de divers projets plus anciens. Ils ont \u00e9t\u00e9 unifi\u00e9s pour simplifier la configuration. Cependant, OpenSimulator \u00e9tant ce qu&rsquo;il est, la configuration peut encore \u00eatre d\u00e9licate &#8211; surtout sans documentation.  <\/p>\n<p>Cette lacune est d\u00e9sormais combl\u00e9e : les \u00e9tapes de l&rsquo;installation sont document\u00e9es dans le fichier <em>INSTALLATION.md<\/em>. Il devrait offrir des conseils utiles aux utilisateurs qui d\u00e9couvrent la biblioth\u00e8que. <\/p>\n<h2 class=\"wp-block-heading\">Nouveau site web<\/h2>\n<p>Les projets open source sont g\u00e9n\u00e9ralement h\u00e9berg\u00e9s sur des plateformes telles que GitHub &#8211; c&rsquo;est le cas de opensim-helpers<a class=\"\" href=\"https:\/\/github.com\/magicoli\/opensim-helpers\" target=\"_blank\" rel=\"noopener\">(https:\/\/github.com\/magicoli\/opensim-helpers)<\/a>. Mais tous les utilisateurs potentiels ne sont pas familiers avec ces plateformes. C&rsquo;est pourquoi nous avons cr\u00e9\u00e9 un site web simple et d\u00e9di\u00e9 au projet, qui se concentre sur l&rsquo;essentiel  <\/p>\n<div class=\"wp-block-buttons is-content-justification-center is-layout-flex wp-container-core-buttons-is-layout-1 wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link has-text-align-center wp-element-button\">https:\/\/opensim-helpers.dev<\/a><\/div>\n<\/div>\n<p class=\"has-text-align-center\">Ce n&rsquo;est pas tr\u00e8s sophistiqu\u00e9. L&rsquo;objectif est de le garder propre et simple &#8211; sans les cloches et les sifflets de GitHub &#8211; et d&rsquo;\u00e9viter les tracas de la maintenance manuelle. <\/p>\n<h3 class=\"wp-block-heading\">Note compl\u00e9mentaire : l&rsquo;outil de g\u00e9n\u00e9ration de sites web<\/h3>\n<p>Comme toutes les informations cl\u00e9s existent d\u00e9j\u00e0 dans le d\u00e9p\u00f4t GitHub (sous forme de fichiers Markdown), nous avons d\u00e9velopp\u00e9 un outil d\u00e9di\u00e9 pour synchroniser le site web directement \u00e0 partir du d\u00e9p\u00f4t. De cette mani\u00e8re, le site reste automatiquement \u00e0 jour avec la documentation cr\u00e9\u00e9e par les d\u00e9veloppeurs. <\/p>\n<ul class=\"wp-block-list\">\n<li>G\u00e9n\u00e8re un site web statique pour des raisons de performance et de charge minimale du serveur (les pages sont mises \u00e0 jour r\u00e9guli\u00e8rement via cron).<\/li>\n<li>Utilise Bootstrap pour une mise en page propre, r\u00e9active et l\u00e9g\u00e8re.<\/li>\n<li>Cr\u00e9e des pages de base \u00e0 partir des fichiers <code>.md<\/code> (par exemple, <code>README.md<\/code> comme page d&rsquo;accueil, d&rsquo;autres comme <code>INSTALLATION.md<\/code>, <code>TROUBLESHOOTING.md<\/code>, <code>CHANGELOG.md<\/code> ajout\u00e9es au menu).<\/li>\n<li>Fournit une page de t\u00e9l\u00e9chargement (derni\u00e8re version stable et instructions d&rsquo;installation)<\/li>\n<li>Inclut une page de support (encourageant l&rsquo;utilisation des questions GitHub)<\/li>\n<li>Offre une page de donation (li\u00e9e aux sponsors GitHub)<\/li>\n<\/ul>\n<p>Le g\u00e9n\u00e9rateur lui-m\u00eame est \u00e9galement open source et disponible ici <a class=\"\" href=\"https:\/\/github.com\/magicoli\/php-site-generator\" target=\"_blank\" rel=\"noopener\">: https:\/\/github.com\/magicoli\/php-site-generator.<\/a><br\/>(Il n&rsquo;a pas son propre site web &#8211; donc meta <img decoding=\"async\" src=\"https:\/\/s.w.org\/images\/core\/emoji\/15.0.3\/72x72\/1f605.png\" alt=\"\ud83d\ude05\" class=\"wp-smiley\" title=\"\">).<\/p>\n<h2 class=\"wp-block-heading\">Alternatives<\/h2>\n<p>Comme mentionn\u00e9 pr\u00e9c\u00e9demment, les aides d&rsquo;OpenSimulator peuvent \u00eatre install\u00e9es en tant que solution autonome, int\u00e9gr\u00e9es \u00e0 une interface web, ou utilis\u00e9es en conjonction avec celle-ci.<\/p>\n<p>L&rsquo;option la plus simple est souvent d&rsquo;installer une interface web compl\u00e8te, qui inclut g\u00e9n\u00e9ralement les aides ainsi que des outils pour l&rsquo;enregistrement des utilisateurs, la gestion des comptes, etc. Plusieurs projets int\u00e9ressants existent &#8211; avec ou sans CMS &#8211; notamment <strong>w4os<\/strong> (bien s\u00fbr), <strong>OSMW<\/strong>, et <strong>Diva<\/strong>: <br\/><a class=\"\" href=\"http:\/\/opensimulator.org\/wiki\/Webinterface\" target=\"_blank\" rel=\"noopener\">http:\/\/opensimulator.org\/wiki\/Webinterface<\/a><\/p>\n<p>Cela dit, dans certains cas, il est plus judicieux d&rsquo;ex\u00e9cuter les aides de mani\u00e8re ind\u00e9pendante, soit pour des raisons de performance, soit lorsqu&rsquo;aucune interface n&rsquo;est n\u00e9cessaire. La plupart des fonctionnalit\u00e9s incluses dans OpenSim Helpers \u00e9taient autrefois disponibles dans des projets distincts, souvent abandonn\u00e9s. Bien que nous ne les \u00e9num\u00e9rerons pas toutes, nous sommes reconnaissants aux d\u00e9veloppeurs originaux dont le travail a jet\u00e9 les bases de cette biblioth\u00e8que.  <\/p>\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n<h2 class=\"wp-block-heading\">Perspectives d&rsquo;avenir<\/h2>\n<p>Nous continuerons \u00e0 d\u00e9velopper <strong>w4os<\/strong> et <strong>opensim-helpers<\/strong> en parall\u00e8le, en nous assurant que l&rsquo;interface web compl\u00e8te et le backend autonome restent \u00e0 jour. Certaines fonctionnalit\u00e9s introduites dans <strong>w4os<\/strong> et le projet <strong>2do Directory<\/strong> seront migr\u00e9es vers les aides lorsque cela sera appropri\u00e9. Nous pr\u00e9voyons \u00e9galement de r\u00e9organiser le code pour faciliter l&rsquo;int\u00e9gration entre les diff\u00e9rents projets.  <\/p>\n<h2 class=\"wp-block-heading\">\u00c0 propos de Speculoos World<\/h2>\n<p><strong><a href=\"https:\/\/speculoos.world\/fr\/\">Speculoos World<\/a><\/strong> est un monde virtuel en 3D cr\u00e9\u00e9 en 2011, bas\u00e9 sur OpenSimulator. Il maintient \u00e0 la fois <strong><a href=\"https:\/\/w4os.org\/\" target=\"_blank\" rel=\"noopener\">w4os<\/a><\/strong> et <strong><a href=\"https:\/\/opensim-helpers.dev\/\" target=\"_blank\" rel=\"noopener\">opensim-helpers<\/a><\/strong>ainsi que plusieurs autres projets li\u00e9s \u00e0 OpenSim. Construits \u00e0 l&rsquo;origine pour r\u00e9pondre aux besoins de la grille Speculoos, ils ont \u00e9t\u00e9 ouverts pour \u00eatre partag\u00e9s avec l&rsquo;ensemble de la communaut\u00e9 OpenSimulator.  <\/p>\n<p>(Article original sur W4OS &#8211; <a href=\"https:\/\/w4os.org\/news\/2025\/04\/opensim-helpers-gets-proper-documentation-and-site\/\" target=\"_blank\" class=\"feedzy-rss-link-icon\" rel=\"noopener\">Lire la suite<\/a>)<\/p>","protected":false},"excerpt":{"rendered":"<p>OpenSim Helpers, la biblioth\u00e8que au c\u0153ur du plugin w4os, dispose enfin d&rsquo;instructions d&rsquo;installation correctes &#8211; et de son propre site web : https:\/\/opensimulator-helpers.dev\/. Cela \u00e9tait attendu depuis longtemps. Suite aux&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[332],"tags":[],"class_list":{"0":"post-15331","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-w4os-fr"},"_links":{"self":[{"href":"https:\/\/speculoos.world\/fr\/wp-json\/wp\/v2\/posts\/15331","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/speculoos.world\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/speculoos.world\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/speculoos.world\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/speculoos.world\/fr\/wp-json\/wp\/v2\/comments?post=15331"}],"version-history":[{"count":1,"href":"https:\/\/speculoos.world\/fr\/wp-json\/wp\/v2\/posts\/15331\/revisions"}],"predecessor-version":[{"id":15334,"href":"https:\/\/speculoos.world\/fr\/wp-json\/wp\/v2\/posts\/15331\/revisions\/15334"}],"wp:attachment":[{"href":"https:\/\/speculoos.world\/fr\/wp-json\/wp\/v2\/media?parent=15331"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/speculoos.world\/fr\/wp-json\/wp\/v2\/categories?post=15331"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/speculoos.world\/fr\/wp-json\/wp\/v2\/tags?post=15331"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}