Magento 2 Kategorie-Code als stabile Kennung
SKU: CATEGORYCODE1
- Eindeutiger Code je Kategorie, unabhängig von ID und URL-Key
- Import und ERP: stabile Zuordnung über Umgebungen hinweg
- Layout-Handle und Body-Klasse je Code für gezieltes Styling
- API-Abfrage per Code, ohne ID-Tabellen zu pflegen
Einmaliger Kauf · inkl. 12 Monate Updates · zzgl. MwSt.
Magento 2 Kategorie-Code: eine stabile Kennung statt wechselnder IDs
In Magento 2 erkennen Sie eine Kategorie an ihrer numerischen ID. Diese ID unterscheidet sich zwischen Entwicklungs-, Staging- und Live-System und ändert sich, sobald ein Baum neu aufgebaut wird. Auch der URL-Key taugt nicht als Schlüssel, weil er aus SEO-Gründen umbenannt wird. Wer Kategorien in Importen, im ERP oder in Layout-Regeln anspricht, braucht eine Kennung, die bleibt. Der Magento 2 Kategorie-Code von Mironsoft liefert genau das.
Mironsoft Category Code ist eine Magento 2 Erweiterung, die jeder Kategorie ein eindeutiges Kürzel gibt, etwa WERKZEUG-AKKU. Der Code wird validiert, ist per API abfragbar und erzeugt ein Layout-Handle sowie eine Body-Klasse. Mironsoft richtet das Modul in Ihrem Shop ein.
Funktionen des Magento 2 Kategorie-Code auf einen Blick
Ein kurzes, lesbares Kürzel verbindet Shop, ERP, Import und Layout, ohne dass jemand IDs auswendig kennen muss.
Eindeutiger Code
Ein Kürzel je Kategorie, global eindeutig und im Kategorie-Formular direkt pflegbar.
Validierung
Format und Eindeutigkeit werden beim Speichern geprüft, doppelte Codes sind ausgeschlossen.
Sperre nach dem Speichern
Optional lässt sich der Code nach dem ersten Speichern sperren, damit ERP-Zuordnungen stabil bleiben.
Layout-Handle
Je Code entsteht ein Layout-Handle, damit Layout-XML genau eine Kategorie anspricht.
API-Abfrage per Code
Der Code ist ein REST-Erweiterungsattribut und lässt sich direkt abfragen.
Import und Export
Der Code taugt als Schlüsselspalte, um Kategorien eindeutig zuzuordnen.
Magento 2 Kategorie-Code im Formular pflegen und prüfen
Im Kategorie-Formular erscheint ein Feld „Kategorie-Code“. Erlaubt sind Großbuchstaben, Ziffern, Unterstrich und Bindestrich, das Muster lässt sich in der Konfiguration anpassen. Beim Speichern prüft das Modul, ob der Code bereits vergeben ist, und meldet den Konflikt mit der betroffenen Kategorie.
- Format per Muster (Regex) einstellbar
- Eindeutigkeit global geprüft, mit klarer Fehlermeldung
- Vorschlag aus dem Namen optional
Magento 2 Kategorie-Code für Import, ERP und Staging-Abgleich
Weil der Code nicht von der Datenbank vergeben wird, ist er auf Entwicklungs-, Staging- und Live-System derselbe. Importdateien und ERP-Schnittstellen verweisen deshalb auf den Code statt auf eine ID. Sperren Sie den Code nach dem ersten Speichern, kann ihn niemand versehentlich ändern und damit eine Zuordnung zerstören.
- Gleicher Code in allen Umgebungen
- Sperre schützt vor versehentlicher Änderung
- Als Schlüsselspalte im Kategorie-Import/-Export nutzbar
Magento 2 Kategorie-Code als Layout-Handle und Body-Klasse
Für jeden Code legt das Modul ein Layout-Handle an, beispielsweise catalog_category_view_code_werkzeug_akku. Damit steuern Sie Layout-XML für genau eine Kategorie, ohne sich auf eine ID zu verlassen. Zusätzlich erhält das body-Tag eine CSS-Klasse, über die Tailwind- oder Template-Anpassungen gezielt greifen.
- Handle-Schema: catalog_category_view_code_<code>
- Body-Klasse category-code-<code>
- Keine ID-Abhängigkeit in Layout-Dateien
Kategorien per Magento 2 Kategorie-Code über die API finden
Der Code erscheint als Erweiterungsattribut an der Kategorie in der REST-API und lässt sich über einen eigenen Endpunkt und einen Service-Contract (getByCode) abfragen. Eigene Module und Schnittstellen holen so die passende Kategorie, ohne vorher eine Tabelle mit IDs zu pflegen.
- Erweiterungsattribut an der Kategorie
- Abfrage per Code über Endpunkt und Service-Contract
- Bestehende Integrations-Berechtigungen gelten
Anwendungsfälle: wofür sich der Magento 2 Kategorie-Code lohnt
ERP und Warenwirtschaft
Warengruppen des ERP werden über den Code den Magento-Kategorien zugeordnet, nicht über Datenbank-IDs.
Staging und Live
Layout- und Import-Regeln bleiben auf allen Systemen identisch, weil der Code überall derselbe ist.
Individuelle Kategorieseiten
Eine Kategorie bekommt ein eigenes Layout, ohne dass die ID im Layout-XML steht.
Produktfeeds und Tracking
Marktplatz- oder Analytics-Zuordnungen verweisen auf den Code und überstehen Umbenennungen von Name und URL.
ID und URL-Key vs. Magento 2 Kategorie-Code
So unterscheidet sich der Code von den Bordmitteln.
| Kriterium | Ohne Modul | Mit Modul |
|---|---|---|
| Stabilität | ID wechselt je Umgebung | Code bleibt gleich |
| Umbenennung | URL-Key ändert sich | Code bleibt unverändert |
| Lesbarkeit | Zahl ohne Bedeutung | Sprechendes Kürzel |
| Layout-Regeln | Nur über ID | Handle je Code |
| API-Abfrage | Über ID oder Suche | Direkt per Code |
| Eindeutigkeit | Durch Datenbank | Durch Validierung im Formular |
Einrichtung des Magento 2 Kategorie-Code in vier Schritten
Abstimmung
Wir legen das Code-Schema fest, etwa Großbuchstaben mit Bindestrich, und klären die Sperrregel.
Einrichtung
Mironsoft installiert das Modul und vergibt die Codes für bestehende Kategorien.
Übergabe
Ihr Team pflegt neue Codes selbst, eine kurze Einweisung ist enthalten.
Kein Download, sondern persönliche Einrichtung
Mironsoft Category Code ist hier nicht als fertige Download-Datei zum Selbst-Installieren gelistet. Der Kauf ist eine Beauftragung: Wir melden uns nach dem Kauf bei Ihnen, installieren das Modul in Ihrem Shop und stimmen gemeinsam ab, das Code-Schema, ob Codes nach dem Speichern gesperrt werden und welche Importe oder Schnittstellen den Magento 2 Kategorie-Code verwenden.
Häufige Fragen
Alles Wichtige zu Format, Eindeutigkeit und Ablauf des Kaufs.
Wie kann ich in Magento 2 Kategorien eindeutig kennzeichnen?
Warum reicht die Kategorie-ID in Magento 2 nicht aus?
Welche Zeichen sind im Code erlaubt?
Kann ich den Code nachträglich ändern?
Wie spreche ich eine Kategorie in Layout-XML über den Code an?
Lässt sich der Code per REST-API abrufen?
Funktioniert der Magento 2 Kategorie-Code mit Hyvä?
Verändert das Modul Kategorie-URLs?
Gilt der Code pro Store View?
Kann ich das Modul selbst herunterladen und installieren?
Magento 2 Kategorie-Code – Mironsoft Category Code