Differences

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

--- word_processor_plugin_troubleshooting [2020/02/25 12:18] – [Mac] dstillman
+++ word_processor_plugin_troubleshooting [2020/04/11 18:54] – [Zotero toolbar doesn't appear] dstillman
@@ Line 13: / Line 13: @@
   - Close Word or LibreOffice.
-  - In Zotero, go to Tools → Add-ons.
+  - In the Cite pane of the [[preferences|Zotero preferences]], open the Word Processors tab, click “Install Microsoft Word Add-in” or “Install LibreOffice Add-in”, and then restart your word processor.
-    - Make sure "Zotero Word for Mac", Zotero for Windows Integration", and/or "Zotero LibreOffice Integration" are enabled. If any are not, click the "Enable" button.
+  - If you don't see the installation buttons in the Cite → Word Processors tab in Zotero, go to Tools → Add-ons.
+    - Make sure "Zotero Word for Mac", "Zotero for Windows Integration", and/or "Zotero LibreOffice Integration" are enabled. If any are not, click the "Enable" button.
     - If the "Enable" button is grayed out and you are unable to click it, click the "Remove" button and restart Zotero.
-    - If you don't see the required integration plugin in the Extensions pane at all, then you should [[/download|re-download]] and re-install Zotero. It is not necessary to uninstall Zotero before re-installing; simply install Zotero over the top of the existing installation. (**Note:** Re-installing Zotero rarely fixes problems and should not be used as a general troubleshooting step. This is one of the few instances where re-installation is helpful.)
+    - If you don't see the required integration plugin in Add-ons at all, then you should [[/download|re-download]] and re-install Zotero. It is not necessary to uninstall Zotero before re-installing; simply install Zotero over the top of the existing installation. (**Note:** Re-installing Zotero rarely fixes problems and should not be used as a general troubleshooting step. This is one of the few instances where re-installation is helpful.)
-  - In the Cite pane of the [[preferences|Zotero preferences]], open the "Word Processors" tab, click “Reinstall Microsoft Word Add-in” or “Reinstall LibreOffice Add-in”, and then restart your word processor.
+    - [macOS only] If you still don't see the plugins in Tools → Add-ons and you're on a Mac, it may help to open your [[kb:profile_directory|Zotero profile directory]], delete extensions.json, and restart Zotero. You may need to reinstall other extensions you've installed.
   - If the Zotero tab or toolbar still doesn't appear in your word processor, perform the [[word_processor_plugin_manual_installation|manual installation instructions]].
@@ Line 219: / Line 220: @@
 If installation continues to fail, repeat the same steps, but click the **Manual Installation** button. This will open a folder containing the integration component to be installed within LibreOffice itself. Double-click this component to install it, or select Tools → Extension Manager within LibreOffice, click the Add button, and navigate to the component. While this is unlikely to succeed, it will provide further information about the cause of the installation failure.
-If you receive an error stating “Could not create java implementation loader” when attempting to perform a manual installation, follow the instructions below for the [[#could_not_create_java_implementation_loader|Windows]], [[#could_not_create_java_implementation_loader1|Mac]], or [[#could_not_create_implementation_loader_or_clicking_toolbar_buttons_does_not_have_an_effect|Linux]]. If you receive an error stating “JNI exception occurred” on Linux, follow [[#jni_exception|these instructions]]. For errors not listed below, post the error you receive during manual installation to the [[/forum|Zotero forums]].
+If you receive an error stating “Could not create Java implementation loader” when attempting to perform a manual installation, follow the instructions below for the [[#could_not_create_java_implementation_loader|Windows]], [[#could_not_create_java_implementation_loader1|Mac]], or [[#could_not_create_implementation_loader_or_clicking_toolbar_buttons_does_not_have_an_effect|Linux]].
+If you receive an error stating “JNI exception occurred” on Linux, follow [[#jni_exception|these instructions]].
+For errors not listed below, post the error you receive during manual installation to the [[/forum|Zotero Forums]].
@@ Line 256: / Line 261: @@
 ===== Windows =====
-==== Could not create java implementation loader ====
+==== Could not create Java implementation loader ====
 Upon manual installation of the LibreOffice component, you may see the message
-//"Could not create java implementation loader"//
+//"Could not create Java implementation loader"//
 This error reflects a faulty Java installation within LibreOffice. This issue affects not only Zotero, but any LibreOffice extension that uses Java. Follow the steps below, testing whether manual installation succeeds after each.
@@ Line 271: / Line 276: @@
 ===== Mac =====
-==== Could not create java implementation loader ====
+==== Could not create Java implementation loader ====
 Upon manual installation of the LibreOffice component, you may see the message
-//"Could not create java implementation loader"//
+//"Could not create Java implementation loader"//
 This is usually caused by an outdated version of LibreOffice that does not properly locate the system Java installation. It can be resolved by installing [[http://www.libreoffice.org/download/|LibreOffice 5.2 or later]].