How to install and use FeedSync 2.0
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.
- 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.
- 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:
- 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');
To generate latitude and longitude coordinates or not
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.
- define( 'FS_GEOCODE' , 'OFF'); // ON or OFF
Save the config file and visit the feedsync directory from your browser and you should see FeedSync in all its glory :)
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 from the Help page of your FeedSync installation.
Create a unique FTP account for your REAXML provider
Recommended is for 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: firstname.lastname@example.org
- Password: Really long secure password like rn7vHgU3mURXYVyxwLYCyYAkH
- 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.
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 Jobsbutton. 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
wget -q -O /dev/null "http://easypropertylistingsdemo.com/XML/feedsync/core/cron.php"
Cron Option 2
/usr/bin/php -q /home/easydemo/public_html/XML/feedsync/core/core/cron.php
Cron Option 3
Now your FeedSync will check for new files and run will process them at your scheduled cron times.
Exporting Files to 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 for with WP All Import Pro allows you to import REAXML listing data into your WordPress website.
You can specify the file output using three variables based on the REAXML specifications
- action=do_output : this is required
- &status=current or a singular value of (current, sold, leased, withdrawn, offmarket)
- &type=all or a singular value of ( all, residential, rental, land, rural, commercial, business, commercial_land)
Note: action=do_output is required and the remaining defaults are all.