ospo / module-orangecat
Ergänzungen zur Orangecat-B2B-Suite: deutsche Übersetzung, Firmenregistrierung je Website, Basiswährung im Kreditrahmen
Package info
codeberg.org/OSPO/magento2-module-orangecat
Type:magento2-module
pkg:composer/ospo/module-orangecat
Requires
- php: ~8.3.0||~8.4.0
- magento/framework: *
- magento/module-customer: *
- magento/module-directory: *
- orangecat/core: *
- orangecat/module-company: *
- orangecat/module-company-credit: *
- orangecat/module-company-sales-rep: *
- orangecat/module-prices: *
- orangecat/module-prices-company: *
- orangecat/module-prices-list: *
- orangecat/module-product-lists: *
- orangecat/module-purchase-order: *
- orangecat/module-quickorder: *
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Ergänzungen zur freien B2B-Suite von Orangecat (orangecat/module-company und folgende, OSL-3.0) für deutsche Shops und gemischte Shops mit Endkunden- und Geschäftskunden-Website.
Entstanden im OSPO-Projekt.
- Firmenregistrierung je Website: Orangecat ersetzt auf der Anmeldeseite den Kasten „Neue Kunden" durch „Firmenkonto" und hängt im Kontomenü einen Link zur Firmenregistrierung an, auf jeder Website. Wo die Einstellung „Firmenregistrierung anbieten" aus ist, zeigt die Anmeldeseite wieder den Standardkasten und der Link entfällt.
- Deutsche Übersetzung der Orangecat-Suite: Verwaltung (Menü, Firmen, Preislisten, Kreditrahmen, Einstellungen) und Shop (Firmenregistrierung, Firmenbenutzer, Bestellanforderungen, Listen, Schnellbestellung). Orangecat selbst bringt nur Englisch und Spanisch mit. Begriffe, die das deutsche Sprachpaket für Mage-OS schon übersetzt, stehen nicht noch einmal in der Datei.
- Basiswährung im Kreditrahmen: Im Firmenformular der Verwaltung hat das Feld „Währung des Kreditrahmens" bei Orangecat keine Vorgabe. Die Auswahlliste zeigt dann ihren ersten Eintrag (Afghanischer Afghani) und speichert ihn mit der Firma. Das Modul gibt die Basiswährung des Shops vor, solange für die Firma noch keine Währung gespeichert oder noch kein Kreditrahmen eingeräumt ist (Höhe 0).
- AGB-Link der Firmenregistrierung: Orangecat verlinkt im Registrierungsformular fest die eigene Seite
company-terms, die es mit einem englischen Platzhaltertext anlegt. Der Link zeigt jetzt auf die AGB-Seite des Shops (Vorgabeagb, die Seite von MageSetup). - Menüeintrag in der Verwaltung: Im Admin-Theme von Mage-OS 4 fällt der Eintrag „Orangecat" samt Icon auf wenige Pixel zusammen. Eine CSS-Regel gibt ihm die Höhe der übrigen Einträge.
Umsetzung: Plugins auf Magento\Customer\Block\Form\Login\Info (Vorlage zurück auf Magento_Customer::newcustomer.phtml) und Orangecat\Company\Block\Account\CompanyRegisterLink (leere Ausgabe). Die Währungsvorgabe ist ein Plugin auf Orangecat\Company\Ui\Component\Form\Company\DataProvider (Daten und Vorgabe des Feldes), die Übersetzung liegt in i18n/de_DE.csv, die CSS-Regel in view/adminhtml/web/css/source/_module.less.
Nicht abgedeckt: Bei Firmen mit eingeräumtem Kreditrahmen bleibt eine falsch gespeicherte Währung stehen; sie lässt sich im Firmenformular umstellen. Ohne Kreditrahmen zeigt das Formular die Basiswährung und speichert sie beim nächsten Sichern. Die E-Mail-Vorlagen von Orangecat sind nur so weit deutsch, wie sie übersetzbare Texte verwenden.
Die Platzhalterseite company-terms bleibt bestehen und erreichbar; wer sie nicht braucht, deaktiviert sie unter Inhalt -> Seiten.
Außerdem nicht abgedeckt: Die Seite /company/account/create bleibt auf allen Websites erreichbar. Im gemischten OSPO-Shop leitet nginx sie auf der Endkunden-Website auf die Geschäftskunden-Website um.
Konfiguration
Im Backend unter Shops -> Konfiguration -> OSPO -> B2B-Firmenkonten, je Website oder Store-Ansicht, oder per bin/magento config:set:
| Pfad | Standard | Bedeutung |
|---|---|---|
ospo_orangecat/general/company_registration | 1 | Firmenregistrierung auf Anmeldeseite und im Kontomenü anbieten |
ospo_orangecat/general/terms_page | agb | URL-Schlüssel der Seite hinter dem AGB-Link der Firmenregistrierung; leer bleibt es bei company-terms |
Installation
composer require ospo/module-orangecat
bin/magento module:enable Ospo_Orangecat
bin/magento setup:upgrade
Im Production-Modus danach bin/magento setup:di:compile und bin/magento setup:static-content:deploy.
Nach einem Update auf 1.1.0 baut setup:static-content:deploy die Stile der Verwaltung nur neu, wenn die vorverarbeiteten Dateien weg sind: vorher var/view_preprocessed/pub/static/adminhtml löschen.
Voraussetzung ist die ganze Orangecat-Suite (zehn Pakete, siehe composer.json), weil das Modul Texte aus allen übersetzt.
Lizenz: OSL-3.0, wie Magento Open Source, Mage-OS und die Orangecat-Module.