Websource Nouveautés pour WordPress — référence développeur

Vue d'ensemble

• Espace de noms Websource\NewProducts, classes dans src/ (chargeur PSR-4 maison, pas de Composer).
• Données : option wsx_newproducts_blocks (tableau de blocs assainis, 30 au plus), option wsx_newproducts_settings (new_days), transients wsx_np_* (identifiants de produits, 5 minutes), option wsx_newproducts_cache_v (génération du cache), wsx_newproducts_version.
• Capacité requise pour l'administration : manage_woocommerce.
• Inerte sans WooCommerce : le code court renvoie une chaîne vide, un avis s'affiche dans l'administration.

Bloc Gutenberg websource/products

Rendu serveur (block.json, apiVersion 3, éditeur sans build). Catégorie WooCommerce.

<!-- wp:websource/products {"blockId":2,"count":4,"layout":"carousel","align":"wide"} /-->

Code court [websource_newproducts]

[websource_newproducts block="8" title="Notre sélection du moment" columns="3"]

Fonctions PHP

echo websource_newproducts_render(['block' => 2, 'count' => 4, 'layout' => 'carousel']);

websource_newproducts_render(array $options = []): string accepte les mêmes clés que le code court. Les blocs enregistrés sont lisibles par \Websource\NewProducts\Plugin::instance()->store()->all().

Emplacements automatiques

Filet de sécurité en thème à blocs : les emplacements non trouvés sont imprimés dans wp_footer. Les sections placées automatiquement portent la classe wsnp--placed (ou wsnp--placed-in alignwide dans le contenu).

Pages reconnues (PageDetector, filtre websource_newproducts_current_page) : home, shop, category, product, cart, checkout, cms, blog, search.

Filtres

Actions

Évènement JavaScript : websource_newproducts_added_to_cart sur document (detail.productId, detail.response) après un ajout AJAX ; wc-blocks_added_to_cart et added_to_cart (jQuery) sont aussi déclenchés pour les compteurs de panier.

Gabarits

Surchargeables dans votre-theme/websource-newproducts/section.php et item.php. section.php reçoit $view (uid, block_id, layout, is_carousel, class, style, title, subtitle, show_button, button_label, button_url, labels, cards, json_ld, item_template) ; item.php reçoit $card.

Structure : section.wsnp.wsnp--grid|wsnp--carousel[.wsnp--custom] > .wsnp__head (.wsnp__title, .wsnp__subtitle, .wsnp__nav avec [data-wsnp-prev] / [data-wsnp-next]) + .wsnp__track[data-wsnp-track] > .wsnp-item > article.wsnp-card[data-product-id] + .wsnp__more > a.wsnp__link.

Routes REST

Espace websource-newproducts/v1.

GET /wp-json/websource-newproducts/v1/products?search=sac
X-WP-Nonce: <nonce wp_rest>

[
  { "id": 42, "name": "Sac à dos Nordik", "sku": "WS-007", "image": "https://exemple.fr/wp-content/uploads/2026/10/sac-a-dos-nordik-150x150.jpg" },
  { "id": 39, "name": "Sac cabas Atelier", "sku": "WS-006", "image": "…" }
]

GET /wp-json/websource-newproducts/v1/blocks

[
  { "id": 1, "name": "Nouveautés", "source": "native", "active": true, "placement": "Page d’accueil" }
]

Sans nonce ou sans droit : 401 / 403.

Export / import

admin-post.php?action=wsx_newproducts_export (nonce) télécharge websource-newproducts-<date>.json :

{
  "section": "newproducts",
  "version": 1,
  "plugin": "1.3.0",
  "data": {
    "new_days": 30,
    "blocks": [
      {
        "id": 7, "name": "Une catégorie", "active": true,
        "position": "none", "hook": "", "page": "all",
        "title": "Pour la maison", "subtitle": "", "button_label": "Voir tout", "show_button": true,
        "count": 8, "source": "category", "category": "category:maison", "products": [],
        "sort": "newest", "period_days": 30, "layout": "grid", "columns": 3,
        "show_badges": true, "badges": ["new", "discount", "on-sale", "pack", "out_of_stock"],
        "show_cart": true, "lazy_images": true, "json_ld": true,
        "use_theme_design": false, "bg_color": "#14282b", "title_color": "#ffffff", "borders": "without", "radius": "lg"
      }
    ]
  }
}

Références stables : category:<slug>, product:<UGS>, product-slug:<slug>. ThemePackage::import(BlockStore $store, array $section, bool $merge): ?array renvoie ['blocks' => n, 'warnings' => [références introuvables]], ou null si le fichier n'est pas une section newproducts.

Valeurs d'un bloc

Variables CSS

La feuille assets/css/front.css lit le thème avec repli :

Variables posées sur chaque section (attribut style, surchargeables) : --wsnp-cols, --wsnp-cols-md, --wsnp-bg, --wsnp-title, --wsnp-line, --wsnp-shadow, --wsnp-radius, --wsnp-radius-lg.

Cookies et cache

• Cookie wsx_np_viewed : 20 derniers produits consultés, posé seulement si un bloc utilise la source « déjà vus ».
• Transients wsx_np_<hash> : identifiants par bloc, langue, devise et contexte ; vidés sur woocommerce_update_product, woocommerce_new_product, woocommerce_delete_product, woocommerce_trash_product, woocommerce_product_set_stock, woocommerce_variation_set_stock, woocommerce_product_set_visibility, woocommerce_order_status_changed, woocommerce_scheduled_sales, transition_post_status d'un produit, edited_product_cat, delete_product_cat, enregistrement des blocs. Un résultat vide n'est pas mis en cache.

Traductions

Domaine websource-newproducts, fichiers languages/websource-newproducts-fr_FR.po|mo et .json pour les scripts. Textes saisis : wpml-config.xml (admin-texts sur wsx_newproducts_blocks) et pll_register_string (groupe « Websource New Products »).