Verfügbare Hooks und Filter in Product Feed Pro

Product Feed Pro löst eine große Anzahl von WordPress-Aktions- und Filter-Hooks während der Feed-Erstellung, der Feed-Generierung und auf den Admin-Seiten aus. Verwenden Sie diese, um eigene Felder zum Feed-Editor hinzuzufügen, zu ändern, welche Daten in einen Feed gelangen, oder um die Admin-Benutzeroberfläche des Plugins zu erweitern, ohne die Plugin-Dateien direkt zu bearbeiten.

Dies ist eine Entwicklerreferenz. Sie setzt voraus, dass Sie mit dem Hinzufügen von Code über ein benutzerdefiniertes Plugin oder die functions.php-Datei Ihres Themes vertraut sind. Wenn Sie neu bei WordPress-Hooks sind, lesen Sie zuerst das WordPress Plugin Handbook zu Hooks.

Außerdem verlassen sich Product Feed Elite und andere AdTribes-Add-ons auf viele der gleichen Hooks, um Product Feed Pro zu erweitern. Wo ein Hook speziell dafür existiert, dass ein Add-on in das Kernverhalten eingreift, wird dies unten vermerkt.

Wie Hooks in die Feed-Pipeline passen

Ein Feed-Generierungslauf hat drei Phasen: Das Plugin löst die Einstellungen des Feeds auf und startet einen Stapel von Produkten, es durchläuft die Produkte und erstellt die Datenzeile für jedes Produkt, dann schreibt es die fertigen Zeilen in die Feed-Datei und schließt ab. Hooks unter Feed-Generierung und Stapelverarbeitung und die meisten Filter unter Produktdaten und Feed-Ausgabe werden während der mittleren Phase ausgelöst, einmal pro Produkt oder einmal pro Stapel. Hooks unter Feed-Bearbeitungsassistent und Admin-Seiten, Einstellungen und Benachrichtigungen werden nur ausgelöst, wenn jemand den WordPress-Admin verwendet (einen Feed erstellt, bearbeitet oder verwaltet), nicht während einer geplanten Feed-Aktualisierung. Beachten Sie dies bei der Auswahl eines Hooks: Ein Filter, der die Daten eines einzelnen Produkts ändert, wirkt sich nur auf zukünftige Feed-Generierungen aus, während eine Aktion, die an den Feed-Bearbeitungsbildschirm gebunden ist, nur ausgeführt wird, wenn eine Person aktiv in diesem Bildschirm arbeitet.

Aktionen

Aktionen sind Hooks, die WordPress zu bestimmten Zeitpunkten während der Ausführung oder bei bestimmten Ereignissen ausführt.

Admin-Seiten, Menüs und Benachrichtigungen

Feed-Lebenszyklus: erstellen, klonen, löschen und abbrechen

Feed-Bearbeitungsassistent: Tab-Verarbeitung

Jeder Tab des Bildschirms Feed bearbeiten löst beim Absenden seines Formulars ein Hook-Paar aus: einen Filter, mit dem Sie ändern können, was gespeichert wird, und eine Aktion, die unmittelbar nach dem Speichern ausgelöst wird. Alle lösen auch von der entsprechenden Abilities API-Aktion aus, wo eine existiert.

Feed-Bearbeitungsassistent: Template-Injektionspunkte

Feed-Generierung und Stapelverarbeitung

Filter

Filter sind Hooks, die Daten modifizieren, bevor sie verwendet werden, sei es ein im Admin angezeigter Wert, eine Abfrage oder Daten, die in die Feed-Datei geschrieben werden.

Filter- und Regel-Engine

Die Tabs „Filter“ und „Regeln“ von Product Feed Pro ermöglichen es einem Shop-Betreiber, Produkte basierend auf Bedingungen einzuschließen, auszuschließen oder zu transformieren. Diese Filter erweitern diese Engine.

Produktdaten und Feed-Ausgabe

Adaptive Batch-Größenanpassung

Neu in Product Feed Pro 13.5.7. Anstatt einer festen Anzahl von Produkten pro Batch kann das Plugin jetzt jeden Batch automatisch anhand der Dauer und des Speicherverbrauchs des vorherigen Batches dimensionieren. Diese Filter geben Ihnen die Kontrolle über dieses Verhalten.

Exportieren und importieren

Versanddaten

Preise, Währung und Formatierung

Kategorien, Attribute und Feldzuordnung

Aufträge und Verkäufe Rückblick

Admin-Seiten, Einstellungen und Benachrichtigungen

Bereinigung und HTML-Ausgabe

Abilities API und Tracking

