Aller au contenu principal

Comment modifier la visibilité des articles d'une variante

Lorsque vous utilisez la fonctionnalité Produits groupés de notre intégration WooCommerce, les articles enfants (les variations individuelles) sont généralement exclus du catalogue principal pour éviter de l'encombrer. Vous pouvez toutefois souhaiter personnaliser ce comportement.

Comportement par défaut​

Par défaut, StoreLinkr règle la visibilité des articles enfants sur search. Cela signifie qu'ils :

  • n'apparaissent pas sur les pages de catégorie ;
  • apparaissent bien dans les résultats de recherche ;
  • apparaissent bien comme articles liés au sein du produit groupé.

Personnaliser la visibilité avec des filtres​

Les développeurs peuvent utiliser le filtre storelinkr_single_visibility pour modifier ce statut par programmation. C'est utile si vous voulez que certains articles restent complètement masqués ou entièrement visibles dans le catalogue selon des conditions précises (par exemple le niveau de stock ou la catégorie).

Exemple de code​

Ajoutez ceci à votre fichier functions.php :

add_filter('storelinkr_single_visibility', 'custom_storelinkr_visibility', 10, 2);

/**
 * Adjust product visibility based on conditions.
 *
 * @param string $visibility Current visibility ('visible', 'catalog', 'search', or 'hidden').
 * @param int $product_id The WordPress Product ID.
 * @return string The modified visibility.
 */
function custom_storelinkr_visibility($visibility, $product_id) {
    // Example: Hide a specific product completely
    if ($product_id == 123) {
        return 'hidden';
    }
    
    // Example: Make everything fully visible in the catalog
    // return 'visible';
    
    return $visibility;
}

Valeurs de visibilité prises en charge​

Elles correspondent aux états de visibilité standard de WooCommerce :

  • visible : visible partout (catalogue et recherche).
  • catalog : visible uniquement dans le catalogue et les pages de catégorie.
  • search : visible uniquement dans les résultats de recherche (valeur par défaut de StoreLinkr pour les produits enfants).
  • hidden : complètement masqué sur le frontend.

Tester les modifications​

Les changements de visibilité sont appliqués pendant le processus de synchronisation. Si vous modifiez votre code :

  1. Attendez la prochaine synchronisation planifiée.
  2. OU déclenchez une synchronisation manuelle de la variante concernée depuis le portail StoreLinkr pour voir immédiatement les changements.