bin/magento config:set catalog/search/opensearch_server_hostname localhost
bin/magento config:set catalog/search/opensearch_server_port 9200 --> 9200 durch Ihren Port ersetzen
bin/magento config:set catalog/search/engine opensearch

Der letzte Befehl ist dabei optional und nur notwendig, wenn Opensearch bisher nicht als Suchengine konfiguriert war.

Führen Sie den folgenden Befehl aus, um Ihre Bilder mit der Magento 2 Mediengalerie zu synchronisieren.

php bin/magento media-gallery:sync

Gerade bei bestehenden Child Themes ist es deshalb sinnvoll, die vorhandene Tailwind Konfiguration gezielt in die neue Struktur zu überführen, da es sonst zu Layoutfehlern kommen kann.

1. Upgrade Helper installieren

Damit der Befehl update-to-tailwind-v4.js zur Verfügung steht, müssen die Hyvä Upgrade Helper Tools zuerst per Composer installiert werden.

composer require --dev hyva-themes/upgrade-helper-tools:dev-main

2. Neue Tailwind Struktur ins Theme übernehmen

Nach der Installation steht das Script nun zur Verfügung. Damit wird der bisherige Tailwind Ordner gesichert und die neue Struktur ins Theme kopiert.

./vendor/bin/update-to-tailwind-v4.js app/design/frontend/Vendor/theme

Falls der Wrapper unter vendor/bin nicht vorhanden ist, kann das Script auch direkt aus dem Paket aufgerufen werden:

./vendor/hyva-themes/upgrade-helper-tools/bin/update-to-tailwind-v4.js app/design/frontend/Vendor/theme

Danach liegt im Theme ein neuer web/tailwind-Ordner vor. Der bisherige Stand wird zusätzlich als Backup abgelegt.

3. hyva.config.json prüfen

In der hyva.config.json wird unter anderem festgelegt, welche Quellen für Tailwind berücksichtigt werden. Bei einem Child Theme sollte dort auch das Parent Theme eingebunden sein.

{
  "tailwind": {
    "include": [
      {
        "src": "vendor/hyva-themes/magento2-default-theme"
      }
    ],
    "exclude": []
  }
}

Wenn dort noch ein Beispielwert wie example_src steht, muss dieser durch src ersetzt werden.

4. tailwind-source.css als zentrale Datei verwenden

Die eigentliche Build Datei ist jetzt tailwind-source.css. Dort werden die Tailwind Basis, die Theme Quellen und die generierten Dateien eingebunden.

@import "@hyva-themes/hyva-modules/css";
@import "tailwindcss" source(none);

@source "../../**/*.phtml";
@source "../../**/*.xml";

@import "./generated/hyva-source.css";
@import "./generated/hyva-tokens.css";

Zusätzliche Theme Werte wie Fonts, Container oder eigene Utilities können ebenfalls dort ergänzt werden.

5. Eigene Werte aus dem bisherigen Theme übernehmen

Bestehende Child Themes enthalten oft eigene Farben, Fonts, Container Abstände oder Hilfsklassen. Diese Werte müssen nach dem Update an die neue Struktur angepasst werden.

Je nach Inhalt landen sie entweder in der hyva.config.json oder direkt in der tailwind-source.css.

Ein einfaches Beispiel für eigene Ergänzungen in der CSS Datei:

@theme {
    --font-sans: "Segoe UI", "Helvetica Neue", "Arial", "sans-serif";
}

@utility container {
    margin-inline: auto;
    padding-inline: 1.5rem;
}

6. Pakete im Tailwind Ordner aktualisieren

Im Theme Ordner unter web/tailwind sollten die aktuellen Pakete für Hyvä und Tailwind 4 installiert sein.

cd app/design/frontend/Vendor/theme/web/tailwind
npm install
npm install @hyva-themes/hyva-modules@latest tailwindcss@latest @tailwindcss/cli@latest

7. Build ausführen

Danach kann der Build wie gewohnt über den Tailwind Ordner des Themes laufen.

npm --prefix app/design/frontend/Vendor/theme/web/tailwind run build

Je nach Setup kann es zusätzlich sinnvoll sein, die Hyvä Dateien einmal neu zu generieren:

bin/magento hyva:config:generate
cd app/design/frontend/Vendor/theme/web/tailwind
npx hyva-sources
npx hyva-tokens
npm run build

