Init FX Engine – Interactive, Event-Driven, Lightweight

Nhật ký thay đổi

2.0.1 – 1 Tháng 10, 2026

• Mới: Hiệu ứng theo mùa — các khung cảnh lễ hội được dựng phía trên trang web: Halloween (dơi, bóng ma, quả bí ngô), Giáng sinh, Năm mới, Tết Nguyên Đán (hoa đào & hoa mai, lì xì), Valentine và Trung thu (đèn lồng phát sáng bay lên). Ba kiểu chuyển động: rơi, bay lên và đung đưa/chao đảo
• Mới: Lịch lễ hội tích hợp sẵn với tính năng tự động chuyển đổi chủ đề; ngày Tết và Trung thu được tính toán từ Âm lịch Việt Nam (UTC+7) và được tích hợp đến hết năm 2040. Đồng thời hỗ trợ khoảng ngày tùy chỉnh hoặc chế độ luôn bật, chỉ hiển thị trên trang chủ và emoji tùy chỉnh
• Mới: Hiệu ứng lời chào theo chủ đề, phát một lần cho mỗi phiên trình duyệt (màn trình diễn pháo hoa vào Năm mới, lì xì vào dịp Tết, thả đèn lồng vào Tết Trung thu…)
• Các hiệu ứng mới: Bùng nổ Halloween, Lì xì (Tết), Màn trình diễn pháo hoa, Bùng nổ tuyết, Thả đèn lồng — hỗ trợ dưới dạng từ khóa, trong [initfxen-fx] và trong block FX Trigger
• Thư viện mới: fireworks-js 2.10.8 (MIT) dành cho Màn trình diễn pháo hoa chân thực. Thư viện chỉ được tải chậm khi hiệu ứng thực sự chạy; nếu không thể tải, pháo hoa dạng kim tuyến (confetti) cổ điển sẽ được sử dụng thay thế
• Mới: JavaScript API — FXEngine.trigger( name, options ), FXEngine.register( name, fn ) và FXEngine.effects() (tiếng gọi FXEngine.trigger được đề cập trong phần FAQ giờ đây đã thực sự tồn tại)
• Cài đặt: phần Hiệu ứng theo mùa với nút Xem trước trực tiếp, lịch lễ hội sắp tới và chỉ báo “hôm nay người truy cập sẽ thấy gì”; bổ sung các nút xem trước cho từng hiệu ứng mới
• Cài đặt: trang cài đặt giờ đây được tổ chức thành các phần rõ ràng (Preloader, Hiệu ứng từ khóa, Tuyết rơi, Hiệu ứng theo mùa, Chế độ trắng đen, Định dạng trực tiếp), mỗi cài đặt một hàng với nhãn thích hợp. Tên các trường không đổi, nên các cài đặt hiện tại vẫn được giữ nguyên
• Hiệu năng: trình dựng hình theo mùa vẽ các sprite emoji được dựng sẵn trên một canvas duy nhất, khởi chạy sau khi tải trang thông qua requestIdleCallback, tạm dừng khi thẻ bị ẩn, giới hạn tỷ lệ điểm ảnh thiết bị (device pixel ratio) ở mức 2, giảm số lượng hạt trên màn hình nhỏ và tuân thủ prefers-reduced-motion
• Hiệu năng: định dạng trực tiếp (inline formatting) không còn chuyển đổi chuỗi toàn bộ trang (innerHTML) để tìm spoiler nữa, và sẽ bỏ qua các nút văn bản không có bất kỳ dấu hiệu định dạng nào trước khi chạy biểu thức chính quy (regular expressions)
• Hiệu năng: các hình dạng emoji/trái tim được lưu trong bộ nhớ đệm thay vì phải dựng lại ở mỗi hiệu ứng, và tất cả shortcode “in-view” dùng chung một IntersectionObserver duy nhất
• Hiệu năng: xóa các quy tắc trùng lặp khỏi CSS quan trọng (critical CSS) của preloader (kết quả hiển thị không đổi)
• Tương thích: fx-engine.js và fx-snowfall.js giờ đây cũng khởi chạy khi chúng bị hoãn/trì hoãn bởi các plugin tối ưu hóa (sau sự kiện DOMContentLoaded); fx-engine.js khai báo rõ ràng phụ thuộc canvas-confetti của nó
• Nhà phát triển: bổ sung các bộ lọc mới init_plugin_suite_fx_engine_seasonal_themes, init_plugin_suite_fx_engine_seasonal_window, init_plugin_suite_fx_engine_lunar_dates, init_plugin_suite_fx_engine_seasonal_config
• Quốc tế hóa: các chuỗi mới đã được thêm vào tệp POT và bản dịch tiếng Việt (PO/MO/JSON được tạo lại bằng WP-CLI)
• Gỡ cài đặt: tùy chọn mới init_plugin_suite_fx_engine_seasonal sẽ bị xóa khi gỡ cài đặt

