Export et import XML

A qui cela sert ?

Si on souhaite échanger des annonces entre deux sites, charger en masse des annonces ou encore faire une sauvegarde, c'est possible avec la fonction intégrée d'importation et exportation XML d'annonces.

Le format XML est un formet texte lisible facilement et éditable.

Modèle XML

Le modéle XML (export et import) peut être obtenu via le menu ADMIN > CONFIGURATION > XML en cliquant sur voir le modèle XML

Le modèle est alors accessible via l'url {yourdomain.com}/phpsvr/xml_service.php?xml=sample et reproduit ci-dessous :

<ZADS_XML>
<!--  the main tag can be customized in settings  -->
<!--  call the xml-service.php with parameters below :  -->
<!--   catid=xx to filter ads from a given category    -->
<!--   id=xx to filter a given ad id   -->
<!--   userid=xx to filter ads from a given userid   -->
<!--   token=xx (mandatory to autenticate the access  -->
<!--   example : GET access to http://localhost/zads60/xml/?xml=ads&token={yourtoken}&catid={youcatid}  -->
    <annonce>
        <id>id/reference number</id>
        <title>title</title>
        <description>text describing the ad content</description>
        <cat_id>id of the category</cat_id>
        <cat_desc>title of the category</cat_desc>
        <type>type of ad : can be sell, buy, ...</type>
        <type2>type for admin - normal or demo</type2>
        <priority>priority of the ads</priority>
        <price>current price</price>
        <currency>EUR</currency>
        <price2>previous price</price2>
        <quantity>quantity or product if in stock mode</quantity>
        <creation_date>creation date in format YYYY-MM-DD hh:mm:ss</creation_date>
        <modification_date>last modification date in format YYYY-MM-DD hh:mm:ss</modification_date>

        <contact>
            <email>email</email>
            <phone>phone</phone>
            <username>username</username>
        </contact>

        <user>
            <user_type>type of user : pro=professionnal ; par=individual</user_type>
            <user_company>company name if user is professionnal</user_company>
            <user_siret>company siret if user is professionnal</user_siret>
            <user_id>reference id of the user on the site</user_id>
        </user>

        <location>
            <city>city</city>
            <zipcode>zip code</zipcode>
            <latlng>48.4915102|7.712391099999991</latlng>
        </location>

        <medias>
            <photos>
                <photo>uri of photo 1</photo>
                <photo>uri of photo 2</photo>
            </photos>
            <videos>
                <video>uri of video 1</video>
                <video>uri of video 2</video>
            </videos>
            <audios>
                <audio>uri of audio 1</audio>
                <audio>uri of audio 2</audio>
            </audios>
        </medias>
    </annonce>
</ZADS_XML>

Exportation d'annonces

Pour accéder à l'export des annonces au format XML, vous devez, depuis un navigateur ou depuis un serveur distant, vous connecter (GET access) au lien {yourdomain.com}xml/xml=ads&token={votretoken}.
Le token permet de sécuriser l'accés aux données et à vos annonces en autorisant uniquement les accés avec ce token valide. Le token doit être généré depuis l'interface d'administration ci-dessous :

Vous pouvez alors sauvegarder le flux XML en opérant sauvegarder depuis votre navigateur ou encore partager ce lien avec un autre site pour l'import de vos annonces.

Les options de filtrages peuvent être passés en paramètres de l'appel :

• catid=1234= exporte les annonces de la catégorie 1234
• userid=1234= exporte les annonces de l'utilisateur 1234
• id=1234= exporte uniquement l'annonce 1234

Le nombre d'annonces exportées peut être limité via l'interface d'administration :

Importation d'annonces

Pour importer des annonces d'un fichier XML au modèle XML indiqué ci-dessus, le principe repose sur un fichier qui est obtenu depuis une URI indiquée . Le fichier est lu, analysé et convertit en annonces dans ZADS.

L'importation est activée manuellement via le bouton lancer l'importation. les annonces importées sont taggées avec origin=xml. Ceci permet de différentier les annonces importées des annonces réelles et ainsi de pouvoir les effacer en masse avec le bouton effacer toutes les annonces importseé.

Du menu ADMIN > CONFIGURATION > XML, on peut effectuer les réglages de :

• Nombre max. d'annonces à charger du flux
• L'état par défaut de publication des annonces (à valider, publiée ou brouillon)

Formatage des différents champs

Les champs XML sont convertis un-pour-un en champs dans le base de données de votre site (tirre, description, ...). les images sont automatiquement transférées sur le site (copiées).

Formatage des details de l'annonceur

Les champs username, phoneet email sont soit hérités du flux XML, si ils sont présents, ou hérités de la fiche ZADS de l'annonceur. Ce choix est fonction du paramètre Détails usager de la source.

L'id de l'utilisateur est soit celui indiqué dans le flux XML, soit celui de la personne effectuant l'importation. Ce choix est fonction du paramètre Id usager de la source.

La localisation de l'annonce via les champs ville, code postalet coordonnées GPS sont soit hérités du flux XML, si ils sont présents, ou hérités de la fiche ZADS de l'annonceur. Ce choix est fonction du paramètre Locatisation de la source.

.

Envoi d'emails aux annonceurs

Annonces existantes

Lors de la synchonisation, le flux XML n'indique pas si une annonce est nouvelle ni la liste des annonces à effacer.

Avant chaque chargement, ZADS procède donc à une mise en mode "effacé" de toutes les annonces puis ensuite les réactive si elles existent dans le flux (en utilisant le tag id présent dans le flux). Si l'annonce existe déjà, on met à jour les champs titre, description, prix, et images.

Statistiques

Chaque activité de synchronisation est tracée dans un journal qui peut être consulté via le menu ADMIN > SYNDICATION > JOURNAL

Journal

nbindique le nombre d'annonces chargées , nbup indique le nombre d'images chargées sur le site.