Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
word_processor_plugin_troubleshooting [2023/12/08 18:36] – [Installation error] dstillmanword_processor_plugin_troubleshooting [2024/03/19 12:47] (current) – Remove instructions for Word 2011 for Mac as it is no longer supported. adomasven
Line 26: Line 26:
   * [[#zotero_tab_does_not_appear_in_the_word_ribbon|Word for Windows]]   * [[#zotero_tab_does_not_appear_in_the_word_ribbon|Word for Windows]]
   * [[#zotero_tab_does_not_appear_in_the_word_2016_ribbon|Word 2016+ for Mac]]   * [[#zotero_tab_does_not_appear_in_the_word_2016_ribbon|Word 2016+ for Mac]]
-  * [[#toolbar_does_not_appear_in_word_2011_or_is_incompatible|Word 2011 for Mac]] 
   * [[#LibreOffice|LibreOffice]]   * [[#LibreOffice|LibreOffice]]
 ===== Fixing broken documents ===== ===== Fixing broken documents =====
Line 58: Line 57:
   - Restart your computer.   - Restart your computer.
   - If you're getting a communication error, go to Tools → Add-ons in Zotero and make sure that Zotero Word for Windows Integration is enabled. [Doesn't apply to Zotero 7]   - If you're getting a communication error, go to Tools → Add-ons in Zotero and make sure that Zotero Word for Windows Integration is enabled. [Doesn't apply to Zotero 7]
-  - Make sure that you're running Zotero as the same user as Word. Specifically, you should [[https://superuser.com/questions/1213101/check-if-an-app-is-running-as-admin|check to make sure neither program is running as administrator]]. For security and stability reasons, you should typically not run any software as administrator.+  - Make sure that you're running Zotero as the same user as Word. Specifically, you should check to make sure neither program is running as administrator (right-click → Properties → Compatibility). For security and stability reasons, you should typically not run any software as administrator.
   - Temporarily disable any security software you're running, which could interfere with the connection between Word and Zotero.   - Temporarily disable any security software you're running, which could interfere with the connection between Word and Zotero.
   - If you've set up Zotero to use [[kb/multiple_profiles|multiple Zotero profiles]] (most people haven't), you might have configured Zotero to launch with the ''-no-remote'' command-line option. This will prevent the plugins from functioning, and if you've done this you should remove the ''-no-remote'' command-line option from the shortcut used to launch the Zotero profile. This flag should never be used with Zotero.   - If you've set up Zotero to use [[kb/multiple_profiles|multiple Zotero profiles]] (most people haven't), you might have configured Zotero to launch with the ''-no-remote'' command-line option. This will prevent the plugins from functioning, and if you've done this you should remove the ''-no-remote'' command-line option from the shortcut used to launch the Zotero profile. This flag should never be used with Zotero.
Line 70: Line 69:
 Other things to try: Other things to try:
  
-** Check if the Zotero plugin is correctly installed **+** Check if the Zotero plugin is correctly installed and enabled **
  
-  - Open the Templates and Add-ins window by going to File → Options → Add-ins, selecting "Word Add-ins" in the Manage drop-down at the bottom, and clicking "Go…"+Go to File → Options → Add-ins and look for Zotero.dotm in the list:
-  - Make sure Zotero.dotm is present and ticked+
  
-** If Zotero.dotm is present and ticked in the Templates and Add-ins window **+  * If Zotero.dotm appears under Inactive Application Add-ins, select "Word Add-ins" in the Manage drop-down at the bottom, click "Go…", and make sure Zotero.dotm is ticked. 
 +  * If Zotero.dotm appears under Disabled Application Add-ins, select "Disabled Items" in the Manage drop-down at the bottom, and click "Go…". In the window that pops up, select Zotero.dotm and click Enable.
  
-  - Go to File → Options -> "Trust Centerand in the right-hand pane click "Trust Center Settings…".+** Check Trust Center ** 
 + 
 +  - Go to File → Options → Trust Center and click "Trust Center Settings…" in the right-hand pane.
   - Under "Add-ins", make sure that "Require Application Add-ins to be signed by Trusted Publisher" and "Disable all Application Add-ins" are **unchecked**.   - Under "Add-ins", make sure that "Require Application Add-ins to be signed by Trusted Publisher" and "Disable all Application Add-ins" are **unchecked**.
   - Restart Word.   - Restart Word.
- +  - If the Zotero tab is still not present, go back into the Trust Center Settings, open the "Macro Settings" pane, and select "Disable all macros with notification". Restart Word and see if you get a notification asking for macro permissions. Click "Enable Content".
-If the Zotero tab is still not present after these steps, go back into the Trust Center Settings, open the "Macro Settings" pane, and select "Disable all macros with notification". Restart Word and see if you get a notification asking for macro permissions.+
  
 If the Zotero tab still isn't showing up and this is an institutional computer, you should contact your IT department, as they may be blocking Word templates from running. If the Zotero tab still isn't showing up and this is an institutional computer, you should contact your IT department, as they may be blocking Word templates from running.
Line 146: Line 146:
  
 Update Word to the latest stable version (15.41 or above). Update Word to the latest stable version (15.41 or above).
- 
-==== Toolbar does not appear in Word 2011 or is incompatible ==== 
- 
-First, make sure you've tried the [[#zotero_toolbar_doesn_t_appear|general troubleshooting steps]]. 
- 
-Next, make sure you are running the last available version of Word 2011, 14.7.7. 
- 
-Finally, check whether "Zotero Bibliographic Management" shows up in the View -> Toolbars menu within Word. If it does but it isn't enabled, enable it. 
- 
  
 ==== “Word could not communicate with Zotero. Please ensure that Zotero is open and try again.” ==== ==== “Word could not communicate with Zotero. Please ensure that Zotero is open and try again.” ====
Line 162: Line 153:
 If Zotero is open and you're still receiving this error, there are two likely causes: If Zotero is open and you're still receiving this error, there are two likely causes:
  
-  - You've upgraded to macOS Sonoma but don't have the latest version of the Zotero plugin in Word. Make sure you're running Zotero 6.0.28 or later or Zotero 7. If you're still getting the error, go to your [[:word_processor_plugin_manual_installation#locating_your_word_startup_folder|Word Startup folder]], delete Zotero.dotm, restart Word, and confirm that Zotero is completely gone from Word. Then follow the steps under [[#Zotero toolbar doesn't appear]].+  - You've upgraded to macOS Sonoma but don't have the latest version of the Zotero plugin in Word. Make sure you're running Zotero 6.0.28 or later or Zotero 7. If you're still getting the error, go to your [[:word_processor_plugin_manual_installation#locating_your_word_startup_folder|Word Startup folder]], delete Zotero.dotm, restart Word, and confirm that the Zotero tab is gone from Word. If it doesn't disappear, follow the instructions for identifying your //active// Word Startup folder, delete Zotero.dotm from there as well, and reset your Word Startup folder location to the default to avoid future problems. Once the Zotero tab is gone from Word, follow the steps under [[#Zotero toolbar doesn't appear]].
   - You previously started Zotero from a disk image instead of dragging it to Applications first, or you have two copies of the Zotero app in different locations on your computer (e.g., a "Zotero" and "Zotero 2" in Applications). Close Zotero, open the [[kb:profile_directory|Zotero profile directory]], and delete extensions.json. Then restart Zotero.   - You previously started Zotero from a disk image instead of dragging it to Applications first, or you have two copies of the Zotero app in different locations on your computer (e.g., a "Zotero" and "Zotero 2" in Applications). Close Zotero, open the [[kb:profile_directory|Zotero profile directory]], and delete extensions.json. Then restart Zotero.
  
Line 173: Line 164:
   - Close Word and go to Tools -> Add-ons -> Extensions in Zotero. Make sure Zotero Word for Mac Integration is listed and enabled. If it is disabled, enable it. If it is missing entirely, see [[#zotero_toolbar_doesn_t_appear|Zotero toolbar doesn't appear]]. After re-enabling/re-installing Zotero Word for Mac Integration, open the Cite -> Word Processors pane of Zotero preferences and click "Reinstall Microsoft Word Add-in" on the "Word Processors" tab. Restart Word and try again.   - Close Word and go to Tools -> Add-ons -> Extensions in Zotero. Make sure Zotero Word for Mac Integration is listed and enabled. If it is disabled, enable it. If it is missing entirely, see [[#zotero_toolbar_doesn_t_appear|Zotero toolbar doesn't appear]]. After re-enabling/re-installing Zotero Word for Mac Integration, open the Cite -> Word Processors pane of Zotero preferences and click "Reinstall Microsoft Word Add-in" on the "Word Processors" tab. Restart Word and try again.
  
-If using Word 2011, make sure you are running the last available version, 14.7.7. If the problem persists with 14.7.7, this may indicate a problem with Visual Basic for Applications. If the above steps do not resolve the issue, follow [[#visual_basic_for_applications_error|these steps for resolving Visual Basic for Applications-related issues]]. 
- 
-==== Visual Basic for Applications error ==== 
- 
-Some Word 2011 users may see the following message upon attempting to insert a citation or bibliography into any Word document using the Script menu: 
- 
-//"Zotero could not perform this action. Please ensure that a document is open. If you have performed a custom installation of Office, you may need to run the installer again, ensuring that "Visual Basic for Applications" is selected."// 
- 
-Attempting to use the Zotero toolbar may result in no response, accompanied by an error message reading "Word could not fire event" when closing the document. 
- 
-This error indicates that Visual Basic for Applications is malfunctioning, which may happen for several reasons: 
- 
-  * Office 2011 may have been installed without Visual Basic for Applications. If you did not select Visual Basic for Applications during installation, or if you're not sure, reinstall Office 2011, making sure to select this option. 
- 
-  * A character with an accent or diacritic may be present in the path to Microsoft Word (e.g., in the name of your hard disk). 
  
-  * The OLE Registration Database may be corrupt. Delete the OLE Registration Database, located in Home/Library/Preferences/Microsoft/Office 2011. Word will regenerate this file the next time it is opened. (On macOS Lion and later, the Library directory is hidden by default, but you can open it by holding down the Option key and selecting it from the Go menu.) 
 ===== Linux ===== ===== Linux =====
  
Line 224: Line 199:
     * If no JRE appears in the list, install the current [[https://www.oracle.com/java/technologies/downloads/|Java JDK]]. (On macOS and Windows, choose the Installer for the easiest installation.)     * If no JRE appears in the list, install the current [[https://www.oracle.com/java/technologies/downloads/|Java JDK]]. (On macOS and Windows, choose the Installer for the easiest installation.)
     * On macOS, install [[https://www.libreoffice.org/download/download/|LibreOffice]] 7.3.4 or later for compatibility with the latest JDK versions.     * On macOS, install [[https://www.libreoffice.org/download/download/|LibreOffice]] 7.3.4 or later for compatibility with the latest JDK versions.
-    * Apple Silicon (M1/M2) Mac users should install LO 7.3+, which adds compatibility with the Apple Silicon version of the JDK. LibreOffice versions 7.2 or earlier require Intel (x64) versions of both LibreOffice and the JDK rather than the Apple Silicon (ARM/aarch64) versions.+    * Apple Silicon (M1/M2) Mac users should install LO 7.3+, which adds compatibility with the Apple Silicon version of the JDK.
  
 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. 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.
word_processor_plugin_troubleshooting.1702078561.txt.gz · Last modified: 2023/12/08 18:36 by dstillman