Skip to main content

JS Radius Suche Dokumentation

Allgemein

Diese Erweiterung ermöglicht eine Umkreissuche in der Community Erweiterung „Jomsocial" von Azrul. Basierend auf der Angabe von Postleitzahl oder Ort wird das Benutzerprofil bzw. benutzerdefinierte Profils in Jomsocial durchsucht. Als Treffer werden die Benutzer mit Profilbild und Entfernungsangabe zum angefragten Ort ausgegeben. Für eine flexiblere Suche steht ein Modul zur Verfügung.

Im Moment funktioniert die JS Umkreissuche nur in Deutschland, Österreich, der Schweiz und den USA. Weitere Länder werden auf Anfrage gerne integriert.

Basis für die Umkreissuche bildet die frei verfügbare Geodatenbank: http://www.geonames.org/. Es ist keine Verbindung zu einem externen Server erforderlich, da die Daten lokal am Server verfügbar sind.

Systemvoraussetzungen / Kompatibilität

  • Joomla 1.5 oder Joomla 2.5
  • PHP 5.2.17 oder höher
  • MySQL 5.x oder höher
  • Jomsocial 2.2 oder höher (optional)

Installation / Update

Die JS Radius Suche besteht aus einer Komponente, einem Modul und einem Plugin. Die Installation erfolgt über den Joomla Installer (Erweiterungen => Erweiterungen). Alle Erweiterungen werden gemeinsam über unser Installer Package installiert. Nach der Installation bitte nicht vergessen das Plugin zu aktivieren.

Update

Sie können neue Versionen einfach mit dem Joomla Installer über die alte Version installieren. Die Dateien werden automatisch aktualisiert und die Konfigurationseinstellungen bleiben erhalten. Sie müssen die alte Version NICHT deinstallieren.

Konfiguration

Komponente

Allgemeine Einstellungen:

  • Suchradien
    Hier können Sie auswählen welche Suchradien im Frontend zur Verfügung stehen sollen. Wenn Sie z.B. wollen, dass nur eine Suche im Umkreis von 5km oder 10km möglich sein soll, dann geben Sie hier „5,10" (ohne Anführungszeichen) ein.
  • Längenangabe
    Hier können Sie die Längenangabe auswählen. Momentan können die Entfernungen nur an Hand von Kilometern angegeben werden.
  • Feld Land
    Hier müssen Sie das erweiterte Profilfeld aus Jomsocial auswählen, welches bei Ihnen das Land des Benutzers enthält. Wenn ein solches Feld nicht vorhanden ist, müssen Sie ein solches erstellen und hier festlegen.
  • Feld Postleitzahl
    Hier müssen Sie das erweiterte Profilfeld aus Jomsocial angeben, welches bei Ihnen die Postleitzahl des Benutzers enthält. Wenn ein solches Feld nicht vorhanden ist, müssen Sie ein solches erstellen und hier festlegen.
  • Länderauswahl anzeigen
    Hier können Sie auswählen ob die Länderauswahl im Suchformular angezeigt werden soll oder nicht.
  • Sortierung nach
    Hier können Sie auswählen wie die Ergebnisse der Suche sortiert werden können. Momentan können Sie entweder nach Entfernung oder nach dem Namen sortieren.
  • Reihenfolge
    Hier können Sie die Reihenfolge der Sortierung festlegen. Sie können auswählen ob die Ergebnisse aufsteigend oder absteigend sortiert werden.
  • Sortierung möglich
    Hier können sie festlegen ob die Sortierung der Suchergebnisse im Frontend möglich sein soll oder nicht.

Suche: Username

  • Name des Users
    Hier können Sie festlegen ob nach dem richtigen Namen der User gesucht werden soll.
  • Username
    Hier können Sie festlegen ob nach dem Benutzernamen der User gesucht werden soll.

Suche: JS Textfelder

Hier können Sie festlegen welche erweiterten Profilfelder aus Jomsocial in die Suche einbezogen werden. Sie können hier entweder „Keine", „Alle" oder bis zu drei speziell definierte Felder festlegen. Bitte beachten Sie, dass diese Einstellungen hier nur auf den Typ „textbox" und „textarea" gelten! Es werden darum in dem Dropdown auch nur Felder mit diesen Typen aufgelistet.

  • Felder durchsuchen
    Auswahl ob und wenn ja, welche Felder durchsucht werden sollen.
  • Feld 1, 2 und 3
    Aktivieren bzw. deaktivieren der Suche in dem entsprechenden Feld unterhalb.
  • JS Feld
    Auswahl des erweiterten Profilfelds, dass in die Suche eingebunden werden soll.

Filter: JS Selectfelder

Hier können Sie bis zu zwei erweiterte Profilfelder in die Suche einbinden, die vom Typ ein „Select" sind. Es werden darum in dem Dropdown auch nur Felder mit diesen Typen aufgelistet.

  • Feld 1 und 2
    Aktivieren bzw. deaktivieren der Suche in dem entsprechenden Feld unterhalb. Die aktivierten Felder werden auch im Frontend zur Definition der Suche angezeigt.
  • JS Feld
    Auswahl des erweiterten Profilfelds, dass in die Suche eingebunden werden soll.

Benutzer

Eine Auflistung der vorhandenen Benutzer mit dem Land, der Postleitzahl, dem Breiten- und dem Längengrad.

Über den Button „User aktualisieren" können die Breiten- und Längengrade zu den Usern neu berechnet werden.

Länder

Eine Auflistung der installierten Länder. In diesem Bereich ist es möglich einzelne Länder zu aktivieren bzw. zu deaktivieren. Über den Button „Standard" kann bzw. muss ein Land als Standardland festgelegt werden.

Verisonshistorie

Hier erhalten Sie eine Auflistung der Änderungen und Fehlerbehebungen an der Erweiterung.

Suchmodul

  • Module Class Suffix
    Eine Suffix, die an die CSS Klasse des Moduls angehängt wird. Dadurch besteht die Möglichkeit ein individuelles Modullayout zu erstellen.
  • Länderauswahl anzeigen
    Hier können Sie auswählen ob die Länderauswahl im Suchformular des Moduls angezeigt werden soll oder nicht.

Plugin

Das Plugin ist für die Lokalisierung der Benutzer( Berechnung des Längen- und Breitengrads in den Benutzerprofilen) verantwortlich. Die benötigten Einstellungen müssen in der Konfiguration der Komponente vorgenommen werden.
Nach der Installation bitte nicht vergessen das Plugin zu aktivieren.