Adobe Reader 8.1.2 -- Browser Plugin HowTo

The browser plugin provided along with the Adobe Reader 8.1.2 is used
for viewing of PDF files from within the browser. It is compliant with
the Netscape Gecko API and works with all browsers which use the Gecko
browser engine. It will enable viewing of PDFs as full page documents
in the browser or within frames managed by HTML content.

The supported browsers include: 
    o Mozilla 1.7.3, 1.8 
    o Firefox 1.0, 1.5



Installing the browser plugin:

An installation script "install_browser_plugin" has been provided for
the purpose of setting up the browser plugin for your browser.

o Run the script from the prompt as: 
  $ cd <install-path>/Browser
  $ ./install_browser_plugin

o When prompted for the Adobe Reader 8.1.2 install path, manually enter
  the installation path or press ENTER to use the default specified.

o Next you will be presented a menu to perfom global or user-specific
  installation.

o In global installation, the script automatically searches the
  PATH variable and some default directories for all the supported
  browsers and installs the plugin for all those which are found.
  
o User-specific installation: This has been tested to work for
  Mozilla, Firefox and enables only a particular user to be able to view
  PDFs inside any of the browsers stated above.  This is done by copying
  the necessary files to $HOME/.mozilla/plugins folder.

o If you are unable to install the plugin for your browser by any of
  the above mentioned mechanisms, you might need to refer to the
  browser documentation for ways of adding a new plugin.

o After the installation succeeds, please make sure that the acroread
  startup script is in the PATH environment variable.



TroubleShooting:

Problem - 

Unable to load PDF in browser
OR 
Clicking on a PDF link in the browser shows a blank page 

Solution (any one of the following) -

1. Make sure you have installed the plugin in the correct place. To
   verify loading of the plugin in Mozilla/Firefox, type
   'about:plugins' in the address bar and verify that Adobe Reader 8.1.2
   is showing in the list.

2. Make sure acroread is in the PATH of the shell which was used to
   launch the browser. This can be done by running the command 'which
   acroread' from the shell which was used to launch the browser. If
   it is not found, locate acroread and add it to the PATH variable in
   the environment.

3. Make sure there is no other plugin installed which can handle the
   PDF mime type. To view all plugins that have loaded in
   Mozilla/Firefox, type 'about:plugins' in the address bar. In the
   list of plugins displayed, verify that there is no entry other than
   Adobe Reader 8.1.2 which is handling PDF. 

   - At times there is a plugin called Plugger/Mozplugger which also
     handles PDF files. To correct this, open the file '/etc/mozpluggerrc'
     and remove the lines corresponding to PDF mime type. Then remove the
     file 'pluginreg.dat' from $HOME/.mozilla folder and restart the
     browser.

   - If you find an entry corresponding to "KDE Parts Plugin", you will 
     need to remove the plugin file (libdragonegg.so) from the plugins 
     folder in order to use Adobe Reader as the default PDF viewer. However 
     deletion of the plugin file would mean that you might loose some 
     additional functionality provided by the KDE Parts Plugin.


For queries or more information, please visit us at www.adobe.com

Copyright (c) 2007, Adobe Systems Incorporated 
All Rights Reserved
