İçeriğe geç

Geliştirici belgeleri · Theme API v1.0 · v1.1

Eksiksiz bir şirket sitesi şablonunu güvenli bir şekilde oluşturun.

Eyivo temaları sayfa yapıları, tipografi, bileşenler ve stillerden oluşan tamamlanmış bir görsel sistem tanımlar. İşletme sahibi daha sonra blokları taşımadan, kodu düzenlemeden veya tasarımı bozmadan onaylı içeriği uygulamaya ekler.

Temel prensip

Liquid, sitenin nasıl görüneceğini; Eyivo Core ise hangi şirket içeriğinin gösterileceğini belirler.

1. Zihinsel model

Sistemde üç ayrı sorumluluk vardır. Bunları ayırmak v1'i anlamanın anahtarıdır.

Eyivo Core

Şirket ayrıntılarını, sayfaları, medyayı, SEO'yu, gezinmeyi ve yayınlama durumunu saklar. İçerik için gerçeğin kaynağıdır.

Tema paketi

Sabit sayfa şekillerini, izin verilen bölümleri, özel bileşen şemalarını ve CSS'yi tanımlar. Asla verileri sorgulamaz veya uygulama kodunu çalıştırmaz.

Uygulama düzenleyici

Şemadan güvenli formlar oluşturur. Sahipler bir alandaki metni, görselleri, sayfaları ve bölüm sırasını güncelleyebilir.

Sayfa oluşturucu değildir: site sahibi main bölgesine izin verilen bir bölüm ekleyip sayısal konumunu seçebilir. Yeni bir bölge oluşturamaz, hero bölümünü alt bilgiye taşıyamaz veya temanızın dosyalarını değiştiremez. Stil sayfalarınızdan sonra yüklenen kendi site CSS’ini ekleyebilir ve bölümlere sınıf adları verebilir (bkz. Site özel CSS’i).

2. Hızlı başlangıç: asgari işlevsel tema

Her v1 teması yerleşimini, stillerini ve betiklerini bütünüyle kendisi sağlar; tasarımcı bunları istediği gibi düzenleyebilir. Temalar başka bir temanın yerleşimini veya varlığını devralmaz. Ortak eyivo: bileşenleri ve yedi yedek sayfa türü theme-core içinden gelir; tema yalnızca yerine kendi sürümünü koyduğu sayfa türlerini ve theme: ad alanında tanımladığı bileşenleri içerir.

Her v1 temasının varsayılan bir düzen dosyasına ihtiyacı vardır. Paket yalnızca çekirdek geri dönüşleri kullandığında hem page-types/ hem de components/ isteğe bağlıdır:

acme-industrial/
├── theme.json
├── layouts/default.liquid
├── page-types/
│   └── home.liquid        # optional override
├── components/
│   └── featured_course.liquid
├── locales/
│   ├── en.json
│   └── tr.json
├── screenshots/
│   └── home-desktop.png   # demo-data screenshot
└── assets/
    ├── css/theme.css
    └── js/theme.js        # Theme API 1.1, reviewed

layouts/default.liquid her zaman etkin temadan gelir ve HTML belgesinin tamamını tanımlar. Eyivo istenen sayfa türünü önce temada arar, bulamazsa theme-core/page-types içindeki yedeği kullanır. Çekirdek yerleşim veya varlık sağlamaz; bu nedenle yedek sayfa içeriği de etkin temanın paketi ve stilleriyle sunulur.

3. theme.json'daki şablonu açıklayın

Manifest hem yetenekleri bildirir hem de uygulamadaki formların oluşturulacağı sözleşmeyi tanımlar. Üç soruya yanıt verir: hangi sayfa yapıları var, her yapıda hangi bölgeler bulunuyor ve hangi bileşenler saklanabilir? Yerleşik temalar, on standart sayfa türünün tamamını açıkça tanımlar ve bunlara karşılık gelen Liquid dosyalarını içerir. Özel temalar, tanımlanmamış sayfa türleri için çekirdek şablonları kullanmaya devam edebilir.

{
  "name": "Acme Industrial",
  "version": "1.0.0",
  "eyivo_theme_api": "1.0",
  "settings": {
    "primary_color": { "type": "color" },
    "button_radius": { "type": "number" }
  },
  "page_types": {
    "home": {
      "areas": {
        "hero": {
          "allowed_components": ["eyivo:hero"],
          "min": 0,
          "max": 1
        },
        "main": {
          "allowed_components": ["eyivo:rich_text", "eyivo:image_text", "theme:featured_course"]
        }
      }
    },
    "page": { "areas": { "main": { "allowed_components": ["eyivo:rich_text"] } } }
  },
  "components": {
    "featured_course": {
      "variants": ["card", "compact"],
      "schema": {
        "heading": { "type": "text", "required": true, "translatable": true },
        "summary": { "type": "textarea", "translatable": true }
      }
    }
  }
}
AnahtarAnlamÖrnek
keyKendi başvurunuz için isteğe bağlı bir etiket. Eyivo yüklenen her temaya kendi kimliğini verir; bu nedenle anahtar, bir yüklemenin hangi temaya ait olduğunu hiçbir zaman belirlemez.acme-industrial
versionTemanızın değişmez yayın sürümü (anlamsal sürümlendirme).1.2.0
eyivo_theme_apiPaketinizin desteklediği Eyivo genel API sözleşmesi.1.0
areasLiquid sayfa dosyanızın sabit yerlerde oluşturduğu adlandırılmış yuvalar.hero, main, bottom
allowed_componentsEditörün bir alana hangi bileşenleri ekleyebileceği.["eyivo:hero"]
componentsEtkin temanın özel theme: bileşen tanımları. Paylaşılan eyivo: tanımları theme-core'da kalır.featured_course
min/maxBu alandaki bölüm sayısına ilişkin isteğe bağlı sınırlamalar.max: 1

Sayfa türü geri dönüş: Yerleşik türler home, page, gallery, contact, products, product ve videos'dur. theme-core'daki tanımını ve Liquid dosyasını kullanmak için bunlardan herhangi birini çıkarın. Yalnızca tema aynı zamanda eşleşen page-types/<type>.liquid geçersiz kılmayı da sağladığında bir tür bildirin.

