-
Notifications
You must be signed in to change notification settings - Fork 13
Installation and Options
##Installation
For most users, the easiest and most direct way is to install the signed add-on through the Mozilla Add-On Directory. If you are using the Firefox browser, then you can install with one click by finding the add-on in the directory and clicking the green "Add to Firefox button". This add-on uses the restartless add-on SDK so you will not have restart your browser after installing. However, you will have to refresh any open tabs in which you would like to use the add-on. It will work in all new tabs opened after installation without requiring a refresh.
You can watch the [installation and setup video](http://# "Watch the video at YouTube" to learn more).
This add-on will only run in Firefox; however, you can still download from another browser from the Mozilla Add-on Directory. In this case, you will have to download and save the *.xpi file to your local workstation and then manually load it into your Firefox distribution. For more information, see the tutorial at Access Firefox
In most cases, you will just install the add-on directly from the Mozilla Add-on Directory. If you already followed above, you can skip this section.
However, if you want to make customizations or if you are interested in using this add-on to learn more about add-on development you will likely need to repackage the *.xpi. Please note, the only official release as a packaged XPI is through the Mozilla Add-on Directory ad described above.
You can make a local copy of the GitHub repository or download a zip and manually extract all the files to a local directory. You will need to be familiar with the Add-On SDK. If you are not, you can get up and running in about 1-2 hours using the "Getting Started" Tutorials from the Mozilla Developer Network. If you want to package this add-on yourself for installation, you can do so using the Add-On SDK cfx tool (cfx xpi). You should also be able to use the newer jpm, but this has not been tested.
Once you have packaged the XPI you can install it using the manual install method as described at Access Firefox.
The add-on will generally work for most people with the default configuration out of the box. However, there are a few configuration options available to the user. To access the configuration options, load the add-on manager.
Once there, find the row for "Add Url to Window Title" and click on the "Options" button. There will be three options which you can configure out of the box through the Add-on Manager:
This option is a checkbox. By default, it is checked.
When the checkbox for "Show the full URL?" is checked, the entire URL including the protocol, the specific page, and any other content is shown. For example, if you were to log into Google's GMail, the url may look something like this: https://accounts.google.com/ServiceLogin?service=mail. When the checkbox is checked, the entire URL will be shown. When the box is left uncheck, only the website's hostname will be shown: With the given GMail example above, this would only show accounts.google.com.
Generally, you will want to leave the checkbox checked because this will allow you to write a more specific Auto-Type rule. However, some users may want to match on less granularity. Note, even if you leave the checkbox checked, you can use a wildcard when defining your auto-type rules to match just the hostname on sites where this is desired. For more on auto-type rules, see the KeePass Documentation
This option is a string. By default, it is a single dash (-).
This option allows you to specify a separator string that will go between the original page title and the content added by the add-on. It can be more than one character. Please note, the add-on automatically puts a one character space before and after this string. Generally, you can leave this as the default. You may want to change it to help make it more clear when you look at the window title or to further customize your auto-type rules.
This option is a checkbox. By default, it is unchecked.
This is an advanced setting and requires you to change settings within KeePass (see below). If you do not wish to change the KeePass settings, then you should leave this options unchecked.
When you enable this setting by checking the checkbox the add-on will monitor for when you select an input field. When the input field is selected, the input field's html name and id attributes will be added to the window's title after the full URL or hostname (depending on how you configured the settings above). This can help you customize auto-type rules and helps to prevent you from accidentally entering your username or password in search fields or other input boxes which may not be properly secured or treated with the same protections as we fields for credentials (e.g., the server may log all search queries, exposing your password in the logs).
For additional information and help configuring KeePass, see the help and tutorial which includes detailed instructions and tutorial videos.
This add-on uses the standard install and uninstall lifecycle management for Firefox addons. Please see the official Mozilla documentation on removing or disabling add-ons for more help.
This document is distributed under the the Creative Commons Attribution-NonCommercial 2.0 Generic (CC BY-NC 2.0) License. You may adapt parts of this text for other purposes, but you must attribute to this original source (i.e., with a link back). You may freely distribute this document to anyone for any reason without restriction, but may not use this document for commercial purposes per the license.