Annotation of quickfilters/www/index.html, revision 1.35

1.1       cvs         1: 
1.18      axel.gru    2: <link rel="stylesheet" href="/css/myProjects.css?v2" type="text/css">
1.34      axel.gru    3: <link rel="stylesheet" href="/css/index.css?v5" type="text/css">
1.2       axel.gru    4: 
1.1       cvs         5: <!-- ***************** INFO/NEWS *************** -->
1.2       axel.gru    6: <a name='news'> </a>
1.1       cvs         7: <div id="infoTabs">
                      8: <div class="infoTab" id="whats-new">
                      9: <h5 class="infoHeader">What's New</h5>
                     10: <ul>
1.24      axel.gru   11: <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>
                     12: <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>
1.23      axel.gru   13: <li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/2.0">2.0</a>Added Toolbar and Postbox compatibility</li>
                     14: <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>
                     15: <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>
                     16: <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>
                     17: <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>
                     18: <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>
                     19: <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>
                     20: <li>Version <a href="https://addons.mozilla.org/thunderbird/addon/quickfilters/versions/0.8">0.8</a> 08/05/2012 - First Release</li>
1.1       cvs        21: <li><a href="http://www.mozdev.org/">mozdev.org</a></li>
                     22: </ul>
                     23: </div>
                     24: 
1.6       axel.gru   25: 
                     26: <!--
1.1       cvs        27: <div class="infoTab" id="other-stuff">
                     28: <h5 class="infoHeader">Other Stuff</h5>
                     29: <ul>
                     30: <li>stuff goes here</li>
                     31: <li>more stuff goes here</li>
                     32: </ul>
                     33: </div>
1.6       axel.gru   34: -->
1.1       cvs        35: 
                     36: <!-- alternative image/table base tab works better in NS4 -->
                     37: <!--
                     38: <div class="infoTab" id="whats-new-image">
1.2       axel.gru   39: <h5 class="infoHeader"><img src="http://www.mozdev.org/sharedimg/whatsnew_top.gif" width="154" alt="What's New"></h5>
1.1       cvs        40: <div class="infoItems">
                     41: <div>News item goes here</div>
                     42: <div>More news item goes here</div>
                     43: <div><a href="http://mozdev.org/">mozdev.org</a></div>
                     44: </div>
                     45: </div>
                     46: -->
                     47: </div>
                     48: <!-- ***************** INFO/NEWS *************** -->
                     49: 
                     50: <!-- MAIN CONTENT -->
1.2       axel.gru   51: 
                     52: 
                     53: <a name='main'></a>
1.9       axel.gru   54: <h2 class="page-header">quickFilters :: homepage</h2>
1.2       axel.gru   55: 
1.35    ! axel.gru   56: <p>Thanks for installing quickFilters! </p>
        !            57: <p>Here is a video that shows how to set up some filters. Anybody can do it, and if you 
        !            58:    put in a few minutes to understand it you will be creating filters within seconds which are going
        !            59:    to tidy up your inbox automatically:<br>
        !            60: <iframe width="560" height="315" src="https://www.youtube.com/embed/ISheZHpACxM" frameborder="0" allowfullscreen></iframe>
1.15      axel.gru   61: 
1.35    ! axel.gru   62: <p>This extension makes it much easier to create new mail filters, by simply dragging emails into folders and let quickFilters do the "heavy lifting" 
1.15      axel.gru   63: 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
                     64: sense to show Thunderbird "what to do" by dragging one typical email manually, rather than filling in all the complicated details.
                     65: </p>
1.2       axel.gru   66: 
1.26      axel.gru   67: <a name='howToUse'> </a>
                     68: <h3>How to use quickFilters</h3>
1.2       axel.gru   69: <p>
                     70: With this, it is very easy to create new filters very quickly. 
1.20      axel.gru   71: </p>
                     72: <p>It will prefill the destination folder and other relevant fields after you have dragged the email into a different folder in the tree.
1.2       axel.gru   73: </p>
                     74: <ol>
1.13      axel.gru   75:   <li> Click on the quickFilters button on the main toolbar<br/>
                     76:   <img class="screenshot" src="img/quickFilters-ToolbarButton.png" alt="main menu: filter assistant">
1.2       axel.gru   77: 
1.13      axel.gru   78:   <li>The button will change depicting a glowing wheel instead of the mail icon and there will be sliding notification:<br/>
                     79:   <img class="screenshot" src="img/quickFilters-Notification.png" alt="filter notification" title="filter notification assistant">
1.2       axel.gru   80: 
1.19      axel.gru   81:   <li>Drag an email into a folder on the left hand folder tree. This will open the Filter Assistant screen.<br/>
                     82:   <img class="screenshot" src="img/quickFilters-Assistant-1.6.png" alt="filter wizard" title="filter wizard">
