rss_unlimited_categories

The rss_unlimited_categories plugin enables you to assign an unlimited number of categories to an article so that you’re not limited to the default number allowed by Textpattern (2).

The plugin will add a multiple select list to your article -> write tab to enable the selection of unlimited categories. It also includes several public side tags to display the categories and list articles by category.

Installation and Setup

1. Simply install and enable the plugin. The plugin will automatically install a new table that relates articles to categories.
2. Navigate to the article -> write tab and you’ll find a new multiple select list above the standard Textpattern category selection.
3. For existing sites, you can copy your current article/category assignments to the new category table structure using the following SQL statements:

INSERT INTO textpattern_category (article_id, category_id) SELECT t.id, c.id FROM textpattern t LEFT JOIN txp_category c on t.category1 = c.name where c.type = 'article' and t.category1 != '';


INSERT INTO textpattern_category (article_id, category_id) SELECT t.id, c.id FROM textpattern t LEFT JOIN txp_category c on t.category2 = c.name where c.type = 'article' and t.category2 != '';

Public Site Tags

The collection of public site tags include:

rss_unlimited_categories_filedunder – Lists all categories assigned to the current article.
rss_unlimited_categories_cloud – Displays a weighted list of all categories as a tag cloud.
rss_unlimited_categories_list – Displays a list of all categories with the number of posts in each.
rss_unlimited_categories_article_list – Lists articles by category. This is a replacement for the standard Textpattern article list tags.
rss_unlimited_categories_related – Lists related articles by category. This is a replacement for the standard Textpattern related article tag that uses the unlimited category tables instead of the standard Textpattern category 1 and 2 fields.
rss_sct_permlink – Builds a permlink in /section/category/title format. This is used exactly as the standard Textpattern permlink tag.

All of the tags use the new category table created by this plugin instead of the standard Textpattern category 1 and 2 fields.

rss_unlimited_categories_filedunder

Lists all categories assigned to the current article.

section
Accepts a comma separated list of sections that posts are listed from. NO spaces after commas.
Wildcards and negatives can also be used when specifying sections. For instance, section=”*” (all sections, regardless of how many), section=”!photos,writing,thoughts” (writing AND thoughts AND NOT photos), or just section=”!photos” (all sections except photos).
Default: “article”
Example: section=“sectionOne,sectionTwo”

linktosection
The section used for category links.
Default: “article”
Example: linktosection=“10”

usemessy
Use messy (/section/?c=category) URLs instead of clean (/section/category) URLs for category links..
Default: “0”
Example: usemessy=“1”

listwraptag
The HTML tag that wraps the label and category list.
Default: “”
Example: listwraptag=“div”

wraptag
The HTML tag that wraps the category list.
Default: “”
Example: wraptag=“ul”

class
The class attribute on the wraptag.
Default: “”
Example: class=“catlist”

break
HTML/text that wraps/separates each element in the list.
Default: “, “
Example: break=“li”

breakclass
The maximum number of live search results returned.
Default: “”
Example: breakclass=“catelement”

label
A label that appears before the list.
Default: “”
Example: label=“File under: “

labeltag
The HTML tag that wraps the label.
Default: “”
Example: labeltag=“h4”

sortdir
The direction the category names are sorted in. Valid choices include “asc” and “desc”.
Default: “asc”
Example: sortdir=“desc”

rss_unlimited_categories_cloud

Displays a weighted list of all categories as a “cloud”.

section
Accepts a comma separated list of sections that posts are listed from. NO spaces after commas.
Wildcards and negatives can also be used when specifying sections. For instance, section=”*” (all sections, regardless of how many), section=”!photos,writing,thoughts” (writing AND thoughts AND NOT photos), or just section=”!photos” (all sections except photos).
Default: “article”
Example: section=“sectionOne,sectionTwo”

time
Accepts one of 3 options “past”, “future” or “any”. By default (past) will display articles with a posted date before the current date/time.
Selecting FUTURE will display articles with a posted date after the current date/time. Selecting ALL will display all articles regardless of posted date.
Default: “past”
Example: time=“any”

limit
The maximum number of categories returned.
Default: “999”
Example: limit=“5”

parent
The maximum number of live search results returned.
Default: “”
Example: parent=“mycategory”

linktosection
The section used for category links.
Default: “article”
Example: linktosection=“archive”

usemessy
Use messy (/section/?c=category) URLs instead of clean (/section/category) URLs for category links..
Default: “0”
Example: usemessy=“1”

cloudwraptag
The HTML tag that wraps the label and category list.
Default: “”
Example: cloudwraptag=“div”

wraptag
The HTML tag that wraps the category list.
Default: “p”
Example: wraptag=“ul”

class
The class attribute on the wraptag.
Default: “”
Example: class=“catlist”

break
HTML/text that wraps/separates each element in the list.
Default: “, “
Example: break=“li”

breakclass
The maximum number of live search results returned.
Default: “”
Example: breakclass=“catelement”

label
A label that appears before the list.
Default: “”
Example: label=“File under: “

labeltag
The HTML tag that wraps the label.
Default: “”
Example: labeltag=“h4”

