OpenImmo2WP: Absatzüberschriften im Beschreibungstext ergänzen

Wir haben unser OpenImmo2WP-Plugin für WordPress mit dem Ziel entwickelt, die einfachst mögliche Lösung für die Meisterung der komplexen Aufgabe des regelmäßigen Imports von OpenImmo-Daten, zu entwickeln.

Neben der konsequenten Limitierung der Konfigurationsoptionen zur Reduzierung der Komplexität haben wir das erreicht durch direkt einsatzbereite Daten-Zuordnungstabellen und spezialisierten Schnittstellencode für jedes unterstützte Theme/Plugin. (Natürlich arbeiten wir nach wie vor an der Optimierung der Software, um sie noch einfacher zu machen.)

Die Zuordnung der OpenImmo-Elemente zu den entsprechenden themespezifischen, benutzerdefinierten Feldern („Mapping”) kann ohne Programmieraufwand durch das einfache Anpassen der jeweiligen Standard-Mapping-Tabelle realisiert werden. Hierfür kann eine Tabellenkalkulation wie LibreOffice Calc verwendet werden, mit der die Tabelle bearbeitet und anschließend als CSV-Datei exportiert wird.

Nichtsdestotrotz gibt es Fälle, in denen eine individuellere Verarbeitung der Importdaten erforderlich ist. Hier kommen benutzerdefinierte Funktionen ins Spiel, mit denen nach dem „Einklinken“ über diverse vom Plugin bereitgestellte Filter/Action-Hooks nahezu jedes Detail des Importvorgangs angepasst werden kann.

Seit dem Aufbruch zu unserer „WordPress-OpenImmo-Reise” haben wir bereits viele solcher Funktionen mit unterschiedlichsten Zielsetzungen für unsere Plugin-Nutzer entwickelt. So ist mit der Zeit ein ansehnlicher Bestand an Best-Practice-Beispielen entstanden.

Mit diesem Beitrag beginnen wir nun endlich damit, diese Beispiele auf Basis einer wöchentlichen Blog-Artikel-Serie zu veröffentlichen, die wir so nennen:

Snippet der Woche (bzw. Hashtag #SnipOTW)

Wir beginnen mit einem Klassiker: Die meisten Immobilien-Themes stellen keine separaten Felder für die Beschreibung des Objekts sowie dessen Lage und Ausstattung bereit. Aus diesem Grund werden die entsprechenden OpenImmo-Details beim Import meist in einem einzelnen Text zusammengefügt.

Diese kombinierten Abschnitte enthalten normalerweise keine Überschriften oder anderweitige Trennelemente. Das kann durch Ergänzen der folgenden beiden Filterfunktionen in der functions.php-Datei des (Child-)Themes (oder einer anderen passenden Datei) geändert werden:

/**
* Absatzüberschriften im Haupt-Beschreibungstext der Immobilie ergänzen.
*/
add_filter( 'immonex_oi2wp_add_post_data_element', 'mysite_add_section_headlines', 10, 3 );
function mysite_add_section_headlines( $value, $immobilie, $mapping ) {
if ( ! trim( $value ) ) return $value;
switch( $mapping['source'] ) {
case 'freitexte->objektbeschreibung+' :
$value = '<h3>Objektbeschreibung</h3>' . "\n$value\n";
break;
case 'freitexte->lage+':
$value = '<h3>Lage</h3>' . "\n$value\n";
break;
case 'freitexte->ausstatt_beschr+' :
$value = '<h3>Ausstattung</h3>' . "\n$value\n";
break;
case 'freitexte->sonstige_angaben+' :
$value = '<h3>Sonstiges</h3>' . "\n$value\n";
break;
}
return $value;
} // mysite_add_section_headlines
/**
* Liste erlaubter HTML-Elemente, die beim automatisierten Import zum
* Immobilien-Beschreibungstext hinzugefügt werden können, erweitern.
*/
add_filter( 'wp_kses_allowed_html', 'mysite_kses_add_allowed_html_tags', 10, 2 );
function mysite_kses_add_allowed_html_tags( $allowed_tags, $context ) {
if ( 'post' === $context ) $allowed_tags = array_merge( $allowed_tags, array(
'h2' => array( 'id' => true, 'class' => true, 'style' => true ),
'h3' => array( 'id' => true, 'class' => true, 'style' => true ),
'h4' => array( 'id' => true, 'class' => true, 'style' => true ),
'h5' => array( 'id' => true, 'class' => true, 'style' => true ),
'div' => array( 'id' => true, 'class' => true, 'style' => true )
) );
return $allowed_tags;
} // mysite_kses_add_allowed_html_tags

/**

* Absatzüberschriften im Haupt-Beschreibungstext der Immobilie ergänzen.

add_filter( 'immonex_oi2wp_add_post_data_element', 'mysite_add_section_headlines', 10, 3 );

function mysite_add_section_headlines( $value, $immobilie, $mapping ) {

if ( ! trim( $value ) ) return $value;

switch( $mapping['source'] ) {

case 'freitexte->objektbeschreibung+' :

$value = '<h3>Objektbeschreibung</h3>' . "\n$value\n";

break;

case 'freitexte->lage+':

$value = '<h3>Lage</h3>' . "\n$value\n";

break;

case 'freitexte->ausstatt_beschr+' :

$value = '<h3>Ausstattung</h3>' . "\n$value\n";

break;

case 'freitexte->sonstige_angaben+' :

$value = '<h3>Sonstiges</h3>' . "\n$value\n";

break;

}

return $value;

} // mysite_add_section_headlines

/**

* Liste erlaubter HTML-Elemente, die beim automatisierten Import zum

* Immobilien-Beschreibungstext hinzugefügt werden können, erweitern.

add_filter( 'wp_kses_allowed_html', 'mysite_kses_add_allowed_html_tags', 10, 2 );

function mysite_kses_add_allowed_html_tags( $allowed_tags, $context ) {

if ( 'post' === $context ) $allowed_tags = array_merge( $allowed_tags, array(

'h2' => array( 'id' => true, 'class' => true, 'style' => true ),

'h3' => array( 'id' => true, 'class' => true, 'style' => true ),

'h4' => array( 'id' => true, 'class' => true, 'style' => true ),

'h5' => array( 'id' => true, 'class' => true, 'style' => true ),

'div' => array( 'id' => true, 'class' => true, 'style' => true )

) );

return $allowed_tags;

} // mysite_kses_add_allowed_html_tags

Bei Bedarf kann auch jeder Abschnitt in einem eigenen Element gekapselt werden:

...
case 'freitexte->objektbeschreibung+' :
$value = '<div class="property-description">' . "\n<h3>Objektbeschreibung</h3>\n$value\n</div>";
break;
...

...

case 'freitexte->objektbeschreibung+' :

$value = '<div class="property-description">' . "\n<h3>Objektbeschreibung</h3>\n$value\n</div>";

break;

...

Das war’s auch schon! Anmerkungen oder Fragen hierzu? Dann bitte einfach einen Kommentar hinterlassen.

Menü

OpenImmo2WP #SnipOTW: Absatzüberschriften im Immobilien-Beschreibungstext ergänzen

Snippet der Woche (bzw. Hashtag #SnipOTW)