Dostępne haki i filtry w Product Feed Pro

Product Feed Pro uruchamia duży zestaw haków akcji i filtrów WordPress podczas tworzenia pliku, generowania pliku i ekranów administracyjnych. Użyj ich, aby dodać własne pola do edytora pliku, zmienić dane, które trafiają do pliku, lub rozszerzyć interfejs użytkownika wtyczki bez bezpośredniej edycji plików wtyczki.

Jest to referencja dla deweloperów. Zakłada się, że czujesz się komfortowo z dodawaniem kodu za pomocą niestandardowej wtyczki lub pliku functions.php motywu. Jeśli dopiero zaczynasz przygodę z hakami WordPress, najpierw przeczytaj Podręcznik wtyczek WordPress dotyczący haków.

Ponadto, Product Feed Elite i inne dodatki AdTribes polegają na wielu tych samych hakach, aby rozszerzyć Product Feed Pro. Tam, gdzie hak istnieje specjalnie po to, aby dodatek mógł podłączyć się do podstawowego zachowania, jest to zaznaczone poniżej.

Jak haki pasują do potoku generowania pliku

Uruchomienie generowania pliku ma trzy etapy: wtyczka rozwiązuje ustawienia pliku i rozpoczyna przetwarzanie partii produktów, przechodzi przez produkty i buduje wiersz danych dla każdego z nich, a następnie zapisuje ukończone wiersze do pliku i kończy pracę. Haki w sekcji Generowanie pliku i przetwarzanie wsadowe oraz większość filtrów Dane produktu i wyjście pliku działają podczas środkowego etapu, raz na produkt lub raz na partię. Haki w sekcjach Edytor pliku i Strony administracyjne, ustawienia i powiadomienia działają tylko wtedy, gdy ktoś korzysta z panelu administracyjnego WordPress (tworząc, edytując lub zarządzając plikiem), a nie podczas zaplanowanego odświeżania pliku. Pamiętaj o tym przy wyborze haka: filtr, który zmienia dane jednego produktu, wpływa tylko na przyszłe generowanie plików, podczas gdy akcja powiązana z ekranem Edycji pliku działa tylko wtedy, gdy osoba aktywnie pracuje na tym ekranie.

Akcje

Akcje to haki, które WordPress uruchamia w określonych punktach podczas wykonania lub gdy wystąpią określone zdarzenia.

Strony administracyjne, menu i powiadomienia

Cykl życia kanału: tworzenie, klonowanie, usuwanie i anulowanie

Kreator edycji kanału: przetwarzanie zakładek

Każda zakładka ekranu Edytuj kanał uruchamia parę haków po przesłaniu jej formularza: filtr, którego można użyć do zmiany tego, co zostanie zapisane, oraz akcję, która uruchamia się tuż po zapisaniu. Wszystkie uruchamiają się również z równoważnej akcji Abilities API, jeśli taka istnieje.

Kreator edycji kanału: punkty wstrzykiwania szablonu

Generowanie kanału i przetwarzanie wsadowe

Filtry

Filtry to haki, które modyfikują dane przed ich użyciem, niezależnie od tego, czy jest to wartość wyświetlana w panelu administracyjnym, zapytanie, czy dane zapisane w pliku kanału.

Silnik filtrów i reguł

Zakładki Filtry i Reguły w Product Feed Pro pozwalają właścicielowi sklepu na uwzględnianie, wykluczanie lub transformowanie produktów na podstawie warunków. Te filtry rozszerzają ten silnik.

Dane produktu i dane wyjściowe kanału

Adaptacyjne rozmiary partii

Nowość w Product Feed Pro 13.5.7. Zamiast stałej liczby produktów na partię, wtyczka może teraz automatycznie dostosowywać rozmiar każdej partii na podstawie czasu trwania poprzedniej partii i zużytej pamięci. Te filtry dają Ci kontrolę nad tym zachowaniem.

Eksport i import

Dane wysyłki

Ceny, waluta i formatowanie

Kategorie, atrybuty i mapowanie pól

Okresy i sprzedaż wstecz

Strony administracyjne, ustawienia i powiadomienia

Sanitization i dane wyjściowe HTML

API zdolności i śledzenie

Product Feed Pro rejestruje zestaw akcji w WordPress Abilities API, rozwijającym się standardzie udostępniania funkcjonalności wtyczki agentom AI i narzędziom automatyzacji.

Zasoby i typ posta

Przykłady typowych dostosowań

Te przykłady używają rzeczywistych sygnatur haków zweryfikowanych pod kątem bieżącego kodu wtyczki. Dodaj je do niestandardowej wtyczki lub pliku functions.php swojego motywu.

Dodaj własną właściwość kanału do Eksportu/Importu

adt_pfp_export_feed_data_properties otrzymuje listę kluczy właściwości Product_Feed, które narzędzie Eksport/Import odczytuje, plus eksportowany kanał:

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

Każda właściwość dodana przez Twój kod, której obiekt kanału faktycznie nie posiada, jest bezpiecznie pomijana, więc można ją bezpiecznie dodać nawet dla właściwości, które istnieją tylko wtedy, gdy Twój własny dodatek jest aktywny.

Dodaj wiersz ustawień do zakładki Ogólne

adt_general_feed_settings_after_shipping_countries uruchamia się bezpośrednio po wierszu „Uwzględnij wszystkie kraje wysyłki” w zakładce Ogólne i otrzymuje edytowany kanał:

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

Zapisz wartość nowego pola z filtra adt_edit_feed_general_tab_props, który uruchamia się po przesłaniu formularza zakładki Ogólne, dzięki czemu Twoje ustawienie jest faktycznie zapisywane w kanale.

Zarejestruj i oceń niestandardowy warunek filtra

Dodanie działającego niestandardowego warunku do konstruktora Filtrów i Reguł wymaga połączenia dwóch haków: jednego do dodania go do listy rozwijanej i jednego do jego oceny podczas uruchamiania kanału.

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

Zarejestrowanie warunku bez jego obsługi w adt_pfp_evaluate_filters_rules_condition sprawia, że nic nie robi on podczas uruchamiania kanału, ponieważ nic nie mówi wtyczce, jak go sprawdzić.

Wyłącz adaptacyjne rozmiary partii dla jednego kanału

adt_product_feed_adaptive_batch_enabled otrzymuje bieżącą wartość domyślną i identyfikator kanału:

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

Zastąp 123 identyfikatorem swojego kanału (widocznym w adresie URL edycji kanału), aby wpłynąć tylko na ten jeden kanał, a wszystkie inne kanały nadal korzystały z adaptacyjnego rozmiaru.

FAQ

Potrzebujesz więcej pomocy?

Jeśli korzystasz z Product Feed Elite lub innej płatnej wtyczki AdTribes i potrzebujesz pomocy z konkretnym dostosowaniem, otwórz zgłoszenie wsparcia, a zespół wskaże Ci odpowiedni hak dla Twojego przypadku użycia.

Jeśli korzystasz z darmowej wtyczki Product Feed Pro, zadaj pytanie na forum wsparcia WordPress.org.