AthlexShopify Online Store 2.0

Athlex · Dokümantasyon

Athlex Tema Dokümantasyonu

Athlex, sadecode tarafından geliştirilen bir Shopify Online Store 2.0 temasıdır. Sporcu besinleri, takviye ürünleri, fitness ve aktif yaşam markaları için tasarlanmıştır. Bu kılavuz, temayı nasıl yükleyeceğinizi, kuracağınızı ve özelleştireceğinizi açıklar.

  • Sürüm1.0.0
  • PlatformShopify Online Store 2.0
  • Bölümler14 konu

Başlarken

Temayı yükleme

  1. Shopify yönetici panelinizde Online Store > Themes bölümüne gidin.
  2. Shopify Tema Mağazası'nda Athlex'i bulun ve Try theme veya Add theme düğmesine tıklayın.
  3. Tema, tema kitaplığınıza eklenir. Düzenlemeye başlamak için Customize'a tıklayın.
  4. Hazır olduğunuzda Publish'e tıklayın.

Önerilen kurulum sırası

  1. Logonuzu yükleyin, renklerinizi ve yazı tiplerinizi seçin (Theme settings).
  2. Menülerinizi Online Store > Navigation bölümünde oluşturun (yeni yönetici panelinde Content > Menus) ve bunları Header (üst bilgi) ile Footer (alt bilgi) bölümlerinde atayın.
  3. Ana sayfanızı aşağıda açıklanan bölümlerle oluşturun.
  4. Bir ürün sayfası düzeni seçin ve ihtiyacınız olan ürün bloklarını ekleyin.
  5. Koleksiyon sayfalarını, sepeti ve iletişim sayfanızı ayarlayın.

Tema ayarları

Tema düzenleyicisini açın ve Theme settings (dişli) simgesine tıklayın.

Logo ve favicon

AyarAçıklama
LogoSVG veya PNG dosyası yükleyin. Boş bırakılırsa mağaza adınız metin olarak gösterilir.
Logo widthÜst bilgideki logo genişliğini belirler.
FaviconKare görsel; 32 × 32 px boyutuna ölçeklenir.

Renkler

AyarAçıklama
Accent colorDüğmeler, rozetler ve vurgular için kullanılan ana vurgu rengi.
Text on accent colorVurgu renginin üzerindeki metin rengi. Kontrastı yüksek tutun.
Accent color 2İkincil vurgu rengi.
Text on accent color 2İkinci vurgu renginin üzerindeki metin rengi.
Theme bar colorMobil cihazlarda tarayıcı araç çubuğunun rengi.
Color schemesArka plan, metin ve düğme renkleri. Her bölüm herhangi bir renk şemasını kullanabilir.

Tipografi

Athlex, Shopify yazı tipi kitaplığındaki yazı tiplerini kullanır; bu nedenle ek bir şey yüklemeniz gerekmez.

AyarKullanım alanı
HeadingsSayfa ve bölüm başlıkları ile fiyatlar.
Navigation, buttons and labelsBüyük harfli menüler, düğmeler, rozetler ve küçük etiketler. Kalın (bold) ağırlıkları olan bir yazı tipi seçin.
BodyParagraflar ve form alanları.

Düzen

  • Page width: İçerik alanının en fazla genişliği.
  • Animations enabled: Kaydırmayla beliren öğeleri ve hareket efektlerini açar veya kapatır. Cihazında "hareketi azalt" seçeneği etkin olan ziyaretçiler için hareket her zaman azaltılır.

Ürün kartları

  • Show vendor: Ürün kartlarında satıcı adını gösterir.
  • Show quick add: Ürün kartlarına hızlı sepete ekle düğmesi ekler.

Sepet

  • Cart type: Drawer (yandan açılan sepet paneli) veya Page (sepet sayfasını açar).
  • Free shipping threshold: Sepette ücretsiz kargo ilerleme çubuğu gösterir. Tutarı mağazanızın para biriminde girin. Gizlemek için 0 yazın. Müşteri farklı bir para birimiyle alışveriş yaptığında çubuk otomatik olarak gizlenir.

Sosyal medya

Instagram, Facebook, TikTok, YouTube, X (Twitter) ve Pinterest bağlantılarınızı ekleyin. Simgeler alt bilgide görünür.

Üst bilgi ve alt bilgi

Üst bilgi

AyarAçıklama
MenuAna gezinme menüsü. Açılır menüleri destekler.
Customer account menuHesap açılır penceresinde gösterilen menü (örneğin Siparişler ve Profil).
Mega collectionMega menünün içinde öne çıkarılan koleksiyon.
Show searchArama simgesini ve tam ekran tahmine dayalı aramayı gösterir.
Phone, Email, AddressMobil menüde gösterilen iletişim bilgileri.

