A quick, easy way to add an extensible News custom post type to Wordpress.
This plugin add a News custom post type to your WordPress site. Now you can keep your press releases or time-sensitive announcements in a separate list, without having to juggle categories or tags.
The plugin adds a News tab to your admin menu, which allows you to enter news items just as you would regular posts. The archive list of your news items will appear at /news
, and individual news items will appear at /news/<permalink>
.
Default single item and archive page templates for news items are also provided. These templates have abundant IDs and classes, so that you can style them with your own CSS.
You may also customize them by putting copies in your theme folder, and changing the markup. When you update the plugin, you will get new features and bug fixes, while keeping any customizations you made in your copies of these templates.
A list of news items may be included in other post content with the list-news-items] shortcode. (See the FAQ for more information on using the shortcode.)
Finally, the plugin adds a Recent News Items widget, which can be placed on any sidebar available in your theme, to show a list of news items in reverse chronological order. You can set the title of this list and the number of news items to show.
news-cpt
folder to the /wp-content/plugins/
directory.News
tab that appears in your admin menu.There is one templates named single-news.php
which controls the display of each individual news item on a page of its own. There is also a template named archive-news.php
which controls the display of the list of all news items.
Yes. Just as you can display a list of your regular posts by year, month, or day, you can display news items for a particular year (/news/2013/), month (/news/2013/04/), or day (/news/2013/04/20/).
Copy (don’t move) the template you wish to customize from /wp-content/plugins/views/
to /wp-content/themes/<your-theme-name>/
. Modify the PHP and HTML of the copy in your theme folder, but leave the plugin version alone. You may want to refer back to it if something goes wrong, or you may want to copy new features from it to your custom templates after a plugin update.
No, not usually. While many plugins instruct you to update your permalinks after activation, this plugin tries to update your permalink structure for you. That being said, if the links that begin with /news
aren’t working, please try updating your permalinks first, before reporting a bug or submitting a question to the support forums.
Yes, since Version 1.1.0, the [list-news-items] shortcode is available. It fetches the last X news items in reverse chronological order and outputs them wherever you place the shortcode in any post content.
Yes. The [list-news-items] shortcode can take four (4) parameters, which control the number of posts retrieved, whether the thumbnail of the Featured Image of the news item is shown, whether the excerpt is also shown, and whether to filter the news items by a particular category slug.
Here is a list of the parameter names and their defaults:
Note: Setting the show_date parameter to ‘date’, ‘dateonly’ or 1 will cause the date to be printed with each item. Setting it to ‘datetime’ will cause the date AND time to be printed. Setting it to ‘custom’ will make it use a date format string that you can supply in the date_format parameter. If you specify the ‘custom’ show_date option, the date_format string should use the PHP date formatting options: see http://www.php.net/manual/en/function.date.php.
Here is an example of the shortcode using all the available parameters:
[list-news-items count=8 show_thumbnail=0 show_excerpt=0 category='holidays' show_date='custom' date_format='l jS F Y h:i:s A']
You can use your own CSS rules to style the output of the shortcode. The shortcode wraps its output in a div with classes of “news-items” and, if you limit it to a category slug, also a class of “category-” (where is the slug you specified in the shortcode).
Each news item listed is structured like an OOCSS media object. See Nicole Sullivan’s explanation of styling media objects here: http://www.stubbornella.org/content/2010/06/25/the-media-object-saves-hundreds-of-lines-of-code/.
Here is an example of the output of the shortcode with only one item, from the category “publishing”:
<div class="news-items category-publishing"> <div class="post-65 news type-news status-publish hentry category-publishing media news-item"> <div class="img news-item-thumbnail"> <a href="/news/a-story-in-the-news/"><img width="48" height="48" src="http://localhost:8888/wp-content/uploads/2013/04/Dandelion.gif" class="attachment-thumbnail wp-post-image" alt="Dandelion"></a> </div> <!-- end of .img.news-item-thumbnail --> <div class="bd news-item"> <h3><a href="/news/a-white-christmas-story-in-the-news/">A White Christmas Story in the News</a></h3> <p class="date">Tuesday 13th May 2014 08:49:06 PM</p> <p class="description">The excerpt goes here.</p> </div> <!-- end of .bd.news-item --> </div> <!-- end of .media.news-item --> </div> <!-- end of .news-items -->
No. Individual news items and the news item list have their own templates. There are no specific tags to add news items to other templates, although if you’re comfortable with the WordPress functions for retrieving posts, you are welcome to use something like get_posts()
or query_posts()
with a post_type of “news” and any other parameters you’d like.
The icons are from the Fugue icon set created by Yusuke Kamiyamane (http://http://p.yusukekamiyamane.com/), licensed under the Creative Commons Attribution 3.0 license (http://creativecommons.org/licenses/by/3.0/).