Simple Draft List

You would use this option is you wished to display the list outside of a page or post - e.g. in a sidebar. To display the list you will need to insert the following code, where appropriate, into your theme…

<?php draft_list( 'template', 'parameters' ); ?>

Where template is a default layout (see Templates section below) and parameters is an optional list of parameters, each seperated by an ampersand (&)

The following parameters are valid...

• limit= : The maximum number of draft items to display. The default is 0, which is unlimited.
• type= : This allows you to limit the results to either post or page. The default is both.
• order= : This is the sequence that you'd like to order the results in. It consists of 2 codes - the first is either t, m or c to represent the title, modified date or created date and the second is a or d for ascending or descending. Therefore order=td will display the results in descending title sequence. The default is descending modified date.
• scheduled= : If specified as No then scheduled posts will not display in the list, only drafts.
• folder= : The scheduled icon will be, by default, the one in the plugin folder named scheduled.png. However, use this parameter to specify a folder within your theme that you'd prefer the icon to be fetched from.
• cache= : How long to cache the output for, in hours. Defaults to half an hour. Set to No to not cache at all. Whenever you save a post any cache will be cleared to ensure that any lists are updated.
• template= : This is the template which formats the output. See the section below on * *Templates** for further information.
• date= : The format of any dates output. This uses the PHP date formatting system - read here for the formatting codes. Defaults to F j, Y, g:i a.

To restrict the posts/pages to a particular timeframe you can use the following 2 parameters. You simply state, in words, how long ago the posts must be dated for e.g. "2 days", "3 months", etc.

• modified= : This reflects how long ago the post/page must have been modified last for it to be listed. For example 6 months would only list drafts that have been modified in the last 6 months.
• created= : his reflects how long ago the post/page must have been created for it to be listed. For example 6 months would only list drafts that were created in the last 6 months.

The plugin will then display details of each draft item, depending on the parameters and template used.

An example would be...

<?php draft_list( '%ul%%draft% %icon%', 'limit=5&type=post&order=ma' ); ?>

This would display a list of up to 5 draft posts in ascending modified date sequence, with an icon displayed to the right of each if the draft is scheduled.

The following is an example of how it could be used in the sidebar, with a function_exists check so that it doesn't cause problems if the plugin is not active...

<?php if ( function_exists( 'draft_list' ) ) : ?>
<h2>Coming Soon</h2>
<?php draft_list( '%ul%%draft% %icon%', 'limit=5&type=post&order=ma' ); ?>
<?php endif; ?>