Formularz tworzenia
Automatyczne tworzenie plików na Twojej stronie - dyplomów, certyfikatów lub czegoś innego. Odwiedzający Twoją stronę wystarczy, że wypełnią formularz i otrzymają plik.
Aby tworzyć pliki, musisz stworzyć formularz HTML na swojej stronie. Jeśli to niemożliwe, wystarczy użyć widżetu tworzenia.
Tworzenie formularza
Aby wysyłać zapytania na tworzenie plików w DiMaker, musisz stworzyć formularz na swojej stronie. Formularz ten może być umieszczony zarówno w publicznej, jak i zamkniętej części Twojej strony. Za pomocą Twojego CMS utwórz stronę i formularz na tej stronie.
Action formularza
https://dimaker.app/api/v1/webform-create/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 będzie używany do tworzenia pliku. ID można uzyskać w pasku adresu, gdy dokument jest otwarty. Dokument nie powinien być w koszu, ale może znajdować się w dowolnej liście Dokumentów.
-
mail_id
ID szablonu maila (ciąg znaków, 36 znaków) do wysyłki pocztą elektroniczną. ID można uzyskać, gdy szablon jest otwarty. Jeśli zmienna nie została przekazana, wiadomość nie zostanie wysłana.
-
email_send
Czas, kiedy wysłać wiadomość z plikiem. Może przyjmować następujące wartości:
onfinish - Wysłać wszystkie wiadomości po stworzeniu wszystkich plików (domyślnie)
oncreate - Wysyłać wiadomości natychmiast po stworzeniu pliku. Przy tworzeniu jednego pliku onfinish i oncreate są identyczne.
timeout - Wysłać wiadomości po upływie określonego czasu. W tym przypadku należy przekazać jeszcze dwa parametry:
email_timeout_value - wartość liczbową odstępu, po którym wysyłać wiadomości, wartość całkowita
email_timeout_unit - jednostka miary odstępu. Może przyjmować wartość "m" (minuty), "h" (godziny), "d" (dni).
Aby wskazać dokładny czas wysyłki, należy przekazać czas w formacie unix time w email_timeout_timestamp. Jeśli przekazane są timeout i email_timeout_timestamp, priorytet będzie mieć ten ostatni. -
storage_period
Czas przechowywania plików na Dysku. Jeśli parametr nie jest określony, pliki są przechowywane bezterminowo, do ręcznego usunięcia. Aby usunąć po określonym czasie, powinien przyjąć wartość:
timeout. W tym przypadku należy przekazać jeszcze dwa parametry:
storage_period_timeout_value - wartość liczbową odstępu, po którym usunąć pliki, wartość całkowita
storage_period_timeout_unit - jednostka miary odstępu. Może przyjmować wartość "m" (minuty), "h" (godziny), "d" (dni).
Aby wskazać dokładny czas usunięcia, należy przekazać czas w formacie unix time w storage_period_timeout_timestamp. Jeśli przekazane są storage_period_timeout_value i email_timeout_timestamp, priorytet będzie mieć ten ostatni. -
folder_id
ID folderu na Dysku (ciąg znaków, 36 znaków) do przechowywania plików. Jeśli folder nie istnieje, zostanie automatycznie utworzony przy tworzeniu pierwszego pliku.
-
page_id
Numer porządkowy strony (liczba lub ciąg znaków), jeśli w dokumencie jest kilka stron. Można podać jeden numer (pierwsza strona – 0), lub numery (oddzielone przecinkiem) stron, które należy użyć do tworzenia pliku.
Wysłanie pliku na swój e-mail po stworzeniu
Plik zostanie wysłany na e-mail konta natychmiast po jego utworzeniu. W polu „Szablon maila” można wybrać, jaki szablon użyć do wysyłki. Wcześniej w Szablonach maili można stworzyć osobny szablon do wysyłki wiadomości e-mail na konto. Jeśli w treści maila wpisać zmienną %data, to w jej miejsce zostaną dodane wszystkie dane pliku w formie tabeli.
Skrypt i style
Na stronie integracji należy pobrać kod i wstawić go do sekcji HEAD lub w dowolne inne miejsce strony. Nie trzeba wstawiać tego kodu na wszystkie strony witryny. Konieczne jest wstawienie tego kodu tylko na stronę z formularzem.
Ponadto, należy utworzyć dwa bloki z id result-success i result-danger. Oba bloki są ukryte, z stylem display:none; W pierwszym bloku można wpisać tekst po pomyślnym utworzeniu pliku. Blok ten zostanie pokazany po prawidłowym zapytaniu. Jeśli wystąpił jakiś błąd, zostanie wyświetlony blok z id result-danger. Tekst błędu zostanie wstawiony do bloku automatycznie.
Podstawianie 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 powinna zaczynać się od mask_, na przykład mask_name lub mask_course. Wprowadzone przez odwiedzającego dane w te pola zostaną zastąpione odpowiednimi zmiennymi w treści dokumentu. Aby wskazać adres e-mail, użyj zmiennej mask_email. Aby wysłać wiadomości na kilka adresów, podaj je oddzielone przecinkiem lub spacją. Status wysyłki w Dysku będzie wyświetlany dla pierwszego adresu.
Działanie formularza
Po stworzeniu formularza możesz otworzyć opublikowaną stronę i sprawdzić działanie formularza. Zostanie utworzony plik i wyświetlony w oknie pop-up do pobrania.
Jeden dokument = jedno wypełnienie
W razie potrzeby, możesz ograniczyć liczbę wypełnień formularza. Jeśli na podany e-mail został już stworzony plik z doc_id, zostanie wyświetlone ostrzeżenie, że można stworzyć tylko jeden plik.
Moje dokumenty
Możesz wyświetlić dokumenty użytkownika w zamkniętej części swojej strony. Aby to zrobić, stwórz formularz, jak wskazano powyżej. Następnie dodaj ukryte pola email, secure i doc_id. W pierwsze - adres e-mail użytkownika, a w ostatnim polu wpisz wartość all. Po otwarciu tej strony odwiedzający zobaczy w miejscu formularza listę wszystkich dokumentów z możliwością ich pobrania. Jeśli chcesz, aby jeśli odwiedzający już wypełnił formularz, to zamiast formularza został wyświetlony jego plik, pole email formularza powinno być ukryte i automatycznie wstawione przez Twój CMS.