1.13      axel.gru   83:   
                     84:   <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.
                     85:   See below for a detailed description.  
                     86: 
                     87:   <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, 
                     88:   <u>based on the email that you dragged to the folder</u>:<br/>
                     89:   <img class="screenshot" src="img/filter-Rules.png" alt="filter rules">
                     90:   <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. 
                     91:   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).
                     92: 
                     93:   <li>Now tweak the filter as usual and click Ok to save it (and try it out in the Filter List)
                     94:   <li>You can also click Cancel to not create the filter
                     95:   
                     96:   <li> in the last step Thundebird's list of filters is shown. <br/>
                     97:   <img class="screenshot" src="img/filters-List.png" alt="list of filters">
1.2       axel.gru   98: 
1.13      axel.gru   99:   <li>You can repeat the process from step 2 to create more filters
1.2       axel.gru  100: 
1.13      axel.gru  101:   <li>When you're done, click the filter button again to disable "Filter Wizard" mode.
1.2       axel.gru  102: </ol>
                    103: 
1.26      axel.gru  104: <a name='assistant'> </a>
                    105: <h3>The Filter Assistant</h3>
                    106:   <p>On this screen, you select what type of information (conditions) will trigger the filter action, 
                    107:           and what kind of actions the filter will carry out. A condition is a 'fact' that applies to the 
                    108:                 incoming email, such as 'the sender is fred', 'the mail is tagged as important', 
                    109:                 'this message is more than a month old' etc. The action can be 'move message to freds folder',
                    110:                 'tag message as personal', 'set message low priority', 'mark message with a star'.</p>
                    111:                 <img src="img/quickFilters-Assistant-2.3.png" alt="quickFilters Assistant"/><br/>
                    112:                 <p>
                    113:                 The templates offered here make this a much easier and quicker process and fill prefill the 
                    114:                 new filter accordingly.</p>
                    115: 
1.13      axel.gru  116: <a name='templates'> </a>
1.4       axel.gru  117: <h3>Filter Templates</h3>
1.13      axel.gru  118: 
1.4       axel.gru  119: <p>This section describes the different patterns used to create filters based on the dragged email. 
1.2       axel.gru  120: I will probably add more templates in future, if I get good requests from the users. 
                    121: Simply head over to the <a href="bugs.html">bugs section</a> to suggest new templates.
                    122: <br/>
1.19      axel.gru  123: <div id='templates'>
                    124:        <h4>Based on Sender (from)</h4>
                    125:        <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.
                    126:        This way a whole conversation with the sender will be moved to the new folder.
                    127:        </p>
                    128:        <h4>Based on Recipient (to)</h4>
                    129:        <p>Similar to 'Based on Sender': use this when you move an email from yourself 
                    130:        to somebody else. This will retrieve the recpient's email address and paste it into 
                    131:        the from and to filter conditions fields. This way the complete conversation with 
                    132:        the contact will be moved to the new folder.</p>
                    133:        <h4>Mailing List</h4>
                    134:        <p>
                    135:        Similar to Based on Sender, but it doesn't fill the 'to' condition field.
                    136:        </p>
                    137:        <h4>Subscriptions - By Subject [Keyword]</h4>
                    138:        <p>
                    139:        This will look for special "bracketed" expressions, e.g. [amo-editors] or {Mozilla} and create a filter condition based on these; a lot of
                    140:        mass email is set up using this pattern, so it is really easy to use.
                    141:        </p>
                    142:        <h4>By Tags</h4>
                    143:        <p>
                    144:        Uses the tags of the email and adds them as filter conditions.
                    145:        </p>
                    146: </div>
1.2       axel.gru  147: 
1.26      axel.gru  148: <a name='merge'> </a>
                    149: <h3>Merging Filters</h3>
                    150: <p>This is a special screen on the filter assistant which is shown if there are already filters that carry out the same action
                    151:    as the one you want your new filter to do. It can also be invoked using the 'Merge Filters' button on the filter toolbar.
                    152:         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
                    153:         makes sure that no other filters can be merged together.</p>
                    154:         
                    155: <img src="img/NewFilter-Merge.png" alt="quickFilters Merge"/><br/>
                    156:  
1.20      axel.gru  157: 
1.26      axel.gru  158: <a name='messagesAlreadyMoved'> </a>
1.20      axel.gru  159: <h3>Mail that's already moved</h3>
1.26      axel.gru  160: 
1.20      axel.gru  161: 
                    162: <p>What if already have moved my Mails to another folder? 
                    163: Chances are that sometimes forget switching on the filter assistant, or we have already moved a lot of mail around manually.
                    164: In this case the quickFilters version 1.6 now adds a context menu to the message list:<br/>
                    165: <img src="img/contextMenu.png" alt="Creating a filter from a moved message"/><br/>
                    166: just right-click the mail you want to choose for your filter, and then click on QuickFilters: "Create Filter from Message...". 
                    167: Alternatively, simply select the message and use the "Message" menu.
                    168: </p>
                    169: 
