LekTrail Reading Tracker

外掛說明

Most websites have no memory. Visitors return and see the same content with no recognition of what they’ve already explored. LekTrail changes that.

For content sites: Show readers which articles they started but didn’t finish, and suggest new content based on their history.

For e-commerce: Display recently viewed products so customers can easily return to items they were considering.

For courses and documentation: Track progress through lessons or guides, showing what’s completed and what’s next.

How It Works

LekTrail tracks when visitors scroll through your content:

  • Viewed: Posts they started reading
  • Completed: Posts they scrolled to the end (configurable threshold)
  • Suggestions: Unread posts based on your configuration

The widget displays three sections: “Continue Reading”, “Completed”, and “Suggested Reading”.

Two Tracking Modes

localStorage Mode (Default)

  • Works for all visitors, no login required
  • Data stored in browser, completely private
  • Optional consent banner
  • Data clears if browser storage is cleared

Server-Side Mode

  • Requires logged-in users (WordPress users or membership plugin)
  • Reading history persists across devices
  • Useful for membership sites, courses, or personalized experiences
  • Anonymous visitors see suggestions only

Features

  • Gutenberg block and shortcode support
  • Works with any post type (posts, pages, products, custom types)
  • Configurable scroll threshold to mark content as “completed”
  • Show/hide excerpts and thumbnails
  • Suggestion order: random, recent, or related
  • Category filters for suggestions
  • Customizable labels (multilingual ready)
  • Optional consent requirement with built-in banner
  • Performance caching for suggestions

Development

Source code and build tools are available on GitHub.

螢幕擷圖

適用於區塊編輯器

這個外掛提供 3 個可供 Gutenberg/區塊編輯器使用的區塊。

  • LekTrail Reading Tracker Display reading progress and suggestions for your visitors.
  • LekTrail Reading Progress Display a reading progress bar, filterable by category and year.
  • LekTrail Reading List Display a filtered list of read or viewed posts.

安裝方式

  1. Upload lektrail to /wp-content/plugins/
  2. Activate the plugin
  3. Add the widget:
    • Gutenberg: Search for “LekTrail” in the block inserter
    • Shortcode: Add [lektrail] to any page
  4. Configure in Settings > LekTrail

常見問題集

Does this work without user registration?

Yes. By default, LekTrail uses localStorage which works for all visitors without requiring login. Data is stored privately in the visitor’s browser.

Can I track reading progress for logged-in users?

Yes. Enable “Track Logged-in Users” in settings. This stores reading history on the server, allowing it to persist across devices. Requires users to be logged in (WordPress users or via a membership plugin).

What post types can I track?

Any post type: posts, pages, WooCommerce products, custom post types. Configure which types to track in the settings.

How do I customize the widget appearance?

The widget uses minimal styling. Add your own CSS targeting .lektrail-widget, .lektrail-continue, .lektrail-completed, and .lektrail-suggestions.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈LekTrail Reading Tracker〉的開發相關工作。

參與者

將〈LekTrail Reading Tracker〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

1.1.0

  • Reading dashboard blocks for logged-in users: progress bar and reading list
  • Three display modes: progress (percentage), remaining (posts to read), count (posts read)
  • Per-category progress with automatic child category inclusion
  • Category dropdown selector in block editor (replaces text input)
  • Status indicators on reading lists (checkmark for read, circle for viewed)
  • Block patterns: Category Breakdown, Year Overview, Simple Dashboard
  • Custom LekTrail block category in the block inserter
  • Spanish translations for dashboard labels
  • Fix: server-side tracking no longer blocked by localStorage checks

1.0.0

  • Initial release
  • localStorage and server-side tracking modes
  • Gutenberg block and shortcode
  • Configurable suggestions (random, recent, related)
  • Category filters
  • Consent management
  • Custom labels