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

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

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