Toute la documentation

Weekly Sale – Documentation

Vente flash hebdomadaire

Weekly Flash Sale vous aide à lancer une promotion flash récurrente sans devoir vous connecter à chaque jour de vente. Au jour et à l’heure configurés, le module sélectionne un produit actif éligible, crée pour ce produit un code de réduction PrestaShop sous forme de règle panier à durée limitée, et peut publier l’offre sur Instagram, Facebook et X lorsque les modules sociaux correspondants sont installés et actifs.

Le module ne modifie pas définitivement les prix des produits. Il crée une règle panier de type coupon avec une date de début, une date de fin, une restriction produit, un pourcentage de réduction et un code généré. À la fin de la période de validité, le code expire.

Compatibilité : PrestaShop 1.6 à 9.0 (dernière version), PHP 7.1+. Nous continuerons à prendre en charge les prochaines versions de PrestaShop.

Weekly Sale, Weekly sale schedule Weekly Sale, Admin integrity

Fonctionnement

Vous choisissez le jour de vente hebdomadaire, l’heure, le pourcentage de réduction, le préfixe du code, la durée du code et la fenêtre de protection contre les répétitions. Lorsque la tâche planifiée s’exécute, Weekly Flash Sale :

  1. Sélectionne un produit actif au hasard dans la boutique actuelle.
  2. Ignore les produits utilisés récemment, selon votre réglage de protection contre les répétitions.
  3. Génère un code de réduction à partir de votre préfixe.
  4. Crée une règle panier PrestaShop limitée au produit sélectionné.
  5. Génère les légendes à partir de vos modèles Instagram, Facebook et X.
  6. Utilise l’URL de l’image de couverture du produit pour la publication sociale.
  7. Enregistre le résultat dans l’historique des ventes du module.

La tâche planifiée enregistrée par le module est :

weekly_flash_sale
Weekly Flash Sale, pick product, create discount, publish to social

Le format de planification utilisé en interne est :

weekly:{SALE_DAY}:{SALE_HOUR}

Exemple de planification par défaut :

weekly:3:08:00

Dans ce format, 3 signifie mercredi et 08:00 signifie 8 h 00.

Weekly Sale, Run now dry run buttons

Installation

  1. Dans votre Back Office, allez dans Modules → Module Manager.
  2. Cliquez sur Upload a module et sélectionnez le fichier ZIP.
  3. Après l’installation, cliquez sur Configure.
  4. Vérifiez la commande cron affichée dans le panneau de configuration du module.
  5. Enregistrez vos réglages de vente et lancez un dry run avant la première vraie promotion.
Weekly Sale, Social caption templates

Configuration

Réglages de la vente

Enable, Active ou désactive la tâche de vente hebdomadaire.

Sale Day, Choisissez le jour de la semaine où la vente flash doit être créée.

0 = Sunday
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday

Sale Time, Heure de la journée au format 24 heures.

08:00
14:30
21:15

Discount Percentage, Pourcentage de réduction appliqué à la règle panier générée.

50

Duration, Nombre d’heures pendant lesquelles le code de réduction reste valide.

24

Code Prefix, Préfixe utilisé pour générer les codes coupon.

FLASH

Un code généré ressemble à ceci :

FLASHA1B2C3

Repeat Protection, Nombre de semaines pendant lesquelles le même produit ne doit pas être sélectionné à nouveau.

12

Les principales clés de configuration et leurs valeurs par défaut sont :

DISCOUNT_PERCENT=50
DURATION_HOURS=24
CODE_PREFIX=FLASH
HISTORY_WEEKS=12
SALE_DAY=3
SALE_HOUR=08:00
ENABLED=1

Modèles de légende

Vous pouvez configurer des modèles de légende distincts pour Instagram, Facebook et X.

Variables disponibles :

{product_name}
{original_price}
{sale_price}
{discount}
{code}
{product_url}

Légende Instagram par défaut :

FLASH SALE! {discount}% OFF today only!

{product_name}
Was: {original_price}, Now: {sale_price}

Use code: {code}

{product_url}

#prestashop #flashsale #ecommerce

Légende Facebook par défaut :

FLASH SALE! {discount}% OFF today only!

{product_name}
Was: {original_price}, Now: {sale_price}

Use code: {code}
Shop now: {product_url}

Légende X par défaut :

FLASH SALE! {discount}% OFF, {product_name}

Use code: {code}

{product_url}

Les légendes Instagram sont raccourcies à 2200 caractères si nécessaire. Les légendes X sont raccourcies à 280 caractères si nécessaire.

Publication sociale

Weekly Flash Sale peut publier via ces modules compagnons lorsqu’ils sont installés, actifs et exposent la méthode de publication attendue :

