Arama adresi parametreleri ve tahmini arama adresi

Shopify /search sayfasının kabul ettiği tüm parametreler (q, type, options[prefix], options[unavailable_products], sort_by, page) ve /search/suggest.json.

Arama sayfası
/search?q=<terim>&type=product
Tahmini
/search/suggest.json?q=<terim>
Sıralama
relevance, price-ascending, price-descending
Plan
Her plan
Son kontrol

Kısaca

Shopify’ın /search sayfası q ile birlikte isteğe bağlı parametreler alır: type=product,page,article sonuç türlerini sınırlar, options[unavailable_products]=show|hide|last tükenen ürünlerin yerini belirler, options[prefix]=last sayfa ve yazılarda kelime parçasını eşleştirir, sort_by=price-ascending sıralar, page sayfalar. Tahmini arama /search/suggest.json?q=… adresinde, tür başına en fazla 10 sonuçla yanıt verir. Temanızın aramasını değiştirmek için bu parametreleri gizli form alanlarına koyun.

Nasıl kullanılır

  1. Parametreleri doğrudan deneyin: /search?q=snow&type=product&options[unavailable_products]=hide.
  2. Temanın arama formuna type ve istediğiniz seçenekler için gizli alanlar ekleyin; görünür alan olarak yalnızca q gerekir.
  3. Çok dilli mağazalarda dil korunsun diye form action’ı olarak routes.search_url kullanın.
  4. Müşteri yazarken açılan bir liste için /search/suggest.json’ı (HTML için section_id ile /search/suggest’i) çağırın.

Kod

search-form.liquid
{%- comment -%}
  A products-only search form that hides sold-out products.
  routes.search_url keeps the market's language path (/fr/search).
  Only q needs user input; the rest are hidden inputs.
{%- endcomment -%}
<form action="{{ routes.search_url }}" role="search">
  <label for="SearchProducts">Search products</label>
  <input id="SearchProducts" type="search" name="q" value="{{ search.terms | escape }}">
  <input type="hidden" name="type" value="product">
  <input type="hidden" name="options[unavailable_products]" value="hide">
  <button type="submit">Search</button>
</form>
urls.txt
# Search page: /search with q and optional parameters
https://your-store.com/search?q=snow
https://your-store.com/search?q=snow&type=product
https://your-store.com/search?q=snow&type=product,page&options[unavailable_products]=hide&options[prefix]=last
https://your-store.com/search?q=snow&type=product&sort_by=price-ascending
https://your-store.com/search?q=snow&page=2

# Parameters
q                               the search terms (required)
type                            product, page, article (comma-separated; default all)
options[unavailable_products]   show | hide | last (default last)
options[prefix]                 last | none (pages and articles only; products match partial words anyway)
sort_by                         relevance | price-ascending | price-descending
page                            results page, default 1

# Predictive search (JSON), up to 10 results per type
https://your-store.com/search/suggest.json?q=bag&resources[type]=product,collection&resources[limit]=4

# Storefront filters work on search results too
https://your-store.com/search?q=snow&type=product&filter.v.availability=1

Lintel tarafından yazıldı. MIT lisansı: kendi mağazanızda da müşteri işlerinizde de ücretsiz kullanabilirsiniz.

Sınırlar ve özel durumlar

  • Ürünler kelime parçasıyla zaten eşleşir; options[prefix] yalnızca sayfa ve yazı sonuçlarını etkiler.
  • Mağaza araması price:>50 gibi aralık sorgularını desteklemez; bunun yerine fiyat filtrelerini (filter.v.price.gte) kullanın.
  • type ve tükenen ürünler için varsayılanlar Search & Discovery uygulamasının ayarlarından da değiştirilebilir.
  • seo.hidden metafield’ıyla gizlenen ya da Unlisted yapılan ürünler aramada ve tahmini aramada görünmez.

Sık sorulan sorular

Shopify aramasında yalnızca ürünler nasıl gösterilir?
Arama adresine type=product ekleyin ya da arama formuna name="type" value="product" olan gizli bir alan koyun.
Shopify aramasında tükenen ürünler nasıl gizlenir?
options[unavailable_products]=hide ekleyin ya da bunu Search & Discovery uygulamasında varsayılan yapın.
Shopify tahmini arama adresi nedir?
/search/suggest.json?q=<terim>; sonuç türü ve sayısı (1–10) için resources[type] ve resources[limit] kullanılır.
Shopify arama sonuçları fiyata göre sıralanabilir mi?
Evet: sort_by=price-ascending ya da price-descending. Ürün dışı sonuçlar sona taşınır.
  • Gösterilen tarihte bir Shopify mağazasında denendi. Shopify yönetim panelini sık değiştirir; bir adım farklı görünüyorsa fikir genellikle hâlâ geçerlidir.
  • Örneklerde yer tutucu ID’ler ve your-store.myshopify.com kullanılır. Kendi değerlerinizle değiştirin.
  • Kod parçaları MIT lisanslıdır.

Mağazanız için kurulmasını, test edilmesini ve bakımını isterseniz: Shopify geliştirme.

Geliştirmek istediğiniz bir şey mi var? Gelin, birlikte konuşalım.

Aynı anda sınırlı sayıda proje alıyoruz.

Gencer KarakayaShopify mühendisi

Proje özetinizi bir mühendis okur; size e-postayla yanıt veririz.