Düzenleyici, birleştirilmiş sayfa türü API'sini alır: etkin tema tanımları eşleşen çekirdek tanımlarının yerini alırken, atlanan her tür çekirdekte kullanılabilir durumda kalır.

4. Demo içeriğini demo.json'da tamamlayın

Her yüklemede taşınabilir, salt taslak demo.json fikstürü ve bu fikstür yüklüyken çekilen en az bir ekran görüntüsü bulunmalıdır. Yerleşik temalar aynı şemayı kullanır. Veritabanı kimliklerini, kiracı etki alanlarını, kimlik bilgilerini veya nesne depolama kimlik bilgilerini eklemeyin.

{
  "schema_version": 2,
  "default_locale": "en",
  "label": "Northline Build Co.",
  "summary": "Thoughtful construction for the way life happens.",
  "media": {
    "media/hero.jpg": {
      "public_url": "https://cdn.eyivo.com/demo/hero.jpg",
      "mime_type": "image/jpeg",
      "original_name": "hero.jpg",
      "bytes": 184000,
      "width": 1600,
      "height": 900
    },
    "assets/images/team.jpg": {
      "mime_type": "image/jpeg",
      "original_name": "team.jpg"
    }
  },
  "company": { "display_name": "Northline Build Co.", "logo_asset": "media/hero.jpg" },
  "theme_settings": { "settings": { "header_cta_url": "/contact" } },
  "pages": [],
  "catalog": [],
  "galleries": [],
  "videos": []
}
AnahtarAmaç
mediaTaşınabilir varlık tanımlayıcıları tarafından anahtarlanan genel kaynak URL'leri ve meta veriler. hero_asset, cover_asset, media_asset, galeri öğesi asset, logo_asset ve favicon_asset tanımlayıcısını yeniden kullanın.
companyŞirket profili, sosyal bağlantılar, marka renkleri, isteğe bağlı logo/favicon varlığı ve yerel ayar anahtarlı çeviriler.
theme_settingsİsteğe bağlı yerel ayar anahtarlı çevirilerle başlangıç ​​tema ayarları.
pagesTür, sıralama düzeni, gezinme durumu, SEO, sayfa ayarları, bileşenler ve yerel ayar anahtarlı içerik.
catalogYerel ayar anahtarlı içeriğe ve isteğe bağlı cover_asset'ya sahip katalog girişleri.
galleriesGaleri meta verileri ve resim öğeleri. Her galeri öğesinin bir asset'ya ve boş olmayan bir alt_text'ya ihtiyacı vardır.
videosHarici bir source_url veya media_asset, sunum modu ve yerel ayar anahtarlı içerik.

Her media girdisi ya izin verilen bir sunucuda (Eyivo demo medya sunucusu cdn.eyivo.com veya images.pexels.com) https kullanan bir public_url içermeli ya da temada assets/ altında paketlenmiş, yoluyla anahtarlanmış ve public_url verilmemiş bir dosya olmalıdır. Diğer sunucular, http, IP adresleri, diğer portlar ve yönlendirmeler demo_media_url yükleme tanılamasıyla reddedilir. mime_type, width ve height yalnızca ipucudur: Eyivo gerçek türü indirilen dosyanın içeriğinden belirler; dosya izin verilen bir görsel veya video olmalı ve en fazla 20 MB olmalıdır.

Demo formları taşınabilir form bağlamaları kullanır; Eyivo bunları demoyu içe aktaran her site için ayrı ayrı çözer. İçe aktarılan demo görselleri o sitede sıradan medya başvurularına dönüşür; onları orada kaldırmak paylaşılan orijinali asla kaldırmaz.

Sayfalar ve bileşenler

{
  "type": "home",
  "sort_order": 0,
  "navigation_visible": true,
  "hero_asset": "media/hero.jpg",
  "translations": {
    "en": { "slug": "home", "title": "Home", "meta_title": "Home | Northline" },
    "tr": { "slug": "ana-sayfa", "title": "Ana sayfa", "meta_title": "Ana sayfa | Northline" }
  },
  "components": [{
    "component_type": "eyivo:hero",
    "area": "hero",
    "position": 100,
    "variant": "split",
    "data": { "primary_url": "/contact" },
    "translations": {
      "en": { "heading": "Built for real life", "primary_label": "Contact us" },
      "tr": { "heading": "Gerçek yaşam için tasarlandı", "primary_label": "Bize ulaşın" }
    }
  }]
}

Bileşen türleri ve alanları, etkin tema bildiriminde veya theme-core'da bildirilmelidir. Aynı site bağlantıları için /contact gibi göreli yollar kullanın. Yerleşik ana sayfa demoları mevcut hero görselini okunabilir bir katman ve duyarlı metinle tam genişlikte arka plan olarak kullanır: çoğu temada immersive, Compact temasında ise görselli centered. Diğer hero varyantları kendi düzenlerini korur.

Demo dilleri ve yedek dil

İngilizce zorunlu temel dildir: default_locale değerini en olarak ayarlayın. Eski verilerde bu alanın bulunmaması da İngilizce anlamına gelir. Desteklenen diğer site dilleri isteğe bağlıdır; İngilizce metni başka bir dilin altına kopyalayıp çeviri olarak sunmayın.

Şirket metinleri, tema ayarları, sayfalar, bileşenler, ürünler, galeriler, galeri görsellerinin açıklamaları ve alternatif metinleri, videolar ve blog yazıları için translations.en ve isteğe bağlı dil nesneleri sağlayın. Eski, dil anahtarı olmayan İngilizce alanlar desteklenir. Oluşturma sırasında sitenin ana dili seçilir; eksik her alan için İngilizce kullanılır. Diziler İngilizce dizinin tamamının yerini alır; açıkça boş bırakılan değerler korunur. Yalnızca seçilen site dili içe aktarılır; İngilizce veya diğer diller otomatik etkinleştirilmez.

