Trang Contact đã publish với form Send message cho guest
Form liên hệ guest

DINHDANH Creator · Bài F02 · Trung bình

Form liên hệ / đăng ký
lưu vào Aura Storage (không cần CMS)

Bài này hướng dẫn cách khách (guest) gửi form mà không cần đăng nhập - dữ liệu tự lưu thành danh sách có thể xem lại, kể cả khi bạn chưa mở Aura CMS.

Mục tiêu bài học: Hiểu appendData, vì sao form guest luôn dùng danh sách indexed, cách xem lại tin đã gửi, và xử lý thông báo "Thử lại sau" khi gửi quá nhanh.

Thời lượng đọc: khoảng 14-16 phút

Điều kiện trước: Đã xem tab Backend (bài F01).

Bài trước → sau: F01 → F02 → F03 / G03

Nhãn UI: tab Backend · Xem nội dung database backend · Lưu thay đổi · Thay đổi / Hiện tại

1. Sơ đồ luồng form guest

1. Khách điền form trên trang (không đăng nhập)
→ họ tên, email, nội dung…
2. Khách nhấn nút Gửi trên trang
→ trang gọi appendData('contacts.json', {"{"} name, email, message {"}"})
3. Backend xử lý
→ tự sinh id, created_at, created_by_ip
→ lần đầu: tạo danh mục tổng + hệ thống tự chia nhỏ danh sách khi lớn
4. Khách thấy
→ thông báo thành công - hoặc "Thử lại sau" nếu gửi quá nhiều lần
5. Bạn xem lại
→ tab Backend → "Xem nội dung database backend"
→ hoặc nav "Liên hệ" trong Aura CMS (sau khi mở /tên-link-của-bạn/cms)

2. Thuật ngữ (bảng 3 cột)

Thuật ngữNghĩaNơi thấy trên UI
Guest (khách)Người truy cập trang không đăng nhập - chỉ được thêm mới vào danh sáchForm công khai trên site
appendDataAPI thêm 1 bản ghi mới vào danh sách - duy nhất mutation guest được phép không cần đăng nhậpTên API khi nhờ AI viết code (bài F02)
Danh sách indexedKiểu lưu nhiều bản ghi có id - dùng cho contacts, blog, đơn hàngBảng Backend sau khi có dữ liệu
created_by_ipIP người gửi - server tự gắn, form không tự điền đượcCột trong chi tiết liên hệ (CMS)
Thử lại sauThông báo chống spam khi gửi liên tục quá nhanh - không phải lỗi hệ thống hỏngTrên form sau khi nhấn Gửi nhiều lần
readListAPI đọc toàn bộ danh sách - chỉ admin đã đăng nhập mới gọi đượcTrang admin do AI tạo (F03)

3. Các bước tạo form liên hệ (qua AI)

  1. Bước 1 - Kiểm tra Backend: mở tab "Backend", chắc API key hợp lệ và đã chọn Advanced nếu cần CMS sau này (F01).
  2. Bước 2 - Nhờ AI tạo form: chat: "Tạo form liên hệ gồm họ tên, email, nội dung; khi gửi lưu vào contacts.json bằng appendData, không cần đăng nhập. Hiện thông báo thành công hoặc Thử lại sau khi bị giới hạn."
  3. Bước 3 - Thử trên bản nháp: tab "Xem và sửa" → "Thay đổi" → điền thử form → nhấn Gửi → đọc thông báo trên màn hình.
  4. Bước 4 - Xác nhận dữ liệu: tab "Backend" → "Xem nội dung database backend" → tìm key gần contacts.json.
  5. Bước 5 - Công bố: hài lòng → nhấn "Lưu thay đổi" trên toolbar → thử lại form trên link live.
  6. Bước 6 - (Tuỳ chọn) Trang admin: nhờ AI tạo trang đọc danh sách bằng readList, yêu cầu đăng nhập admin (F03). Hoặc đợi mở Aura CMS → nav "Liên hệ" (G03).

4. Vì sao luôn dùng appendData, không writeFile cho danh sách

