Differences

This shows you the differences between two versions of the page.

--- kb:safari_compatibility [2019/09/21 14:35] – [Additional Details] dstillman
+++ kb:safari_compatibility [2024/04/01 23:24] (current) – [Installation] dstillman
@@ Line 1: / Line 1: @@
-====== Zotero Connector and Safari 13 ======
+====== Zotero Connector and Safari ======
-The Zotero Connector for Safari is currently unavailable for download, and existing installations will stop working if you upgrade to Safari 13 and/or macOS Catalina. Existing installations will continue to work in Safari 12.
+===== Installation =====
-We're currently working on a new version of the Zotero Connector to support Safari users going forward, and we hope to have it available in fall 2019. Follow [[https://twitter.com/zotero|@zotero on Twitter]] for updates.
+The Zotero Connector for Safari is bundled with the Zotero desktop app. (Current versions of Safari don't allow direct installation of browser extensions like other browsers.) After opening Zotero for the first time, you can enable the Zotero Connector from the Extensions pane of the Safari settings ("Safari" menu → "Settings"/"Preferences" → "Extensions").
-In the meantime, we suggest saving via the Zotero Connector for Chrome or Firefox, [[:adding_items_to_zotero#add_item_by_identifier|Add Item by Identifier]] within Zotero itself, or [[/save|zotero.org/save]].
+The Zotero Connector for Safari requires macOS 11 Big Sur or later.
-===== Additional Details =====
+Using an iPhone or iPad? You can save to the [[https://apps.apple.com/us/app/zotero/id1513554812|Zotero iOS app]] using the Share sheet in Safari and other browsers.
-In Safari 13, Apple is discontinuing support for the original type of Safari extension, which affects the Zotero Connector and many other extensions.
+{{:kb:safari-compatibility.png?width=700}}
+===== Can’t see the save button? Save button flickering? =====
-These Safari extensions, which work similarly to extensions for Chrome and Firefox, are being phased out in favor of Safari App Extensions, a much more limited type of extension that must be distributed as part of a Mac app. Legacy Safari extensions will no longer work in Safari 13.
+Due to a macOS bug, you may occasionally find that the extension has disappeared from the Safari toolbar or is quickly appearing and reappearing after a Zotero app update. To restore the extension, delete the Zotero app from Applications and redownload it. (Your Zotero data won't be affected.) It may also be necessary to restart your computer in between deleting the app and redownloading.
-We're working on a Safari App Extension version of the Zotero Connector. Unfortunately, despite their limited functionality, Safari App Extensions require significant development time that isn't required for browsers used by many more users, so we've had to balance it with other development demands.
+We believe this bug is less common in macOS 11 Big Sur and later, so the release version of Zotero includes the Zotero Connector for Safari only for those versions. It's possible to run the Zotero Connector on macOS Mojave (10.14) and Catalina (10.15) by using the [[:beta_builds|Zotero beta]], but you may need to fix the extension more frequently after Zotero app updates and may encounter additional instability, possibly requiring booting into [[https://support.apple.com/guide/mac-help/start-up-your-mac-in-safe-mode-mh21245/mac|Safe Mode]] before performing the above steps.
-For the best Zotero experience, you may wish to use the Zotero Connector for Chrome or Firefox instead. Chrome and Firefox provide powerful extension frameworks that allow us to offer advanced functionality such as automatic proxy detection and automatic RIS/BibTeX import, features that weren't possible in Safari even before Apple further restricted what Safari extensions can do.
+If you have repeated trouble using the Zotero Connector in Safari, you may want to consider switching to a browser with a more stable extension framework, such as Firefox, Chrome, or Edge.
+===== Limitations =====
-Note that Zotero is, to our knowledge, the only tool of its kind that has offered a dedicated extension for Safari instead of a much more limited bookmarklet. While Zotero offers a [[/download/bookmarklet|bookmarklet]] as well, the "Intelligent Tracking Prevention" in the latest versions of Safari can prevent the bookmarklet from working properly as it does in other browsers, so the bookmarklet may not serve as a suitable alternative at this time.
+Due to technical limitations of the Safari extension framework, some features available in Firefox, Chrome, and Edge aren't available in Safari:
-See [[https://forums.zotero.org/discussion/72255/zotero-safari-extension-not-working-with-safari-12/p1|this forum thread]] for further discussion of this issue.
+  * Automatic proxy redirection
+  * Automatic RIS/BibTeX import
+  * Automatic CSL installation
+Other differences:
+  * Gated PDFs may not be saved on some sites (e.g., ScienceDirect)
+  * It's not possible to right-click on the toolbar button to access secondary translators. Instead, right-click on the page itself.
+{{tag>kb basics}}