Beschikbare hooks en filters in Product Feed Pro

Product Feed Pro activeert een groot aantal WordPress actie- en filterhooks tijdens het maken van feeds, het genereren van feeds en de admin-schermen. Gebruik ze om uw eigen velden toe te voegen aan de feed-editor, te wijzigen welke gegevens in een feed terechtkomen, of de admin UI van de plugin uit te breiden zonder de plugin-bestanden direct te bewerken.

Dit is een ontwikkelaarsreferentie. Het gaat ervan uit dat u comfortabel bent met het toevoegen van code via een aangepaste plugin of het functions.php bestand van uw thema. Als u nieuw bent met WordPress hooks, lees dan eerst de WordPress Plugin Handbook over hooks.

Ook Product Feed Elite en andere AdTribes add-ons maken gebruik van veel van dezelfde hooks om Product Feed Pro uit te breiden. Waar een hook specifiek bestaat zodat een add-on kan inkapselen in het kern gedrag, wordt dat hieronder vermeld.

Hoe hooks passen in de feed-pipeline

Een feedgeneratieronde heeft drie fasen: de plugin lost de instellingen van de feed op en start een batch producten, het loopt over producten en bouwt de gegevensrij van elk product op, vervolgens schrijft het de voltooide rijen naar het feedbestand en rondt het af. Hooks onder Feedgeneratie en batchverwerking en de meeste filters onder Productgegevens en feeduitvoer worden geactiveerd tijdens de middelste fase, eenmaal per product of eenmaal per batch. Hooks onder Feed-editor wizard en Admin-pagina's, instellingen en meldingen worden alleen geactiveerd wanneer iemand de WordPress-admin gebruikt (een feed aanmaakt, bewerkt of beheert), niet tijdens een geplande feedverversing. Houd hier rekening mee bij het kiezen van een hook: een filter dat de gegevens van één product wijzigt, heeft alleen invloed op toekomstige feedgeneraties, terwijl een actie die is gekoppeld aan het scherm Feed-editor alleen wordt uitgevoerd wanneer een persoon actief in dat scherm werkt.

Acties

Acties zijn hooks die WordPress uitvoert op specifieke punten tijdens de uitvoering, of wanneer specifieke gebeurtenissen plaatsvinden.

Admin-pagina's, menu's en meldingen

Feed levenscyclus: aanmaken, klonen, verwijderen en annuleren

Feed-editor: verwerkings-tabblad

Elk tabblad van het scherm Feed bewerken vuurt een paar hooks af wanneer het formulier wordt verzonden: een filter dat u kunt gebruiken om te wijzigen wat er wordt opgeslagen, en een actie die direct wordt geactiveerd nadat het is opgeslagen. Ze worden allemaal ook geactiveerd vanuit de equivalente Abilities API-actie waar deze bestaat.

Feed-editor: sjabloon-injectiepunten

Feedgeneratie en batchverwerking

Filters

Filters zijn hooks die gegevens wijzigen voordat ze worden gebruikt, of het nu een waarde is die in de admin wordt weergegeven, een query, of gegevens die naar het feedbestand worden geschreven.

Filters en regels-engine

De tabbladen Filters en Regels van Product Feed Pro laten een winkelier producten opnemen, uitsluiten of transformeren op basis van voorwaarden. Deze filters breiden die engine uit.

Productgegevens en feed-output

Adaptieve batchgrootte

Nieuw in Product Feed Pro 13.5.7. In plaats van een vast aantal producten per batch, kan de plugin nu elke batch automatisch op grootte instellen op basis van hoe lang de vorige batch duurde en hoeveel geheugen deze gebruikte. Deze filters geven u controle over dat gedrag.

Exporteren en importeren

Verzendgegevens

Prijzen, valuta en opmaak

Categorieën, attributen en veldmapping

Orders en verkopen terugkijkperiode

Adminpagina's, instellingen en meldingen

Sanering en HTML-uitvoer

Abilities API en tracking

Product Feed Pro registreert een reeks acties met de WordPress Abilities API, een opkomende standaard voor het blootstellen van plugin-functionaliteit aan AI-agenten en automatiseringshulpmiddelen.

Assets en post type

Veelvoorkomende aanpassingvoorbeelden

Deze voorbeelden gebruiken echte hook-handtekeningen die zijn geverifieerd tegen de huidige plugin-code. Voeg ze toe aan een aangepaste plugin of aan het functions.php-bestand van uw thema.

Voeg uw eigen feed-eigenschap toe aan Export/Import

adt_pfp_export_feed_data_properties ontvangt de lijst met Product_Feed-eigenschapssleutels die de Export/Import-tool leest, plus de feed die wordt geëxporteerd:

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;
}

Elke eigenschap die uw code toevoegt en die het feed-object niet daadwerkelijk heeft, wordt veilig overgeslagen, dus het is veilig om dit toe te voegen, zelfs voor eigenschappen die alleen bestaan wanneer uw eigen add-on actief is.

Voeg een instellingenrij toe aan het tabblad Algemeen

adt_general_feed_settings_after_shipping_countries wordt direct na de rij "Alle verzendlanden opnemen" op het tabblad Algemeen geactiveerd en ontvangt de feed die wordt bewerkt:

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>';
}

Sla de waarde van het nieuwe veld op via de adt_edit_feed_general_tab_props-filter, die wordt uitgevoerd wanneer het formulier van het tabblad Algemeen wordt verzonden, zodat uw instelling daadwerkelijk naar de feed wordt geschreven.

Registreer en evalueer een aangepaste filterconditie

Het toevoegen van een werkende aangepaste conditie aan de builder voor filters en regels vereist twee hooks samen: één om deze toe te voegen aan de dropdown, en één om deze te evalueren wanneer een feed wordt uitgevoerd.

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 ) );
}

Het registreren van de conditie zonder deze ook te verwerken in adt_pfp_evaluate_filters_rules_condition zorgt ervoor dat deze niets doet wanneer een feed wordt uitgevoerd, aangezien niets de plugin vertelt hoe deze moet worden gecontroleerd.

Schakel adaptieve batch-grootte uit voor één feed

adt_product_feed_adaptive_batch_enabled ontvangt de huidige standaardwaarde en de ID van de feed:

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;
}

Vervang 123 door de ID van uw feed (zichtbaar in de bewerkings-URL van de feed), zodat dit slechts één feed beïnvloedt en elke andere feed adaptieve dimensionering blijft gebruiken.

Veelgestelde vragen

Meer hulp nodig?

Als u Product Feed Elite of een andere premium AdTribes-plugin gebruikt en hulp nodig heeft met een specifieke aanpassing, opent u een ondersteuningsticket en het team kan u naar de juiste hook voor uw gebruikssituatie wijzen.

Als u de gratis Product Feed Pro-plugin gebruikt, stel uw vraag dan op het WordPress.org-ondersteuningsforum.