Product Feed Pro registriert eine Reihe von Aktionen bei der WordPress Abilities API, einem aufkommenden Standard zum Auslagern von Plugin-Funktionalitäten an KI-Agenten und Automatisierungstools.

Assets und Post-Typ

Häufige Anpassungsbeispiele

Diese Beispiele verwenden echte Hook-Signaturen, die gegen den aktuellen Plugin-Code verifiziert wurden. Fügen Sie sie zu einem benutzerdefinierten Plugin oder zur functions.php Ihres Themes hinzu.

Fügen Sie Ihre eigene Feed-Eigenschaft zu Export/Import hinzu

adt_pfp_export_feed_data_properties empfängt die Liste der Product_Feed-Eigenschaftsschlüssel, die das Export/Import-Tool liest, plus den zu exportierenden Feed:

add_filter( 'adt_pfp_export_feed_data_properties', 'my_custom_export_property', 10, 2 );
function my_custom_export_property( $data_properties, $feed ) {
    $data_properties[] = 'my_custom_property';
    return $data_properties;
}

Jede Eigenschaft, die Ihr Code hinzufügt und die das Feed-Objekt nicht tatsächlich hat, wird sicher übersprungen. Daher ist es sicher, dies auch für Eigenschaften hinzuzufügen, die nur vorhanden sind, wenn Ihr eigenes Add-on aktiv ist.

Fügen Sie eine Einstellungszeile zum Tab "Allgemein" hinzu

adt_general_feed_settings_after_shipping_countries wird direkt nach der Zeile "Alle Versandländer einschließen" im Tab "Allgemein" ausgelöst und empfängt den bearbeiteten Feed:

add_action( 'adt_general_feed_settings_after_shipping_countries', 'my_custom_general_tab_row' );
function my_custom_general_tab_row( $feed ) {
    echo '<tr><td>My setting</td><td>...</td></tr>';
}

Speichern Sie den Wert des neuen Feldes aus dem adt_edit_feed_general_tab_props-Filter, der ausgeführt wird, wenn das Formular des Tabs "Allgemein" übermittelt wird, damit Ihre Einstellung tatsächlich in den Feed geschrieben wird.

Registrieren und auswerten einer benutzerdefinierten Filterbedingung

Das Hinzufügen einer funktionierenden benutzerdefinierten Bedingung zum Filter- und Regel-Builder erfordert zwei Hooks zusammen: einen, um sie zum Dropdown-Menü hinzuzufügen, und einen, um sie auszuwerten, wenn ein Feed ausgeführt wird.

add_filter( 'adt_pfp_get_filters_rules_conditions', 'my_custom_condition' );
function my_custom_condition( $conditions ) {
    $conditions[] = array(
        'value' => 'starts_with',
        'label' => __( 'Starts with', 'my-textdomain' ),
    );
    return $conditions;
}

add_filter( 'adt_pfp_evaluate_filters_rules_condition', 'my_evaluate_starts_with', 10, 5 );
function my_evaluate_starts_with( $result, $condition, $product_value, $filter_value, $case_sensitive ) {
    if ( 'starts_with' !== $condition ) {
        return $result;
    }
    return 0 === ( $case_sensitive ? strpos( $product_value, $filter_value ) : stripos( $product_value, $filter_value ) );
}

Das Registrieren der Bedingung, ohne sie auch in adt_pfp_evaluate_filters_rules_condition zu behandeln, führt dazu, dass sie nichts tut, wenn ein Feed ausgeführt wird, da nichts dem Plugin sagt, wie es sie überprüfen soll.

Deaktivieren Sie die adaptive Stapelgrößenanpassung für einen Feed

adt_product_feed_adaptive_batch_enabled empfängt den aktuellen Standardwert und die ID des Feeds:

add_filter( 'adt_product_feed_adaptive_batch_enabled', 'my_disable_adaptive_batching', 10, 2 );
function my_disable_adaptive_batching( $enabled, $feed_id ) {
    if ( 123 === $feed_id ) {
        return false;
    }
    return $enabled;
}

Ersetzen Sie 123 durch die ID Ihres Feeds (sichtbar in der Bearbeitungs-URL des Feeds), damit dies nur diesen einen Feed betrifft und jeder andere Feed weiterhin adaptive Größenanpassung verwendet.

FAQ

Benötigen Sie weitere Hilfe?

Wenn Sie Product Feed Elite oder ein anderes Premium-AdTribes-Plugin verwenden und Hilfe bei einer spezifischen Anpassung benötigen, öffnen Sie ein Support-Ticket und das Team kann Sie auf den richtigen Hook für Ihren Anwendungsfall hinweisen.

Wenn Sie das kostenlose Product Feed Pro-Plugin verwenden, stellen Sie Ihre Frage im WordPress.org-Supportforum.