DINHDANH Creator · Bài EM07 · Easy · 12 helper (không gọi mạng)

Helper đồng bộ
đủ method - tham số · trả về · lưu ý

Không cần await. Cùng họ logic với Aura (AM08) - Easy có thêm vài helper filename/UI.

appifio_generateSlug(text)

Việc: Đổi tiêu đề → chuỗi URL (hỗ trợ tiếng Việt).

const slug = appifio_client.appifio_generateSlug('Bài viết về AI');
// → "bai-viet-ve-ai"

Trả về: chuỗi slug. Dùng trước addRoute.

appifio_formatDateTime(serverDatetime, format?)

Tham số format: mặc định 'datetime'. Preset: date | time | datetime | full | iso | us | eu - hoặc pattern tùy chỉnh.

appifio_client.appifio_formatDateTime('2025-12-27 15:59:10', 'date');
appifio_client.appifio_formatDateTime(post.created_at, 'd/m/Y H:i');

Trả về: chuỗi đã format. Input: SQL UTC, ISO, hoặc timestamp 13 số. Nếu trang có cấu hình định dạng CMS → preset date/time/datetime theo cấu hình.

appifio_formatFileSize(bytes, decimals?)
appifio_client.appifio_formatFileSize(1536000); // "1.5 MB"

Trả về: chuỗi dung lượng dễ đọc.

appifio_getRouteSlug()
const slug = appifio_client.appifio_getRouteSlug();
// URL .../ten-link/bai-viet-ve-ai → "bai-viet-ve-ai"

Trả về: chuỗi (có thể rỗng trên trang chủ).

appifio_getQueryParams()
const q = appifio_client.appifio_getQueryParams();
// ?id=1&page=2 → { id: "1", page: "2" }
appifio_sanitizeFilename · getFileExtension · isImageFile · generateUniqueFilename
appifio_client.appifio_sanitizeFilename('My Photo!!.PNG');
appifio_client.appifio_getFileExtension('a.B.JPG'); // "jpg"
appifio_client.appifio_isImageFile('x.webp');       // true
appifio_client.appifio_generateUniqueFilename('a.png', 'img_');

Trả về: chuỗi tên/đuôi hoặc boolean. Dùng trước upload / đặt tên file an toàn.

appifio_deepClone · debounce · showError · showSuccess
const copy = appifio_client.appifio_deepClone(obj);
const run = appifio_client.appifio_debounce(() => { /* … */ }, 300);
appifio_client.appifio_showError('Lỗi');   // gọi window.showError nếu có
appifio_client.appifio_showSuccess('OK');

Lưu ý: showError/Success chỉ hiện nếu trang định nghĩa hook tương ứng.

Checklist EM07: generateSlug · formatDateTime · formatFileSize · getRouteSlug · getQueryParams · sanitizeFilename · getFileExtension · isImageFile · generateUniqueFilename · deepClone · debounce · showError/showSuccess

EM08 - executeBackendFunction

DINHDANH Creator · Loạt Easy Storage · EM07