{"id":15337,"date":"2025-04-05T06:52:15","date_gmt":"2025-04-05T13:52:15","guid":{"rendered":"https:\/\/speculoos.world\/unkategorisiert\/2025\/04\/opensim-helpers-erhaelt-eine-angemessene-dokumentation-und-website\/"},"modified":"2025-04-05T07:16:27","modified_gmt":"2025-04-05T14:16:27","slug":"opensim-helpers-erhaelt-eine-angemessene-dokumentation-und-website","status":"publish","type":"post","link":"https:\/\/speculoos.world\/de\/labo\/w4os-de\/2025\/04\/opensim-helpers-erhaelt-eine-angemessene-dokumentation-und-website\/","title":{"rendered":"OpenSim Helpers erh\u00e4lt eine angemessene Dokumentation und Website"},"content":{"rendered":"<p><strong>OpenSim Helpers<\/strong>, die Bibliothek, die den Kern des <strong>w4os-Plugins<\/strong> bildet, hat endlich eine richtige Installationsanleitung &#8211; und eine eigene Website: <a class=\"\" href=\"https:\/\/opensimulator-helpers.dev\/\" target=\"_blank\" rel=\"noopener\">https:\/\/opensimulator-helpers.dev\/.<\/a> Das war schon lange \u00fcberf\u00e4llig. <\/p>\n<p>Nach dem Feedback der Benutzer haben wir hart daran gearbeitet, die Installation von eigenst\u00e4ndigen Helfern einfacher zu gestalten. Wie \u00fcblich arbeiten wir noch daran, aber es ist bereits eine gro\u00dfe Verbesserung. <\/p>\n<p><strong>OpenSim Helpers<\/strong> (fr\u00fcher <em>Flexible Helpers Scripts<\/em>) ist eine Sammlung von Webskripten und Bibliotheken, die neben einer OpenSimulator-Installation verwendet werden. Sie werden von Grids oder eigenst\u00e4ndigen Simulatoren verwendet, um Funktionen bereitzustellen, die nicht im OpenSim-Kern enthalten sind und eine webseitige Implementierung erfordern &#8211; wie z.B. Suche, finanzielle Transaktionen und Offline-Nachrichtenweiterleitung. <\/p>\n<p>Hilfsprogramme werden mit dem w4os-Plugin geb\u00fcndelt, sind aber auch als eigenst\u00e4ndige Bibliothek verf\u00fcgbar und k\u00f6nnen in jede Website integriert werden, unabh\u00e4ngig davon, ob sie ein CMS verwendet. In solchen F\u00e4llen werden sie normalerweise in einem Unterordner installiert, wie <code>example.org\/helpers<\/code>. <\/p>\n<p>Optional k\u00f6nnen die Hilfsprogramme auch unabh\u00e4ngig von einer Webschnittstelle wie w4os installiert werden, um die Leistung zu verbessern.<\/p>\n<h2 class=\"wp-block-heading\">Aktuelle Merkmale<\/h2>\n<ul class=\"wp-block-list\">\n<li><strong>In-World-Suche<\/strong> &#8211; Durchsuchen Sie Orte, Grundst\u00fccke, Kleinanzeigen und Ereignisse \u00fcber das klassische Suchfeld des Betrachters.<\/li>\n<li><strong>W\u00e4hrung<\/strong> &#8211; Erm\u00f6glichen Sie Transaktionen wie den Verkauf von Land oder Objekten und die Bezahlung von Avataren. Kann mit Drittanbieterdiensten wie Gloebit oder Podex oder sogar lokal konfiguriert werden. (F\u00fcr Funktionen wie den kostenlosen Verkauf von Land oder die Erstellung von Gruppen ist sogar eine gef\u00e4lschte W\u00e4hrung erforderlich).  <\/li>\n<li><strong>Land-Tool<\/strong> &#8211; Erm\u00f6glichen Sie Parzellen-Transaktionen (kostenlos oder kostenpflichtig)<\/li>\n<li><strong>Offline-Nachrichtenweiterleitung<\/strong> &#8211; Leiten Sie Offline-IMs an die E-Mail-Adressen der Avatare weiter (muss in den Viewer-Einstellungen aktiviert werden)<\/li>\n<li><strong>Zielf\u00fchrer<\/strong> &#8211; Unterst\u00fctzung f\u00fcr v3 Viewer Zielf\u00fchrer<\/li>\n<\/ul>\n<h2 class=\"wp-block-heading\">Anweisungen zur Installation<\/h2>\n<p>OpenSim Helpers besteht aus Skripten, von denen einige neu geschrieben und andere aus verschiedenen \u00e4lteren Projekten zusammengetragen wurden. Sie wurden vereinheitlicht, um die Konfiguration zu vereinfachen. Allerdings kann die Einrichtung von OpenSimulator, so wie er ist, immer noch schwierig sein &#8211; insbesondere ohne Dokumentation.  <\/p>\n<p>Diese L\u00fccke ist nun geschlossen: Die Installationsschritte sind in der Datei <em>INSTALLATION.md<\/em> dokumentiert. Sie sollte Benutzern, die die Bibliothek noch nicht kennen, eine hilfreiche Anleitung bieten. <\/p>\n<h2 class=\"wp-block-heading\">Neue Website<\/h2>\n<p>Open-Source-Projekte werden in der Regel auf Plattformen wie GitHub gehostet &#8211; und so auch opensim-helpers<a class=\"\" href=\"https:\/\/github.com\/magicoli\/opensim-helpers\" target=\"_blank\" rel=\"noopener\">(https:\/\/github.com\/magicoli\/opensim-helpers)<\/a>. Aber nicht alle potenziellen Benutzer sind mit diesen Plattformen vertraut. Deshalb haben wir eine einfache, spezielle Website f\u00fcr das Projekt erstellt, die sich auf das Wesentliche konzentriert  <\/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\">Es ist nicht extravagant. Das Ziel ist es, es sauber und einfach zu halten &#8211; ohne den Schnickschnack von GitHub &#8211; und den Aufwand der manuellen Pflege zu vermeiden. <\/p>\n<h3 class=\"wp-block-heading\">Nebenbei bemerkt: das Tool zur Erstellung von Websites<\/h3>\n<p>Da alle wichtigen Informationen bereits im GitHub-Repository (als Markdown-Dateien) vorhanden sind, haben wir ein spezielles Tool entwickelt, um die Website direkt mit dem Repository zu synchronisieren. Auf diese Weise bleibt die Website automatisch mit der von den Entwicklern erstellten Dokumentation auf dem neuesten Stand. <\/p>\n<ul class=\"wp-block-list\">\n<li>Erzeugt eine statische Website f\u00fcr Performance und minimale Serverbelastung (Seiten werden regelm\u00e4\u00dfig \u00fcber Cron aktualisiert)<\/li>\n<li>Verwendet Bootstrap f\u00fcr ein sauberes, reaktionsschnelles und leichtes Layout<\/li>\n<li>Erstellt einfache Seiten aus <code>.md<\/code> Dateien (z.B. <code>README.md<\/code> als Startseite, andere wie <code>INSTALLATION.md<\/code>, <code>TROUBLESHOOTING.md<\/code>, <code>CHANGELOG.md<\/code> werden dem Men\u00fc hinzugef\u00fcgt)<\/li>\n<li>Stellt eine Download-Seite zur Verf\u00fcgung (neueste stabile Version und Anweisungen f\u00fcr die Installation)<\/li>\n<li>Enth\u00e4lt eine Support-Seite (die die Verwendung von GitHub-Themen f\u00f6rdert)<\/li>\n<li>Bietet eine Spendenseite (verlinkt mit GitHub-Sponsoren)<\/li>\n<\/ul>\n<p>Der Generator selbst ist ebenfalls Open Source und hier verf\u00fcgbar: <a class=\"\" href=\"https:\/\/github.com\/magicoli\/php-site-generator\" target=\"_blank\" rel=\"noopener\">https:\/\/github.com\/magicoli\/php-site-generator.<\/a><br\/>(Er hat keine eigene Website &#8211; sooo 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\">Alternativen<\/h2>\n<p>Wie bereits erw\u00e4hnt, k\u00f6nnen die OpenSimulator Helpers als eigenst\u00e4ndige L\u00f6sung installiert, in eine Weboberfl\u00e4che integriert oder in Verbindung mit einer solchen verwendet werden.<\/p>\n<p>Die einfachste Option ist oft die Installation einer voll funktionsf\u00e4higen Weboberfl\u00e4che, die in der Regel die Hilfsprogramme zusammen mit den Tools f\u00fcr die Benutzerregistrierung, die Kontoverwaltung usw. enth\u00e4lt. Es gibt mehrere interessante Projekte &#8211; mit oder ohne CMS &#8211; vor allem <strong>w4os<\/strong> (nat\u00fcrlich), <strong>OSMW<\/strong> und <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>In manchen F\u00e4llen ist es jedoch sinnvoller, die Helpers unabh\u00e4ngig voneinander auszuf\u00fchren, entweder aus Leistungsgr\u00fcnden oder wenn keine Schnittstelle ben\u00f6tigt wird. Viele der Funktionen, die jetzt in OpenSim Helpers enthalten sind, waren fr\u00fcher in separaten, oft aufgegebenen Projekten verf\u00fcgbar. Wir werden sie zwar nicht alle auflisten, aber wir sind den urspr\u00fcnglichen Entwicklern dankbar, die mit ihrer Arbeit den Grundstein f\u00fcr diese Bibliothek gelegt haben.  <\/p>\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n<h2 class=\"wp-block-heading\">Blick nach vorn<\/h2>\n<p>Wir werden sowohl <strong>w4os<\/strong> als auch <strong>opensim-helpers<\/strong> parallel weiterentwickeln, um sicherzustellen, dass sowohl die vollst\u00e4ndige Weboberfl\u00e4che als auch das Standalone-Backend auf dem neuesten Stand bleiben. Einige Funktionen, die in <strong>w4os<\/strong> und dem <strong>2do Directory<\/strong> Projekt eingef\u00fchrt wurden, werden bei Bedarf in die Helfer migriert. Wir planen auch eine Umstrukturierung des Codes, um die Integration in verschiedene Projekte zu erleichtern.  <\/p>\n<h2 class=\"wp-block-heading\">\u00dcber Spekulatius Welt<\/h2>\n<p><strong><a href=\"https:\/\/speculoos.world\/de\/\">Spekulatius-Welt<\/a><\/strong> ist eine virtuelle 3D-Welt, die 2011 gegr\u00fcndet wurde und auf OpenSimulator basiert. Sie unterh\u00e4lt sowohl <strong><a href=\"https:\/\/w4os.org\/\" target=\"_blank\" rel=\"noopener\">w4os<\/a><\/strong> und <strong><a href=\"https:\/\/opensim-helpers.dev\/\" target=\"_blank\" rel=\"noopener\">opensim-helpers<\/a><\/strong>zusammen mit mehreren anderen OpenSim-bezogenen Projekten. Urspr\u00fcnglich wurden sie f\u00fcr die Bed\u00fcrfnisse des Speculoos-Grid entwickelt, aber sie wurden als Open Source ver\u00f6ffentlicht, um sie mit der breiteren OpenSimulator-Gemeinschaft zu teilen.  <\/p>\n<p>(Originalbeitrag auf 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\">Mehr lesen<\/a>)<\/p>","protected":false},"excerpt":{"rendered":"<p>OpenSim Helpers, die Bibliothek, die den Kern des w4os-Plugins bildet, hat endlich eine richtige Installationsanleitung &#8211; und eine eigene Website: https:\/\/opensimulator-helpers.dev\/. Das war schon lange \u00fcberf\u00e4llig. Nach dem Feedback der&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1242],"tags":[],"class_list":{"0":"post-15337","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-w4os-de"},"_links":{"self":[{"href":"https:\/\/speculoos.world\/de\/wp-json\/wp\/v2\/posts\/15337","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/speculoos.world\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/speculoos.world\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/speculoos.world\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/speculoos.world\/de\/wp-json\/wp\/v2\/comments?post=15337"}],"version-history":[{"count":1,"href":"https:\/\/speculoos.world\/de\/wp-json\/wp\/v2\/posts\/15337\/revisions"}],"predecessor-version":[{"id":15344,"href":"https:\/\/speculoos.world\/de\/wp-json\/wp\/v2\/posts\/15337\/revisions\/15344"}],"wp:attachment":[{"href":"https:\/\/speculoos.world\/de\/wp-json\/wp\/v2\/media?parent=15337"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/speculoos.world\/de\/wp-json\/wp\/v2\/categories?post=15337"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/speculoos.world\/de\/wp-json\/wp\/v2\/tags?post=15337"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}