From 2326e6a3fd9d24b08c1bc34157ab7ace1e969c17 Mon Sep 17 00:00:00 2001 From: M_Viper Date: Wed, 18 Mar 2026 21:02:53 +0000 Subject: [PATCH] README.md aktualisiert --- README.md | 121 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 120 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 369e5a0..5d4c219 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,121 @@ -# WP-Multi-Wiki +# 📚 WP Multi Wiki +**WP Multi Wiki** ist ein WordPress-Plugin zum Erstellen und Verwalten mehrerer Wikis auf einer Website — ideal fĂŒr Plugin-Dokumentationen, Wissensdatenbanken und Support-Seiten. + +![Version](https://img.shields.io/badge/Version-1.0.0-blue) +![WordPress](https://img.shields.io/badge/WordPress-5.8%2B-21759b) +![PHP](https://img.shields.io/badge/PHP-7.4%2B-777bb4) +![Lizenz](https://img.shields.io/badge/Lizenz-GPL%20v2-green) + +--- + +## ✹ Features + +- **Mehrere Wikis** — Erstelle beliebig viele voneinander unabhĂ€ngige Wikis +- **Kategorien & Tags** — Artikel nach Themen strukturieren +- **Automatisches Inhaltsverzeichnis** — wird aus den Überschriften generiert +- **AJAX-Suche** — schnelle Live-Suche innerhalb eines Wikis +- **Breadcrumb-Navigation** — immer wissen wo man ist +- **Sidebar-Navigation** — ĂŒbersichtliche Artikelliste pro Wiki +- **Verwandte Artikel** — Ă€hnliche Artikel am Ende anzeigen +- **Prev/Next Navigation** — zwischen Artikeln blĂ€ttern +- **Gitea Wiki Importer** — Wikis direkt aus einer Gitea-Instanz importieren +- **Shortcodes** — Wikis ĂŒberall auf der Seite einbetten +- **Theme-Adaptiv** — passt sich automatisch an Dark & Light Mode an + +--- + +## 📩 Installation + +1. Repository als ZIP herunterladen +2. In WordPress: **Plugins → Installieren → Plugin hochladen** +3. ZIP auswĂ€hlen und installieren +4. Plugin aktivieren +5. Im Admin-MenĂŒ erscheint **WP Multi Wiki** + +--- + +## 🚀 Schnellstart + +### 1. Wiki erstellen +**WP Multi Wiki → Neues Wiki** → Titel, Icon, Farbe und Version eingeben → **Wiki erstellen** + +### 2. Artikel hinzufĂŒgen +**WP Multi Wiki → Neuer Artikel** → Titel, Inhalt, Wiki zuordnen → **Artikel erstellen** + +### 3. Wiki auf einer Seite einbinden +Shortcode auf einer beliebigen WordPress-Seite einfĂŒgen: + +``` +[wmw_wiki id="1"] +``` + +--- + +## 📋 Shortcodes + +| Shortcode | Beschreibung | +|-----------|-------------| +| `[wmw_wiki_list]` | Alle Wikis als Karten-Übersicht | +| `[wmw_wiki id="1"]` | Ein Wiki mit allen Artikeln | +| `[wmw_wiki slug="mein-plugin"]` | Wiki per Slug einbinden | +| `[wmw_search wiki_id="1"]` | Suchfeld fĂŒr ein bestimmtes Wiki | +| `[wmw_article id="5"]` | Einzelnen Artikel einbetten | +| `[wmw_breadcrumb]` | Breadcrumb-Navigation | + +--- + +## ⚙ Einstellungen + +Unter **WP Multi Wiki → Einstellungen** konfigurierbar: + +| Einstellung | Standard | Beschreibung | +|-------------|----------|-------------| +| Inhaltsverzeichnis | ✅ an | Automatisch aus Überschriften generiert | +| Breadcrumbs | ✅ an | Navigation Home → Wiki → Artikel | +| Verwandte Artikel | ✅ an | Ähnliche Artikel am Ende | +| Suchfeld | ✅ an | AJAX-Suche im Wiki | +| Sidebar-Position | Links | Links, Rechts oder keine Sidebar | +| Artikel pro Seite | 20 | Anzahl der Artikel in Listen | +| Custom CSS | — | Eigenes CSS fĂŒr das Frontend | + +--- + +## 🐙 Gitea Wiki Importer + +Wikis direkt aus einer Gitea-Instanz importieren: + +1. **WP Multi Wiki → Gitea Import** öffnen +2. Gitea-Server URL, Owner und Repository eintragen +3. Auf **Seiten vorab laden** klicken — Vorschau aller verfĂŒgbaren Seiten +4. Ziel-Wiki auswĂ€hlen +5. Seiten die ĂŒbersprungen werden sollen eintragen (z.B. `Home`, `_Sidebar`) +6. **Wiki jetzt importieren** klicken + +**Folgende Markdown-Elemente werden automatisch konvertiert:** +Überschriften, Fett/Kursiv, Code-Blöcke, Tabellen, Links, Bilder, Blockquotes, Listen und Gitea-interne `[[Wiki-Links]]` + +> FĂŒr **private Repositories** einen Access Token unter Gitea → Einstellungen → Anwendungen erstellen (Scope: `read:wiki`) und im Importer eintragen. + +--- + +## 🔧 Voraussetzungen + +- WordPress **5.8** oder höher +- PHP **7.4** oder höher +- MySQL **5.6** / MariaDB **10.1** oder höher + +--- + +## đŸ‘€ Autor + +**M_Viper** +- Website: [M-Viper.de](https://M-Viper.de) +- Gitea: [git.viper.ipv64.net](https://git.viper.ipv64.net/M_Viper) + +--- + +## 📄 Lizenz + +Dieses Plugin ist unter der **GNU General Public License v2 or later** lizenziert. +Weitere Informationen: [http://www.gnu.org/licenses/gpl-2.0.html](http://www.gnu.org/licenses/gpl-2.0.html) \ No newline at end of file