Hooky a filtry

Plugin WPify Raynet poskytuje filtry pro úpravu dat před odesláním do Raynet CRM.

Datové filtry (dle integrace)

Každá integrace formulářového pluginu má vlastní filtr, volaný těsně před odesláním dat do Raynetu. Použijte je pro úpravu, obohacení nebo validaci dat leadu.

wpify_raynet_cf7_data

Filtruje data Contact Form 7 před odesláním do Raynetu.

apply_filters( 'wpify_raynet_cf7_data', RaynetData $raynet_data, array $form, array $cf7_data );

Parametry:

$raynet_data (RaynetData) — Objekt dat leadu
$form (array) — Konfigurace mapování formuláře
$cf7_data (array) — Surová data z CF7

Příklad — přidání poznámky o zdroji:

/**
 * Přidání poznámky o zdroji leadu z Contact Form 7
 *
 * @param RaynetData $raynet_data Objekt dat leadu
 * @param array      $form        Konfigurace formuláře
 * @param array      $cf7_data    Data z CF7
 * @return RaynetData
 */
function my_cf7_add_source_notice( $raynet_data, $form, $cf7_data ) {
    $raynet_data->notice = 'Zdroj: kontaktní formulář na webu';

    return $raynet_data;
}
add_filter( 'wpify_raynet_cf7_data', 'my_cf7_add_source_notice', 10, 3 );

Příklad — přidání vlastních polí z CF7:

/**
 * Přidání vlastních polí z CF7 formuláře do leadu
 *
 * @param RaynetData $raynet_data Objekt dat leadu
 * @param array      $form        Konfigurace formuláře
 * @param array      $cf7_data    Data z CF7
 * @return RaynetData
 */
function my_cf7_custom_fields( $raynet_data, $form, $cf7_data ) {
    // Přidání produktového zájmu z CF7 pole
    if ( ! empty( $cf7_data['product-interest'] ) ) {
        $raynet_data->custom_fields['product_interest'] = $cf7_data['product-interest'];
    }

    return $raynet_data;
}
add_filter( 'wpify_raynet_cf7_data', 'my_cf7_custom_fields', 10, 3 );

wpify_raynet_fluent_data

Filtruje data Fluent Forms před odesláním do Raynetu.

apply_filters( 'wpify_raynet_fluent_data', RaynetData $raynet_data, array $form, array $form_data );

Parametry:

$raynet_data (RaynetData) — Objekt dat leadu
$form (array) — Konfigurace mapování formuláře
$form_data (array) — Surová data z Fluent Forms

wpify_raynet_ninja_data

Filtruje data Ninja Forms před odesláním do Raynetu.

apply_filters( 'wpify_raynet_ninja_data', RaynetData $raynet_data, array $form, array $form_data );

Parametry:

$raynet_data (RaynetData) — Objekt dat leadu
$form (array) — Konfigurace mapování formuláře
$form_data (array) — Surová data z Ninja Forms

wpify_raynet_wpforms_data

Filtruje data WP Forms před odesláním do Raynetu.

apply_filters( 'wpify_raynet_wpforms_data', RaynetData $raynet_data, array $form, $entry );

Parametry:

$raynet_data (RaynetData) — Objekt dat leadu
$form (array) — Konfigurace mapování formuláře
$entry (array) — Surová data z WP Forms

Filtr požadavku

wpify_raynet_request_args

Filtruje finální argumenty API požadavku před odesláním do Raynetu. Poslední filtr aplikovaný před HTTP požadavkem.

apply_filters( 'wpify_raynet_request_args', array $request_args );

Parametry:

$request_args (array) — Argumenty HTTP požadavku včetně hlaviček, těla atd.

Příklad — přidání vlastního pole do API požadavku:

/**
 * Přidání vlastního pole do API požadavku
 *
 * @param array $request_args Argumenty požadavku
 * @return array
 */
function my_raynet_custom_field( $request_args ) {
    $request_args['body']['customField1'] = 'vlastni_hodnota';

    return $request_args;
}
add_filter( 'wpify_raynet_request_args', 'my_raynet_custom_field' );

Vlastnosti objektu RaynetData

Objekt $raynet_data předávaný filtrům integrace má následující vlastnosti:

Vlastnost	Typ	Popis
`topic`	string	Předmět leadu (povinné)
`first_name`	string	Křestní jméno
`last_name`	string	Příjmení
`email`	string	Primární email
`email_2`	string	Sekundární email
`phone`	string	Primární telefon
`phone_2`	string	Sekundární telefon
`company_name`	string	Název klienta
`street`	string	Ulice
`city`	string	Město
`postcode`	string	PSČ
`country`	string	Země
`province`	string	Kraj/Region
`www`	string	URL webu
`reg_number`	string	IČO
`other_contact`	string	Jiný kontakt
`notice`	string	Poznámka/popis
`notification_message`	string	Text notifikace
`notification_emails`	array	Emaily k zaslání oznámení
`category`	string	Kategorie leadu (ID z číselníku)
`contact_source`	string	Zdroj kontaktu (ID z číselníku)
`territory`	string	Teritorium (ID z číselníku)
`owner`	string	Vlastník leadu (ID z číselníku)
`lat`	string	Zeměpisná šířka
`lng`	string	Zeměpisná délka
`custom_fields`	array	Vlastní pole (klíč-hodnota)

Kde umístit kód

Vlastní funkci můžete vložit buď do tzv. child šablony nebo pomocí pluginu Code Snippets.