1. Das Grundmodell
Es gibt drei getrennte Zuständigkeiten. Diese Trennung ist der Schlüssel zum Verständnis von v1.
Eyivo Core
Speichert Unternehmensdaten, Seiten, Medien, SEO, Navigation und Veröffentlichungsstatus. Es ist die maßgebliche Quelle für Inhalte.
Theme-Paket
Definiert feste Seitenstrukturen, zulässige Abschnitte, Schemas eigener Komponenten und CSS. Es fragt weder Daten ab noch führt es Anwendungscode aus.
App-Editor
Erzeugt sichere Formulare aus dem Schema. Inhaber können Text, Bilder, Seiten und die Reihenfolge der Abschnitte innerhalb eines Bereichs ändern.
Kein Seitenbaukasten: Ein Inhaber kann main einen erlaubten Abschnitt hinzufügen und seine numerische Position wählen. Er kann keinen neuen Bereich anlegen, keinen Hero in die Fußzeile ziehen und die Dateien Ihres Themes nicht ändern. Er kann eigenes Website-CSS hinzufügen, das nach Ihren Stylesheets geladen wird, und Abschnitten Klassennamen geben (siehe Eigenes Website-CSS).
2. Schnellstart: eine minimale, nutzbare Vorlage
Jedes v1-Theme bringt sein vollständiges Layout, seine Styles und Skripte mit und kann sie nach dem gewählten Design anordnen. Themes erben weder Layouts noch Assets anderer Themes. Gemeinsame eyivo:-Komponenten und die sieben Ersatz-Seitentypen stammen aus theme-core; ein Theme speichert nur überschriebene Seitentypen und die eigenen Komponenten im Namensraum theme:.
Jedes v1-Theme benötigt eine Standard-Layoutdatei. page-types/ und components/ sind optional, wenn das Paket ausschließlich Core-Fallbacks nutzt:
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 stammt immer aus dem aktiven Theme und bildet das vollständige öffentliche Dokument. Eyivo sucht den angeforderten Seitentyp zuerst im Theme und greift dann auf theme-core/page-types zurück. Core liefert weder Layout noch Assets; der Fallback-Seiteninhalt wird deshalb weiterhin vom aktiven Theme umgeben und gestaltet.
3. Vorlage in theme.json beschreiben
Das Manifest beschreibt sowohl die Fähigkeiten des Themes als auch den Vertrag, aus dem die App Formulare erzeugt. Es beantwortet drei Fragen: Welche Seitenstrukturen gibt es, welche Bereiche enthalten sie und welche Daten darf eine Komponente speichern? Integrierte Themes deklarieren alle zehn Standardseitentypen ausdrücklich und enthalten die zugehörigen Liquid-Dateien. Eigene Themes können für nicht deklarierte Seitentypen weiterhin auf Core-Vorlagen zurückgreifen.
{
"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 }
}
}
}
}
| Schlüssel | Bedeutung | Beispiel |
|---|---|---|
key | Optionale Bezeichnung für Ihre eigene Übersicht. Eyivo vergibt für jedes hochgeladene Theme eine eigene ID, daher entscheidet der Schlüssel nie, zu welchem Theme ein Upload gehört. | acme-industrial |
version | Die unveränderliche Release-Version Ihres Themes nach semantischer Versionierung. | 1.2.0 |
eyivo_theme_api | Der öffentliche Eyivo-API-Vertrag, den Ihr Paket unterstützt. | 1.0 |
areas | Benannte Plätze, die Ihre Liquid-Seitendatei an festen Stellen rendert. | hero, main, bottom |
allowed_components | Welche Komponenten der Editor einem Bereich hinzufügen darf. | ["eyivo:hero"] |
components | Eigene theme:-Komponentendefinitionen des aktiven Themes. Gemeinsame eyivo:-Definitionen bleiben in theme-core. | featured_course |
min/max | Optionale Grenzen für die Anzahl der Abschnitte in diesem Bereich. | max: 1 |
Fallback für Seitentypen: Die integrierten Typen sind home, page, gallery, contact, products, product und videos. Lassen Sie einen davon weg, um Definition und Liquid-Datei aus theme-core zu verwenden. Deklarieren Sie einen Typ nur, wenn das Theme auch die passende Datei page-types/<type>.liquid als Überschreibung bereitstellt.
Der Editor erhält die zusammengeführte Seitentyp-API: Definitionen des aktiven Themes ersetzen entsprechende Core-Definitionen; jeder ausgelassene Typ bleibt aus Core verfügbar.
4. Vollständige Demoinhalte in demo.json
Jeder Upload muss eine portable demo.json-Datei mit ausschließlich Entwurfsdaten und mindestens einen Screenshot mit diesen geladenen Daten enthalten. Integrierte Themes verwenden dasselbe Schema. Nehmen Sie keine Datenbank-IDs, Tenant-Domains, Zugangsdaten oder Objektspeicher-Zugangsdaten auf.
{
"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": []
}
| Schlüssel | Zweck |
|---|---|
media | Öffentliche Quell-URLs und Metadaten unter portablen Asset-Kennungen. Verwenden Sie dieselbe Kennung für hero_asset, cover_asset, media_asset, das asset eines Galerieeintrags sowie logo_asset und favicon_asset. |
company | Unternehmensprofil, soziale Links, Markenfarben, optionales Logo-/Favicon-Asset und Übersetzungen nach Sprachcode. |
theme_settings | Anfängliche Theme-Einstellungen mit optionalen Übersetzungen nach Sprachcode. |
pages | Typ, Sortierung, Navigationsstatus, SEO, Seiteneinstellungen, Komponenten und Inhalte nach Sprachcode. |
catalog | Katalogeinträge mit Inhalten nach Sprachcode und optionalem cover_asset. |
galleries | Galerie-Metadaten und Bildeinträge. Jeder Galerieeintrag benötigt ein asset und einen nicht leeren alt_text. |
videos | Eine externe source_url oder ein media_asset, Darstellungsmodus und Inhalte nach Sprachcode. |
Jeder media-Eintrag braucht entweder eine public_url mit https auf einem erlaubten Host (dem Eyivo-Demo-Medienhost cdn.eyivo.com oder images.pexels.com) oder eine im Theme unter assets/ mitgelieferte Datei, die über ihren Pfad angegeben wird und keine public_url hat. Andere Hosts, http, IP-Adressen, andere Ports und Weiterleitungen werden mit der Upload-Diagnose demo_media_url abgelehnt. mime_type, width und height sind nur Hinweise: Eyivo erkennt den echten Typ am heruntergeladenen Inhalt; die Datei muss ein erlaubtes Bild oder Video von höchstens 20 MB sein.
Demo-Formulare verwenden portable Formularbindungen, die Eyivo für jede Website, die die Demo importiert, separat auflöst. Importierte Demobilder werden auf dieser Website zu gewöhnlichen Medienreferenzen; wenn Sie sie dort entfernen, wird das gemeinsame Original nie gelöscht.
Seiten und Komponenten
{
"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" }
}
}]
}
Komponententypen und Bereiche müssen im Manifest des aktiven Themes oder in theme-core deklariert sein. Verwenden Sie für Links innerhalb der Website relative Pfade wie /contact. Die mitgelieferten Startseiten-Demos verwenden ihr vorhandenes Hero-Bild als Hintergrund über die volle Breite mit lesbarer Überlagerung und responsivem Text: meist immersive, in Compact centered mit Bild. Andere Hero-Varianten behalten ihre eigenen Layouts.
Demo-Sprachen und Fallback
Englisch ist die erforderliche Basissprache: Setzen Sie default_locale auf en. Fehlt das Feld in älteren Daten, gilt ebenfalls Englisch. Andere unterstützte Website-Sprachen sind optional. Englische Kopien gelten nicht als Übersetzungen.
Verwenden Sie translations.en und optionale Sprachobjekte für Unternehmen, Theme-Einstellungen, Seiten, Komponenten, Produkte, Galerien, Bildunterschriften und Alternativtexte, Videos und Blogbeiträge. Ältere englische Felder ohne Sprachschlüssel bleiben gültig. Beim Erstellen wird die Hauptsprache der Website gewählt; fehlende Felder fallen auf Englisch zurück. Arrays ersetzen das gesamte englische Array, ausdrücklich leere Werte bleiben erhalten. Nur die gewählte Sprache wird importiert; weitere Sprachen werden nicht automatisch aktiviert.
Verwenden Sie englische Quell-Slugs für interne Links und portable Menüeinträge. Beim Import werden auch Links in Rich Text und Blogdokumenten auf den übersetzten Slug abgebildet. Menüeinträge können explizite slugs- und labels-Zuordnungen enthalten. Fehlende Beschriftungen fallen auf Englisch zurück. Externe URLs bleiben unverändert.
{
"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" }
}]
}
}
Sicherer Import und Umgang mit Medien
Neue Websites aus dem Dashboard enthalten standardmäßig Demo-Daten und veröffentlichen sofort die gewählte Sprache; Besitzer können die Option deaktivieren. Demo-Importe über Branding für bestehende Websites bleiben Entwürfe und erhalten veröffentlichte Inhalte. Die zentrale App kopiert Bilder in die Medienbibliothek der neuen Website und sendet Referenzen über die interne API. Master und Themes erhalten keine Zugangsdaten zum Objektspeicher. Themes verwenden die bereitgestellte media.public_url.
Deklarieren Sie Screenshots unter theme.json.preview mit data_source: "demo_data". Das Paket muss jedes deklarierte preview-Bild enthalten.
5. Jedes gewünschte Layout mit Liquid gestalten
Das Standardlayout besitzt das vollständige HTML-Dokument. Nichts außerhalb des aktiven Themes liefert Kopfbereich, Fußzeile, Stylesheet oder visuelle Struktur. Die Plattform fügt nur eigene Skripte für Formulare, Menschenprüfung, Einwilligung und das Eyivo-Badge hinzu; Theme-Skripte erfordern Theme API 1.1.
<!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>
Die Seitentyp-Datei legt fest, wo dynamische Bereiche erscheinen. Bereichskomponenten sind bereits gerenderte HTML-Zeichenfolgen. Fügen Sie sie daher mit | raw ein; gewöhnliche Werte werden standardmäßig escaped.
<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>
Komponente direkt rendern
Ein Designer kann eine registrierte Komponente direkt in einem Layout oder einer Seitentyp-Datei platzieren. Diese Position ist im Theme festgelegt und kann im Panel weder verschoben noch entfernt werden. Übergeben Sie ein Objekt über data:, einzelne Schemafelder oder beides; benannte Felder überschreiben gleichnamige Schlüssel aus data:.
{% 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"
%}
Der Typ muss ein in Anführungszeichen gesetztes Literal mit Namensraum sein. Direktes Rendering verwendet dasselbe Schema, dieselben Varianten, dieselbe Komponentendatei und dasselbe normalisierte component-Objekt wie eine Bereichsinstanz. Komponentendateien können keine anderen Komponenten rendern.
Assets: Verwenden Sie stets {{ 'css/theme.css' | asset_url }}. Eyivo liefert es aus dem aktiven Paket unter /theme-assets/<theme>/css/theme.css aus. Codieren Sie keinen anderen Theme-Namen oder Dateisystempfad fest ein.
Dokumentkopf, Routen und Oberflächenübersetzungen
Jedes Layout muss {% eyivo_head %} genau einmal rendern. Eyivo erzeugt damit Titel, Beschreibung, Robots-Angaben, Canonical-URL, hreflang, Open Graph und strukturierte Daten. Verwenden Sie routes.home, routes.contact, routes.catalog, routes.gallery und routes.videos statt fest codierter öffentlicher Pfade. Leiten Sie bearbeitbare URL-Einstellungen durch | localized_url, damit bekannte interne Pfade das aktive Sprachpräfix erhalten und externe URLs unverändert bleiben.
{{ 'Menu' | t }}
{{ theme.settings.header_cta_url | localized_url }}
Legen Sie bei Bedarf locales/<locale>.json-Dateien für vom Theme eingeführte Oberflächenbeschriftungen an. Die Suche erfolgt in dieser Reihenfolge: Core-Englisch, Core-Sprache, Theme-Englisch, Theme-Sprache. Gemeinsame Labels aus theme-core funktionieren daher ohne Kopie. Unternehmenstexte gehören in übersetzbare Inhalte, Komponentenfelder oder Theme-Einstellungen, nicht in Oberflächenwörterbücher.
Datei einer eigenen Komponente
<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>
Bei übersetzbaren Feldern wählt Eyivo vor dem Rendering die Sprache des Besuchers. Ein türkischer und ein englischer Besucher sehen somit dieselbe Komponentenstruktur mit unterschiedlichen Werten für component.data.heading.
7. Verfügbare sichere Liquid-Daten
Liquid erhält einfache, normalisierte Daten, keine Laravel- oder Datenbankmodelle. Fehlt ein Wert in dieser Tabelle, ist er in v1 nicht verfügbar.
| Objekt | Nützliche Felder | Typische Verwendung |
|---|---|---|
site | name, locale | Bezeichnung der Website und Ausgangssprache. |
company | name, legal_name, description, address, phone, email | Header-, Footer- und Kontaktinformationen. |
page | id, type, title, slug, body, settings | Allgemeiner Seiteninhalt und seitenspezifische Einstellungen. |
seo | title, description sowie Canonical-, Robots- und Open-Graph-Werte, sofern vorhanden | Dokumentkopf. |
navigation.main | Jeder Eintrag hat label, url und active | Website-Menü. |
locale | code, name, native_name, direction, is_default, home_url, available | Dokumentsprache, RTL-Richtung, lokalisierte Startseitenlinks und Sprachauswahl. |
routes | home, contact, catalog, gallery, videos, blog | System-URLs in der richtigen Sprache; Sprachpräfixe niemals selbst in Liquid zusammensetzen. |
blog | title, url, categories, category, posts, post, pagination | Kostenlose Blogübersicht, Kategoriearchiv und Artikelseiten. Beiträge bieten Titel, Zusammenfassung, URL, Datum, Kategorien und Titelbild. Nur blog.post.body_html enthält serverseitig erzeugtes, sicheres Artikel-HTML und sollte mit raw ausgegeben werden. Die Seitennavigation liefert previous_url und next_url. |
theme.settings | Ihre Manifesteinstellungen | Konfigurierte Farben, Abstände oder Gestaltungsoptionen verwenden. |
products/product | Übersetzter Titel, URL, Zusammenfassung und Inhalt | Seitentypen für Produktlisten und Produktdetails. |
galleries | Übersetzter Titel und Beschreibung | Galerie-Seitentyp. |
videos | title, description, source_type, source_url, playback_url, media | Verwenden Sie je nach source_type playback_url für hochgeladene Videodateien und source_url für externe HTTP(S)-Videos. Angehängte Bilder sind niemals Videoquellen. Verwenden Sie die Videodatei selbst nicht als Vorschaubild. |
component | id, type, variant, data | Nur innerhalb einer Komponentendatei. |
Beispiel für ein sprachsicheres Layout
<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 %}
Jeder Eintrag einer verfügbaren Sprache bietet außerdem label, direction, is_default, current und has_translation. Eyivo liefert nur gleichwertige veröffentlichte Übersetzungen. Themes müssen daher language.url verwenden, statt /en oder ein anderes Präfix selbst zu bilden.
Beispiel für ein einstellungsbasiertes Token: style="--brand: {{ theme.settings.primary_color }}". Die Einstellung muss zuerst in theme.json deklariert werden.
8. Komponenten: direkt und dynamisch
Komponenten haben einen Rendering-Vertrag mit zwei Möglichkeiten der Platzierung. Eine direkte Komponente wird vom Designer im Layout oder Seitentyp festgelegt. Eine dynamische Komponente wird als Instanz eines Seitenbereichs gespeichert und im Editor verwaltet. Dynamische Instanzen besitzen eine stabile ID, einen Typ mit Namensraum, Bereich, Position, optionale Variante, Daten und Übersetzungen. Die Position bestimmt nur die Reihenfolge, nicht die Identität.
Feldtypen
text, textarea, richtext, number, boolean, select, url, email, image, video, file, color, icon, page, product und repeater.
Namensräume
eyivo: wird aus theme-core/components geladen, theme: aus dem aktiven Theme; plugin: ist für künftige Plugins reserviert. Verwenden Sie in einem Bereich oder eyivo_component-Tag den exakten Typ mit Namensraum.
Universelle Komponente: Setzen Sie "universal": true in einer Komponentendefinition, um sie in allen Bereichen kompatibler Seitentypen zuzulassen. Sie benötigt weiterhin ein gültiges Schema und eine Liquid-Datei.
Gemeinsame Aktionslinks passen bekannte interne Pfade an die aktive Sprache an und behalten Abfrageparameter und Fragmente bei. Rich Text bewahrt sichere Formatierung in verschachtelten Editor-Containern. Leere Galeriebilder werden ausgelassen, Kartenbilder ohne Ziel sind keine Links, und Folien- sowie Suchbeschriftungen verwenden die Oberflächensprache des Besuchers.
9. Eigenes Website-CSS und Abschnittsklassen
Inhaber können einer Website eigenes CSS hinzufügen und Abschnitten Klassennamen geben (Design → Eigenes CSS). Schreiben Sie Themes so, dass das gut funktioniert:
- Ladereihenfolge: Das CSS der Website wird als
<style id="eyivo-custom-css">direkt vor</head>eingefügt, nach jedem Stylesheet des Themes. Behalten Sie</head>in Ihren Layouts und verlassen Sie sich nicht darauf, dass Ihr CSS zuletzt kommt. - Abschnittsklassen: Der Renderer fügt die Klassennamen eines Abschnitts dem ersten Element der Komponentenausgabe hinzu. Geben Sie jeder Komponentenvorlage daher ein Wurzelelement. Die Namen stehen auch als
{{ component.css_class }}bereit, wenn Sie sie anders platzieren möchten. - Stabile Ansatzpunkte: Behalten Sie die Klassen
body.theme-{key}undlayout-{name}sowie eine stabile Wurzelklasse pro Komponente bei, damit das CSS der Inhaber über Ihre Versionen hinweg funktioniert. Führen Sie Umbenennungen in den Versionshinweisen auf. - Hochgeladene Themes: erhalten ebenfalls eigenes Website-CSS. Alle Versionen eines hochgeladenen Themes teilen sich ein Stylesheet pro Website; es wird gelöscht, wenn die letzte Version des Themes auf einer Website außer Betrieb genommen oder gelöscht wird.
- Reservierte Namen: Das Klassenpräfix
eyivo-und die IDeyivo-custom-cssgehören der Plattform.
10. Theme-Skripte (Theme API 1.1)
Ein Theme kann eigenes JavaScript für Menüs, Slider, Tabs, Filter und ähnliche Funktionen mitbringen. Skripte sind optional: Jedes Theme muss auch ohne sie funktionieren, und Pakete mit Theme API 1.0 funktionieren unverändert ohne Skripte weiter.
- Angeben: Setzen Sie
"eyivo_theme_api": "1.1"und"capabilities": {"custom_javascript": true}intheme.jsonund legen Sie jede Datei direkt inassets/js/ab. Ein Paket mit.js-Dateien ohne diese Angabe wird abgelehnt. - Laden: Verwenden Sie für eine Paketdatei nur
<script src="{{ 'js/theme.js' | asset_url }}" defer></script>(odertype="module"). Tags laufen in der Reihenfolge, in der sie stehen. - Mehrere Dateien: Jede Datei wird einzeln geprüft und freigegeben, daher sind
importundexportnicht erlaubt. Teilen Sie Code über ein globales Objekt wiewindow.AcmeThemeund laden Sie die Datei, die es definiert, zuerst. - Grenzen: höchstens 20 Dateien, 100 KB pro Datei und 300 KB insgesamt, nur UTF-8-Text.
- In Vorlagen abgelehnt: Inline-Skripte, externe Skriptquellen,
on…=-Event-Handler-Attribute,javascript:-URLs sowie<iframe>-,<object>-,<embed>- und<base>-Elemente. - Nur lesbarer Code: Laden Sie Quellcode hoch, keinen minifizierten, gepackten oder codierten Code. Bundler können unminifizierte Ausgaben erzeugen.
- Status: Eine neue Version ist Prüfung ausstehend, bis die Prüfungen abgeschlossen sind, dann Freigegeben oder Abgelehnt. Nur eine freigegebene Version kann in der Vorschau angezeigt oder verwendet werden. Eine freigegebene Version kann später Gesperrt werden: Websites behalten das Theme ohne seine Skripte.
- Drei automatische Prüfungen nacheinander: lesbarer Code; Code-Regeln (kein
eval,new Function,document.write, keine Seitenweiterleitungen, keinwindow.open, keine Cookies oder Browserspeicher, kein WebAssembly, keine String-Timer, keine erzeugten Script- oder Frame-Elemente und keine über das Netzwerk gesendeten Formularwerte); und eine KI-Sicherheitsprüfung. Für diese Prüfung werden die Skripte und die Vorlagenzeilen, die sie laden, an einen KI-Dienst gesendet. Jeder Befund lehnt die Version mit Datei und Zeile ab.
Besteht: ein Menüschalter
(function () {
document.querySelectorAll('[data-menu-toggle]').forEach(function (button) {
button.addEventListener('click', function () {
document.body.classList.toggle('menu-open');
});
});
})();
Abgelehnt: sendet Formularwerte weg
form.addEventListener('submit', function () {
fetch('/collect', { method: 'POST', body: form.elements.email.value });
});
- Nur für den Inhaber: Freigegebene Skripte laufen nur auf Websites des Kontos, das das Theme hochgeladen hat, und nur solange die Plattform und der Inhaber der Website sie zulassen.
- Sicherheitsrichtlinie: Seiten mit Theme-Skripten erlauben genau die geprüften Dateien, festgelegt durch ihre SHA-256-Hashes, mit
connect-src 'self', ohne Frames oder Worker und ohneeval. Eine geänderte Datei erfordert eine neue Version. Bilder und Stylesheets dürfen weiterhin überhttps:geladen werden, deshalb lehnt die Prüfung auch Daten ab, die über Bild- oder Stylesheet-URLs gesendet werden. - Nach der Freigabe: Browser melden Versuche, die Richtlinie zu verletzen. Meldungen von drei Besuchern innerhalb von 24 Stunden sperren die Version; Missbrauchsmeldungen von drei Besuchern innerhalb von 7 Tagen schalten die Skripte auf dieser Website aus und prüfen die Version erneut. Inhaber erhalten eine E-Mail, wenn eine Version freigegeben, abgelehnt oder gesperrt wird.
- Plattformfunktionen: Skripte dürfen Formulare und ihre versteckten Felder, die Menschenprüfung, das Einwilligungsbanner, das Eyivo-Badge oder die Inhaberleiste nicht ersetzen, umschließen oder ausblenden.
11. Verfügbare Komponenten
Diese 30 gemeinsamen eyivo:-Komponenten bilden die vollständige v1-Bibliothek und stammen aus theme-core. Ein Theme kann zusätzlich eigene theme:-Komponenten deklarieren und implementieren.
Varianten: spliteditorialcenteredimmersive
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Ja | Ja | — |
summary |
textarea |
Nein | Ja | — |
image_url |
url |
Nein | Nein | — |
image_alt |
text |
Nein | Ja | — |
primary_label |
text |
Nein | Ja | — |
primary_url |
url |
Nein | Nein | — |
secondary_label |
text |
Nein | Ja | — |
secondary_url |
url |
Nein | Nein | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
body |
richtext |
Nein | Ja | — |
Varianten: image_leftimage_rightoverlap
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
body |
richtext |
Nein | Ja | — |
image_url |
url |
Nein | Nein | — |
image_alt |
text |
Nein | Ja | — |
badge |
text |
Nein | Ja | — |
button_label |
text |
Nein | Ja | — |
button_url |
url |
Nein | Nein | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
intro |
textarea |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
intro |
textarea |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
intro |
textarea |
Nein | Ja | — |
button_label |
text |
Nein | Ja | — |
button_url |
url |
Nein | Nein | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
text |
textarea |
Nein | Ja | — |
submit_label |
text |
Nein | Ja | — |
form_binding |
select |
Nein | Nein | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
heading |
text |
Nein | Ja | — |
text |
textarea |
Nein | Ja | — |
whatsapp_url |
url |
Nein | Nein | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
address |
textarea |
Nein | Ja | — |
map_url |
url |
Nein | Nein | — |
image_url |
url |
Nein | Nein | — |
image_alt |
text |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
heading |
text |
Nein | Ja | — |
placeholder |
text |
Nein | Ja | — |
categories |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
summary |
textarea |
Nein | Ja | — |
video_url |
url |
Nein | Nein | — |
poster_url |
url |
Nein | Nein | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
price |
text |
Nein | Ja | — |
period |
text |
Nein | Ja | — |
features |
repeater |
Nein | Ja | — |
button_label |
text |
Nein | Ja | — |
button_url |
url |
Nein | Nein | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
label |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
body |
textarea |
Nein | Ja | — |
button_label |
text |
Nein | Ja | — |
button_url |
url |
Nein | Nein | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
Die gemeinsame Komponente eyivo:faq behält in jedem Theme dieselben Felder und dasselbe Markup. Jedes Theme zeigt sie in seiner eigenen Schrift, seinem Abstand und seiner Farbe.
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
text |
textarea |
Nein | Ja | — |
button_label |
text |
Nein | Ja | — |
button_url |
url |
Nein | Nein | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
heading |
text |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
Varianten: keine
| Feld | Typ | Erforderlich | Übersetzbar | Optionen |
|---|---|---|---|---|
eyebrow |
text |
Nein | Ja | — |
heading |
text |
Nein | Ja | — |
intro |
textarea |
Nein | Ja | — |
items |
repeater |
Nein | Ja | — |
12. Formulare und Einsendungen
Forms API 1 bietet sieben freigegebene Verarbeiter. Themes gestalten Layout und Stil; Plugins definieren Schema, Validierung und Ablauf. Der Host übernimmt Speicherung, Verifizierung und Benachrichtigung.
| System-Plugin | Formulartyp |
|---|---|
eyivo/contact | Kontakt contact |
eyivo/quote-request | Angebotsanfrage quote_request |
eyivo/product-inquiry | Produktanfrage product_inquiry |
eyivo/appointment-request | Terminanfrage appointment |
eyivo/course-application | Kursbewerbung course_application |
eyivo/reservation-request | Reservierungsanfrage reservation |
eyivo/property-inquiry | Immobilienanfrage property_inquiry |
Ein Formular, mehrere Platzierungen
Die Einrichtung erzeugt eine beständige Standard-UUID je Website/Plugin/Typ. Weitere Platzierungen verwenden dieselbe Identität; benannte neue Formulare erhalten eigene UUIDs. Themewechsel und Neuinstallation erhalten den Verlauf. Themes verwenden portable Aliase; Kunden wählen gespeicherte Formulare statt UUIDs einzugeben.
{
"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"}
}
}
Kontaktvorlagen verwenden forms.contact, Formularabschnitte component.form. Ersetzen Sie form_preset durch form_binding. Rendern Sie die gelieferten Felder, Hinweise, action, CSRF, signierten form_context und verification_html. Nur erlaubte Darstellungsänderungen und Zusatzfelder sind zulässig; Pflichtvalidierung bleibt bestehen.
forms.contact · component.form · form_binding · form.fields · form.action · form.csrf_token · form.context · form.verification_html
Zwei Ansichten, ein Datensatz
Gemeinsamer Posteingang und Plugin-Listen/Details zeigen dieselben Datensätze. Formularpakete benötigen Panel API 2 mit submission-list/submission-detail und einem flachen Menülink. Panel API 1 bleibt unterstützt. Lesen markiert nicht automatisch als gelesen; Lese-, Archiv- und Ablaufstatus sind getrennt, Änderungen nutzen record_revision. Deaktivierung entfernt Plugin-Seiten; der gemeinsame Posteingang erhält historische Snapshots.
{"components":[{"type":"submission-list","form_type":"contact","detail_page":"submission"}]}
{"components":[{"type":"submission-detail","form_type":"contact","list_page":"submissions"}]}
Kundendaten und Berechtigungen
Formulardaten liegen in der Inhaltsdatenbank der Website und zählen zum vorhandenen max_db_bytes-Paketlimit. Keine zusätzliche Anzahl- oder Aufbewahrungsquote. Konfiguration bleibt in der Masterdatenbank mit 50 Feldern, 32 KB und drei Ebenen. Mitglieder lesen; Änderungen brauchen Eigentümer-/Verwaltungsrechte. Plugins erhalten keinen direkten Datenbankzugriff; PHP/Blade gelangt nicht zur App.
Geprüft speichern und benachrichtigen
Der Host prüft Kontext, Antworten und Human Verification und speichert Datensatz, Nutzung und Benachrichtigungsauftrag zusammen. Identische Versuche lassen sich 24 Stunden ohne Duplikate wiederholen. SMTP läuft anschließend mit Wiederholungen; Mailfehler löschen keine Einsendung. Ohne Formular-Empfänger gilt die Unternehmensadresse; ist keine der beiden Adressen gültig, wird ohne E-Mail gespeichert.
Alle ausgelieferten Themes verwenden diesen Vertrag. Alte contact-POSTs liefern 410; Kontaktseiten bleiben per GET erreichbar. Termin- und Reservierungsanfragen bestätigen keine Buchung. Drittanbieterprozessoren, Dateiuploads und beliebige externe Ziele gehören nicht dazu.
POST /__eyivo/forms/{UUID}/submissionsGET /__eyivo/forms/{UUID}/challenge
15. Seitenvorlagen und Core-Ersatzvorlagen
Es gibt zehn Standard-Seitentypen: home, page, contact, products, product, gallery, videos, blog, blog_category und blog_post. Ein Theme kann alle zehn oder nur einige bereitstellen; theme-core liefert für jeden nicht deklarierten Typ eine funktionierende Vorlage. Behalten Sie beim Überschreiben die Bereichsnamen und Formularbindungen der Core-Seitentypen bei, damit vorhandene Inhalte und registrierte Formulare nach einem Themewechsel weiter funktionieren.
16. Seiten-Heros
Unterseiten-Heros gibt es in zwei Formen. Ohne Bild verwenden Sie ein kompaktes Banner mit Brotkrumen, optionaler Dachzeile und dem Seitentitel. Mit Bild legen Sie Titel, Brotkrumen und Zusammenfassung über das Bild und eine kontrastierende Überlagerung, damit der Text auf jedem Foto lesbar bleibt, und spiegeln die Richtung der Überlagerung in Rechts-nach-links-Layouts.
17. Bilder, Galerien und Video
Halten Sie hochgeladene Bilder in begrenzten Rahmen: Katalogbilder behalten ihre Proportionen, Detailfotos dürfen den Rahmen mit einem zentrierten Zuschnitt füllen. Galerien können das Originalbild in einem Dialog öffnen, der sich mit Escape schließt und den Fokus an den Bildlink zurückgibt; ohne Skripte verlinken Sie das Original, damit es in einem neuen Tab öffnet. Bild-Slider sollten Touch, Schaltflächen, die Tastatur und reduzierte Bewegung unterstützen.
18. Rich Text und gemeinsame Darstellungsregeln
Die gemeinsame Komponente eyivo:rich_text akzeptiert vom Editor markierte und ältere HTML-Inhalte. Beide durchlaufen die Formatierungs-Positivliste der Plattform: Absätze, Überschriften, Listen und sichere Links erscheinen als Inhalt, während Skripte, Event-Handler und unsichere Links entfernt werden. Andere Textfelder bleiben maskiert. Geben Sie Rich Text mit den bereitgestellten Filtern aus, nicht mit eigener HTML-Verarbeitung.
19. Einleitungen, Orientierungsbereiche und lange Seiten
Ein Seitentyp kann den Hero mit einem optionalen Orientierungsbereich für Schnelllinks oder Eckdaten kombinieren; ist dieser Bereich leer, nutzt die Einleitung die volle Breite. Lange redaktionelle Seiten sollten eine lesbare Zeilenlänge und klare Abstände bei Überschriften behalten und können unterstützende Abschnitte wie eine Checkliste oder Notiz auf breiten Bildschirmen neben dem Artikel und auf kleinen danach zeigen. Jedes Layout muss auch ohne Skripte lesbar bleiben.
20. Bewegung und reduzierte Bewegung
Dekorative Bewegung ist optional. Beachten Sie prefers-reduced-motion bei Übergängen, Slidern und animierten Abschnitten, und pausieren Sie bewegte Inhalte, während der Besucher darüberfährt oder darin fokussiert.
21. Checkliste für ein vollständiges Theme
Ein vollständiges Theme stellt alle zehn Seitenvorlagen bereit, gestaltet alle gemeinsamen eyivo:-Komponenten, unterstützt jede portable Formularbindung über die vorhandenen Formular-Plugins und die Menschenprüfung und funktioniert auf Desktop, Mobilgeräten und in Rechts-nach-links-Layouts. Katalogfilter, Tabs, Slider und aufklappbare Navigation sind optionale Verbesserungen auf Inhalten, die auch ohne sie funktionieren.
22. Von der Aktivierung bis zur Veröffentlichung
- Vorlage installieren und aktivieren. Eyivo validiert das Paket, speichert Schlüssel und Version und stellt Einstellungen und Komponentenschemas in der App bereit.
- Seitentyp auswählen. Eyivo verwendet die passende Liquid-Datei und Bereichsdefinition des aktiven Themes, falls vorhanden, andernfalls den passenden Fallback aus
theme-core. - Zulässige Abschnitte hinzufügen. Die App bietet nur die unter
allowed_componentsaufgeführten Typen an. Sie speichert Text, Medienreferenzen und Übersetzungen für die gewählte Komponenteninstanz. - Sicher rendern. Eyivo bereitet Unternehmens-, Seiten-, SEO- und Navigationsdaten auf, rendert gespeicherte Bereichskomponenten sowie direkt platzierte Komponenten und anschließend Seitentyp und Layout des aktiven Themes.
- Veröffentlichen. Besucher erhalten Ihr HTML und CSS, aber keine Datenbankzugangsdaten, internen Modelle oder Anwendungscode.
- Mit einer neuen Version aktualisieren. Ein ZIP-Upload unter „Eigene Themes“ erstellt ein neues Theme. Um ein bestehendes Theme zu ändern, öffnen Sie es, erhöhen Sie
versionintheme.jsonund laden Sie eine neue Version hoch. Jede Website wechselt, wenn Sie die neue Version als Entwurf verwenden und veröffentlichen; die vorherige Version bleibt 30 Tage lang für ein Zurücksetzen verfügbar.
23. Validierung und häufige Fehler
| Wenn Sie Folgendes sehen … | Prüfen Sie zuerst |
|---|---|
| „Unsupported Eyivo Theme API version“ | Setzen Sie "eyivo_theme_api": "1.0". |
| Fehler wegen fehlendem Seitentyp, Layout oder fehlender Komponente | Für jeden vom Theme deklarierten Seitentyp und jede Komponente ist eine passende .liquid-Datei erforderlich. Das aktive Theme muss immer layouts/default.liquid bereitstellen; ausgelassene integrierte Seitentypen fallen auf Core zurück. |
| Komponente im Editor nicht verfügbar | Ihr Typ mit Namensraum muss in der Liste allowed_components des Bereichs stehen oder die Definition muss universell sein. |
| Unbekannte direkt platzierte Komponente | Verwenden Sie einen eyivo:-Typ aus dem gemeinsamen Katalog als Zeichenfolgenliteral oder deklarieren Sie eine passende theme:-Definition mit Liquid-Datei im aktiven Theme. |
| Feld wird abgelehnt | Deklarieren Sie es im Komponentenschema und verwenden Sie einen unterstützten Feldtyp. Für sprachspezifischen Text setzen Sie translatable: true. |
| Vorlage erscheint ohne Gestaltung | Verwenden Sie für CSS den Filter asset_url und prüfen Sie, ob die Datei unter assets/ liegt. |
| Paket wird wegen unsicherer Syntax abgelehnt | Entfernen Sie PHP/Blade, env, config, Datenbank-/HTTP-Aufrufe und Dateisystemzugriffe. Liquid dient nur der Darstellung. |
Skriptregeln: custom_javascript_declaration, script_file, script_tag, script_import, script_size | Folgen Sie Theme-Skripte. Prüfbefunde erscheinen mit Datei und Zeile auf der Seite der Version; beheben Sie sie und laden Sie eine neue Version hoch. |
24. Häufige Fragen
Kann ein Kunde ein neues Layout erstellen oder einen Hero-Abschnitt unter die Fußzeile verschieben?
Nein. Kunden können freigegebene Inhalte ändern und freigegebene Komponenten innerhalb eines Bereichs sortieren. Der Liquid-Seitentyp bestimmt das Layout.
Kann ein Designer eine Komponente ohne bearbeitbaren Bereich verwenden?
Ja. Verwenden Sie eyivo_component in einem Layout oder Seitentyp. Verwenden Sie einen Bereich, wenn der Website-Inhaber die Komponenteninstanz und ihre Reihenfolge steuern soll.
Muss ein Theme jeden Seitentyp implementieren?
Jedes Theme muss Blogs unterstützen. Die integrierten Typen blog, blog_category und blog_post können die passenden Definitionen und Liquid-Dateien aus theme-core innerhalb des Layouts des aktiven Themes verwenden. Deklarieren Sie einen Typ nur mit passender Überschreibungsdatei. Bestehende Theme-Pakete bleiben kompatibel. Blogrouten verwenden /blog, /blog/category/{slug} und /blog/{slug}, gegebenenfalls mit Eyivos Sprachpräfix. Behalten Sie eyivo_head für sichere Metadaten sowie responsive Bloggestaltung und begrenzte Bildkarten bei.
Kann ein Theme eine Seite abfragen, eine API aufrufen oder eine Umgebungsvariable lesen?
Nein. Daten werden bewusst als sichere Objekte übergeben. Das hält Themes portabel, sicher und vorhersehbar.
Wie veröffentliche ich ein Update?
Veröffentlichen Sie eine neue semantische Theme-Version. Ändern Sie ein veröffentlichtes Release nicht unbemerkt; Websites sollten ausdrücklich auf eine neue Version wechseln.
Wo sollten Bilder liegen?
Verwenden Sie in Komponentendaten eine Eyivo-Medien-URL oder ein Paket-Asset über asset_url. Verwenden Sie keine beliebigen Dateisystempfade des Servers.
25. Änderungsprotokoll
- 31. Oktober 2026. Theme API 1.1: Themes können geprüftes JavaScript in
assets/js/mit der Fähigkeitcustom_javascriptmitbringen. Neue Versionen werden automatisch geprüft und zeigen Prüfung ausstehend, Freigegeben, Abgelehnt oder Gesperrt. Pakete mit Theme API 1.0 bleiben unverändert. - 31. Oktober 2026. Inhaber können eigenes Website-CSS hinzufügen, das nach Ihren Stylesheets geladen wird, und Abschnitten Klassennamen geben, die dem ersten Element jeder Komponente hinzugefügt werden und als
{{ component.css_class }}verfügbar sind. Siehe Eigenes Website-CSS und Abschnittsklassen. - 31. Oktober 2026. Demo-Medien in
demo.jsonmüssen einen erlaubtenhttps-Host (cdn.eyivo.comoderimages.pexels.com) oder eine unterassets/mitgelieferte Datei verwenden. Eyivo erkennt den Typ jeder Datei an ihrem Inhalt. Dies ist eine Sicherheitskorrektur; die Theme API bleibt bei 1.0. - 30. Oktober 2026. Eyivo vergibt für jedes hochgeladene Theme eine eigene ID, und
keyintheme.jsonist optional. Laden Sie Änderungen auf der Seite des Themes als neue Version hoch. Das Beispiel-Repository enthält das Theme im Ordnersample-theme/, den Sie als ZIP hochladen. Das Paketbeispiel zeigt keinassets/js/mehr, da Uploads mit Theme API 1.0 keine JavaScript-Dateien enthalten dürfen.