Hướng dẫn cấu hình thuộc tính nội dung
Khai báo và sửa từng kiểu thuộc tính nội dung, quản lý danh sách lựa chọn, phạm vi áp dụng và hiểu tác động khi thay đổi cấu hình.
Giao diện danh sách và phạm vi sử dụng
Mở Cấu hình → Thuộc tính nội dung. Chức năng này khai báo các trường bổ sung để người dùng nhập dữ liệu có cấu trúc. Người có quyền Config có thể thêm định nghĩa, sửa tên/loại/danh sách giá trị/thứ tự và xóa theo phạm vi được cấp. Đây là màn hình cấu hình trường, khác với nơi nhập giá trị của một bài viết, đơn hàng hoặc yêu cầu liên hệ cụ thể.
Có hai tab: Thuộc tính thông tin dùng bổ sung thông tin cho nội dung; Thuộc tính lọc - tìm kiếm dùng dữ liệu cho bộ lọc khi website có module sử dụng. Chọn đúng tab trước khi thêm. Thuộc tính được gắn với một hoặc nhiều danh mục; nội dung trong danh mục con có thể nhận các trường từ danh mục cha.
Giao diện thêm thuộc tính tại dòng đầu danh sách
Tên: Nhãn mà người nhập sẽ nhìn thấy. Ghi rõ nội dung cần nhập, ví dụ “Ngôn ngữ tài liệu”; không chỉ đặt “Thông tin”.
Loại: Chọn một trong chín kiểu bên dưới. Kiểu quyết định control và cách lưu giá trị ở các giao diện sử dụng thuộc tính.
Giá trị: Chỉ cần danh sách lựa chọn khi loại là Check hoặc Option. Nhập một lựa chọn, bấm + để thêm vào danh sách, lặp lại cho các lựa chọn khác. Dấu × bỏ một lựa chọn đang soạn; chưa tự lưu định nghĩa.
Thứ tự: Độ ưu tiên sắp xếp các trường. API lấy thuộc tính theo độ ưu tiên tăng dần.
Thêm: Kiểm tra thông tin và gửi tạo định nghĩa. Sau thành công danh sách được tải lại và dòng thêm được đưa về trạng thái nhập mới.
Danh mục: Chọn từng danh mục để thêm vào tập áp dụng. Các danh mục đã chọn xuất hiện thành nhãn; × trên nhãn gỡ khỏi bản đang sửa. Cần ít nhất một danh mục khi Thêm hoặc Lưu. Chọn loại nội dung và nhóm cụ thể theo dữ liệu doanh nghiệp, không gõ mã nhóm ngẫu nhiên.
Tất cả lựa chọn Loại và cách sử dụng
Chữ (Text): Một giá trị văn bản ngắn, ví dụ chất liệu hoặc tên tác giả. Khi nhập giá trị ở chi tiết nội dung, bấm Lưu cạnh trường.
Đoạn văn (Textarea): Văn bản nhiều dòng cho mô tả dài hơn. Đây là giá trị thuộc tính, không phải trình soạn thảo toàn bộ bài.
Số (Number): Giá trị số; không nhập đơn vị hay câu văn vào ô số. Đặt tên thuộc tính rõ đơn vị nếu cần, ví dụ Trọng lượng (g).
Ngày (Date): Giá trị ngày được chọn bằng ô ngày, phù hợp ngày phát hành hoặc mốc liên quan.
Màu (Color): Bộ chọn màu; dùng cho dữ liệu màu mà template hỗ trợ, khác với nhập tên màu bằng chữ.
Hình ảnh (Image): Giá trị là ảnh riêng của thuộc tính. Người dùng chọn tệp rồi Lưu cạnh thuộc tính.
Có/Không (Boolean): Một giá trị đúng/sai. Khi nhập giá trị, công tắc bật/tắt gửi ngay; ý nghĩa phụ thuộc tên thuộc tính, không tự là trạng thái công bố.
Chọn nhiều từ danh sách (Check): Cấu hình sẵn nhiều lựa chọn; người nhập có thể chọn nhiều ô. Ví dụ chất liệu gồm Nhựa và Kim loại. Mỗi lần chọn/bỏ chọn gửi tập giá trị mới.
Chọn một từ danh sách (Option): Cấu hình sẵn các lựa chọn nhưng người nhập chỉ chọn một. Ví dụ kiểu dáng chọn Oval hoặc Tròn. Bấm lựa chọn gửi ngay.
- Xác định dữ liệu muốn thu thập và nơi website sẽ hiển thị hoặc lọc dữ liệu đó.
- Nhập tên, chọn kiểu; với danh sách hãy tạo ít nhất một lựa chọn không trống và không trùng.
- Chọn phạm vi danh mục nếu là thuộc tính nội dung, rồi đặt thứ tự.
- Bấm Thêm, chờ thông báo; mở một nội dung hoặc form sử dụng thuộc tính để kiểm tra trường mới.
Giao diện sửa thuộc tính tại từng dòng
Chỉnh trực tiếp Tên, Loại, các Giá trị, Thứ tự và danh mục áp dụng nếu có. Sau đó bấm Lưu của chính dòng đó. UI theo dõi các thay đổi để gửi bản vá; nếu không có thay đổi thì không gửi yêu cầu cập nhật. Lưu một dòng không ghi tất cả các dòng khác đang sửa.
Đổi từ Chọn một sang Chọn nhiều làm thay đổi cách người nhập lựa chọn. Đổi sang kiểu không có danh sách sẽ khiến danh sách lựa chọn không còn được sử dụng; máy chủ thay tập lựa chọn theo kiểu mới. Không coi đây là thao tác chỉ đổi hình thức: các nội dung đã nhập cần được rà soát vì dữ liệu cũ không được bảo đảm tự chuyển sang định dạng mới phù hợp. Đổi tên một lựa chọn cũng không nên hiểu là tự đổi mọi giá trị đã lưu trong các nội dung.
Giao diện xác nhận xóa và phạm vi tác động
Bấm Xóa tại đúng dòng, đọc xác nhận rồi đồng ý nếu thực sự muốn bỏ cấu hình. Hủy giữ lại dữ liệu. Xóa định nghĩa khác với xóa một lựa chọn bằng ×. Nếu chỉ không muốn dùng một trường ở một nhóm nội dung, kiểm tra phạm vi danh mục thay vì mặc định xóa toàn bộ định nghĩa.
API xóa theo phạm vi trước hết gỡ liên kết áp dụng trong phạm vi đó. Nếu định nghĩa còn liên kết ở phạm vi khác, hệ thống giữ định nghĩa. Nếu đã gỡ liên kết cuối cùng, máy chủ xóa toàn bộ định nghĩa và các giá trị liên quan theo doanh nghiệp. Vì vậy xóa một dòng có thể dẫn tới mất cả dữ liệu giá trị khi đó là phạm vi cuối; kiểm tra các tab/danh mục đang dùng trước khi xác nhận.
Giao diện nhập thuộc tính trên nội dung
Đổi danh mục: lưu ngay và xóa giá trị thuộc tính cũ
Đổi danh mục của nội dung đã tồn tại có tác động ngay đến dữ liệu đã lưu. Hệ thống không chỉ thay tên nhóm trên màn hình: API kiểm tra danh mục, xóa các bản ghi giá trị thuộc tính của nội dung, cập nhật danh mục rồi lưu cơ sở dữ liệu. Không có bước bấm Lưu chung để xác nhận lại thay đổi này.
- Trước khi đổi, ghi lại các giá trị cần giữ trong Thông tin khác và Tìm kiếm, ở từng ngôn ngữ đang sử dụng. Lưu hoặc sao chép riêng các phần đang soạn để không nhầm chúng với dữ liệu đã lưu.
- Chọn đúng danh mục đích. Chỉ thực hiện khi đã quyết định chuyển nội dung; không dùng danh sách này để thử xem danh mục khác có những trường nào.
- Chờ thông báo thành công. Khi API thành công, màn hình nhận danh mục mới và hai khối thuộc tính tải lại. Nếu có lỗi, kiểm tra thông báo và dữ liệu sau khi mở lại trang, không tiếp tục nhập thuộc tính theo một danh mục chưa được lưu thành công.
- Nhập lại các giá trị phù hợp với bộ thuộc tính mới. Thuộc tính có nút Lưu cần lưu từng trường; công tắc, ô chọn và nút chọn một giá trị gửi cập nhật ngay.
- Mở lại nội dung và kiểm tra từng ngôn ngữ. Chọn lại danh mục cũ không khôi phục các giá trị đã bị xóa.
Phạm vi bị xóa: xử lý phía máy chủ lọc theo mã nội dung, không lọc theo ngôn ngữ hay nhóm thuộc tính. Vì vậy, toàn bộ giá trị thuộc tính đã lưu của nội dung ở các ngôn ngữ đều nằm trong phạm vi xóa; ngay cả thuộc tính xuất hiện ở cả danh mục cũ và mới cũng không được giữ lại theo cách xử lý này. Thao tác này không xóa định nghĩa thuộc tính dùng chung trong phần cấu hình. Không diễn giải việc mất giá trị thuộc tính là xóa bài viết, sản phẩm hoặc tệp nội dung.
Ví dụ minh họa: một nội dung đang có thuộc tính “Tác giả” ở danh mục A. Chuyển sang danh mục B có cùng thuộc tính “Tác giả” vẫn cần nhập lại giá trị đã ghi trước đó. Nếu B không có thuộc tính này, ô nhập sẽ không còn xuất hiện. Đây là ví dụ về quy tắc xử lý, không phải mô tả một bản ghi đã được thử chuyển trong dữ liệu thật.
Vì sao bộ thuộc tính thay đổi hoặc một khối không có ô nhập?
Hệ thống lấy thuộc tính theo nội dung, danh mục hiện tại, ngôn ngữ đang chọn và nhóm mục đích. Các thuộc tính được cấu hình cho danh mục hiện tại hoặc các danh mục cha có thể được đưa vào, theo ngôn ngữ tương ứng. Các trường được sắp theo độ ưu tiên của định nghĩa thuộc tính. Khối Thông tin khác dùng nhóm thông tin; khối Tìm kiếm dùng nhóm bộ lọc. Cách trình bày trên website còn phụ thuộc template có sử dụng các trường này hay không.
Khi một trong các thông tin nhận diện trên thay đổi, component xóa danh sách đang hiển thị và gọi API tải lại. Nếu có nhiều yêu cầu tải nối tiếp, phản hồi cũ không được ghi đè kết quả của lần tải mới hơn. Một khối trống có thể do chưa cấu hình thuộc tính cho danh mục/ngôn ngữ đó; nếu tải lỗi, hệ thống có thông báo lỗi, không nên hiểu là chắc chắn không có thuộc tính.
Lưu giá trị thuộc tính như thế nào?
Văn bản, văn bản nhiều dòng, số, ngày, màu: Nhập hoặc chọn giá trị, rồi bấm Lưu cạnh chính trường đó. Chỉ trường đó được gửi cập nhật. Nút Lưu của nội dung không thay thế các nút này.
Hình ảnh thuộc tính: Chọn tệp ảnh, sau đó bấm Lưu của trường. Chọn tệp mới chỉ chuẩn bị dữ liệu. Khi lưu, máy chủ xử lý ảnh và lưu đường dẫn; sau thành công, component tải lại danh sách thuộc tính. Do đó nên lưu các trường khác đang sửa trước khi lưu ảnh thuộc tính.
Công tắc đúng/sai: Bật hoặc tắt. Gửi giá trị ngay. Công tắc thuộc tính chỉ có ý nghĩa theo tên thuộc tính; không tự đồng nghĩa với trạng thái xuất bản của nội dung.
Chọn nhiều giá trị: Đánh dấu hoặc bỏ đánh dấu từng ô. Mỗi lần thay đổi gửi lại tập giá trị đã chọn. Code lưu các lựa chọn dưới dạng chuỗi phân cách bằng dấu phẩy.
Chọn một giá trị: Bấm nút tròn cạnh lựa chọn. Gửi lựa chọn ngay; chỉ một giá trị được chọn trong trường đó.
Máy chủ kiểm tra thuộc tính có thuộc danh mục hiện tại hoặc danh mục cha của nội dung, đúng ngôn ngữ và thuộc nhóm được phép hay không. Nếu nội dung đã bị chuyển danh mục ở một tab khác, lưu một ô thuộc tính cũ có thể bị từ chối với thông báo Thuộc tính không thuộc danh mục nội dung hiện tại. Khi đó cần ghi lại phần đang nhập và mở lại trang để làm việc với bộ trường đúng.
Luôn đọc thông báo của từng lần lưu. Giá trị còn hiện trong ô sau một lỗi không chứng minh rằng máy chủ đã lưu thành công.
Kiểm tra kết quả
- Chờ thông báo thành công của đúng thao tác vừa thực hiện; đọc lỗi trước khi làm tiếp.
- Lưu hoặc sao chép phần còn đang soạn rồi mở lại bản ghi để đối chiếu dữ liệu máy chủ.
- Mở đúng trang website và ngôn ngữ để kiểm tra nội dung, trạng thái, đường dẫn và bố cục. Nếu còn dữ liệu cũ, kiểm tra cache và điều kiện module, không tạo thêm bản ghi trùng để xử lý.