sortdir
The direction the category names are sorted in. Valid choices include “asc” and “desc”.
Default: “asc”
Example: sortdir=“desc”

rss_unlimited_categories_list

Displays a list of all categories with the number of posts in each.

section
Accepts a comma separated list of sections that posts are listed from. NO spaces after commas.
Wildcards and negatives can also be used when specifying sections. For instance, section=”*” (all sections, regardless of how many), section=”!photos,writing,thoughts” (writing AND thoughts AND NOT photos), or just section=”!photos” (all sections except photos).
Default: “article”
Example: section=“sectionOne,sectionTwo”

time
Accepts one of 3 options “past”, “future” or “any”. By default (past) will display articles with a posted date before the current date/time.
Selecting FUTURE will display articles with a posted date after the current date/time. Selecting ALL will display all articles regardless of posted date.
Default: “past”
Example: time=“any”

parent
The maximum number of live search results returned.
Default: “”
Example: parent=“mycategory”

linktosection
The section used for category links.
Default: “article”
Example: linktosection=“archive”

showcount
Displays the number of posts in each category.
Default: “1”
Example: showcount=“0”

listwraptag
The HTML tag that wraps the label and category list.
Default: “”
Example: listwraptag=“div”

wraptag
The HTML tag that wraps the category list.
Default: “ul”
Example: wraptag=“p”

class
The class attribute on the wraptag.
Default: “”
Example: class=“catlist”

break
HTML/text that wraps/separates each element in the list.
Default: “li”
Example: break=”, “

breakclass
The maximum number of live search results returned.
Default: “”
Example: breakclass=“catelement”

label
A label that appears before the list.
Default: “”
Example: label=“File under: “

labeltag
The HTML tag that wraps the label.
Default: “”
Example: labeltag=“h4”

sortdir
The direction the category names are sorted in. Valid choices include “asc” and “desc”.
Default: “asc”
Example: sortdir=“desc”

rss_unlimited_categories_article_list

Lists articles by category. This is a replacement for the standard Textpattern article list tags that uses the unlimited category tables instead of the standard Textpattern category 1 and 2 fields.

section
Accepts a comma separated list of sections that posts are listed from. NO spaces after commas.
Wildcards and negatives can also be used when specifying sections. For instance, section=”*” (all sections, regardless of how many), section=”!photos,writing,thoughts” (writing AND thoughts AND NOT photos), or just section=”!photos” (all sections except photos).
Default: “article”
Example: section=“sectionOne,sectionTwo”

category
Accepts a comma separated list of categories. NO spaces after commas. If currently browsing by category, the global category will be used as the default.
Default: “$c” (global category)
Example: category=“5”

form
The article form used in the article list.
Default: “default”
Example: form=“myform”

limit
The maximum number of articles returned.
Default: “999”
Example: limit=“5”

offset
Excludes x number of articles from the beginning of the article listing.
Default: “0”
Example: offset=“1”

time
Accepts one of 3 options “past”, “future” or “any”. By default (past) will display articles with a posted date before the current date/time.
Selecting FUTURE will display articles with a posted date after the current date/time. Selecting ALL will display all articles regardless of posted date.
Default: “past”
Example: time=“any”

sortdir
The direction the category names are sorted in. Valid choices include “asc” and “desc”.
Default: “asc”
Example: sortdir=“desc”

sortby
The field the articles are sorted by. Valid choices include any field on the textpattern table such as “ID” or “title”.
Default: “uPosted”
Example: sortby=“title”

rss_unlimited_categories_related

Lists related articles by category. This is a replacement for the standard Textpattern related article tag that uses the unlimited category tables instead of the standard Textpattern category 1 and 2 fields.

section
Accepts a comma separated list of sections that posts are listed from. NO spaces after commas.
Wildcards and negatives can also be used when specifying sections. For instance, section=”*” (all sections, regardless of how many), section=”!photos,writing,thoughts” (writing AND thoughts AND NOT photos), or just section=”!photos” (all sections except photos).
Default: “article”
Example: section=“sectionOne,sectionTwo”

form
The article form used in the article list.
Default: “default”
Example: form=“myform”

limit
The maximum number of articles returned.
Default: “999”
Example: limit=“5”

offset
Excludes x number of articles from the beginning of the article listing.
Default: “0”
Example: offset=“1”

time
Accepts one of 3 options “past”, “future” or “any”. By default (past) will display articles with a posted date before the current date/time.
Selecting FUTURE will display articles with a posted date after the current date/time. Selecting ALL will display all articles regardless of posted date.
Default: “past”
Example: time=“any”

sortdir
The direction the category names are sorted in. Valid choices include “asc” and “desc”.
Default: “asc”
Example: sortdir=“desc”

sortby
The field the articles are sorted by. Valid choices include any field on the textpattern table such as “ID” or “title”.
Default: “uPosted”
Example: sortby=“title”

rss_sct_permlink

Build article permlinks in /section/category/title format. Use as a replacement for the <txp:permlink/> tag.

For example: <txp:rss_sct_permlink><txp:title/></txp:rss_sct_permlink>