RETS Import

Preparation

Server/hosting requirements

First make sure that you have installed Estatik Premium RETS version and then proceed. There is no RETS import option in Estatik PRO or Simple version.

When it comes to actually processing the images and other data elements a server setting called the max_execution_time setting plays a role. This is the most often error that you can get if your max_execution time is not enough.

Beside this, there are some others  important requirements that your hosting provider server should have:

  • mod_fcgid=off
  • safe_mode=off
  • open_basedir=NULL
  • RLimitMEM parameter's value of Apache = 20MB
  • Response body limit( SecResponseBodyLimit ) =20MB

The options below also are a must:

  • php5.6x - php7.0
  • cURL support = enabled
  • allow_url_fopen = on

 

php.ini file settings:

  • display_errors = Off
  • log_errors = On
  • memory_limit = 512M - 10* 24M
  • max_input_vars = 20000
  • max_execution_time = 1000-5000
  • max_input_time = 600
  • upload_max_filesize = 100M

 

Also you need to open TCP ports 6103, 6160, 8080 if you have errors including them in result of connection attempt.

If you have a website built on wordpress.com or other service that do not provide full control of the website, we recommend to find self-hosted solutions otherwise our team will not be able to setup and control automatic import via server cron.

0

0

Back To Top

Setup

Setup options

Setup of Estatik Premium version is mostly the same as the one of Estatik Pro.
Premium version has a White label option, which can be found in Estatik>>Settings>>General

Enable it to remove Estatik logo and Powered by link from all Estatik pages.

0

0

Back To Top

Connection Errors

If you have got Setup error like displayed below which says - You are not connected to the MLS server -->

rets_error_setup

