Acil müdahale gerektiren bir sorununuz mu var?Acil müdahale mi?Acil yardım alın →
RehberMagento 2.4.9 ve Mage-OS üzerinde Hyvä

Magento 2 ve Mage-OS üzerine Hyvä kurulumu

Hyvä, Luma önyüzünün yerine Alpine.js ve Tailwind CSS getirir. Bu rehber önce neyi kontrol etmeniz gerektiğini, Composer ile nasıl kuracağınızı, alt temayı nasıl oluşturacağınızı, neleri test etmeniz gerektiğini ve Türkiye'de ve Avrupa genelinde Hyvä projelerini nasıl yürüttüğümüzü anlatır.

Güncelleme Ekim 2026Okuma süresi 15 dkUyumlu olduğu sürümler Magento 2.4.x ve Mage-OS

Başlamadan önce

Hyvä; RequireJS, Knockout veya jQuery kullanmaz. Önyüz kodunu Luma yöntemiyle ekleyen her eklenti, uyarlanana kadar çalışmaz. Bu yüzden ilk iş kurulum değil, envanter çıkarmaktır.

  • İçinde view/frontend klasörü bulunan tüm etkin eklentileri listeleyin.
  • Her biri için Hyvä sürümü veya uyumluluk eklentisi olup olmadığını kontrol edin.
  • Neleri kendiniz uyarlayacağınızı, neleri kapatabileceğinizi işaretleyin.

Yazılarımız Hyvä geçiş kontrol listesi ve uyumluluk eklentisi olmayan eklentiler bu konuyu ayrıntılı olarak ele alıyor.

Gereksinimler

BileşenGereksinim
Magento2.4.4-p9, 2.4.5-p8, 2.4.6-p7, 2.4.7-p1 veya daha yeni, 2.4.9 dahil
Mage-OS2.4.9 tabanlı Mage-OS 3'te çalışır
Node.jsCSS'i derlediğiniz makinede 20 veya daha yeni
Composer erişimihyva.io hesabınızdan bir Packagist anahtarı
Ödeme sayfasında docs.hyva.io adresini kontrol edin.

Composer ile kurulum

Hyvä paketleri Hyvä'nın kendi Packagist deposundan gelir. hyva.io hesabınızdaki anahtarı ve depo URL'sini ekleyin, ardından temayı require ile ekleyin:

composer config --auth http-basic.hyva-themes.repo.packagist.com token YOUR_KEY
composer config repositories.private-packagist composer https://hyva-themes.repo.packagist.com/YOUR_PROJECT/

composer require hyva-themes/magento2-default-theme
bin/magento setup:upgrade
bin/magento hyva:config:generate

hyva:config:generate komutu, Tailwind derlemesine eklenti şablonlarının nerede olduğunu bildirir. Hyvä uyumlu bir eklenti eklediğinizde veya kaldırdığınızda komutu yeniden çalıştırın.

Alt tema oluşturma

Asla Hyva/default temasını doğrudan düzenlemeyin; güncellemeler yaptığınız değişikliklerin üzerine yazar. Bir alt tema oluşturun:

app/design/frontend/Vendor/hyva/
  registration.php
  theme.xml              # <parent>Hyva/default</parent>
  web/tailwind/          # vendor/hyva-themes/magento2-default-theme/web/tailwind klasöründen kopyalandı
cd app/design/frontend/Vendor/hyva/web/tailwind
npm ci
npm run build

Ardından temayı şu bölümde atayın: Content › Design › Configuration. Yapının ayrıntıları için alt tema rehberimize göz atın.

Hyvä'yı sizin için kuralım mı?Hyvä'yı Magento 2.4.9 veya Mage-OS üzerine kuruyor, eklentilerinizi uyarlıyor ve test listemizden geçen bir mağaza teslim ediyoruz.

Geçişten sonraki ayarlar

  • Hyvä mağaza görünümü için Magento'nun JavaScript paketleme (bundling), birleştirme ve küçültme ayarlarını kapatın; Hyvä bunları kullanmaz.
  • CSS küçültmeyi de kapatın; Tailwind derlemesi zaten küçültülmüş durumdadır.
  • Canlı modda (production) çalıştırın ve satış yaptığınız her dil için statik içeriği yayına alın.
  • Her yayına almadan sonra pub/static/deployed_version.txt dosyasının yalnızca sürüm numarasını içerdiğini ve sonunda satır sonu olmadığını kontrol edin. Satır sonu tema yolunu bozar; sepete ekleme, arama ve sepet çekmecesi birlikte çalışmaz hale gelir.

Canlıya almadan önce test edilecekler

  • Kategori sayfalarından, ürün sayfalarından ve hızlı görünümden sepete ekleme.
  • Giriş, kayıt, parola sıfırlama, iletişim ve bülten formları; reCAPTCHA canlıdaki gibi açıkken. Luma'dan kopyalanan formlarda çoğu zaman şu alan eksiktir: form_key.
  • Her ödeme yöntemiyle ödeme sayfası, ödeme sağlayıcısından geri dönüş dahil.
  • Analitik olayları: sayfa görüntüleme, add_to_cart, begin_checkout ve purchase.
  • Lighthouse ile mobil sayfalar; tarayıcının yanı sıra gerçek bir telefonda da.

Türkiye'de ve Avrupa genelinde Hyvä

