WP All Import add-on for Listable theme

Import fichier XML/CSV dans le thème Listable

Comment importer facilement toute la géolocalisation et les images de vos listings dans le thème WordPress Listable de Pixelgrade ?

Read the english version of this article

Le thème WordPress Listable de Pixelgrade vous permet de créer un annuaire thématique basé sur un système de géolocalisation très performant. Si vous avez l’intention d’utiliser ce thème pour l’un de vos projets et que vous devez importer un listing d’adresses, l’un des meilleurs plugins pour effectuer cette importation est WP All Import.

Cependant, WP All Import ne permet pas nativement d’importer les images de vos listings et il faut utiliser un complément qui ajoute cette fonctionnalité. Malheureusement, ce complément conçu par l’équipe de WP All Import permet uniquement de renseigner l’adresse complète (location) d’un listing. En conséquence, vous devrez pour chaque listing importé, faire appel à l’API Google Maps Geocoding intégré au thème Listable afin que l’icône du listing soit correctement géolocalisée sur les cartes du thème. Dans sa version gratuite l’API Google Maps Geocoding est limité à 2 500 requêtes par jour ou 50 requêtes par seconde, ce qui risque de perturber ou bloquer l’importation de vos listings.

J’ai donc développé un complément pour WP All Import, qui si vous disposez déjà de la géolocalisation de chaque listing, contourne ce problème et vous permet d’importer simplement et facilement vos listings et les images liées dans le thème Listable.

WP ALL Import add-on pour le thème Listable

Il permet de simplifier l’importation de vos fichiers XML/CSV et de toutes les images liées à chaque listing.

Il est totalement compatible avec le plugin WP Job Manager nécessaire au fonctionnement du thème Listable.

Il permet d’importer la géolocalisation complète de chaque adresse grâce à une section dédiée.

Pour importer vos listes d’adresses et images, vous n’aurez rien à acheter ou installer de plus que la version gratuite de WP All Import.

Installation

  1. Installer le plugin gratuit WP All Import
  2. Lire les tutoriels expliquant le fonctionnement de WP All Import
  3. Télécharger et installer WPAI Listable theme Add-On

Importation de la géolocalisation

Le thème Listable utilise le service Google Maps Geocoding pour localiser les adresses lorsque que vous ajoutez ou modifiez un listing. Les données que vous importez dans les champs de géolocalisation doivent être saisies au standard de cette API. Dans le cas contraire vos cartes seront fausses. Lire la documentation de l’API pour connaître le format à utiliser.

Description des champs

Geolocated Flag indiquant si l’adresse doit être géolocalisée avec l’API Google Maps Geocoding
Latitude Latitude en degré. Ex : 48.871913
Longitude Longitude en degré. Ex : 2.302310
Formatted Address Chaîne contenant une adresse lisible de votre listing. Bien souvent, cette adresse équivaut à l’« adresse postale », laquelle diffère parfois d’un pays à l’autre. Cette adresse est généralement composée d’un ou plusieurs composants d’adresse.

Par exemple :

  • l’adresse française « 102 Av. des Champs Elysées, 75008 Paris, France » contient des composants d’adresse distincts pour « 102 » (le numéro de rue), « Av. des Champs Elysées » (la voie), « 75008 » (le code postal),  « Paris » (la ville) et « France » (le pays).
  • l’adresse américaine « 111 8e Avenue, New York, NY » contient des composants d’adresse distincts pour « 111 » (le numéro de rue), « 8e Avenue » (la voie), « New York » (la ville) et « NY » (l’État).

Afin que les adresses soient reconnues correctement, pensez à bien séparer chaque composant d’adresse avec une virgule.

Street number Numéro dans la rue. Ex : 102
Street name Nom de la rue. Ex : Av. des Champs Elysées
City Nom de la ville. Ex : Paris
State short name Nom court de la région. Ex : IdF
State long name Nom long de la région: Ex : Ile de France
Postcode Code Postal. Ex : 75008
Country short name Nom court du pays. Ex : FR
Country long name Nom long du pays. Ex : France

