![]() | ||||||||
![]() |
Karte | Kalender | Suche | Bookmarks | Experte | FAQ |
ModuleDownloadSMFinder_Help_FAQWird verwendet von:SMFinder_Help Keine Erläuterungen gefunden. <?php /* published under GPL www.gnu.org/licenses/gpl.html */ ?> <h1>Fragen und Antworten zum SM-Finder</h1> <h2>Rubriken</h2> <ul> <li> <a href="#about">Zielbeschreibung - Was ist der SM-Finder?</a> </li> <li> <a href="#WoliegtderNutzenfrmich">Wo liegt der Nutzen für mich...</a> </li> <li> <a href="#Wiekannich">Wie kann ich...</a> </li> <li> <a href="#SMFinderArbeitskreisBVSMWiehngtdaszusammen">SM-Finder? Arbeitskreis? BVSM? - Wie hängt das zusammen?</a> </li> <li> <a href="#Rechtlichesundfinanzielles">Rechtliches und finanzielles</a> </li> <li> <a href="#EintrgeundnichtEintrge">Einträge und nicht-Einträge</a> </li> <li> <a href="#Technik">Technik</a> </li> </ul> <hr><a name='about'></a> <h2>Zielbeschreibung - Was ist der SM-Finder?</h2> <p>Der SM-Finder will einen möglichst vollständigen, aktuellen Überblick über alle Projekte, Gruppen, etc. der nichtkommerziellen SM-Szene in Deutschland erarbeiten und anbieten. Dazu gehören zum Beispiel die Beschreibungen und Kontaktadressen der Gruppen, ihre Termine und Veranstaltungen und ihre Angebote für die Szene.</p> <p>Diese Informationen sollen allen Interessenten möglichst einfach, übersichtlich und kostengünstig zur Verfügung stehen, sei es im Web, per Abruf (Mail, Fax) oder als gedruckte Broschüre.</p> <p><strong>Noch eine Gruppenliste?</strong></p> <p>Nein, eine Vernetzung der bestehenden Listen. Wo immer möglich soll mit existierenden Vernetzungs-Projekten zusammengearbeitet werden, zum Beispiel dem <a href='http://www.bizarre-talk.org/bdsm-stammtische/index2.html' target='_blank'>BDSM-Stammtische-Netz</a>, der <a href='http://www.schlagworte.org/' target='_blank'>Schlagworte-Mailingliste</a> und Communities/Magazinen wie <a href='http://lustschmerz.de' target='_blank'>Lustschmerz</a> oder den <a href='http://schlagzeilen.com' target='_blank'>Schlagzeilen</a>. Das vermeidet nicht nur doppelte Arbeit, sondern sorgt durch mehrere Augen auch dafür, dass die Informationen verlässlich sind. </p> <p><strong>Ein Netzwerk?</strong></p> <p>Im Idealfall kann durch diese Zusammenarbeit ein gleichberechtigtes Informationsnetzwerk geschaffen werden, bei dem Änderungen und Neuigkeiten (Termine, Veranstaltungen, neue Gruppen) an einer beliebigen Stelle des Netzes eingegeben werden und sich automatisch an alle Teilnehmer verbreiten.</p> <h2> <a name="WoliegtderNutzenfrmich"></a>Wo liegt der Nutzen für mich...</h2> <p> <strong>... als "Otto Normal-SMler"?</strong> </p> <p> <answer>Aktualität und Verfügbarkeit: Die Adressen und Termine sind bei allen angeschlossenen Sites stets aktuell und überall zu finden. Falsche und überholte Informationen werden schnell überall ausgetauscht. Du kannst mit einem Zugriff alles finden, statt an mehreren Stellen zu suchen und immer noch nicht sicher zu sein, alle Infos gefunden zu haben. </answer> </p> <p> <strong>... als Webseiten-Betreiber?</strong> </p> <p> <answer>Arbeitsersparnis: Der automatische Abgleich ist eine Sache von wenigen Minuten, egal wie viele Neuigkeiten reinkommen. Sobald deine Webseite aus den Daten der SM-Finder XML-Datei gespeist wird (s.u.), kannst du sie in kürzester Zeit ohne manuelle Nacharbeit akualisieren. <br> <br> Mehr Angebot: Du kannst deinen Besuchern das volle Programm bieten, gefiltert und gesichtet nach deinen Vorstellungen. </answer> </p> <p> <strong>... als Gruppen/Stammisch/etc.-Organisator?</strong> </p> <p> <answer>Vereinfachung: Du brauchst in Zukunft deine Adressänderungen und Termine nur einmal einzugeben, denn sie verbreiten sich automatisch zu allen angeschlossenen Sites. Das heisst für dich: Keine Serienmails mehr. <br> <br> Die Eintragung kann übrigens überall erfolgen, wo ein Betreiber eine entsprechende Möglichkeit anbietet. </answer> </p> <hr> <h2> <a name="Wiekannich"></a>Wie kann ich...</h2> <p> <strong>... (m)eine Adresse / Gruppe / Stammtisch in den SM-Finder eintragen?</strong> </p> <p> <answer>Hier auf unserer Webseite zum Beispiel. Dafür gibt es das <?php echo "<a href='".$_SERVER['PHP_SELF']."?what2do=edit'>Eingabeformular</a>."; ?> Dort kannst du alle Angaben eintragen, Ansprechpartner hinzufügen, etc. Wie das im Detail funktioniert ist ausführlich unter <?php echo "<a href='".$_SERVER['PHP_SELF']."?what2do=help&sec=editAddress'>Adresse eingeben</a>"; ?> erklärt.<br> <em>Niemandem ist geholfen, wenn sich alle Einträge in allen Kategorien finden. Je mehr Kategorien oder Attribute du für euren Eintrag auswählst, desto wahrscheinlicher wird sich einer der Redakteure eure Seite flüchtig ansehen und die Katalogisierung zurechtstutzen.</em><br> <br> Als Ergebnis bekommst Du einen "XML-Schnipsel" angezeigt, den du später verwenden kannst, um deinen Datensatz zu modifizieren.<br> </answer> </p> <p> <strong>... die SM-Finder-Daten auf meiner Webseite anzeigen?</strong> </p> <p> <answer> Zunächst musst du dir alle Einträge <?php echo "<a href='".$_SERVER['PHP_SELF']."?what2do=admin'>herunterladen</a>."; ?> (Das dort als Default eingegebene Gründungsdatum der BVSM stellt sicher, dass du sämtliche vorhandenen Einträge bekommst. Wenn du später deinen Datensatz mit einem der anderen Server abgleichen möchtest, gibst du das Datum deiner letzten Aktualisierung ein und erhäst ausschließlich die seitdem modifizierten Datensätze.)<br> So erhälst du die Daten im XML-Format als Datei <tt>sm-finder.xml</tt>.</p> <p>Um aus der XML-Datei eine ansprechende Webseite zu machen gibt es verschiedene Optionen: <ol> <li> Du kannst dir eine eigene <a href="http://selfhtml.teamone.de/xml/darstellung/xslgrundlagen.htm" target="_blank">XSLT-Datei</a> basteln. Mit dieser Datei und einem XSLT-Konverter wird dann normales HTML erzeugt.<br> Als Beispiel kann dir hierzu die Version <a href='http://www.BDSM-Howto.de/sm-finder/index.php?what2do=Download'>SM-Finder 1.0</a> helfen.<br> Mehr über XML, DTD, XSLT, und eine Liste von <a href="http://selfaktuell.teamone.de/links/xml.htm" target="_blank">Links</a> und <a href="http://selfaktuell.teamone.de/links/xml_software.htm" target="_blank">XML-Software</a> steht bei <a href="http://selfhtml.teamone.de" target="_blank">SelfHTML</a> --> <a href="http://selfhtml.teamone.de/xml/index.htm" target="_blank">XML/DTDs</a>. </li> <li>Sofern du eine MySQL-Datenbank einsetzen möchtest, kannst du die hier genutzten <?php echo "<a href='".$_SERVER['PHP_SELF']."?what2do=modules'>Module</a>"; ?> herunterladen und bei dir installieren und das Aussehen deiner Seite anpassen.<br>Wie das geht, ist ausführlich unter <a href='http://www.BDSM-Howto.de/sm-finder/index.php?what2do=Download'>Download</a> beschrieben.</li> <li> Neu ist die Option, den SM-Finder einfach per <tt>iframe</tt> in deine eigene Seite einzubinden: <pre> <iframe src="http://localhost/~www/sm-finder.de/index.php?pageID=003&what2do=map" width="770px" height="700px" name="SM-Finder"> <p>Ihr Browser kann leider keine eingebetteten Frames anzeigen: Sie finden den SM-Finder aber direkt unter: <a href="http://www.sm-finder.de">SM-Finder.de</a>.</p> </iframe> </pre> Als Einstiegsoptionen bieten sich an: <tt>what2do = [map,calendar,search]</tt>, oder du zeigst direkt alle Einträge in deiner Umgebung, indem du den entsprechenden Link aus der Übersichtskarte übernimmst.<br> Du kannst dann das <a href='index.php?what2do=modules&modul=SMFinder_Style'>SMFinder_Style.css</a> an deine Bedürfnisse anpassen und teilst und die URL mit, wo wir dein Stylesheet finden. </ol> </answer> </p> <p> <strong>... beim SM-Finder mitmachen?</strong> </p> <p> <answer>Abstimmung und Diskussion finden statt auf der <a href="http://lists.sm-finder.de/listinfo/smfinder-technik">Mailingliste</a>. Dort solltest Du Dich einschreiben und einfach fragen, was zu tun ist. </answer> </p> <p> <strong>... meine Adressliste mit dem SM-Finder abgleichen?</strong> </p> <p> <answer>Indem du mit uns absprichst, wie wir deine Liste im XML-Format bekommen können. Wir arbeiten deine Neuigkeiten dann in unseren Stand ein und stellen dies aktualisiert auf unserer Seite bereit. <br> <br> Umgekehrt kannst du deinen Stand stets mit unserer Version abgleichen, indem du alle seit deinem letzten Abgleich geänderten Einträge <?php echo "<a href='".$_SERVER['PHP_SELF']."?what2do=admin'>herunterlädst</a>."; ?> <br> <br> Das Datenaustauschformat ist extra dafür ausgelegt, automatisch verschiedene Stände miteinander zu synchronisieren, so wie man die Adressen und Termine zwischen PDA und PC synchronisiert. Der AK arbeitet gerade an den entsprechenden Werkzeugen und Programmen, die dann für alle Nutzer verfügbar gemacht werden. </answer> </p> <hr> <h2> <a name="SMFinderArbeitskreisBVSMWiehngtdaszusammen"></a>SM-Finder? Arbeitskreis? BVSM? - Wie hängt das zusammen?</h2> <p> <strong>Welche Organisation steckt hinter dem SM-Finder?</strong> </p> <p> <answer>Eine lose Gruppe von Menschen, die dieses Projekt mitgestalten wollen. Es gibt keine Struktur, keine Hierarchie, sondern nur Menschen die Aufgaben übernehmen. Einzige "offizielle" Funktion ist die des Ansprechpartners für die BVSM, weil der SM-Finder korporatives Mitglied ist. </answer> </p> <p> <strong>Wie hängt der SM-Finder mit der BVSM zusammen?</strong> </p> <p> <answer>Der AK ist korporatives Mitglied der BVSM. Das heisst er (seine Mitmacher) haben sich grundsätzlich mit den Zielen des BVSM einverstanden erklärt. Der AK ist eigenständig und arbeitet und entscheidet unabhängig von der BVSM. </answer> </p> <p> <strong>Wie wird man Mitglied beim AK SM-Finder?</strong> </p> <p> <answer>Einfach indem man mitmacht, also sich auf die <a href="http://lists.sm-finder.de/listinfo/smfinder-technik" target="_blank">Mailingliste</a> einschreibt und an den Diskussionen und der Arbeit teilnimmt. </answer> </p> <p> <strong>Muss man dazu BVSM-Mitglied werden?</strong> </p> <p> <answer>Nein. Für die Mitarbeit im AK SM-Finder muss man kein Mitglied von irgendwas sein oder werden. Man sollte aber mit den Zielen der BVSM einverstanden sein, denn das steckt in der korporativen Mitgliedschaft des AK SM-Finder in der BVSM.</answer> </p> <hr> <h2> <a name="Rechtlichesundfinanzielles"></a>Rechtliches und finanzielles</h2> <p> <strong>Was kostet der SM-Finder / die Teilnahme / die Verwendung der Daten?</strong> </p> <p> <answer>Der SM-Finder ist nicht käuflich, weder die Mitglieder, noch die Daten. Der SM-Finder arbeitet kostenlos für die nicht- kommerzielle BDSM-Szene. <br> <br> Die Daten, Programme, Skripte dürfen kostenfrei benutzt werden, wenn das daraus entstehende Angebot ebenfalls kostenfrei ist, zum Beispiel kostenfreie Webseiten, kostenlos verteilte Flyer, Broschüren, usw.. </answer> </p> <p> <strong>Darf ich die Daten für eine kommerzielle Anwendung nutzen?</strong> </p> <p> <answer>Nein. Eine Nutzung für kommerzielle Zwecke wird hiermit ausdrücklich untersagt. Dies betrifft sowohl die direkte Nutzung (z.B. Verkauf, Vermietung, etc. der Daten), wie auch die indirekte Nutzung (z.B. Werbung für komerzielle Zwecke an die angegebenen Adressen). <br> <br> Vom <em>Sinn</em> (nicht vom Wortlaut her) her folgt die Nutzungserlaubnis des SM-Finders der <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>. <br> (Wird noch ergänzt) </answer> </p> <p> <strong>Wer haftet für die Richtigkeit der Daten?</strong> </p> <p> <answer>Niemand. Wir sind bemüht, die Daten nach bestem Wissen auf dem neuesten Stand zu halten, aber wir übernehmen keinerlei Garantie für Aktualität und/oder Richtigkeit der Angaben, ebensowenig für Daten, die von Teilnehmern des Austauschnetzwerks eingespeist werden. Insbesondere haften wir nicht für Schäden, die aus einer Fehlinformation resultieren. </answer> </p> <hr> <h2> <a name="EintrgeundnichtEintrge"></a>Einträge und nicht-Einträge</h2> <p> <strong>Welche Arten von Einträgen werden aufgenommen?</strong> </p> <p> <answer>Grundsätzlich aufgenommen werden alle mit dem BVSM assoziierten Gruppen, Arbeitskreise, etc., die sich zu den Grundsätzen des BVSM bekennen.<br> <br> Ebenfalls unstrittig sind alle nicht-kommerziellen Angebote aus dem Bereich BDSM, wie Stammtische, Munches und dergleichen. <br> <br> In der Diskussion ist noch, ob, wie und in welcher Form rein kommerzielle Angebote wie Parties, Shops usw. aufgenommen werden. <br> <br> Die Diskussion darüber findet auf der Mailingliste statt. </answer> </p> <p> <strong>Was wird nicht aufgenommen?</strong> </p> <p> <answer>Der SM-Finder listet grundsätzlich keine pornografischen Angebote, keine Stories, keine Bilder-Sites. Der SM-Finder listet auch keine rein persönlichen Webseiten o.ä., solange diese keine Sachinformationen von allgemeinem Interesse enthalten. </answer> </p> <hr> <h2> <a name="Technik"></a>Technik</h2> <p> <strong>Wieso XML?</strong> </p> <p> <answer>XML wird durch die Werkzeuge dazu zu einer sehr mächtigen Form der Datenkodierung. In einer einzigen XML-Datei können nicht nur die reinen Daten, sondern auch die Querverbindungen zwischen ihnen kodiert werden, zum Beispiel zwischen Gruppen und ihren Veranstaltungen. Mithilfe von XSLT- Skripten oder DOM/XPATH-Funktionen werden aus dieser Komplettdatei die jeweiligen Daten gewonnen, zum Beispiel für die Liste aller Angebote auf der Ausgabe als Webseite. <br> <br> Mit dem XML-Format kann der komplette Datenbestand des SM- Finders in einer unkomplizierten, leicht zu speichernden und leicht zu verarbeitenden Form zusammengehalten werden. Bei Bedarf können daraus auch leicht andere Formate erzeugt werden. </answer> </p> <p> <strong>Wie funktioniert der Abgleich verschiedener Versionen?</strong> </p> <p> <answer>Jeder Eintrag, Adresse oder Termin, hat zwei Pflichtangaben, über die der Abgleich gesteuert wird: <em>uid</em> und <em>last-mod</em> (s. die <?php echo "<a href='".$_SERVER['PHP_SELF']."?what2do=dtd'>DTD</a>"; ?> ). <br> <br> Die <em>unique id</em> (<em>uid</em>) ist die eindeutige Kennung eines Eintrags. Bei der Synchronisation werden jeweils die Einträge mit der gleichen <em>uid</em> aus den zu synchronisierenden Dateien verglichen. <br> <br> Anhand des Zeitstempels der <em>last modification</em> (<em>last-mod</em>) kann festgestellt werden, welcher von zwei Einträgen neuer ist und damit übernommen werden muss. Auf diese Weise können zwei Dateien durch paarweisen Vergleich ihrer Einträge auf den neuesten Stand gebracht werden. <br> <br> </answer> </p> <p> <strong>Welche Technik wird für die Synchronisation benötigt?</strong> </p> <p> <answer>Sofern du mit Datenbanken arbeitest, findest du im Adminbereich die Funktion <strong>uploadXML</strong> <!-- <?php echo "<a href='".$_SERVER['PHP_SELF']."?what2do=uploadXML'>XML upload</a>"; ?> --> , mit der du einen XML-Datensatz laden und importieren kannst.</answer> </p> <strong>Wie kriege ich einen Punkt zu meinem Eintrag in die Karte (an die richtige Stelle)?</strong> </p> <p> <answer>Um als Punkt in der Karte zu erscheinen, musst du wenigstens eine Adresse zu deinem Eintrag angeben. Am genauesten funktioniert es, wenn du selbst die geographischen Angaben eintippst, alternativ versuchen wir die Daten an Hand der Postleitzahl zu erraten.<br> Und sobald die Karte von uns neu generiert wurde, findet sich auch zu deiner Stadt ein Punkt in der Karte.</answer> </p> <!-- <hr> <a name="instal"></a> <?php echo "<p><strong>Wie richte ich den SM-Finder bei mir ein?</strong></p> siehe <a href='".$_SERVER['PHP_SELF']."?what2do=Download'>Download</a>"; ?> <p><answer>Technische Voraussetzungen sind <tt>php</tt> und <tt>mySQL</tt> auf deinem Server.<br> <em>Falls du das selbst einrichtest und am Ausprobieren bist beachte, dass du die Seiten nur in deinem Browser über </em><tt>http://localhost/SMFinder_Karte.php</tt><em> angezeigt bekommst. Der Aufruf der Datei in einem Dateimanager zeigt typischerweise den Sourcecode. <br> Falls du die Fehlermeldung </em><tt>Can't connect to local MySQL server through socket</tt><em> bekommst, läuft das mySQL noch nicht. Tippe dann in einer root-shell </em><tt>rcmysql start</tt><em> ein.</em></p> <ol> <li>Lege ein Verzeichnis <tt>sm-finder</tt> an.</li> <li>Lade dir den Sourcecode runter und speichere ihn in diesem Verzeichnis:<br> <?php echo "<a href='".$_SERVER['PHP_SELF']."?what2do=Download'>SMFinder.tar.gz</a></li>"; ?> <li>Die Datei ist komprimiert:<br><tt>gunzip SMFinder.tar.gz</tt></li> <li>Entpacke die Datein, hierbei sollte <tt>src/</tt> entstehen:<br><tt>tar -xvf SMFinder.tar</tt></li> <li>Gehe in das Verzeichnis:<br><tt>cd src/</tt></li> <li>Bastel die einzelnen Funktionen zu den Modulen zusammen:<br><tt>make build</tt></li> <li>Wenn du noch die Modulübersicht mit Erklärungen möchtest:<br><tt>make doc</tt></li> <?php echo "<li>Jetzt fehlt dir eine Datenbank mit mehreren relationalen Tabellen: <a href='".$_SERVER['PHP_SELF']."?what2do=help&sec=DB'>SMFinder_Datenbanken</a>.<br>"; ?> Um auf deine Datenbanken zugreifen zu können musst du <br><tt>SMFinder_DB.php</tt> anpassen. (Der $sitename dient lediglich dazu nachvollziehen zu koennen, wo Eintraege erstellt wurden.)</li> <li>Um die geografischen Angaben einmalig in die DB zu füttern, lege dir <tt>/sm-finder/text/</tt> an und kopiere <tt>opengeodb-0.2.2e-UTF8-text-plz.txt</tt> von <a href="http://www.OpenGeoDB.de">OpenGeoDB</a> hinein.<br> Anschließend klickst du in <tt>SMFinder_Admin.php</tt> auf <tt>PLZ2DB</tt>.</li> <li>Um das Layout der Seiten deiner eigenen HP anzupassen kannst du in <tt>SMFinder_Style.css</tt> zentral alle Farben festlegen.<br> Danach musst du nur noch <tt>SMFinder_Frame_Head.php</tt>, <tt>SMFinder_Frame_Foot.php</tt> und <tt>Menu.php</tt> deinen Vorstellungen anpassen.</li> <li>Wenn dir jetzt noch Grafiken fehlen, sollte dir <a href='http://www.BDSM-HowTo.de/sm-finder/Grafik.tar.gz'>Grafik.tar.gz</a> weiterhelfen.</li> <li>Diese Änderungen werden mit einem abschließenden <tt>make build</tt> eingebaut.</li> </ol> <p><em>Du hast keinen blassen Schimmer, was diese kryptischen Befehle bedeuten und es scheitert schon an der Shell, in die man sie eintippen könnte?<br> Dann benutzt du vermutlich irgendein exotisches Betriebssystem mit bunter Oberfläche.<br> In dem Fall solltest du dir </em><a href="http://www.cygwin.com/">cygwin</a><em> installieren.<br> Viel Erfolg!</em></answer></p> --> <?php ?> IndexFür die Funktionalität des SM-Finders sind viele kleine Tools notwendig. Alle Funktionen beginnen mit SMFinder_ um deren Ursprung zu kennzeichnen. Dem schließt sich die Funktionsgruppe, z.B. Geo_ an, gefolgt vom eigentlichen Namen, der die Aufgabe der Funktion widerspiegeln soll, z.B. PLZ2DB. Der gesamte Sourcecode darf gemäß GNU General Public License weiterverbreitet werden. |
![]() |
Die hier zur Verfügung gestellten Informationen basieren auf dem Austauschnetzwerk des SM-Finders.
Änderungen an eurem Datensatz könnt ihr z.B. beim Arbeitskreis SM-Finder vornehmen.
Bei Fragen und Problemen schreibt bitte an: sm-finderki-co.org
Der AK-SM-Finder ist korporatives Mitglied der BVSM e.V.
Für Aktualität und Richtigkeit der dargebotenen Infomationen kann keine Gewähr übernommen werden!