Skip to content

Deutsch

David Decker edited this page Oct 22, 2026 · 3 revisions

Builder Template Categories — Anleitung auf Deutsch

Letzte Hauptversion: 1.9.0. Die Entwicklung ist eingestellt: WordPress und moderne Builder übernehmen heute die ursprünglichen Aufgaben des Plugins; Arbeitsabläufe haben sich verändert. Falls erforderlich, folgen ausschließlich Sicherheitsupdates, längstens bis 31.12.2027. Neue Funktionen und laufende Kompatibilitätspflege sind nicht vorgesehen.

English · Release und Download · Repository

Inhaltsverzeichnis

  1. Zweck und Grenzen
  2. Voraussetzungen und Installation
  3. Unterstützte Bibliotheken
  4. Builder-Kategorien und WordPress-Kategorien
  5. Kategorien anlegen und zuweisen
  6. Übersichten und Filter
  7. WordPress-Vorlagen im Hauptmenü
  8. Berechtigungen und Datenschutz
  9. Update, Deaktivierung und Daten
  10. Multisite
  11. Fragen nach Themen
  12. Entwicklerhinweise
  13. Sicherheit und weitere Plugins

Zweck und Grenzen

Builder Template Categories ergänzt einen gemeinsamen Bestand an Builder-Kategorien für die unterstützten Vorlagenbibliotheken im WordPress-Admin. Damit lassen sich beispielsweise Kopfzeilen, Landingpages oder Inhaltsblöcke zuordnen und in Listen wiederfinden.

Das Plugin organisiert vorhandene Vorlagen. Es erstellt keine Layouts, ersetzt keinen Builder und ändert nicht die Bedingungen, unter denen ein Template auf der Website ausgegeben wird. Kategorien werden nicht automatisch in die internen Bibliotheksfilter eines Builders übernommen. Die Zuordnung einer Builder-Kategorie verändert weder Inhalt noch Darstellungsbedingungen eines Templates.

Wartungsupdate 1.9.2

Updater 2.2.1 behebt die Update-Verarbeitung bei gleichzeitig geladenen älteren Updater-Kopien. Library 1.1.0, Funktionen, Einstellungen und Mindestanforderungen bleiben unverändert.

Wartungsupdate 1.9.1

Version 1.9.1 ergänzt deckerweb Library 1.1.0 und deckerweb Updater 2.2.0 als ausdrücklich zugelassene Wartungsausnahme. Erforderlich ist jetzt PHP 8.1 oder neuer; WordPress 7.0 bleibt die Mindestversion. Der Funktionsstopp und das Ende möglicher Sicherheitsupdates am 31.12.2027 bleiben bestehen.

Die gemeinsame Library ist über Plugins hinzufügen erreichbar und unter Einstellungen → deckerweb Library ausblendbar. Ihr Online-Katalog ist standardmäßig ausgeschaltet. Wird er eingeschaltet, wird ein öffentlicher Katalog von GitHub geladen. Die Installation eines ausgewählten Plugins lädt dessen freigegebenes Paket; die Aktivierung ist ein eigener Schritt. Native Updates können GitHub kontaktieren und Release-ZIPs herunterladen. Dabei sieht die Gegenstelle die anfragende IP-Adresse; Telemetrie wird nicht ergänzt. Öffentliche Updates benötigen kein Token.

Gemeinsame Library-Einstellungen bleiben bei Deaktivierung und standardmäßig bei Deinstallation erhalten. Die Entfernung des letzten einbindenden Plugins bereinigt Komponenten-Caches und temporäre Dateien; eine optionale Einstellungslöschung richtet sich nach der Library-Vorgabe. Andere installierte Plugins, Kategorien und Inhalte bleiben erhalten.

Enthalten sind deckerweb Library 1.1.0 und deckerweb Updater 2.2.1 von David Decker – DECKERWEB unter GPL-2.0-or-later. Quellen: https://github.com/deckerweb/deckerweb-plugin-library und https://github.com/deckerweb/deckerweb-updater.

