File:  [mozdev] / quickfilters / www / index.html
Revision 1.27: download - view: text, annotated - select for diffs - revision graph
Wed Jan 8 15:03:52 2014 UTC (6 years, 2 months ago) by axel.grude
Branches: MAIN
CVS tags: HEAD
updated Message Filter List help topic making sure that quickFilters name was displayed


<link rel="stylesheet" href="/css/myProjects.css?v2" type="text/css">
<link rel="stylesheet" href="/css/index.css" type="text/css">

<!-- ***************** INFO/NEWS *************** -->
<a name='news'> </a>
<div id="infoTabs">
<div class="infoTab" id="whats-new">
<h5 class="infoHeader">What's New</h5>
<ul>
<li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/2.2">2.2</a>Support creating filters based on Tag changes.</li>
<li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/2.2">2.1</a>Cloning filters. Group Filter template from multiple mails</li>
<li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/2.0">2.0</a>Added Toolbar and Postbox compatibility</li>
<li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/1.8">1.8</a>Cut, copy and paste to support migrating accounts</li>
<li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/1.5.1">1.5.1</a>19/11/2012 - dragging emails from search folders </li>
<li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/1.4">1.4</a>02/08/2012 - button for running filters </li>
<li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/1.3">1.3</a>03/06/2012 - SeaMonkey support & improved auto-naming </li>
<li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/1.2">1.2</a>23/05/2012 - error fixes, multi-cc </li>
<li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/0.9">0.9</a> 15/05/2012 - support pages, filter list button </li>
<li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/0.8">0.8</a> 08/05/2012 - First Release</li>
<li><a href="http://www.mozdev.org/">mozdev.org</a></li>
</ul>
</div>


<!--
<div class="infoTab" id="other-stuff">
<h5 class="infoHeader">Other Stuff</h5>
<ul>
<li>stuff goes here</li>
<li>more stuff goes here</li>
</ul>
</div>
-->

<!-- alternative image/table base tab works better in NS4 -->
<!--
<div class="infoTab" id="whats-new-image">
<h5 class="infoHeader"><img src="http://www.mozdev.org/sharedimg/whatsnew_top.gif" width="154" alt="What's New"></h5>
<div class="infoItems">
<div>News item goes here</div>
<div>More news item goes here</div>
<div><a href="http://mozdev.org/">mozdev.org</a></div>
</div>
</div>
-->
</div>
<!-- ***************** INFO/NEWS *************** -->

<!-- MAIN CONTENT -->


<a name='main'></a>
<h2 class="page-header">quickFilters :: homepage</h2>

<p>Thanks for installing quickFilters! <br/>

This extension makes it much easier to create new mail filters, by simply dragging emails into folders and let quickFilters do the "heavy lifting" 
of filling in the sometimes complicated settings in the filter settings. Filters are usually used to move emails to other folders, automatically, so it makes
sense to show Thunderbird "what to do" by dragging one typical email manually, rather than filling in all the complicated details.
</p>

<a name='howToUse'> </a>
<h3>How to use quickFilters</h3>
<p>
With this, it is very easy to create new filters very quickly. 
</p>
<p>It will prefill the destination folder and other relevant fields after you have dragged the email into a different folder in the tree.
</p>
<ol>
  <li> Click on the quickFilters button on the main toolbar<br/>
  <img class="screenshot" src="img/quickFilters-ToolbarButton.png" alt="main menu: filter assistant">

  <li>The button will change depicting a glowing wheel instead of the mail icon and there will be sliding notification:<br/>
  <img class="screenshot" src="img/quickFilters-Notification.png" alt="filter notification" title="filter notification assistant">

  <li>Drag an email into a folder on the left hand folder tree. This will open the Filter Assistant screen.<br/>
  <img class="screenshot" src="img/quickFilters-Assistant-1.6.png" alt="filter wizard" title="filter wizard">
  
  <li>select a template (e.g. "based on Sender") and click [Create Filter...] - in the example I have pulled an email into the QuickFolders folder.
  See below for a detailed description.  

  <li>Next, the Edit Filter dialog is displayed - as you can see it already tries to "guess" what  you want the filter to do when it should be applied, 
  <u>based on the email that you dragged to the folder</u>:<br/>
  <img class="screenshot" src="img/filter-Rules.png" alt="filter rules">
  <br/>Since in this case I chose "Based on Sender", it will pull all conversations from and to <i>joe@quickFolders.com</i> into the QuickFolders folder. 
  No need to select the folder (as it has been done automatically) or to enter any condition (this is based on the template that you have chosen).

  <li>Now tweak the filter as usual and click Ok to save it (and try it out in the Filter List)
  <li>You can also click Cancel to not create the filter
  
  <li> in the last step Thundebird's list of filters is shown. <br/>
  <img class="screenshot" src="img/filters-List.png" alt="list of filters">

  <li>You can repeat the process from step 2 to create more filters

  <li>When you're done, click the filter button again to disable "Filter Wizard" mode.
