David Artiss

If you’re upgrading from a previous release of Draft List (i.e. pre version 2.5) please check out the FAQ – a number of changes have been made in this release that you need to be aware of
Draft List allows you to both manage your draft and scheduled posts more easily but also to promote them by showing them on your site via shortcode or widget – use it to show your visitors what’s “coming soon” or as a great SEO tool.
How easy is it display a list of draft posts? Here’s an example of how you could use it in a post or page…
<pre><code>[drafts limit=5 type=post order=ma scheduled=no template='{{ul}}{{draft}} {{icon}}']
</code></pre>
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.
Key features include…
<ul>
<li>Both widgets and shortcodes are available for you to show off your up-coming content</li>
<li>Output is highly configurable – create your own look by using a template, identify scheduled posts with an icon, sequence the results in various ways and even narrow down the results to a specific timeframe</li>
<li>Click on any of the drafts posts listed to edit them</li>
<li>A meta box in the editor screen allows you to omit individual posts from any list outputs</li>
<li>Tested up to PHP 8.2</li>
<li>Fully complies with WordPress coding standards</li>
<li>Compliant with the stronger <a href="https://wpvip.com/" rel="nofollow ugc">WordPress VIP</a> coding standards, as well as compatibility with their platform</li>
<li>Community plugin – visit the <a href="https://github.com/dartiss/draft-list" title="Github" rel="nofollow ugc">Github page</a> to get involved with the latest code development, request enhancements and report issues</li>
</ul>
Iconography is courtesy of the very talented <a href="https://www.fiverr.com/jankirathore" rel="nofollow ugc">Janki Rathod</a>.
<h3>Shortcode Parameters</h3>
The following shortcode parameters are valid…
<ul>
<li>cache= : How long to cache the output for, in hours. Defaults to half an hour. Set to <code>No</code> to not cache at all. Whenever you save a post any cache will be cleared to ensure that any lists are updated.</li>
<li>date= : The format of any dates output. This uses the PHP date formatting system – <a href="http://uk3.php.net/manual/en/function.date.php" title="date" rel="nofollow ugc">read here</a> for the formatting codes. Defaults to <code>F j, Y, g:i a</code>.</li>
<li>folder= : The scheduled icon will be, by default, the one in the plugin folder named <code>scheduled.png</code>. However, use this parameter to specify a folder within your theme that you’d prefer the icon to be fetched from.</li>
<li>limit= : The maximum number of draft items to display. The default is 0, which is unlimited.</li>
<li>order= : This is the sequence that you’d like to order the results in. It consists of 2 codes – the first is either <code>t</code>, <code>m</code> or <code>c</code> to represent the title, modified date or created date and the second is <code>a</code> or <code>d</code> for ascending or descending. Therefore <code>order=td</code> will display the results in descending title sequence. The default is descending modified date.</li>
<li>pending= : True or false, where to include pending posts in the result. By default, pending posts will not be included.</li>
<li>scheduled= : True or false, where to include scheduled posts in the result. By default, scheduled posts will be included.</li>
<li>template= : This is the template which formats the output. See the section below on * *Templates** for further information.</li>
<li>type= : This allows you to limit the results to either <code>post</code> or <code>page</code>. The default is both.</li>
<li>words= : The minimum number of words that must be present in the draft for it to be included. Defaults to 0.</li>
</ul>
To restrict the posts 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.
<ul>
<li>created= : his reflects how long ago the post/page must have been created for it to be listed. For example <code>6 months</code> would only list drafts that were created in the last 6 months.</li>
<li>modified= : This reflects how long ago the post/page must have been modified last for it to be listed. For example <code>6 months</code> would only list drafts that have been modified in the last 6 months.</li>
</ul>
<h3>Templates</h3>
The template parameter allows you to format the output by allowing you to specify how each line of output will display. A number of tags can be added, and you can mix these with HTML. The available tags are as follows…
<ul>
<li>{{ul}} – Specifies this is an un-ordered list (i.e. bullet point output). This MUST be specified at the beginning of the template if it is to be used.</li>
<li>{{ol}} – Specifies this is an ordered list (i.e. number output). This MUST be specified at the beginning of the template if it is to be used.</li>
<li>{{icon}} – This is the icon that indicates a scheduled post.</li>
<li>{{draft}} – This is the post detail and is the only REQUIRED tag.</li>
<li>{{author}} – This is the name of the post author.</li>
<li>{{author+link}} – This is the name of the post author with, where available, a link to their URL.</li>
<li>{{words}} – The number of words in the draft post.</li>
<li>{{chars}} – The number of characters (exc. spaces) in the post.</li>
<li>{{chars+space}} – The number of characters (inc. spaces) in the post.</li>
<li>{{created}} – The date/time the post was created.</li>
<li>{{modified}} – The date/time the post was last modified.</li>
<li>{{category}} – Shows the first category assigned to the post.</li>
<li>{{categories}} – Shows all categories assigned to the post, comma separated.</li>
</ul>
If {{ul}} or {{ol}} are specified then all the appropriate list tags will be added to the output. If neither are used then it’s assumed that line output will be controlled by yourself.
<h3>Omitting Posts/Pages from Results</h3>
If you wish to omit a page or post from the list then you can do this in 3 ways…
<ol>
<li>By giving the post a title beginning with an exclamation mark. You can then remove this before publishing the post.</li>
<li>The post and page editor has a meta box, where you can select to hide the page/post.</li>
<li>You can add a custom field to a page/post with a name of ‘draft_hide’ and a value of ‘Yes’</li>
</ol>
<h3>Edit Link</h3>
If the current user can edit the draft item being listed then it will be linked to the appropriate edit page. The user then simply needs to click on the draft item to edit it.
There are separate permissions for post and page editing, so an editor with just one permission may find that they can only edit some of the draft items.
Drafts that don’t have a title will not be shown on the list UNLESS the current user has edit privileges for the draft – in this case a title of [No Title] will be shown.
<h3>Using a Widget</h3>
Sidebar widgets can be easily added. In Administration simply click on the <code>Widgets</code> option under the <code>Appearance</code> menu. <code>Draft Posts</code> will be one of the listed widgets. Drag it to the appropriate sidebar on the right hand side and then choose your options.
Save the result and that’s it! You can use unlimited widgets, so you can add different lists to different sidebars.

