NAME

WWW::Mechanize::Firefox::Installation - How to install the components

Installation

If you notice that tests get skipped and/or the module installs but "does not seem to work", there are some more steps required to configure Firefox:

1. Download mozrepl 1.1.2 available from

   https://addons.mozilla.org/en-US/firefox/addon/mozrepl/versions/?page=1#version-1.1.2

   or a later version from

   https://github.com/bard/mozrepl/tags

2. If you downloaded the version from mozilla.org, skip to 5.

   If you downloaded a version from github, unpack the zip archive into a directory. The version distributed by mozilla.org is ready for direct installation.

   The archive contains one subdirectory with a name of the form bard-mozrepl-abcdefg.

3. Create a new zip archive with the files in the subdirectory bard-mozrepl-abcdefg. This new archive must have the files at the root entry, not in a subdirectory.

   The file layout should look like this:

   chrome/
   components/
   defaults/
   chrome.manifest
   install.rdf
   logo.png

4. Rename your new zip archive from .zip to .xpi.

5. Launch Firefox

6. Install the downloaded or freshly created .xpi file into Firefox. For example you can drag and drop the file into Firefox.

7. Start mozrepl in Firefox by going to the menu:

   "Tools" -> "MozRepl" -> "Start"

   You may want to tick the "Activate on startup" item.

   Alternatively, launch the Firefox binary with the -mozrepl command line switch:

   firefox -repl

If tests still fail, especially t/50-click.t and 51-mech-submit.t , this might be because you use the NoScript Mozilla extension and have it blocking Javascript for file:// URLs. While this is good, the tests need Javascript enabled.

1. Open t/50-click.html in Firefox

2. Allow Javascript for all file:// URLs

3. Re-run tests

   perl Makefile.PL
   nmake test

   or if you are using Strawberry Perl or Citrus Perl

   perl Makefile.PL
   dmake test

4. No test should fail

If tests fail with an error from Firefox that a file could not be found, check that the test suite and the Firefox process are run using the same user. Otherwise, the Firefox process might not have the permissions to access the files created by the test suite.

PPMs

If you use ActiveStates package manager, you can find some pre-packaged but untested PPMs at https://github.com/Corion/www-mechanize-firefox/downloads .

As I don't use ppm, I can't offer any support for them.

AUTHOR

Max Maischein corion@cpan.org

COPYRIGHT

Copyright 2010-2014 by Max Maischein corion@cpan.org.

All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.