Skip to content
Offerel edited this page May 2, 2024 · 6 revisions

About

With this plugin you can read your Firefox bookmarks within Roundcube. It is not necessary to synchronize the bookmarks via Firefox Sync, because you have direct access to the exported bookmark file.

Installation

  • Extract the downloaded archive into Roundcube’s plugin directory <roundcube>/plugins/ and rename it to ffbookmarks.
  • Copy config.inc.php.dist to config.inc.php
  • Change $config['bookmarks_path'] to the folder where your exported Firefox bookmarks file is saved. You can use %u for the Roundcube username.
  • Change $config['bookmarks_filename'] to the filename of the bookmarks file.
  • Activate the plugin in /config/config.inc.php in the way that you add it to the active plugins array, like $config['plugins'] = array('ffbookmarks');

Issues

For issue reporting, please use the issue tracker at Codeberg.org. I have disabled the issue tracker on GitHub.com

How to report bugs

If the plugin does not work as expected, the error should be reported here as a issue. I will then try to fix the problem. However, I need your help to find the cause of the problem. Important are especially the different log files.

  • Mainly I need the output of the browser's webconsole. In most browsers under Windows, you can access it by pressing the F12 key, please tell me all listed errors and warnings.
  • The output of the Roundcube error log file is also useful. Please attach this to the issue. Remove any confidential text
  • Sometimes the issue depends more at the server configuration. Helpful in these cases are the two logfiles of the webserver: error.log and access.log
  • There is also a separate PHP Logfile. Please attach this file also to the issue

Please also note that I can only give very limited tips and advice on server configuration.

FAQ

Export Firefox Bookmarks

Bookmarks can be exported in Firefox. These exported bookmarks serve as the basis for this plugin. The help page from Mozilla will show you how to export your bookmarks. All you have todo now is, to save this bookmark file somewhere on your server, where Roundcube can access this file. As an alternative, you can use my new DAVMarks Firefox AddOn and configure the plugin for the Addon.

Automatischer Bookmark Export

A little less well known is that Firefox Bookmarks can also export automatically. How often you can configure this via the advanced settings in Firefox. Enter about:config in the address line of Firefox and confirm with Enter.

In the filter line please enter "bookmarks" as search word to narrow down the entries. Important are now 2 entries, which have to be changed. The entry browser.bookmarks.autoExportHTML must be changed to true. This means that the bookmarks are automatically exported each time Firefox is closed. With the setting browser.bookmarks.file you determine where this file is saved and what the file should be called. For example, if you specify a UNC path here (for example,\\192.168.130.1\rcfiles\bookmarks.html), which is also readable by Roundcube, the bookmark file is automatically kept up to date. Alternatively you can synchronize the exported bookmarkfile with additional programs.

Automatischer Bookmark Import

If you set the following parameter in Firefox, the bookmarkfile will be automatically import by every Firefox start. This works also, when a file places.sqlite exists. But be warned: All existing bookmarks in places.sqlite are replaced by the import file and are lost. Additionally, i do not recommend to use Firefox Sync Account in parallel. This will lead to duplicated bookmarks. With every import new ID's for the bookmarks are generated, which are not identical with the previous ones. The internal check check during a FF Accounts sync will not work in this case. Please use the import only, when you have read and understand my warning. Do let the magic happen, place a file user.js in your profile folder. Here you can define some Firefox settings. Please add at least the setting user_pref("browser.bookmarks.restore_default_bookmarks", false); and on a new line user_pref("browser.places.importBookmarksHTML", true); in this file. After the import, the setting user_pref("browser.places.importBookmarksHTML", true); is set to false, but only in prefs.js. Since user.js is higher in the rating, this setting is overwritten, every time the browser is started.

DAVMarks

Since version 2.0.0 this plugins supports bookmarks saved with my new DAVMarks AddOn. Change $config['bookmarks_path'] to the WebDAV foldername from your WebDAV share and $config['bookmarks_filename'] to "bookmarks.json". For the username and password, the Roundcube credentials are automatically used.