PHP-Wrapper - WordPress

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

In der folgenden ZIP-Datei sind die Dateien des Wordpress-Moduls hinterlegt.

• Aktuelle Version herunterladen
• Versionshistorie öffnen

Erweiterung installieren

Automatische Installation

Abhängig von der Wordpress-Installation kann das Plugin automatisch installiert werden.

• Klicken Sie im Administrationsbereich von Wordpress auf Plugins » Installieren und oberhalb der dargestellten Seite auf Hochladen.
• Es wird ein Formular angezeigt, über welches die ZIP-Datei hochgeladen werden kann.

Manuelle Installation

Wenn die automatische Installation nicht funktioniert / fehlschlägt, kann das Plugin von Hand installiert werden.

• Laden Sie die ZIP-Datei herunter und entpacken Sie diese auf Ihrem Rechner.
• Öffnen Sie mit einem FTP-Programm eine Verbindung zu Ihrem Server und speichen Sie den Ordner openestate-php-wrapper aus dem ZIP-Archiv auf Ihrem Webspace ab unter wp-content/plugins.

Erweiterung aktivieren

Nach erfolgter Installation (egal ob automatisch oder manuell) muss die Erweiterung in der Plugin-Verwaltung aktiviert werden (1).

Screenshots

(1) Plugin aktivieren

Erweiterung konfigurieren

Um dem Plugin mitzuteilen, wo die exportierten ImmoTool-Skripte hinterlegt sind, gehen Sie wie folgt vor.

• Öffnen Sie die Einstellungen zur Erweiterung (2).
• Tragen Sie den Server-Pfad und die URL ein, welche auf die exportierten ImmoTool-Skripte verweisen (3).
• Klicken Sie auf Speichern um die Einstellungen zu übernehmen und auf Korrektheit zu prüfen.

Screenshots

(2) Einstellungen öffnen

(3) Skript-Pfad & -URL angeben

Erweiterung verwenden

Nachdem erfolgreicher Installation des Plugins, kann man in jedem beliebigen Artikel oder jeder beliegen Seite Immobilien einbinden. Dies erfolgt über einen Platzhalter, den man sich im Einstellungs-Formular erzeugen lassen kann.

• Öffnen Sie die Einstellungen zur Erweiterung (4).
• Wählen Sie im unten dargestellten Formular aus, welche Darstellung erzeugt werden soll.
  • Es kann eine Immobilienübersicht eingebunden werden (5).
  • Es kann die Detailansicht einer Immobilie eingebunden werden (6).
• Mit jeder vorgenommenen Einstellung, wird der im gelben Bereich dargestellte Platzhalter-Code aktualisiert (7). Nachdem alle Einstellungen korrekt vorgenommenen sind, kann der erzeugte Platzhalter-Code in jedem Artikel / jeder Seite von Wordpress eingefügt werden (8).

Auf diesem Wege können beliebig viele 'Immobilien-Artikel' in WordPress integriert werden. So wäre es denkbar, getrennte Artikel für verschiedene Immobilienarten zu erzeugen (z.B. zur Trennung zwischen Wohn- & Gewerbe-Immobilien).

Screenshots

(4) Einstellungen öffnen	(5) Immobilienübersicht darstellen
(6) Detailansicht darstellen	(7) Erzeugter Platzhalter-Code
(8) Platzhalter-Code in eine Seite einbinden

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;  }

CSS-Anpassungen

Die 'kubrick'-Standard-Template von Wordpress verwendet verschiedene Stylesheets, die mit dem PHP-Export 'kollidieren', sodass Fehldarstellungen auftreten. Wenn Sie dieses Template (oder eine davon abgewandelte Form) auf Ihrer Webseite verwenden, sind einige CSS-Korrekturen nötig.

(a) Zusätzlichen Stylesheet registrieren

Bearbeiten Sie die Datei myconfig.php und nehmen Sie folgende Ergänzung vor.

  /**
   * allgemeine Konfiguration überschreiben
   */
  function load_config_default( &$config )
  {
    $config->AdditionalStylesheet = 'http://www.meinewebseite.de/immotool_export/mystyle.css';  }

(b) Stylesheet-Datei hinterlegen

Unter der in (a) konfigurierten Adresse muss eine CSS-Datei auf dem Webspace mit folgendem Inhalt hinterlegt werden.

#openestate_contentpane h1 {
  color: black;
  font-size: 1.8em;
  text-align: left;
  margin: 0;
  padding: 0;
}
 
#openestate_listing_pagination_top ul li, 
#openestate_listing_pagination_bottom ul li,
#openestate_expose_menu_top ul li,
#openestate_expose_menu_bottom ul li,
#openestate_expose_header ul li,
#openestate_expose_view_menu ul li,
#openestate_expose_gallery_thumbnails ul li,
#openestate_expose_contact_person ul li {
  padding-right: 0;
  padding-left: 0;
  margin-right: 0.3em;
  margin-left: 0.3em;
}
 
 
#openestate_listing_pagination_top ul li:before, 
#openestate_listing_pagination_bottom ul li:before,
#openestate_expose_menu_top ul li:before,
#openestate_expose_menu_bottom ul li:before,
#openestate_expose_header ul li:before,
#openestate_expose_view_menu ul li:before,
#openestate_expose_gallery_thumbnails ul li:before,
#openestate_expose_contact_person ul li:before {
  content: none;
}
 
#openestate_listing_menu form {
  text-align: left;
}
 
.openestate_listing_entry h2 {
  text-align: left;
}
 
.openestate_listing_entry div.options ul li {
  white-space: nowrap;
}

Letze Änderungen

Version 0.1

• Erste Veröffentlichung des Moduls.

Geplante Verbesserungen

• Übersetzung in weitere Sprachen.