How to use DJ-Classifieds-Importer

How to use DJ-Classifieds-Importer


Important Note: We distribute the DJ-Classifieds-Importer component along with the active subscription of DJ-Classifieds. That means that if your subscription for DJ-Classifieds is active, you can download and use the DJ-Classifieds-Importer component for free.
- The tool is for those who understand and want to set the import themselves (mainly developers). 
- The support for DJ-Classifieds DOES NOT include the service to set up the XML/feed or DJ-Classifieds-Importer setup. 
- We do not guarantee it will work for everyone and every possible setup. 
Each XML is different and requires time and knowledge for the setup and tests, though we do not provide free setup or support for DJ-Classifieds-Importer. 
If the tool is to complex for you and you need assistance to set up the import from your feed/XML, please contact us to quote the DJ-Classifieds-Importer setup for your website. 
In this case, please provide the XML you want to integrate and all the needed details, and we'll get back to you with the estimation.

All active subscribers of DJ-Classifieds can download the DJ-Classifieds-Importer from the download section.

Exemplary XML for DJ-Classifieds-Importer can be downloaded here:  DJ-Classifieds-Importer exemplary XML feed (7.92 kB 2018-06-04 13:18:50)



DJ-Classifieds-Importer component provides an option to import any data to DJ-Classifieds. Do you have other classified solution and want to migrate to DJ-Classifieds? Nothing easiest, export your data to XML and import with this component!

How to start?

1. Check if your XML file contains fields other than core fields from DJ-Classifieds.
In example XML we have 6 extra fields [size_m2, bathrooms,bedrooms,floor,garage,internet,basement].



Please create suitable fields in your DJ-Classifieds extra fields section:


Make sure all fields from XML are also visible in your DJ-Classifieds extra fields.

2. Next, you need to create a group for feeds in importer; in the example, we used 'Real Estate'.

3. Now, you need to create XML and DJ-Classifieds fields connections


3.1 In the importer field, you need to specify
  1. Name - It's field custom name (not used during import, only for information purpose)
  2. Field's attribute - [optional] if the value of the field is stored in fields attribute, then provide the attribute name
  3. Group - Group of fields to import
  4. Created Date and Created By - fields not used during import
  5. Field's source name - a name of the field in your XML item element
  6. Destination field's type - a type of DJ-Classifieds field
Example of standard fields configuration:

start date



title




garage [value]


garage size [attribute]




3.2 If you want to put a few XML elements into one DJ-CLassifieds field, you can create 2 importer fields that lead to the same DJ-Classifieds field. For example, with DJ-Classifieds field 'contact', we can connect:
XML field 'contact' and 'application_email':



3.3 If your fields are embedded like in below example:
      <location>
        <country>US</country>
        <region>Michigan</region>
        <postal_code>48909</postal_code>
      </location>
Then in field "Field's source name", you need to put a path to this field separated by '|'.

So, in this case, it will be:



and for the second level of regions:



3.4 For elements like regions, categories, types. You can also set a type of synchronization. So, if an element with this name doesn't exist, you can force importer to create this element.


3.5 For Images groups like:

  <fotos>
        <foto>image1_url</foto>
        <foto>image2_url</foto>
        <foto>image3_url</foto>
      </fotos>

You need to set into "Field's source name" the group name of elements and into "Source sub name" name of single photo element. Example:



4. Now, when we have all fields and connections created, you can set up a feed.
  1. Group - your feed group where all fields were
  2. Name - Your custom name of the feed
  3. Description - Your custom Description
  4. Url of synchronization - Link to your feed
  5. XML path to parent item - path to the parent group of items for import (you can separate elements by | )
  6. XML parent item - the name of the single item object
  7. Item external ID field - name if object id field, it helps for the updating process
  8. Action on the duplicated item - You can decide what importer should do with previously imported items (compare on id field)
  9. Ads' author - default adverts author
  10. Expiration date (days) - default expiration duration
  11. Synchronization protocol - a type of import protocol for HTTPS POST curl is used.
Example configuration:

5. Remember to insert Google API keys in DJ-Classifieds configuration because DJ-CLassifieds Importer uses required libraries.
6. After feed creation and DJ-Classifieds configuration, you can use the "Import data" button on feeds list

Please note: You can also use a link to automate this CRON process: http://www.example.com/index.php?option=com_djcfimporter&task=import&id=1 where ID is your feed ID.



      • Related Articles

      • How to use FaLang with DJ-Classifieds

        Here below, you'll find a short tutorial about how to use FaLang with DJ-Classifieds for Joomla.  This will allow you to translate DJ-Classifieds to any language. Falang is a 3rd party integrated with DJ-Classifieds. It allows to translate ...

      • How to use JMailAlerts with DJ-Classifieds

        First, you need to download and install J! email alerts. You'll find relevant information on developer's site: http://techjoomla.com/jmailalerts/view-category.html (be sure to be logged in to download the extension - it's free) Once installed you ...

      • EasySocial integration for DJ-Classifieds

        In this tutorial, I’ll show you how to install both Joomla plugin and EasySocial application. I will also show a basic configuration that can help you display ads on your community stream and social profile. This plugin comes free with the ...

      • How to resize images in DJ-Classifieds?

        DJ-Classifieds keeps the original images/pictures when you upload them. If you want to change your website's template or alter the images in adverts, categories or profiles to a better fit, you can always do this following this tutorial. ( Video ...

      • Auctions in DJ-Classifieds

        DJ-Classifieds component allows hosting auctions on your Joomla powered website! Users can run their own auctions and sell items to your site visitors! To make it everything more comfortable, we will show you how to manage the auctions, place a bid ...