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
Next revisionBoth sides next revision
word_processor_plugin_troubleshooting [2018/02/26 04:49] – [All Platforms] Add an entry for unresponsive Zotero buttons after LO update adomasvenword_processor_plugin_troubleshooting [2019/01/07 02:32] – [Windows] dstillman
Line 14: Line 14:
   - Close Word or LibreOffice.   - Close Word or LibreOffice.
   - In Zotero, go to Tools → Add-ons → Extensions.    - In Zotero, go to Tools → Add-ons → Extensions. 
-    - If "Zotero Word for Mac/Windows Integration" or "Zotero LibreOffice Integration" are disabled, click the ''Enable'' button to re-enable the extension. +    - If "Zotero Word for Mac/Windows Integration" or "Zotero LibreOffice Integration" are disabled, click the "Enablebutton to re-enable the extension. 
-    - If the ‘’Enable’’ button for "Zotero Word for Mac/Windows Integration" is grayed out, and you are unable to click it, click the ‘’Remove’’ button and restart Zotero. +    - If the "Enablebutton for "Zotero Word for Mac/Windows Integration" is grayed out, and you are unable to click it, click the "Removebutton and restart Zotero. 
     - If you don't see "Zotero Word for Mac/Windows Integration" or "Zotero LibreOffice Integration" in the Extensions window 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 "Zotero Word for Mac/Windows Integration" or "Zotero LibreOffice Integration" in the Extensions window 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 [[/preferences/cite|Cite pane]] of Zotero preferences, open the "Word Processors" tab.   - In the [[/preferences/cite|Cite pane]] of Zotero preferences, open the "Word Processors" tab.
Line 43: Line 43:
 ===== Field codes instead of citation/bibiliography text ===== ===== Field codes instead of citation/bibiliography text =====
  
-By default, Zotero stores the reference data for citations and the bibliography in [[https://support.office.com/en-us/article/Insert-fields-in-Word-c429bbb0-8669-48a7-bd24-bab6ba6b06bb|Fields]] (Word) or [[https://help.libreoffice.org/Writer/About_Fields|Reference Marks]] (LibreOffice), which stores items' reference data hidden behind the formatted text.  +See [[kb:word_field_codes|Field Codes]].
- +
-If Word or LibreOffice is showing the field codes, rather than the formatted text, you can hide the field codes by pressing Alt/Option-F9 (or Alt-Fn-F9; Word) or Ctrl-F9 (LibreOffice). +
- +
-If you see field codes showing repeatedly, check your word proccessor settings for displaying fields. In [[http://mikefrobbins.com/2010/05/10/how-to-toggle-field-codes-off-or-on-in-word/|Word for Windows]], open Word Options, then choose "Advanced" and uncheck the "Show field codes instead of their values" box. In Word for Mac, open Word -> Preferences -> View and uncheck the "Field codes instead of values" box in the "Show in Document" area. In [[https://help.libreoffice.org/Writer/Field_Names|LibreOffice]], open Tools -> Options -> LibreOffice Writer -> View, and uncheck the "Field codes" box in the "Display" area. +
- +
-When using Track Changes, Word or LibreOffice will sometimes show you the changed and original versions of changed field codes. If this occurs, click “Accept” twice to quickly accept the changed citations and hide the field codes again.  +
- +
-See also [[kb/word_field_codes|Field Codes]]. +
 ===== Citations/bibliography highlighted ===== ===== Citations/bibliography highlighted =====
  
Line 85: Line 76:
  
 ==== Communication error or non-responsive plugin buttons==== ==== Communication error or non-responsive plugin buttons====
 +
 +If you see one of the following errors:
  
 //"Word could not communicate with Zotero. Please ensure Zotero is running and try again.”// //"Word could not communicate with Zotero. Please ensure Zotero is running and try again.”//
-Or plugin appears and buttons are clickable, but no insert citation window appears. 
  
-  - Ensure that Zotero Word for Windows Integration is enabled in Tools -> Add-ons-> Extensions. +//"Could not find a running Word instance"// 
-  - Make sure that you're running Zotero as the same user as Word. The plugin will fail, for example, if Zotero is run as administrator and Word as a regular user. For security reason you should typically not run any software as administrator. + 
-  - If you use ZoneAlarm, disable ForceField, which is known to cause a [[http://forums.zotero.org/discussion/11094/|communication error]].+or the plugin appears and buttons are clickable, but no insert citation window appears, try the following steps: 
 + 
 +  - Ensure that Zotero Word for Windows Integration is enabled in Tools -> Add-ons-> Extensions in Zotero
 +  - 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).   - 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).
  
Line 121: Line 117:
   - Go into Zotero Preferences -> Cite -> Word Processors and click "Install Word for Windows Add-in". Restart Word.   - 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_installation|manual installation]]+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]]
  
 ==== Word 2010: "Could not find a running Word instance" ==== ==== Word 2010: "Could not find a running Word instance" ====
Line 136: Line 132:
  
 You may also experience this error if you are running either Word or Zotero as Administrator or in a compatibility mode in Windows Vista or 7, or if security software is interfering with Zotero's ability to communicate with Word. You may also experience this error if you are running either Word or Zotero as Administrator or in a compatibility mode in Windows Vista or 7, or if security software is interfering with Zotero's ability to communicate with Word.
 +
 +
 +==== Run-time error '5097': Word has encountered a problem. ====
 +This issue affects the users of the Windows 10 October 2018 Update. To fix it you will need to change your regional format to English:
 +
 +  - In “Windows settings” go to the page for “Region”, which has settings for “Regional format”
 +  - Change that setting to "English (United States)" or “English (United Kingdom)”
 +  - Restart Word
  
  
Line 215: Line 219:
  
   * 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.)   * 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.)
- 
-==== Error with Word 2008 after using Migration Assistant ==== 
- 
-After using Migration Assistant to move your applications and documents from an old computer to a new computer, upon attempting to use Zotero from within Word, you may see the following error: 
- 
-//"Zotero experienced an error updating your document. 
- 
-[Exception... "'The operation couldn't be completed. (OSStatus error -1728.) @[getDocument:application.m:100]' when calling method: [zoteroIntegrationApplication::getDocument]" nsresult: "0x8057001e (NS_ERROR_XPC_JS_THREW_STRING)" location: "JS frame :: chrome:%%//%%zotero/content/xpcom/integration.js :: _callIntegration :: line 273" data: no]"// 
- 
-Migration Assistant transfers an incomplete copy of Office 2008 that lacks files required for Zotero to function properly. Delete the copy of Microsoft Office created by Migration Assistant and reinstall Office from the original discs, or copy it manually from your old computer to your new computer using a USB flash drive or network share. 
- 
-==== Plugin not working with Word Insider versions ==== 
- 
-Changes made in Word Insider (Beta) preview builds sometimes cause Zotero's Word Add-in to work incorrectly or not at all. If you are using a Word Insider version and the above troubleshooting steps do not fix your issue, try to [[downgrade_word_for_mac|downgrade to the stable version of Word for Mac]] to see if this resolves your issue. 
- 
-Zotero was previously incompatible with Word 2016 for Mac versions 16 and higher. Support was added in Zotero 5.0.34.3. 
- 
 ===== Linux ===== ===== Linux =====
  
word_processor_plugin_troubleshooting.txt · Last modified: 2024/03/19 12:47 by adomasven