1.28      axel.gru  170: <a name='messageFilterList'> </a>
                    171: <h3>The Message Filters List</h3>
1.2       axel.gru  172: 
1.30      axel.gru  173: <p>QuickFilters adds more functions to the filter list dialog - which becomes necessary after creating many filters was so easy.</p>
                    174: <!--<img src="img/messageFilters.png" alt="Message Filters: new features"/><br/> -->
1.25      axel.gru  175: <p>The biggest new feature here is the addition of a Search box, which allows filtering the number of results. 
1.29      axel.gru  176: I was able to submit this as a patch to Thunderbird itself and it is now part of the main product. With quickFilters,
                    177: search has many new features which can be selected with the search settings button:<br>
                    178: <img class="screenshot" src="img/extended-search.png" alt="extended search">
1.30      axel.gru  179: <ul>
                    180:   <li> Name - search the text within all filter names</li>
                    181:        <li> Target Folder - filters that move or copy to a specific folder</li>
                    182:        <li> Search Condition - all filter conditions that are text related (such as subject, body or sender)</li>
                    183:        <li> Add Tag (label) - find filters that tag messages</li>
                    184:        <li> Reply with Template - search for a template by searching subject lines</li>
                    185: </ul>
1.29      axel.gru  186: </p>
1.30      axel.gru  187: <img class="screenshot" src="img/toolbar.png" alt="toolbar">
1.28      axel.gru  188: <p>The toolbar has some useful functions that Thunderbird was missing:</p>
1.25      axel.gru  189: <ul>
1.29      axel.gru  190:   <li> Cut / copy / paste: these are designed to transfer filters from one account to another. 
1.25      axel.gru  191:             Select one ore more filters, then push cut or or copy, then select a new account (in the 'Filters for' drop down), 
                    192:                         then paste the filters to the other account.</li>
1.29      axel.gru  193:        <li> Merge filters: allows putting multiple filters into one, provided they do th same action. E.g. if two filters all
1.25      axel.gru  194:             move mails to the 'Fred' folder, you can merge them together into one filter. The assistant will ask you to select
                    195:                         the "Target" filter, which is the one that gets the conditions from the other filters. Once you confirm the "Target Filter"
                    196:                         by clicking Ok, the merged filters will be deleted.</li>