</ol>

<a name='assistant'> </a>
<h3>The Filter Assistant</h3>
  <p>On this screen, you select what type of information (conditions) will trigger the filter action, 
	   and what kind of actions the filter will carry out. A condition is a 'fact' that applies to the 
		 incoming email, such as 'the sender is fred', 'the mail is tagged as important', 
		 'this message is more than a month old' etc. The action can be 'move message to freds folder',
		 'tag message as personal', 'set message low priority', 'mark message with a star'.</p>
		 <img src="img/quickFilters-Assistant-2.3.png" alt="quickFilters Assistant"/><br/>
		 <p>
		 The templates offered here make this a much easier and quicker process and fill prefill the 
		 new filter accordingly.</p>

<a name='templates'> </a>
<h3>Filter Templates</h3>

<p>This section describes the different patterns used to create filters based on the dragged email. 
I will probably add more templates in future, if I get good requests from the users. 
Simply head over to the <a href="bugs.html">bugs section</a> to suggest new templates.
<br/>
<div id='templates'>
	<h4>Based on Sender (from)</h4>
	<p>Probably the most used pattern: this will retrieve the sender's email address and paste it into the from and to filter conditions fields.
	This way a whole conversation with the sender will be moved to the new folder.
	</p>
	<h4>Based on Recipient (to)</h4>
	<p>Similar to 'Based on Sender': use this when you move an email from yourself 
	to somebody else. This will retrieve the recpient's email address and paste it into 
	the from and to filter conditions fields. This way the complete conversation with 
	the contact will be moved to the new folder.</p>
	<h4>Mailing List</h4>
	<p>
	Similar to Based on Sender, but it doesn't fill the 'to' condition field.
	</p>
	<h4>Subscriptions - By Subject [Keyword]</h4>
	<p>
	This will look for special "bracketed" expressions, e.g. [amo-editors] or {Mozilla} and create a filter condition based on these; a lot of
	mass email is set up using this pattern, so it is really easy to use.
	</p>
	<h4>By Tags</h4>
	<p>
	Uses the tags of the email and adds them as filter conditions.
	</p>
</div>

<a name='merge'> </a>
<h3>Merging Filters</h3>
<p>This is a special screen on the filter assistant which is shown if there are already filters that carry out the same action
   as the one you want your new filter to do. It can also be invoked using the 'Merge Filters' button on the filter toolbar.
	 Note that you can only merge filters that have the same action (such as move to a certain folder or add a certain tag), quickFilters
	 makes sure that no other filters can be merged together.</p>
	 
<img src="img/NewFilter-Merge.png" alt="quickFilters Merge"/><br/>
 

<a name='messagesAlreadyMoved'> </a>
<h3>Mail that's already moved</h3>


<p>What if already have moved my Mails to another folder? 
Chances are that sometimes forget switching on the filter assistant, or we have already moved a lot of mail around manually.
In this case the quickFilters version 1.6 now adds a context menu to the message list:<br/>
<img src="img/contextMenu.png" alt="Creating a filter from a moved message"/><br/>
just right-click the mail you want to choose for your filter, and then click on QuickFilters: "Create Filter from Message...". 
Alternatively, simply select the message and use the "Message" menu.
</p>