Badge blokları, bir menü öğesinin yanına küçük bir etiket (örneğin "Yeni" veya "İndirim") ekler. Menü bağlantısının başlığını birebir aynı şekilde, bir etiket ve bir renkle birlikte girin.

Müşteri hesapları: Hesap simgesi, Shopify'ın müşteri hesabı bileşenini kullanır. Müşteri hesaplarını Settings > Customer accounts bölümünden etkinleştirin.

Alt bilgi

Alt bilgi şu blokları destekler:

  • Brand: Logo, kısa metin ve sosyal medya simgeleri.
  • Menu: Bir menüdeki bağlantıların listesi.
  • Contact: İletişim bilgileri.

Alt bilginin en altındaki büyük, dış çizgili mağaza adı otomatik olarak mağazanızın adını kullanır.

Ana sayfa bölümleri

Bu bölümlerden herhangi birini eklemek için tema düzenleyicisinde Add section'a tıklayın. Bölümleri istediğiniz zaman yeniden sıralayabilir ve gizleyebilirsiniz.

BölümNe işe yarar
HeroVideo veya görsel, başlık, vurgulu başlık, giriş metni, iki düğme ve isteğe bağlı kayan yazı (ticker) içeren tam genişlikte banner. Video eklerseniz bir görsel de ekleyin: Görsel, video yüklenirken gösterilir ve ziyaretçinin cihazında hareketi azaltma veya veri tasarrufu açık olduğunda videonun yerine kullanılır. Erişilebilirlik için otomatik olarak bir duraklatma düğmesi eklenir.
SlideshowHer slayt için ayrı masaüstü ve mobil görselleri, metni ve iki düğmesi olan görsel slaytlar. Otomatik geçişi ve kayan yazıyı destekler. Görselin odak noktasını kullanır; bunu Image position override ayarıyla geçersiz kılabilirsiniz (örneğin 30% 50%).
StatementGörseller ve ürün görselleriyle harmanlanmış büyük, tipografik bir ifade. Text, Image, Product ve Break bloklarıyla oluşturulur. Metin blokları normal, altı çizili veya vurgulu olabilir. Sayfadaki ilk bölüm olduğunda Layout ayarını Hero olarak belirleyin.
Trust barKısa avantajlardan oluşan bir satır (örneğin ücretsiz kargo ve güvenli ödeme).
Collection tilesKoleksiyonlara bağlantı veren büyük kutucuklar.
Collection rowsHer biri ürün küçük resimleri ve ürün sayısı içeren numaralı bir koleksiyon listesi.
Featured collectionTek bir koleksiyondan, isteğe bağlı filtre çipleriyle bir ürün ızgarası.
Featured productTek bir ürünü ürün sayfasındaki bloklarla gösterir; böylece müşteriler doğrudan ana sayfadan satın alabilir.
Product finderMüşterilerin hedeflerine göre ürün seçmesine yardımcı olur. Her Goal bloğu bir ürüne veya etikete bağlanır ve çipler gösterebilir.
Brand valuesSimgeli kısa değer ifadeleri.
How to useNumaralı adımlar.
TestimonialsMüşteri yorumları.
Blog postsBir blogdaki en son yazılar.
FAQAçılır kapanır sorular ve yanıtlar.
NewsletterE-posta kayıt formu. İsteğe bağlı arka plan videosu. Aboneler, e-posta pazarlama izniyle birlikte Customers bölümünde görünür.
Product recommendationsGörüntülenen ürünle ilgili ürünler.
Contact formHerhangi bir sayfaya yerleştirebileceğiniz iletişim formu.
Custom LiquidKendi Liquid, HTML veya uygulama kodunuzu ekleyin.

Görsel ve video kullanımı

  • Videoları bölümün Video ayarından yükleyin. Shopify videolarınızı sizin için barındırır ve optimize eder.
  • Bir görselin odak noktasını Content > Files bölümünden veya görsel seçiciden belirleyin. Athlex bu noktayı her ekran boyutunda görünür tutar.
  • Önerilen boyutlar: Hero ve slayt gösterisi görselleri için 2000 px genişlik (mobil slaytlar için 1080 × 1920 px), koleksiyon kutucukları için 1200 px, Statement görselleri için 600 px.

Ürün sayfaları

Düzenler

Product information bölümünde bir düzen seçin:

