# 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.

Source: https://www.jpkc.com/db/guides/jpkcom-is-lc-friendly/

JPKCom Theme is LiveCanvas friendly meldet [LiveCanvas](https://docs.livecanvas.com/which-themes-with-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
<?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

- Quellcode auf GitHub: <https://github.com/JPKCom/jpkcom-is-lc-friendly>
- API-Dokumentation (PHPDoc): <https://jpkcom.github.io/jpkcom-is-lc-friendly/docs/>
- [Welche Themes mit LiveCanvas?](https://docs.livecanvas.com/which-themes-with-livecanvas/)
- [Changelog dieses Projekts](https://www.jpkc.com/db/changelog/jpkcom-is-lc-friendly/)