PHP-Wrapper - Joomla

Aus OpenEstate-Wiki

Erweiterung herunterladen

Lizenzhinweis

Die PHP-Skripte können gemäß den Bedingungen der GPL3-Lizenz verwendet werden. Mit dem Download der Dateien akzeptieren Sie die Lizenzbedingungen.

Download

Die OpenEstate-Komponente kann als ZIP-Datei heruntergeladen und in Joomla installiert werden.

Automatische Aktualisierung

Mit Joomla 1.6 ist eine automatische Benachrichtigung sowie Installation von Aktualisierungen möglich. Im OpenEstate-Wiki wird dafür eine extension.xml bereitgestellt, die von Joomla zur automatischen Aktualisierung heruntergeladen wird.

Erweiterung installieren

Die Erweiterung kann als Komponente in Joomla eingebunden werden.

Komponente installieren

Die Komponente kann mit den von Joomla bereitgestellten Mechanismen unkompliziert installiert werden.

• Melden Sie sich ggf. im Administrationsbereich von Joomla an.
• Klicken Sie im Hauptmenü auf Erweiterungen » Installieren/Deinstallieren.
• Klicken Sie auf Durchsuchen und wählen Sie die heruntergeladene Paketdatei aus.
• Klicken Sie auf Datei hochladen & installieren um die Installation durchzuführen.
• Um zu prüfen, ob die Installation korrekt verlief, klicken Sie auf den Bereich Komponenten. In der dargestellten Tabelle sollte die Komponente OpenEstate dargestellt werden.

Screenshots

Bereich zur Installation von Komponenten öffnen	ZIP-Datei zur Installation hochladen
Eintrag der OpenEstate-Komponente nach erfolgreicher Installation

Komponente konfigurieren

Nachdem die Komponente erfolgreich installiert wurde, müssen vorab einige Einstellungen vorgenommen werden.

• Melden Sie sich ggf. im Administrationsbereich von Joomla an.
• Klicken Sie im Hauptmenü auf Komponenten » OpenEstate.org » Wrapper.
• Im folgenden Formular muss dem Wrapper mitgeteilt werden, wo auf dem Server der PHP-Export abgelegt wurde.
  • Tragen Sie als Skript-Pfad den vollständigen Pfad ein, wo der PHP-Export zu finden ist. Dieser Pfad wird benötigt, um die exportierten PHP-Skripte innerhalb Joomla ausführen zu können.
  • Tragen Sie als Skript-URL eine Web-Adresse ein, die auf den PHP-Export verweist. Diese Adresse wird benötigt, um z.B. die Bilder des Exportes korrekt darstellen zu können.

Screenshots

Bereich zur Konfiguration des Wrappers öffnen	Pfad & URL des PHP-Exportes eintragen
PHP-Export wurde korrekt konfiguriert

Erweiterung verwenden

Nachdem die Komponente erfolgreich eingerichtet wurde, kann man beliebig viele Menüpunkte erzeugen und mit der OpenEstate-Komponente verknüpfen.

• Melden Sie sich ggf. im Administrationsbereich von Joomla an.
• Klicken Sie im Hauptmenü auf Menüs » Main Menu (oder ein anderes Menü Ihrer Wahl)
• Klicken Sie oben rechts auf Neu um einen neuen Menüeintrag zu erzeugen.
• Wählen Sie im folgenden Formular die Komponente OpenEstate.org aus. Folgende Ansichten werden bereitgestellt:
  • In der Tabellenansicht wird eine Übersicht der vorhandenen Immobilien dargestellt.
  • In der Exposéansicht werden die Details einer einzelnen Immobilie dargestellt.
• Im folgende Formular können verschiedene Einstellungen vorgenommen werden, um die Darstellung der Komponente zu beeinflussen. (Sprache, Filter, Sortierung, etc.)

Screenshots

Bereich zum Hinzufügen eines Menüeintrages öffnen	Einen neuen Menüeintrag hinzufügen	Auswahl der OpenEstate-Komponente zum neuen Menüpunkt
Eckdaten zum Menüpunkt eingeben	Spezifische Einstellungen der OpenEstate-Komponente eingeben

Besonderheiten

Allgemeine Stylesheets deaktivieren

Um Darstellungsprobleme bei der Einbindung mit den bereits existierenden CSS-Stylesheets zu vermeiden, sollte die Konfigurationsvariable $ShowGeneralStyles deaktiviert werden. Bearbeiten Sie dafür die Datei myconfig.php und ergänzen Sie folgenden Eintrag.

  /**
   * Konfiguration des Stylesheets überschreiben.
   * @param object $config Konfigurations-Objekt
   */
  function load_config_style( &$config )
  {
    // allgemeine Konfiguration (siehe oben)
    immotool_myconfig::load_config_default( $config );
 
    // ggf. individuelle Konfigurationswerte einfügen
    $config->ShowGeneralStyles = false;  }

