Mô tả tính năng cài đặt của EzyArticle
Back to ezyarticleSau khi EzyArticle được cài đặt, quản trị viên có thể điều chỉnh cách plugin biên tập, tìm kiếm, xuất bản và cung cấp nội dung tại màn hình Cài đặt. Đây cũng là nơi quản lý các tác vụ nền phục vụ lập chỉ mục và chuẩn hóa dữ liệu.
Màn hình này chỉ dành cho người dùng đã đăng nhập và có quyền quản lý cài đặt.
Quản lý các tác vụ dữ liệu
Phần đầu màn hình hiển thị các tác vụ xử lý dữ liệu của EzyArticle. Tùy theo trạng thái hiện tại, quản trị viên có thể điều khiển từng tác vụ thông qua các thao tác do EzyPlatform cung cấp.
Các tác vụ gồm:
- Lập chỉ mục tiêu đề bài viết.
- Lập chỉ mục tác giả.
- Lập chỉ mục danh mục và thẻ.
- Lập chỉ mục dữ liệu hệ thống đã được gắn thẻ.
- Tạo liên kết tìm kiếm cho bài viết.
- Tạo liên kết đến tác giả quản trị.
- Tạo liên kết cho bình luận.
- Cập nhật trạng thái bài viết theo lịch.
- Sinh nội dung rút gọn cho các bài viết hiện có.
- Bổ sung người dùng với vai trò đồng tác giả.
- Thống kê số bài đã xuất bản theo term.
- Thống kê số nội dung con đã xuất bản.
Những tác vụ này đặc biệt hữu ích sau khi nâng cấp plugin, thay đổi cấu hình hoặc nhập một lượng lớn dữ liệu từ hệ thống khác.
Không phải tác vụ nào cũng cần chạy liên tục. Chẳng hạn, tác vụ cập nhật trạng thái theo lịch cần hoạt động để bài viết được phát hành đúng thời điểm, trong khi một số tác vụ lập chỉ mục có thể chỉ cần chạy khi dữ liệu cần được đồng bộ lại.
Cấu hình nội dung rút gọn
EzyArticle có khả năng tự tạo phiên bản rút gọn từ nội dung đầy đủ. Màn hình Cài đặt cung cấp hai giới hạn:
- Độ dài nội dung tối đa để plugin thực hiện rút gọn khi lưu.
- Độ dài tối đa của kết quả sau khi rút gọn.
Giới hạn thứ nhất giúp tránh xử lý tự động đối với nội dung quá lớn. Giới hạn thứ hai kiểm soát kích thước đoạn trích được sử dụng trong danh sách bài viết, kết quả tìm kiếm hoặc thẻ giới thiệu.
Một số loại nội dung có thể không cần nội dung rút gọn, ví dụ trang bố cục, dữ liệu dạng tệp hoặc nội dung do một trình dựng trang quản lý. Quản trị viên có thể khai báo danh sách loại bài được loại khỏi quá trình này.
Khi thay đổi quy tắc, tác vụ sinh nội dung rút gọn có thể được sử dụng để cập nhật lại dữ liệu cũ.
Mở rộng loại nội dung
Ngoài các loại nội dung có sẵn, EzyArticle cho phép khai báo thêm:
- Loại bài viết.
- Loại trang.
- Trạng thái bài viết.
- Loại term.
- Loại bình luận.
Các giá trị bổ sung được nhập dưới dạng danh sách. Sau khi lưu, chúng sẽ được kết hợp với tập giá trị mặc định của plugin.
Tính năng này cho phép một dự án định nghĩa các khái niệm riêng như tài liệu, khóa học, hồ sơ dự án hoặc nội dung quảng bá mà không phải thay đổi mô hình dữ liệu cốt lõi.
Việc thêm một loại mới chỉ giúp EzyArticle nhận diện và quản lý giá trị đó. Theme hoặc plugin nghiệp vụ vẫn cần triển khai cách nhập liệu, truy vấn hay hiển thị riêng nếu loại nội dung có hành vi đặc biệt.
Chọn loại phân loại chính
Cài đặt “Loại term chính” xác định hệ thống phân loại được ưu tiên khi tổ chức bài viết.
Tùy mô hình website, loại chính có thể là:
- Danh mục cho blog hoặc trang tin.
- Series cho nội dung nhiều phần.
- Nhóm bài viết cho cổng thông tin.
- Danh mục wiki cho hệ thống tài liệu.
Việc xác định loại chính giúp giao diện quản trị và những thành phần tích hợp có một quy ước chung khi cần chọn phân loại mặc định.
Nếu các loại term có sẵn chưa đáp ứng nghiệp vụ, quản trị viên có thể khai báo thêm loại mới ngay trên màn hình này.
Cấu hình trình soạn thảo
EzyArticle cho phép chọn trình soạn thảo mặc định độc lập cho ba nhóm dữ liệu:
- Bài viết.
- Trang.
- Bình luận.
Theo cấu hình mặc định, bài viết sử dụng trình soạn thảo nội dung trực quan, trang sử dụng công cụ thiết kế bố cục và bình luận sử dụng trình nhập văn bản đơn giản. Danh sách lựa chọn thực tế có thể mở rộng khi plugin khác đăng ký thêm trình soạn thảo.
Việc tách riêng ba cấu hình giúp mỗi loại nội dung có trải nghiệm phù hợp. Bài viết thường cần công cụ định dạng văn bản, trong khi trang có thể cần thiết kế bố cục kéo thả.
Cấu hình ở đây là lựa chọn mặc định. Hệ thống vẫn có thể ánh xạ trình soạn thảo riêng theo loại bài hoặc định dạng nội dung.
Cấu hình tìm kiếm bài viết
Nhóm cài đặt tìm kiếm cho phép quản trị viên kiểm soát nội dung nào được tham gia tìm kiếm và cách hệ thống thực hiện truy vấn.
Các lựa chọn chính gồm:
- Danh sách loại bài có thể tìm kiếm.
- Danh sách trạng thái bài được phép hiển thị.
- Cho phép tìm bài bằng phép so khớp gần đúng.
- Cho phép nhận diện từ khóa tìm kiếm.
“Loại bài có thể tìm kiếm” giới hạn phạm vi dữ liệu. Ví dụ, website có thể cho phép tìm bài blog, tin tức và wiki nhưng loại trừ fragment hoặc nội dung nội bộ.
“Trạng thái được phép hiển thị” tạo thêm một lớp lọc trước khi dữ liệu được cung cấp cho giao diện. Danh sách này cần được cấu hình thận trọng để tránh đưa bản nháp, nội dung nội bộ hoặc nội dung trong thùng rác vào kết quả công khai.
Tìm kiếm gần đúng thuận tiện cho hệ thống nhỏ và cấu hình đơn giản. Với lượng dữ liệu lớn, dự án nên kết hợp các tác vụ lập chỉ mục và công cụ tìm kiếm của EzyPlatform để đạt hiệu năng tốt hơn.
Tính năng nhận diện từ khóa cho phép hệ thống ghi nhận hoặc tổ chức các cụm từ tìm kiếm theo mô hình term. Khả năng này có thể được sử dụng để phân tích nhu cầu người đọc hoặc xây dựng trang kết quả theo chủ đề.
Cấu hình bình luận
Quản trị viên có thể bật hoặc tắt bình luận trên toàn hệ thống. Khi bình luận được bật, màn hình Cài đặt cung cấp thêm các giới hạn và chính sách kiểm soát:
- Yêu cầu người dùng đăng nhập trước khi bình luận.
- Số bình luận tối đa trên mỗi bài.
- Độ dài tối đa của nội dung bình luận.
- Cho phép tìm bình luận bằng phép so khớp gần đúng.
- Các loại bình luận bổ sung.
- Những loại bình luận người dùng được phép tạo.
- Những trạng thái bình luận người dùng được phép sử dụng.
Việc khai báo thêm loại bình luận không đồng nghĩa với việc người dùng được phép tạo mọi loại đó. Hai danh sách “loại bổ sung” và “loại được phép” được tách riêng để quản trị viên có thể dành một số loại cho quy trình nội bộ.
Tương tự, trạng thái người dùng được phép gửi cần được giới hạn. Trong hệ thống có kiểm duyệt, bình luận mới thường nên đi vào trạng thái chờ duyệt thay vì được chấp nhận ngay.
Các giới hạn số lượng và độ dài được kiểm tra ở phía máy chủ. Giá trị giới hạn phải là số dương thì cấu hình mới được chấp nhận.
Cấu hình metadata
Metadata giúp dự án bổ sung thuộc tính riêng cho bài viết mà không cần thay đổi cấu trúc dữ liệu cốt lõi. Màn hình Cài đặt cung cấp hai phần liên quan:
- Schema mô tả metadata có thể nhập.
- Danh sách metadata được phép truy xuất.
Schema được khai báo dưới dạng JSON và phải có cấu trúc hợp lệ. Nếu nội dung không thể được phân tích thành một đối tượng JSON, máy chủ sẽ từ chối lưu và trả lỗi tại trường tương ứng.
Sau khi cấu hình được lưu thành công, bộ quản lý metadata có thể chỉnh sửa sẽ được tải lại ngay. Vì vậy, thay đổi schema có thể được phản ánh trên giao diện quản trị mà không cần khởi động lại toàn bộ ứng dụng.
Danh sách metadata được phép truy xuất đóng vai trò như một lớp kiểm soát dữ liệu. Chỉ nên đưa vào đây những thuộc tính thực sự cần được cung cấp cho web runtime hoặc các thành phần bên ngoài.
Không nên lưu bí mật, mật khẩu, token hoặc thông tin nhạy cảm trong metadata chỉ vì dữ liệu này có cơ chế giới hạn truy xuất.
Cấu hình xem trước
EzyArticle cho phép cấu hình mẫu đường dẫn xem trước riêng cho:
- Bài viết.
- Trang.
Khi biên tập viên chọn xem trước, plugin sử dụng mẫu tương ứng để tạo đường dẫn đến giao diện web. Cách làm này cho phép mỗi dự án sử dụng quy tắc URL riêng mà không phải sửa phần quản trị của EzyArticle.
Mẫu xem trước cần tương thích với route do web plugin hoặc theme triển khai. Nếu chỉ cấu hình mẫu trong EzyArticle nhưng website không có route xử lý tương ứng, chức năng xem trước sẽ không thể hiển thị nội dung.
Khi website chạy trên tên miền hoặc ứng dụng web khác, cần bảo đảm địa chỉ web và luồng xác thực xem trước cũng đã được cấu hình đúng ở cấp EzyPlatform.
Cấu hình page fragment
Page fragment là các khối giao diện có thể được đăng ký và ghép vào trang. Màn hình Cài đặt cung cấp hai công tắc độc lập:
- Cho phép bổ sung page fragment vào giao diện quản trị.
- Cho phép bổ sung page fragment vào giao diện web.
Việc tách hai phạm vi giúp dự án kiểm soát rõ nơi fragment được sử dụng. Một fragment phục vụ công cụ nội bộ có thể được bật trong trang quản trị nhưng không xuất hiện trên website. Ngược lại, fragment trình bày nội dung cho người đọc chỉ cần được bật ở web runtime.
Đây là quyền cho phép tích hợp fragment, không phải công cụ tự động sinh giao diện. Fragment vẫn cần được đăng ký bởi plugin hoặc theme tương ứng.
Ghi log lỗi của hàm mở rộng
EzyArticle có các hàm mở rộng được sử dụng để cung cấp dữ liệu cho template và những thành phần tích hợp. Quản trị viên có thể bật ghi log ngoại lệ phát sinh trong quá trình thực thi các hàm này.
Nên bật tùy chọn này trong môi trường phát triển hoặc khi đang chẩn đoán lỗi. Ở môi trường production, cần cân nhắc dung lượng log và nguy cơ ghi lại dữ liệu không cần thiết.
Việc tắt ghi log không làm lỗi biến mất và cũng không thay thế cơ chế giám sát. Tùy chọn này chỉ điều khiển cách EzyArticle ghi nhận ngoại lệ từ nhóm hàm mở rộng.
Lưu và kiểm tra cấu hình
Khi quản trị viên lưu, toàn bộ biểu mẫu được gửi tới API quản lý cài đặt. Máy chủ thực hiện kiểm tra trước khi cập nhật dữ liệu.
Các điều kiện quan trọng gồm:
- Độ dài tối đa của nội dung rút gọn phải lớn hơn không.
- Số bình luận tối đa trên mỗi bài phải lớn hơn không.
- Độ dài tối đa của bình luận phải lớn hơn không.
- Schema metadata, nếu được khai báo, phải là JSON hợp lệ.
Nếu một giá trị không hợp lệ, cấu hình không được lưu và giao diện hiển thị lỗi tại trường tương ứng.
Các danh sách để trống được xử lý như tập rỗng, không phải giá trị không xác định. Vì vậy, việc xóa toàn bộ một danh sách có thể làm mất giới hạn hoặc phạm vi đã cấu hình trước đó. Quản trị viên nên kiểm tra kỹ các nhóm loại nội dung, trạng thái hiển thị và metadata trước khi lưu.
Cấu hình đề xuất ban đầu
Với một website nội dung thông thường, có thể bắt đầu theo hướng sau:
- Chỉ đưa các loại bài công khai vào phạm vi tìm kiếm.
- Chỉ cho phép trạng thái đã xuất bản xuất hiện trên website.
- Yêu cầu đăng nhập nếu website không muốn nhận bình luận ẩn danh.
- Đưa bình luận mới vào trạng thái chờ duyệt.
- Chọn trình soạn thảo văn bản cho bài viết và trình thiết kế bố cục cho trang.
- Chỉ cho phép truy xuất những metadata mà theme thực sự sử dụng.
- Kiểm tra mẫu xem trước với route của website.
- Khởi động tác vụ cập nhật trạng thái nếu sử dụng lịch xuất bản.
- Chạy lại các tác vụ lập chỉ mục sau khi nhập hoặc chuyển đổi dữ liệu lớn.
Lưu ý khi thay đổi cài đặt
Các lựa chọn trên màn hình Cài đặt có thể ảnh hưởng đến cả giao diện quản trị và dữ liệu trả về cho website. Trước khi thay đổi trên môi trường production, nên đặc biệt lưu ý:
- Mở rộng trạng thái hiển thị có thể làm lộ nội dung chưa sẵn sàng.
- Thay đổi loại bài có thể tìm kiếm sẽ ảnh hưởng trực tiếp đến kết quả tìm kiếm.
- Tắt tác vụ lịch xuất bản có thể khiến bài không đổi trạng thái đúng giờ.
- Thay đổi trình soạn thảo có thể làm nội dung cũ không tương thích hoàn toàn với định dạng mới.
- Xóa một trường khỏi schema không tự động xóa metadata đã lưu.
- Thay đổi cấu hình không thay thế việc triển khai route và template ở phía web.
- Các tác vụ xử lý lại dữ liệu lớn nên được theo dõi để tránh gây tải cao trong giờ cao điểm.
Kết luận
Màn hình Cài đặt của EzyArticle là trung tâm điều khiển hành vi của plugin. Nó không chỉ chứa các tùy chọn giao diện mà còn quyết định cách nội dung được rút gọn, phân loại, tìm kiếm, bình luận, xem trước và cung cấp cho những thành phần khác.
Việc cấu hình đúng ngay từ đầu giúp EzyArticle vận hành nhất quán, đồng thời tạo nền tảng để website mở rộng thêm loại nội dung, metadata và quy trình xuất bản trong tương lai.