Use of Zotero 1.5 with your Word and OpenOffice.org documents will irrevocably upgrade them, and you will no longer be able to use them with Zotero 1.0.7 or earlier.
====== Sync Preview Features ====== We are excited to announce the launch of Zotero 1.5 Sync Preview, which introduces a powerful slate of new features, including: * Automatic synchronization of collections among multiple computers. For example, sync your PC at work with your Mac laptop and your Linux desktop at home. * Free automatic backup of your library data on Zotero’s servers. * Automatic synchronization of your attachment files to a WebDAV server (e.g. iDisk, Jungle Disk, or university-provided web storage). * Rich-text notes * Support for Endnote® export styles * A new style manager allowing you to add and delete CSLs and legacy style formats. * Automatic detection of PDF metadata. * Automatic detection and support for proxy servers. * Preliminary support for local sharing of collections through Zeroconf on OS X. Other platforms and full support to come with the final release of Zotero 1.5. ====== Requirements ====== ===== Firefox 3 ===== Zotero 1.5 Sync Preview requires [[http://www.mozilla.com/firefox|Firefox 3]]. It is not compatible with Firefox 2. ===== Test dataset and profile ===== Because Zotero 1.5 Sync Preview will make irreversible changes to both your database (zotero.sqlite) and your attachments directory (zotero/storage), you should work only with a copy of your Zotero library. With Firefox closed, make a copy of the "zotero" folder from the Firefox profile of your existing Zotero 1.0.7 installation. For the moment, just remember where you are keeping the copy. Now launch Firefox 3 from the command line with the -ProfileManager flag and create a new profile (e.g. "Sync Testing"). For more information on how to start and use the profile manager, please see Mozilla's [[http://support.mozilla.com/en-US/kb/Managing+profiles|Managing profiles]] page. After you've created the new profile, close Firefox 3, navigate to the new profile's directory, and place your copy of your "zotero" folder here. Tip: Store a zipped copy of your "zotero" folder in your Firefox profile directory. If you need to reset your library quickly, you can simply delete the "zotero" folder and then unzip the zipped copy. ===== Install Zotero 1.5 Sync Preview add-on ===== Open Firefox 3 using the new profile and install [[/download/zotero-1.5-sync3.4.xpi|Zotero 1.5 Sync Preview 3.5]]. ===== zotero.org account ===== If you don't already have a zotero.org account, please [[https://www.zotero.org/user/register/|create one]]. If you were previously a Zotero Forums user, a zotero.org account has been created for you automatically. Enter your zotero.org username and password in the Sync pane of the Zotero preferences. ====== Syncing ====== As you make changes to your library (add, edit, and delete items), those changes will be automatically synchronized with the Zotero server. The first time your Zotero library syncs, Firefox may appear to hang, especially if you have a large library. While testing Zotero syncing, it is possible to observe the process "behind the scenes" by running Firefox from the command line with the console open and [[debug_output|debug output]] enabled. However, if you're running Windows, running with the console open will severely degrade performance and is therefore not recommended. Note: Some syncing functionality is not yet implemented. Please see our [[sync_preview_known_issues|known issues]] page for Zotero 1.5 Sync Preview. ====== File Syncing ====== If your service has an SSL certificate that requires whitelisting via Firefox before you can use it with Zotero, you can load that URL in Firefox, accept the certificate permanently, and then return to Zotero. You should only have to do this once. Zotero doesn't handle redirects for WebDAV—you need to enter the final destination URL. ====== Accessing Your Data from Other Computers ====== Once you have set up one computer to work with Zotero 1.5 Sync Preview, you can access your library from any computer with Zotero 1.5 Sync Preview installed. On another computer, install Zotero 1.5 Sync Preview into Firefox 3 and add your Zotero forums username and password information as indicated above. Click the Zotero sync icon to initiate automatic synchronization of this computer with your Zotero server account. As you make changes to your library (add, edit, and delete items), those changes will be automatically synchronized with the Zotero server. Whenever you begin work on another, synchronized computer, click the sync icon to make sure your library is up to date. Zotero will also attempt to synchronize your library whenever you first open the Zotero pane after starting Firefox. ====== Word Processor Plugins ====== **Warnings:** * Use of Zotero 1.5 with your Word and OpenOffice documents will irrevocably upgrade them, and you will no longer be able to use them with Zotero 1.0.x releases. * The 2.0a2 plugins for Mac Word 2008 and OpenOffice are alpha releases. Please make frequent backups of your documents if you use these plugins in production. * Due to incomplete bookmark support in OpenOffice when saving files in .doc format, in-text citations in footnotes or endnotes and note-based styles cannot be used in Bookmarks mode. The 2.0a2 plugins enforce the former restriction; the next Sync Preview release will prevent the latter. Version 1.0b4 of the Windows Word plugin does not yet enforce the former restriction. ===== Microsoft Word ===== Windows Word (all versions) users should use **1.0b4** of the Word plugin: * [[/download/integration/Zotero-Word-Plugin-Installer-1.0b4.exe|Download Word for Windows Installer]] (139KB, English only) * [[/download/integration/Zotero-Word-Plugin-1.0b4-Win.zip|Download Word for Windows Plugin]] (90KB, all languages, [[windows_word_plugin_manual_installation_instructions|manual installation]] required) Mac Word 2008 users should use **2.0a2** of the Word 2008 plugin: * [[/download/integration/Zotero-Word-Plugin-Installer-2.0a2.dmg|Download Word 2008 for Mac Plugin Installer]] (701KB) Mac Word 2004 is not currently supported by Zotero 1.5, though a compatible version is planned. ===== OpenOffice ===== Windows/Linux OpenOffice users should use **2.0a2** of the OOo plugin: * [[/download/integration/OOo-Plugin-2.0a2/Zotero.oxt|Download OpenOffice Plugin]] (27KB) OpenOffice 3.0 for Mac OS X [[http://www.openoffice.org/issues/show_bug.cgi?id=92661|does not currently support Python-based plugins]] such as the Zotero plugin. A fix is currently targeted for OOo 3.1. In the meantime, Mac users can also use NeoOffice. ===== NeoOffice ===== NeoOffice users should use **2.0a2** of the OOo plugin: * [[/download/integration/OOo-Plugin-2.0a2/Zotero.oxt|Download OpenOffice Plugin]] (27KB) ====== Known Issues ====== Before reporting any bugs or problems, please consult the list of [[sync_preview_known_issues|known issues]]. ====== Reporting Bugs ====== To provide helpful bug reports, you generally must be running Zotero with [[debug output]] enabled, as this will allow you to follow the syncing process and view client and server errors. All bugs should be reported in the [[http://forums.zotero.org/10/|Sync Preview forum]].