Site içi bağlantılarda ve taşınabilir menü öğelerinde İngilizce kaynak slug değerlerini kullanın. İçe aktarma, zengin metin ve blog belgelerindeki bağlantılar dahil bunları seçilen çevirinin slug değerine dönüştürür. Menü öğeleri açık slugs ve labels haritaları içerebilir. Eksik etiket çevirileri için İngilizce kullanılır. Harici URL’ler değiştirilmez.

{
  "company": {
    "translations": {
      "en": { "display_name": "Northline", "description": "Built around your needs." },
      "tr": { "display_name": "Northline", "description": "İhtiyaçlarınıza göre tasarlandı." }
    }
  },
  "theme_settings": {
    "settings": { "header_cta_url": "/contact" },
    "translations": {
      "en": { "header_cta_label": "Contact us" },
      "tr": { "header_cta_label": "Bize ulaşın" }
    }
  },
  "menus": {
    "footer": [{ "type": "page", "slug": "contact",
      "slugs": { "en": "contact", "tr": "iletisim" },
      "labels": { "en": "Contact us", "tr": "Bize ulaşın" }
    }]
  }
}

İçe aktarma ve medya güvenliği

Panelde oluşturulan yeni sitelerde demo verileri varsayılan olarak seçilidir ve seçilen dilde hemen yayınlanır; kullanıcı bu seçeneği kapatabilir. Mevcut bir sitede Marka ayarlarından demo yüklemek taslak oluşturur ve yayınlanmış içeriği korur. Merkezi App, görselleri yeni sitenin medya kitaplığına kopyalar ve referansları Dahili API üzerinden iletir. Master sunucular ve temalar nesne depolama kimlik bilgilerini almaz. Temalar sağlanan media.public_url değerini kullanır.

data_source: "demo_data" ile ekran görüntülerini theme.json.preview'da bildirin. Paket, bildirilen her preview görüntüsünü içermelidir.

5. Temanızın ihtiyaç duyduğu düzeni yazın

Varsayılan düzen HTML belgesinin tamamına sahiptir. Etkin temanın dışındaki hiçbir şey başlığını, alt bilgisini, stil dosyasını veya görsel yapısını sağlamaz. Platform yalnızca formlar, insan doğrulaması, onay ve Eyivo rozeti için kendi betiklerini ekler; tema betikleri Theme API 1.1 gerektirir.

<!doctype html>
<html lang="{{ locale.code }}" dir="{{ locale.direction }}">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  {% eyivo_head %}
  <link rel="stylesheet" href="{{ 'css/theme.css' | asset_url }}">
</head>
<body>
  <header class="site-header">
    <a href="{{ locale.home_url }}">{{ company.name }}</a>
    <nav>
      {% for item in navigation.main %}
        <a href="{{ item.url }}">{{ item.label }}</a>
      {% endfor %}
    </nav>
  </header>

  {{ content | raw }}
</body>
</html>

Sayfa türü dosyası dinamik bölgelerin tam olarak nerede görüneceğini belirler. Bölge bileşenleri önceden oluşturulmuş HTML dizeleridir; bu nedenle bunları | raw ile ekleyin. Diğer değerler varsayılan olarak HTML için kaçışlanır.

<main class="home-layout">
  <section class="home-layout__hero">{{ areas.hero | raw }}</section>
  <div class="home-layout__content">{{ areas.main | raw }}</div>
  <aside class="home-layout__footer-cta">{{ areas.bottom | raw }}</aside>
</main>

Bir bileşeni doğrudan işleme

Tasarımcı, kayıtlı bir bileşeni doğrudan bir düzen veya sayfa tipi dosyaya yerleştirebilir. Bu yerleşim temaya göre sabitlenir ve panelde yeniden sıralanmaz veya kaldırılmaz. Bir nesneyi data:'dan, bireysel şema alanlarından veya her ikisinden geçirin; adlandırılmış alanlar data:'daki eşleşen anahtarları geçersiz kılar.

{% eyivo_component "eyivo:cta",
  eyebrow: "Let’s talk",
  heading: page.title,
  text: company.description,
  button_label: "Contact us",
  button_url: routes.contact
%}

{% eyivo_component "theme:featured_course",
  data: page.settings.featured_course,
  variant: "compact"
%}

Tür, tırnak içine alınmış bir ad alanı değişmez değeri olmalıdır. Doğrudan işleme, alan örneği olarak aynı şemayı, varyantları, bileşen dosyasını ve normalleştirilmiş component nesnesini kullanır. Bileşen dosyaları diğer bileşenleri oluşturamaz.

Varlıklar: her zaman {{ 'css/theme.css' | asset_url }} ifadesini kullanın. Eyivo dosyayı etkin paketten /theme-assets/<theme>/css/theme.css adresinde sunar; başka bir tema adını veya dosya sistemi yolunu sabit kodlamayın.

HTML head, yollar ve arayüz sözlükleri

Her yerleşim {% eyivo_head %} etiketini tam olarak bir kez oluşturmalıdır. Eyivo başlık, açıklama, robots, canonical, hreflang, Open Graph ve yapılandırılmış veri çıktısını yönetir. Sabit kodlanmış genel yollar yerine routes.home, routes.contact, routes.catalog, routes.gallery ve routes.videos kullanın. Düzenlenebilir URL ayarlarını | localized_url filtresinden geçirin; böylece bilinen iç yollar etkin dil önekini alırken dış URL'ler değişmeden kalır.

{{ 'Menu' | t }}
{{ theme.settings.header_cta_url | localized_url }}

Temanın eklediği arayüz etiketleri için isteğe bağlı locales/<locale>.json dosyaları oluşturun. Arama sırası çekirdek İngilizce, çekirdek yerel dil, tema İngilizcesi ve tema yerel dilidir. Böylece theme-core içindeki ortak etiketler dosyaları kopyalamadan çalışır. İşletmeye özgü metinler sözlüklerde değil, çevrilebilir içerikte, bileşen alanlarında veya tema ayarı alanlarında tutulmalıdır.

Özel bir bileşen dosyası

