Formularz tworzenia

Automatyczne generowanie plików na Twojej stronie - dyplomów, certyfikatów lub innych dokumentów. Wystarczy, że odwiedzający wypełni formularz i otrzyma gotowy plik.

Aby tworzyć pliki, musisz utworzyć formularz HTML na swojej stronie. Jeśli nie jest to możliwe, możesz po prostu skorzystać z widgetu do tworzenia dokumentów.

Tworzenie formularza

Aby wysyłać żądania do DiMaker w celu tworzenia plików, musisz stworzyć formularz na swojej stronie. Formularz może znajdować się zarówno w publicznej, jak i zamkniętej części witryny. Używając swojego CMS, utwórz stronę i formularz na tej stronie.

Action formularza

Pola formularza

Musisz utworzyć kilka ukrytych pól z następującymi wartościami:

• secure*

  Token (ciąg znaków, 36 znaków)

• doc_id*

  ID dokumentu (ciąg znaków, 36 znaków), który zostanie użyty do utworzenia pliku. ID możesz znaleźć w pasku adresu, gdy dokument jest otwarty. Dokument nie może znajdować się w koszu, ale może być przechowywany w dowolnym folderze Dokumentów.

• mail_id

  ID szablonu wiadomości e-mail (ciąg znaków, 36 znaków) do wysyłki za pomocą poczty. ID możesz znaleźć w pasku adresu, gdy szablon jest otwarty. Jeżeli zmienna nie zostanie przekazana, wiadomość nie zostanie wysłana.

• email_send

  Czas, kiedy ma zostać wysłana wiadomość z plikiem. Może przyjąć wartości:
  onfinish - Wysłanie wszystkich wiadomości po utworzeniu plików (domyślnie)
  oncreate - Wysyłanie wiadomości od razu po utworzeniu pliku. W przypadku utworzenia jednego pliku onfinish i oncreate są identyczne.
  timeout - Wysłanie wiadomości po określonym czasie. W takim przypadku należy przekazać jeszcze dwa parametry:
  email_timeout_value - wartość czasu opóźnienia, po którym ma zostać wysłana wiadomość, liczba całkowita
  email_timeout_unit - jednostka opóźnienia. Może przyjąć wartość "m" (minuty), "h" (godziny), "d" (dni).
  Lub, aby określić dokładny czas wysyłki, należy podać czas w formacie Unix time w email_timeout_timestamp. Jeśli jednocześnie przekażesz timeout i email_timeout_timestamp, priorytet będzie miało to drugie.

• folder_id

  ID folderu na Dysku (ciąg znaków, 36 znaków), w którym będą zapisywane pliki. Jeśli folderu nie ma, zostanie utworzony automatycznie przy pierwszym pliku.

• page_id

  Numer kolejny strony (cyfra lub ciąg znaków), jeżeli dokument zawiera wiele stron. Można podać jeden numer (pierwsza strona - 0) lub numery (oddzielone przecinkami) stron, które mają zostać użyte do utworzenia pliku.

Wysyłka pliku na e-mail po utworzeniu

Plik zostanie wysłany na adres e-mail Twojego konta zaraz po jego utworzeniu. W polu „Szablon wiadomości” możesz wybrać, jakiego szablonu użyć do wysyłki. W Szablonach wiadomości możesz wcześniej utworzyć szablon do wysyłania wiadomości na e-mail konta. Jeśli w treści wiadomości użyjesz zmiennej %data, w tym miejscu zostaną wstawione wszystkie dane pliku w formie tabeli.

Skrypt i style

Na stronie integracji znajdziesz kod, który należy wkleić w sekcji HEAD lub w dowolne inne miejsce na stronie. Nie wklejaj tego kodu na wszystkich stronach witryny - wystarczy, aby kod znajdował się tylko na stronie z formularzem.

Dodatkowo musisz utworzyć dwa bloki z id result-success i result-danger. Oba bloki muszą być ukryte (style display:none;). W pierwszym bloku możesz napisać tekst informujący o pomyślnym utworzeniu pliku. Blok ten zostanie wyświetlony w przypadku powodzenia. Jeżeli wystąpi błąd, wyświetlony zostanie blok z id result-danger, a treść błędu zostanie automatycznie do niego wstawiona.

Wstawianie zmiennych w dokumencie

W dokumencie musi znajdować się przynajmniej jedna zmienna do zastąpienia, na przykład %name lub %course. Dodaj w formularzu pole, gdzie nazwa zmiennej zaczyna się od mask_, na przykład mask_name lub mask_course. Dane wpisane przez użytkownika w te pola zostaną zastąpione odpowiednimi zmiennymi w tekście dokumentu. Aby podać adres e-mail, użyj zmiennej mask_email. Do wysłania wiadomości na kilka adresów podaj je oddzielone przecinkiem lub spacją. Status wysyłki w Dysku będzie wyświetlany tylko dla pierwszego adresu.

Działanie formularza

Po utworzeniu formularza możesz otworzyć opublikowaną stronę i sprawdzić jego działanie. Plik zostanie utworzony i wyświetlony w wyskakującym oknie do pobrania.

Jeden dokument = jedno wypełnienie

Opcjonalnie możesz ograniczyć liczbę wypełnienia formularza. Jeżeli na podany adres e-mail został już wcześniej stworzony plik z doc_id, pojawi się ostrzeżenie, że można utworzyć tylko jeden plik.

Moje dokumenty

Możesz wyświetlić dokumenty użytkownika w zamkniętej sekcji swojej strony. Aby to zrobić, utwórz formularz zgodnie z instrukcjami powyżej. Następnie dodaj ukryte pola email, secure i doc_id. W polu email umieść adres e-mail użytkownika, a w polu doc_id ustaw wartość all. Po otwarciu tej strony użytkownik zobaczy listę swoich dokumentów z możliwością ich pobrania. Jeżeli użytkownik już wypełnił formularz, zamiast formularza powinien zobaczyć swój dokument. Pole email formularza powinno być ukryte i automatycznie uzupełnione przez Twój CMS.

Inne integracje