Sticky Title Extension

huseyinfiliz · 2025-08-22T14:14:23+00:00

📝 Description Sticky Title enhances your Flarum forum's navigation by keeping discussion titles always visible while scrolling. Perfect for long discussions where users might lose track of what they're reading! 🎯 Why Sticky Title? Have you ever scrolled through a long discussion and forgotten which topic you were reading? Sticky Title solves this problem by intelligently displaying the discussion title as you navigate through posts. 🛠️ Latest Update v1 - August 26, 2025 v0.5 - August 25, 2025 ✨ Features 📱 Mobile Experience Smart Scroll Detection: Shows discussion title based on your scroll direction Customizable Behavior: Always show Show when scrolling down Show when scrolling up Never show Smooth Animations: Beautiful fade transitions that feel native Space Efficient: Replaces post count temporarily, no extra screen space needed 💻 Desktop Experience Elegant Sidebar Panel: Beautiful title panel that fits perfectly with Flarum's design Tag Display: Shows discussion tags for better context Quick Navigation: Click to instantly jump to the first post Scrubber Enhancement: See the discussion title instead of generic "Original Post" ⚙️ Admin Control Full control over every feature: Configure mobile scroll behavior Toggle scrubber title replacement Enable/disable desktop sidebar panel 📸 Screenshots Mobile - Title appears on scroll Desktop - Sidebar panel with tags Admin Settings Panel 📥 Installation composer require huseyinfiliz/sticky-title if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Or use Flarum Extension Manager: huseyinfiliz/sticky-title if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } ♻️ Updating composer update huseyinfiliz/sticky-title php flarum cache:clear if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 🔧 Compatibility ✅ Flarum: 1.8.1+ ✅ PHP: 8.1+ ✅ Tags Extension: Fully compatible ✅ Dark Mode: Fully supported ✅ Mobile: iOS & Android optimized 🎨 Customization The extension respects your forum's theme and automatically adapts to: Custom color schemes Dark/light modes Custom CSS variables Mobile responsive breakpoints 🌍 Translations Currently available in: 🇬🇧 English 🇹🇷 Türkçe If you like the extension and want to contribute, you can help translate it into your language for free via Weblate: HuseyinFiliz/Sticky-Title at Weblate 🐛 Found a Bug? Please report issues on GitHub with: Flarum version PHP version Browser and device Steps to reproduce 🤝 Contributing Contributions are welcome! Feel free to: Report bugs Suggest features Submit pull requests Add translations 📄 License Released under the MIT License. 🔗 Links GitHub Repository Packagist Extiverse 💬 Feedback I'd love to hear your thoughts! Please share your feedback, suggestions, or feature requests in this discussion thread. If you find this extension useful, please consider: ⭐ Starring on GitHub 👍 Like this post Thank you for using Sticky Title! 🙏 If you liked this extension, don’t forget to check out my other extensions too: huseyinfiliz.com/flarum

huseyinfiliz

luceos Thanks a lot for your suggestion! I’ll follow your advice and rely on the JS models instead of touching the recipients table directly. That really makes sense.

By the way, did you have a chance to try out the extension yet?

endlessedits

Really nice, thank you!

m4v3rick

huseyinfiliz

Thanks. Just saw this today. I will try it and give you feedback afterwards.

Edit: up and running. Thanks a lot, @huseyinfiliz ! Looks great!

huseyinfiliz

endlessedits m4v3rick Thanks so much! I’m really glad to hear it’s up and running smoothly for you 🎉

Turkish language is now added for Sticky Title. If you like the extension and want to contribute, you can help translate it into your language for free via Weblate: HuseyinFiliz/Sticky-Title at Weblate

Subarist

Oshvam

Hi @huseyinfiliz I think this might be useful to you. Sometimes on PCs, particularly long titles can cause the navigation bar between messages to shift.