2.0.0 – 4 tháng 8, 2026

• Mới: Hỗ trợ Block Editor (Gutenberg): một block FX Trigger gốc (tương đương với [initfxen-fx]), được nhóm trong danh mục block Init FX Engine riêng (thay vì danh mục “Widgets” chung chung). Được đăng ký qua block.json (với tệp PHP render.php kết nối qua trường "render", WP 6.1+) gọi chính xác cùng hàm shortcode như shortcode tương ứng của nó — không lặp lại logic hiển thị, kết quả luôn khớp nhau. Tích hợp trình soạn thảo là một tệp JavaScript thuần, không cần bước build, sử dụng wp.serverSideRender để xem trước trực tiếp ngay trong trình soạn thảo. Shortcode [initfxen-fx-ambient] chưa có block tương đương trong phiên bản này — hành vi hiển thị của nó chưa đủ ổn định; bản thân shortcode không bị ảnh hưởng
• Thay đổi: Requires at least được nâng từ 5.5 lên 6.9, để nhất quán với các phiên bản 2.0.0 khác trong Init Plugin Suite
• Lưu ý: phiên bản này không thêm hỗ trợ Abilities API. Plugin này không có dữ liệu nào để đọc hoặc ghi — mọi thứ nó làm chỉ là hiệu ứng hình ảnh thuần túy phía client — nên không có gì đáng để một AI agent truy vấn
• Đã kiểm tra đến: 7.1

1.6 – 17 tháng 12, 2025

• Cải tiến: Đã thêm tùy chọn cấu hình Tuyết rơi nâng cao — kiểm soát lượng tuyết, kích thước, tốc độ rơi, và độ trong suốt
• Trải nghiệm người dùng: Giới thiệu tinh chỉnh tuyết rơi chi tiết để hình ảnh cân bằng, không lấn át nội dung
• Hiệu năng: Đã tối ưu tính toán mật độ hạt để tránh rối mắt khi số lượng tuyết cao
• Độ ổn định: Áp dụng giới hạn giá trị nghiêm ngặt và giá trị mặc định an toàn để tránh cấu hình sai và hiệu ứng cực đoan
• Lập trình viên: Đã chuẩn hóa schema cài đặt tuyết rơi với giá trị mặc định tương thích ngược cho các bản cài cũ
• Lập trình viên: Frontend giờ nhận một payload cấu hình tuyết rơi tối giản, đã làm sạch (giảm bề mặt và sự phụ thuộc của JS)
• Tương thích: Cải thiện khả năng phục hồi khi particles.js tải trễ hoặc cấu hình bị thiếu một phần
• Quốc tế hóa: Đã thêm các chuỗi có thể dịch cho mọi cài đặt Tuyết rơi mới và mô tả hỗ trợ
• Chất lượng mã nguồn: Đã tái cấu trúc logic khởi tạo tuyết rơi để tách biệt rõ ràng hơn giữa logic lịch trình và hiển thị
• Khả năng bảo trì: Đã chuẩn bị module Tuyết rơi cho các cấu hình có sẵn trong tương lai (Nhẹ / Bình thường / Dày đặc) mà không phá vỡ tương thích

1.5 – 9 tháng 12, 2025

• Tính năng mới: Đã thêm tùy chọn Tuyết rơi chỉ ở trang chủ — cho phép hiệu ứng tuyết rơi chạy riêng trên trang chủ
• Trải nghiệm người dùng: Cài đặt tuyết rơi giờ cung cấp kiểm soát phạm vi rõ ràng hơn giữa toàn site và chỉ trang chủ
• Lập trình viên: Đã mở rộng schema tùy chọn tuyết rơi với cờ homepage_only
• Bảo mật: Cải thiện việc làm sạch dữ liệu cho cài đặt phạm vi tuyết rơi
• Tương thích: Đảm bảo hành vi đúng với cả cấu hình is_front_page() lẫn is_home()
• Độ ổn định: Ngăn việc tải tài nguyên không cần thiết trên các trang không phải trang chủ khi chế độ chỉ trang chủ được bật
• Hiệu năng: Đã giảm dung lượng script frontend khi tuyết rơi bị giới hạn ở trang chủ

1.4 – 14 tháng 11, 2025

