DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: ImmobilienScout24 import

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed by:Sven Burkert
Changed:2012-06-21T12:38:10.140000000
Classification:immoscout2ttnews
Description:The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ----
Keywords:forAdmins, forBeginners
Author:Sven Burkert
Email:bedienung@sbtheke.de
Info 4:
Language:en

img-1 img-2 EXT: ImmobilienScout24 import - immoscout2ttnews

EXT: ImmobilienScout24 import

Extension Key: immoscout2ttnews

Language: en

Keywords: forAdmins, forBeginners

Copyright 2000-2012, Sven Burkert, <bedienung@sbtheke.de>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.org

Table of Contents

EXT: ImmobilienScout24 import 1

`Introduction 3 <#1.1.Introduction|outline>`_

What does it do? 3

`Configuration 4 <#1.2.Configuration|outline>`_

`Administration 5 <#1.3.Administration|outline>`_

Template Marker 5

Immobilien bearbeiten / neu anlegen 6

`To-Do list 7 <#1.4.To-Do%20list|outline>`_

Introduction

What does it do?

I write this manual in german language because the ImmobilienScout24 website and service is only available in german language.

Diese Erweiterung importiert Immobilien-Objekte eines ImmobilienScout24.de-Benutzerkonto als tt_news-Datensätze über die ImmobilienScout24-REST-API. Diese Erweiterung hat einige “Baustellen” und würde noch ein paar Änderungen benötigen, um flexibel eingesetzt werden zu können (vor allem bei der Ausgabe der Daten im News- Template). Daher dient diese Erweiterung vor allem als Beispiel, wie die Schnittstelle zu ImmobilienScout24 aussehen könnte.

Auch ist die ImmobilienScout24-Schnittstelle momentan im Aufbau, daher wird sich in Zukunft noch einiges ändern und daher könnte diese Erweiterung schnell unbrauchbar werden.

Weitere Infos über die ImmobilienScout24-Schnittstelle:

Als SDK für die Anfrage der Immobilien-Objekte wird immocaster (Version 1.1.20) genutzt. Die SDK musste abgeändert werden, um die Objekte eines Benutzers zu erhalten (Funktion “_channelSearch”).

Configuration

After installing this extension you have to configure it in the extension manager: Provide your consumer key and secret (you get them from ImmobilienScout24 support) in BASIC settings. Then go to AUTHENTICATION and authenticate with your ImmobilienScout24 user.

Go to the scheduler and add the task to import the data from ImmobilienScout24.

Most of the data of the real estate object are imported in field “immoscout_data” of the tt_news record as json.

Wenn die Fehlermeldung “Das gelieferte Token ist ungültig, abgelaufen oder wurde bereits verwendet.” kommt und man in der Konfiguration nicht in die BASIC-Konfiguration wechseln kann, muss man in localconf.php den Eintrag für “immoscout2ttnews” löschen

Administration

Template Marker

Hinweis: Als Grundlage sollte das Template typo3conf/ext/immoscout2ttnews/res/tt_news_v3_template.html verwendet und angepasst werden.

Nach dem Import der ImmobilienScout24 Objekte als tt_news stehen in den News-Templates etliche neue Marker zur Verfügung:

IMMOSCOUT_REALESTATETYPE

Marker

IMMOSCOUT_REALESTATETYPE

Example

Gastronomie/Hotel

IMMOSCOUT_ID

Marker

IMMOSCOUT_ID

Example

62994878

IMMOSCOUT_REALESTATE_TITLE

Marker

IMMOSCOUT_REALESTATE_TITLE

Example

3-Zimmer-Wohnung in Berlin

IMMOSCOUT_REALESTATE_ADDRESS_STREET

Marker

IMMOSCOUT_REALESTATE_ADDRESS_STREET

Example

Hauptstraße

IMMOSCOUT_REALESTATE_ADDRESS_HOUSENUMBER

Marker

IMMOSCOUT_REALESTATE_ADDRESS_HOUSENUMBER

Example

33

IMMOSCOUT_REALESTATE_ADDRESS_POSTCODE

Marker

IMMOSCOUT_REALESTATE_ADDRESS_POSTCODE

Example

12487

IMMOSCOUT_REALESTATE_ADDRESS_CITY

Marker

IMMOSCOUT_REALESTATE_ADDRESS_CITY

Example

Berlin

