Adobe Reader 7.0 -- Browser Plugin HowTo

The browser plugin provided along with the Adobe Reader 7.0 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



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 7.0 install path, manually enter
  the installation path or press ENTER to use the default specified.

o Next you will be prompted whether to perfom automatic installation.
  In automatic installation, the the script automatically searches the
  PATH variable for all the supported browsers and installs the plugin
  for all those which are found.
  
o After completion/cancellation of the automatic installation, you
  will be prompted whether to perform manual installaion. In manual
  installation, you can explicitly specify the browsers for which the
  installation did not happen automatically.

o If select 'yes' for manual installation, you will then be prompt for
  the installation type:

  - Perform global installation: This is used for installing the
    plugin for a specific browser installation. If setup succeeds,
    then any user accessing that browser will be able to view PDFs
    inside the browser itself. This is done by copying the necessary
    files to the "plugins" folder in the browser installation
    path. Please make sure the user running the script has write
    permission to the location where the browser is installed.

  - Perform user-specific installation: This has been tested to work
    for Mozilla, Firefox and Netscape 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 7.0
   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 7.0 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) 2005, Adobe Systems Incorporated 
All Rights Reserved
