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 [2019/06/09 09:25] – [Zotero toolbar doesn't appear] 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 10: Line 10:
 ===== Zotero toolbar doesn't appear ===== ===== Zotero toolbar doesn't appear =====
  
-If the Zotero tab or toolbar (or [[kb:no_toolbar_in_word_2008_plugin|Zotero scripts menu]] for Word 2008/2011 for Mac) does not appear, follow these steps:+In most cases, the Zotero plugin should appear automatically in the Word ribbon or the LibreOffice toolbar after installing Zotero and restarting the word processor. If you don't see a Zotero tab or toolbar, follow these steps:
  
   - Close Word or LibreOffice.   - Close Word or LibreOffice.
-  - In Zotero, go to Tools → Add-ons → Extensions.  +  - 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 pane, you'll need to repair your Zotero installation: 
-    - If the "Enable" button is grayed out and you are unable to click it, click the "Remove" button and restart Zotero.  +      - Go to Tools → Add-ons in 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.) +      - 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. 
-  In the [[/preferences/cite|Cite pane]] of Zotero preferences, open the "Word Processors" tab+      - If the "Enable" button is grayed out and you are unable to click it, click the "Remove" button and restart Zotero.  
-  - Click “Reinstall LibreOffice/Microsoft Word Add-in” and then restart your word processor.+      - If you don't see the integration plugins 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.) 
 +      If you still don't see the installation buttons in the Cite → Word Processors pane of the Zotero preferences, it may help to open your [[kb:profile_directory|Zotero profile directory]], delete extensions.json, and restart Zotero. If you've installed any third-party plugins, you may need to reinstall them
 +  - If the Zotero tab or toolbar still doesn't appear in your word processor after clicking the install button in the Zotero preferences and restarting your word processor, follow 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:
  