• Hiệu năng: Đã xây dựng lại FX Keyword Scanner — giờ dùng TreeWalker một lượt duyệt, engine biểu thức chính quy hợp nhất, loại trùng ở cấp cha, và quy tắc bỏ qua thông minh để phân tích DOM cực nhanh
• Độ ổn định: Cải thiện kiểm tra an toàn với data-fx-keyword-processed để ngăn vòng lặp xử lý lại và đảm bảo thay thế node gọn gàng
• Trải nghiệm người dùng: Tương tác kích hoạt từ khóa mượt mà hơn qua một trình lắng nghe nhấp chuột ủy quyền duy nhất (giảm chi phí sự kiện và tăng độ phản hồi)
• Lập trình viên: Đã tái cấu trúc quy trình khớp nội bộ để rõ ràng hơn, dễ mở rộng, và dễ gỡ lỗi hơn
• Tương thích: Phát hiện từ khóa chính xác hơn trên nội dung HTML đa ngôn ngữ và định dạng hỗn hợp

1.3 – 13 tháng 9, 2025

• Tính năng mới: Đã thêm tùy chọn Preloader chỉ theo phiên (chỉ hiển thị preloader ở lần truy cập đầu tiên mỗi phiên)
• Tính năng mới: Đã thêm Công tắc định dạng nội tuyến (bật/tắt việc phân tích cú pháp nội tuyến trong văn bản)
• Tính năng mới: Giới thiệu Cú pháp Spoiler dùng ||text|| — bọc bất kỳ nội dung nào (kể cả ảnh) trong một khung mờ với lớp phủ nhấp để hiện
• Quốc tế hóa: Nhãn lớp phủ spoiler (Nhấn để hiện) giờ có thể dịch qua i18n
• Chèn CSS: Đã tối ưu để chỉ tải kiểu làm nổi bật và spoiler khi cần
• Lập trình viên: Đã mở rộng việc làm sạch dữ liệu và đăng ký cài đặt cho các tùy chọn mới (session_once, inlinefmt)
• Độ ổn định: Đã sửa lỗi trùng lặp khi phân tích khối spoiler và đảm bảo cấu trúc DOM gọn gàng
• Trải nghiệm người dùng: Cải thiện khả năng truy cập của spoiler với nhãn ARIA

1.2 – 25 tháng 8, 2025

• Sửa lỗi nghiêm trọng: Đã giải quyết vấn đề preloader nhấp nháy/chớp trong lúc tải trang
• Hiệu năng: Đã loại bỏ tình trạng tranh chấp thời điểm trong trình tự tải tài nguyên
• Tương thích: Tăng cường hỗ trợ cho các theme không có hook wp_body_open
• Độ ổn định: Đã sửa lỗi “Cannot read properties of null” khi thực thi sớm
• Chất lượng mã nguồn: Đã tái cấu trúc cơ chế thời gian preloader để tuân thủ chuẩn WordPress
• Trải nghiệm người dùng: Chuyển tiếp mượt mà hơn với tải CSS quan trọng chống nhấp nháy
• Lập trình viên: Cải thiện xử lý lỗi và dự phòng giảm cấp mượt mà

1.1 – 24 tháng 8, 2025

• Hiệu ứng mới: Particle Burst, Text Typewriter, Floating Bubbles, Lightning Strike
• Kích hoạt nâng cao: Dựa trên cuộn trang, chuỗi trì hoãn thời gian, theo dõi tương tác
• Từ khóa nâng cao: Hỗ trợ cụm từ, khớp không phân biệt hoa/thường, nhập/xuất hàng loạt
• Tối ưu di động: Hiệu năng tốt hơn 40%, hiệu ứng co giãn responsive
• API cho lập trình viên: Tạo hiệu ứng tùy chỉnh, chế độ gỡ lỗi, hook WordPress
• Sửa lỗi: Tranh chấp thời điểm của preloader, tương thích Safari, dọn dẹp bộ nhớ

1.0 – 17 tháng 5, 2025

• Phiên bản công khai đầu tiên
• Pháo hoa, mưa emoji, mưa trái tim, cannon blast và nhiều hơn nữa
• Preloader có hoạt hình với 6 kiểu tích hợp sẵn
• Trang cài đặt với xem trước theo thời gian thực
• Shortcode để kích hoạt và hiệu ứng xung quanh
• Bộ lên lịch tuyết rơi (tự động/tùy chỉnh)
• Chế độ đen trắng tùy chọn (thủ công hoặc theo lịch)
• Định dạng văn bản nội tuyến với cú pháp thông dụng
• Được tối ưu hiệu năng và có thể mở rộng