Kowal_Affiliate - instrucțiuni de instalare și configurare

Acest document descrie modul de instalare, activare și configurare inițială a modulului Kowal_Affiliate pentru Magento 2. Instrucțiunile includ atât cerințele tehnice, cât și pașii practici necesari pentru lansarea programului afiliat în magazin.

1. Cerințe de sistem

Modulul este destinat pentru:

• Magento Open Source / Adobe Commerce 2.4.7+
• PHP 8.2 sau 8.3

În proiectul Magento ar trebui să fie disponibile cel puțin modulele:

• Magento_Store
• Magento_Cms
• Magento_Customer
• Magento_Email
• Magento_Quote
• Magento_Sales
• Magento_SalesRule
• Magento_Backend

2. Metode de instalare

Modulul poate fi implementat standard ca pachet Composer.

2.1. Instalare prin Composer

Modulul este distribuit ca pachet Composer, iar un exemplu de proces arată astfel:

Datele de acces la depozitul Composer, adresa de e-mail a clientului și tokenul de licență, le veți primi prin e-mail după achiziție. Acestea sunt disponibile și în panoul clientului după autentificarea pe kowal.store. Înlocuiți TWOJ_EMAIL_KLIENTA cu adresa de e-mail a contului dumneavoastră și TWOJ_TOKEN cu tokenul primit. Rulați comenzile în directorul rădăcină Magento.

composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-affiliatebin/magento module:enable Kowal_Affiliatebin/magento setup:upgradebin/magento setup:di:compilebin/magento cache:flush

2.3. Mod de producție

Dacă magazinul funcționează în production mode, după instalare merită să rulați și:

bin/magento setup:static-content:deploy

3. Ce creează modulul în timpul instalării

În timpul instalării, modulul:

• creează propriile tabele de bază de date legate de afiliere,
• extinde quote și sales_order cu câmpuri afiliate,
• adaugă atribute de client folosite pentru administrarea afiliatului,
• creează pagina CMS implicită a programului de parteneriat,
• pregătește configurarea sistemului și cron jobs,
• înregistrează șabloane de e-mail și resursele panoului administrativ.

3.1. Pagina CMS implicită

După instalare este creată o pagină exemplu a programului de parteneriat:

identifier: affiliate-programtitle: Affiliate Partnership Program

Pagina are caracter universal și poate fi folosită în producție după o personalizare minoră a conținutului.

Patch-ul este idempotent:

• dacă pagina cu acest identifier există deja, modulul nu o va suprascrie.

4. Unde găsiți configurarea modulului

Panoul de configurare se află în:

Stores -> Configuration -> Affiliate Program

Cele mai importante secțiuni:

• General
• Commission
• Payouts
• Affiliate Portal
• Notifications
• Fraud
• AI
• Reporting

5. Prima configurare după instalare

După activarea modulului, se recomandă următoarea ordine de configurare:

1. activați modulul global,
2. setați înregistrarea afiliaților,
3. configurați comisionul și hold period,
4. setați pragul minim de plată,
5. completați conținutul portalului afiliatului,
6. configurați notificările administratorului,
7. opțional configurați AI,
8. efectuați un test de înregistrare, click afiliat și comandă.

6. Configurare detaliată

6.1. General

Enable Module

Comutatorul global al modulului.

Dacă setarea este dezactivată:

• trackingul afiliat nu ar trebui să funcționeze,
• formularul de înregistrare nu ar trebui să funcționeze,
• comisioanele și payouturile nu vor fi gestionate.

Recomandare:

• Yes în mediul de producție după finalizarea testelor,
• No doar pe durata dezactivării programului.

Enable Affiliate Registration

Activează formularul de înscriere în programul afiliat pe frontendul magazinului.

Dacă opțiunea este dezactivată:

• partenerii noi nu se vor putea înregistra singuri,
• administratorul poate în continuare marca manual clientul ca afiliat.

Tracking Cookie Lifetime (days)

Definește durata de viață a atribuirii bazate pe cookie după clickul pe linkul afiliat.

Exemple:

• 30 pentru un program afiliat standard,
• 7 pentru campanii scurte,
• 60 sau 90 doar atunci când regulamentul programului prevede acest lucru.

Default Redirect Path

Calea de rezervă folosită atunci când tracking linkul nu conține un target valid.

Exemple:

• /
• promotions
• catalog/category/view/id/12

6.2. Commission

Enable Commissions

Activează calcularea comisioanelor pentru comenzile afiliate.

Dacă acest câmp este dezactivat:

• afilierea poate fi salvată,
• dar înregistrarea din tabelul de comisioane nu va fi creată.

Default Commission Rate (%)

Rata implicită a comisionului procentual.

Exemplu:

• 10 înseamnă comision de 10% din baza curentă de calcul.

Commission Hold Period (days)

Numărul de zile în care comisionul rămâne în status de așteptare.

După expirarea acestei perioade, cron poate aproba automat comisionul.

Recomandare:

• 14 ca valoare implicită sigură,
• 0 doar pentru un program foarte simplu, fără risc de retururi.

13. Rezumat

După instalarea și configurarea corectă, Kowal_Affiliate permite lansarea în Magento 2 a unui program complet de parteneriat care include:

• afiliați,
• linkuri de recomandare,
• coduri afiliate,
• cupoane de reducere pentru afiliați,
• comisioane,
• payouturi,
• notificări,
• dashboard pentru partener,
• securitate de bază și automatizare.