Brevo – Elhagyott Kosár
Modul

✨ Funkciók

A modul az alábbi fő funkciókat biztosítja:

📋 Követelmények

A modul telepítéséhez és működéséhez az alábbi környezet szükséges:

⚙️ Hogyan működik

A rendszer három cron script és egy recovery link kezelő segítségével valósítja meg az elhagyott kosár funkciót:

Adatbázis táblák

A telepítés során két tábla jön létre automatikusan:

Cron scriptek áttekintése

1 Előkészítés Brevóban

A. Két lista létrehozása

Brevo → Contacts → Lists → New list

B. Contact attribútumok létrehozása

Brevo → Contacts → Contact attributes → New attribute

Hozd létre az alábbi 3 attribútumot, mind TEXT típusú:

2 Fájlok feltöltése

Töltsd fel az összes fájlt FTP/SFTP-vel a webshop gyökérkönyvtárába. A ZIP struktúrája megfelel a szerver struktúrájának (1:1 másolás).

admin/
  controller/extension/module/brevo.php
  model/extension/module/brevo.php
  view/template/extension/module/brevo.twig
  language/hu-hu/extension/module/brevo.php
  language/en-gb/extension/module/brevo.php
catalog/
  controller/extension/module/brevo_recover.php
system/
  cron/brevo_abandoned.php
  cron/brevo_completed.php
  cron/brevo_sync_contacts.php
  cron/.htaccess

3 Telepítés az OpenCart adminban

• 1
  Lépj be az admin felületre
• 2
  Navigálj: Extensions → Extensions → Modules
• 3
  Keresd meg: Brevo – Elhagyott Kosár a listában
• 4
  Kattints az Install gombra (zöld + ikon)
  Ez automatikusan létrehozza az oc_brevo_sent és oc_brevo_contacts táblákat az adatbázisban.
• 5
  Kattints az Edit gombra (ceruza ikon) a beállítások megnyitásához

4 Beállítások megadása az adminban

Általános beállítások

Duplikáció szűrés

Vevők szinkronizálása

Recovery titkos kulcs generálása

php -r "echo bin2hex(random_bytes(16));"

Az eredményt illeszd be a mezőbe. Ezt titkosan kezeld – ha megváltoztatod, az összes korábban kiküldött recovery link érvénytelenné válik.

5 Brevo Automation létrehozása

Brevo → Automations → Create an automation → Create from scratch

Trigger (Triggers fül)

Húzd a canvasra: Contact added to list → válaszd ki az Elhagyott Kosár listát.

Lépések (Actions fül)

Contact added to list: Elhagyott Kosár
        ↓
Send email  ← 1. emlékeztető levél (azonnali)
        ↓
Time delay: 23 óra
        ↓
Send email  ← 2. emlékeztető
        ↓
Time delay: 2 nap
        ↓
Send email  ← 3. emlékeztető (esetleg kuponnal)
        ↓
Remove from list: Elhagyott Kosár  ← lista tisztítás

Exit condition (Rules fül)

Contact removed from list → Elhagyott Kosár lista

6 Email sablon változók

Az email sablonban az alábbi Brevo contact attribútumok érhetők el:

Visszatérés gomb sablonban

<a href="{{ contact.CART_RECOVERY_URL }}"
   style="display:inline-block; background:#e74c3c; color:#fff;
          padding:12px 28px; text-decoration:none; border-radius:4px;
          font-size:15px;">
  Folytatom a vásárlást →
</a>

Termékek táblázat sablonban

<table style="width:100%; border-collapse:collapse;">
  <tr style="background:#f5f5f5;">
    <th style="padding:6px;"></th>
    <th style="padding:6px; text-align:left;">Termék</th>
    <th style="padding:6px;">Mennyiség</th>
    <th style="padding:6px;">Ár</th>
  </tr>
  {{ contact.CART_ITEMS_HTML }}
</table>
<p><strong>Összesen: {{ contact.CART_TOTAL }}</strong></p>

Termék HTML sablon változói (admin beállítás)

Az admin felületen a Termék HTML sablon mezőben az alábbi változók használhatók (minden termékre ismétlődik):

7 Cron beállítása

Az admin felület Cron szekciójában láthatod a pontos fájlútvonalakat a szerveredhez igazítva.

SSH-n futtasd: crontab -e

# Elhagyott kosár – óránként
0 * * * * php /home/user/public_html/system/cron/brevo_abandoned.php >> /home/user/logs/brevo_abandoned.log 2>&1

# Vásárlás befejezve – 30 percenként
*/30 * * * * php /home/user/public_html/system/cron/brevo_completed.php >> /home/user/logs/brevo_completed.log 2>&1

# Vevők szinkronizálása – naponta egyszer hajnali 2-kor
0 2 * * * php /home/user/public_html/system/cron/brevo_sync_contacts.php >> /home/user/logs/brevo_sync.log 2>&1

Kézi tesztelés

php /home/user/public_html/system/cron/brevo_abandoned.php

Elvárt output:

[INFO] 2026-02-10 14:00:01 – Feldolgozandó orderek: 2
[OK]    order_id=1042 → valaki@example.com
[OK]    order_id=1043 → masik@example.com

8 Meglévő vevők szinkronizálása (opcionális)

Ha korábban már szinkronizáltad a vevőket Brevóba, töltsd fel a tracking táblát, hogy a cron ne próbálja újra az összes emailt:

INSERT IGNORE INTO `oc_brevo_contacts` (email, synced_at)
SELECT DISTINCT email, NOW()
FROM `oc_order`
WHERE email != '';

🗑️ Eltávolítás

1. Admin → Extensions → Extensions → Modules → Brevo → Uninstall (piros – gomb)
   Ez automatikusan törli az oc_brevo_sent és oc_brevo_contacts táblákat.
2. Fájlok manuális törlése a szerverről (az összes feltöltött fájl eltávolítása)
3. Cron sorok eltávolítása: crontab -e

🔧 Hibaelhárítás