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

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

FreeBSD-CVSweb <>