Fazit

Für das Update eines Hyvä Themes von einer Version < 1.4 sind vor allem diese Punkte wichtig:

• die neue Tailwind Struktur ins Child Theme übernehmen
• hyva.config.json korrekt setzen
• tailwind-source.css als zentrale Build Datei nutzen
• bestehende Theme Werte sauber in die neue Struktur übertragen

Wer bereits ein eigenes Child Theme mit angepasster Tailwind Konfiguration im Einsatz hat, sollte diese Umstellung bewusst durchführen und nicht nur die neuen Dateien kopieren. Dann lässt sich das Theme sauber unter Hyvä 1.4.x weiterführen.

An die Darstellung und Implementierung des Widerrufsprozesses werden unterschiedliche Anforderungen gestellt, so muss der Widerruf beispielsweise explizit ohne Login möglich sein und nach der Übermittlung muss der Händler unverzüglich eine Eingangsbestätigung per E-Mail senden. Neben diesen Anforderungen gibt es einige weitere wichtige Details, welche beachtet werden sollten.

Verstöße können als Ordnungswidrigkeit mit bis zu 50.000 Euro bzw. bei großen Unternehmen bis zu 4 % des Jahresumsatzes geahndet werden.

Ich helfe Ihnen schnell und unkompliziert bei der Implementierung in Ihrem Magento Shop, egal ob Sie Hyvä oder ein anderes Frontend nutzen. Melden Sie sich gerne, dann integrieren wir den Widerrufsbutton fristgerecht in Ihren Magento Shop.

Die Integration ist in Magento 1 sowie in Magento 2 möglich.

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Acl/etc/acl.xsd">
    <acl>
        <resources>
            <resource id="Magento_Backend::admin">
                <resource id="Magento_Backend::stores">
                    <resource id="Vendor_Whatever::config" title="Foobar" sortOrder="90" />
                </resource>
            </resource>
        </resources>
    </acl>
</config>

Hier wurde der title “Foobar” vergeben, was nun dazu führt, dass die Fehlermeldung verschwindet und Sie den Adminbereich Ihres Magento 2 Shops wieder ganz normal nutzen können.

Die Ursache liegt darin, dass in neuen Versionen von Hyvä der buil-prod Befehl ersetzt wurde. Hyvä 1.1.x nutzt noch build-prod, spätere Hyvä Versionen nutzen nur noch build. Der npm build Befehl könnte also so aussehen:

npm --prefix app/design/frontend/Vendor/hyva_child/web/tailwind run build

Fügen Sie diesen Code einfach innerhalb des tocart-form Formulares im Template Magento_Catalog/templates/product/list.phtml Ihres Child Themes ein.

<input type="hidden" name="qty" value="1" />

Nun sollte nach einem erneuten Deployment und erneutem Laden der Kategorieseite der Wert 1 im Warenkorb landen und nicht mehr die voreingestellte Mindestmenge. Sie können den gewünschten Wert so beliebig und unkompliziert setzen.

Sie können nun beispielsweise den Namen einer PageBuilder Vorlage mit der folgenden SQL Query anpassen:

UPDATE pagebuilder_template SET name='Whatever' WHERE template_id='1';

Wenn Sie eine PageBuilder Vorlage komplett löschen möchten, hilft die folgende SQL Query:

DELETE FROM pagebuilder_template WHERE template_id='3';

Das Löschen einer Vorlage ist auch direkt aus dem Magento 2 Adminbereich möglich. Sie finden alle PageBuilder Vorlagen unter Inhalt Vorlagen.

php bin/magento admin:user:create --admin-user='nutzername' --admin-password='passwort123' --admin-email='nutzer@example.com' --admin-firstname='Ihr' --admin-lastname='Nutzer'

Nach Ausführung dieses Befehls (Nutzername und Passwort bitte ändern vor der Ausführung) können Sie sich nun wieder ganz normal in Ihren Magento 2 Adminbereich einloggen. Sie können den alten Nuzter nun z.B. löschen, oder ein neues Passwort vergeben.

rm -rf var/view_preprocessed/*
rm -rf pub/static/*
bin/magento setup:static-content:deploy de_DE en_US -f //(evtl. weitere Sprachen hinzufügen)
bin/magento cache:clean