Draft List

WordPress plugin to manage and promote your unpublished content.

ウェブ屋のさとーさん

ショートコード [tgb ][/tgb] で囲まれた部分が　start_time, end_time, config で指定された時間帯等に表示されるようになるプラグインです。 
start_time だけの指定 
end_time だけの指定も可能です。
[tgb start_time=”20160101″][/tgb]　で囲まれた部分は 2016年１月１日を迎えると表示されます。 
[tgb end_time=”20161231″][/tgb] で囲まれた部分は 2016年１２月３１日になるまで表示されます。 
２０１６年１２月３１日いっぱい表示したい場合は　[tgb end_time=”20161231235959″][/tgb] で囲むか 
[tgb end_time=”20170101″][/tgb] で囲むと2017年１月１日担った瞬間表示されなくなります。
より詳細で繰り返しも可能な　config パラメータの設定ができるようにしました。 
設定は　config=”day:1|2|3|4|5,hour:7|8|9|10|11″ のように設定します。 
上記の設定は下記のように理解されます。
「毎月１〜５日　の　７〜１１時　にだけ表示される」
これに start_time, end_time も絡めて詳細に繰り返しとなる部分を設定することが可能です。 
そして複数の設定を一度に行うことができます。パラメータをカンマ区切りで指定できます。 
** 複数の設定は記述の順番に実行されます。ただし、任意のパラメータについては最後に実行されます。 
** 規定のパラメータ、任意のパラメータ以外のパラメータは無視されます。
config パラメータは下記の設定が出来ます。 
[1] hour: ２４時表記で設定します。７〜１０時という場合は　hour:7|8|9（１０時台に入ったら表示されない） というように | （vertical line）で区切るようにします。 
[2] day: 毎月○日の設定をします。　day:7|8|9|10 とすると ７〜１０日というようになります。 
[3] week: 毎週○曜日の設定をします。　week:sun|mon|tue とすると日〜火曜日という感じです。一応日本語での設定も受け付けるはずです。 week:火|木|土 など。 
[4] month: ○月の設定をします。　month:6|7|8 とすると６〜８月という感じです。季節ごとの表示切り替えができる感じです。 
[5] 任意のパラメータ これは 
　　 
　　add_filter(‘time_goes_by_judgement’, ‘〜任意のメソッド名〜’, 10, 3); 
　　 
　　という感じにfunctions.phpに記述し 
　　任意のメソッド名にて TRUE か FALSE を返却すればそのように表示されます。 
　　そもそも他の判定に依存しないように $flg を引数に入れていますので、そこまでの判定を覆すことも可能です。 
　　$config には任意のパラメータ以外の上記パラメータも入ってきます。 $content にはショートコードで囲まれた部分が入ってますので 
　　様々な利用方法・判定方法が考えられます。 
　　apply_filters( ‘time_goes_by_judgement’, $flg, $configs, $content );
　　祝日に表示する　などは現在のプラグイン自体にはない機能ですが、これを使って実装すると良いでしょう。
例： 
 [tgb config=”month:1|2|3,day:5|15|25,hour:13|14|15″]１〜３月の　５の付く日は　タイムサービスを行っています！！！　ただいま１３時〜１６時までサービスタイム実施中！！[/tgb]
・timezone=”Asia/Tokyo” のようにパラメータ指定でタイムゾーンの指定ができます。
このデフォルト値は内部設定のタイムゾーンとなっています。
このデフォルト値は管理画面から変更することが可能です。
その他、この中で利用出来るように[disp_content][disp_title]ショートコードも用意しました。 
[disp_content post_id=”xxx”] とすると、投稿IDがxxxのコンテンツを表示します。 
[disp_title post_id=”xxx”] とすると、投稿IDのタイトルを表示します。
例： 
[tgb start_time=”20160101″ end_time=”20160201″]
[disp_title post_id=”1234″]
[disp_content post_id=”1234″][/tgb]
２０１６年１月１日から２０１６年２月１日になるまで（１月３１日の間まで）投稿ID:1234のタイトルがh2タグでその下に投稿ID:1234のコンテンツが表示されます。
・disp_content, disp_title のパラメータに slug と status を追加しました。（version 1.2.5） 
　slug にはスラッグを入れると記事を特定します。（サーバー移転などpost_idが変わるような環境で効果的です。） 
　status は publish, future, private, draft の中から指定できます。 
　非公開の状態だったら取得したくない場合などを考慮しました。 
　無指定の場合はいかなる状態でも取得してきます。
制作：佐藤　毅（さとう　たけし） <a href="https://gti.co.jp/" rel="nofollow ugc">福岡市南区大橋 ウェブシステム開発</a> 株式会社ジーティーアイ代表
<h3>Arbitrary section</h3>
<h3>A brief Markdown Example</h3>

Time goes by

Switch the display of content based on time using a shortcode.  ショートコードで囲んだコンテンツを時間に応じて表示切替できるプラグイン。

Draft List vs Time goes by