Předvyplnění prodejního formuláře

V určitých případech může být užitečné automaticky předvyplnit vybraná pole prodejního formuláře FAPI na webové stránce konkrétními údaji klienta.

Toho můžete snadno docílit pomocí speciálních parametrů vložených do URL adresy stránky s prodejním formulářem. Předvyplnění formuláře funguje jen při změně URL adresy webu. URL skriptu níže popisovaným způsobem měnit nelze.

Jaké údaje lze předvyplnit?

Pro předvyplnění prodejního formuláře je možné použít následující parametry:

• fapi-form-name= (Jméno)
• fapi-form-surname= (Příjmení)
• fapi-form-email= (E-mailová adresa)
• fapi-form-mobil= (Mobil)
• fapi-form-street= (Ulice)
• fapi-form-city= (Město)
• fapi-form-postcode= (PSČ)
• fapi-form-state= (Stát)
• fapi-form-company= (Firma)
• fapi-form-ic= (IČ)
• fapi-form-dic= (DIČ)
• fapi-form-notes= (Poznámka)
• fapi-form-discountCode= (Slevový kód)
• fapi-form-customField-{id} (Vlastní pole)
• fapi-form-item-{product_code}=1 (předvybrání /=1/ nebo vypnutí /=0/ označení produktu) 
• fapi-form-item-count-{product_code}=10 (Nastavení počet produktů k zakoupení, pouze v případě že se ve formuláři dá počet zakoupených produktů měnit) 
• fapi-form-repayment=1 (předvybrání /=1/ nebo vypnutí /=0/ splátek)

Formát zápisu

Parametry se do URL adresy stránky vkládají spolu s hodnotou, která se má předvyplnit do příslušného pole prodejního formuláře.

Obecný formát zápisu je následující:

?název_parametru_1=hodnota_parametru_1&název_parametru_2=hodnota_parametru_2&...

Příklady použití

Předvyplnění e-mailové adresy, jména a příjmení klienta a poznámky (Jan Malý, jan.maly@seznam.cz, VIP):

?fapi-form-email=jan.maly@seznam.cz&fapi-form-name=Jan&fapi-form-surname=Malý&fapi-form-notes=VIP

Předvyplnění státu (Dánsko):

?fapi-form-state=DK

Předvyplnění vlastního pole (sobota):

?fapi-form-customField-20=sobota

Programové vyplnění prodejního formuláře

Formulář jde do jisté míry vyplnit i programově. Prodejní formulář při každém vložení do stránky publikuje událost "fapiFormMounted", v detailu této události je html element samotného formuláře. S kterým se dá dále pracovat. 

Ukázka, jak se dá vyplnit emailová adresa a zaškrtnout checkbox pro zadání fakturačních údajů.

<script>
   // naslouchání na událost, která říká že je formulář vložený do stránky
   document.addEventListener('fapiFormMounted', function (event) {
      console.log(event); // vypsání eventu do konzole
      console.log(event.detail.formWrapper); // vypsání elementu formulář do konzole
      console.log(event.detail.formWrapper.id) // vypsání ID do konzole, ID je pro každé vykreslení formuláře unikátní
      var formElement = event.detail.formWrapper;

      // získání inputu pro emailovou adresu, změna hodnoty a vyvolání eventu, která je potřeba pro správné fungování formuláře
      var emailInput = formElement.querySelector('input[name="email"]');
      emailInput.value = 'jirka@fapi.cz'
      emailInput.dispatchEvent(new Event('blur'))
      console.log(emailInput); // vypsání emailového inputu do konzole

      // získání checkboxu pro zadání fakturačních údajů, změna hodnoty a vyvolání eventu, která je potřeba pro správné fungování formuláře
      var checkboxInput = formElement.querySelector('input[name*="show_full_form.name"]');
      checkboxInput.checked = 'checked';
      checkboxInput.dispatchEvent(new Event('change'))
      console.log(checkboxInput); // vypsání checkboxu do konzole
   })
</script>

Zrušení předvyplnění prvního produktu

Zruší předvybrání 1. produktu v prodejním formuláři.

Script funguje pouze pro zaškrtávací políčka (checkboxy) ne pro výber v z jedné varianty (radio buttony).

<script>
	document.addEventListener('fapiFormMounted', function (event) {
		var formElement = event.detail.formWrapper;
		var formItems = formElement.querySelector('.fapi-form-items');
		var checkInputs = formItems.querySelectorAll('input[type="checkbox"]');
		if (checkInputs[0]) {
			setTimeout(function () {
				checkInputs[0].click();
			}, 250);
		}
	});
</script>