Download the PHP package fof/bookmarks without Composer
On this page you can find all versions of the php package fof/bookmarks. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download fof/bookmarks
More information about fof/bookmarks
Files in fof/bookmarks
Package bookmarks
Short Description Allow users to bookmark their favourite discussions and posts
License MIT
Homepage https://friendsofflarum.org
FAQ
Example:
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 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.
Informations about the package bookmarks
FriendsOfFlarum Bookmarks
A Flarum extension that lets users bookmark discussions and posts, and find them again from a single bookmarks page.
What it does
Bookmarks are private to each user, and work rather like subscriptions but without any notifications attached.
Discussions
- A bookmark control on every discussion, either in the discussion sidebar or in its dropdown menu.
- A Bookmarked badge on bookmarked discussions in the discussion list.
- An
is:bookmarkedsearch gambit, so bookmarks can be combined with any other search —is:bookmarked tag:support, for instance.
Posts
- A bookmark control on every comment, positioned above the post, below it with the quick actions, or in the post's menu.
- An optional Bookmarked label above bookmarked posts, for when the control is not in the post header.
The bookmarks page
A single /bookmarks page with a tab for each type. Bookmarked discussions reuse Flarum's own discussion list, so sorting and filtering behave exactly as they do on the index; bookmarked posts are listed newest first, each linked back to the discussion it belongs to.
Deep links work, so /bookmarks?tab=posts opens the posts tab directly.
fof/blog
When fof/blog is installed, article pages get a bookmark control too. Blog articles are discussions, so they appear under the discussions tab alongside everything else.
Requirements
- Flarum 2.0 or higher
Installation
Updating
Migrating from the ClarkWinkelmann extensions
This extension replaces three packages, and existing bookmarks are preserved when you switch:
| Replaced package | What it stored |
|---|---|
clarkwinkelmann/flarum-ext-bookmarks |
discussion bookmarks (v1 of the below) |
clarkwinkelmann/flarum-ext-discussion-bookmarks |
discussion bookmarks |
clarkwinkelmann/flarum-ext-post-bookmarks |
post bookmarks |
Install as normal:
Composer removes the old packages automatically, because this one replaces them. Enable FoF Bookmarks in the admin panel afterwards.
Both storage locations are kept exactly as they were — discussion_user.bookmarked_at and the post_user_bookmark table — so the migrations detect existing data and leave it untouched. Nothing is copied or moved, and no bookmark is lost.
Two things do not carry over:
- Settings. The old extensions used their own setting keys, so reconfigure the three settings below after enabling.
- URLs. The old
/bookmarked-discussionsand/bookmarked-postspages are replaced by/bookmarks. No redirects are provided.
If you have custom CSS targeting the old extensions, note that class names have changed.
Uninstalling
Disabling or uninstalling deliberately leaves your bookmark data in place, since discussion_user.bookmarked_at may hold data created by an extension that predates this one.
If you genuinely want the data gone, remove it by hand:
All three statements matter. Flarum records which migrations have run, and because this extension's down handlers intentionally do nothing, those records survive an uninstall. Leaving them behind means a later reinstall considers the migrations already applied and never recreates the table or column, so the extension breaks on enable. Deleting the rows — all of them, whatever the current set happens to be — lets the migrations run again from scratch.
This is destructive and irreversible — take a database backup first.
Settings
| Setting | Default | Description |
|---|---|---|
| Show the discussion bookmark control in the sidebar | On | When off, the control moves to the discussion dropdown menu. |
| Post bookmark button position | Above post (header) | Also available below the post with the quick actions, or in the post menu. |
| Label bookmarked posts | Off | Shows a label above bookmarked posts. Only applies when the button is not in the header. |
Credits
This extension combines and continues two extensions by Clark Winkelmann — flarum-ext-discussion-bookmarks and flarum-ext-post-bookmarks — both of which were released as open source and are no longer maintained. FriendsOfFlarum is grateful for that work, on which this extension is based.
Links
An extension by FriendsOfFlarum.
License
This extension is licensed under the MIT License. See the LICENSE.md file for details.