Ein fehlgeschlagenes manuelles Einzelupdate kann das Plugin trotz erhaltener Dateien deaktiviert zurücklassen. Prüfe die Plugins-Seite und aktiviere es gegebenenfalls erneut. Beim getesteten abgelehnten Sammelupdate blieb die Aktivierung erhalten. Ist Git Updater aktiv, beachte den gemeinsamen Konflikthinweis; deaktiviere einen anderen Update-Anbieter erst dauerhaft, wenn alle betroffenen Plugins und Themes anderweitig zuverlässig versorgt sind.

Voraussetzungen und Installation

  • WordPress 7.0 oder neuer.
  • PHP 8.1 oder neuer.
  • Für Builder-Integrationen: der jeweilige Builder beziehungsweise das Theme und dessen Vorlagenbibliothek.

Die Mindestversionen sind keine Zusage für die Kompatibilität mit allen zukünftigen Versionen.

  1. Datenbank und Plugin-Dateien sichern, insbesondere vor einem Update.
  2. Die Datei builder-template-categories-1.9.2.zip aus dem GitHub-Release herunterladen.
  3. Unter Plugins → Installieren → Plugin hochladen installieren beziehungsweise die bestehende Version ersetzen.
  4. Aktivieren und eine unterstützte Vorlagenbibliothek öffnen.

Verwende das ausdrücklich angebotene Installations-ZIP. Die automatisch erzeugten GitHub-Archive „Source code“ enthalten den Repository-Quellstand einschließlich zusätzlicher Dateien. Der Grafiksatz ist kein installierbares Plugin.

Unterstützte Bibliotheken

Integration Beitragstyp
Gespeicherte WordPress-Patterns wp_block
Elementor-Vorlagen elementor_library
Bricks-Templates bricks_template
Beaver Builder / Beaver Themer fl-builder-template / fl-theme-layout
Divi-Bibliothek et_pb_layout
Oxygen Classic ct_template
Avada fusion_template / fusion_element
GeneratePress Elements gp_elements
Astra Pro Custom Layouts astra-advanced-hook

Eine Integration erscheint nur, wenn sie auf dieser Website erkannt wird und ihr Beitragstyp vorhanden ist. Das Plugin schaltet keine kostenpflichtigen Funktionen frei. Oxygen 6 ist nicht enthalten. Früher unterstützte Formulare, Felder, Snippets, Scripts, kleinere Themes und zahlreiche Add-ons wurden mit 1.9.0 entfernt.

In der Verwaltung der Builder-Kategorien zeigt „Auf dieser Website verfügbar“ die tatsächlich aktiven und angebundenen Bibliotheken. Die Namen führen zur jeweiligen Übersicht, soweit der Benutzer diese bearbeiten darf. „Technische Details: Beitragstypen“ lässt sich bei Bedarf aufklappen. Dieser Bereich erscheint nur für Benutzer mit der Kategorienberechtigung.

Builder-Kategorien und WordPress-Kategorien

Bezeichnung Herkunft und Verwendung
Builder-Kategorien Gemeinsame Taxonomie dieses Plugins für die unterstützten Bibliotheken.
Vorlagen-Kategorien Eigene WordPress-Taxonomie für gespeicherte Patterns.

Im WordPress-Vorlageneditor können beide Bereiche erscheinen. Die WordPress-Kategorien haben eine Eingabe wie Schlagwörter; ihre offizielle Bezeichnung lautet dennoch Vorlagen-Kategorien. Unsere Builder-Kategorien sind hierarchisch und unterstützen übergeordnete Kategorien.

Beide Systeme sind unabhängig. Gleichnamige Kategorien sind nicht automatisch identisch; es gibt keine Synchronisierung. Die neue Beschriftung Builder-Kategorien verändert keine gespeicherten Kategorien oder Zuordnungen. Die technische Kennung bleibt builder-template-category.

Kategorien anlegen und zuweisen

  1. In einer unterstützten Bibliothek das Untermenü Builder-Kategorien öffnen. Für WordPress-Patterns: Vorlagen → Builder-Kategorien.
  2. Einen Namen eingeben; bei Bedarf Titelform, übergeordnete Kategorie und Beschreibung ergänzen.
  3. Die Kategorie speichern.
  4. Eine Vorlage im WordPress-Admin bearbeiten und die gewünschte Builder-Kategorie auswählen. Im Block-Editor befindet sich der Bereich in den Dokumenteinstellungen.
  5. Die Vorlage speichern beziehungsweise aktualisieren.