IMMOSCOUT_REALESTATE_ADDRESS_QUARTER

Marker

IMMOSCOUT_REALESTATE_ADDRESS_QUARTER

Example

Berlin-Adlershof

IMMOSCOUT_REALESTATE_ADDRESS_WGS84COORDINATE_LATITUDE

Marker

IMMOSCOUT_REALESTATE_ADDRESS_WGS84COORDINATE_LATITUDE

Example

IMMOSCOUT_REALESTATE_ADDRESS_WGS84COORDINATE_LONGITUDE

Marker

IMMOSCOUT_REALESTATE_ADDRESS_WGS84COORDINATE_LONGITUDE

Example

IMMOSCOUT_REALESTATE_ADDRESS_GEOHIERARCHY_COUNTRY_NAME

Marker

IMMOSCOUT_REALESTATE_ADDRESS_GEOHIERARCHY_COUNTRY_NAME

Example

Deutschland

IMMOSCOUT_REALESTATE_ADDRESS_GEOHIERARCHY_REGION_NAME

Marker

IMMOSCOUT_REALESTATE_ADDRESS_GEOHIERARCHY_REGION_NAME

Example

Berlin

IMMOSCOUT_REALESTATE_LOCATIONNOTE

Marker

IMMOSCOUT_REALESTATE_LOCATIONNOTE

Example

Die Wohnung befindet sich im Hinterhaus.

IMMOSCOUT_REALESTATE_FLOOR

Marker

IMMOSCOUT_REALESTATE_FLOOR

Example

2

IMMOSCOUT_REALESTATE_LIFT

Marker

IMMOSCOUT_REALESTATE_LIFT

Example

false

IMMOSCOUT_REALESTATE_ASSISTEDLIVING

Marker

IMMOSCOUT_REALESTATE_ASSISTEDLIVING

Example

false

IMMOSCOUT_REALESTATE_CELLAR

Marker

IMMOSCOUT_REALESTATE_CELLAR

Example

IMMOSCOUT_REALESTATE_HANDICAPPEDACCESSIBLE

Marker

IMMOSCOUT_REALESTATE_HANDICAPPEDACCESSIBLE

Example

IMMOSCOUT_REALESTATE_CONDITION

Marker

IMMOSCOUT_REALESTATE_CONDITION

Example

IMMOSCOUT_REALESTATE_FREEFROM

Marker

IMMOSCOUT_REALESTATE_FREEFROM

Example

sofort

IMMOSCOUT_REALESTATE_BUILDINGENERGYRATINGTYPE

Marker

IMMOSCOUT_REALESTATE_BUILDINGENERGYRATINGTYPE

Example

IMMOSCOUT_REALESTATE_ENERGYCONSUMPTIONCONTAINSWARMWATER

Marker

IMMOSCOUT_REALESTATE_ENERGYCONSUMPTIONCONTAINSWARMWATER

Example

IMMOSCOUT_REALESTATE_GUESTTOILET

Marker

IMMOSCOUT_REALESTATE_GUESTTOILET

Example

IMMOSCOUT_REALESTATE_BASERENT

Marker

IMMOSCOUT_REALESTATE_BASERENT

Example

450

IMMOSCOUT_REALESTATE_TOTALRENT

Marker

IMMOSCOUT_REALESTATE_TOTALRENT

Example

600

IMMOSCOUT_REALESTATE_SERVICECHARGE

Marker

IMMOSCOUT_REALESTATE_SERVICECHARGE

Example

150

IMMOSCOUT_REALESTATE_HEATINGCOSTSINSERVICECHARGE

Marker

IMMOSCOUT_REALESTATE_HEATINGCOSTSINSERVICECHARGE

Example

IMMOSCOUT_REALESTATE_PETSALLOWED

Marker

IMMOSCOUT_REALESTATE_PETSALLOWED

Example

IMMOSCOUT_REALESTATE_LIVINGSPACE

Marker

IMMOSCOUT_REALESTATE_LIVINGSPACE

Example

45

IMMOSCOUT_REALESTATE_NUMBEROFROOMS

Marker

IMMOSCOUT_REALESTATE_NUMBEROFROOMS

Example

2

IMMOSCOUT_REALESTATE_ENERGYPERFORMANCECERTIFICATE

Marker

IMMOSCOUT_REALESTATE_ENERGYPERFORMANCECERTIFICATE

Example

false

