Thư viện ảnh

Thư viện phương tiện (en: Media library) là kho tệp dùng chung của một site: mọi ảnh, video và phông chữ bạn đã tải lên. Bạn mở nó từ bất cứ chỗ nào cần chọn một tệp — trong trình chỉnh sửa, trong biểu mẫu sản phẩm, trong bài viết — hoặc bấm Xem toàn bộ thư viện để mở đầy đủ.

Tải tệp lên

Kéo tệp thả vào là được: "Thả tệp vào đây để tải lên." Tải nhiều tệp một lúc cũng được, và thanh tiến độ đếm Đang tải 3/8….

Bốn loại được hỗ trợ, lọc được ngay trên thanh trên cùng: Hình ảnh, Video, Phông chữ, Khác. Phông chữ nhận woff2, woff, ttf, otf. Giới hạn 25 MiB mỗi tệp.

Nếu một lô tải lên bị gián đoạn giữa chừng, thông báo nói rõ đã tải được bao nhiêu, tệp nào hỏng và vì sao — chứ không im lặng bỏ qua phần còn lại.

Dung lượng — phần dễ gây bất ngờ nhất

Thanh dung lượng hiện Đã dùng {x} trên {y}, kèm một dòng bạn nên đọc kỹ:

"Bao gồm cả tệp trong thùng rác — chỉ xoá vĩnh viễn mới giải phóng dung lượng."

Đây là điều gây bối rối nhiều nhất: bỏ tệp vào thùng rác không giải phóng dung lượng. Bạn xoá 500 MB ảnh, thanh dung lượng không nhúc nhích, và bạn tưởng có gì hỏng. Không hỏng — chúng vẫn đang nằm trong thùng rác.

Khi hết chỗ, thông báo nói đủ ba con số: "Không đủ dung lượng: tệp này nặng {incoming}, trong khi đã dùng {used} trên {limit}." Việc từ chối xảy ra trước khi có gì được lưu, nên nó không tốn của cửa hàng đồng dung lượng nào.

Thùng rác, và xoá vĩnh viễn

Xoá một tệp là chuyển vào thùng rác — có thể khôi phục. Tab Thùng rác liệt kê chúng, mỗi tệp có Khôi phục và Xoá vĩnh viễn.

Xoá vĩnh viễn mới là thao tác thật sự huỷ tệp, và hộp thoại nói rất rõ hậu quả:

"“{tên}” ({dung lượng}) sẽ bị xoá hẳn và giải phóng dung lượng. Các trang đang dùng tệp này sẽ bị lỗi ảnh. Không thể hoàn tác."

Đọc kỹ câu giữa. Hệ thống không đếm được ai đang dùng tệp nào, nên nó không ngăn bạn xoá một tệp mà một trang đang chạy vẫn đang phục vụ. Nó chỉ nói cho bạn biết điều đó có thể xảy ra và để bạn quyết định.

Cũng vì vậy mà API công khai không có lệnh xoá vĩnh viễn: DELETE /api/v1/media chỉ bỏ vào thùng rác. Một API xoá cứng được sẽ là một API có thể chọc thủng một storefront đang sống chỉ bằng một script, mà không màn hình nào kịp cảnh báo. Lệnh huỷ hẳn ở lại trong app, cạnh cái hộp thoại vừa trích ở trên.

Thư mục

Sắp tệp vào Thư mục để dễ tìm. Có sẵn vài thư mục theo mục đích — Sản phẩm, Blog, Danh mục, Danh mục blog — cộng với Tất cả tệp và Chưa phân loại.

Thư mục mới để tạo thêm. Xoá một thư mục không xoá tệp trong đó.

Tìm một tệp

Ô tìm kiếm lọc theo tên. Ngoài ra có bộ lọc theo loại và Sắp xếp: mới nhất, cũ nhất, tên A→Z, lớn nhất, nhỏ nhất.

Sắp xếp theo Lớn nhất là cách nhanh nhất để tìm ra thứ đang ăn hết dung lượng của bạn.

Chi tiết một tệp

Xem chi tiết hiện Định dạng, Dung lượng, Kích thước, Ngày tải lên, Thư mục và Đường dẫn, kèm Sao chép đường dẫn và Mở tệp gốc.

Đường dẫn là một URL đầy đủ, và nó là trường duy nhất ở đây bạn không nên lưu cache vĩnh viễn. Phần đầu của URL là cấu hình lưu trữ, được ghép lúc đọc — chính điều đó cho phép đổi CDN mà không phải sửa lại dữ liệu. Hãy đọc lại đường dẫn khi cần thay vì chép cứng nó vào chỗ khác.

Khi lưu sản phẩm, đôi khi hệ thống hỏi về tệp thừa

Gỡ ảnh khỏi một sản phẩm rồi lưu, nếu những ảnh đó không còn được dùng ở đâu nữa, một hộp thoại hỏi "Xoá tệp không còn dùng?" kèm tên từng tệp.

Nó hỏi chứ không tự làm. Xoá một thứ mà bạn còn cần là quyết định của bạn, không phải mặc định của hệ thống.

Qua API

GET, POST (multipart), PATCH, DELETE trên /api/v1/media, cộng POST /api/v1/media/{id}/restore và /api/v1/media-folders. Lệnh tải lên là request duy nhất trên bề mặt đó không phải JSON. Xem API công khai.