In unterstützten WordPress-Listen kannst du Kategorien auch über Schnellbearbeitung oder die Mehrfachbearbeitung zuweisen. In der Mehrfachbearbeitung ergänzt WordPress üblicherweise Zuordnungen; sie ist kein Werkzeug zum pauschalen Entfernen aller vorhandenen Kategorien.

Verwende verständliche Namen und einen überschaubaren Bestand. Dieselbe Kategorie kann Vorlagen unterschiedlicher Bibliotheken organisieren. Sie muss nicht für jeden Builder erneut angelegt werden.

Übersichten und Filter

Die Template-Übersicht erhält die Spalte Builder-Kategorien und den Filter Alle Builder-Kategorien. Wähle eine Kategorie und klicke auf Filtern, um Vorlagen dieser Bibliothek mit der entsprechenden Zuordnung zu sehen. Ein Kategorienlink in der Spalte öffnet ebenfalls die gefilterte Übersicht. Ein Gedankenstrich bedeutet, dass keine Kategorie zugeordnet ist.

Bricks-Template-Übersicht mit Builder-Kategorien-Spalte und Filter

Version 1.9.0 auf einer echten Bricks-Testwebsite: Die bisherigen Bricks-Spalten bleiben erhalten; Builder-Kategorien erscheinen zusätzlich. Die deutschen Oberflächenbegriffe gelten auch beim Lesen der englischen Anleitung.

Die Zahl Anzahl in der Kategorienverwaltung wird von WordPress für die gemeinsame Taxonomie ermittelt, nicht separat für den gerade geöffneten Builder. Beispielsweise können fünf gezählte Elementor-Vorlagen und zehn Astra-Layouts zusammen einen Zähler von 15 ergeben, während der Elementor-Filter fünf Treffer liefert. Sichtbarkeit und gezählte Beitragsstatus richten sich zusätzlich nach WordPress.

WordPress-Vorlagen im Hauptmenü

Das Plugin ergänzt standardmäßig Vorlagen als eigenen Menüpunkt:

  • Alle Vorlagen — native WordPress-Liste gespeicherter Patterns.
  • Vorlage hinzufügen — neue Vorlage anlegen, sofern erlaubt.
  • Builder-Kategorien — unsere Kategorienverwaltung, sofern erlaubt.

Diese Liste enthält in WordPress gespeicherte Patterns, synchronisiert oder nicht synchronisiert. Patterns, die Themes oder Plugins nur registrieren und dem Inserter bereitstellen, sind keine gespeicherten wp_block-Beiträge und erscheinen hier nicht automatisch. Die native Verwaltung im Website-Editor bleibt daneben verfügbar. Ein bereits vorhandener Hauptmenüpunkt mit derselben Zieladresse wird nicht nochmals angelegt.

Berechtigungen und Datenschutz

Standardmäßig benötigt die Verwaltung und Zuweisung von Builder-Kategorien die WordPress-Berechtigung edit_theme_options. Administratoren besitzen sie normalerweise; normale Redakteure normalerweise nicht. Angepasste Rollen und Berechtigungsfilter können das ändern.

Die WordPress-Vorlagenliste nutzt weiterhin die nativen Bearbeitungsrechte. Ein Redakteur kann daher Vorlagen sehen oder anlegen, ohne Builder-Kategorien verwalten zu dürfen. Das Plugin erweitert diese Rechte nicht automatisch.

Unsere interne Taxonomie ist nicht öffentlich. REST-Zugriffe auf ihre Kategorien sind ebenfalls geschützt. Das Plugin fügt keine Frontend-Skripte oder Styles hinzu und betreibt keine Telemetrie. Kategorien und Zuordnungen liegen in den WordPress-Taxonomietabellen. Links zu Dokumentation und anderen Plugins werden nur beim Aufrufen geöffnet.

Update, Deaktivierung und Daten

