Виджет подлинности

Құжаттар оқылған кезде машинамен оқуға негізделген түсіндірмелер аударылады.

Виджет подлинности — это специальный лейбл с QR-кодом, который добавляется на выданный документ (сертификат, диплом и т.д.). При сканировании QR-кода открывается страница вашего сайта, где автоматически выводится информация о документе: ФИО владельца, дата выдачи, название мероприятия и другие данные.

В разделе «Виджеты» → «Виджеты подлинности» отображается список всех лейблов, настроенных в аккаунте.

Как создать виджет

Лейбл подлинности создаётся не через раздел «Виджеты», а непосредственно в редакторе документа. Нужно открыть нужный документ и добавить элемент «Лейбл проверки подлинности» через панель инструментов редактора. У каждого документа может быть только один лейбл подлинности. При этом в аккаунте может быть любое количество документов, у каждого из которых настроен свой лейбл.

Настройка лейбла в редакторе

При добавлении лейбла в редакторе указывается:

  • URL страницы на сайте. Адрес страницы, созданной на сайте, на которой будет выполняться проверка подлинности. Ссылка должна вести на конкретную страницу — не на главную сайта. Чем короче адрес, тем лучше читается QR-код.
  • Вывод на странице. Текст, который будет показан на странице проверки подлинности. Можно использовать переменные из документа, например %фио, %баллы, %место, название мероприятия, дату и любые другие данные. Чем больше данных указано, тем убедительнее выглядит проверка.

Код на сайте

Чтобы проверка подлинности работала, на странице сайта должен быть установлен следующий код:

<div id="CheckGenuine"></div> <script src="https://dimaker.app/api/v1/genuine-js/"></script>

Код нужно вставить в исходный код страницы — туда, где должна выводиться информация о документе. Скрипт автоматически определяет идентификатор документа по параметру в URL и выводит миниатюру файла и данные из настроек лейбла.

Без этого кода на странице ничего не отобразится — скрипт должен присутствовать на странице, иначе лейбл в документе сохранить не получится.

Создание файлов

При создании, на лейбл автоматически наносится QR-код с уникальной ссылкой. Ссылка ведёт на указанную страницу сайта, к адресу которой добавляется уникальный идентификатор. Таким образом, каждый выданный документ имеет индивидуальную ссылку для проверки.

Что происходит при удалении документа

Если документ будет удалён из раздела «Документы», лейбл подлинности сохраняется и продолжает отображаться в списке виджетов подлинности. Это означает, что ранее созданные файлы по-прежнему будут корректно проходить проверку, пока они остаются на Диске.

Файл должен быть на Диске

Чтобы проверка работала, файл должен находиться на Диске. Именно по идентификатору файла на Диске скрипт находит нужную запись и выводит данные.

Если файл будет удалён с Диска, при сканировании QR-кода на сайте отобразится сообщение: «К сожалению, информация об этом документе не найдена».

Файл может лежать в любой папке на Диске — это не влияет на работу проверки.

Условия корректной работы

Для того чтобы виджет подлинности работал, необходимо одновременное выполнение трёх условий:

  • На странице сайта установлен код с id="CheckGenuine" и подключён скрипт.
  • Файл c лейблом находится на Диске.
  • В настройках лейбла правильно указан URL страницы и хотя бы одна переменная из документа.

Бастауға дайынсыз ба?

Ашу Веб-қосымшаны ашу