Module

SMFinder_Help_FAQ

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 
?>

Index

Fü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.

Datenbanken

• Eintrag erstellen, ändern, löschen
• Hilfe, FAQ
• Datenabgleich