Mit 1.9.0 wurden 72 frühere Integrationsdateien entfernt. Prüfe deshalb vor dem Update die obige Liste und teste wichtige Abläufe auf einer Testwebsite.

Bestehende Kategorien und Zuordnungen bleiben erhalten, auch bei Deaktivierung oder Deinstallation des Plugins. Für entfernte Integrationen entfällt die Bedienoberfläche; ihre gespeicherten Beziehungen werden nicht automatisch gelöscht oder zu einer anderen Taxonomie migriert.

Vorgabekategorien werden nur bei einer leeren Sammlung angelegt. Eigene oder bereits übersetzte Kategorien werden bei erneuter Aktivierung nicht aufgefüllt und nicht automatisch umbenannt. Ein späterer Wechsel der Website-Sprache übersetzt gespeicherte Kategorienamen nicht.

Wenn du eine Kategorie ausdrücklich in WordPress löschst, verschwinden diese Kategorie und ihre Zuordnungen in sämtlichen Bibliotheken dieser Website. Die Templates selbst werden dadurch nicht gelöscht. Überlege vor dem Löschen, ob andere Bibliotheken dieselbe Kategorie verwenden.

Für einen Rollback benötigst du das vorherige Plugin-Paket und eine Datenbanksicherung. Eine Rückkehr zur alten Version stellt nicht automatisch Änderungen an Daten oder Berechtigungen zurück.

Multisite

Einzelaktivierung und Netzwerkaktivierung werden unterstützt. Jede Website hat ihren eigenen Kategorienbestand; „gemeinsam“ bedeutet bibliotheksübergreifend innerhalb dieser Website, nicht netzwerkweit.

Bei Netzwerkaktivierung werden leere Sammlungen initialisiert. Neu angelegte Websites werden bei aktivem Netzwerk-Plugin ebenfalls berücksichtigt. Bestehende Kategorien bleiben bei erneuter Aktivierung erhalten.

Fragen nach Themen

Einrichtung und Sichtbarkeit

Ein Menüpunkt oder die Kategorien fehlen. Prüfe die Plugin-Aktivierung, deine Berechtigung und ob die betreffende Bibliothek aktiv ist. Lade den Admin nach einem Update neu. Benutzer ohne Kategorienberechtigung sehen weder die Spalte noch den Filter oder das Kategorien-Untermenü.

Der Filter erscheint, aber die Spalte fehlt. Version 1.9.0 ergänzt die Spalte auch nach einer angepassten Builder-Spaltenliste. Prüfe zusätzlich Ansicht anpassen und gegebenenfalls ein Plugin zur Spaltenverwaltung: Eine dort ausdrücklich versteckte Spalte wird nicht zwangsweise eingeblendet. Stelle sicher, dass du das veröffentlichte 1.9.0-Paket verwendest.

Zuordnungen und Zähler

Die Kategorie ist angelegt, aber es gibt keine Treffer. Eine angelegte Kategorie ist noch keiner Vorlage zugewiesen. Prüfe die Zuordnung, den gespeicherten Zustand und weitere Filter wie Datum, Suche, Status oder Template-Typ. Die aktuelle Liste zeigt nur ihren eigenen Beitragstyp.

Die Kategorienverwaltung zeigt mehr Einträge als mein Builder. Der Kategorienbestand und der WordPress-Zähler gelten über die angebundenen Bibliotheken hinweg. Die Template-Liste filtert dagegen ihren jeweiligen Beitragstyp; siehe den Abschnitt zu Übersichten und Filtern.

Patterns und Kompatibilität

Im Editor stehen zweimal Kategorien. Das ist bei Patterns erwartbar: WordPress-Vorlagen-Kategorien und unsere Builder-Kategorien sind zwei unabhängige Taxonomien. In 1.9.0 sind sie eindeutig beschriftet.

Wo sind meine Theme-Patterns? Nur gespeicherte Patterns stehen in der neuen Vorlagenliste. Registrierte Theme- und Plugin-Patterns findest du weiterhin im nativen Inserter beziehungsweise Website-Editor.