MageBooster, Tallinn (Estonya) ve İstanbul'da (Türkiye) ofisleri olan bir Magento ekibidir. Avrupa genelindeki ve Türkiye'deki mağazalarla İngilizce, Almanca ve Türkçe çalışıyoruz. İşi yapan kişilerle doğrudan konuşursunuz: mağazanızı aynı ekip planlar, kurar ve bakımını yapar.

Türkiye

Türk mağazaları için Hyvä, Mage-OS ve Magento kuruyoruz: Türk lirası fiyatlandırma, ürün sayfasında gösterilen taksit seçenekleri, KVKK onay metinleri ve Türkçe mağaza görünümleriyle. Görüşmeler Türkçe; İstanbul ofisimizde ya da online.

Almanya, Avusturya, İsviçre

Almanca mağaza görünümleri, cayma (Widerruf) formları, sözleşme koşulları ve KDV gösterimi; Alman alışverişçilerin beklediği şekilde kurulur. Almanca ve İngilizce çalışıyoruz.

Birleşik Krallık ve Avrupa'nın geri kalanı

Çok dilli ve çok para birimli mağazalar, tek kurulumda birden fazla mağaza görünümü, müşterilerinizin bulunduğu bölgede sunucular. İngilizce çalışıyoruz.

Bir proje nasıl ilerler

Audit

Mağazanızı, eklentilerinizi ve sunucunuzu inceliyor, kurulumun ya da upgrade'in neleri kapsadığını size anlatıyoruz.

Fix

Kurulumu veya upgrade'i önce bir test kopyası üzerinde yapıyor, gereken eklentileri uyarlıyoruz.

Boost

Sunucuyu, önbelleği ve önyüzü ayarlıyor, ardından sonucu sizinle birlikte ölçüyoruz.

Care

Canlıya geçtikten sonra, isterseniz mağazanın yamalarını güncel tutuyor ve izliyoruz.

Çalışmalar uzaktan, ekran paylaşımlı görüşmelerle yürür; her adımda kodunuza ve sunucunuza tam erişiminiz sizde kalır. Çalışma saatlerimiz İstanbul saatiyle pazartesi–cuma 09:00–18:00.

MageBooster Checkout

Pek çok mağaza en çok müşteriyi ödeme sayfasında kaybeder. Kurulumların yanı sıra kendi Hyvä ödeme sayfamızı da geliştirip kuruyoruz: MageBooster Checkout. Magento 2.4.9 ve Mage-OS üzerinde çalışır; uluslararası mağazalar için tek sayfadan adım adım ilerleyen çok adımlı akışa kadar dört farklı düzende gelir.

  • Seçtiğiniz düzene göre adres, kargo ve ödeme tek ekranda ya da adım adım.
  • Ülkenizde beklenen ödeme yöntemleri; Türkiye'deki mağazalar için taksitli ödeme dahil.
  • Hyvä'nın geri kalanı gibi Alpine.js ve Tailwind CSS ile geliştirildi; Luma ödeme sayfasının JavaScript'i olmadan.

Demo mağazamızda deneyebilirsiniz: demo.magebooster.com. Orada gerçek sipariş oluşturulmaz.

MageBooster Checkout ilginizi mi çekti?Demo mağazada sizinle birlikte bir tur atmamızı isteyin ya da bize WhatsApp'tan yazın.

Yardım mı gerekiyor?

Türkiye, Almanya, Birleşik Krallık ve Avrupa genelinde Hyvä kuruyor, eklentileri uyarlıyor ve Hyvä mağazalarının bakımını yapıyoruz.

Hyvä kurulumunuz için destek alınBize mağazanızdan bahsedin. Bir iş günü içinde bir planla dönüş yapıyoruz.
Bu sayfa otomatik çeviri sistemiyle çevrildi. Bir hata mı gördünüz? Bize bildirin, hemen düzeltelim.
MageBooster Kurulum desteği alın Magento 2.4.9, Mage-OS veya Hyvä; sizin sunucunuzda ya da bizimkinde. Bir iş günü içinde bir planla dönüş yapıyoruz.
✓ Sunucu kurulumu ve ayarları✓ Kurulum ve eklentiler✓ Türkiye, Almanya, Birleşik Krallık ve Avrupa

Ücretsiz Site Analizi

Mağaza bilgilerinizi gönderin. Hız, güvenlik ve eklentileri inceleyip 3 iş günü içinde hemen uygulayabileceğiniz üç iyileştirme önerisiyle size dönelim.

Konuşalım

Teklif alın

Mağazanızdan bahsedin, bir iş günü içinde size dönelim. Sohbet etmeyi mi tercih edersiniz? WhatsApp'tan yazın

MageBooster UnoPim demosu talep edin UnoPim’i sizinkine benzer ürünlerle canlı görün. Yeni bir PIM ya da Akeneo’dan geçiş: plan, zaman çizelgesi ve teklifle dönüyoruz.
✓ Resmi UnoPim partneri✓ Ekibiniz için yapay zeka asistanı✓ Magento’ya bağlı
MageBooster Hyvä projenizi başlatın Sıfırdan ya da mevcut mağazanızdan. Proje planı, zaman çizelgesi ve teklifle dönüyoruz.
✓ Tasarım ve kurgu bizden✓ Hyvä’ya optimize sunucu✓ Bonus modüller dahil
Partnerimiz olun