1.29      axel.gru  197:        <li> Clone filter: makes a copy of a filter in the account and opens the edit dialog so it can be modified. </li>
                    198:        <li> Sort Alphabetically - implemented by popular demand. When using this feature you have to be aware that the list order
                    199:             on screen also determines in which order the filters are executed. So if a filter on top moves a message the filter 
                    200:                         below it cannot apply any more. Therefore, some caution is advised while using this feature.</li>
                    201:        <li> Find Duplicates (Thunderbird only): This button is a powerful tool to detect filters that might do the same (and they might also be candidates for 
                    202:             the "Merge" process, as you might be able to combine them into one.
                    203:                         If duplicates are found they are shown in this drop-down: <br>
                    204:                         <img class="screenshot" src="img/find-duplicates-dropdown.png" alt="duplicates"><br>
                    205:                         Clicking an entry will automatically filter the results list to show the duplicate filters only:<br>
                    206:                         <img class="screenshot" src="img/find-duplicates-resultlist.png" alt="duplicates list"><br>
                    207:                         The context menu adds a command "Remove duplicate..." for editing the part that makes this filter a duplicate. 
                    208:                         Alternatively you can select both filters and try the "Merge" button.
                    209:                         </li>
1.25      axel.gru  210:        <li> Filter assistant mode toggle: once this is active, quickFilters will listen for manual mail movement and tagging emails. 
                    211:             If any of these actions occur, the assistant is started so that a filter can be created based on this action</li>
                    212:        <li> The Support Site button opens this page. </li>
                    213:        <li> The wrench button displays quickFilters global preferences. </li>
                    214: </ul>
1.2       axel.gru  215: <p>Also you can now move the filter to the top of the bottom of the list. This is actually significant as the 
                    216: order you see on screen is the same as the order in which the filters are executed. This also means, if a filter
                    217: on the top moves a message from the inbox then the filters below will not get a chance to execute on this message;
                    218: as the filters are only executed on messages in the inbox, they will simply be ignored. Therefore it is very important 
                    219: that it remains easy to re-order the relative positions of the filters. This also works while the search box is active.</p>
1.4       axel.gru  220: 
1.28      axel.gru  221: <a name='options'> </a>
                    222: <h3>Preferences Dialog</h3>
                    223: 
1.31      axel.gru  224: <p>Options Tab - sets global preference of quickFilters. </p>
1.28      axel.gru  225: <img src="img/quickFilters-Options.png" alt="quickFilters Preferences"/><br/>
                    226: 
                    227: <ul>
                    228:   <li>Exit Filter Assistant after a filter has been created. Default:on.</li>
                    229:   <li>Automatically start Filter Assistant mode with application. If you want to full automate all mail movement
                    230:            then you would activate this option and keep quickFilters paying attention to anything you do manually.
1.31      axel.gru  231:            Default: off.</li>
1.28      axel.gru  232:   <li>Display Toolbar in Filter Manager. I highly recommend leaving it on as it gives you extra options (Merge, Clone). 
1.31      axel.gru  233:            Default: on.</li>
                    234:        <li>Listen for Tag changes. The Assistant will detect if a message is tagged manually.</li>
1.32      axel.gru  235:        <li>Support quick move feature - the Assistant will be triggered when Postbox' "quick move" is used.</li>
1.31      axel.gru  236: <ul>
1.33      axel.gru  237: <h4 class="header">Naming Rules</h4>
1.31      axel.gru  238: <p>quickFilters automatically generates filter names, so it is important to be consistent:</p>
                    239: </ul>
                    240:        <li>Disable two-way address conditions - by default the templates "Based on Sender" and "Based on Recipient" 
                    241:            will fill in two conditions, from XXX and to XXX. This is so whole conversations can be filtered 
                    242:                        (including your personal replies) and moved to a folder. This is especially helpful when using 
                    243:                        the "Copy Sent to Current" addon, and avoids messages being "orphaned" in the Sent Mail folder.</li>
1.28      axel.gru  244:   <li>Add parent folder name. Default:on.</li>
                    245:   <li>Add rule specific key word. Default:off.</li>
1.31      axel.gru  246:        <li>Append to name of cloned filter - to avoid confusion when creating multiple versions of the same filter. Default: "(copy)"</li>
1.28      axel.gru  247: </ul>
1.31      axel.gru  248: <p>Debug Mode: Use this for trouble shooting. With this option enabled quickFilters will print information in the Javascript Console.
                    249: The console can be shown via tools &gt; error console. Additional log detail can be switched on via right-click on the checkbox.</p>
1.28      axel.gru  250: 
                    251: 
1.4       axel.gru  252: 
                    253: <h3><a name="other">My other Extensions - highly recommended</a></h3>
                    254: <br/>
                    255: 
1.17      axel.gru  256: <div id='myProjects'>
                    257:        <h4 class="QuickFolders"><a href="https://addons.mozilla.org/en-US/thunderbird/addon/quickfolders-tabbed-folders/">QuickFolders</a></h4>
                    258:        <p>
                    259:        <a href="https://addons.mozilla.org/en-US/thunderbird/addon/quickfolders-tabbed-folders/">QuickFolders</a>
                    260:        (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>
                    261:        </p>
                    262: 
                    263:        <h4 class="ZombieKeys"><a href="https://addons.mozilla.org/en-US/firefox/addon/zombie-keys/">Zombie Keys</a></h4>
                    264:        <p>
                    265:        <a href="https://addons.mozilla.org/en-US/firefox/addon/zombie-keys/">Zombie Keys for Firefox / SeaMonkey</a> ; 
                    266:        <a href="https://addons.mozilla.org/en-US/thunderbird/addon/zombie-keys/">Zombie Keys for Thunderbird / Postbox</a>
                    267:        <br>
                    268:        <p>Entering European languages (which include diacritics (accented characters, diaeresis, umlauts, etc.), ligatures, the Euro sign, etc.) 
                    269:        into Mozilla applications using a non-native keyboards doesn't have to be a pain any more! 
                    270:        </p>
                    271: 
                    272:        <h4 class="QuickPasswords"><a href="https://addons.mozilla.org/en-US/firefox/addon/quickpasswords">QuickPasswords</a></h4>
                    273:        <p>
                    274:        <a href="https://addons.mozilla.org/en-US/firefox/addon/quickpasswords">QuickPasswords for Firefox / SeaMonkey</a>;
                    275:        <a href="https://addons.mozilla.org/en-US/thunderbird/addon/quickpasswords">QuickPasswords for Thunderbird / Postbox</a>
                    276:        <br>
                    277:        this is a very neat and quick way to retrieve and use a growing number
                    278:        of passwords, without displaying them on screen or having to re-type them. 
                    279:        Also supports renaming of multiple passwords!
                    280:        </p>
                    281: </div>
1.4       axel.gru  282: 

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