Probleme bei Speicherung der Session in der Datenbank

An verschiedenen Stellen werden Sessions in den PHP-Exportskripten verwendet. Joomla stellt eine Option zur Verfügung, um Sessions in der Datenbank zu speichern. Diese Option führt jedoch an verschiedenen Stellen bei der Einbindung des PHP-Exportes zu Problemen:

• Verschiedene Informationen werden nicht dauerhaft zwischengespeichert. Dies erhöht die Ladezeiten bei jedem Seitenaufruf.
• Das Captcha im Kontaktformular kann nicht verwendet werden. Wenn Sie dennoch die 'Datenbank-Sessions' von Joomla verwenden möchten, muss die Captcha-Darstellung deaktiviert werden um eine Kontaktanfrage senden zu können.

Lösung (1): Datenbank-Sessions in Joomla deaktivieren

Die Einstellung zur Speicherung der Sessiondaten kann im Administrationsbereich von Joomla (Abschnitt Konfiguration) verändert werden.

Screenshots

Konfiguration im Joomla-Adminbereich öffnen

Auswahl der Speicherroutine für Sessiondaten auf Keine setzen.

Lösung (2): Captcha-Funktion des PHP-Exportes deaktivieren

Wenn Lösung (1) nicht in Frage kommt, kann alternativ folgender Eintrag in der myconfig.php eingetragen werden, um die Captcha-Funktion zu deaktivieren:

  /**
   * Konfiguration der Exposédarstellung überschreiben.
   * @param object $config Konfigurations-Objekt
   */
  function load_config_expose( &$config )
  {
    // allgemeine Konfiguration (siehe oben)
    immotool_myconfig::load_config_default( $config );
 
    // ggf. individuelle Konfigurationswerte einfügen
    $config->ShowContactCaptcha = false;  }

Letze Änderungen

Version 0.1.4 / 0.2.4

• Kompatibilität mit Joomla 2.5 (betrifft v0.2.4)
• Die gewählte Sprache wird als META-Tag 'language' in die erzeugte Seite übernommen.
• Der Titel einer Immobilie wird in der Exposéansicht als TITLE-Tag in die erzeugte Seite übernommen.
• Der Text 'Kurzbeschreibung' einer Immobilie wird in der Exposéansicht als META-Tag 'description' in die erzeugte Seite übernommen.
• Der Text 'Schlüsselworte' einer Immobilie wird in der Exposéansicht als META-Tag 'keywords' in die erzeugte Seite übernommen.
• Der allgemeine Stylesheet (style.php) sowie der eigene hinterlegte Stylesheet ($AdditionalStylesheet) wird im HEAD-Bereich der erzeugten Seite dargestellt.

Version 0.1.3 / 0.2.3

• Beim Wechsel zwischen mehreren Immobilienseiten sollen die vom Besucher gewählten Filter-Einstellungen zurückgesetzt werden. (siehe Forum)
• Während ein Export durchgeführt, wird nicht mehr der Text 'Fehler' sondern statt dessen 'Hinweis' dargestellt. (siehe Forum)
• Ein Problem mit suchmaschinenfreundlichen URL's (URL-Rewrite) wurde korrigiert, das bisher nur bei 1&1-Hosting-Paketen auftrat.

Version 0.1.2 / 0.2.2

• Überprüfung und Fehlermeldung auf der Webseite, wenn zeitgleich ein PHP-Export via ImmoTool durchgeführt wird. (siehe Bug-Tracker #594)
• Verbesserter Umgang mit suchmaschinenfreundlichen URL's bei aktiviertem und deaktiviertem mod_rewrite. (siehe Joomla Dokumentation)
• Beim Bearbeiten eines OpenEstate-Menüeintrages kann zusätzlich ein Text (oder HTML-Code) hinterlegt werden, der vor oder hinter der OpenEstate-Einbindung dargestellt wird.
• Fehler bei der Immobiliensuche in mehrsprachigen Installationen von Joomla 1.6. (siehe Hinweis im Forum)

Version 0.1.1 / 0.2.1

• Inkompatiblität mit Internet Explorer behoben (siehe Hinweis im Forum)

Version 0.2

• Erste Veröffentlichung des Moduls für Joomla 1.6.

Version 0.1

• Erste Veröffentlichung des Moduls für Joomla 1.5.

Geplante Verbesserungen

• Übersetzung in weitere Sprachen.