Check for Updates and License Status

Check For Updates Check License Status Activate Your License

Documentation

• FeedSync Documentation
• How to Upgrade to FeedSync 2.0
• How to Upgrade old MyDesktop image URLs
• How to Import REAXML files into Your WordPress Real Estate Website

How to install FeedSync

Your first step is to determine where you want to install FeedSync on your server. Download the application from your account at Easy Property Listings.

Uncompress feedsync.zip on your computer and FTP the feedsync directory into the XML/ directory on your server

• cPanel: Recommended folder: public_html/XML/
• Plesk/Parallels: Recommended folder: httpdocs/XML/

Create a database for FeedSync to store listing data

FeedSync uses a SQL database to store listing data in. Login to your hosting and create a MySQL database.

cPanel Database

• Click the MySQL Database Wizard under the Databases heading.
• Next to New Database enter a name for your database and click Next Step.
• Next to Username enter a username.
• Enter a password next to Password, enter it again for Password (Again) and then click Create User
• On the next page, you'll assign privileges for the user to the database. Check the box next to All Privileges and then click Next Step.

Plesk/Parallels Database

• Login to your hosting and click the Websites tab.
• Click the Databases under the Websites & Domains heading.
• Press Add New Database enter feedsync for Database name.
• Make a note of the Database server.
• Under the Users heading enter feedsync in the Database user name field.
• Enter a strong secure password in the New password field, enter it again for Confirm password field (Again) and then click Ok.

Congratulations, you have just successfully created a database for FeedSync!

Make a note of your database name, password and database username.

Performing the The Initial FeedSync Setup

There is only one file that you need to edit in order for your FeedSync to work which is the config.php file located in the feedsync directory.

Open up your FTP program and navigate to the folder where you installed FeedSync and open the config.php file in a text editor. Edit the following details highlighted in bold below:

Base settings

• define('SITE_URL', 'http://YOUR_WEBSITE_DOMAIN_NAME.COM.AU/XML/feedsync/');
• define('DB_NAME', 'DATABASE_NAME' );
• define('DB_USER', 'DATABASE_USER_NAME' );
• define('DB_PASS', 'DATABASE_PASSWORD' );
• define('DB_HOST', 'localhost' ); // Plesk/Parallels: replace localhost with your Database server details.
• define( 'EPL_LICENSE_URL' , 'YOUR_URL');
• define( 'EPL_LICENSE_KEY' , 'YOUR_KEY');

Save the config file and visit your feedsync directory from your browser and you should see FeedSync in all its glory :)

Automatically generate latitude and longitude coordinates

Some providers supply latitude and longitude coordinates for listings and some do not. Once you receive files from your provider open one of the XML files and look for a <Geocode> node which contains the Lat and Long values. If <Geocode> is not present set the following option to ON. Default is OFF.

Once your provider has delivered the REAXML files and they are ready for processing by FeedSync for the first time it is best to leave the setting OFF, process the files then manually generate your coordinates from the Process Page. Once the coordinates are generated for all the listings, set the following setting to ON.

• define( 'GEO_ENABLED' , 'OFF'); // ON or OFF

Force re-generating coordinates

In some instances your coordinates may not be correct so you can set the FORCE_GEOCODE setting to ON which will re-generate all coordinates for your listings. Once updated, set this setting to OFF.

• define( 'FORCE_GEOCODE' , 'OFF'); // ON or OFF

Test Geocode Credit Status

FeedSync uses the Google Geocoding API to convert the property addresses in your XML file during import into lat/long coordinates so your website can display the address with a map. NOTE: Google has usage limits of 2,500 requests per day and you can check the status with the button below.

Check Geocode Status

Create a unique FTP account for your REAXML provider

We recommend that you to create an unique FTP account for the feed provider which will only give them access to the feedsync/input folder. They don't need access to anything else on your server. This lets you move FeedSync later and all you have to do is edit the providers FTP Account Directory on your hosting.

Log into your hosting account and press the FTP Accounts button. Create a unique FTP Account using a unique username and strong secure password.

Important: In the Directory field specify the FeedSync input folder. With cPanel its usually:

• cPanel: Recommended: public_html/XML/feedsync/input
• Plesk/Parallels: Recommended: httpdocs/XML/feedsync/input

Supply your REAXML feed provider with their unique FTP details:

• FTP Account: ftp.myawesomewebsite.com.au
• User name: reaxml@myawesomewebsite.com.au
• Password: Secure password e.g. rn7vHgU Note: Some providers have difficulty with long passwords.
• Folder: Leave this blank as you have only given them access to the feedsync/input folder.

Once your provider has configured their end they will start delivering REAXML files to the input folder. When files are in the feedsync/input folder they will be listed on the FeedSync home page as ready for processing.

Processing for the first time

Once you have received REAXML files you can perform the import process manually to check that everything is working correctly with your configuration.

Upgrading From FeedSync 2.0+

Upgrading FeedSync to 2.1 from 2.0+ is a simple process. Download the latest version of FeedSync from your account. Unzip the file to your computer and all you need to do is replace the /core folder and its contents in your installation of FeedSync on your server.

Once you have upgraded the core files you need to perform a one time Database Upgrade from the Process page which will allow you to filter listings by office id and address values. Once the database is upgraded you can update your agent database with the Process Listing Agents button.

Instructions to upgrade from FeedSync 1.3 or lower can be found here.

How To Setup Your Cron Job

Once your feed is working correctly and you have successfully processed your initial feed manually you can create a cron job on your server to process the files automatically.

Login to your server cPanel account (usually just add /cpanel to the end of your domain name. Once you have logged in look for the Cron Jobs button. On the Cron Jobs page under the Add New Cron Job under common settings select Once every 30 minutes and insert the following into the Command box and press Add New Cron Job.

Option 1 is the most reliable for servers.

Cron Option 1

Cron Option 2

Cron Option 3

Now your FeedSync will check for new files and run will process them at your scheduled cron times. Alternative to wget cron command for some servers.

Exporting Listings for Import

FeedSync has an export tab for exporting xml files manually.

You can also use the dynamic action to and you can also directly access the export via a URL for importing into your website. Using Easy Property Listings with WP All Import Pro and the Importer Add-On allows you to import REAXML listing data into your WordPress website.

Note: This will only output listings that are current, leased, sold. If you want to include withdrawn and off market listing you can use &status=all

You can specify the file output using the following variables based on the REAXML specifications.

1. ?action=do_output : this is required
2. &type=all or a singular value of ( all, residential, rental, land, rural, commercial, business, commercial_land)
3. &status=current or a singular value of (current, sold, leased, withdrawn, offmarket, all)

Adjust the type=residential to the post type you want to export. Available types are:

• residential
• rental
• land
• rural
• business
• commercial
• commercialland

Additional Listing Export Commands

You can also output your listings by address fields and agent/office id.

You can output listings by additional options indicated below.

1. ?action=do_output : this is required
2. &agent_id=123456 : output listings by office id.
3. &date=today : output listings by the current date.
4. &days_back=10 : output listings for the past number of specified days.
5. &street=Smith Street : output listings by street name.
6. &suburb=Sydney : output listings by suburb.
7. &state=WA : output listings by state.
8. &postcode=6000 output listings by postcode.
9. &country= output listings by country.

Exporting Agents

You can export all agents present in your database for import.