Init Reading Position – Plugin ghi nhớ vị trí đọc, tự động cuộn lại khi người dùng quay lại bài viết

Tính năng chính

• Ghi nhớ vị trí đọc bằng localStorage cho khách chưa đăng nhập.
• Lưu vị trí đọc vào user_meta theo từng thiết bị nếu người dùng đã đăng nhập (PC, Mobile, Tablet…).
• Tự động cuộn lại đúng đoạn đã đọc sau khi reload hoặc quay lại bài viết.
• Tùy chỉnh post type được áp dụng qua giao diện cài đặt.
• Không thêm bảng, không tracking, không bloat – hoàn toàn clean và an toàn.
• Không dùng jQuery, viết bằng Vanilla JS hiện đại.
• Hỗ trợ filter init_plugin_suite_reading_position_delay để tùy chỉnh thời gian dừng trước khi lưu.

Dành cho cả khách và người dùng đã đăng nhập

• Khách chưa đăng nhập sẽ được lưu bằng localStorage trình duyệt.
• Người dùng đã đăng nhập được lưu vào user_meta theo từng bài viết và từng thiết bị, đảm bảo mỗi thiết bị nhớ đúng vị trí đã đọc của nó.

Tùy chỉnh dễ dàng

• Bạn có thể chọn loại bài viết nào được kích hoạt chức năng này.
• Hỗ trợ filter để dev tùy chỉnh delay lưu vị trí hoặc can thiệp logic lưu theo post_id.

Cài đặt nhanh

1. Tải plugin và giải nén vào thư mục /wp-content/plugins/
2. Kích hoạt qua menu Plugins trong admin
3. Cấu hình các post type được hỗ trợ tại Settings → Reading Position
4. Hoàn tất – plugin tự động hoạt động, không cần thêm shortcode hay block.

Hiệu suất và tương thích

• Tương thích WordPress 5.5 trở lên
• Hỗ trợ PHP 7.4+
• Không phụ thuộc theme, tương thích với mọi giao diện phổ biến
• Code tối ưu, không gây chậm site kể cả bài viết rất dài

Dành cho Developer

• Filter init_plugin_suite_reading_position_delay để tùy chỉnh debounce khi lưu vị trí
• Filter init_plugin_suite_reading_position_meta_key để tùy chỉnh tên meta key lưu
• Filter init_plugin_suite_reading_position_data_to_store để can thiệp nội dung lưu
• Filter init_plugin_suite_reading_position_should_delete để quyết định có xoá vị trí đọc khi cuộn tới cuối
• Filter init_plugin_suite_reading_position_localized_data để truyền thêm dữ liệu sang JS

Ví dụ sử dụng các filter mở rộng:

// Thay đổi thời gian debounce (mặc định: 1000ms)
add_filter('init_plugin_suite_reading_position_delay', fn() => 2000); // 2 giây

// Tuỳ chỉnh tên meta_key dùng để lưu vị trí đọc
add_filter('init_plugin_suite_reading_position_meta_key', function ($key, $post_id, $device) {
    return "_custom_rp_{$post_id}_{$device}"; // Ví dụ: _custom_rp_123_PC
}, 10, 3);

// Can thiệp dữ liệu sẽ lưu vào user_meta (mặc định gồm scrollTop, percent, screenHeight, updated)
add_filter('init_plugin_suite_reading_position_data_to_store', function ($data, $post_id, $device, $user_id) {
    $data['ip'] = $_SERVER['REMOTE_ADDR'] ?? ''; // Lưu thêm IP người dùng (tuỳ mục đích)
    return $data;
}, 10, 4);

// Quyết định có xoá dữ liệu vị trí đọc khi người dùng cuộn tới cuối hay không
add_filter('init_plugin_suite_reading_position_should_delete', fn($yes) => false); // Không xoá, giữ lại để đọc lại lần sau

// Bổ sung dữ liệu truyền sang JS (InitRPData)
add_filter('init_plugin_suite_reading_position_localized_data', function ($data, $post_id) {
    $data['debug'] = current_user_can('manage_options'); // Gửi thêm biến debug nếu là admin
    return $data;
});

Bắt đầu ngay

Bạn đang làm blog, web truyện, tạp chí số hay long-form content? Init Reading Position sẽ mang đến trải nghiệm người đọc mượt mà hơn bao giờ hết – nhẹ, thông minh và hoàn toàn tự động.