Download the PHP package wszdb/flarum-homefilter without Composer
On this page you can find all versions of the php package wszdb/flarum-homefilter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
Informations about the package flarum-homefilter
Flarum Home Filter
English | 简体中文
An intelligent Flarum extension for filtering homepage discussions by title or tags, with flexible control over the display quantity of specific types of posts.
✨ Features
🎯 Dual Filtering Modes
- Title Filter Mode: Filter discussions based on keywords in titles
- Tags Filter Mode: Filter discussions based on keywords in tags
🔧 Flexible Configuration
- Customize filter keywords (supports multiple keywords, comma-separated)
- Set display limit for keyword-matched discussions
- Easy mode switching in admin panel
- NEW: Multiple supplement strategies (default/unread random)
- NEW: Flexible sort modes (time descending/random)
🚀 Smart Supplementing
- Automatically supplement non-keyword discussions to maintain homepage count
- Prevents homepage from having insufficient discussions after filtering
- NEW: Respects hidden tags from flarum/tags extension
- NEW: Smart unread-based random supplement with configurable count
🎲 Advanced Features
- Hidden Tags Support: Automatically filters out discussions with hidden tags
- Unread Random Mode: Randomly select from user's recent X unread posts
- Random Sort: Randomize homepage discussion order while keeping sticky posts on top
- Sticky Posts Priority: Sticky posts always appear first regardless of sort mode
- Graceful Fallback: Automatically falls back to default mode when all posts are read
📦 Installation
Install via Composer:
Enable the extension in Flarum admin panel after installation.
⚙️ Configuration
Navigate to Flarum Admin → Extensions → Home Filter to configure:
1. Filter Keywords
Enter keywords to filter, separated by commas.
Example:
2. Filter Mode
Choose filtering method:
- Title Filter: Check if discussion title contains keywords
- Tags Filter: Check if discussion tags contain keywords (requires flarum/tags extension)
3. Keyword Posts Display Limit
Set the maximum number of keyword-matched posts to display on homepage.
- Set to
3: Display maximum 3 keyword-matched posts - Set to
0: Completely hide keyword-matched posts
4. Supplement Strategy (NEW)
Choose how to supplement discussions when homepage needs more posts:
- Default: Supplement with latest posts in time descending order (original behavior)
- Unread Random: Randomly select from user's recent unread posts
- For logged-in users: Only unread posts are selected
- For guests: All posts are considered unread
- Automatically falls back to default mode if no unread posts available
5. Unread Posts Count (NEW)
Set how many recent unread posts to consider for "Unread Random" mode.
- Default:
50posts - Minimum:
20posts - Maximum: Unlimited (but recommend keeping under 100 for performance)
- Only the most recent X unread posts will be randomly selected from
6. Homepage Sort Mode (NEW)
Choose how to sort homepage discussions:
- Time Descending: Latest replied posts appear first (default)
- Random: Randomize post order on each page load
- Note: Sticky posts always appear first regardless of sort mode
💡 Use Cases
Case 1: Limit Advertisement Posts
Effect: Homepage shows maximum 2 posts with "ad", "promotion" or "marketing" in title.
Case 2: Control Specific Categories
Effect: Homepage shows maximum 5 posts tagged with "General" or "Chat".
Case 3: Completely Hide Certain Content
Effect: Completely hide posts with "spam" or "junk" in title.
Case 4: Fresh Content Discovery (NEW)
Effect:
- Show random posts from user's recent 50 unread posts
- Different content on each page refresh
- Great for content discovery and engagement
- Falls back to latest posts if all posts are read
Case 5: Balanced Mix (NEW)
Effect:
- Maximum 2 announcement posts
- Fill remaining slots with random posts from recent 100 unread posts
- Random order for variety (sticky posts still on top)
- Supplements with read posts if unread posts are insufficient
🔍 How It Works
- Filtering: Check homepage discussions, match based on selected mode (title/tags) and keywords
- Limiting: Keep specified number of keyword-matched posts, filter out excess
- Hidden Tags Check: Automatically exclude discussions with hidden tags (if flarum/tags is installed)
- Supplementing: Auto-query and add non-keyword posts based on selected strategy
- Default mode: Latest posts in time order
- Unread Random mode: Random posts from recent X unread posts
- Fallback: If no unread posts, supplement with read posts or fall back to default mode
- Sorting: Apply selected sort mode (time/random) while keeping sticky posts on top
- Precision Control: Ensure final display count matches homepage configuration
📊 Performance
- Title Filter Mode: Performance identical to vanilla Flarum
- Tags Filter Mode: Adds 1-2 database queries, using optimized JOIN queries
- Unread Random Mode: Highly optimized with controlled query limits
- Queries exactly X posts (configurable, default 50)
- Random shuffle in PHP memory (very fast)
- Much faster than previous time-based filtering
- Suitable For: Most forums (daily visits < 50,000)
Performance Improvements
The new "Unread Posts Count" approach is significantly faster than the old "Days Range" approach:
- Old: Database-level random sorting on potentially hundreds of posts (slow)
- New: Fetch limited posts + memory-level shuffle (fast)
- Performance gain: 50-80% faster on medium to large forums
🤝 Contributing
Issues and Pull Requests are welcome!
📄 License
MIT License
🔗 Links
💬 Support
For questions or suggestions, please submit an Issue on GitHub.
This extension was fully developed using AiPy. Invitation code: XOFS.
All versions of flarum-homefilter with dependencies
PHP Build Version
Package Version
Requires
flarum/core Version
^1.8.0
The package wszdb/flarum-homefilter contains the following files
Loading the files please wait ...