<article class="featured-course featured-course--{{ component.variant }}">
  <div class="featured-course__content">
    <h1>{{ component.data.heading }}</h1>
    {% if component.data.summary %}<p>{{ component.data.summary }}</p>{% endif %}
  </div>
</article>

Çevrilebilir alanlar için Eyivo, oluşturma öncesinde ziyaretçinin yerel ayarını seçer. Dolayısıyla bir Türk ziyaretçi ve bir İngiliz ziyaretçi aynı bileşen yapısını farklı component.data.heading değerleriyle görüyor.

7. Kullanabileceğiniz güvenli Liquid verileri

Liquid, Laravel veya veritabanı modellerini değil, düz, normalleştirilmiş verileri alır. Bir değer bu tabloda yoksa onu v1'de mevcut değil olarak değerlendirin.

NesneYararlı alanlarTipik kullanım
sitename, localeSite düzeyindeki etiket ve ana dil.
companyname, legal_name, description, address, phone, emailÜstbilgi, altbilgi ve iletişim bilgileri.
pageid, type, title, slug, body, settingsGenel sayfa içeriği ve sayfa başına ayarlar.
seoSağlandığında title, description, canonical/robots/Open Graph değerleriBelge kafası.
navigation.mainHer öğede label, url ve active bulunurSite menüsü.
localecode, name, native_name, direction, is_default, home_url, availableBelge dili, RTL yönü, yerelleştirilmiş ana sayfa bağlantıları ve dil seçiciler.
routeshome, contact, catalog, gallery, videos, blogYerel ayara göre doğru sistem URL'leri; Liquid'da asla önek oluşturmayın.
blogtitle, url, categories, category, posts, post, paginationÜcretsiz blog listesi, kategori arşivi ve makale sayfaları. Gönderiler başlığı, özeti, URL'yi, tarihleri, kategorileri ve kapak medyasını gösterir. Yalnızca blog.post.body_html, sunucu tarafından oluşturulan güvenli makale HTML'sini içerir ve raw kullanmalıdır. Sayfalandırma, previous_url ve next_url sağlar.
theme.settingsTema ayarlarınızYapılandırılmış bir renk, aralık veya tasarım seçeneği kullanın.
products/productÇevrilmiş başlık, URL, özet ve gövdeÜrün listeleme/ayrıntı sayfası türleri.
galleriesÇevrilmiş başlık ve açıklamaGaleri sayfası türü.
videostitle, description, source_type, source_url, playback_url, mediasource_type değerine göre yüklenen video dosyaları için playback_url, harici HTTP(S) videolar için source_url kullanın. Ekli görseller video kaynağı değildir. Video dosyasının kendisini poster görseli olarak kullanmayın.
componentid, type, variant, dataYalnızca bir bileşen dosyasının içinde.

Yerel ayar açısından güvenli düzen örneği

<html lang="{{ locale.code }}" dir="{{ locale.direction }}">
<a href="{{ locale.home_url }}">{{ company.name }}</a>
{% if locale.available.size > 1 %}
  <nav aria-label="Language">
    {% for language in locale.available %}
      <a href="{{ language.url }}" lang="{{ language.code }}"
         {% if language.current %}aria-current="page"{% endif %}>
        {{ language.native_name }}
      </a>
    {% endfor %}
  </nav>
{% endif %}

Mevcut dil öğelerinin her biri aynı zamanda label, direction, is_default, current ve has_translation'yu da gösterir. Eyivo yalnızca eşdeğer yayınlanmış çevirileri sağlar, bu nedenle temalar /en veya başka herhangi bir önek oluşturmak yerine language.url kullanmalıdır.

Ayarlara dayalı token örneği: style="--brand: {{ theme.settings.primary_color }}". Ayarın ilk önce theme.json'da bildirilmesi gerekir.

8. Bileşenler: doğrudan ve dinamik

Bileşenlerin iki yerleştirme yolu vardır. Doğrudan bileşenin yeri, tasarımcı tarafından yerleşimde veya sayfa türünde belirlenir. Dinamik bileşen ise sayfa bölgesi örneği olarak saklanır ve düzenleyiciden yönetilir. Dinamik örneklerin sabit kimliği, ad alanlı türü, bölgesi, sıra numarası, isteğe bağlı varyantı, verileri ve çevirileri vardır. Sıra numarası yalnızca sıralama içindir, kimlik değildir.

Alan türleri

text, textarea, richtext, number, boolean, select, url, email, image, video, file, color, icon, page, product ve repeater.

Ad alanları

eyivo:, theme-core/components'dan çözümlenir, theme: etkin temadan çözümlenir ve plugin: gelecekteki eklentiler için ayrılmıştır. Bir alanda veya eyivo_component etiketinde tam ad alanı türünü kullanın.

Evrensel bileşen: uyumlu sayfa türlerinin tüm bölgelerinde kullanılabilmesi için bileşen tanımında "universal": true ayarını yapın. Bileşenin yine de geçerli bir şeması ve Liquid dosyası olmalıdır.

Ortak işlem bağlantıları, sorgu parametrelerini ve bölüm işaretlerini koruyarak bilinen iç yolları etkin dile uyarlar. Zengin metin, iç içe düzenleyici kapsayıcılarındaki güvenli biçimlendirmeyi korur. Boş galeri görselleri gösterilmez, hedefi olmayan harita görselleri bağlantı olmaz; slayt ve arama etiketleri ziyaretçinin arayüz dilini kullanır.

9. Site özel CSS’i ve bölüm sınıfları