To fix this, we can use this custom CSS to limit the number of lines displayed. You would need to edit the property -webkit-line-clamp: 3; for the number of lines, for example 2, 3 or 5. It might be interesting to include this as a future feature, but in the meantime, I think this CSS can help.

.PostStreamScrubber .Scrubber-first .ScrubberTitle {
    display: -webkit-box;
    -webkit-line-clamp: 3;
    -webkit-box-orient: vertical;
    overflow: hidden;
    white-space: normal;
}

huseyinfiliz

Oshvam Hi, thanks a lot for sharing this tip! 🙏
You're right — long titles can sometimes affect the navigation bar layout. Limiting the number of lines with -webkit-line-clamp is a neat solution, and adjusting the value depending on preference (2, 3, 5 lines, etc.) definitely helps. I’ll keep this in mind for a possible feature improvement.

A quick update 🌍✨

Sticky Title extension now supports;

English
Turkish
Chinese (Traditional)
Croatian
Indonesian

Subarist Thanks again to everyone who contributed with translations. If you like the extension and want to contribute, you can help translate it into your language for free via Weblate: HuseyinFiliz/Sticky-Title at Weblate

Karl

Hey, I don't know what's going on right now. But I just noticed that the FoF Pages Title is no longer stickied. I wonder if it's from the recent update.

huseyinfiliz

Karl Hey, I'm not entirely sure what's causing that, but I'll try to fix it as soon as possible.
Thanks for letting me know!

huseyinfiliz

🎉 v1.8 - Byobu Support

✨ New Features

🔥 FoF Byobu Support: Added full support for FoF Byobu private discussions.

Recipient users and groups are now displayed in the sidebar panel (desktop)
Shows private discussion participants with dedicated icons
Respects your chosen tag color style settings (background, text, or border)
Works seamlessly with the existing design

📑 FoF Pages Fixed: FoF Page support removed in v1 has been restored.

Page titles are now displayed in the mobile header when viewing FoF Pages
Provides consistent navigation experience across your forum
Can be toggled on/off in the admin panel

🎨 CSS Update: Cleaner Tag Styling
Based on @Wlork’s suggestion, the !important declarations have been removed from the CSS code.
Now, when using the Text Color Only tag color style, you can apply this custom CSS to use it without borders:

.StickyTitlePanel-tags .TagLabel {
  border: none !important;
}

📋 Features Recap

For those new to Sticky Title, here's what the extension offers:

Mobile Discussion Titles: Keep discussion titles visible in the mobile header while scrolling
Desktop Sidebar Panel: Display discussion title and tags in a beautiful sidebar panel
Scrubber Enhancement: Replace "Original Post" with the actual discussion title
Customizable Tag Colors: Choose between background, text, or border color styles
Blog Integration: Support for blog article titles in mobile header

🔧 Installation

composer require huseyinfiliz/sticky-title:"*"

🔄 Update Instructions

composer update huseyinfiliz/sticky-title:"*"
php flarum migrate
php flarum cache:clear

⚙️ Configuration

All features can be configured through the admin panel under Extensions > Sticky Title:

Mobile scroll direction behavior
Scrubber replacement options
Desktop sidebar title display
Tag color style preferences
FoF Pages header toggle
Blog header toggle

🔗 Links

GitHub: huseyinfiliz/sticky-title
Packagist: huseyinfiliz/sticky-title

🙏 Feedback & Support

⭐ Don’t forget to star it on GitHub!
ℹ If you encounter any issues or have suggestions for improvement, please reply to this discussion thread.

Enjoy the update! 🎉

Thanks:
Karl Oshvam Subarist m4v3rick endlessedits luceos Wlork

Karl

huseyinfiliz looks great so far man! Thanks for the update!

Wlork

huseyinfiliz Thank you very much for your work ! It work perfectly !

Impulsive5

I would like to be able to configure the extension so the tag list in the box above the scrubber will take the user the tag they click on. Clicking on any other part of the box would take the user to the first post as it does now.

huseyinfiliz