you need to check the following:

    * Your server PHP version is 5.5 or higher
    * Your server have extension curl installed
    * You have the latest version of Estatik Premium Version
    * You have entered user agent name and password in Advanced Settings (required for some cases, please check screenshot below)

    0

    0

    Back To Top

    Connection to RETS

    If all steps above were done successfully, now you need to connect to your MLS account using RETS credentials that your MLS provider granted you.

    Go to MLS RETS Import area of the Estatik plugin, enter your RETS link, username and password. Click Save and Connect.

    estatik rets

    This basic settings usually enough for connection. Do not touch Advanced link. The Advanced settings are mostly for Estatik Support team.

    0

    0

    Back To Top

    Fields Configuration

    Once connected to MLS via RETS, additional tabs will become available. Please click on second tab - Fields configuration. Here you need to select resource, class and entity values in drop-down lists.

    Important: Fields maping is the most important part of the plugin configuration. Please do not hurry up with it and do everything carefully. 

    If you map MLS fields to the wrong Estatik field and will make import, these fields will be imported wrong and as result you will not find he required information about property. So please follow our instructions or order additional service and we will set it up for you.

    When we need to import properties, we select Resource: property. Field Classes will provide us with a list of property types - Residential, Lots/Land/Farm, Multi-Family, Commercial.

    fields

     

    It is important to select the required fields as different class will give you different list of fields. Let's select Residential class and Entity - Property.

    Click Submit button. You will get a drop-down list of MLS fields available for the Resource Property, and class Residential. Use quick access search and type the fields. Please note that the MLS fields can be named differently and if you are uncertain whether you need this field or not, omit it and do not add. There can be numerous empty fields and it is not necessary to add them to your website.

    So you need to add MLS field and map it to Estatik field like displayed below:

    Below is the list of most common MLS fields and corresponding Estatik fields:

    MLS field = Estatik field:

    MLS number = Property MLSID

    Building Name = Title

    MLS Number = Large photo & Images

    Current price = Price

    Beds Total = Bedrooms

    Baths Full = Bathrooms

    Public Remarks = Description

    Sqft Total = Area

    Lot Size Area = Lot size

    Foreign Country Or State = Country

    State Or Province = State

    City = City

    Amenities = Amenities

    Property Type = Type

    Status = Status .. etc.

    Please note that there are some crucial fields that must be assigned correctly. They are - MLS Number - without it being properly assigned as indicated above, you will not be able to make import properly.

    1

    0

    Back To Top

    New fields & sections

    There can be hundreds of fields on MLS side and sure that there is no such fields in the plugin. But there is no problem to add them. With Fields Builder you can add as many fields and sections as you need.

    Please check Fields Builder guide first. Once you add the new fields, they will be all displayed in the drop-down list in Fields Configuration >>

    First add new fields via Fields Builder, create new sections first, e.g. Interior Features, Exterior Features, School Information, etc.

    Once you add new fields, you will find them in the drop-down list of the plugin in MLS RETS Import >> Fields Configuration >>

    You can always get back to Fields Builder and edit any field or section, as well as add any new ones.

    0

    0

    Back To Top

    Filters

    When configuring fields for specific Property Class, please put a check mark if you want to narrow the import and pull out only specific listings.

     If you make some fields filterable, you will be able to configure filters in Import pages (Manual Import or Automatic Import) like displayed below:

    estatik_premium_rets_filters

    0

    0

    Back To Top

    Listing URL setup

    Listing URL consists of a customizable slug URI '/property' and a listing title. Default slug '/property' can be changed in the plugin Settings:

    settings-custom-slug

    Listing Title can be setup when configuring MLS fields. You need to assign necessary fields that you want to be displayed in listing URL in appropriate order.



    If you did everything properly, you will see listings with correct titles:



    and consequently listing page URL will be framed as you required:

    custom-url-estatik

    If you do not want to show Listing Title on frontend and leave it only in URL, please make sure that you selected Address in plugin Settings for the field Title/Address:

    title-address-estatik

    0

    0

    Back To Top

    Automatic Import

    Errors

    1. Error of malconfiguration of the fields.

      error-auto

    It means that you didn’t set up fields for the selected Resource – Land. You should go to Fields Configuration tab, select this resource and configure the fields. Please check it here.

    0

    0

    Back To Top

    Cron Job Setup

    To handle scheduled tasks, you need to set up cron job via cPanel.

    First, you need to disable the file to be hit every time someone loads your pages. To do this, open the wp-config.php file in your website folder and add this line at the end, before the closing ?> tag:

    define('DISABLE_WP_CRON', true);

     

    Then you can set up cron via cPanel. Open cpanel and find there Cron Jobs section.

    cron_job

    When you open it, there will be offer to set up an email sent to you each time when cronjob is executed successfully. You can add your email just to be sure that it works ok.

    Below you will see a list of preset intervals. Select Every 30 minutes from the minutes drop-down and leave a * symbol in the rest of fields.

    Add command below where /user/ must be your cPanel username.

    /usr/local/bin/php /home/user/public_html/wp-cron.php

    cron_setup_estatik_rets

    Click on Add new Cron Job button. You will see this cron job in a list of cron jobs which can be removed or edited.

    0

    0

    Back To Top

    Configuration

    In Automatic Import you can set up a schedule and launch properties import on automatic basis.

    automatic-rets

    First select from drop-down lists correct values and click Save. You will see the scheduled import below with the number of listings that is available for import:

    rets-schedule

     

    0

    0

    Back To Top

    Manual Import

    Errors

    1. Error - Malconfiguration of the fields: 

    errors-manual

    It means that you didn't set up fields for the selected Resource - Commercial. You should go to Fields Configuration tab , select this resource and configure the fields. Please check it here.

    0

    0

    Back To Top

    Configuration

    You can also import listings manually. Please open Manual Import:

    manual-import

    Also, set up all the fields in this tab and click Submit. If you want to add any filters, please check this document to learn how to proceed.

    Click Submit and get a list of properties like below:

    manual-import

    To start import, please do not miss to select all listings or some of them an only then press Import button. If you miss out to select listings, nothing will get imported.

    All listings will be imported unpublished.

    estatik-listings

    0

    0

    Back To Top

    Notes for Estatik Premium

    Support coverage

    1. Support coverage

    Estatik Support includes Mon-Fri email and chat support. We do not provide support via phone or other devices.

    What we do:
    * help to figure out any issues with incorrect configuration of the Estatik plugin
    * help to figure out conflicts with themes
    * provide you with documentation and video tutorials
    * advice as for the server requirements and issues connected with it.

    What we do not:
    * we do not contact MLS directly to figure out your questions regarding RETS credentials or any others.
    * we do not contact your hosting provider directly. We can tell you what you must ask about or request from hosting tech support.
    * we do not setup cron on your server until you ordered paid setup service. You do it yourself using our documentation.

    0

    0

    Back To Top

    Returns & Trials

    1. Trials and refunds

    We can offer returns only in case if you are not able to connect to your MLS server and we are not able to figure it out. You are required to contact support and describe the issues you experience before demanding refund. Only in case if our team is not possible to solve the issues or get it work as it is presented in our documentation and demo, we may provide you with refund.
    We do not offer returns for reasons like:
    “I thought it comes with RETS credentials already”
    “I thought you are a Vendor and will give me credentilas”
    “I changed my mind and switched to another plugin”
    “Sorry but it works in other way than I imagined”
    “It shows some errors , please return my monney back”, etc.
    We also do not offer trials.

    0

    0

    Back To Top

    Errors

    1. Manual Import errors - no listings imported

    If Estatik Premium version was installed and activated correctly, but when you try to import listings manually you get nothing, please make sure that you configured major fields (Property MLS ID) correctly. Check out our Documentation or please contact us and we will check that.

    2. Error 401

    If you have Error 401, please check if you entered your RETS credentials properly. 401 error means incorrect login/password.

    3. Images for listings are not imported

    If the images are shown for every listing, but they are not imported with all the other listing data, please disable htpasswd popup on your website. The script that uploads images gives the status 403 - unauthorized and the prevents images from importing.

    4. Error "String could not be parsed as XML"

    If RETS credentials are correct, but you still cannot connect to MLS server - the click on Connect button results in "String could not be parsed as XML" error, please, check curl version on the server. It should be 7.50 or higher, and the issue will be resolved.

    5. Can not load resources and classes

    If you have connected successfully but when you go to Fields Configuration there no resources can be loaded,

    rets_errors

    please contact your MLS provider with request to check your account permissions (you can refer to the error: GetMetadata' tried but no valid endpoint was found. Did you forget to Login()? ) or make sure that you do not have additional agent username and agent username password that should be entered in Advanced Settings:

    5. Keep getting RETS Error: Miscellaneous Search Error

    If you keep getting the error like above, please go to your RETS profile Advanced settings and switch on the option: Miscellaneous Search Error Fix ->

    0

    0

    Back To Top

    Premium version options

    1. Free Theme Setup

    We offer Trendy, Native or Project theme – one of them you can choose within Premium
    Package and we will setup and configure the chosen theme so they will look like Trendy demo site, Native demo site or Project demo site.
    Free Theme Setup doesn't include Estatik Premium version configuration. We offer documentation for that and also additional service which costs $98. You can find details here.

    2. White label option

    Premium version has a White label option. Read more about it here, please.

    3. CRM option

    There is no such option on our plugin and we do not offer integration with any of these plugins. Estatik has agents (users who registered to become agents and can submit listings via frontend), users (simple visitors) and admin.

    4. Search function

    With Estatik Premium you will be able to make search listings that were imported from your MLS provider using Estatik Search widget. So the search results will be based on MLS data.

    5. Number of listings for import and update

    There are no limitations in the quantity of listings for importing or updating in the plugin but WordPress itself can handle smoothly up to 5 000 - 10 000 listings. If there are more listings the website can become slower or show errors.

    6. Synchronization

    The amount of listings available for updating depends on how many listings you have. If you have thousands of listings and your server allows to update 5 listings per request (each 2 mins), it means that every hour you will get updated 150 listings or 1800 per day.

    0

    0

    Back To Top

    Customer’s payments

    1. Payment for Estatik Premium version

    $489 is one-time payment for the plugin and free updates and support for 1 year. Once the first year has passed, you still can use the plugin but do not longer receive free updates and support until you prolong your subscription. The renewal price for subscription is $299.

    2. Additional or hidden costs

    There are no hidden payments. We can offer your Setup service for $98.
    Please note that Estatik is not responsible for any costs charged by your MLS provider for granting RETS credentials.

    0

    0

    Back To Top

    RETS access & MLS providers

    Please, read the following notes carefully to avoid mistakes and misunderstandings!

    1. RETS credentials

    To obtain RETS credentials, you need to contact your MLS provider and figure out if they offer this type of integration or not and what must be done to get it. Please check other details about MLS integration service here.

    2. RETS access

    Estatik is not a vendor and we do not provide customers with RETS. That is why we write on our website that you should buy the Premium plugin only after you have RETS credentials. Usually it takes some time to obtain credentials. MLS also may charge for it. All of MLS providers fees are payable by customer.

    3. MLS coverage

    Estatik Premium covers any MLS provider, which offers organic integration via RETS and grants RETS credentials for that. It works via RETS connector which is a standard technology in any of these MLS.

    4. Multiple MLS providers

    You can enter and use several RETS profiles and enter credentials for each of them in Estatik Premium. But in this case you will need to make all configuration separately for every profile.

    5. Usage on several websites

    You can use Estatik Premium plugin on several websites and with different RETS credentials. There are no limitations for it.

    0

    0

    Back To Top

    Multiple RETS profiles use

    How to switch from one MLS profile to another?

    To connect to another MLS provider (RETS profile), you need to disconnect from the one to which you are connected currently. Please check our screenshot below:

    Please note that you have to configure the MLS fields separately for every single profile.

    0

    0

    Back To Top

    How to connect to several RETS profiles

    Please make sure that you have all necessary credentials, i.e. rets url, username and password. Then go to MLS RETS Import -> General and enter your first profile credentials.

    estatik_rets_profiles

    Once you save it, you will be able to connect it or to add your second profile credentials. All profiles will be displayed on the right side of the admin page:

    estatik_premium_rets

    0

    0

    Back To Top