Ignore the Categories tab

n: smd_write_cats | v: 0.30 | f: /

Documentation for the Textpattern plugin smd_write_cats by Stef Dawson follows this short message from our sponsor ;-)

Plugin list button Plugin download button Compressed plugin download button

smd_write_cats

Add article, image, file or link categories directly when creating content, without having to visit the Categories tab first.

Installation / uninstallation

Requires Textpattern CMS 4.4.1+

Download the plugin from either textpattern.org, or the software page, paste the code into the Txp Admin->Plugins panel, install and enable the plugin. Visit the forum thread for more info or to report on the success or otherwise of the plugin.

To uninstall, delete from the Admin->Plugins page.

Usage

Type a comma-separated list of category titles into the Or new categories box and when you hit Save or Publish they will be created if they don’t already exist.

You can create as many as you like; just keep comma-separating them. On the Write panel, only the first two will be automatically assigned to the article; replacing any categories that were already assigned. If one or both of the first two category titles you type already exists they will be assigned to the article (it ignores the case when checking the database for matches, but the category title will be created exactly as you typed it). The plugin functions in a similar manner on the Images, Files and Links panels, except only the first category will be assigned.

For articles, if you want to set Category 2 only, just start your list with a comma, e.g. , My new category. If for some reason you want to create more categories but don’t want to assign them to the current article, put two commas at the start: , , Some unlinked category, And another. The same goes for the other content types, but you only need to specify one empty comma.

Parent categories

By default all categories you create will be stored under the ‘root’ of the category tree. If you wish to assign your new category beneath an existing category you can specify an alternative syntax:

Parent category -> New category

If the designated parent category title exists, your new category will be assigned to it. If it doesn’t exist (the plugin ignores the case of the parent category title) then it will be assigned to root. IMPORTANT: although the case doesn’t matter, the parent must match your category Title (not-its-sanitized-name) for it to be assigned beneath it.

You can customize the mechanism for supplying parent-child relationships by creating the following prefs (smd_prefalizer can help here):

Pref name Value Visiblity Event Notes
smd_write_cats_child_first 0=parent first 1=child first Hidden smdwritecats Setting this to 1 means that you specify the new category first and then specify the parent you want it assigned to
smd_write_cats_parent_delim any string Hidden smdwritecats Overrides the default ->. Whatever you specify here will be used as a parent/child delimiter. Be careful to choose something that would not normally be used in a category name!

If you create a new category, you may use that category as a parent in subsequent category declarations. For example:

Fruit, Fruit->Apple

will create the category Fruit (at the root of the tree) and assign it to Category1. It will then create Apple beneath the Fruit category, and assign it to Category2.

Author / credits

Written by Stef Dawson

Changelog

  • 06 Jul 2010 | 0.10 | Initial release
  • 11 Jul 2010 | 0.20 | Added parent->child ability ; fixed ‘article’ type selection (thanks monkeyninja/Uli) ; made tests case insensitive to prevent duplicate cats being created ; prevented ‘root’ being added to category1/2 ; added edit class to input box and made sure only people who have category privs can create them (thanks Uli)
  • 13 Jun 2012 | 0.30 | Extended for image, file and link categories ; made parent category assignment more lenient to case (both thanks MattD)

Source code

If you’d rather wander aimlessly through thousands of lines of PHP source code, you’ll need to step into the view source page.

Legacy software

If, for some inexplicable reason, you need a prior version of a plugin, it can probably be found on the plugin archive page.

Experimental software

If you’re feeling brave, or fancy skateboarding into volcanos, you can test out some of my beta code. It can be found on the plugin beta page.