The ([highlite_list]) shortcode in Highlite Pro provides users with a powerful personal dashboard to manage all their highlights across the site. It offers search, sorting, download, and print functionalities, all in a clean tabular interface.
🧩 What This Shortcode Does #
- Displays a table of all posts where the logged-in user has saved highlights.
- Lists:
- The post title (linked to original content)
- The date of last highlight
- Action icons to download (DOCX) or print the highlights.
- Includes a search/filter bar, sorting dropdowns, and pagination.
⚠️ Only available to logged-in users. Guests will see a login prompt.
📦 How to Use #
➕ Adding the Shortcode #
To show the dashboard on any post or page, insert:
[highlite_list]
You can insert it:
- In the WordPress block editor (Gutenberg) using a Shortcode block
- In a Classic Editor via the standard editor area
- Inside any HTML widget or custom page template
🔍 Filter Options #
Displayed above the highlight table, these filters help users quickly find what they need:
- Search Bar: Looks through both post titles and highlighted texts.
- Sort By:
- Date (default)
- Title
- Order:
- Descending (latest first)
- Ascending
🧠 Filter inputs use
GETparameters, so URLs can be bookmarked or shared.
📊 Table View #
The table displays:
| Post Title | Last Highlighted On | Actions |
|---|---|---|
| Clickable title | Formatted date | DOCX 📥 + Print 🖨️ |
- Post Title: Linked to the original post/page.
- Date: Fetched from the
user_highlight_dates_meta. - Actions:
- 🖨️ Print — Opens a print-friendly HTML version.
- 📥 Download — Triggers a DOCX file download.
🔁 Pagination #
- Displays 10 items per page.
- Page navigation appears at the bottom.
- Pagination preserves search and sorting query strings.
🛡️ Security & Access Control #
- All actions are nonce-protected to prevent unauthorized access.
- Only the current logged-in user can:
- View their highlights
- Download/print their saved content
🧪 Example Use Case #
If a user highlights notes across 15 blog posts, this dashboard becomes their personal study/reading center, allowing them to:
- Revisit the exact posts
- Re-download key excerpts
- Edit/remove older highlights from the original post frontend