mprinstagramintegration       -> publishToInstagram(imageUrl, caption)
mprfacebookpostsintegration   -> publishToFacebook(caption, imageUrl)
mprxintegration               -> publishToX(caption, imageUrl)

Si un module social n’est pas installé, n’est pas actif, ne dispose pas de méthode de publication ou si la légende est vide, la plateforme est marquée comme ignorée. Le code de vente est tout de même créé.

Le module utilise l’URL de l’image de couverture du produit sélectionné pour la publication :

/img/p/{image-path}/{id_image}.jpg

Il ne génère pas de mise en page promotionnelle personnalisée.

Weekly Sale, Sale history results

Configuration du cron

Weekly Flash Sale utilise le système cron partagé MPR. Le module affiche le vrai token cron dans le panneau de configuration du Back Office.

Format cron serveur recommandé :

* * * * * php /var/www/html/modules/mprweeklysale/cron.php --token=YOUR_TOKEN

Format cron HTTP :

curl "https://yourshop.com/modules/mprweeklysale/cron.php?token=YOUR_TOKEN"

Paramètres CLI optionnels pris en charge par le point d’entrée cron :

--token=YOUR_TOKEN
--max-tasks=20
--max-seconds=55
--context=cron

Les paramètres HTTP sont également pris en charge :

token=YOUR_TOKEN
max_tasks=20
max_seconds=55
context=cron

Le token cron est partagé entre les modules MPR compatibles cron et stocké dans la table de configuration MPR. Régénérer le token rend les URL cron existantes invalides.

Weekly Sale, Admin cart rule detail

Règle panier créée par le module

Chaque exécution réelle de vente crée une règle panier PrestaShop pour le produit sélectionné. La règle est limitée au produit et n’est valable que pendant la durée configurée.

Comportement principal de la règle panier :

reduction_percent = your configured discount
reduction_product = selected product ID
product_restriction = 1
quantity = 1000
quantity_per_user = 1
highlight = 1
active = 1

Le nom de la règle panier utilise ce modèle :

Flash Sale: {discount}% OFF {product_name}

La description de la règle panier utilise ce modèle :

Weekly Flash Sale: {product_name}, {discount}% OFF
Weekly Sale, Admin cart rules

Tests avant lancement

Utilisez Dry Run avant votre première campagne en ligne. Le dry run sélectionne le produit et montre ce qui serait créé, mais il ne crée pas la règle panier et ne publie rien sur les réseaux sociaux.

La sortie du dry run inclut :

Product name
Discount percentage
Generated code
Original price
Sale price

Utilisez Run Now lorsque vous voulez créer immédiatement une vraie vente depuis le Back Office.

Weekly Sale, Admin config

Historique des ventes

Le tableau d’historique du Back Office affiche les exécutions de vente les plus récentes, notamment :

Date
Product
Discount
Code
Original price -> sale price
Instagram result
Facebook result
X result

Les valeurs de résultat social peuvent inclure :

ok:{platform_result}
skipped
dry-run
FAIL
FAIL:{error_message}

Les erreurs de publication sont également écrites dans le journal PrestaShop.

Weekly Sale, Admin config social

Conseils

  • Utilisez un préfixe de code court, facile à lire et à saisir pour vos clients, comme FLASH, WEEKLY ou TODAY.
  • Gardez la légende X suffisamment courte après le remplacement des variables, surtout lorsque les noms de produits sont longs.
  • Réglez la protection contre les répétitions assez haut pour éviter de promouvoir trop souvent le même produit.
  • Lancez un dry run après avoir modifié la réduction, la durée, les légendes ou l’heure de vente.
  • Assurez-vous que les produits disposent d’images de couverture si vous souhaitez de meilleurs posts sociaux.
  • Si vous utilisez la publication sociale, vérifiez que les modules d’intégration Instagram, Facebook Posts et X sont configurés avant l’heure de vente planifiée.
Weekly Sale, Admin dry run

Questions fréquentes

Le module modifie-t-il les prix des produits dans le catalogue ?

Non. Il crée un code de réduction PrestaShop sous forme de règle panier, limité au produit sélectionné. Le prix de base du produit n’est pas modifié.

Puis-je choisir des produits ou des catégories spécifiques ?

Le module actuel sélectionne un produit actif au hasard dans la boutique actuelle et exclut les produits récemment utilisés selon le réglage de protection contre les répétitions. Il ne propose pas de filtres par catégorie, stock, prix ou sélection manuelle de produits.

Puis-je prévisualiser une vente avant sa mise en ligne ?

Oui. Utilisez Dry Run. Il affiche le produit sélectionné, la réduction, le code généré, le prix d’origine et le prix remisé, sans créer de règle panier ni publier de posts.

Weekly Sale, Admin history
Retour en haut