- poprawiono regex-y do czyszczenia mark-upu Json LD z plików modułów
Die wichtigsten Funktionen des Moduls
Ein JSON-LD-Graph und Kontrolle über veröffentlichte Entitäten
- Ein JSON-LD-Dokument. Das Modul fügt die aktivierten Daten zu einem Schema.org-Graphen mit
@contextund@graphzusammen, anstatt für jeden Datentyp ein separates JSON-Fragment zu erstellen. - Verknüpfungen über
@id. Entitäten können sich gegenseitig referenzieren, zum Beispiel ein Produktangebot auf die Organisation und eine Seite auf die Website und die Breadcrumb-Navigation. - Generierung auf PHP-Seite. Das JSON wird von der Modulklasse aufgebaut und mit
json_encode()kodiert; das Template erhält das fertige Markup. - Rendering nach dem Aufbau der Seite. Das Modul verwendet
displayFooter, um Zugriff auf die Daten der sichtbaren Produktliste sowie der an Smarty übergebenen FAQ-Fragen zu haben. - Unabhängige Schalter. Organization, LocalBusiness, Product, BreadcrumbList, WebSite, WebPage, CheckoutPage, ContactPage, SearchResultsPage, Article, CollectionPage und FAQPage werden unabhängig voneinander aktiviert.
Organization, OnlineStore und Geschäftsdaten
- Organisationstyp. Die Entität kann als
OnlineStore,OnlineBusiness,Organization,CorporationoderStorekonfiguriert werden. - Quelle der Unternehmensdaten. Name, Adresse und Kontakt können aus den PrestaShop-Shop-Einstellungen oder aus im Modul manuell eingegebenen Werten übernommen werden.
- Identifikation des Unternehmens. Das Modul unterstützt unter anderem den rechtlichen Namen, alternative Namen, Beschreibung, Logo, Bilder, Adresse, E-Mail, Telefon,
sameAs-Profile, Steuernummer, VAT ID, ISO-6523-Code, GLN und Gründungsdatum — sofern die Daten ergänzt werden. - Kontaktstellen. In der erweiterten Konfiguration können wiederholbare Kontaktkanäle mit Kontaktart, Telefon, E-Mail, Sprachen und Betreuungsgebiet hinzugefügt werden.
- Geschäftsbedingungen. Der Organisation kann eine Konfiguration für Rückgaberichtlinien, Lieferdienste und Stufen des Treueprogramms zugewiesen werden. Die Daten werden ausschließlich dann veröffentlicht, wenn der Administrator vollständige, wahrheitsgemäße Werte angibt.
LocalBusiness für stationäre Standorte und lokalen Service
- Ein Standort oder mehrere Filialen. Die Basisfelder erstellen eine standardmäßige LocalBusiness-Entität, und eine wiederholbare Filialliste ermöglicht die Veröffentlichung separater Entitäten mit stabilen Kennungen.
- Adresse und lokale Daten. Für einen Standort können Geschäftstyp, Name, Marke, Adresse, Telefon, E-Mail, Website-Adresse, Filialcode, Preisspanne, bedientes Gebiet, akzeptierte Zahlungsmittel und Währungen angegeben werden.
- Koordinaten und Karte. Es stehen Felder für Breiten- und Längengrad, Kartenadresse und Bildadressen zur Verfügung.
- Standard- und Sonderöffnungszeiten. Das Modul unterstützt Öffnungszeiten nach Wochentagen sowie Zeilen mit Datumsbereichen für saisonale oder außergewöhnliche Zeiten.
- Adressvalidierung. Bei einem manuell konfigurierten aktiven Standort sind vollständige Adressdaten erforderlich: Straße, Stadt, Postleitzahl und zweistelliger ISO-Ländercode.
Produkt, Angebot und Varianten
- Product oder ProductGroup. Ein Produkt ohne verfügbare Varianten erhält eine
Product-Entität; ein Produkt mit verfügbaren Kombinationen kann alsProductGroupmithasVariant-Entitäten beschrieben werden. - Aus PrestaShop übernommene Daten. Das Modul verwendet Name, Beschreibung, Kategorie, Bilder, SKU-Referenz, MPN, EAN-13, UPC, Hersteller, Gewicht, Abmessungen, Preis, Währung, Verfügbarkeit und Produktzustand — sofern verfügbar und anwendbar.
- Angebote abhängig von der Kaufmöglichkeit. Die
Offer-Entität wird nur hinzugefügt, wenn der Katalog nicht im Katalogmodus ist, das Produkt bestellt werden kann und der Preis auf der Produktseite sichtbar ist. - Varianten mit eigener Adresse. Jede veröffentlichte Variante erhält eine Verknüpfung mit der PrestaShop-Kombination; wenn der URL-Generator eine einzige kanonische Adresse zurückgibt, fügt das Modul den Parameter
id_product_attributehinzu. - Zuordnung von Variantenmerkmalen. Attributgruppen können Eigenschaften wie Farbe oder Größe zugeordnet werden, und die übrigen Variantenachsen werden als
additionalPropertymit dem öffentlichen Attributnamen übergeben. - Erweiternde Produktdaten. Die erweiterte Konfiguration ermöglicht die Zuordnung von Produktmerkmalen zu Eigenschaften, Material, Muster, Zertifikaten und Energiedaten. Das Modul übergibt auch den Grundpreis, wenn die Daten zu Einheit und Faktor im Produkt dessen Berechnung ermöglichen.
- GTIN und Bilder. Der Builder prüft die Korrektheit der GTIN-Länge und Prüfziffer, und die Produktbilddaten umfassen verfügbare Produktbilder, nicht nur das Titelbild.
- Grenze der Variantenanzahl. Das Standardlimit beträgt 100 Kombinationen pro Shop, und das absolute technische Limit liegt bei 250. Wird dieses überschritten, erstellt das Modul keine umfangreiche
ProductGroupmit allen Varianten, um die Seitenausgabe nicht unnötig aufzublähen. - Lieferung und Rückgaben. Versanddetails und Rückgaberichtlinien können auf Organisationsebene übergeben oder eine separate Überschreibung für Produktangebote aktiviert werden.
Seiten, Inhalte und sichtbare Elemente des Shops
- BreadcrumbList. Das Modul erstellt Breadcrumbs aus der sichtbaren Navigation, und wenn diese nicht verfügbar sind, verwendet es die Unterstützung für Produkt-, Kategorie-, Hersteller-, Lieferanten-, CMS- und erkannte Blogseiten.
- WebSite auf der Startseite. Die
WebSite-Entität wird nach ihrer Aktivierung für die Startseite des Shops veröffentlicht. - WebPage und spezielle Seiten. Das Modul erstellt
WebPagemit einem Typ, der an den aktuellen Controller angepasst wird, und separate Schalter unterstützenCheckoutPage,ContactPageundSearchResultsPage. - Article. Die Integration betrifft Beiträge aus
ph_simpleblogundsmartblog; sie kann Titel, Beschreibung, Bild, Daten und den auf der Seite sichtbaren Autor übergeben. - CollectionPage. Für Listen von Kategorien, Herstellern, Lieferanten, Neuheiten, Sonderangeboten und Bestsellern erstellt das Modul eine Liste sichtbarer Produkte. Das Positionslimit ist von 1 bis 200 konfigurierbar, standardmäßig 50.
- FAQPage aus für den Nutzer sichtbaren Inhalten. Fragen und Antworten werden ausschließlich aus den von der aktuell gerenderten Seite unter den Schlüsseln
pd_faqs,product_faqsoderfaqsübergebenen Daten übernommen.
Administrationsbereich und Datenpflege
- Arbeitsbereich und Vorschau. Das Modulpanel gruppiert die Schema-Einstellungen und enthält eine Vorschau des auf Basis der aktuellen Konfiguration generierten JSON-LD.
- Speicherkontrolle. Das Modul validiert unter anderem die erforderlichen Daten der manuellen Organisation, E-Mails, Ländercodes, HTTP(S)-Adressen, Zahlenbereiche, Uhrzeiten, wiederholbare Zeilen sowie die Konfiguration von Lieferung und Rückgaben.
- Multistore. Die Konfiguration wird im Shop-Kontext gespeichert; jeder Shop kann eigene Unternehmens-, Standort- und Geschäftsdaten veröffentlichen.
- Entfernung älterer JSON-LD-Daten. Die Werkzeuge des Moduls können eine Sicherungskopie erstellen und erkannte ältere JSON-LD-Fragmente aus Theme- oder Moduldateien entfernen und anschließend ausgewählte Daten aus dem Archiv wiederherstellen.
Bedeutung für SEO und GEO — ohne unbegründete Versprechen
JSON-LD übermittelt Suchmaschinen und datenverarbeitenden Systemen strukturierte Informationen über den Shop, das Unternehmen, Produkte, Standorte und sichtbare Inhalte. Für GEO ist die Übereinstimmung von Namen, Adressen, Kontakten, Betreuungsgebieten und Profilen mit den tatsächlichen Unternehmensdaten wichtig; das Modul ergänzt diese nicht für den Administrator und prüft ihre Richtigkeit nicht über die Formatvalidierung hinaus. Strukturierte Daten ersetzen weder die Qualität der Seite, die Verfügbarkeit der Inhalte, die Indexierung, die Richtlinien der Suchmaschine noch die Konfiguration der Google Search Console. Das Ergebnis sollte auf der veröffentlichten Seite des konkreten Shops nach Aktivierung der entsprechenden Entitäten und Ergänzung der Daten geprüft werden.
Wichtige Funktionsgrenzen
- Das Modul sendet keine Daten an Google, meldet keine Adressen an den Index und erzwingt keine Rich Results.
- Es verwaltet keine FAQ-Inhalte. Die Datei
faq.jsonist Material für den Import von Fragen und Antworten; das Schema.org-Modul selbst liest sie bei der Seitengenerierung nicht direkt aus. FAQPage,CollectionPageundArticlehängen von den auf der aktuellen Seite tatsächlich verfügbaren Daten und von den unterstützten Integrationen ab.- Ein benutzerdefiniertes Theme oder Modul, das
displayFooternicht aufruft oder sichtbare Daten nicht an Smarty übergibt, erfordert eine Prüfung im konkreten Shop. - Version 1.3.6 erklärt die Kompatibilität mit PrestaShop 1.7.0.0–9.99.99; die PHP-Umgebung muss gleichzeitig die Anforderungen der verwendeten PrestaShop-Version erfüllen.
Link zur Modul-Demo:
Demo des Administrationsbereichs:
https://moduly-prestashop.eu/znaczniki-rozszerzone/admin-dev
Demo des Frontends:
https://moduly-prestashop.eu/znaczniki-rozszerzone
Prüfung der korrekten Funktion strukturierter Daten:
https://validator.schema.org