作成フォーム
証明書やディプロマ、その他のファイルをあなたのサイト上で自動的に作成します。 サイト訪問者はフォームに入力するだけで、ファイルを受け取ることができます。
ファイルを作成するためには、あなたのサイトにHTMLフォームを作成する必要があります。 それが不可能な場合は、作成ウィジェットを使用してください。
フォーム作成
DiMakerでファイル作成リクエストを送信するには、サイトにフォームを作成する必要があります。 このフォームは、サイトの公開部分または非公開部分のどちらにも配置することができます。CMSを使用してページを作成し、そのページにフォームを設置してください。
フォームのアクション
https://dimaker.app/api/v1/webform-create/フォームのフィールド
次の値を持ついくつかの隠しフィールドを作成する必要があります:
-
secure*
トークン (36文字の文字列)
-
doc_id*
ドキュメントID (36文字の文字列)。これはファイル作成に必要なIDです。このIDは、ドキュメントが開かれている状態のアドレスバーから取得できます。ドキュメントはゴミ箱に入っていない必要がありますが、どのフォルダーにも存在する可能性があります。
-
mail_id
メールテンプレートのID (36文字の文字列)。これは、メール送信のために使用されます。このIDは、テンプレートが開かれている状態のアドレスバーから取得できます。このパラメータを指定しない場合、メールは送信されません。
-
email_send
ファイル付きのメールを送信するタイミングを指定します。以下の値を指定できます:
onfinish - すべてのファイルが作成された後にメールを一括送信 (デフォルト設定)
oncreate - ファイル作成後すぐにメールを送信。1つのファイルを作成する場合、onfinishとoncreateは同じ動作になります。
timeout - 指定した時間経過後にメールを送信。この場合、以下の2つのパラメータを追加する必要があります:
email_timeout_value - メール送信までの時間間隔 (整数)
email_timeout_unit - 時間単位。「m」(分)、「h」(時間)、「d」(日) のいずれかを指定してください。
また、特定の時間を指定したい場合には、Unix Time形式でのタイムスタンプをemail_timeout_timestampのフィールドに入力してください。timeoutとemail_timeout_timestampが両方指定されている場合は、後者が優先されます。 -
folder_id
作成したファイルを保存するフォルダーID (36文字の文字列)。指定されたフォルダーが存在しない場合、最初のファイル作成時に自動的に作成されます。
-
page_id
ドキュメント内で複数のページがある場合、使用するページの番号を指定します (数字またはカンマ区切りの文字列)。例: 「最初のページは0」。
ファイル作成後に自分への送信
ファイルは、作成後すぐにアカウントに登録されたメールアドレスに送信されます。「メールテンプレート」フィールドで使用するテンプレートを指定できます。 メールテンプレートセクションで、事前にアカウント用のテンプレートを作成することも可能です。 メール本文に変数 %data を記載することで、ファイルのデータが表形式で挿入されます。
スクリプトとスタイル
統合ページからスクリプトコードを取得し、それをページのHEADまたは任意の場所に挿入してください。 このコードをすべてのページではなく、フォームのあるページのみに追加してください。
さらに、result-successとresult-dangerというIDを持つ2つの非表示ブロックを作成する必要があります (display:none; スタイル付き)。 成功の場合はresult-successブロックが表示され、エラー発生時はresult-dangerブロックにエラーメッセージが自動的に挿入されます。
ドキュメントへの置換
ドキュメント内に少なくとも1つの置換用変数 (例: %name や %course) を設定しておく必要があります。フォームにmask_nameやmask_courseといった名前の変数を持つフィールドを追加することで、訪問者が入力したデータがドキュメント内の対応する変数に置き換えられます。 メールアドレスを指定する場合は、変数mask_emailを使用してください。複数のメールアドレスを指定する場合はカンマや空白で区切ります。その際、送信状態は最初のアドレスで表示されます。
フォームの動作確認
フォームを作成した後、公開ページを開いてフォームの動作を確認してください。ファイルが作成され、ダウンロード用のポップアップが表示されます。
1ドキュメント = 1回の入力
希望により、フォーム入力の回数を制限できます。同じメールアドレスで既にdoc_idを用いてファイルが作成されている場合、「1つのファイルのみ作成可能」という警告が表示されます。
マイドキュメント
サイトの非公開部分で訪問者のドキュメントを表示することができます。そのためには、上記のようにフォームを作成し、email、secure、doc_idという隠しフィールドを追加してください。emailフィールドには訪問者のメールアドレスを指定し、doc_idフィールドには「all」という値を入力します。このページを開くと、訪問者はフォームの代わりに自分のドキュメント一覧と、それをダウンロードするオプションが表示されます。すでにフォームを入力済みの訪問者には、フォームの代わりにそのファイルが自動的に表示されることも可能です。emailフィールドは非表示にし、CMS内で自動的に入力されるよう設定してください。