The attached add-on files may be out of date. Please visit Devot-ee for the latest versions.
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. Allows you to specify weblog 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 weblog “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 weblog="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