JPKCom DB
Auf GitHub ansehen

JPKCom Theme is LiveCanvas friendly — Anleitung & Tipps

Ein beliebiges WordPress-Theme als LiveCanvas-kompatibel kennzeichnen — Installation, Bootstrap-Version und das nötige Empty-Page-Template.

JPKCom Theme is LiveCanvas friendly meldet LiveCanvas, dass dein aktives Theme LiveCanvas-kompatibel ist. Das Plugin stellt die Helper-Funktionen lc_theme_is_livecanvas_friendly() und lc_theme_bootstrap_version() bereit, sodass du dein Theme nicht selbst um diese Funktionen erweitern musst.

Anleitung

Voraussetzungen

  • WordPress 6.9 oder neuer (getestet bis 7.0)
  • PHP 8.3 oder neuer
  • Das Plugin LiveCanvas (im Header als Requires Plugins: livecanvas ausgewiesen) muss aktiv sein

Installation

  1. Gehe im Admin-Bereich zu Plugins → Installieren und klicke auf Plugin hochladen.
  2. Wähle die ZIP-Datei des Plugins und klicke auf Jetzt installieren.
  3. Stelle sicher, dass das LiveCanvas-Plugin aktiviert ist.
  4. Klicke auf Aktivieren.
  5. Lege in deinem Theme-Ordner ein Unterverzeichnis page-templates an.
  6. Erstelle darin eine Datei empty.php mit folgendem Inhalt:
<?php
/* Template Name: Empty */

defined( 'ABSPATH' ) || exit;

get_header();

while ( have_posts() ) :
the_post();
the_content();
endwhile;

get_footer();

Bootstrap-Version

lc_theme_bootstrap_version() teilt LiveCanvas mit, welche Bootstrap-Version dein Theme nutzt. Laut README-Beispiel gibt die Funktion 5.3 für aktuelles Bootstrap zurück; alternativ sind 5 (Bootstrap 5.0–5.2) oder 4 (Bootstrap 4) möglich.

Tipps & Tricks

  • Das Empty-Template ist Pflicht: Ohne das page-templates/empty.php in deinem Theme fehlt LiveCanvas die leere Vorlage, auf der es seine Inhalte aufbaut. Lege es genau wie im README gezeigt an.
  • Helfer sind abgesichert: Ab Version 1.0.4 sind die LiveCanvas-Helper-Funktionen mit function_exists() geschützt — sie kollidieren also nicht, falls dein Theme dieselben Funktionen schon definiert.
  • Bootstrap-Version anpassen: Passe den Rückgabewert von lc_theme_bootstrap_version() an die tatsächlich von deinem Theme verwendete Bootstrap-Version an.
  • Reproduzierbare Updates: Ab Version 1.0.4 nutzt das Plugin sichere, selbst gehostete Updates über GitHub mit SHA256-Prüfsummen und arbeitet mit declare(strict_types=1).

Weiterführende Informationen