AI Unified Chat — Wtyczka WordPress

Inteligentny asystent AI z pełnym zarządzaniem treścią WordPress, oparty na Claude API (Anthropic). Jeden interfejs: rozmowa i akcje w tym samym oknie. Agent rozpoznaje czy użytkownik chce porozmawiać czy wydać polecenie i reaguje adekwatnie.

---

Jak to działa

Admin pisze: "Pokaż ostatnie posty"
    ↓
Claude rozpoznaje intencję → typ: action
    ↓
Agent wykonuje get_posts() w WordPress
    ↓
Admin widzi listę postów z ID i statusem

Admin pisze: "Jak się masz?"
    ↓
Claude rozpoznaje intencję → typ: chat
    ↓
Agent odpowiada normalnie po polsku

---

Funkcje

• 💬 Unified Chat rozmowa i polecenia w jednym oknie
• 📝 Tworzenie postów i stron z możliwością publikacji lub jako szkic
• ✏️ Edycja istniejących postów po ID
• 🗑️ Usuwanie postów do kosza (bezpieczne, odwracalne)
• 🔍 Wyszukiwanie treści pełnotekstowe
• 📋 Lista postów i stron z ID, statusem i datą
• 🏷️ Kategorie przypisywanie przy tworzeniu posta
• 🔒 Tylko dla zalogowanych wymaga uprawnień edit_posts

• 🖥️ Panel admina dedykowana strona w menu WordPress

Wymagania

• WordPress 6.0+
• PHP 8.0+
• Klucz API Anthropic (console.anthropic.com)

• Uprawnienia: editor lub wyżej

Instalacja

1. Pobierz wtyczkę

git clone https://github.com/Pawel-Szymczyk/ai-unified-chat.git

2. Wgraj do WordPress

Skopiuj folder ai-unified-chat do:

wp-content/plugins/ai-unified-chat/

3. Aktywuj w panelu admina

WordPress Admin → Wtyczki → AI Unified Chat → Aktywuj

4. Wpisz klucz API

WordPress Admin → Ustawienia → AI Assistant → wpisz klucz z console.anthropic.com

---

Użycie

Po aktywacji w lewym menu admina pojawi się pozycja AI Chat z ikoną dymka.

Przykładowe polecenia

Zarządzanie postami:

"Pokaż ostatnie 10 postów"
"Stwórz post o historii WordPress"
"Stwórz i opublikuj post o SEO w kategorii Marketing"
"Edytuj post o ID 42 — zmień tytuł na 'Nowy tytuł'"
"Wyszukaj posty o AI"
"Usuń post o ID 15"

Zarządzanie stronami:

"Pokaż wszystkie strony"
"Stwórz stronę O nas z krótkim opisem firmy"

Rozmowa:

"Jak napisać dobry tytuł SEO?"
"Co to jest Gutenberg?"

---

Dostępne akcje agenta

Akcja	Parametry	Opis
create_post	title, content, category, status	Tworzy post (domyślnie szkic)
edit_post	post_id, title, content	Edytuje istniejący post
delete_post	post_id	Przenosi post do kosza
get_posts	limit, status	Lista postów
search_posts	query	Wyszukiwanie pełnotekstowe
create_page	title, content	Tworzy stronę (szkic)
get_pages	Lista wszystkich stron

---

Struktura plików

ai-unified-chat/
├── ai-unified-chat.php              # Główny plik wtyczki
├── includes/
│   ├── class-ai-api.php             # Komunikacja z Claude API
│   └── class-ai-unified-chat.php    # Logika agenta
└── assets/
    ├── js/chat.js                   # Frontend interfejs chatu
    └── css/chat.css                 # Style widgetu

---

Bezpieczeństwo

• Endpoint REST wymaga uprawnień edit_posts, publiczny dostęp zablokowany
• Usuwanie postów przez kosz, nie trwałe usunięcie
• Przed usunięciem agent pyta o potwierdzenie
• Sanitizacja wszystkich danych wejściowych
• Nonce WordPress na każdym żądaniu

• Klucz API przechowywany w bazie WordPress, nigdy w kodzie

Dostosowanie

Dodanie nowej akcji

Krok 1 dodaj akcję do system promptu w get_system_prompt():

'publish_post (post_id), ' .

Krok 2 dodaj case w execute_action():

'publish_post' => $this->action_publish_post( $params ),

Krok 3 napisz metodę:

private function action_publish_post( array $p ): string {
    $id = intval( $p['post_id'] ?? 0 );
    wp_update_post( [ 'ID' => $id, 'post_status' => 'publish' ] );
    return "Post #{$id} opublikowany.";
}

Zmiana modelu Claude

W class-ai-api.php zmień:

private string $model = 'claude-haiku-4-5';   // szybki, tani
// na:
private string $model = 'claude-sonnet-4-6';  // lepszy, droższy

---

Koszty API

Model	Koszt	Zalecenie
Claude Haiku	~$0.25/1M tokenów	Demo, niski ruch
Claude Sonnet	~$3/1M tokenów	Produkcja, lepsza jakość

---

Licencja

GPL v2 zgodnie ze standardem WordPress.

---

Screenshots

---

Autor

Paweł Szymczyk — github.com/Pawel-Szymczyk

Freelancer specjalizujący się w integracji AI z WordPress. Zainteresowany podobnym rozwiązaniem? Napisz: [kontakt]