WWW::Mechanize::Firefox::Installation - How to install the components
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:
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
If you downloaded the version from mozilla.org, skip to 5.
mozilla.org
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.
bard-mozrepl-abcdefg
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
Rename your new zip archive from .zip to .xpi.
.zip
.xpi
Launch Firefox
Install the downloaded or freshly created .xpi file into Firefox. For example you can drag and drop the file into Firefox.
Start mozrepl in Firefox by going to the menu:
mozrepl
"Tools" -> "MozRepl" -> "Start"
You may want to tick the "Activate on startup" item.
Alternatively, launch the Firefox binary with the -mozrepl command line switch:
-mozrepl
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.
Open t/50-click.html in Firefox
Allow Javascript for all file:// URLs
Re-run tests
perl Makefile.PL nmake test
or if you are using Strawberry Perl or Citrus Perl
perl Makefile.PL dmake test
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.
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.
ppm
Max Maischein corion@cpan.org
corion@cpan.org
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.
To install WWW::Mechanize::Firefox, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WWW::Mechanize::Firefox
CPAN shell
perl -MCPAN -e shell install WWW::Mechanize::Firefox
For more information on module installation, please visit the detailed CPAN module installation guide.