-  * [[#windows|Word for Windows]] +  * [[#zotero_tab_does_not_appear_in_the_word_ribbon|Word for Windows]] 
-  * [[#tab_does_not_appear_in_word_2016|Word 2016 for Mac]] +  * [[#zotero_tab_does_not_appear_in_the_word_2016_ribbon|Word 2016for Mac]]
-  * [[#toolbar_does_not_appear_in_word_2011_or_is_incompatible|Word 2011 for Mac]] +
-  * [[#scripts_do_not_appear_in_word_20082011_or_are_incompatible|Word 2008/2011 for Mac]]+
   * [[#LibreOffice|LibreOffice]]   * [[#LibreOffice|LibreOffice]]
-===== Debugging broken documents =====+===== Fixing broken documents =====
  
-See [[https://www.zotero.org/support/kb/debugging_broken_documents|Troubleshooting errors in word processor documents]].+If you can insert a Zotero citation in a new, empty document but get an error in an existing document, see [[kb:debugging_broken_documents|Troubleshooting Errors in Word Processor Documents]].
 ===== Field codes instead of citation/bibiliography text ===== ===== Field codes instead of citation/bibiliography text =====
  
Line 35: Line 35:
 ===== Citations/bibliography highlighted ===== ===== Citations/bibliography highlighted =====
  
-Word and LibreOffice will highlight Fields/Reference Marks on your screen to indicate that the text is automatically generated. This can help you avoid accidentally manually typing in the fields (to edit the text shown in a Zotero citation, see [[/support/word_processor_plugin_usage#customizing_cites|Customizing Cites]]). These highlights are only shown on screen and won't appear if you print or save the document as a PDF.  +See [[kb/citations_highlighted|Citations Highlighted]].
- +
-You can change the settings for highlighting Fields/Reference Marks in your word processor: +
-  * **[[https://helpdeskgeek.com/office-tips/show-field-shading-in-word-and-convert-the-fields-to-plain-text/|Word for Windows]]:** In Word Options, open "Advanced", then set "Field shading" to "Never", "Always", or "When selected"+
-  * **Word for Mac:** Open Word -> Preferences -> View and set "Field shading" to "Never", "Always", or "When selected"+
-  * **[[https://help.libreoffice.org/Writer/About_Fields|LibreOffice]]:** Open Tools -> Options -> LibreOffice -> Application Colors and check/uncheck the "Field shadings" box. You can also control the color used for field shadings. +
- +
-See also [[kb/citations_highlighted|Citations Highlighted]].+
  
 ===== Citations converted to plain text ===== ===== Citations converted to plain text =====
  
-If you have previously inserted citations into Word or LibreOffice using Zotero, but they have now been converted to plain text, this may be caused by one of several factors. +See [[kb/existing_citations_not_detected|Existing Citations Not Detected]].
- +
-  - You used the "Unlink Citations" button. This button will disconnect your document from Zotero and convert all citations and bibliographies to plain text. +
-  - You saved the document in an unsupported file type. For Word, your document must be saved as .docx or .doc. For LibreOffice, if you are storing citations as Reference Marks (the default), your document must be saved as .odt. For LibreOffice, if you are storing citations as Bookmarks (see below), your document must be saved as .docx or .doc. +
-  - You opened and saved your document using a word processor program that does not support Fields/Reference Marks/Bookmarks. These include: +
-    - **Google Docs and other online word processors:** Google Docs and most other online word processors do not support Fields/Reference Marks/Bookmarks. Opening a document in these programs will break connections with Zotero. Microsoft's Word Online does support Fields and so can be used safely with Word documents containing Zotero fields. +
-    - **Pages:** Apple Pages does not support Fields/Reference Marks/Bookmarks. Opening a document in Pages will break connections with Zotero. +
-    - **Word:** If you open an .odt file (created by LibreOffice) in Word, Zotero references stored as Reference Marks (the default) will be broken. To share a document between Word and LibreOffice users, change the "Store Citations as:" option in the Zotero Document Preferences to Bookmarks. (Bookmarks can cause errors if accidentally modified, so they should only be used if compatibility between Word and LibreOffice is necessary.) +
-    - **LibreOffice:** If you open a .docs or .doc file (created by Word) in LibreOffice, Zotero references stored as Fields (the default) will be broken. To share a document between Word and LibreOffice users, change the "Store Citations as:" option in the Zotero Document Preferences to Bookmarks. (Bookmarks can cause errors if accidentally modified, so they should only be used if compatibility between Word and LibreOffice is necessary.) +
- +
-If your document's citations have been converted to plain text, your only option for restoring the links to Zotero is to open and restore a previous version of the document with the citation links intact. If this is not possible, you will need to re-insert the citations from Zotero. +
- +
-See also [[kb/citations_converted_to_plain_text|Citations Converted to Plain Text]].+
  
 ====== Word ====== ====== Word ======
Line 64: Line 45:
 ===== Windows ===== ===== Windows =====
  
-==== Communication error or non-responsive plugin buttons====+==== Error or non-responsive plugin buttons==== 
 + 
 +If you see one of the following errors in a **new, empty document** (and not just a [[kb:debugging_broken_documents|specific existing document]]):
  
-If you see one of the following errors:+  * //"Zotero experienced an error updating your document."// 
 +  * //"Word could not communicate with Zotero. Please ensure Zotero is running and try again.”// 
 +  * //"Could not find a running Word instance"//
  
-//"Word could not communicate with Zotero. Please ensure Zotero is running and try again.”//+or if no insert citation window appears when you click the plugin buttons, try the following steps:
  
-//"Could not find a running Word instance"//+  - Restart your computer. 
 +  - If you're getting 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 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. 
 +  - 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 the plugins still aren't working, go to your [[word_processor_plugin_manual_installation#locating_your_word_startup_folder|Word Startup folder]], delete Zotero.dotm, and restart Word to make sure that the plugin is completely gone from Word. Then [[#zotero_toolbar_doesn_t_appear|reinstall the plugin]]. 
 +==== Zotero tab does not appear in the Word ribbon ====
  
-or the plugin appears and buttons are clickable, but no insert citation window appearstry the following steps:+Firstmake sure you've tried the [[#zotero_toolbar_doesn_t_appear|general troubleshooting steps]].
  
-  - Ensure that Zotero Word for Windows Integration is enabled in Tools -> Add-ons-> Extensions in Zotero. +If you're using Microsoft Office Starter Edition, note that Zotero Word integration is not supported.
-  - Make sure that you're running Zotero as the same user as Word. The plugin may fail, for example, if Zotero is run as administrator and Word as a regular user. For security and stability reasons you should typically not run any software as administrator. +
-  - Try temporarily disabling any security software you're running, which could interfere with the connection between Word and Zotero. +
-  - Windows plugins communicate with Zotero using the remote window. Thus, launching Zotero with the -no-remote command-line option will prevent the plugins from functioning. (You might do this accidentally if you have [[kb/multiple_profiles|multiple Zotero profiles]].) The solution is to remove the -no-remote command-line option from the shortcut used to launch the Zotero profile (this flag should never be used with Zotero).+
  
-==== Zotero tab does not appear in the Word Ribbon ====+Other things to try:
  
-If you are using Microsoft Office Starter Edition, Zotero Word integration is not supported.+** Check if the Zotero plugin is correctly installed and enabled **
  
-** Check if Zotero plugin is correctly installed **+Go to File → Options → Add-ins and look for Zotero.dotm in the list:
  
-  - Open Word Options +  * If Zotero.dotm appears under Inactive Application Add-ins, select "Word Add-insin the Manage drop-down at the bottom, click "Go…", and make sure Zotero.dotm is ticked. 
-  Choose "Customize Ribbon" +  * 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.
-  On the right pane tick the "Developertab +
-  - Close the options and in the new Developer tab click "Word Add-ins" +
-  - Make sure Zotero.dotm is present and ticked+
  
-** If Zotero.dotm is present and ticked under Word Add-ins **+** Check Trust Center **
  
-  - Open Word Options +  - Go to File → Options → Trust Center and click "Trust Center Settings…" in the right-hand pane. 
-  - Choose "Trust Centreand in the pane click "Trust Centre Settings..." +  - 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 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 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 Zotero.dotm is not present under Word Add-ins **+==== Zotero tab has an empty label ====
  
-  - Go into Zotero -> Tools -> Add-ons and make sure that Zotero Word for Windows Integration is enabled. If it is disabledenable it and restart Word+If after installing the plugin the Zotero tab has an empty label, it means Word Macro settings are preventing the Zotero plugin from running.
-    - 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]]. +
-  - Go into Zotero Preferences -> Cite -> Word Processors and click "Install Word for Windows Add-in". Restart Word.+
  
-If Zotero tab is not present in Word, check whether it is available under Word Add-ins and if so, follow the section above. If it still does not show up in Word Add-ins, you should attempt a [[/support/word_processor_plugin_manual_installation|manual installation]]+  - In Word, go File → Options. 
 +  Select the Trust Center panel and click the "Trust Center Settings…" button 
 +  Select the Trusted Locations panel and make sure that the Word default location startup is in this list.
  
 +You can find your Word Startup location in Word Options → Advanced, by clicking the "File Locations…" button at the bottom of the panel.
 ==== Word 2010: "Could not find a running Word instance" ==== ==== Word 2010: "Could not find a running Word instance" ====
  
Line 140: Line 126:
 ===== Mac ===== ===== Mac =====
  
-==== Tab does not appear in Word 2016 ====+==== Zotero tab does not appear in the Word 2016+ ribbon ====
  
-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 === === 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: If the tab still does not appear, check whether the plugin was installed in Word correctly:
  
-  - Open Word Preferences. +  - Go to Tools → Templates and Add-ins. 
-  - Click View. +  - Make sure that "Zotero.dotm" is present under Global Templates and Add-ins and is checked.
-  - Check "Show developer tab" and close the preferences dialog. +
-  - In the new Developer tab click "Word Add-ins"+
-  - Make sure that "Zotero.dotm" is present under Global Templates and Add-insand is checked.+
  
-If the "Zotero.dotm" entry isn'present in the dialogtry 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.+If Zotero.dotm still doesn'show upyou may not have correctly performed the [[word_processor_plugin_manual_installation|manual installation steps]] to copy Zotero.dotm to your current Word Startup folder.
  
-If the entry is still not present, follow the [[/support/windows_word_plugin_manual_installation_instructions#word_for_mac_2016|manual installation instructions]].+=== Version <15.41 ===
  
-==== Toolbar does not appear in Word 2011 or is incompatible ====+Update Word to the latest stable version (15.41 or above).
  
-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.+==== “Word could not communicate with ZoteroPlease ensure that Zotero is open and try again.” ====
  
-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]].+First, make sure the Zotero app is open and running on your computer. Note that this is the Zotero programnot the Zotero website or Zotero Connector in your browser.
  
-**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.+If Zotero is open and you're still receiving this errorthere are two likely causes:
  
-**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. +  - 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 errorgo to your [[:word_processor_plugin_manual_installation#locating_your_word_startup_folder|Word Startup folder]], delete Zotero.dotmrestart Word, and confirm that the Zotero tab is gone from Word. If it doesn'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 problemsOnce the Zotero tab is gone from Wordfollow 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., "Zotero" and "Zotero 2" in Applications)Close Zoteroopen the [[kb:profile_directory|Zotero profile directory]], and delete extensions.jsonThen restart Zotero.
-==== 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.  +
- +
-These problems indicate that the new scripts were not installed into the correct locationBy 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 notSince 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 2011install the [[http://www.microsoft.com/mac/downloads|latest available updates]]. You can then reinstall the Word scripts from Zotero. In Zoterogo to the Cite -> Word Processors pane of Zotero preferencesclick the "Reinstall Microsoft Word Add-in" button, and then restart Word. If you don'see the option to reinstall the Word Add-inopen Tools -> Add-ins and ensure that Zotero Word for Mac Integration is present and enabledIf it is missingsee [[#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 scriptsYou can then re-install the Zotero scripts by going to Tools -> Add-ons -> Extensionsclicking the "Preferencesbutton next to Zotero Word for Mac Integration, and clicking the "Reinstall Microsot Word Add-in" button. +
-  - If you have both English and non-English versions of Office installedyou 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".+
  
 +If you continue to receive the error, you may have modified your Zotero installation to work with [[kb:multiple_instances|multiple instances]], in which case you need to do additional [[kb:multiple_instances#word|configuration for the Word for Mac Zotero plugin]].
 ==== No response from plugin ==== ==== No response from plugin ====
  
Line 191: 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.
  
-In Word 2011, this can also indicate an issue 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 239: Line 196:
  
   * Check that LibreOffice is up to date, as new Java releases sometimes introduce incompatibilities with LibreOffice.   * Check that LibreOffice is up to date, as new Java releases sometimes introduce incompatibilities with LibreOffice.
-  * 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 checkedand 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 Java JRE]].+  * Open the LibreOffice preferences by going to Tools → Options (Windows/Linux) or LibreOffice → Preferences… (Mac). In the dialog, click LibreOffice → Advanced. Ensure that "Use a Java runtime environment" is checked and that a JRE is selected in the list below. 
 +    * 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. 
 +    * Apple Silicon (M1/M2) Mac users should install LO 7.3+, which adds compatibility with the Apple Silicon version of the JDK.
  
-Next, restart the installation processby 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 Zoteroopen 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.) 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.)
Line 247: Line 207:
 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 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 believe your Java configuration is correct and you're still getting an error for a manual installation attempt, you can try deleting some or all of your [[https://wiki.documentfoundation.org/UserProfile#Default_locations|LibreOffice profile folder]], which can fix problems installing LibreOffice extensions. 
 + 
 +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 253: Line 219:
  
 Check if there's an entry for Zotero under View -> Toolbars. If not, look for the Zotero LibreOffice Integration plugin in Tools -> Extension Manager. If it's in not there, return to Zotero and the Cite pane of Zotero preferences. On the "Word Processors" tab, click the "Install LibreOffice Add-in" button. If you get an error, refer to [[#installation_error|installation troubleshooting instructions]]. Check if there's an entry for Zotero under View -> Toolbars. If not, look for the Zotero LibreOffice Integration plugin in Tools -> Extension Manager. If it's in not there, return to Zotero and the Cite pane of Zotero preferences. On the "Word Processors" tab, click the "Install LibreOffice Add-in" button. If you get an error, refer to [[#installation_error|installation troubleshooting instructions]].
 +
 +==== Buttons are unresponsive after updating LibreOffice ====
 +
 +Unresponsive Zotero toolbar buttons are an indication of LibreOffice not having access to a working Java JRE. Refer to the [[word_processor_plugin_troubleshooting#installation_error|Installation Error]] section.
  
 ==== NullPointerException or lastDataListener is undefined error ==== ==== NullPointerException or lastDataListener is undefined error ====
Line 277: Line 247:
  
 We believe this is caused by a corrupt LibreOffice profile directory. Move or delete the [[https://wiki.documentfoundation.org/UserProfile|LibreOffice profile directory]], then follow the [[#zotero_toolbar_doesn_t_appear|instructions above]] to reinstall the Zotero LibreOffice extension. (This will revert any LibreOffice settings you have customized to their default state.) We believe this is caused by a corrupt LibreOffice profile directory. Move or delete the [[https://wiki.documentfoundation.org/UserProfile|LibreOffice profile directory]], then follow the [[#zotero_toolbar_doesn_t_appear|instructions above]] to reinstall the Zotero LibreOffice extension. (This will revert any LibreOffice settings you have customized to their default state.)
- 
-==== Buttons are unresponsive after updating LibreOffice ==== 
- 
-After LibreOffice update unresponsive Zotero toolbar buttons are an indication of LibreOffice not having access to a working JRE setup. Refer to the [[word_processor_plugin_troubleshooting#installation_error|Installation error]] section. 
  
 ===== Windows ===== ===== 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 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. 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 295: Line 261:
   * Make sure that Java is installed and enabled in LibreOffice. Choose Tools → Options → LibreOffice → Java (or Advanced). Ensure that "Use a Java runtime environment" is checked, and that a JRE appears in the list below. (It may take a few seconds to load.)   * Make sure that Java is installed and enabled in LibreOffice. Choose Tools → Options → LibreOffice → Java (or Advanced). Ensure that "Use a Java runtime environment" is checked, and that a JRE appears in the list below. (It may take a few seconds to load.)
   * Remove the Zotero LibreOffice Integration component from Tools → Extension Manager and uninstall and reinstall LibreOffice.   * Remove the Zotero LibreOffice Integration component from Tools → Extension Manager and uninstall and reinstall LibreOffice.
-  * If you have recently upgraded from Java 6 to Java 7, you may need to follow [[https://bugs.freedesktop.org/show_bug.cgi?id=50371#c15|these instructions]] to fix your Java installation. Oracle's Java installer does not completely remove older versions of Java, and this can confuse LibreOffice.+  * You may need to follow [[https://bugs.freedesktop.org/show_bug.cgi?id=50371#c15|these instructions]] to fix your Java installation. Previous versions of Oracle's Java installer did not completely remove older versions of Java, and this can confuse LibreOffice.
  
 ===== Mac ===== ===== 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 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]]. +
- +
-==== LibreOffice 5 on macOS 10.11+: No response from plugin ==== +
- +
-Problem: LibreOffice 5 does not currently recognize the Java Runtime Environment (JRE), and Zotero's plugin therefore doesn't work. +
- +
-Solution: Uninstall the JRE and install the Java Development Kit (JDK) instead. +
- +
-  - Uninstall the JRE +
-  - Download and install [[http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html|Java Development Kit (JDK) version 8]] +
-  - In LibreOffice: +
-    - Check in Prefs -> Advanced if JDK 1.8.xx is actually selected in the box +
-    - Go to Tools -> Extension Manager, scroll down to “Zotero LibreOffice Integration", and click on it. You should see an “Enable" button appear. +
-    - After enabling, the Zotero buttons in the LibreOffice toolbar should be responsive. +
- +
-Tested successfully with LibreOffice 5.2.4.2 / JDK 1.8.0_112 / LO Integration Plugin 3.5.12 / Zotero 4.0.29.16 / macOS 10.12.2.+
  
 +This is usually caused by an outdated version of LibreOffice that does not properly locate the system Java installation. It can be resolved by [[http://www.libreoffice.org/download/|reinstalling LibreOffice]].
 ===== Linux ===== ===== Linux =====
  
word_processor_plugin_troubleshooting.1560086732.txt.gz · Last modified: 2019/06/09 09:25 by dstillman