Site sahipleri bir siteye kendi CSS’lerini ekleyebilir ve bölümlere sınıf adları verebilir (Tasarım → Özel CSS). Temaları bunun iyi çalışacağı şekilde yazın:

  • Yükleme sırası: sitenin CSS’i, tüm tema stil sayfalarından sonra, </head> öncesine <style id="eyivo-custom-css"> olarak eklenir. Düzenlerinizde </head> etiketini koruyun ve CSS’inizin en son yükleneceğine güvenmeyin.
  • Bölüm sınıfları: oluşturucu bir bölümün sınıf adlarını bileşen çıktısının ilk öğesine ekler; bu yüzden her bileşen şablonuna tek bir kök öğe verin. Adlar, başka bir yere yerleştirmek isterseniz {{ component.css_class }} olarak da kullanılabilir.
  • Kararlı kancalar: site sahiplerinin CSS’i sürümleriniz boyunca çalışmaya devam etsin diye body.theme-{key} ve layout-{name} sınıflarını ve bileşen başına bir kararlı kök sınıfı koruyun. Yeniden adlandırmaları sürüm notlarında belirtin.
  • Yüklenen temalar: site özel CSS’i onlarda da kullanılır. Yüklenen bir temanın tüm sürümleri site başına tek bir stil sayfasını paylaşır; temanın bir sitedeki son sürümü kullanımdan kaldırıldığında veya silindiğinde bu stil sayfası da silinir.
  • Ayrılmış adlar: eyivo- sınıf öneki ve eyivo-custom-css kimliği platforma aittir.

10. Tema betikleri (Theme API 1.1)

Bir tema menüler, kaydırıcılar, sekmeler, filtreler ve benzeri özellikler için kendi JavaScript dosyalarını içerebilir. Betikler isteğe bağlıdır: her tema onlar olmadan da çalışmalıdır ve Theme API 1.0 paketleri betik olmadan aynen çalışmaya devam eder.

  • Bildirin: theme.json içinde "eyivo_theme_api": "1.1" ve "capabilities": {"custom_javascript": true} ayarlayın ve her dosyayı doğrudan assets/js/ içine koyun. Bildirim olmadan .js dosyası içeren paket reddedilir.
  • Yükleyin: paketteki bir dosya için yalnızca <script src="{{ 'js/theme.js' | asset_url }}" defer></script> (veya type="module") kullanın. Etiketler göründükleri sırayla çalışır.
  • Birden çok dosya: her dosya ayrı ayrı incelenir ve onaylanır, bu yüzden import ve export kullanılamaz. Kodu window.AcmeTheme gibi tek bir genel nesne üzerinden paylaşın ve onu tanımlayan dosyayı önce yükleyin.
  • Sınırlar: en fazla 20 dosya, dosya başına 100 KB ve toplam 300 KB; yalnızca UTF-8 metin.
  • Şablonlarda reddedilenler: satır içi betikler, harici betik kaynakları, on…= olay işleyici öznitelikleri, javascript: URL'leri ve <iframe>, <object>, <embed>, <base> öğeleri.
  • Yalnızca okunabilir kod: küçültülmüş, paketlenmiş veya kodlanmış kod değil, kaynak kod yükleyin. Paketleyiciler küçültülmemiş çıktı üretebilir.
  • Durumlar: yeni bir sürüm kontroller bitene kadar İnceleme bekliyor durumundadır, ardından Onaylandı veya Reddedildi olur. Yalnızca onaylanmış bir sürüm önizlenebilir veya kullanılabilir. Onaylanmış bir sürüm daha sonra Engellendi olabilir: web siteleri temayı betikleri olmadan kullanmaya devam eder.
  • Sırayla üç otomatik kontrol: okunabilir kod; kod kuralları (eval, new Function, document.write, sayfa yönlendirmeleri, window.open, çerezler veya tarayıcı depolaması, WebAssembly, dize zamanlayıcılar, oluşturulan script veya çerçeve öğeleri ya da ağ üzerinden gönderilen form değerleri yok); ve bir yapay zekâ güvenlik incelemesi. Bu inceleme için betikler ve onları yükleyen şablon satırları bir yapay zekâ hizmetine gönderilir. Herhangi bir bulgu, dosya ve satırıyla birlikte sürümü reddeder.

Geçer: bir menü açma düğmesi

(function () {
  document.querySelectorAll('[data-menu-toggle]').forEach(function (button) {
    button.addEventListener('click', function () {
      document.body.classList.toggle('menu-open');
    });
  });
})();

Reddedilir: form değerlerini dışarı gönderir

form.addEventListener('submit', function () {
  fetch('/collect', { method: 'POST', body: form.elements.email.value });
});
  • Yalnızca sahip: onaylanmış betikler yalnızca temayı yükleyen hesaba ait web sitelerinde ve yalnızca platform ile web sitesinin sahibi izin verdiği sürece çalışır.
  • Güvenlik politikası: tema betiği çalıştıran sayfalar yalnızca incelenmiş dosyalara, SHA-256 özetleriyle sabitlenmiş olarak izin verir; connect-src 'self' geçerlidir, çerçeve veya worker yoktur ve eval çalışmaz. Bir dosyayı değiştirmek yeni bir sürüm gerektirir. Görseller ve stil dosyaları hâlâ https: üzerinden yüklenebildiği için inceleme, görsel veya stil dosyası URL'leriyle gönderilen verileri de reddeder.
  • Onaydan sonra: tarayıcılar politikayı ihlal etme girişimlerini bildirir. 24 saat içinde üç ziyaretçiden gelen bildirimler sürümü engeller; 7 gün içinde üç ziyaretçiden gelen kötüye kullanım bildirimleri o web sitesinde betikleri kapatır ve sürümü yeniden kontrol eder. Sahipler, bir sürüm onaylandığında, reddedildiğinde veya engellendiğinde e-posta alır.
  • Platform özellikleri: betikler formları ve gizli alanlarını, insan doğrulamasını, onay bandını, Eyivo rozetini veya sahip çubuğunu değiştiremez, sarmalayamaz veya gizleyemez.

11. Mevcut bileşen kataloğu

Bu 30 paylaşılan eyivo: bileşenleri, v1 kitaplığının tamamını oluşturur ve theme-core'dan çözümlenir. Bir tema ayrıca kendi theme: bileşenlerini bildirebilir ve uygulayabilir.

Varyantlar: spliteditorialcenteredimmersive

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Evet Evet —
summary textarea Hayır Evet —
image_url url Hayır Hayır —
image_alt text Hayır Evet —
primary_label text Hayır Evet —
primary_url url Hayır Hayır —
secondary_label text Hayır Evet —
secondary_url url Hayır Hayır —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
body richtext Hayır Evet —

