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 |
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>`_
`Configuration 4 <#1.2.Configuration|outline>`_
`Administration 5 <#1.3.Administration|outline>`_
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:
- ImmobilienScout24 Developer Center: http://developer.immobilienscout24.de/
- immocaster: http://immocaster.com/
- REST-API Key und Passwort: http://developer.immobilienscout24.de /rest-api-zugang/
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¶
- Possibility to collect ALL objects of an account (not possible for now with REST API, see http://groups.google.com/group/immobilienscout24-d evelopment/browse_thread/thread/aad94f3184fcf7b1 )
- Handling of markers (many of them are raw data)
- Delete images in filesystem when they aren't needed any more
- Import into every desired table (not only tt_news)
- Specify news category for objects
- Show demo page
7