Codequalität: Saubere HTML Templates in WordPress Plugins

Hallo zusammen,

ich benötige ein wenig Inspiration zum Thema Codequalität.

Während meiner Arbeit an WordPress Projekten greife ich häufig auf Custom Post Types und Shortcodes zurück.

Wenn ich beispielsweise die Mitarbeiter einer Firma auf mehreren Seiten darstellen möchte, lege ich sie zunächst in einem eigenem Post Type an und ordne sie über Taxonomien. Will ich die Daten als Mitarbeiter Cards ausgeben, greife ich auf einen Shortcode zurück, z.B. [staff dept="empfang"] oder [staff id="1,2,3"].

Jetzt kommen wir zum Kern der Frage:
Wie setzt ihr HTML Templates in Shortcodes zusammen?

Erweitert ihr Schritt für Schritt eine Variable?

PHP:

Entschuldige, aber du musst dich registrieren oder anmelden um den Inhalt sehen zu können!

Oder verwertet ihr den Output Buffer?

PHP:

Entschuldige, aber du musst dich registrieren oder anmelden um den Inhalt sehen zu können!

Diese Varianten funktionieren wunderbar, aber ich empfinde sie als extrem unsauber, im Vergleich zur Arbeit innerhalb regulärer Theme Templates.

Ideen oder Verweise auf den Codex sind gerne gesehen!

LG
Marvin