DINHDANH Creator Code: window.appifio dùng cho URL tuyệt đối trên dự án live
Helper đồng bộ

DINHDANH Creator · Bài AM08 · API REFERENCE §7 · 5 helper

Helper đồng bộ
không gọi mạng - đủ cấu trúc

Năm hàm chạy ngay trên trình duyệt - không cần await. Dùng khi hiện ngày, tạo slug, đọc URL.

appifio_generateSlug(text)

Việc: Đổi tiêu đề thành chuỗi URL thân thiện (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. Thường dùng trước addRoute / appendData.

appifio_formatDateTime(isoOrSql, format?) · SECTION ĐỊNH DẠNG NGÀY GIỜ

Việc: Hiện ngày/giờ từ dữ liệu máy chủ - theo CMS hoặc preset. Không tự viết toLocaleDateString / cộng trừ múi giờ.

Input máy chủ hiểu được:

  • YYYY-MM-DD HH:mm:ss (không offset) → coi là UTC, rồi quy đổi múi giờ hiển thị
  • ISO có Z hoặc +07:00
  • Timestamp 13 chữ số (ms)

Tham số format: bỏ trống ≈ preset 'datetime'. Preset: 'date' | 'time' | 'datetime' | 'full' | 'iso' | 'us' | 'eu' - hoặc pattern tùy chỉnh ('d/m/Y H:i', 'j F Y'…).

Khi có Aura CMS (Panel → Cài đặt → Định dạng ngày giờ): preset date/time/datetime theo cấu hình site (múi giờ IANA hoặc để trống = theo trình duyệt khách). Mặc định CMS thường: ngày j F Y (vd. 4 Jul 2026), giờ H:i.

Khi không có CMS - ví dụ preset:

PresetVí dụ
datetime (mặc định)04 Jul 2026 15:30
date04 Jul 2026
time15:30:00
eu / us / iso / fullTheo chuẩn EU / US / ISO / đầy đủ
appifio_client.appifio_formatDateTime(post.created_at);
appifio_client.appifio_formatDateTime(post.created_at, 'date');
appifio_client.appifio_formatDateTime(post.created_at, 'd/m/Y H:i');

Trả về: chuỗi đã format. Mọi created_at / published_at nên qua hàm này trước khi hiện. Token pattern: d j m n Y y F M · H G h g i s a A (+ legacy YYYY MM DD HH mm…).

appifio_formatFileSize(bytes)
appifio_client.appifio_formatFileSize(1536000); // → "1.5 MB" (dạng dễ đọc)

Tham số: số byte. Trả về: chuỗi kích thước.

appifio_getRouteSlug()

Việc: Lấy phần slug sau tên link app trong URL đang mở (trang chi tiết / bài viết…).

const slug = appifio_client.appifio_getRouteSlug();

Trả về: chuỗi slug hiện tại (có thể rỗng tùy URL).

appifio_getQueryParams()

Việc: Đọc tham số trên URL dạng ?id=1&page=2.

const q = appifio_client.appifio_getQueryParams();
// q.id, q.page, ...

Trả về: object các cặp key → value.

Ví dụ blog list

Bảng URL Routes phù hợp khi dùng getRouteSlug
Routes + helper slug
const res = await appifio_client.appifio_readList('blog.json', ['id','title','slug','created_at']);
for (const post of (res.data?.content || [])) {
  const when = appifio_client.appifio_formatDateTime(post.created_at, 'date');
  // render...
}
Checklist §7: generateSlug · formatDateTime · formatFileSize · getRouteSlug · getQueryParams = 5/5

Mục lục đủ loạt AM = đủ SECTION API REFERENCE

Bài§Số method
AM01Mở đầuCách gọi + response chuẩn
AM021 Indexed4
AM032 Flat15
AM043 FS & upload7
AM054 Route3
AM065 Auth12
AM076 Backend1
AM087 Helper5
Tổng method API REFERENCE47 (4+15+7+3+12+1+5)

Không gồm method Panel CMS/MCP - xem loạt AS (chỉ UI).

Mục lục mở rộng AM09-AM12 (section ngoài API REFERENCE)

BàiSection TXTNội dung
AM09Biến & hàm toàn cụcBootstrap, global.apps, waitForAppStorage
AM10URL · Rỗng · Rate limitgetAbsoluteUrl, route bắt buộc, err.blocked
AM11System files & CMSManifest, entity map, security enforce
AM12Ví dụ minh họaExample 1-9 end-to-end

DINHDANH Creator · Loạt Method · AM08