Before starting I would like to be clear that we will be retrieving only entries with an Active status. The entire feed would be huge and frankly its just not needed. First off be sure you have downloaded and installed vieleRETS. The entire installation page boils down to just download it, unzip it, place it on your server, and execute the install.bat(Windows) or install.sh(Linux.. from the command line ./install.sh). Now we’re ready to begin, just navigate in your web browser to the vieleRETS/setup/ directory of your site.
Create Sources
You’ll notice on your landing page there are 3 categories like I mentioned in Part 1 or this series. We will be working within the Sources area for this part of the tutorial. For the most part we will accept defaults and enter necessary fields.
Click “Create” in the Sources menu.
- This first page is to enter the name of the source. Generally you could call it Residential, Commercial, etc..
- This second page is to enter your basic credentials and version. I only needed to enter RETS_SERVER_USERNAME, RETS_SERVER_PASSWORD, RETS_SERVER_URL, and Version. For the rest of this page I accepted defaults. Click Apply.
- The third page basically verifies your connection. If you don’t receive green success text you need to go back to the previous step.
- The fourth step is to define a Resource. Here I chose Property.
- Step five asks for the class. This is up to you which class you want to download. For now I’ll pretend we’re choosing Residential.
- Step six is simply auto detection and you shouldn’t have to do much but watch, wait, and cross your fingers. After the page loads at there very bottom you should have your results(hopefully success). Click Apply.
- Step seven is for Overriding Auto-Detection. I left the defaults alone and clicked Apply.
- Step eight is Important! Here you need to choose elements you might be querying the RETS server for. I chose the more obvious ones like mls number, class, type, etc, But as I stated at the top we are also going to retrieve listings where Status is Active. So we need to be sure and check Status from this list. Click Apply.
- Step nine is asking for the Agent Id. I chose the mls number. Click Apply.
- Step ten ask for you to pick date elements. This is up to you which ones you want to use as a date. Click Apply.
Thats it! You are now back at the menu page for this Source. All the options weren’t exactly obvious which ones are for you, but mostly the defaults work. Our next step will be creating a Target.
- RETS Retrieval with PHP and VieleRETS: Part 1, Introduction
- RETS Retrieval with PHP and VieleRETS: Part 2, Creating a Source
- RETS Retrieval with PHP and VieleRETS: Part 3, Create a Target
- RETS Retrieval with PHP and VieleRETS: Part 4, Create an Extract
- RETS Retrieval with PHP and VieleRETS: Part 5, Executing the Batch
- RETS Retrieval with PHP and VieleRETS: Part 6, Creating a Cron Job
Related posts:


11 Responses
Trent’s Blog » RETS Retrieval with PHP and VieleRETS: Part 4
07|Feb|2008[...] RETS Retrieval with PHP and VieleRETS: Part 2, Creating a Source [...]
James
12|Feb|2009Just FYI for anyone reading… php safe mode can cause problems with this step (and possibly others) where the directories created by VieleRets will not be writable so metadata will be queried successfully but will not be downloaded/stored.
michelle
23|Jan|2010Ok. so I got through step six but at the bottom there is nothing to click, and no green text. I did see it once, but after trying to create another source, it is not there, although it looks like a success. Any suggestions? Also, I cannot edit any of the sources I have created, I get a page not found page. Thanks
trent
24|Jan|2010Hey Michelle,
VieleRETS has changed a lot since I last used it, and I’m not familiar at all with the newer versions. Sorry I can’t be of much assistance anymore.
Jay
19|Apr|2010I’ve had the same problem as Michelle trying to get VieleRETS working. It tries to auto-detect the details, and can’t parse the metadata. Even when I give it a known good MLS number, it returns a “not found” error. I’ve spent a few days trying to get it to work. Would you think that the problem is with VieleRETS or with the CCAR’s system? Thanks!
kevin
31|May|2010okay, i am a newbie, i am woundering how to place this software on the server. Is it the php server that i downloaded onto my computer, or is it the hosting server were my site is?
thanks
kevin
trent
31|May|2010it should be installed on the hosting server.. the php server you downloaded onto your computer is just so you can test it out locally
steve
09|Aug|2010This is a wonderful blog and I’m grateful that you (Trent) have taken the time to provide detailed steps for this program. I’m sorry to hear, however, that you’re no longer up on the latest versions! I’m having problems similar to Michelle’s, and then some.
I’ve installed both the VieleRETS Persistent Downloader and the RETS Retriever 2.0 Transient Downloader (in separate directories), but can’t get very far with either one. I do have a good MLS number/credentials. With VieleRETS, when I try to establish a source connection, the “Verifying URL” action returns the following error:
ERROR: 200. Refused – Check RETS server or firewall for port 8080
The same error occurs with the default demo URL. I suspect this may be a firewall issue, perhaps with my ISP? Don’t know how to check that myself, but will likely call on their support to find out.
With RETS, I get the following:
Warning: Cannot modify header information – headers already sent by (output started at /[URL]/rets/retriever-2.0/retriever-2.0/setup/site/submit_config.php:10) in /[same_URL]/rets/retriever-2.0/retriever-2.0/setup/site/submit_config.php on line 166
Could the php safe mode, mentioned by James above, have anything to do with these problems? I guess I should mention that I’m new to PHP scripting.
Current documentation on RETS retrieval is limited, so far as what I’ve been able to find, but it indicates that all the scripts are set up automatically.
In addition to the above issues, I have one overall burning question: Despite ongoing efforts (such as vielerets.org) to make this process easy, is it still necessary to hire a programmer skilled in PHP scripting and database setup/management in order to accomplish RETS integration into an otherwise simple and basic website? And if so, how do I shop for one without subscribing to an offsite vendor? Thanks!
Mike
24|May|2011I get the same error as Steve when trying to connect to the default Test Server: ERROR: 200. Refused – Check RETS server or firewall for port 6103.
My ISP, Hosting provider and Teh Staff have worked on this for more than 40 hours. Did anyone get the answer to this?
Mike
24|May|2011One more comment, the Support Forum has been saying “Closed For Maintenance, please check back in a few hours” for almost a month.
I would be happy to pay for this program rather than have it for free. Is there anyone out there who can help? Is there a way to connect with the developer?
trent
02|Jun|2011Mike, If you’re getting a refused error code on port 6108, you may need to check your network firewall (whereever you’re making the request from and allow that port to get through).
You may also want to checkout the php class discussed on this thread:
http://forums.rets.org/showthread.php?t=1220
I’ve not used this but I have downloaded it. If you’re fairly handy with php this would be a MUCH shorter configuration.