srhinow/simple-product-bundle
Composer 安装命令：
composer require srhinow/simple-product-bundle
包简介
simple products manager for Contao CMS
README 文档
README
Ein schlankes Contao-Bundle zur Verwaltung und Darstellung von Produkten mit Kategorisierung, Detailseiten und flexiblen Content-Elementen.
Voraussetzungen
- PHP ^8.1
- Contao CMS ^5.3
Installation
composer require srhinow/simple-product-bundle
Nach der Installation die Datenbank-Migration ausführen:
php bin/console contao:migrate
Backend
Das Bundle fügt im Contao-Backend den Bereich Produkte mit zwei Modulen hinzu:
Produkt-Kategorien (tl_simple_product_categories)
Kategorien dienen zur Gruppierung der Produkte. Jede Kategorie hat:
| Feld | Beschreibung |
|---|---|
| Titel | Bezeichnung der Kategorie |
| Alias | URL-kompatibler Bezeichner |
| Sortierung | Reihenfolge der Kategorie |
Produkt-Einträge (tl_simple_product_entries)
Die eigentlichen Produkte. Jeder Eintrag hat:
| Feld | Beschreibung |
|---|---|
| Überschrift | Produktname |
| Alias | URL-Alias (wird automatisch generiert) |
| Kategorie | Zuordnung zu einer Produkt-Kategorie |
| Teasertext | Kurzbeschreibung (RTE) |
| Bild | Optional: Bild mit Alt-Text und Titel |
| Veröffentlicht | Sichtbarkeit im Frontend |
| Start / Stop | Zeitgesteuerte Veröffentlichung |
Jedem Produkt-Eintrag können Content-Elemente (tl_content) als Kindelemente zugeordnet werden, um den Detailinhalt flexibel aufzubauen.
Frontend — Content-Elemente
Das Bundle stellt zwei Content-Elemente bereit, die im Backend unter der Gruppe Produkte zu finden sind.
1. Produkt-Liste (sp_product_list)
Zeigt alle veröffentlichten Produkte der ausgewählten Kategorien als Liste an.
Einstellungen im Content-Element:
| Feld | Beschreibung |
|---|---|
| Kategorien | Eine oder mehrere Kategorien, deren Produkte angezeigt werden |
| Detailseite | Seite, auf die bei Klick auf ein Produkt verlinkt wird (Detailansicht) |
| Template | Auswahl des Listeneintrags-Templates (Prefix sp_item_) |
Das Element rendert für jedes Produkt ein eigenes Item-Template und stellt dabei u.a. folgende Template-Variablen bereit:
| Variable | Beschreibung |
|---|---|
products | Array aller gerenderten Produkt-Items (als HTML-String) |
categories | Array der ausgewählten Kategorie-IDs |
Item-Template (sp_item_list):
| Variable | Beschreibung |
|---|---|
productHeadline | Produktname |
href | URL zur Detailseite |
linkHeadline | Produktname als verlinktes <a>-Element |
more | „Weiterlesen"-Link |
hasTeaser | true, wenn ein Teasertext vorhanden ist |
teaser | Teasertext (HTML) |
addImage | true, wenn ein Bild hinterlegt ist |
arrEntries | Callable — liefert die gerenderten Content-Elemente des Produkts |
count | Laufende Nummer des Eintrags in der Liste |
class | CSS-Klassen (first, last, odd, even) |
2. Produkt-Details (sp_product_details)
Zeigt ein einzelnes Produkt in der Detailansicht an. Das anzuzeigende Produkt wird über den URL-Parameter product (bzw. auto_item) ermittelt oder kann fest im Content-Element vorgegeben werden.
Einstellungen im Content-Element:
| Feld | Beschreibung |
|---|---|
| Zurück zur Liste | Seite der Produktliste (für Rücklinks) |
| Produkt | Optional: fester Produkt-Eintrag (ohne URL-Parameter) |
| Template | Auswahl des Detail-Templates (Prefix sp_item_) |
Das Element setzt automatisch den Seitentitel (pageTitle) und die Meta-Beschreibung (description) der aktuellen Seite anhand der Produkt-Daten.
Detail-Template (sp_item_details):
Die gleichen Template-Variablen wie beim Listenitem, zusätzlich:
| Variable | Beschreibung |
|---|---|
product | Gerenderter HTML-String des kompletten Produkt-Detail-Templates |
Templates
Alle Templates liegen unter contao/templates/ und können wie üblich im Contao-Templateverzeichnis überschrieben werden.
| Template | Verwendung |
|---|---|
ce_sp_productlist.html5 | Wrapper-Template für das Produkt-Liste Content-Element |
ce_sp_productdetails.html5 | Wrapper-Template für das Produkt-Details Content-Element |
sp_item_list.html5 | Einzelnes Produkt in der Listenansicht |
sp_item_details.html5 | Einzelnes Produkt in der Detailansicht |
Eigene Item-Templates können mit dem Prefix sp_item_ erstellt und im Content-Element ausgewählt werden.
URL-Routing
Die Detailseite erwartet den Produkt-Alias oder die ID als URL-Segment. Mit aktiviertem auto_item in Contao funktioniert z.B.:
/produkte/mein-produkt
Ohne auto_item lautet der Parameter explizit:
/produkte?product=mein-produkt
Lizenz
GPL-3.0-or-later — siehe LICENSE
Autor
Sven Rhinow — sr-tag.de — kservice@sr-tag.de
srhinow/simple-product-bundle 适用场景与选型建议
srhinow/simple-product-bundle 是一款 基于 PHP 开发的 Composer 扩展包，目前已累计 6 次下载、GitHub Stars 达 0， 最近一次更新时间为 2023 年 06 月 19 日， 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向： 「product」 「contao」 等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 srhinow/simple-product-bundle 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。
基于 srhinow/simple-product-bundle 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。
与 srhinow/simple-product-bundle 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：
Contao Open Source CMS
Diese Contao 4 Erweiterung stellt Google reCAPTCHA V2 in Form eines neuen Formularfeldes im Formulargenerator bereit. This extension provides Google reCAPTCHA V2 in the form of a new form field in the form generator of Contao Open Source CMS.
Simple RSS generator library for PHP 5.5 or later. clone from Bhaktaraz Bhatta ttps://github.com/bhaktaraz/php-rss-generator
Display your categories and products on front end of your website
Product catalog for your Symfony2 applications.
SilverCommerce module that adds customisable products (adding dropdowns, radio buttons or textfields to a product)
统计信息
- 总下载量： 6
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 0
- 点击次数： 9
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： GPL-3.0
- 更新时间： 2023-06-19