devot:eeDevoted to ExpressionEngine

This plugin allows you to find needed item by parsing numbers in url_titles.

PARAMETERS:

1) item - Required. Possible values are integers starting from “1”.

2) category - Optional. Allows you to specify category id. Pipe character and “not”
aren’t supported.

3) weblog - Optional (for EE1.x only). Allows you to specify weblog short name. Pipe character and “not”
aren’t supported.

3) channel - Optional (for EE2.0+ only). Allows you to specify channel short name. Pipe character and “not”
aren’t supported.

4) site - Optional. Default value is “1”.

5) orderby - Optional. Possible values are “date” and “title”. Default is “date”.
Use this parameter together with “if_not_found” parameter.

6) if_not_found - Optional. Possible values are “none”, “first” and “last”. If
the value is “none”, then in case needed item was not found, the variable
{item_finder_url_title} will output nothing. If the value is “first”, then
in such case it will output url_title of the first entry. If the value is “last”, then
in such case it will output url_title of the last entry.

VARIABLES:

1) {item_finder_url_title} - will output url_title of the entry containing item specified in parameters.

EXAMPLE OF USAGE:

Say you have channel “articles” in which there are several entries
posted into category “technical”, whose url_titles are as follows:

articles_15_20
article_21
article_22_24
articles_24_26
article_27

Now suppose you need to display entry containing article 25.

In order to achieve this you will need to write such code:

{exp:item_finder channel="articles" category="technical" item="25" orderby="date" if_not_found="first" parse="inward"}
{redirect="my_template_group/my_template/{item_finder_url_title}/"}
{/exp:item_finder} 

{item_finder_url_title} will output “articles_24_26” and needed entry
will be displayed.

INCORRECTLY FORMED URL TITLES

Some url_titles are considered incorrectly formed and are not parsed by the plugin. Those
are url_titles in which:

1) some number is equal to zero

2) some number contain leading zero

3) there are more than two numbers

4) second number is bigger than the first