Appearance
Pin Timeline Post
The Pin Timeline Post function allows post authors to pin a timeline entry to the top of their post’s timeline feed. Pinned posts stay visible at the top, ensuring important announcements or updates are seen first by visitors.
Overview
This feature adds a “Pin to Top” option for post authors to highlight important timeline entries. Whether it’s a special announcement, featured review, or important update, pinning ensures it stays at the top of the timeline feed regardless of when it was posted.
Key Features
- Pin any timeline post to the top of the feed
- Only post authors can pin posts on their timeline
- One pinned post per timeline at a time
- Visual “Pinned” badge on pinned posts
- Easy toggle to pin/unpin via icon
- Integrates with Voxel’s Timeline widget
- Styling options via Timeline Style Kit widget
- AJAX-powered for instant updates
Setup Instructions
Step 1: Enable the Function
- Navigate to Voxel Toolkit → Functions in your WordPress admin
- Find Timeline Pin in the list
- Toggle the switch to enable
- Click Save Changes
Step 2: Enable on Timeline Widget
- Edit your post template in Elementor
- Select the Timeline widget
- In widget settings, find Enable Pin to Top (VT)
- Toggle to Yes
- Save the template
How It Works
For Post Authors
- View your post’s timeline feed
- Find the timeline entry you want to pin
- Click the pin icon next to the entry’s action buttons
- The post immediately moves to the top with a “Pinned” badge
- To unpin, click the pin icon again
For Visitors
Visitors see the pinned post at the top of the timeline with a “Pinned” badge. They cannot pin or unpin posts unless they are the post author.
Styling Options
Customize the appearance of pinned posts via the Timeline Style Kit widget in Elementor. A new “Pinned Post (VT)” section appears with the following options:
Pinned Post
| Setting | Description |
|---|---|
| Border Color | Custom border color for pinned posts to make them stand out |
Pinned Badge
| Setting | Description |
|---|---|
| Alignment | Left, Center, Right, or Full Width |
| Background | Badge background color |
| Text Color | Badge text color |
| Typography | Font settings for badge text |
| Padding | Internal spacing of badge |
| Border Radius | Roundness of badge corners |
Pin Icon
| Setting | Description |
|---|---|
| Color | Pin icon color |
| Size | Pin icon size (10-30px) |
Use Cases
Business Announcements
Pin important announcements like holiday hours, special promotions, or policy changes so customers see them first.
Featured Reviews
Highlight your best customer review by pinning it to the top of the timeline.
Event Updates
Keep important event updates visible at the top while new posts continue to flow below.
Welcome Messages
Create and pin a welcome message that introduces visitors to your listing.
Permissions
Only the post author can pin/unpin timeline entries on their post. The pin icon only appears for:
- Logged-in users
- Who are the author of the current post
- On timelines where pin is enabled
Troubleshooting
Pin Icon Not Appearing
- Verify the Timeline Pin function is enabled in Voxel Toolkit
- Check that “Enable Pin to Top” is turned on in the Timeline widget
- Ensure you are logged in as the post author
- Clear any caching plugins
Pinned Post Not Showing at Top
- Refresh the page to see the pinned post
- Check for JavaScript errors in browser console
- Verify the timeline entry still exists
Styling Not Applying
- Style options are in the Timeline Style Kit widget, not the Timeline widget
- Ensure Timeline Style Kit is on the same template
- Clear Elementor cache after making style changes