Notez que certains pays, tel que le Royaume-Uni, n’autorisent pas la distribution des vraies adresses postales en raison de restrictions de licence.

En principe, utiliser les champs Latitude, Longitude et Formatted Address est suffisant pour afficher des cartes cohérentes.

Importation des images

Le plus simple est de regarder le tutoriel vidéo ci-dessous qui explique le principe d’importation des images avec WP All Import. Le thème est différent mais le principe d’importation est exactement le même.

© 2015 Soflyy


English version

How to import any geolocation and images of your listings in the WordPress Pixelgrade theme listable .

The WordPress Pixelgrade theme Listable allows you to create a thematic directory based on a high performance geolocated system. If you intend to use this theme for your projects and you need to import an address list, the best plugins to make this import is WP All Import.

But WP All Import does not natively import your listings images and you must use a special addon that adds this functionality. Unfortunately, this addon designed by WP All Import team only uses the listing full address field (location). Therefore, you will need for each imported list, to appeal to the Google Maps Geocoding API integrated into the Listable theme so that the icon listing is correctly geolocated on the maps. In the free version, Google Maps Geocoding API is limited to 2500 requests per day or 50 requests per second, which can disrupt or block the import of your listings.

So I developed a addon for WP All Import, that if you already have the geolocation of each listing, bypasses this problem and allows you to simply and easily import your listings and images related to the Listable theme .

WP ALL Import add-on for Listable theme

It simplifies importing your XML / CSV and all the images associated with each listing.

It is fully compatible with WP Job Manager plugin required to operate the listable theme.

It allows to import full geolocation of each address through a dedicated section.

To import your address lists and images, you will have nothing more to buy or install more than the free version of WP All Import.

Installation

  1. Install the free WP All Import plugin
  2. Read tutorials explaining how WP All Import
  3. Download ans install WPAI Listable theme Add-On

Geolocation importing

The Listabe theme uses Google Maps Geocoding service to locate addresses when you add or modify a listing. The data you import in geolocation fields must be entered in this standard API, otherwise your maps will be wrong. Read the API documentation to use this format.

Fields documentation

Geolocated Flag indicating whether the address should be geotagged with the Google Maps API Geocoding
Latitude Latitude in degree. Ex : 48.871913
Longitude Longitude in degree. Ex : 2.302310
Formatted Address String containing a readable address of your listing. Often this address is equivalent to the « postal address, » which sometimes differs from one country to another. This address is generally composed of one or more address components.

For example :

  • the French address « 102 Av. des Champs Elysées, 75008 Paris, France » contains separate address components for « 102 » (the street number), « Av. des Champs Elysées » (the way), « 75008 » (zip code), « Paris » (the city) and « France » (the country).
  • US address « 111 8th Avenue, New York, NY » contains separate address components for « 111 » (the street number), « 8th Avenue » (the way), « New York » (the city) and « NY » (the state).

For the addresses to be recognized correctly, remember to separate each address with a comma components.

Street number Number in the street. Ex : 102
Street name Name of the street. Ex : Av. des Champs Elysées
City Name of the city. Ex : Paris
State short name Short region name. Ex : IdF
State long name Long region name. Ex : Ile de France
Postcode Zipcode or Postal Code. Ex : 75008
Country short name Short country name. Ex : FR
Country long name Long country name. Ex : France

Note that some countries such as the UK, do not allow distribution of true postal addresses due to licensing restrictions.

In principle, use Latitude, Longitude and Formatted Address fields is enough to show consistent maps.

Importing pictures

The easiest is to watch the video tutorial below which explains the principle of importing pictures with WP All Import. The theme is different but the principle of import is exactly the same.

© 2015 Soflyy


