This plugin creates lists of custom field information in the form of sidebar widgets.
You can define several custom field names for a post. The values of these custom field names will be taken from the data base like they were arranged in columns side by side. All the values will be sorted by one of these columns. You can choose which column resp. custom field name should be the sort criterion. Further it is possible to hide this column (which should be decisive for the sorting) in the list in the sidebar.
Example: An easy to understand example is probably a list of posts which are categorized by special dates. In this example the custom field names are "realdate" and "datename". As "realdate" you set good sortable text strings or numbers like 20091005 (consists of year, month, day) and as "datename" you can set e.g. "October 2009" which is probably not in the same way sortable as the numbers. This way you can of course build probably more useful lists. A more colourful case of use which works this way is probably if you make list of posts grouped by a none-Gregorian calendar. You can use as datenames e.g. names of months and years of the Chinese calendar. In this example the "datenname"s would be the main list elements and the post titles sub elements of them. The "realdate" would be hidden via the option "hide this".
If you want to create a more sub-divided list (instead of "datename" something like "year", "month", "day") then you should keep an eye on the right hierarchy order. (e.g. 0. "realdate" (sort by / hide this), 1. "year", 2. "month", 3. "day"). The post titles will be sub elements of "day" and "day" will be sub elements of the months and so on - in the list in the side bar widget. (But for this special case there other plugins like Collapsing Archives)
Other and even better examples (in English) are the book lists at the weblog of Larry Wilson. He makes list of the books he has read.
There are some basic things you should be aware of: * Overall you can use 5 hierarchical levels (if you want to have more then write me an email). * Every post you want to have in the sidebar list should have the same custom field names (The custom field values can differ from post to post.) * The custom field name which should be excluded from the list should be the first or the last in the list on the widgets page (on the admin site).
You can influence which word the last word is by using a underline character between the words. If you make a underline character between two words it will be seen as one word.
names with more than one first and family name Jon Jake Stewart Brown the last word is Brown Jon Jake Stewart_Brown the last word is "Stewart Brown"
The underline character will not displayed in the sidebar.
Since v1.0 all click-able drop down menu elements have the class "customfieldlist_opt_link" so you can adapt the appearance of these elements easier.
The speed of the show/hide effects and the hide/show characters are changeable via the settings page of the plugin. The settings on this page are for all the widgets of this plugin.