Varyantlar: image_leftimage_rightoverlap

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
body richtext Hayır Evet —
image_url url Hayır Hayır —
image_alt text Hayır Evet —
badge text Hayır Evet —
button_label text Hayır Evet —
button_url url Hayır Hayır —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
intro textarea Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
intro textarea Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
intro textarea Hayır Evet —
button_label text Hayır Evet —
button_url url Hayır Hayır —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
text textarea Hayır Evet —
submit_label text Hayır Evet —
form_binding select Hayır Hayır —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
heading text Hayır Evet —
text textarea Hayır Evet —
whatsapp_url url Hayır Hayır —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
address textarea Hayır Evet —
map_url url Hayır Hayır —
image_url url Hayır Hayır —
image_alt text Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
heading text Hayır Evet —
placeholder text Hayır Evet —
categories repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
summary textarea Hayır Evet —
video_url url Hayır Hayır —
poster_url url Hayır Hayır —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
price text Hayır Evet —
period text Hayır Evet —
features repeater Hayır Evet —
button_label text Hayır Evet —
button_url url Hayır Hayır —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
label text Hayır Evet —
heading text Hayır Evet —
body textarea Hayır Evet —
button_label text Hayır Evet —
button_url url Hayır Hayır —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

Paylaşılan eyivo:faq bileşeni her temada aynı alanları ve işaretlemeyi korur. Her tema onu kendi yazı tipi, boşluğu ve rengiyle sunar.

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
text textarea Hayır Evet —
button_label text Hayır Evet —
button_url url Hayır Hayır —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
heading text Hayır Evet —
items repeater Hayır Evet —

Varyantlar: yok

AlanTipGerekliÇevrilebilirSeçenekler
eyebrow text Hayır Evet —
heading text Hayır Evet —
intro textarea Hayır Evet —
items repeater Hayır Evet —

12. Formlar ve kayıt geçmişi

Forms API 1 yedi onaylı işleyici sağlar. Temalar düzen ve stili; eklentiler şema, doğrulama ve iş akışını yönetir. Kayıt, insan doğrulaması ve bildirimleri platform yürütür.

Sistem eklentisiForm türü
eyivo/contactİletişim contact
eyivo/quote-requestTeklif talebi quote_request
eyivo/product-inquiryÜrün sorusu product_inquiry
eyivo/appointment-requestRandevu talebi appointment
eyivo/course-applicationKurs başvurusu course_application
eyivo/reservation-requestRezervasyon talebi reservation
eyivo/property-inquiryEmlak sorusu property_inquiry

Bir form, birden çok yerleşim

Kurulum her site/eklenti/tür için kalıcı bir varsayılan UUID oluşturur. Yerleşimi yeniden kullanmak kimliği korur; adlandırılmış yeni form ayrı UUID alır. Tema değişikliği ve yeniden kurulum geçmişi korur. Tema taşınabilir takma adlar kullanır; müşteri UUID yazmadan kayıtlı formu seçer.

{
  "plugins": ["eyivo/contact", "eyivo/quote-request"],
  "forms": {
    "contact": {"plugin":"eyivo/contact","type":"contact","schema_version":1,"instance":"default"},
    "quote": {"plugin":"eyivo/quote-request","type":"quote_request","schema_version":1,"instance":"default"}
  }
}

İletişim şablonunda forms.contact, iletişim bölümlerinde component.form kullanın. form_preset yerine form_binding kullanın. Sağlanan alanları, yönlendirmeleri, action, CSRF, imzalı form_context ve verification_html değerlerini gösterin. Yalnızca bildirilen sunum değişiklikleri ve izinli ek alanlar geçerlidir; zorunlu doğrulama zayıflatılamaz.

forms.contact · component.form · form_binding · form.fields · form.action · form.csrf_token · form.context · form.verification_html

İki gelen kutusu, tek kayıt

Ortak gelen kutusu ile eklentinin liste/detay sayfaları aynı kayıtları gösterir. Form paketleri Panel API 2 submission-list/submission-detail bileşenlerini ve tek düzey menü bağlantısını gerektirir. Panel API 1 desteklenir. Görüntülemek okundu yapmaz; okuma/arşiv/iş akışı ayrıdır ve değişiklikler record_revision kullanır. Devre dışı eklentinin menüleri kaybolur; ortak kutu geçmişi korur.

{"components":[{"type":"submission-list","form_type":"contact","detail_page":"submission"}]}
{"components":[{"type":"submission-detail","form_type":"contact","list_page":"submissions"}]}

Müşteri verileri ve izinler

Form kayıtları sitenin içerik veritabanında tutulur ve diğer içerikle aynı max_db_bytes paket hakkını kullanır. Ayrı kayıt sayısı veya saklama kotası yoktur. Yapılandırma master veritabanında 50 alan, 32 KB ve üç düzey sınırını korur. Üyeler görüntüler; değişiklikler sahip/yönetim izni gerektirir. Eklenti doğrudan veritabanına erişmez; PHP/Blade uygulamaya aktarılmaz.

Doğrulanmış kayıt ve bildirim

Platform imzalı bağlamı, cevapları ve insan doğrulamasını denetler; kayıt, kullanım ve bildirim işini birlikte kaydeder. Aynı deneme ve içerik 24 saat içinde çoğalmadan geri alınabilir. SMTP sonra çalışır ve yeniden deneyebilir; e-posta hatası kaydı silmez. Form alıcısı belirtilmezse şirket e-postası kullanılır; iki adres de geçerli değilse kayıt e-posta olmadan saklanır.

Tüm yerleşik temalar bu sözleşmeyi kullanır. Eski contact POST istekleri 410 döndürür; iletişim sayfası GET bağlantıları çalışır. Randevu ve rezervasyon talepleri kesin rezervasyon oluşturmaz. Üçüncü taraf işleyiciler, dosya yükleme ve keyfi dış adresler kapsam dışıdır.

POST /__eyivo/forms/{UUID}/submissions
GET /__eyivo/forms/{UUID}/challenge

13. İkincil menüler ve kenar çubukları

