Vous avez rendez-vous dans Gather Town

Comme vous voulez !

Le paramétrage de l’extension Connecteur WooCommerce Polaris permet de déterminer la correspondance des taxonomies Polaris et WooCommerce.

Pour chaque taxonomie Polaris (catégories, classification; saison, collection, niveau) peut être associée à une taxonomie WooCommerce (catégorie, étiquette, attributs…). Les taxonomies personnalisées, apportées par d’autres extensions sont également supportées.

Pour chaque taxonomie, vous choisirez :

• si un produit différent doit être crée pour chaque élément (par exemple par couleur)
• A quelle taxonomie WooCommerce elle doit être associée
• Si vous sélection un attribut vous pourrez également choisir si cet attribut sera utilisé comme variation et s’il doit être visible publiquement.

Si rien de tout ça n’est sélectionné, la taxonomie sera tout simplement ignorée.

Contexte

Vous vous attendez à voir certains produits dans la boutique en ligne, mais ils ne sont pas importés.

Cela peut-être dû à un plantage lors du processus d’importation ou simplement d’un mauvais réglage. Il convient en premier lieu de déterminer la cause de l’absence du produit pour pouvoir le corriger.

Solution

Pour savoir si un produit absent est lié à un bug ou un réglage, vous devez en premier identifier la cause.

Pour cela, vous devez identifier précisément un produit présent dans votre caisse et absent de la boutique.

Vous aurez besoin de son numéro ou du numéro de modèle.

1. Importer manuellement tous les produits

Lors du processus d’importation, le connecteur appelle la caisse Polaris pour récupérer tous les produits avec ces critères :

• correspondant aux filtres
• modifiées depuis le dernier import

pour vérifier les critères de filtre, il faut vérifier l’ensemble des produit.

Pour cela, lancez un import partiel manuel, avec la date vide , la case taxonomies décochée.

Vous serez alors redirigé vers la vue détaillée de l’import.

2. Extraire le fichier brut des produits

Lors de la première étape, les produits sont récupérés successivement et stockés dans un fichier au format json.
Ce fichier est accessible depuis la vue détaillée d’un import, il s’agit du fichier Produits Polaris brut.

Cliquez dessus pour télécharger et ouvrir le fichier.

De base, le fichier est un texte pas très lisible par les humains (mais très compréhensible pour les machines).

Heureusement, certains navigateurs permettent de mieux lire ce format de fichier

Le navigateur Firefox affiche le fichier dans un format mis en forme et très pratique puisque l’on peut déplier/replier les éléments imbriqués

Le navigateur Chrome propose une option « Impression élégante » qui rend le texte plus lisible.

3. Chercher le produit par son numéro

Une fois le fichier affichez, utilisez la fonction de recherche dans la page (raccourcis commande + F) ou en passant par le menu du navigateur.

Saisissez le numéro du produit que vous recherchez et validez

Plusieurs résultats peuvent correspondre, surtout si vous utilisez le numéro de modèle.

Analyse

Si le produit est présent dans le fichier, comme dans l’exemple ci-contre, le problème vient sans doute d’un plantage lors de l’import.
Dans ce cas, vous pouvez affiner les réglages d’import.

Si le produit est absent du fichier, il s’agit d’un problème lié aux filtres.
Dans ce cas, il convient de vérifier les filtres d’importation.

Les produits sans image peuvent être placé en brouillon lors de la synchronisation.

Explications

Le hook d’action polaris_update_product utilise l’identifiant de produit WooCommerce $product_id et les données Polaris $polaris_data.

On utilise donc la fonction add_action() avec la priorité par défaut (10) et 2 comme nombre de paramètres attendus.

add_action( 'polaris_update_product', 'NOM_DE_LA_FONCTION', 10, 2 );

Dans cet exemple, nous vérifions que les données Polaris ne contiennent pas d’attribut medias ou que celui-ci est vide et que le produit courant n’est pas en brouillon :

if ( ( ! isset( $polaris_data['medias'] ) || ! count( $polaris_data['medias'] ) ) && get_post_status( $product_id ) !== 'draft' ) {
     // Faire quelquechose
}

Ici, nous voulons le passer à l’état de brouillon

$product = wc_get_product( $product_id ); // Récupération du produit WooCommerce
$product->set_status( 'draft' ); // Affectation de l'état
$product->save(); // Enregistrement

