Differences

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

--- word_processor_plugin_troubleshooting [2020/01/25 19:04] – [Zotero toolbar doesn't appear] dstillman
+++ word_processor_plugin_troubleshooting [2020/02/25 12:18] – [Mac] dstillman
@@ Line 13: / Line 13: @@
   - Close Word or LibreOffice.
-  - In Zotero, go to Tools → Add-ons → Extensions.
+  - 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.)
   - 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.
+  - If the Zotero tab or toolbar still doesn't appear in your word processor, perform the [[word_processor_plugin_manual_installation|manual installation instructions]].
-If you are still experiencing issues, follow these software specific troubleshooting steps:
+If you still don't see the plugin after performing a manual installation, follow these OS-specific troubleshooting steps:
   * [[#zotero_tab_does_not_appear_in_the_word_ribbon|Word for Windows]]
@@ Line 61: / Line 62: @@
 ==== Zotero tab does not appear in the Word Ribbon ====
-If you are using Microsoft Office Starter Edition, Zotero Word integration is not supported.
+First, make sure you've tried the [[#zotero_toolbar_doesn_t_appear|general troubleshooting steps]].
-** Check if Zotero plugin is correctly installed **
+If you're using Microsoft Office Starter Edition, note that Zotero Word integration is not supported.
+Other things to try:
+** Check if the Zotero plugin is correctly installed **
   - Open Word Options
@@ Line 79: / Line 84: @@
 If the Zotero tab is still not present after these steps, go back into the Trust Centre Settings and pick "Disable all macros with notification" under "Macro Settings". Restart Word and see if you get a notification asking for macro permissions.
-** If Zotero.dotm is not present under Developer → Word Add-ins **
-  - In Zotero, go to Tools → Add-ons and make sure that Zotero Word for Windows Integration is enabled. If it is disabled, enable it and restart Word.
-    - If Zotero Word for Windows Integration is missing entirely from the Add-ons window, see [[#zotero_toolbar_doesn_t_appear|Zotero toolbar doesn't appear]].
-  - In Zotero, go to Edit → Preferences → Cite → Word Processors and click "Install Word for Windows Add-in". Restart Word.
-If the Zotero tab is still not present in Word, check whether it is available under Developer → Word Add-ins and, if so, follow the section above. If it still does not show up in Developer → Word Add-ins, you should attempt a [[/support/word_processor_plugin_manual_installation|manual installation]]
 ==== Word 2010: "Could not find a running Word instance" ====
@@ Line 122: / Line 119: @@
 ==== Tab does not appear in Word 2016/2019 ====
-First, check your [[https://support.office.com/en-us/article/about-office-what-version-of-office-am-i-using-932788b8-a3ce-44bf-bb09-e334518b8b19|specific Word version number]] and follow the appropriate steps below:
+First, make sure you've tried the [[#zotero_toolbar_doesn_t_appear|general troubleshooting steps]].
-=== Version < 15.41 ===
+If you're still having trouble, check your [[https://support.office.com/en-us/article/about-office-what-version-of-office-am-i-using-932788b8-a3ce-44bf-bb09-e334518b8b19|specific Word version number]] and follow the appropriate steps below:
-Begin by updating Word to the latest stable version (15.41 or above). If the tab still doesn't appear, follow the steps for Word version 15.41 and higher below.
 === Version 15.41 and higher ===
-First, upgrade to the latest stable version of Word (you can download the installer for the latest version of Word from [[https://support.office.com/en-us/article/update-history-for-office-2016-for-mac-700cab62-0d67-4f23-947b-3686cb1a8eb7|here]]).
+Make sure you're running the latest stable version of Word.
 If the tab still does not appear, check whether the plugin was installed in Word correctly:
@@ Line 140: / Line 135: @@
   - Make sure that "Zotero.dotm" is present under Global Templates and Add-ins" and is checked.
-If the "Zotero.dotm" entry isn't present in the dialog, try reinstalling the Word plugin from Zotero. In Zotero, go to the Cite -> Word Processors pane of the Zotero preferences, click the "Reinstall Word Components" button, and then restart Word.
+=== Version < 15.41 ===
-If the entry is still not present, follow the [[/support/windows_word_plugin_manual_installation_instructions#word_for_mac_2016|manual installation instructions]].
+Update Word to the latest stable version (15.41 or above). If the tab still doesn't appear, follow the steps above for Word version 15.41 and higher.
-==== Toolbar does not appear in Word 2011 or is incompatible ====
-First, check whether "Zotero Bibliographic Management" shows up in the View -> Toolbars menu within Word. If it does but it isn't enabled, enable it.
+==== Toolbar does not appear in Word 2011 or is incompatible ====
-If the Zotero option doesn't show up in that menu, try reinstalling the Word plugin from Zotero. In Zotero, go to the Cite -> Word Processors pane of the Zotero preferences, click the "Reinstall Microsoft Word Add-in" button, and then restart Word. If you get an error, report it in the Zotero Forums with a [[:reporting_problems#provide_a_report_id|Report ID]].
-**If you have a non-English version of Office**, you may need to move the Zotero.dot file into the "Word" directory within the equivalent of "Startup" in your language and restart Word. The correct path should be listed in Tools -> Templates and Add-ins in Word.
+First, make sure you've tried the [[#zotero_toolbar_doesn_t_appear|general troubleshooting steps]].
-**If you're using a non-admin macOS user account**, you will need to install the Word plugin from an administrative account or grant write access for the startup directory to the non-admin account to allow it to install Zotero.dot.
+Then check whether "Zotero Bibliographic Management" shows up in the View -> Toolbars menu within Word. If it does but it isn't enabled, enable it.
 ==== Scripts do not appear in Word 2008/2011 or are incompatible ====
-After installing the [[word_processor_plugin_installation|latest Word plugin for Zotero]] on a system with a non-English version of Office 2008/2011 for Mac installed, the [[kb:no_toolbar_in_word_2008_plugin|plugin scripts]] may not appear in Word. Alternatively, after upgrading the plugin, you may receive a message saying that the plugin is incompatible with the installed version of Zotero.
+On a system with a non-English version of Office 2008/2011 for Mac, the [[kb:no_toolbar_in_word_2008_plugin|plugin scripts]] may not appear in Word automatically. Alternatively, after upgrading the plugin, you may receive a message saying that the plugin is incompatible with the installed version of Zotero.
 These problems indicate that the new scripts were not installed into the correct location. By default, Zotero installs the scripts into ~/Library/Application Support/Microsoft/Office/Word Script Menu Items or ~/Documents/Microsoft User Data/Office/Word Script Menu Items if either of these folders exist, or asks where to install them if it does not. Since non-English versions of Office prior to Office 2011 SP2 do not use the Microsoft User Data folder, but rather a folder with an equivalent name in the Office language, this can be problematic for non-English Office users. There are three potential solutions:
-  - If you have Office 2011, install the [[http://www.microsoft.com/mac/downloads|latest available updates]]. You can then reinstall the Word scripts from Zotero. In Zotero, go to the Cite -> Word Processors pane of Zotero preferences, click the "Reinstall Microsoft Word Add-in" button, and then restart Word. If you don't see the option to reinstall the Word Add-in, open Tools -> Add-ins and ensure that Zotero Word for Mac Integration is present and enabled. If it is missing, see [[#zotero_toolbar_doesn_t_appear|Zotero toolbar doesn't appear]].
+  - If you have Office 2011, install the [[http://www.microsoft.com/mac/downloads|latest available updates]]. You can then reinstall the Word scripts from Zotero. In Zotero, go to the Cite -> Word Processors pane of Zotero preferences, click the "Reinstall Microsoft Word Add-in" button, and then restart Word. If you don't see the option to reinstall the Word Add-in, open Tools -> Add-ons and ensure that Zotero Word for Mac Integration is present and enabled. If it is missing, see [[#zotero_toolbar_doesn_t_appear|Zotero toolbar doesn't appear]].
-  - If you have only non-English versions of Office installed, you can delete the Microsoft User Data folder if it contains nothing other than the Zotero scripts. You can then re-install the Zotero scripts by going to Tools -> Add-ons -> Extensions, clicking the "Preferences" button next to Zotero Word for Mac Integration, and clicking the "Reinstall Microsot Word Add-in" button.
+  - If you have only non-English versions of Office installed, you can delete the Microsoft User Data folder if it contains nothing other than the Zotero scripts. You can then re-install the Zotero scripts by going to the Cite → Word Processors pane of the Zotero preferences and clicking the "Reinstall Microsoft Word Add-in" button.
   - If you have both English and non-English versions of Office installed, you should copy the Zotero folder from ~/Documents/Microsoft User Data/Word Script Menu Items to the equivalent folder for your non-English version of Office. You can find the correct directory by selecting "About This Menu..." (or non-English equivalent) from the script menu and clicking "Open Folder".
@@ Line 221: / Line 213: @@
   * Open the LibreOffice options dialog by choosing Tools → Options (Windows/Linux) or LibreOffice → Preferences… (Mac). In the dialog, click LibreOffice → Java (or Advanced). Ensure that "Use a Java runtime environment" is checked, and that a JRE is selected in the list below. (It may take a few seconds to load.) If no JRE appears in the list, [[http://www.oracle.com/technetwork/java/javase/downloads/index.html|install a Java JRE]]. Make sure that LibreOffice and JRE platforms (32-bit/64-bit) match.
-Next, restart the installation process, by restarting Zotero. In Zotero select Tools -> Add-ons. The page should display the **Zotero LibreOffice Integration** extension. Click the preferences button for this extension which will display the Cite pane of Zotero preferences. Click the **Install LibreOffice Add-in** button on the "Word Processors" tab.
+Next, restart Zotero, open the Cite pane of the [[preferences|Zotero preferences]], and click the **Install LibreOffice Add-in** button on the "Word Processors" tab.
 When you are asked to locate your LibreOffice installations, ensure that your LibreOffice installation is listed. (You can add new LibreOffice installations by clicking the "Add Directory…" button below.)