Wird das Template durch eine Kategorie anders angezeigt? Nein. Kategorien organisieren die Admin-Listen. Builder-Bedingungen und Template-Inhalte werden nicht geändert.

Werden alle aktuellen oder zukünftigen Builder unterstützt? Nein. Die oben genannten Integrationen bilden den eingefrorenen Funktionsumfang. Es gibt keine Zusage für zukünftige Builder-Versionen und keine geplanten neuen Integrationen.

Was wurde tatsächlich geprüft? WordPress 7.0 mit PHP 8.1.29 und WordPress 7.1.3 mit PHP 8.4.5, jeweils mit SQLite, einschließlich REST, Rollen, Menüs, Datenbestand und Multisite. Elementor Finder wurde mit Elementor 4.3.4 geprüft; die korrigierte Bricks-Spalte wurde auf einer echten Testwebsite bestätigt. Übrige Premium-Integrationen wurden über Beitragstyp-Fixtures geprüft. Ein exakter PHP-8.0-Lauf sowie vollständige Premium-Builder- und MySQL/MariaDB-Tests wurden nicht durchgeführt.

Entwicklerhinweise

Die Taxonomie heißt builder-template-category und bleibt unverändert. Die folgenden PHP-Filter sind für vertrauenswürdigen Erweiterungscode vorgesehen:

Filter Zweck
btc/filter/integrations/all Integrationen ergänzen oder ändern.
btc/filter/capability/submenu Verwaltung und Zuweisung: erforderliche Berechtigung ändern.
btc/filter/taxonomy/labels Taxonomie-Beschriftungen anpassen.
btc/filter/taxonomy/args Registrierungsargumente anpassen.

Der Integrationsfilter erhält und liefert ein Array mit Integrations-IDs als Schlüsseln. Jeder Eintrag benötigt Zeichenketten für label, submenu_hook, post_type, template_label und admin_url. Registriere den Filter vor init mit Priorität 20. Fehlende Beitragstypen und fehlerhafte Einträge werden übersprungen; später registrierte Beitragstypen werden ebenfalls berücksichtigt.

Eine abgesenkte Berechtigung verändert den Zugriff auch auf die internen Kategorien. Prüfe Rollen und REST-Verhalten sorgfältig. Veröffentliche die Taxonomie nicht leichtfertig über angepasste Argumente. Historische Snippets im Wiki können frühere Integrationen voraussetzen und müssen gegen 1.9.0 geprüft werden.

Changelog

1.9.2 — 22. Oktober 2026

Behoben: Zuverlässige GitHub-Updates, auch wenn ein anderes Plugin zuvor einen älteren deckerweb Updater geladen hat.

1.9.1 — 21. Oktober 2026

  • Gemeinsame Library 1.1.0 und Updater 2.2.0, geprüfte Update-Pakete und PHP 8.1 als Mindestversion.
  • Abschließende Ausgabeabsicherung und fehlende mitgelieferte Übersetzungen nach Sprachwechseln verbessert.
  • Funktionsstopp und Sicherheitsfrist bleiben bestehen.

1.9.0 — 10. Oktober 2026

Letzte Hauptfunktionsversion: reduzierte Integrationen, Builder-Kategorien, natives Vorlagen-Menü, ergänzte Template-Spalten und Übersicht aktiver Bibliotheken.

Deutsches Änderungsprotokoll · Vollständige Veröffentlichungshistorie einschließlich früherer Versionen (Englisch).

Sicherheit und weitere Plugins

Sicherheitsprobleme bitte vertraulich melden: über GitHub Private Vulnerability Reporting, sofern verfügbar, ansonsten über deckerweb.de/kontakt zunächst einen privaten Meldeweg anfragen. Keine Exploit-Details oder Zugangsdaten in öffentlichen Issues veröffentlichen. Details: Sicherheitsrichtlinie.

Eine weitere Hauptversion ist nicht geplant. Sicherheitsupdates erscheinen nur bei Bedarf und spätestens bis 31.12.2027; nach diesem Datum ist keine Sicherheitswartung vorgesehen.

Weitere Helfer von deckerweb:

Dokumentationsstand: Version 1.9.2, 22. Oktober 2026.