<a name='messageFilterList'> 
<h3>The Message Filter List</h3>
</a>

<p>In quickFilters, I added more functions to the filter list dialog - I created these after it had
become a simple thing to create many filters with few clicks. 
</p>
<img src="img/messageFilters.png" alt="Message Filters: new features"/><br/>
<p>The biggest new feature here is the addition of a Search box, which allows filtering the number of results. 
I was able to submit this as a patch to Thunderbird itself and it is not part of the main product.</p>
<p>The toolbar has some useful functions that were missing:</p>
<ul>
  <li> cut / copy / paste: these are designed to transfer filters from one account to another. 
	     Select one ore more filters, then push cut or or copy, then select a new account (in the 'Filters for' drop down), 
			 then paste the filters to the other account.</li>
	<li> merge filters: allows putting multiple filters into one, provided they do th same action. E.g. if two filters all
	     move mails to the 'Fred' folder, you can merge them together into one filter. The assistant will ask you to select
			 the "Target" filter, which is the one that gets the conditions from the other filters. Once you confirm the "Target Filter"
			 by clicking Ok, the merged filters will be deleted.</li>
	<li> clone filter: makes a copy of a filter in the account and opens the edit dialog so it can be modified. </li>
	<li> Filter assistant mode toggle: once this is active, quickFilters will listen for manual mail movement and tagging emails. 
	     If any of these actions occur, the assistant is started so that a filter can be created based on this action</li>
	<li> The Support Site button opens this page. </li>
	<li> The wrench button displays quickFilters global preferences. </li>
</ul>
<p>Also you can now move the filter to the top of the bottom of the list. This is actually significant as the 
order you see on screen is the same as the order in which the filters are executed. This also means, if a filter
on the top moves a message from the inbox then the filters below will not get a chance to execute on this message;
as the filters are only executed on messages in the inbox, they will simply be ignored. Therefore it is very important 
that it remains easy to re-order the relative positions of the filters. This also works while the search box is active.</p>


<h3><a name="other">My other Extensions - highly recommended</a></h3>
<br/>

<div id='myProjects'>
	<h4 class="QuickFolders"><a href="https://addons.mozilla.org/en-US/thunderbird/addon/quickfolders-tabbed-folders/">QuickFolders</a></h4>
	<p>
	<a href="https://addons.mozilla.org/en-US/thunderbird/addon/quickfolders-tabbed-folders/">QuickFolders</a>
	(Thunderbird / Postbox) takes the pain out of working with many mail folders; has currently 22,000 daily users and the top rated message reading extensions.<br>
	</p>

	<h4 class="ZombieKeys"><a href="https://addons.mozilla.org/en-US/firefox/addon/zombie-keys/">Zombie Keys</a></h4>
	<p>
	<a href="https://addons.mozilla.org/en-US/firefox/addon/zombie-keys/">Zombie Keys for Firefox / SeaMonkey</a> ; 
	<a href="https://addons.mozilla.org/en-US/thunderbird/addon/zombie-keys/">Zombie Keys for Thunderbird / Postbox</a>
	<br>
	<p>Entering European languages (which include diacritics (accented characters, diaeresis, umlauts, etc.), ligatures, the Euro sign, etc.) 
	into Mozilla applications using a non-native keyboards doesn't have to be a pain any more! 
	</p>

	<h4 class="QuickPasswords"><a href="https://addons.mozilla.org/en-US/firefox/addon/quickpasswords">QuickPasswords</a></h4>
	<p>
	<a href="https://addons.mozilla.org/en-US/firefox/addon/quickpasswords">QuickPasswords for Firefox / SeaMonkey</a>;
	<a href="https://addons.mozilla.org/en-US/thunderbird/addon/quickpasswords">QuickPasswords for Thunderbird / Postbox</a>
	<br>
	this is a very neat and quick way to retrieve and use a growing number
	of passwords, without displaying them on screen or having to re-type them. 
	Also supports renaming of multiple passwords!
	</p>
</div>


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>