Impulsive5 Yes, that makes sense. We could also apply the same behavior for users in Byobu private discussions. I’m adding this to the to-do list.

Do you think this should be the default behavior, or should we add a setting for it in the admin panel as well?

Impulsive5

huseyinfiliz I think it should be default behavior. I can't think of a reason an admin wouldn't want it. Admins like config options so definitely make it an option.

ClaudiusH

Thanks for this sleek extension. I just finished translating the last remaining German strings on weblate.

huseyinfiliz

ClaudiusH Thank you for helping the extension reach more users by translating it!

Also, we’ve just reached 1,000 downloads! Thanks to everyone who uses it, supports it, and contributes to its development! 🎉

Karl

Man I really wish this would be compatible with 2.0 tomorrow! 😛

huseyinfiliz

🎉 v1.8.1 - Security, Performance & Clickable Widgets

Hello everyone! Shortly after the v1.8 release, we are rolling out v1.8.1. This is a highly recommended update that addresses a critical security vulnerability, introduces massive performance gains, and adds highly requested interactive features to the extension.

🔒 Security Fix: Stored XSS Patched

A big thanks to the community for reporting this! In v1.8, discussion titles containing HTML/JS payloads could execute malicious scripts on mobile views due to an unsafe innerHTML injection technique.

Fix: All UGC (User Generated Content) inputs are now securely escaped using strict DOM text properties (textContent). Code injection via discussion titles is completely neutralized.

🚀 Performance Boost: Goodbye CPU Polling!

We discovered a heavy production risk where an infinite requestAnimationFrame loop was tracking route changes at 60fps+ continuously, burning CPU cycles and battery even when the user was entirely idle.

Fix: The loop has been entirely removed. We now rely on Flarum's native, event-driven page lifecycle hooks (oncreate and onupdate), drastically lowering the extension's resource footprint and improving overall forum fluidity.

🔗 New Feature: Fully Interactive Sidebar Widgets

The desktop sidebar panel is no longer just static text!

Clicking on Tag Labels or Private Discussion Recipient Users will now seamlessly navigate you directly to the respective tag page or user profile.
Built using Flarum's internal SPA Link component with strict event-propagation handling, ensuring snappy, layout-safe transitions without full page refreshes.

🔧 Under the Hood & Code Quality

DRY Refactoring: Merged duplicated scrubber substitution code blocks into a unified, clean helper function.
Dependency Cleanups: Removed dead/unused PHP class imports (SettingsRepositoryInterface) from extend.php and stripped noisy console.log statements from production builds.

📋 Features Recap

For those new to Sticky Title, here's what the extension offers:

Mobile Discussion Titles: Keep discussion titles visible in the mobile header while scrolling.
Desktop Sidebar Panel: Display discussion title, tags, or Byobu recipients in a beautiful sidebar panel.
Scrubber Enhancement: Replace "Original Post" text with the actual discussion title.
Customizable Tag Colors: Choose between background, text, or border color styles.
Blog & Pages Integration: Full out-of-the-box title support for Flarum Blog articles and FoF Pages.

🔧 Installation

composer require huseyinfiliz/sticky-title:"*"

🔄 Update Instructions

composer update huseyinfiliz/sticky-title:"*"
php flarum cache:clear

⚙️ Configuration

All features can be configured through the admin panel under Extensions > Sticky Title:

Mobile scroll direction behavior (Always, Scroll Up, Scroll Down, Never)
Scrubber replacement options
Desktop sidebar title display
Tag color style preferences (Background, Text, or Border)
FoF Pages and Blog header toggles

🔗 Links

GitHub: huseyinfiliz/sticky-title
Packagist: huseyinfiliz/sticky-title

🙏 Feedback & Support

⭐ Don’t forget to star the repository on GitHub if you like the extension!
ℹ If you encounter any bugs or have feature requests, please drop a reply below.

Enjoy the faster, safer update! 🎉

Thanks: @ClaudiusH (Issue #1) Impulsive5

« Previous Page Next Page »