Gerektiğinde theme.json içinde header, secondary, sidebar, footer ve useful_links menülerini kaydedin. navigation.secondary menüsünü bir yardımcı çubukta, navigation.sidebar menüsünü sıradan sayfaların yanında gösterin. Sahipler her menüyü standart menü düzenleyicisinden düzenler ve yayınlar. Ana menüyü kısa tutun; küçük ekranlarda kenar çubuğu sayfa içeriğinin altına geçmelidir.

Kenar çubuğu bir bileşen değil, bir yerleşim alanıdır. Onu kullanan her sayfa türünde allowed_components (örneğin rich_text, announcement, download_list ve contact_actions) ve max değeriyle bir sidebar alanı bildirin, ardından areas.sidebar alanını navigation.sidebar ile birlikte bir <aside> içinde gösterin:

{% if navigation.secondary.size > 0 %}
<nav aria-label="{{ 'Useful information' | t }}">
  {% for item in navigation.secondary %}
    <a href="{{ item.url }}"{% if item.active %} aria-current="page"{% endif %}>{{ item.label }}</a>
  {% endfor %}
</nav>
{% endif %}
<aside aria-label="{{ 'More information' | t }}">
  {% for item in navigation.sidebar %}
    <a href="{{ item.url }}">{{ item.label }}</a>
  {% endfor %}
  {{ areas.sidebar | raw }}
</aside>

15. Sayfa şablonları ve çekirdek yedekler

On standart sayfa türü vardır: home, page, contact, products, product, gallery, videos, blog, blog_category ve blog_post. Bir tema onunun tamamını veya yalnızca bazılarını sağlayabilir; temanın bildirmediği her tür için theme-core çalışan bir şablon sunar. Çekirdek sayfa türlerini geçersiz kılarken alan adlarını ve form bağlamalarını koruyun; böylece mevcut içerik ve kayıtlı formlar tema değişikliğinden sonra da çalışır.

16. Sayfa başlık alanları

Alt sayfa başlık alanlarının iki biçimi vardır. Görsel yoksa içerik yolu, isteğe bağlı üst başlık ve sayfa başlığıyla sade bir bant kullanın. Görsel varsa, metnin her fotoğrafta okunabilir kalması için başlığı, içerik yolunu ve özeti görselin ve kontrast sağlayan bir katmanın üzerine yerleştirin; katmanın yönünü sağdan sola düzenlerde ters çevirin.

17. Görseller, galeriler ve video

Yüklenen görselleri sınırlı çerçeveler içinde tutun: katalog görselleri oranlarını korur, ayrıntı fotoğrafları ise ortalanmış kırpmayla çerçeveyi doldurabilir. Galeriler orijinal görseli Escape ile kapanan ve odağı görsel bağlantısına geri veren bir iletişim kutusunda açabilir; betik yoksa orijinal görsel yeni sekmede açılacak şekilde bağlanmalıdır. Görsel kaydırıcılar dokunmayı, düğmeleri, klavyeyi ve azaltılmış hareketi desteklemelidir.

18. Zengin metin ve ortak görüntüleme kuralları

Ortak eyivo:rich_text bileşeni düzenleyici işaretli ve eski HTML gövdeleri kabul eder. İkisi de platformun biçimlendirme izin listesinden geçer: paragraflar, başlıklar, listeler ve güvenli bağlantılar içerik olarak görünür; betikler, olay işleyiciler ve güvensiz bağlantılar kaldırılır. Diğer metin alanları kaçışlı kalır. Zengin metni kendi HTML işlemenizle değil, sağlanan filtrelerle gösterin.

19. Girişler, yönlendirme alanları ve uzun sayfalar

Bir sayfa türü, başlık alanını hızlı bağlantılar veya temel bilgiler için isteğe bağlı bir yönlendirme alanıyla eşleştirebilir; bu alan boşsa giriş tüm genişliği kullanmalıdır. Uzun yazı sayfaları okunabilir satır uzunluğunu ve net başlık boşluklarını korumalı; kontrol listesi veya not gibi destekleyici bölümleri geniş ekranlarda yazının yanına, küçük ekranlarda arkasına yerleştirebilir. Her düzen betik olmadan da okunabilir kalmalıdır.

20. Hareket ve azaltılmış hareket

Süsleme amaçlı hareket isteğe bağlıdır. Geçişlerde, kaydırıcılarda ve hareketli bölümlerde prefers-reduced-motion tercihine uyun; ziyaretçi üzerine geldiğinde veya içine odaklandığında hareketli içeriği duraklatın.

21. Eksiksiz tema kontrol listesi

Eksiksiz bir tema on sayfa şablonunun tamamını sağlar, tüm ortak eyivo: bileşenlerini biçimlendirir, mevcut form eklentileri ve İnsan Doğrulaması aracılığıyla her taşınabilir form bağlamasını destekler ve masaüstü, mobil ve sağdan sola düzenlerde çalışır. Katalog filtreleme, sekmeler, kaydırıcılar ve menü açılırları, onlar olmadan da çalışan içeriğin üzerine eklenen isteğe bağlı iyileştirmelerdir.

22. Tema etkinleştirmeden yayımlamaya süreç

  1. Temayı yükleyin ve etkinleştirin. Eyivo paketi doğrular, anahtarını ve sürümünü kaydeder, ayarlarını ve bileşen şemalarını uygulamada gösterir.
  2. Bir sayfa türü seçin. Eyivo varsa etkin temanın eşleşen Liquid dosyasını ve bölge tanımını, yoksa theme-core içindeki yedeği kullanır.
  3. İzin verilen bölümleri ekleyin. Uygulama yalnızca allowed_components'da listelenen türleri sunar. Seçilen bileşen örneğine göre metin, medya referansları ve çevirileri saklar.
  4. Güvenle oluşturun. Eyivo şirket, sayfa, SEO ve gezinme verilerini hazırlar; saklanan bölge bileşenlerini ve tasarımcının yerleştirdiği doğrudan bileşenleri oluşturur. Ardından etkin temanın sayfa türünü ve yerleşimini işler.
  5. Yayımlayın. Ziyaretçi HTML ve CSS çıktısını alır; veritabanı kimlik bilgilerine, dahili modellere veya uygulama koduna erişmez.
  6. Yeni sürümle güncelleyin. Özel temalar altında bir ZIP yüklemek yeni bir tema oluşturur. Var olan bir temayı değiştirmek için temayı açın, theme.json içindeki version değerini artırın ve yeni bir sürüm yükleyin. Her site, yeni sürümü taslak olarak kullanıp yayımladığınızda geçiş yapar; önceki sürüm 30 gün boyunca geri dönüş için kullanılabilir kalır.

