FAQ (Frequently Asked Questions)

Das FAQ-Modul ermöglicht es Ihnen, einen Bereich mit häufig gestellten Fragen in Ihrem Shop zu erstellen und anzuzeigen. Die Fragen werden als eigener Beitragstyp (CPT) mit eigener Kategorie-Taxonomie gespeichert, was eine flexible Verwaltung und Anzeige erlaubt.

Modul aktivieren

Gehen Sie zu WooCommerce > Polski > Storefront-Module und aktivieren Sie FAQ (Modul-ID: faq).

Nach der Aktivierung erscheint im Admin-Menü ein neuer Eintrag FAQ mit Unterseiten zur Verwaltung von Fragen und Kategorien.

Administrationsbereich

Die Verwaltung der FAQ-Fragen erfolgt unter FAQ (edit.php?post_type=polski_faq). Die Oberfläche funktioniert genauso wie standardmäßige WordPress-Beiträge.

Eine Frage hinzufügen

1. Gehen Sie zu FAQ > Neu hinzufügen
2. Geben Sie den Fragetext im Titelfeld ein
3. Geben Sie die Antwort im Editor ein (der vollständige Block-Editor wird unterstützt)
4. Weisen Sie eine FAQ-Kategorie zu (optional)
5. Legen Sie die Anzeigereihenfolge im Feld Reihenfolge fest (menu_order)
6. Veröffentlichen

FAQ-Kategorien

Die Taxonomie faq_category ermöglicht es Ihnen, Fragen thematisch zu gruppieren. Verwalten Sie die Kategorien unter FAQ > FAQ-Kategorien.

Beispielkategorien:

• Bestellungen und Zahlungen
• Lieferung und Rücksendungen
• Kundenkonto
• Produkte

Der Shortcode [polski_faq]

Zeigt eine Liste der FAQ-Fragen als CSS-Akkordeon an.

Parameter

Parameter	Typ	Standard	Beschreibung
category	string	(leer)	Der Slug der anzuzeigenden FAQ-Kategorie
limit	int	-1	Die maximale Anzahl der Fragen (-1 = alle)
orderby	string	menu_order	Das Sortierfeld: menu_order, title, date
order	string	ASC	Die Sortierrichtung: ASC oder DESC

Anwendungsbeispiele

Alle Fragen anzeigen:

[polski_faq]

Fragen aus der Kategorie “dostawa” anzeigen:

[polski_faq category="dostawa" limit="5"]

Die 10 neuesten Fragen anzeigen:

[polski_faq limit="10" orderby="date" order="DESC"]

Verwendung in einem PHP-Template

echo do_shortcode('[polski_faq category="zamowienia" limit="10"]');

CSS-Akkordeon

Die Fragen werden als Akkordeon angezeigt, ein Klick auf eine Frage klappt ihre Antwort auf. Das Akkordeon funktioniert vollständig mit CSS (ohne JavaScript), was maximale Performance gewährleistet.

Der Mechanismus basiert auf dem HTML-Element <details> mit <summary>:

<div class="polski-faq">
  <details class="polski-faq__item">
    <summary class="polski-faq__question">Wie gebe ich eine Bestellung auf?</summary>
    <div class="polski-faq__answer">
      <p>Um eine Bestellung aufzugeben, legen Sie Produkte in den Warenkorb...</p>
    </div>
  </details>
</div>

CSS-Klassen

• .polski-faq - der FAQ-Container
• .polski-faq__item - eine einzelne Frage (das <details>-Element)
• .polski-faq__question - der Fragetext (das <summary>-Element)
• .polski-faq__answer - der Antwortinhalt
• .polski-faq__category - die Kategorieüberschrift (bei Anzeige mit Gruppierung)

Das Erscheinungsbild anpassen

/* Die Hintergrundfarbe der aktiven Frage ändern */
.polski-faq__item[open] .polski-faq__question {
    background-color: #f0f0f0;
}

/* Das Aufklapp-Symbol ändern */
.polski-faq__question::marker {
    content: "+";
}

.polski-faq__item[open] .polski-faq__question::marker {
    content: "-";
}

Schema.org FAQPage

Das Modul generiert auf Seiten, die den Shortcode [polski_faq] enthalten, automatisch Schema.org-FAQPage-Auszeichnungen im JSON-LD-Format:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Wie gebe ich eine Bestellung auf?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Um eine Bestellung aufzugeben, legen Sie Produkte in den Warenkorb..."
      }
    },
    {
      "@type": "Question",
      "name": "Wie lange dauert die Lieferung?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Die Standardlieferzeit beträgt 2-3 Werktage..."
      }
    }
  ]
}

FAQPage-Auszeichnungen ermöglichen es Google, Fragen und Antworten direkt in den Suchergebnissen anzuzeigen (Rich Snippets).

Schema.org deaktivieren:

add_filter('polski/faq/schema_enabled', '__return_false');

Hooks

Filter

// Die Argumente der FAQ-Abfrage ändern
add_filter('polski/faq/query_args', function (array $args): array {
    $args['posts_per_page'] = 20;
    return $args;
});

// Das Antwort-HTML vor der Anzeige modifizieren
add_filter('polski/faq/answer_html', function (string $html, int $post_id): string {
    return wp_kses_post($html);
}, 10, 2);

Aktionen

// Ein eigenes Element vor dem FAQ-Bereich hinzufügen
add_action('polski/faq/before', function (): void {
    echo '<h2>Haben Sie Fragen? Hier sind die Antworten:</h2>';
});

// Ein eigenes Element nach dem FAQ-Bereich hinzufügen
add_action('polski/faq/after', function (): void {
    echo '<p>Keine Antwort gefunden? <a href="/kontakt">Kontaktieren Sie uns</a>.</p>';
});

Fehlerbehebung

Der Shortcode zeigt einen leeren Container - prüfen Sie, ob Sie FAQ-Fragen veröffentlicht haben. Entwürfe und geplante Beiträge werden nicht angezeigt.

Das Akkordeon funktioniert nicht - stellen Sie sicher, dass das Theme das <details>-Element nicht blockiert. Einige CSS-Reset-Stylesheets können dieses Element ausblenden.

Schema.org erscheint nicht - überprüfen Sie die Auszeichnungen mit dem Google Rich Results Test. Stellen Sie sicher, dass der Shortcode auf der Seite steht (nicht in einem Sidebar-Widget).

Probleme melden: github.com/wppoland/polski/issues

Diese Seite dient ausschließlich zu Informationszwecken und stellt keine Rechtsberatung dar. Polski for WooCommerce ist Open-Source-Software (GPLv2), die ohne Gewährleistung bereitgestellt wird.