🔷

Magento 2.4+ Kurulum Rehberi

WhatsMod OTP plugin'ini Magento 2.4+ sitenize kurun — 5 dakika içinde WhatsApp üzerinden telefon doğrulaması aktif.

ZIP İndir (v1.0.0)Token Al
Gereksinimler
  • Magento ≥ 2.4.0
  • PHP ≥ 7.4
  • Test edilmiş ≥ 2.4.7
  • WhatsMod hesabı + otp kapsamlı token
  • Aktif + connected WhatsApp hesabı
Bu Plugin Ne Yapar
  • •Kayıt akışında Plugin interceptor ile OTP doğrulama
  • •Stores → Configuration → WhatsMod admin paneli
  • •AJAX "Kod Gönder" endpoint (/whatsmod/ajax/sendotp)
  • •Token şifreli saklanır (EncryptorInterface)
  • •Magento cache tabanlı OTP oturumu

Kurulum Adımları

  1. 1

    API Token Üretin

    app.whatsmod.io üzerinden OTP kapsamlı token oluşturun.
  2. 2

    Modülü Yükleyin — Manuel Yöntem

    ZIP'i app/code/Whatsmod/Otp/ dizinine çıkarın. Yolun doğru olduğundan emin olun:
    cd /var/www/magento
mkdir -p app/code/Whatsmod
unzip whatsmod-otp-magento2.zip -d app/code/Whatsmod/
# Dizin: app/code/Whatsmod/Otp/ (Whatsmod_Otp değil!)
  3. 3

    Composer ile Alternatif (yakında)

    Composer paketi henüz Packagist'te yok. Şu an için manuel yöntem kullanın. Composer paketi çıktığında şu komutla yükleyebilirsiniz:
    composer require whatsmod/module-otp
  4. 4

    Modülü Etkinleştirin ve Deploy Edin

    Magento root dizinindeyken:
    php bin/magento module:enable Whatsmod_Otp
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy tr_TR en_US
php bin/magento cache:flush
    Production modunda setup:static-content:deploy zorunlu. Developer modunda değilse devre dışı bırakıp: php bin/magento deploy:mode:set developer ile geçiş yapabilirsiniz (önerilmez, test için).
  5. 5

    Admin Paneli Üzerinden Yapılandır

    Admin panel → Stores → Configuration → WhatsMod → OTP.

    Ayarlar:
    • Kayıt Formunda OTP İste: Evet
    • API URL: https://gw.whatsmod.io
    • API Token: wsk_... (token şifreli saklanır — her Save'de yeniden girmenize gerek yok, boş bırakılırsa mevcut korunur)
    • Site Etiketi: mağaza adı (boş ise config\'den alınır)
    • Kod Uzunluğu: 6 (default)

    Save Config + System Cache Flush.
  6. 6

    Frontend Cache Temizle

    Cache'leri temizle:
    php bin/magento cache:clean config block_html full_page
php bin/magento cache:flush
  7. 7

    Test — Register Sayfası

    Mağazanızın kayıt sayfasına gidin: https://mağazanız.com/customer/account/create

    Standart alanların altında "WhatsApp Doğrulama" fieldset'i görünmeli.
    1. Numara gir → Kod Gönder
    2. WhatsApp'a düşen kodu gir
    3. Create Account — kayıt doğrulandıktan sonra tamamlanır

Sorun Giderme

?module:enable'da "module does not exist"
Dizin yapısı yanlış. Doğru yapı: app/code/Whatsmod/Otp/registration.php.Whatsmod_Otp değil — vendor Whatsmod, modül Otp. Dosyaları manuel hareket ettirin.
?Register sayfasında WhatsApp fieldset görünmüyor
setup:static-content:deploy çalıştırmadan production modunda layout yüklenmez. Alternatif: deploy:mode:set developer ile developer moda geçip test edin, sonra production moda dönüp static-content:deploy atın.
?AJAX 404 (/whatsmod/ajax/sendotp)
Route cache'lenmiş. php bin/magento cache:clean config + cache:flush. Sonra browser hard refresh.
?CSRF hatası alıyorum
Template window.FORM_KEY kullanır — Magento layout'u form_key generate eder, standart akış. Özel bir CSP header'ınız varsa JSON POST engellenebilir; nginx/Apache header yapılandırmanızı kontrol edin.
?Token encryption key değişti, token bozuldu
Magento'nun encryption key değiştiyse (app/etc/env.php →crypt.key) tüm şifreli alanlar okunamaz olur. Admin panelden token'ı yeniden girip Save Config yapın.

Sorun mu yaşıyorsunuz?

API dokümantasyonuna göz atın veya destek ekibimizle iletişime geçin.

API DokümanlarıDestek