DüzenEn uygun olduğu durum
DefaultÇoğu ürün. Galeri ve ürün ayrıntıları yan yana.
Stacked galleryÇok sayıda görseli olan ürünler. Tüm medya alt alta dizilir, ayrıntılar ise sabit (sticky) kalır.
ShowcaseÖne çıkan (hero) ürünler. Görselin arkasında renkli bir sahne ve büyük bir başlık.

Athlex; product, product.stacked, product.showcase ve product.gift-card şablonlarını içerir. Birini kullanmak için yönetici panelinde ilgili ürüne gidin ve bir Theme template seçin.

Ürün blokları

Bu blokları ekleyebilir, kaldırabilir ve yeniden sıralayabilirsiniz:

  • Vendor and type (satıcı ve ürün türü)
  • Title (başlık)
  • Price: İndirimli fiyatları ve birim fiyatları, ayrıca vergi veya kargo notlarını gösterir.
  • Highlights: Kısa, önemli bilgiler (örneğin "25 g | Protein"). Meta alanlar bölümüne bakın.
  • Description (açıklama)
  • Text (metin)
  • Variant picker: Düğmeler, açılır listeler veya renk/desen örnekleri (swatch). Ürünün seçenek değerlerinde swatch verisi tanımlandığında renk ve aroma seçenekleri swatch olarak gösterilir.
  • Quantity selector (adet seçici)
  • Buy buttons: Sepete ekle ve dinamik ödeme düğmeleri. Hediye kartı ürünlerinde otomatik olarak alıcı formu gösterilir.
  • Trust badges (güven rozetleri)
  • Pickup availability: Mağazanızda etkinse mağazadan teslim alma uygunluğunu gösterir.
  • Collapsible tab: İçerikler, besin değerleri, kargo ve iade gibi ayrıntılar için.
  • Share (paylaş)
  • Custom Liquid
  • Apps: Yorum veya abonelik gibi yüklü uygulamalardan gelen uygulama blokları.

Diğer ürün özellikleri

  • Sabit sepete ekle çubuğu: Show sticky add to cart bar ayarıyla etkinleştirin.
  • Medya: Görseller, videolar, harici videolar ve 3D modeller (desteklenen cihazlarda AR ile).
  • Galeri arka planı: Gallery background ayarını belirleyin veya ürün bazında ayarlamak için custom.stage_color meta alanını kullanın.

Hediye kartları

Hediye kartı ürünleri için product.gift-card şablonunu kullanın. Müşteriler hediye kartını bir isim, bir mesaj ve bir teslim tarihiyle başka birine gönderebilir. Hediye kartı e-posta sayfası temanın renklerini kullanır ve bir QR kod gösterir.

Koleksiyon sayfaları

Düzenler

DüzenAçıklama
DefaultBaşlık, açıklama ve isteğe bağlı kayan yazı içeren koyu renkli üst bant.
BannerGörselli üst alan ve yandan açılan filtre paneli.
SplitBaşlık ve filtrelerin yer aldığı sabit (sticky) yan sütun.

collection, collection.banner ve collection.split şablonları temaya dahildir.

Filtreleme ve sıralama

Enable filtering ve Enable sorting ayarlarını açın. Filtreleri Shopify'ın Search & Discovery uygulamasından yönetin.

Tanıtım kutucuğu

Ürün ızgarasının içinde bir banner göstermek için Promo tile bloğu ekleyin. Konumunu Show after product ayarıyla seçin.

Sepet

  • Sepet paneli (Cart drawer): Bir ürün eklendiğinde açılır. Müşteriler adetleri değiştirebilir, ücretsiz kargo çubuğunu görebilir ve ödemeye geçebilir.
  • Sepet sayfası: Sipariş notları içeren tam sepet görünümü. Sepet boşken koleksiyon önermek için Empty cart tile blokları ekleyin.

Diğer sayfalar

SayfaNotlar
AramaTahmine dayalı arama, yazarken ürünleri, koleksiyonları, sayfaları ve blog yazılarını gösterir.
Blog ve blog yazısıÖne çıkan yazı ve yazı listesi. Yazılarda yazar, tarih ve paylaşım bağlantıları; blog için etkinse yorumlar da gösterilir.
İletişim (page.contact)İletişim formu ile telefon, e-posta ve adres için Contact card blokları. Mesajlar mağazanızın gönderici e-posta adresine iletilir.
Koleksiyon listesiTüm koleksiyonlar bir ızgara düzeninde.
404Arama kutusu ve bağlantılar içeren özel bir "sayfa bulunamadı" sayfası.
ŞifreMağazanız şifreyle korunurken gösterilir. Bülten kayıt formu içerir.
Müşteri hesaplarıGiriş, kayıt, hesap, siparişler ve adresler sayfaları temayla uyumlu şekilde tasarlanmıştır. Yeni müşteri hesaplarını kullanıyorsanız bu sayfalar Shopify tarafından barındırılır.

