List Manager Plugin v1.7 Released

Yes, it’s true: I have released a new version of the WordPress List Manager. Version 1.7 offers three new features based on the new list attributes tag.

List Attributes

Patrick — a WordPress user just like you and I– suggested in an email to me the idea that date and time of when a list was last updated/modified should be made available. So, there you have it, you can now let users automatically know when the list was last modified/updated. This was slightly more difficult than I had originally anticipated but instead of hacking it, I decided to introduce the new custom tag which can be used inside posts and pages. This new functionality now paves the way for easy future additions.

To use this new functionality, in your posts or pages, simply add the following custom tag where ever you would like to insert the date/time.

<list id="#" attribute="lastmodified" format="g:ia" gmt="false" />

  • id: just like the normal list tag, we need to know which list we are dealing with.
  • attribute: we need to know what attribute we’re looking for, so set this to lastmodified or lastupdated (same thing).
  • format: if you omit this tag, it will automatically grab the default WordPress values, otherwise use the PHP date() syntax to specify the format. (optional)
  • gmt: if you want to display gmt instead, set this value to true. defaults to false. (optional)

Of course the custom tag is based off the new API method available — in case you prefer to use this functionality directly within PHP:

<?php wplists_last_modified( $list_id, $format = "", $gmt = false, $echo = true ); ?>

List Count

In addition to the “lastmodified” attribute, there are two more attributes available: count and countchecked. Basically, just like above, you can embed the following tags anywhere in your post or pages:

  • <list id="#" attribute="count" />
    • returns the total number of items in the list
  • <list id="#" attribute="countchecked" />
    • returns the number of items checked or crossed off in the list

Again, this functionality, is built off the following API methods:

<?php wplists_count_total( $list_id, $echo = true ); ?>

<?php wplists_count_checked( $list_id, $echo = true ); ?>

Documentation

Also, I have taken the time to basically clean up the “documentation” so its much easier to understand and use this plugin overall. This was suggested by Lorelle regarding on how to import lists. Therefore, I changed the “Example Usage” layout in order to answer specific questions regarding how to use the plugin. I hope things are much more clear.

As always, if there are any feature suggestions or bug reports, please do not hesitate to contact me.

Adieu. Navid.


About this entry