23. Doğrulama ve yaygın hatalar

Eğer görürsen…İlk önce bunu kontrol edin
“Desteklenmeyen Eyivo Theme API sürümü”"eyivo_theme_api": "1.0"'yu ayarlayın.
Eksik sayfa türü/düzen/bileşen hatasıTemanın bildirdiği her sayfa türü veya bileşen için eşleşen bir .liquid dosyası gerekir. Etkin tema her zaman layouts/default.liquid sağlamalıdır; bildirilmeyen yerleşik sayfa türleri çekirdek tanıma döner.
Bileşen düzenleyicide kullanılamıyorAd alanı tipinin o alanın allowed_components listesinde olması veya tanımın evrensel olması gerekir.
Bilinmeyen doğrudan bileşenPaylaşılan katalogdan alıntılanan bir eyivo: türü kullanın veya etkin temada eşleşen bir theme: tanımı ve Liquid dosyası bildirin.
Alan reddedildiBunu bileşen şemasında bildirin ve desteklenen bir alan türünü kullanın. Yerel ayara özgü metin için translatable: true kullanın.
Şablon biçimsiz görünüyorCSS için asset_url filtresini kullanın ve dosyanın assets/ altında olduğunu doğrulayın.
Paket güvenli olmayan sözdizimi nedeniyle reddedildiPHP/Blade, env, config, DB/HTTP çağrılarını ve dosya sistemi erişimini kaldırın. Liquid yalnızca sunum amaçlıdır.
Betik kuralları: custom_javascript_declaration, script_file, script_tag, script_import, script_sizeTema betikleri bölümünü izleyin. İnceleme bulguları, dosya ve satırlarıyla sürümün sayfasında görünür; bunları düzeltip yeni bir sürüm yükleyin.

24. SSS

Müşteri yeni bir yerleşim oluşturabilir veya hero bölümünü altbilginin altına taşıyabilir mi?

Hayır. Onaylı içeriği değiştirebilir ve bir bölgedeki izin verilen bileşenleri sıralayabilirler. Yerleşimi Liquid sayfa türü belirler.

Bir tasarımcı, düzenlenebilir alanı olmayan bir bileşeni kullanabilir mi?

Evet. Bir düzende veya sayfa türünde eyivo_component kullanın. Site sahibinin bileşen örneğini ve sırasını kontrol etmesi gereken bir alan kullanın.

Bir temanın her sayfa türünü uygulaması gerekir mi?

Her temanın blogu desteklemesi gerekir. Yerleşik blog, blog_category ve blog_post türleri, etkin temanın yerleşimi içinde theme-core tanımlarını ve Liquid dosyalarını kullanabilir. Bir türü yalnızca karşılık gelen geçersiz kılma dosyasını sağlıyorsanız bildirin. Mevcut tema paketleri uyumlu kalır. Blog yolları /blog, /blog/category/{slug} ve /blog/{slug} biçimindedir; gerektiğinde Eyivo dil öneki eklenir. Güvenli meta veriler, duyarlı blog stilleri ve boyutları sınırlandırılmış görsel kartları için eyivo_head etiketini koruyun.

Bir tema bir sayfayı sorgulayabilir, bir API'yi çağırabilir veya bir ortam değişkenini okuyabilir mi?

Hayır. Veriler bilinçli olarak güvenli nesneler olarak iletilir. Bu, temaların taşınabilir, güvenli ve öngörülebilir olmasını sağlar.

Bir güncellemeyi nasıl yayınlarım?

Yeni bir anlamsal tema sürümü yayınlayın. Yayınlanan bir sürümü sessizce değiştirmeyin; siteler açıkça yeni bir sürüme geçmelidir.

Görseller nerede tutulmalı?

Bileşen verilerinde bir Eyivo medya URL'si veya asset_url aracılığıyla başvurulan bir paket varlığı kullanın. Rastgele sunucu dosya sistemi yollarını kullanmayın.

25. Değişiklik günlüğü

  • 31 Ekim 2026. Theme API 1.1: temalar custom_javascript yeteneğiyle assets/js/ içinde incelenmiş JavaScript içerebilir. Yeni sürümler otomatik olarak incelenir ve İnceleme bekliyor, Onaylandı, Reddedildi veya Engellendi durumunu gösterir. Theme API 1.0 paketleri değişmedi.
  • 31 Ekim 2026. Site sahipleri stil sayfalarınızdan sonra yüklenen site özel CSS’i ekleyebilir ve bölümlere sınıf adları verebilir; bu adlar her bileşenin ilk öğesine eklenir ve {{ component.css_class }} olarak kullanılabilir. Bkz. Site özel CSS’i ve bölüm sınıfları.
  • 31 Ekim 2026. demo.json içindeki demo medyası izin verilen bir https sunucusu (cdn.eyivo.com veya images.pexels.com) ya da assets/ altında paketlenmiş bir dosya kullanmalıdır. Eyivo her dosyanın türünü içeriğinden belirler. Bu bir güvenlik düzeltmesidir; Theme API 1.0 olarak kalır.
  • 30 Ekim 2026. Eyivo yüklenen her temaya kendi kimliğini verir ve theme.json içindeki key isteğe bağlıdır. Değişiklikleri temanın sayfasından yeni sürüm olarak yükleyin. Örnek depo temayı sample-theme/ klasöründe tutar; bu klasörü ZIP olarak sıkıştırıp yüklersiniz. Paket örneği artık assets/js/ göstermez, çünkü Theme API 1.0 yüklemeleri JavaScript dosyası içeremez.