WP Manifestindependent plugin directory
manifest / seo / faq-ai-wordpress

WP AI FAQ Enhanced

by Paweł Zinkiewicz · github.com/pavelzin/faq-ai-wordpress

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/pavelzin/faq-ai-wordpress/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/pavelzin/faq-ai-wordpress ↗

WP AI FAQ

Wtyczka WordPress automatycznie generująca FAQ (Frequently Asked Questions) z treści postów przy użyciu OpenAI API. Dodaje structured data (JSON-LD) dla lepszego SEO.

✨ Funkcje

  • 🤖 Automatyczne generowanie FAQ - przy publikowaniu nowych postów
  • 📊 JSON-LD structured data - lepsze SEO i rich snippets w Google
  • ⚡ Prosty w użyciu - działa automatycznie po konfiguracji
  • �� Panel administracyjny - łatwa konfiguracja klucza API
  • 🚫 Brak duplikatów - nie generuje FAQ ponownie dla istniejących postów
  • 📏 Filtr długości - pomija krótkie posty (mniej niż 300 znaków)

📋 Wymagania

  • WordPress 5.0 lub nowszy
  • PHP 7.4 lub nowszy
  • Klucz API OpenAI

🚀 Instalacja

Metoda 1: Upload pliku ZIP

  1. Pobierz najnowszą wersję z Releases
  2. W panelu WordPress idź do Wtyczki → Dodaj nową → Wgraj wtyczkę
  3. Wybierz pobrany plik ZIP i kliknij Zainstaluj
  4. Aktywuj wtyczkę

Metoda 2: Ręczna instalacja

  1. Pobierz lub sklonuj to repozytorium
  2. Skopiuj folder do katalogu /wp-content/plugins/wp-ai-faq/
  3. W panelu WordPress idź do Wtyczki i aktywuj WP AI FAQ

⚙️ Konfiguracja

  1. Po aktywacji idź do Ustawienia → WP AI FAQ
  2. Wprowadź swój klucz API OpenAI
  3. Kliknij Zapisz zmiany

📖 Użytkowanie

  1. Utwórz nowy post z treścią dłuższą niż 300 znaków
  2. Opublikuj post
  3. FAQ zostanie automatycznie wygenerowane i pojawi się na dole posta
  4. Structured data (JSON-LD) zostanie dodane do kodu dla SEO

Przykład wygenerowanego FAQ

Na podstawie artykułu o akcyzie na samochody, wtyczka wygeneruje:

FAQ

  • Jakie są stawki akcyzy na samochody osobowe w Polsce?
    Stawki wynoszą 3,1% dla silników do 2.0l, 18,6% powyżej 2.0l i 0% dla aut elektrycznych.

  • Kto musi płacić akcyzę na samochody?
    Akcyza dotyczy osób fizycznych, firm oraz importerów samochodów.

🔧 Jak to działa

  1. Hook save_post - reaguje na publikowanie postów
  2. Filtrowanie treści - usuwa HTML i sprawdza długość
  3. Wywołanie OpenAI API - model gpt-4o-mini generuje FAQ
  4. Parsowanie JSON - wyciąga dane z odpowiedzi markdown
  5. Zapis do meta - przechowuje FAQ w _wp_ai_faq meta field
  6. Wyświetlanie - dodaje FAQ na frontend + JSON-LD schema

🎯 SEO Korzyści

  • Rich Snippets - FAQ może być wyświetlane w wynikach Google
  • Structured Data - JSON-LD schema.org dla lepszej indeksacji
  • Więcej treści - dodatkowe słowa kluczowe na stronie
  • User Experience - szybsze odpowiedzi na częste pytania

��️ Rozwijanie

Funkcje API

  • wp_ai_faq_generate($post_id, $post) - generuje FAQ dla posta
  • wp_ai_faq_call_openai($content) - wywołuje OpenAI API
  • wp_ai_faq_display($content) - wyświetla FAQ na frontend
  • wp_ai_faq_settings_page() - panel ustawień

Meta fields

  • _wp_ai_faq - przechowuje wygenerowane FAQ jako array

🔒 Bezpieczeństwo (v1.7.1)

Wersja 1.7.1 zawiera kompleksowe poprawki bezpieczeństwa:

  • Brak hardcoded kluczy - wymaga konfiguracji własnego klucza API
  • Sanityzacja danych - ochrona przed XSS w pytaniach i odpowiedziach FAQ
  • Weryfikacja nonce - ochrona przed CSRF dla wszystkich operacji AJAX
  • Bezpieczne JSON-LD - prawidłowe kodowanie z flagami bezpieczeństwa
  • Sprawdzanie uprawnień - tylko autoryzowani użytkownicy mogą generować FAQ
  • Bezpieczne logowanie - logi tylko w trybie debug, bez wrażliwych danych

Zalecenia przed produkcją

  1. Upewnij się że WP_DEBUG jest ustawione na false
  2. Skonfiguruj własny klucz API OpenAI
  3. Używaj HTTPS na stronie

🐛 Troubleshooting

FAQ się nie generuje

  1. Sprawdź czy klucz API jest prawidłowy w Ustawienia → WP AI FAQ
  2. Upewnij się że post ma więcej niż 300 znaków
  3. Sprawdź logi błędów WordPress w wp-content/debug.log

FAQ się nie wyświetla

  1. Sprawdź czy jesteś na pojedynczym poście (nie archiwum)
  2. Upewnij się że FAQ zostało wygenerowane (sprawdź w bazie: meta_key _wp_ai_faq)
  3. Sprawdź czy motyw nie blokuje filtra the_content

Błędy OpenAI API

  • 401 Unauthorized - nieprawidłowy klucz API
  • 429 Rate Limit - przekroczony limit requestów
  • 500 Internal Error - problem z serwerem OpenAI

📊 Koszty

Wtyczka używa modelu gpt-4o-mini który kosztuje:

  • Input: $0.15 / 1M tokenów
  • Output: $0.60 / 1M tokenów

Przykładowy post 1000 słów ≈ 1500 tokenów ≈ $0.0001-0.001 za FAQ.

🤝 Współpraca

  1. Fork repozytorium
  2. Stwórz branch dla swojej funkcji (git checkout -b feature/amazing-feature)
  3. Commit zmiany (git commit -m 'Add amazing feature')
  4. Push do branch (git push origin feature/amazing-feature)
  5. Otwórz Pull Request

📝 Licencja

Ta wtyczka jest udostępniona na licencji GPL v2 lub nowszej.

👨‍💻 Autor

Paweł Żin

📞 Wsparcie

Jeśli masz problemy lub pytania:

  1. Sprawdź Issues
  2. Utwórz nowy Issue
  3. Przejrzyj dokumentację powyżej