Meta alanlar

Athlex, meta alanlardaki ek ürün bilgilerini gösterebilir. Bunları Settings > Custom data > Products bölümünde oluşturun.

Ad alanı ve anahtarTürKullanım alanı
custom.highlightsÇok satırlı metinÜrünün öne çıkan bilgileri. Her satıra value | label biçiminde bir öğe yazın; örneğin 25 g | Protein. Boş bırakılırsa Highlights bloğu kendi varsayılan öğelerini gösterir.
custom.subtitleTek satırlı metinÜrün kartlarındaki alt başlık. Boş bırakılırsa ürün türü gösterilir.
custom.stage_colorRenkBu ürünün galeri arka plan rengi.
reviews.ratingPuanÜrün kartlarındaki yıldız puanı. Çoğu yorum uygulaması bu alanı otomatik olarak doldurur.

Uygulamalar ve özel kod

  • Uygulama blokları: Çoğu uygulama; ürün sayfasına, Featured product bölümüne veya App embeds alanına (Theme settings > App embeds) yerleştirebileceğiniz bloklar ekler.
  • Custom Liquid: Kendi kodunuzu Custom Liquid bölümüyle veya Custom Liquid ürün bloğuyla ekleyin. Bu ayarlardaki kod, temayı güncellediğinizde yerinde kalır.

Performans ve erişilebilirlik

  • Görseller duyarlıdır (responsive) ve geç yüklenir (lazy load). Sayfadaki ilk görsel yüksek öncelikle yüklenir.
  • Videolar sayfa yüklendikten sonra başlar; veri tasarrufu veya hareketi azaltma açıkken hiç yüklenmez.
  • Yazı tipleri Shopify'ın yazı tipi CDN'inden gelir.
  • Tüm etkileşimli öğeler klavyeyle çalışır ve görünür odak durumlarına sahiptir. Animasyonlar "hareketi azalt" ayarına uyar.

Hızlı bir mağaza için ipuçları:

  • Görselleri gerekenden büyük yüklemeyin (tam genişlikteki görseller için 2000 px genişlik yeterlidir).
  • Hero videolarını kısa (10–20 saniye) ve 5 MB'ın altında tutun.
  • Artık kullanmadığınız uygulamaları kaldırın.

Temayı güncelleme

Yeni bir sürüm yayınlandığında Shopify, Online Store > Themes bölümünde bir güncelleme bildirimi gösterir.

  1. Tema kartında View update düğmesine tıklayın.
  2. Shopify, güncellenmiş temayı kitaplığınıza ekler ve ayarlarınızı ve içeriğinizi korur.
  3. Önizleyin, ardından yayınlayın.

Doğrudan kod dosyalarında yapılan değişiklikler yeni sürüme aktarılmaz.

SSS ve sorun giderme

Logom görünmüyor; onun yerine mağaza adı çıkıyor.

Theme settings > Logo and favicon bölümünden bir logo yükleyin.

Hero videosu oynatılmıyor.

Ziyaretçinin cihazında hareketi azaltma veya veri tasarrufu seçeneğinin açık olmadığını kontrol edin. Bu durumlarda tasarım gereği videonun yerine görsel gösterilir. Bir görselin de tanımlı olduğundan emin olun.

Ücretsiz kargo çubuğu görünmüyor.

Theme settings > Cart bölümünde 0'dan büyük bir eşik değeri girin. Çubuk yalnızca mağazanızın varsayılan para biriminde gösterilir.

Swatch'lar (renk/desen örnekleri) görünmüyor.

Ürün yönetim sayfasında seçenek değerlerine swatch renkleri veya görselleri ekleyin (örneğin Renk veya Aroma seçeneği).

Hesap menüsü hata veriyor.

Online Store > Navigation (yeni yönetici panelinde Content > Menus) bölümünde Customer account menu olarak ayarlanan menüyü oluşturun veya Header ayarlarından başka bir menü seçin.

Filtreler görünmüyor.

Search & Discovery uygulamasını yükleyin ve filtreleri orada ekleyin. Ardından koleksiyon bölümünde Enable filtering ayarını açın.

Hâlâ yardıma mı ihtiyacınız var? Destek ekibiyle iletişime geçin.

Sürüm notları

1.0.0

  • İlk sürüm.