IMMOSCOUT_REALESTATE_BUILTINKITCHEN

Marker

IMMOSCOUT_REALESTATE_BUILTINKITCHEN

Example

false

IMMOSCOUT_REALESTATE_BALCONY

Marker

IMMOSCOUT_REALESTATE_BALCONY

Example

true

IMMOSCOUT_REALESTATE_CERTIFICATEOFELIGIBILITYNEEDED

Marker

IMMOSCOUT_REALESTATE_CERTIFICATEOFELIGIBILITYNEEDED

Example

false

IMMOSCOUT_REALESTATE_GARDEN

Marker

IMMOSCOUT_REALESTATE_GARDEN

Example

false

IMMOSCOUT_REALESTATE_FLOORPLAN

Marker

IMMOSCOUT_REALESTATE_FLOORPLAN

Example

false

IMMOSCOUT_REALESTATE_COURTAGE_HASCOURTAGE

Marker

IMMOSCOUT_REALESTATE_COURTAGE_HASCOURTAGE

Example

NO

IMMOSCOUT_CONTACTDETAILS_SALUTATION

Marker

IMMOSCOUT_CONTACTDETAILS_SALUTATION

Example

MALE

IMMOSCOUT_CONTACTDETAILS_FIRSTNAME

Marker

IMMOSCOUT_CONTACTDETAILS_FIRSTNAME

Example

Sven

IMMOSCOUT_CONTACTDETAILS_LASTNAME

Marker

IMMOSCOUT_CONTACTDETAILS_LASTNAME

Example

Burkert

IMMOSCOUT_CONTACTDETAILS_PHONENUMBER

Marker

IMMOSCOUT_CONTACTDETAILS_PHONENUMBER

Example

IMMOSCOUT_CONTACTDETAILS_ADDRESS_STREET

Marker

IMMOSCOUT_CONTACTDETAILS_ADDRESS_STREET

Example

IMMOSCOUT_CONTACTDETAILS_ADDRESS_HOUSENUMBER

Marker

IMMOSCOUT_CONTACTDETAILS_ADDRESS_HOUSENUMBER

Example

IMMOSCOUT_CONTACTDETAILS_ADDRESS_POSTCODE

Marker

IMMOSCOUT_CONTACTDETAILS_ADDRESS_POSTCODE

Example

IMMOSCOUT_CONTACTDETAILS_ADDRESS_CITY

Marker

IMMOSCOUT_CONTACTDETAILS_ADDRESS_CITY

Example

IMMOSCOUT_CONTACTDETAILS_COMPANY

Marker

IMMOSCOUT_CONTACTDETAILS_COMPANY

Example

IMMOSCOUT_CONTACTDETAILS_HOMEPAGEURL

Marker

IMMOSCOUT_CONTACTDETAILS_HOMEPAGEURL

Example

((Unknown Property))

Marker

Example

((Unknown Property))

Marker

Example

((Unknown Property))

Marker

Example

((Unknown Property))

Marker

Example

((Unknown Property))

Marker

Example

((Unknown Property))

Marker

Example

((Unknown Property))

Marker

Example

Immobilien bearbeiten / neu anlegen

Als Redakteur kann man bei den importierten Immobilien ein paar wenige Daten editieren, nicht jedoch der Großteil der Daten, da diese in ein einziges Feld der tt_news-Tabelle gespeichert sind. Grund hierfür ist, dass die Daten von ImmobilienScout24 über dutzende unterschiedlich benannte Felder verteilt sind, die sich außerdem je nach Immobilien-Typ unterscheiden.

Daher kann man auch bei Immobilien, die man über das TYPO3 BE neu einpflegt, diese Daten nicht eingeben. Aus diesem Grund wird beim Rendern der Immobilien-Detailseite über einen Hook geprüft, ob es sich bei dem Datensatz um einen importierten Datensatz mit ImmobilienScout24-Daten handelt oder um einen von einem Redakteur angelegten Datensatz. Je nachdem wird ein anderer Template-Subpart verwendet: TEMPLATE_SINGLE oder TEMPLATE_SINGLE_IMMOSCOUT, zu sehen in Datei typo3conf/ext/immoscout2ttnews/res/tt_news_v3_template.html.

Dafür muss im News-Plugin als “Ansicht” die Einstellung “Einzelansicht Immobilie (SINGLE_IMMOSCOUT)” gewählt werden.

To-Do list

7