WP-ImmoMakler: Display and customize reference properties

Show references/reference objects on the website

With WP-ImmoMakler you can display reference properties under a separate menu item or at the end of your real estate list. The presentation is reduced: Only description texts, images and location are displayed - no prices, areas or features.

For individual requirements (e.g. reference letters), you can customize the display using your own templates.

---

Marking of reference objects

For properties to be displayed as references, they must be marked accordingly before export. As there is no fixed definition for reference objects in the OpenImmo standard, the procedure differs depending on the broker software:

onOffice

• Activate the "Reference" checkbox in the "Marketing" tab under "Own website"
• Call onOffice technical support (+49 241 44686-122) to have the transfer of the so-called "marketing fields" activated free of charge
• No further setting is necessary in WP-ImmoMakler

Propstack

• Activation under: Administration → Interfaces → Portals → "Reference transmission for certain object statuses"

other broker software

The transfer of reference objects is also possible with other systems - however, there may be deviations depending on the customer configuration. Please contact our support team if you need to make any adjustments.

Options:

• Setting up an additional portal interface
  • Set up your own export interface (e.g. "References website") to which you export your reference objects. If you export the references to /openimmo/referenzen/ to your server, they are automatically marked as a reference.
  • WP-ImmoMakler automatically recognizes the following directories:
    • /referenzen/, /reserviert/, /neu/, /preisreduziert/, /vermittelt/
  • Use a different provider number than in the main portal to enable separate comparisons

WP-ImmoMakler settings

• WP-ImmoMakler → Settings → Import → Activate "Mark properties marked as sold/rented as reference properties"

• User-defined fields (custom fields)

  • Add a new user-defined field (e.g. "Reference object" checkbox). If necessary, consult the documentation of your software or its support team.
  • Folgende benutzerdefinierte Felder werden von WP-ImmoMakler bereits akzeptiert, weitere Felder können wir aber bei Bedarf hinzufügen:
    immobilie-user_defined_anyfield-Referenz = 1 oder 'true'
immobilie-user_defined_anyfield-Referenzobjekt = 'true'
ausstattung-user_defined_anyfield-Referenz = 1 oder 'true'
verwaltung_techn-user_defined_anyfield-Referenzobjekt = 'Ja'

• Automatic conversion of deleted objects into reference objects

  • To do this, place the following filter in the functions.php in your WP-ImmoMakler ChildSkin:
    add_filter('immomakler_mark_as_reference_instead_of_delete', '__return_true');
  • This means that deleted objects are not removed but archived as references.

👉 If none of the above options are feasible for you, please contact us - we will find an individual solution (e.g. via keywords in the object title or description text or object IDs).

🚫 Restrictions at immowelt.de

The Immowelt API does not allow the transfer of inactive properties - this means that the reference display is not technically possible.

Alternatives:

• Use of external broker software (e.g. OpenEstate open source solution)
  [ → Please also take a look at our list of software providers with whom we already work successfully].
• Use of certain keywords in the title or description text for reference identification

👉 If you have any questions, please contact our support team.

---

Presentation of reference objects

The reference properties are visible in the frontend from the first import under:/immobilien/referenzen/

In shortcodes via status=referenz controllable

[immomakler-archive status=referenz vermarktungsart=kauf]
[immomakler-archive status=referenz vermarktungsart=miete]

Note: The parameter for the Avada theme is: immobilien-status=referenz

Settings in the Customizer

• Under Customizer → WP-ImmoMakler → Reference properties basic display options can be customized
  • Whether reference objects are also displayed in the normal list view or only on a separate reference page.
  • Whether the detailed view should be linked

---

Individualize display of reference objects

You have the option of adapting the reference display to your individual requirements.

You can customize the reference display in the following templates:

• item-property-reference.php (skins/archive/item-property-reference.php)
• content-property-reference.php (skins/single/content-property-reference.php)

Please place the item-property-reference.php or the content-property-reference.php in your WP-ImmoMakler child skin in order to store the customizations there in an update-safe manner. You can then freely customize the display of the references there.

Customize the header of the reference page

If you want to customize the header of the reference page, you can differentiate the display with the following instruction:

if (is_tax( 'immomakler_object_status', 'referenz' )) {
    echo 'REFERENZEN';
}

Show references with ShortCode

From the PLUS license onwards, you have the option of displaying reference objects at the desired position on your website using a ShortCode. Possible ShortCodes would be:

[real-estate-archive status=reference marketing-type=purchase] [real-estate-archive status=reference marketing-type=rent]