Options

To access the options, go to Tools > Add-ons in Firefox, locate Easy Copy and click Options.

There are various options you can set to make Easy Copy work the way you want to. The Options dialog is split into a Templates pane and a Formatting pane.

Also have a look at some more ideas for templates you can add. There's a lot of cool stuff you can do.

Note on Mac/Linux: On these platforms, options are normally applied immediately when you change them and there are no Ok/Cancel buttons. However, template changes aren't instantly applied. You have to close the options dialog for template changes to be saved. On Windows, the dialog will show Ok/Cancel buttons and options are only applied if you press Ok.

Templates



The Templates pane allows you to configure just about anything related to a template. You can set properties and perform actions like reordering templates, creating new ones and deleting unwanted ones.

Selecting a template in the list shows more details about the template in the Template Details fields below the list. You can also edit the template from here (you can't edit anything in the list directly - you have to use the Template Details below).

The order of the menus in the Options dialog determine the order they appear in menus. Note: If you're using Menu Editor then reordering might not work and you may have to configure the order manually in Menu Editor itself.

Properties

Here are the properties you can set for a template:

Property Description
Name The name of the template that will appear in menus.
Template The template to use when copying text to the clipboard. See the list of variables you can use.
Enabled Whether this template is enabled or disabled. Only enabled templates will appear in menus and have keys registered with Keyconfig. Disabled templates will still appear in the Options dialog. If you want to permanently delete a template, see the Delete button below.
Show In Main Menu Whether this template appears in Firefox's main context menu in addition to the Easy Copy submenu. This makes it faster to access the menu item, especially if it's a template you use frequently.
Type Tells Easy Copy what format to copy the template as. The relevant icon below will appear next to the template in the menu.
text: Easy Copy will only copy the template to the clipboard as text. Most application should understand text.
html: Similar to text, but in addition, Easy Copy will make the template availabe as HTML to other applications. Pasting this in applications that recognise HTML (eg. Word, Evernote) will paste it as HTML-formatted text so, for example, links will be clickable. Choose this option if your template contains HTML syntax (eg. see the Title Link template).
Format for HTML Tells Easy Copy that the template needs to produce HTML so any user text such as selections and titles should be HTML encoded (ie. <, > and & will be replaced by &lt;, &rt; and &amp; respectively). Normally used together with the template Type html.

Actions

There are also some actions you can perform on the templates:

Action Description
New Creates a new template and assigns default values to it.
Duplicate
Creates a new template based on the currently selected template, with a title indicating that it's a copy of the currently selected template.
Move Up / Move Down Moves the selected template up/down in the order. The order of the templates determine the order in which they will appear on the context menu and the Easy Copy submenu.

NB: If you're using the Menu Editor extension then this feature will probably not work for templates in Firefox's main context menu (see the Show In Main Menu option). You'll have to go into Menu Editor and manually reorder the templates. It will still work with Menu Editor for templates in the Easy Copy submenu though.
Delete Deletes a template permanently. The template will disappear from the Options altogether and won't appear in any Easy Copy menu. If you just want to disable a template without deleting it, then see the Enabled property above.

Keyboard shortcuts

Easy Copy allows you to copy any template easily with the keyboard. The following keys are preconfigured:

Template Keyboard Shortcut Comments
Copy Title Link Ctrl+Shift+Y Pasting a link into an email doesn't require a mouse anymore.
Copy URL Ctrl+Shift+U Yes, you can copy the page's URL directly with a single key.

However, you don't manage keyboard shortcuts directly from Easy Copy.

There are 2 big reasons for this, the first being that it takes time and effort away from providing the essential features of Easy Copy, ie. cool ways to quickly copy useful stuff to the clipboard.

The second reason is that the excellent extension Keyconfig already exists to manage keyboard shortcuts. It's well-documented on MozillaZine's Knowledge Base and you can download it at the extension's support forum.

Easy Copy integrates with Keyconfig by exposing all templates and menu items as keys. In the Keyconfig interface, you'll see entries starting with Copy ABC (Easy Copy). The titles will correspond to the template names to identify them easily, eg. Copy HTML Source (Easy Copy). Here's an example of what you may see in Keyconfig (remember that you'll only see entries for templates that are enabled - see the Enabled property).:

Easy Copy in Keyconfig

Formatting


From the Formatting pane, you can configure how Easy Copy formats text before it copies it to the clipboard.

Option Description
When copying text version of HTML, copy displayed text instead of HTML markup
If this option is disabled (default), then the HTML markup is copied as the text version for HTML templates. If it's enabled, then the actual displayed text is copied as the text version.

Background: When you copy an HTML template, Easy Copy copies 2 versions of it: One for pasting into HTML-aware editors (like Word or Evernote) and another for text editors such as TextPad and Notepad. Normally, the text version is the actual HTML markup, eg. <a href="my/link">Some Link</a>. However, you might prefer to have the actual text ("Some Link") and paste that in the text editor.
Remove the following text from the front or back of the title When disabled, Easy Copy will leave the title untouched and copy it as it appears in the browser's tab. When enabled, it will remove the text specified in Text to remove below.
Text to remove Specifies pieces of text that you want to remove from the beginning or end of the page's title. For example, Leonardo da Vinci's title full title in Firefox is Leonardo da Vinci - Wikipedia, the free encyclopedia (the title in the tab). To remove "- Wikipedia, the free encyclopedia" from the end of the title, just add it as a separate line to Easy Copy. Be sure to include any separator characters like - and :.

Easy Copy comes configured with defaults for a couple of popular sites, including Wikipedia, BBC News and Firefox Addons. You can add/remove as many entries as you like.

Copy All Tabs (since v2.0.0)


The Copy All Tabs pane allows you to specify how Easy Copy should copy templates across multiple tabs. Easy Copy runs over each tab and makes its values available in the variable %template%. You can use this variable to customise the output, according to the options below.

Property Description
Include the following windows All Windows: Copy all tabs in all open windows

Active Window Only: Only copy tabs in the current active window.
Use the following format (text templates) Tells Easy Copy what to add to the copied template when copying content in text format. For example, if you want to add an asterisk at the beginning of each line, then enter "* %template%". Easy Copy will generate multiple lines for each tab with each one prefixed with an asterisk.
Use the following format (HTML templates) Tells Easy Copy what to add to the copied template when copying content in HTML format. For example, if you want to eventually wrap each line in an unordered list tag (<ul>) then just enter "<li>%template%</li>".
Split multiple lines using Specify what to use to break multiple HTML lines across new lines. The default is <br> but you can choose any other HTML markup (eg. <p>).

Display (since v2.0.0)


The Display pane allows you to choose which menus you see in the main context menu so you hide a menu if you don't use it.

Property Description
Show the following submenus in the context menu Easy Copy: Show the Easy Copy submenu that shows all the available templates. Disable this if you only use templates that are shown in the main context menu and don't use the submenu.

Copy All Tabs: Show the Copy All Tabs submenu that allows you to copy all open tabs using the available templates. Disable this if you don't intend to use the Copy All Tabs feature.
Show the following items in submenus
Options: Show a shortcut to the Easy Copy Options dialog to give you faster access to templates and other settings. Disable this if you rarely change options.

Contribute: Show a contribute item that opens the Easy Copy contribution page at Mozilla Addons. Disable this if you've already contributed to Easy Copy or prefer not to have this option display in the menu.