On peut utiliser un procédé similaire pour (re)publier les produits qui ont une image.

Vous pouvez utiliser le code suivant dans le fichier functions.php de votre thème ou dans votre extension personnalisée.

add_action( 'polaris_update_product', function ( $product_id, $polaris_data ) {
	if ( ( ! isset( $polaris_data['medias'] ) || ! count( $polaris_data['medias'] ) ) && get_post_status( $product_id ) !== 'draft' ) {
		$product = wc_get_product( $product_id );
		$product->set_status( 'draft' );
		$product->save();
	}
  if ( isset( $polaris_data['medias'] ) && count( $polaris_data['medias'] ) && get_post_status( $product_id ) !== 'publish' ) {
		$product = wc_get_product( $product_id );
		$product->set_status( 'publish' );
		$product->save();
	}
}, 10, 2 );

Cas pratique : Votre caisse Polaris comporte ces catégories :

• Femme
  • Lingerie
    • Soutien-gorge
    • Culotte
    • Slip
  • T-shirt
• Homme
  • Lingerie
    • Caleçon
    • Slip
  • T-shirt

Mises à plat, vous aurez 2 catégories nommées Lingerie, 2 T-shirt et 2 Slip. Vous pouvez vouloir les différencier, outre la hiérarchie.

Le hook de filtre polaris_taxonomy_parameters permet de surpasser les attributs lors de la création des taxonomies dans WooCommerce.

Dans l’exemple suivant, nous allons ajouter le code de taxonomie à l’identifiant (slug)

add_filter( 'polaris_taxonomy_parameters', function ( $params, $taxonomy, $polaris_term ) {
	if ( $taxonomy == 'product_cat' ) {
		$params['slug'] = $polaris_term->Code . '-' . $polaris_term->Nom;
	}
	return $params;
}, 10, 3 );

Son URL deviendra alors quelque chose comme : https://votreboutique.shop/categorie-produit/007-lingerie/

Suivant le paramétrage de la passerelle sur Polaris, les données peuvent varier :

Si ces options sont activées alors c’est le libellé internet qui est retourné (s’il est renseigné) sinon c’est le libellé modèle.

Si ces options ne sont pas activées alors c’est le libellé modèle qui est retourné.

Le connecteur WooCommerce Polaris lie votre boutique WooCommerce à un magasin Polaris.

Lors du paramétrage de l’extension, vous choisissez à quel magasin votre site e-commerce est associé, c’est ce magasin qui fera référence pour synchroniser le stock sera des produits.

Par ailleurs, vous serez également amené à renseigner les identifiants de caisse et de vendeur qui seront utilisés pour créer les ventes effectuées de puis la boutique.

J’utilise le connecteur Polaris pour WooCommerce et je souhaite synchroniser de façon automatique les produits, cependant, certains produits ne sont pas importés.

Plusieurs cas de figure peuvent expliquer l’absence de produits dans l’import automatique.

Pour vous assurer de la cause, le mieux est de se référer aux journaux d’importation.

Solution 1 : vérifier les filtres

Si l’import s’est bien déroulé et que certains produits ne sont pas importés, il convient sans doute de mettre à jour les filtres d’import.

Solution 2 : Ajuster les paramètres de synchronisation

Le nombre de produits à traiter lors de l’appel à l’API Polaris et pendant le processus d’importation sont à affiner en fonction des ressources de votre serveur.

Si les imports n’aboutissent, réduire les valeurs augmentera considérablement vos chances de réussite. L’import sera juste un petit peu plus long.

Les ventes réalisées sur la boutique WooCommerce sont envoyées à Polaris en temps réel avec la référence de chaque article Polaris.
Une note de synchronisation est alors ajoutée à la commande WooCommerce avec le numéro de vente.

Ainsi, vous pouvez retrouver facilement la vente en caisse

Il se peut que la synchronisation automatique de vos ventes ne soit pas pris en compte et que donc, toutes les données liées aux transactions sur votre boutique en ligne n’apparaissent pas sur votre logiciel de caisse.

Solutions :

Pour remédier à cette situation, il vous suffit de garder votre logiciel de caisse allumé. Toutes les ventes générées pendant votre inactivité seront prit en compte durant la synchronisation automatique à tout moment. Attention la caisse éteinte va empêcher la synchro automatique du stock.