11 thoughts on “Import fichier XML/CSV dans le thème Listable

  1. Bonjour,

    J’ai lu très attentivement à 3 reprises l’article de votre site concernant l’import fichier XML/CSV dans le thème Listable.

    J’ai juste une question.
    Pour obtenir le fichier XML/CSV de départ au standard de l’API Google Maps Geocoding,
    Puis-je exporter mon listing présent sur mon site (j’ai déjà des pages de listes publiées sur mon site) et le réimporter par la suite.
    Ou dois-je d’abord créer tout mon listing d’adresse en CSV au standard de l’API Google Maps Geocoding et l’importer ensuite. Cela va-t-il générer automatiquement des pages/listes sans titre ni contenu ?

    Vous n’êtes bien sûr pas du tout obligé de me répondre mais une réponse de votre part m’aiderait grandement pour essayer de mettre ça en place et tester votre extension WPAI Listable dans la 3ème partie de la procédure d’importation via WP All Import plugin .

    Bien à vous

    1. Bonjour,

      Comprenez bien que mon plugin [WP ALL Import add-on for Listable] ne sert qu’à contourner une limitation de l’API Google Maps Geocoding dans sa version gratuite. En fournissant dans votre fichier import les adresses et géolocalisation de vos annonces, vous supprimez l’accès à ce service. Comme le thème Listable utilise le format de cet API, vous devez compenser/reproduire les adresses au format de l’API.

      Par exemple, si vous désirez importer une annonce sur le restaurant « LE RABASSIER » de Bruxelles, votre fichier doit contenir non seulement son nom, un contenu, son adresse dans le champ Formatted Address «  Rue Duquesnoy 6, Bruxelles 1000, Belgique », mais aussi la latitude, longitude et tous les autres champs d’adresse correctement remplis , sans oublier d’indiquer dans le champ Geolocated la valeur 1.

      Concernant les annonces déjà présentes dans votre site, il me semble me souvenir qu’il existe une fonction limitant les doublons dans WP Import. Voir sa doc ou faire un essai avec 1 ou 2 annonces

      Espérant avoir répondu au mieux

      1. Je vous remercie votre réponse qui m’a déjà aidé à mieux comprendre le fonctionnement de votre addon.

        Le fait de contourner la limitation de l’API Google Maps Geocoding est une idée géniale.

        Je suis arrivé à l’étape 4 mais n’ai pas osé continuer plus loin de peur de générer des conflits ou un doublon complet des listes.

        Si on suit votre logique, l’idée est donc de partir d’un fichier CSV ou xml dans lequel on retrouve en ligne les infos suivantes pour chaque lieu : titre, contenu, fomatted address, lat, long + Geolocated la valeur 1 via Xpath

        Maintenant si je pars d’un fichier export conçu à partir de mes listes déjà encodée, est-il possible d’uniquement mettre à jour ces 5 mêmes informations sans mettre mes pages en péril ?
        Process : Encodage des infos pour les lieux(listing) via le CMS de wordpress > export listing xml via wordpress > Fichier xml import via WP ALL Import + à l’étape 3 [WP ALL Import add-on for Listable]

        La meilleure marche à suivre serait-elle d’éviter l’encodage des infos pour les lieux(listing) via le CMS de wordpress et de plutôt partir d’un fichier de base (contenant les infos de chaque lieu : titre, contenu, Fomatted address, lat, long + Geolocated la valeur 1 via Xpath ) pour générer toutes les listes ?

        1. Alors,

          Je confirme que le contenu du fichier d’import est correct. Mais vous pouvez y mettre ce que vous vous voulez, puisque vous devez joindre chaque champs de votre fichier à un champ de la bdd du thème Listable.

          Concernant la gestion des doublons ou de la mise à jour des annonces existantes, lors du processus d’importation dans la dernière étape de l’assistant de WP All Import vous trouverez ceci
          WP All Import - Gestion des doublons et MAJ
          Cela vous permet de gérer au mieux les données que vous importez

          Quant à la meilleure marche à suivre, tout dépend du nombre d’annonces à publier. Le seul conseil que je peux vous donner, avec de tout importer, validez votre importation avec une dizaine d’annonces représentatives des différents formats de donnée à importer (taxonomies, images, adresses, etc..). Ne pas le faire c’est le casse pipe assuré avec au final un p’tit coucou au plugin WP Reset 😉

  2. Dès lundi matin, je testerai la méthode ci-dessous et vous tiendrez au courant.
    > Export de tous mes listings en fichier xml via wordpress
    > Import de ce même fichier via WP ALL Import
    > drag & drop les valeur suivantes dans les bons champs > titre, contenu, fomatted address, lat, long + Geolocated la valeur 1 via Xpath
    > Dernière étape je cocherai « update existing post with changed data in your file »
    Par contre il ne devrait y avoir aucune réelle mise à jour car je partirai du fichier export de base sans ajouter d’autres données. On verra ce que ça donnera… Encore merci pour votre dernière réponse.

  3. Voici les résultats,
    J’ai donc
    > exporté de tous mes listings en fichier xml via wordpress
    > Importé ce même fichier dans WP ALL Import en sélectionnant l’option « Existing Items » puisque je pars d' »Items » existants
    > « Import to existing « Listings « and update some or all of their data » puisque c’est ça que je veux.
    > Step 2 : « 131 items elements will be imported »
    > Step 3 :
    Drag & Drop Title, Content
    Dans le Listable Add-on Drag & Drop Fomatted address, lat, long + Geolocated (checked) la valeur 1 via Xpath
    > Step 4 : Juste sélectionné – Update existing posts with changed data in your file & – Update all dataRun

    Tout semble bien avoir été importé.
    Mes fichiers sont les mêmes qu’avant, ce qui est donc normal.
    Si j’enlève ma clé API, la carte géographique n’apparaît plus, ce qui est normal en temps normal mais avec l’importation que je viens d’effectuer, la carte ne devrait elle pas continuer à apparaître ?
    Comment puis-je savoir si j’ai réussi à contourner la limitation de l’API Google Maps Geocoding ?

    1. Enlever la clé API revient à dire que vous désirez ne plus utiliser les cartes de GG Maps, il est donc normal qu’elles ne s’affichent plus.

      A partir du moment où dans le fichier d’import vous indiquez 1 pour le champ Geolocated, aucun appel n’est effectué à GG.

      Listable utilise 2 produits de Google Maps.
      – Google Maps JavaScript API pour l’affichage des cartes
      – Google Maps Geocoding API pour la recherche des coordonnées GPS des annonces.

      Exemple d’appel au service de géolocalisation https://maps.google.com/maps/api/geocode/json?sensor=false&address=Saint-Beauz%C3%A9ly,Aveyron,France

  4. Un tout grand merci pour vos conseils et explications, grâce à vous, je pense bien avoir finalement réussi le processus d’importation 🙂 🙂 🙂

  5. Re-bonjour après 2 ans 🙂
    J’ai encore une petite question :
    L’extension permet-elle d’une manière ou d’une autre de contourner le nouveau système de pricing de Google Map.
    J’avais à l’époque testé votre extension sur 131 adresses, maintenant on a plus de 1000 adresses sur le site (guide-ecoles.be). L’utilisation du site par les visiteurs commence à générer des coûts google map de plus en plus élevés et qui dépassent le crédit gratuit mensuel… Nous sommes une association sans but lucratif donc limitée en terme de financement. Nous avons d’ailleurs introduit une demande auprès de Google pour devenir un partenaire social.

    1. Bonjour,

      Ce qui génère un coût important c’est l’affichage des cartes avec l’API GG Maps et non l’utilisation de l’API Geocode de Google. En effet ce dernier vous facture 0.005 USD par appel donc 5$ pour une importation de 1000 écoles

      Dans Listable, il est aussi possible d’utiliser l’API MapBox gratuitement jusqu’à un certain point. A voir si cela vaut le coup pour vous. Vous trouverez toutes les infos à ce sujet à https://pixelgrade.com/docs/listable/faq/maps-services-using-need-pay/

      Cordialement

      1. Merci pour votre réponse,
        Map box est en effet gratuit jusqu’à un certain point mais n’est pas plus avantageux que Google au final, vu le trafic sur notre site. Nous allons probablement chaque mois activer et désactiver l’option MAP sur le site, une fois les crédits gratuits épuisés…

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.