Dört katman aracılığıyla çalışarak Horizon'un başlığını ve menülerini, hiçbir satıcı dosyasına dokunmadan yeniden şekillendirebilirsiniz: Tema Ayarları, editördeki Özel CSS alanları, başlık bölüm grubunu hedefleyen uygulama gömme blokları ve JSON şablonlarınızda başlığın yerini alan paralel özel bölüm. Doğru yapıldığında, her değişiklik bir Shopify tarafından iletilen tema güncellemesinden sağ çıkar. Yanlış yapıldığında, birkaç haftada bir yama düzeltmelerini manuel olarak yeniden uygulamak zorunda kalırsınız.
Temel Çıkarımlar
- Horizon'un başlığı
--header-backgroundve--menu-top-level-font-size-desktopgibi CSS özel özelliklerini açığa çıkarır; herhangi bir dosyayı düzenlemeden bu özellikleri geçersiz kılabilirsiniz. - Başlık bölümünün tema editöründeki yerleşik "Özel CSS" alanı o bölüme kapsamlıdır ve güncellemelerden sağ çıkar.
- Uygulama gömme blokları
sectionGroup:headeryüzeyini hedefleyebilir; duyuru barları veya navigasyon pencerelerini dosya düzenleme olmadan enjekte etmenize izin verir. - Yapısal HTML değişikliklerine ihtiyaç duyduğunuzda (ek menü, sekmeler, mega-menü),
custom.header.liquidbölümü oluşturun ve satıcıheader.liquid'i değiştirmek yerine JSON şablonlarında yerini alın. - 1 Ekim 2026'dan beri uygulamalar artık storefront script etiketleri oluşturamaz veya güncelleyemez; script enjeksiyonu kullanan her navigasyon penceresi artık tema uygulama uzantılarını kullanmalıdır.
Horizon'un bunu Dawn'dan neden daha zor ve aynı zamanda daha kolay hale getirdiği
Horizon, Shopify Editions Yaz '25'te on ücretsiz tema ailesi olarak piyasaya sürüldü. Web Bileşenleri yerine sunucu tarafında işlenmiş düz Liquid üzerinde çalışır ve sekiz seviyeye kadar iç içe geçebilen yeniden kullanılabilir tema blokları dolu bir blocks/ dizini ile birlikte gelir. Bu mimarı, tüccarlar için gerçekten daha güçlü olsa da, geliştiriciler için belirli bir sorun yaratır: başlık davranışının çoğu özel elemanların içinde yaşar (<header-component>, <header-drawer>) ve bunların iç DOM'i kısmen izole edilmiştir. <select>'i bir varyant için sorgulamak ve change dinlemek için kullanılan eski düzen aynı şekilde çalışmaz ve aynı mantık olay tabanlı menü betikleri için de geçerlidir.
İyi haber, Horizon'un yazarları tüm görsel jetonlar için CSS özel özelliklerine yoğun bir şekilde yöneldi. Bu sizin ilk aracınız ve sıfır dosya düzenleme maliyeti vardır.
Katman 1: Tema Ayarları > Özel CSS aracılığıyla CSS özel özelikleri
Tema editörünü açın, dişli simgesine tıklayın (Tema Ayarları), Özel CSS'ye kaydırın ve kuralları buraya bırakın. Bu alan, Shopify tarafından enjekte edilen satır içi <style> bloğuna yazar; bu hiçbir satıcı dosyasının parçası değil, bu nedenle güncelleme sırasında üzerine yazılmaz.
Başlık için kullanışlı özellikler:
/* Üst düzey nav öğelerini daha büyük ve her zaman beyaz yapın */
overflow-list {
--menu-top-level-font-size-desktop: 1.25rem; /* varsayılan 1.125rem olarak gemi */
--menu-top-level-font-size: 1rem;
}
/* Katı bir arka plan zorlayın, kaydırma saydamlığı efektini kaldırın */
header-component#header-component {
--header-background: #ffffff;
}
/* Alt menü hover solmasını kaldırın */
header-component#header-component
.header__underlay.header__underlay-closed {
background: transparent !important;
}
Font-family jetonları satıcı dosyalarında snippets/theme-styles-variables.liquid içinde yaşar. Bu dosyayı açmadan onları geçersiz kılabilirsiniz:
body {
--font-heading-family: 'YourFont', sans-serif;
}
.header__menu-item,
.menu-drawer__menu-item {
font-family: var(--font-heading-family);
}
Geçersiz kılmaya yalnızca bir bölüme kapsamlı ihtiyaç duyarsanız, Tema Ayarları yerine Başlık bölüm panelinde bölüm düzeyinde "Özel CSS" alanını kullanın. Bu kapsam daha dar ve diğer bileşenlere sızmış olması daha az olasıdır.
Katman 2: Başlık yüzeyini hedefleyen uygulama gömme blokları
Bu, üçüncü taraf navigasyon pencerelerini, duyuru barlarını veya başlık yakınına güven rozetleri eklemek için doğru yoldur. 1 Ekim 2026 itibariyle, storefront script etiketleri kullanımdan kaldırıldı; Shopify bunları 1 Mart 2027'de çalıştırmayı durdurur. Daha önce başlık DOM'e işaret eden bir script etiketi aracılığıyla kendisini enjekte eden her şey, şimdi bir tema uygulama uzantısı olmalıdır.
Uzantınızın blok şemasında, başlık bölüm grubunu doğrudan hedefleyebilirsiniz:
"target": "sectionGroup:header"
Bu, Shopify'e bloğu editörde Başlık bölümü içinde sunmasını söyler; satıcının her şablon üzerinde manuel olarak yerleştirmesine gerek yoktur. Satıcı bunu bir kez Tema Editörü > Uygulama Gömmelerinin altında etkinleştirir ve global olarak görünür. theme.liquid düzenleme gerekli değildir.
Mega-menü uygulaması için, DOM enjeksiyonu yaklaşımı CSS seçici düzeyinde çalışır: Horizon başlığının en dış sarmalayıcısı .header-section sınıfını taşır; bunu bir Insert After kuralıyla hedefleyebilir, menüyü masaüstünde başlığın altına bırakabilir ve herhangi bir iç Liquid yapısına bağlanmadan.
Katman 3: Paralel özel bölüm aracılığıyla yapısal değişiklikler
Çoğu takımın yanlış yaptığı yer burası. sections/header.liquid açarlar, ikinci bir link_list ayarı ve ikincil menü bloğu eklerler, kaydederler ve devam ederler. Bu, Shopify bir Horizon güncellemesi gönderene kadar çalışır. Horizon bir ücretsiz, Shopify tarafından yönetilen tema olduğu için, güncellemeler sıklıkla gelir ve düzenlemeleriniz güncellemenin üzerine yazmak istediği dosyanın içinde yaşar.
Yükseltmeye karşı güvenli düzen:
sections/header.liquidtamamen dokunulmamış bırakın.sections/custom.header.liquidoluşturun. Gereksinim duyduğunuz satıcı başlığının bölümlerini kopyalayın, sonra yapısal değişikliklerinizi buraya ekleyin.- Her JSON şablonunda (
index.json,collection.json,product.json, vb.),headerbölüm referansınıcustom.headerolarak değiştirin.
Çekmece için ikincil keşif menüsü eklemeye yönelik minimal bir örnek:
{%- comment -%} sections/custom.header.liquid {%- endcomment -%}
{%- assign shop_handle = section.settings.menu -%}
{%- assign explore_handle = section.settings.explore_menu -%}
{%- if linklists[shop_handle] != blank -%}
{# render primary nav #}
{%- endif -%}
{%- if linklists[explore_handle] != blank -%}
{# render secondary panel #}
{%- endif -%}
{% schema %}
{
"name": "Custom Header",
"settings": [
{ "type": "link_list", "id": "menu", "label": "Main menu" },
{ "type": "link_list", "id": "explore_menu", "label": "Explore menu" }
]
}
{% endschema %}
Çekmece JavaScript'i assets/header-drawer.js içinde yaşar; bu özel bir elemanın kayıt yöntemidir. Sekme geçiş mantığınız yalnızca CSS sınıflarını değiştirir ve görünürlüğü değiştirirse, özel bölümünüzün yalnızca tarafından dahil edilen ayrı bir assets/custom-header-drawer.js yazabilir; satıcı JS dosyasını temiz bırakabilirsiniz.
Herhangi bir kod düzenlemesinden önce her zaman temayı çoğaltın. Bu bir klişe değildir: Horizon ücretsiz bir Shopify teması olarak gemi yıklar, yani Horizon otomatik güncellemeler etkinse Shopify canlı temayı güncelleyebilir. Tema ayarlarınızı kontrol edin ve koda taahhüt ettiğiniz anda otomatik güncellemeleri devre dışı bırakın.
Katman 4: Özel blok CSS'sini uygun şekilde kapsamlandırma
Horizon, stilleri kapsamlandırmak için blok kimliklerini kullanır. Oluşturduğunuz her özel blok, tema tarafından desteklenen sekiz iç içe geçme seviyesinde seçici çarpışmalarından kaçınmak için aynı kalıbı izlemelidir:
{%- assign block_id = 'custom-header-' | append: block.id -%}
<div id="{{ block_id }}">
{# block markup #}
</div>
{% style %}
#{{ block_id }} {
/* scoped rules only */
}
{% endstyle %}
Bu, Shopify Magic sizin için bir blok yazdığında Horizon'un kendi AI blok üreteçisinin ürettiğine yansıtır: benzersiz bir kimlik atar ve her seçiciyi önceki ekler. Aynı konvensiyonu izlemek, özel bloklarınızın oluşturulanlarla tutarlı davranması anlamına gelir.
Karşılaştırma: Horizon başlığı özelleştirmesine yönelik yaklaşımlar
| Yaklaşım | Ne düzenlersiniz | Tema güncellemesinden sağ çıkar mı? | İyi olduğu şeyler |
|---|---|---|---|
| Tema Ayarları Özel CSS | Hiçbir şey (satır içi stil) | Evet | Renk, yazı tipi boyutu, boşluk jetonları |
| Bölüm Özel CSS alanı | Hiçbir şey (satır içi stil) | Evet | Kapsamlı başlık stili geçersiz kılmaları |
| Uygulama gömme bloğu | Yalnızca uzantı dosyası | Evet | Üçüncü taraf pencereler, duyuru barları |
| Paralel özel bölüm | Kendi bölüm dosyanız | Evet (satıcı dosyası dokunulmamış) | Ek menüler, yapısal HTML değişiklikleri |
Satıcı header.liquid düzenlemesini doğrudan yapın | Satıcı dosyası | Hayır, her güncellemede manuel yeniden yama gerekir | Başka seçenek yoksa kaçının |
Sonucu Doğrulama
Herhangi bir değişiklikten sonra üç şeyi kontrol edin:
- Tema editörü önizlemesi: Editörde başlık bölümünü açın ve ayarlar paneliniz yine de yüklüyse onaylayın. Bölümün şeması kırılırsa, editör sessizce bölümü bırakır ve satıcı kontroller kaybeder.
- Mobil çekmece: Horizon'un
<header-drawer>ayrı bir özel elemandır. DevTools'u açın, Öğeler sekmesine geçin ve enjekte edilen biçimlendirmeniz doğru gölge sınırının içinde görünüyorsa (veya CSS özel özelikleriyle ana elemanı hedefliyorsanız dışında) onaylayın. - Güncelleme simülasyonu: Aynı Horizon kardeş temasının yeni bir kopyasını yükleyin (Atelier, Pitch, Vessel, vb.) geliştirme mağazanıza. Aynı değişiklikleri uygulayın. Yaklaşımınız yeni bir kopyada iki dakikada çalışırsa, taşınabilir ve güncellemeye karşı güvenlidir. Satıcı dosya satır numaraları aracılığıyla av gerektiriyorsa, güvenli değildir.
Tema blokları ve content_for 'blocks' Horizon bölümlerinde nasıl çalıştığının ayrıntılı bir incelemesi için, bkz. Shopify Horizon Tema Blokları Açıklandı.
Başlık bölüm grubu ve uygulama blok sınırları hakkında bir not
Şubat 2026 itibariyle, tek bir tema uygulama uzantısı önceki 25 sınırından 30 uygulama bloğuna kadar içerebilir. Birden fazla yüzeyde başlık içeriği enjekte eden kurum içi bir uygulama oluşturuyorsanız, bu yükseltilmiş tavan size esneklik verir. sectionGroup:header hedefi, bloklarınızın editörde yerel başlık kontrolleri yanında görünmesi anlamına gelir; bu, satıcıların bunları aradığı yerdir.
Çok sayıda SKU'su ve çok sayıda şablonu olan bir katalog işliyorsanız, JSON şablonu yaklaşımı hızlı geri ödeme yapar: custom.header.liquid bir kez düzenlersiniz ve her yerde yansıtılır; satıcı dosyasında Shopify güncellemesi sessizce navigasyon değişikliklerinizi geri alma riski yoktur. Bu tutarlılık, bir geliştirme iş akışında birden fazla aktif tema arasında güncellemeleri yönettiğinizde geçtiği kadar önemli olabilir.
Bunu şirket içinde yapmak yerine yaptırmak isterseniz, yönettiğim stüdyo Lintel bu tür projeler için Shopify tema geliştirme sunuyor.
Sıkça sorulan sorular
Herhangi bir tema dosyasını düzenlemeden Shopify Horizon başlığını özelleştirebilir miyim?
Evet. Renkler, yazı tipi boyutları ve boşluk gibi görsel değişiklikler için, Tema Ayarları > Özel CSS veya başlık bölümünün kendi Özel CSS alanında CSS özel özelliklerini kullanın. Bu alanların hiçbiri satıcı dosyasının parçası değildir, bu nedenle tema güncellemelerinden sağ çıkarlar. İkinci menü ekleme gibi yapısal değişiklikler için, paralel özel bölüm dosyası oluşturun ve JSON şablonlarınızda ona referans verin; satıcı başlık.liquid dosyasına dokunmadan bırakın.
Horizon başlığı için ne CSS özel özelikleri açığa çıkarır?
Temel olanlar --header-background (arka plan rengi için), --menu-top-level-font-size-desktop (masaüstü nav öğesi boyutu, varsayılan 1.125rem) ve mobil için --menu-top-level-font-size içerir. Bunlar overflow-list ve header-component elemanlarında ayarlanır ve satıcı dosyalarına dokunmadan tema editöründeki herhangi bir Özel CSS alanından geçersiz kılınabilir.
Shopify bir tema güncellemesi iletdiğinde Horizon başlığı özelleştirmelerim bozulur mu?
Yalnızca satıcı dosyalarını doğrudan düzenlediyseniz. Özel CSS alanları, uygulama gömme blokları veya kendi paralel bölüm dosyalarınız aracılığıyla yapılan değişiklikler satıcı kodundan ayrı olarak depolanır ve güncellemeler tarafından üzerine yazılmaz. Satıcı dosyası düzenlemek zorundaysanız, temayı önce çoğaltın ve güncellemelerin ne zaman uygulanacağında kontrol sahibi olmak için tema ayarlarınızda otomatik güncellemeleri devre dışı bırakın.