.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============================= 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: EXT: ImmobilienScout24 import ============================= Extension Key: immoscout2ttnews Language: en Keywords: forAdmins, forBeginners Copyright 2000-2012, Sven Burkert, 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: Table of Contents ----------------- `EXT: ImmobilienScout24 import 1 <#1.EXT:%20ImmobilienScout24%20import|outline>`_ **`Introduction 3 <#1.1.Introduction|outline>`_** `What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_ **`Configuration 4 <#1.2.Configuration|outline>`_** **`Administration 5 <#1.3.Administration|outline>`_** `Template Marker 5 <#1.3.1.Template%20Marker|outline>`_ `Immobilien bearbeiten / neu anlegen 6 <#1.3.2.Immobilien%20bearbeiten%20/%20neu%20anlegen|outline>`_ **`To-Do list 7 <#1.4.To-Do%20list|outline>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: 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: 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: Administration -------------- .. _Template-Marker: 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: .. ### BEGIN~OF~TABLE ### .. _IMMOSCOUT-REALESTATETYPE: IMMOSCOUT\_REALESTATETYPE """"""""""""""""""""""""" .. container:: table-row Marker IMMOSCOUT\_REALESTATETYPE Example Gastronomie/Hotel .. _IMMOSCOUT-ID: IMMOSCOUT\_ID """"""""""""" .. container:: table-row Marker IMMOSCOUT\_ID Example 62994878 .. _IMMOSCOUT-REALESTATE-TITLE: IMMOSCOUT\_REALESTATE\_TITLE """""""""""""""""""""""""""" .. container:: table-row Marker IMMOSCOUT\_REALESTATE\_TITLE Example 3-Zimmer-Wohnung in Berlin .. _IMMOSCOUT-REALESTATE-ADDRESS-STREET: **IMMOSCOUT\_REALESTATE\_ADDRESS\_STREET** """""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ADDRESS\_STREET** Example Hauptstraße .. _IMMOSCOUT-REALESTATE-ADDRESS-HOUSENUMBER: **IMMOSCOUT\_REALESTATE\_ADDRESS\_HOUSENUMBER** """"""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ADDRESS\_HOUSENUMBER** Example 33 .. _IMMOSCOUT-REALESTATE-ADDRESS-POSTCODE: **IMMOSCOUT\_REALESTATE\_ADDRESS\_POSTCODE** """""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ADDRESS\_POSTCODE** Example 12487 .. _IMMOSCOUT-REALESTATE-ADDRESS-CITY: **IMMOSCOUT\_REALESTATE\_ADDRESS\_CITY** """""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ADDRESS\_CITY** Example Berlin .. _IMMOSCOUT-REALESTATE-ADDRESS-QUARTER: **IMMOSCOUT\_REALESTATE\_ADDRESS\_QUARTER** """"""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ADDRESS\_QUARTER** Example Berlin-Adlershof .. _IMMOSCOUT-REALESTATE-ADDRESS-WGS84COORDINATE-LATITUDE: **IMMOSCOUT\_REALESTATE\_ADDRESS\_WGS84COORDINATE\_LATITUDE** """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ADDRESS\_WGS84COORDINATE\_LATITUDE** Example .. _IMMOSCOUT-REALESTATE-ADDRESS-WGS84COORDINATE-LONGITUDE: **IMMOSCOUT\_REALESTATE\_ADDRESS\_WGS84COORDINATE\_LONGITUDE** """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ADDRESS\_WGS84COORDINATE\_LONGITUDE** Example .. _IMMOSCOUT-REALESTATE-ADDRESS-GEOHIERARCHY-COUNTRY-NAME: **IMMOSCOUT\_REALESTATE\_ADDRESS\_GEOHIERARCHY\_COUNTRY\_NAME** """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ADDRESS\_GEOHIERARCHY\_COUNTRY\_NAME** Example Deutschland .. _IMMOSCOUT-REALESTATE-ADDRESS-GEOHIERARCHY-REGION-NAME: **IMMOSCOUT\_REALESTATE\_ADDRESS\_GEOHIERARCHY\_REGION\_NAME** """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ADDRESS\_GEOHIERARCHY\_REGION\_NAME** Example Berlin .. _IMMOSCOUT-REALESTATE-LOCATIONNOTE: **IMMOSCOUT\_REALESTATE\_LOCATIONNOTE** """"""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_LOCATIONNOTE** Example Die Wohnung befindet sich im Hinterhaus. .. _IMMOSCOUT-REALESTATE-FLOOR: **IMMOSCOUT\_REALESTATE\_FLOOR** """""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_FLOOR** Example 2 .. _IMMOSCOUT-REALESTATE-LIFT: **IMMOSCOUT\_REALESTATE\_LIFT** """"""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_LIFT** Example false .. _IMMOSCOUT-REALESTATE-ASSISTEDLIVING: **IMMOSCOUT\_REALESTATE\_ASSISTEDLIVING** """"""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ASSISTEDLIVING** Example false .. _IMMOSCOUT-REALESTATE-CELLAR: **IMMOSCOUT\_REALESTATE\_CELLAR** """"""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_CELLAR** Example .. _IMMOSCOUT-REALESTATE-HANDICAPPEDACCESSIBLE: **IMMOSCOUT\_REALESTATE\_HANDICAPPEDACCESSIBLE** """""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_HANDICAPPEDACCESSIBLE** Example .. _IMMOSCOUT-REALESTATE-CONDITION: **IMMOSCOUT\_REALESTATE\_CONDITION** """""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_CONDITION** Example .. _IMMOSCOUT-REALESTATE-FREEFROM: **IMMOSCOUT\_REALESTATE\_FREEFROM** """"""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_FREEFROM** Example sofort .. _IMMOSCOUT-REALESTATE-BUILDINGENERGYRATINGTYPE: **IMMOSCOUT\_REALESTATE\_BUILDINGENERGYRATINGTYPE** """"""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_BUILDINGENERGYRATINGTYPE** Example .. _IMMOSCOUT-REALESTATE-ENERGYCONSUMPTIONCONTAINSWARMWATER: **IMMOSCOUT\_REALESTATE\_ENERGYCONSUMPTIONCONTAINSWARMWATER** """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ENERGYCONSUMPTIONCONTAINSWARMWATER** Example .. _IMMOSCOUT-REALESTATE-GUESTTOILET: **IMMOSCOUT\_REALESTATE\_GUESTTOILET** """""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_GUESTTOILET** Example .. _IMMOSCOUT-REALESTATE-BASERENT: **IMMOSCOUT\_REALESTATE\_BASERENT** """"""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_BASERENT** Example 450 .. _IMMOSCOUT-REALESTATE-TOTALRENT: **IMMOSCOUT\_REALESTATE\_TOTALRENT** """""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_TOTALRENT** Example 600 .. _IMMOSCOUT-REALESTATE-SERVICECHARGE: **IMMOSCOUT\_REALESTATE\_SERVICECHARGE** """""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_SERVICECHARGE** Example 150 .. _IMMOSCOUT-REALESTATE-HEATINGCOSTSINSERVICECHARGE: **IMMOSCOUT\_REALESTATE\_HEATINGCOSTSINSERVICECHARGE** """""""""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_HEATINGCOSTSINSERVICECHARGE** Example .. _IMMOSCOUT-REALESTATE-PETSALLOWED: **IMMOSCOUT\_REALESTATE\_PETSALLOWED** """""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_PETSALLOWED** Example .. _IMMOSCOUT-REALESTATE-LIVINGSPACE: **IMMOSCOUT\_REALESTATE\_LIVINGSPACE** """""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_LIVINGSPACE** Example 45 .. _IMMOSCOUT-REALESTATE-NUMBEROFROOMS: **IMMOSCOUT\_REALESTATE\_NUMBEROFROOMS** """""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_NUMBEROFROOMS** Example 2 .. _IMMOSCOUT-REALESTATE-ENERGYPERFORMANCECERTIFICATE: **IMMOSCOUT\_REALESTATE\_ENERGYPERFORMANCECERTIFICATE** """"""""""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_ENERGYPERFORMANCECERTIFICATE** Example false .. _IMMOSCOUT-REALESTATE-BUILTINKITCHEN: **IMMOSCOUT\_REALESTATE\_BUILTINKITCHEN** """"""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_BUILTINKITCHEN** Example false .. _IMMOSCOUT-REALESTATE-BALCONY: **IMMOSCOUT\_REALESTATE\_BALCONY** """""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_BALCONY** Example true .. _IMMOSCOUT-REALESTATE-CERTIFICATEOFELIGIBILITYNEEDED: **IMMOSCOUT\_REALESTATE\_CERTIFICATEOFELIGIBILITYNEEDED** """"""""""""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_CERTIFICATEOFELIGIBILITYNEEDED** Example false .. _IMMOSCOUT-REALESTATE-GARDEN: **IMMOSCOUT\_REALESTATE\_GARDEN** """"""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_GARDEN** Example false .. _IMMOSCOUT-REALESTATE-FLOORPLAN: **IMMOSCOUT\_REALESTATE\_FLOORPLAN** """""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_FLOORPLAN** Example false .. _IMMOSCOUT-REALESTATE-COURTAGE-HASCOURTAGE: **IMMOSCOUT\_REALESTATE\_COURTAGE\_HASCOURTAGE** """""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_REALESTATE\_COURTAGE\_HASCOURTAGE** Example NO .. _IMMOSCOUT-CONTACTDETAILS-SALUTATION: **IMMOSCOUT\_CONTACTDETAILS\_SALUTATION** """"""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_CONTACTDETAILS\_SALUTATION** Example MALE .. _IMMOSCOUT-CONTACTDETAILS-FIRSTNAME: **IMMOSCOUT\_CONTACTDETAILS\_FIRSTNAME** """""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_CONTACTDETAILS\_FIRSTNAME** Example Sven .. _IMMOSCOUT-CONTACTDETAILS-LASTNAME: **IMMOSCOUT\_CONTACTDETAILS\_LASTNAME** """"""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_CONTACTDETAILS\_LASTNAME** Example Burkert .. _IMMOSCOUT-CONTACTDETAILS-PHONENUMBER: **IMMOSCOUT\_CONTACTDETAILS\_PHONENUMBER** """""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_CONTACTDETAILS\_PHONENUMBER** Example .. _IMMOSCOUT-CONTACTDETAILS-ADDRESS-STREET: **IMMOSCOUT\_CONTACTDETAILS\_ADDRESS\_STREET** """""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_CONTACTDETAILS\_ADDRESS\_STREET** Example .. _IMMOSCOUT-CONTACTDETAILS-ADDRESS-HOUSENUMBER: **IMMOSCOUT\_CONTACTDETAILS\_ADDRESS\_HOUSENUMBER** """"""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_CONTACTDETAILS\_ADDRESS\_HOUSENUMBER** Example .. _IMMOSCOUT-CONTACTDETAILS-ADDRESS-POSTCODE: **IMMOSCOUT\_CONTACTDETAILS\_ADDRESS\_POSTCODE** """""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_CONTACTDETAILS\_ADDRESS\_POSTCODE** Example .. _IMMOSCOUT-CONTACTDETAILS-ADDRESS-CITY: **IMMOSCOUT\_CONTACTDETAILS\_ADDRESS\_CITY** """""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_CONTACTDETAILS\_ADDRESS\_CITY** Example .. _IMMOSCOUT-CONTACTDETAILS-COMPANY: **IMMOSCOUT\_CONTACTDETAILS\_COMPANY** """""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_CONTACTDETAILS\_COMPANY** Example .. _IMMOSCOUT-CONTACTDETAILS-HOMEPAGEURL: **IMMOSCOUT\_CONTACTDETAILS\_HOMEPAGEURL** """""""""""""""""""""""""""""""""""""""""" .. container:: table-row Marker **IMMOSCOUT\_CONTACTDETAILS\_HOMEPAGEURL** Example .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Marker Example .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Marker Example .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Marker Example .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Marker Example .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Marker Example .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Marker Example .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row Marker Example .. ###### END~OF~TABLE ###### .. _Immobilien-bearbeiten-neu-anlegen: 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: 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 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87