modules/taxonomy_sifter/taxonomy_sifter.help

<!-- $Id: taxonomy_sifter.help,v 1.1.4.2 2008/11/15 12:46:19 tbarregren Exp $ -->
<p><a href="http://drupal.org/project/taxonomy_sifter">Taxonomy Sifter</a> is a Drupal module that provides a block with terms which <em>any</em> or <em>all</em> selected must apply to a node for it to be listed when viewing a taxonomy term page, e.g. <code>taxonomy/term/...</code> The vocabularies used in the block is configurable.</p><!--break-->
<p>Taxonomy Sifter is developed by <a href="/user/16678">Thomas Barregren</a> at  <a href="http://drupal.org/node/131670">imBridge</a> and <a href="http://drupal.org/user/101412">Nancy Wichmann</a>. The initial development was sponsored by <a href="http://www.sspa.se/">SSPA Sweden</a>.
<h3>Background</h2>
<p>Given the path <code>taxonomy/term/...</code>, where <code>...</code> is the identity number of a taxonomy term, Drupal responds by dynamically building a page with teasers of nodes with the given term applied to them. Often, more than just one term is applied to a node. By combining several terms with either the OR operator (<code>+</code>) or the AND operator (<code>,</code>) the returned teasers will correspond to nodes with <em>any</em> or <em>all</em>, respectively, of the terms applied. For further explanation, see the <a href="http://drupal.org/node/22273">handbook</a>.</p>
<p>There are several modules that leverage this feature by providing a block with a user friendly interface for combining the terms. Some examples are <a href="http://drupal.org/project/refine_by_taxo">Refine by taxonomy</a>, <a href="http://drupal.org/project/taxonomy_filter">Taxonomy Filter</a> and <a href="http://drupal.org/project/ubrowser">uBrowser</a>. These modules works as filters which can be refined step-by-step. But, once the taxonomy term page is left, for instance by viewing a node sorted out by the filter, the filter is reset. That is often the desired behaviour. But if the purpose of the filter is to provide a short-list of nodes to be reviewed, it can be very frustrating to reapply the refinement over and over again.</p>
<p>To this end Taxonomy Sifter provides a block where the user can select terms that automatically will be combined with the terms in every request of the form <code>taxonomy/term/...</code> The selected terms are combined with the same operator already used in the request. If no operator is used, that is a single term is given, the sifter use the operator given in the module's settings. The vocabularies of the terms presented in the sifter block is also configurable.</p>
<h3>Configuration</h3>
<p>Configure Taxonomy Sifter as follows:</p>
<ol>
<li>On <a href="/admin/build/block">admin/build/block</a>, click on the <a href="admin/build/block/configure/taxonomy_sifter/0">configure link</a> for the Taxonomy Sifter block.</li>   
<li>In the <em>Taxonomy Sifter Settings</em>, select one or more vocabularies and the default operator.</li>
<li>In the <em>Page specific visibility settings</em>, choose the alternative <em>Show on only the listed pages</em> and put <code>taxonomy/term/*</code> in the <em>Pages</em> text area.</li>
<li>Press the <em>Save block</em> button.</li>
<li>Enable the Taxonomy Sifter block by choosing a region.</li>
</ol>
<h3>Usage</h3>
<p>The Taxonomy Sifter block appears on taxonomy term(s) listing pages.</p>
<p>If no terms are selected in the Taxonomy Sifter block, the listing contains all nodes that are tagged with the term(s) indicated in the URL. For an example, on <a href="/taxonomy/term/1">taxonomy/term/1</a>, all nodes tagged with the term with the term id <code>1</code> is listed.</p>
<p>If terms are selected in the Taxonomy Sifter block, the listing contains all nodes that are tagged with the term(s) indicated in the URL as well as the terms selected in the Taxonomy Sifter block.</p>
<p>If the URL contains more than one term, the terms in the URL and the term(s) selected in the Taxonomy Sifter block are combined with the operator (<code>,</code>/<code>+</code>) used in the URL.</p>
<p>If the URL contains a single term, the term in the URL and the term(s) selected in the Taxonomy Sifter block are combined with the Taxonomy Sifter default operator configured as described above.</p>
1	<!-- $Id: taxonomy_sifter.help,v 1.1.4.2 2008/11/15 12:46:19 tbarregren Exp $ -->
2	<p><a href="http://drupal.org/project/taxonomy_sifter">Taxonomy Sifter</a> is a Drupal module that provides a block with terms which <em>any</em> or <em>all</em> selected must apply to a node for it to be listed when viewing a taxonomy term page, e.g. <code>taxonomy/term/...</code> The vocabularies used in the block is configurable.</p><!--break-->
3	<p>Taxonomy Sifter is developed by <a href="/user/16678">Thomas Barregren</a> at <a href="http://drupal.org/node/131670">imBridge</a> and <a href="http://drupal.org/user/101412">Nancy Wichmann</a>. The initial development was sponsored by <a href="http://www.sspa.se/">SSPA Sweden</a>.
4	<h3>Background</h2>
5	<p>Given the path <code>taxonomy/term/...</code>, where <code>...</code> is the identity number of a taxonomy term, Drupal responds by dynamically building a page with teasers of nodes with the given term applied to them. Often, more than just one term is applied to a node. By combining several terms with either the OR operator (<code>+</code>) or the AND operator (<code>,</code>) the returned teasers will correspond to nodes with <em>any</em> or <em>all</em>, respectively, of the terms applied. For further explanation, see the <a href="http://drupal.org/node/22273">handbook</a>.</p>
6	<p>There are several modules that leverage this feature by providing a block with a user friendly interface for combining the terms. Some examples are <a href="http://drupal.org/project/refine_by_taxo">Refine by taxonomy</a>, <a href="http://drupal.org/project/taxonomy_filter">Taxonomy Filter</a> and <a href="http://drupal.org/project/ubrowser">uBrowser</a>. These modules works as filters which can be refined step-by-step. But, once the taxonomy term page is left, for instance by viewing a node sorted out by the filter, the filter is reset. That is often the desired behaviour. But if the purpose of the filter is to provide a short-list of nodes to be reviewed, it can be very frustrating to reapply the refinement over and over again.</p>
7	<p>To this end Taxonomy Sifter provides a block where the user can select terms that automatically will be combined with the terms in every request of the form <code>taxonomy/term/...</code> The selected terms are combined with the same operator already used in the request. If no operator is used, that is a single term is given, the sifter use the operator given in the module's settings. The vocabularies of the terms presented in the sifter block is also configurable.</p>
8	<h3>Configuration</h3>
9	<p>Configure Taxonomy Sifter as follows:</p>
10	<ol>
11	<li>On <a href="/admin/build/block">admin/build/block</a>, click on the <a href="admin/build/block/configure/taxonomy_sifter/0">configure link</a> for the Taxonomy Sifter block.</li>
12	<li>In the <em>Taxonomy Sifter Settings</em>, select one or more vocabularies and the default operator.</li>
13	<li>In the <em>Page specific visibility settings</em>, choose the alternative <em>Show on only the listed pages</em> and put <code>taxonomy/term/*</code> in the <em>Pages</em> text area.</li>
14	<li>Press the <em>Save block</em> button.</li>
15	<li>Enable the Taxonomy Sifter block by choosing a region.</li>
16	</ol>
17	<h3>Usage</h3>
18	<p>The Taxonomy Sifter block appears on taxonomy term(s) listing pages.</p>
19	<p>If no terms are selected in the Taxonomy Sifter block, the listing contains all nodes that are tagged with the term(s) indicated in the URL. For an example, on <a href="/taxonomy/term/1">taxonomy/term/1</a>, all nodes tagged with the term with the term id <code>1</code> is listed.</p>
20	<p>If terms are selected in the Taxonomy Sifter block, the listing contains all nodes that are tagged with the term(s) indicated in the URL as well as the terms selected in the Taxonomy Sifter block.</p>
21	<p>If the URL contains more than one term, the terms in the URL and the term(s) selected in the Taxonomy Sifter block are combined with the operator (<code>,</code>/<code>+</code>) used in the URL.</p>
22	<p>If the URL contains a single term, the term in the URL and the term(s) selected in the Taxonomy Sifter block are combined with the Taxonomy Sifter default operator configured as described above.</p>