Blöcke
Drei dynamische Blöcke bringen Collections, Datensätze und Formulare in den Block-Editor. Jeder Block kapselt einen Shortcode: Der Editor wandelt die Block-Attribute in den Shortcode-String um, sodass Blöcke und Shortcodes denselben Code-Pfad, dieselben Templates und dieselben Theme-Overrides teilen.
Die drei Blöcke
Alle drei liegen in der Kategorie Widgets im Namespace wbsdvc/. Suchen Sie im Block-Inserter nach "Dataverse".
| Block | Name | Rendert |
|---|---|---|
| Dataverse Collection | wbsdvc/collection | Das Kartenraster einer Collection, mit der Detailansicht auf derselben Seite |
| Dataverse Record | wbsdvc/record | Die Detailansicht eines einzelnen Datensatzes, per Slug ausgewählt oder aus der Seiten-URL gelesen |
| Dataverse Form | wbsdvc/form | Ein Formular, dessen Einsendungen Datensätze anlegen oder aktualisieren |
Die Seitenleiste bietet ein Dropdown mit den Collections und Formularen, die auf der Einstellungsseite konfiguriert sind, beschriftet als key (table) oder key (entity set). Ist noch nichts konfiguriert, zeigt der Block stattdessen einen Link zum passenden Einstellungs-Tab. Blöcke unterstützen weder eigenes HTML noch zusätzliche CSS-Klassen; das Styling läuft über Templates und das Theme.
Attribute
| Block | Attribut | Entsprechung im Shortcode |
|---|---|---|
| Collection | name | name, der Key der Collection |
| per_page (0 = Einstellung der Collection) | per_page | |
| columns (1 bis 4) | columns | |
| detail_page | detail_page | |
| form | form | |
| search (default, on, off) | search="1" oder "0" | |
| filters (default, on, off) | filters="1" oder "0" | |
| sort (default, on, off) | sort="1" oder "0" | |
| Record | name | name |
slug (leer liest ?dvc=) | slug | |
| form | form | |
| Form | name | name, der Key des Formulars |
| record (Slug oder ID des gebundenen Datensatzes) | record |
"default" lässt die eigene Einstellung der Collection unangetastet; "on" und "off" erzwingen das Bedienelement. Die dreistufigen Schalter werden auf die Shortcode-Werte 1/0 abgebildet, der Block kann also nichts, was der Shortcode nicht kann. Ein Block ohne Auswahl rendert im Frontend nichts.
<!-- was der Collection-Block rendert -->
[wbsdvc_collection name="listings" per_page="12" columns="3" search="1"]Vorschau
Der Editor zeigt eine serverseitig gerenderte Vorschau über die Block-Renderer-REST-Route des WordPress-Cores, die die Capability edit_posts voraussetzt. Die Vorschau ist die echte Ausgabe: dieselben Templates, dieselben Daten, derselbe Cache. Eine Collection an einer langsamen Umgebung rendert auch im Editor langsam; setzen Sie eine Cache-Lebensdauer an der Collection, wenn das die Redakteure stört. Eine nicht konfigurierte Verbindung zeigt im Editor denselben Hinweis, den auch Besucher sehen würden.
Styling über das Theme
Das Frontend-Stylesheet des Plugins wird auch im Editor geladen, damit die Vorschau wie die veröffentlichte Seite aussieht. Das Frontend-Markup verwendet dvc--Klassen (dvc-collection, dvc-toolbar, dvc-grid, dvc-card, dvc-pagination, dvc-detail, dvc-form). Das Aussehen überschreiben Sie auf einem von drei Wegen:
- Gestalten Sie die
dvc--Klassen im Stylesheet Ihres Themes. - Kopieren Sie ein Template aus
wbs-connect-for-dataverse/templates/nachyour-theme/wbs-connect-for-dataverse/und ändern Sie das Markup. Blöcke übernehmen die Überschreibung sofort. - Passen Sie die Dropdown-Beschriftungen an oder ergänzen Sie Einträge für den Editor über den Filter
wbs_dataverse_connect_blocks_data.
Die Block-Skripte sind reines ES5 ohne Build-Schritt; die Block-Metadaten liegen in blocks/collection, blocks/record und blocks/form.
Elementor und andere Page Builder
Page Builder ohne Block-Unterstützung verwenden den Shortcode: In Elementor ziehen Sie ein Shortcode-Widget auf die Seite und fügen [wbsdvc_collection name="listings"] ein. Ausgabe und Templates sind mit dem Block identisch.