
DINHDANH Creator · Bài F02 · Trung bình
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
2. Thuật ngữ (bảng 3 cột)
| Thuật ngữ | Nghĩa | Nơ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ách | Form công khai trên site |
| appendData | API 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ập | Tên API khi nhờ AI viết code (bài F02) |
| Danh sách indexed | Kiểu lưu nhiều bản ghi có id - dùng cho contacts, blog, đơn hàng | Bảng Backend sau khi có dữ liệu |
| created_by_ip | IP người gửi - server tự gắn, form không tự điền được | Cột trong chi tiết liên hệ (CMS) |
| Thử lại sau | Thô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ỏng | Trên form sau khi nhấn Gửi nhiều lần |
| readList | API đọc toàn bộ danh sách - chỉ admin đã đăng nhập mới gọi được | Trang admin do AI tạo (F03) |
3. Các bước tạo form liên hệ (qua AI)
- 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).
- 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."
- 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.
- 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. - 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.
- 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

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 xem | Tự đọ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ống | Xử lý |
|---|---|
| Gửi form nhưng không thấy dữ liệu trong Backend | Kiể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ách | Yêu cầu sửa sang appendData/readList (F05) |
| Form chạy trên Thay đổi nhưng lỗi trên live | So 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
- Bạn hiểu vì sao form guest chỉ dùng appendData?
- Bạn biết xem lại dữ liệu ở tab Backend?
- Bạn biết "Thử lại sau" là chống spam, không phải site hỏng?
- 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ò.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Bộ hướng dẫn người dùng · F02 · Form liên hệ & Storage