Bảng database Backend liệt kê contacts.json trong kho
Xem hàng trong Backend

Hình dung: appendData giống thả thư vào hòm - mỗi người thêm một lá, không ai ghi đè lá của người khác. writeFile với cả mảng giống xóa sổ cũ rồi viết lại - hai người gửi cùng lúc dễ mất dữ liệu.

Đúng (indexed)Sai (dễ hỏng danh sách)
appendData('contacts.json', {"{"}name, email, message{"}"})writeFile('contacts.json', JSON.stringify([...]))
readList('contacts.json') để admin xemTự đọc/ghép toàn file rồi ghi lại mỗi lần gửi

5. So sánh với công cụ khác

  • Google Forms / Typeform: form tách rời khỏi trang; ở DINHDANH form nằm ngay trên landing, dữ liệu về kho app của bạn.
  • WordPress Contact Form 7: thường gửi email, ít có bảng xem lại; Aura Storage + CMS cho xem/xóa tin trong panel.
  • Formspree: dữ liệu ở dịch vụ ngoài; ở đây dữ liệu nằm trong chính app storage.

6. Giới hạn kỹ thuật

Làm được

  • Form công khai không cần đăng nhập
  • Tự sinh id, thời gian, IP gửi
  • Xem tin trong Backend hoặc CMS Liên hệ
  • Gửi email thông báo qua Backend Function + Secrets (F04)

Chưa làm được / hạn chế

  • Guest không sửa/xóa tin người khác
  • Gửi quá nhanh → Thử lại sau (chống spam)
  • Không có CAPTCHA tích hợp sẵn - cần AI thêm nếu cần
  • Bật Security enforce có thể tắt quyền guest append (G05)

7. Bảo mật form guest

  • Guest chỉ được appendData (thêm mới) - không thể updateData, xóa file hay đọc danh sách người khác qua API công khai.
  • Thông báo "Thử lại sau" xuất hiện khi cùng IP gửi quá nhiều lần trong thời gian ngắn - đợi vài phút rồi thử lại; không spam nút Gửi.
  • Yêu cầu AI hiển thị lỗi thân thiện trên form (try/catch) - tránh khách tưởng site hỏng khi chỉ bị giới hạn tạm.
  • Khi bật Kiểm soát bảo mật CMS, kiểm tra cột "Ai được thêm mới?" của entity Liên hệ vẫn là Khách được gửi (G05).

8. Vấn đề thường gặp

Tình huốngXử lý
Gửi form nhưng không thấy dữ liệu trong BackendKiểm tra đã Lưu thay đổi chưa; refresh bảng database; thử trên live không chỉ bản Thay đổi
Form báo "Thử lại sau"Rate limit chống spam - đợi 2-5 phút, không báo lỗi hệ thống
AI dùng writeFile để lưu danh sáchYêu cầu sửa sang appendData/readList (F05)
Form chạy trên Thay đổi nhưng lỗi trên liveSo sánh tab Hiện tại vs Thay đổi; Lưu thay đổi; kiểm tra API key trên live

9. Lời khuyên

  • Đặt tên file rõ nghĩa (contacts.json, registrations.json) - dễ tra trong Backend.
  • Test form trên cả Desktop và Di động (Canvas) trước khi Lưu thay đổi.
  • Cần email khi có liên hệ mới → dùng Backend Function (F04), không gửi mail trực tiếp từ trình duyệt khách.

10. Checklist tự kiểm

  1. Bạn hiểu vì sao form guest chỉ dùng appendData?
  2. Bạn biết xem lại dữ liệu ở tab Backend?
  3. Bạn biết "Thử lại sau" là chống spam, không phải site hỏng?
  4. Bạn đã thử gửi form trên bản live sau Lưu thay đổi?

Bài tiếp theo

F03 - Auth admin: login.json & vai trò

Khi cần trang riêng chỉ admin mới xem được danh sách liên hệ, bạn sẽ học hệ thống đăng nhập và 3 vai trò.

DINHDANH Creator · Bộ hướng dẫn người dùng · F02 · Form liên hệ & Storage