=== Network Latest Posts ===
Contributors: L'Elite
Donate link: https://laelite.info
Tags: recent posts, shortcode, widget, network, latest posts
Requires at least: 3.0
Tested up to: 3.4.1
Stable tag: 3.0
This plugin allows you to get the latest posts from the blogs in your network and display them in your main site using shortcodes or a widget.
== Description ==
This plugin get the latest posts from the blogs in your network and display them in your main site using shortcodes or a widget.
For further details please visit: http://en.8elite.com/network-latest-posts [English] http://es.8elite.com/network-latest-posts [Espanol] http://fr.8elite.com/network-latest-posts [Francais]
This plugin works with Wordpress 3 Network (multisites)
== Installation ==
1. Upload `network-latest-posts folder` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. If you want to use the Widget, you can add the Network Latest Posts widget under 'Appearance->Widgets'
4. If you want to use the Shortcode, go to a page or post then click the NLPosts icon (green button in the TinyMCE editor) or use [nlposts] (that's it, seriously!)
== Options ==
= CSS Classes =
* Unordered List:
* 'wrapper_o' => <ul class='nlposts-wrapper nlposts-ulist nav nav-tabs nav-stacked'>
* 'wtitle_o' => <h2 class='nlposts-ulist-wtitle'>
* 'item_o' => <li class='nlposts-ulist-litem'>
* 'content_o' => <div class='nlposts-container nlposts-ulist-container $nlp_instance'>
* 'meta_o' => <span class='nlposts-ulist-meta'>
* 'thumbnail_o' => <ul class='nlposts-ulist-thumbnail thumbnails'>
* 'thumbnail_io' => <li class='nlposts-ulist-thumbnail-litem span3'><div class='thumbnail'>
* 'pagination_o' => <div class='nlposts-ulist-pagination pagination'>
* 'title_o' => <h3 class='nlposts-ulist-title'>
* 'excerpt_o' => <ul class='nlposts-ulist-excerpt'><li>
* Ordered List:
* 'wrapper_o' => <ol class='nlposts-wrapper nlposts-olist nav nav-tabs nav-stacked'>
* 'wtitle_o' => <h2 class='nlposts-olist-wtitle'>
* 'item_o' => <li class='nlposts-olist-litem'>
* 'content_o' => <div class='nlposts-container nlposts-olist-container $nlp_instance'>
* 'meta_o' => <span class='nlposts-olist-meta'>
* 'thumbnail_o' => <ul class='nlposts-olist-thumbnail thumbnails'>
* 'thumbnail_io' => <li class='nlposts-olist-thumbnail-litem span3'>
* 'pagination_o' => <div class='nlposts-olist-pagination pagination'>
* 'title_o' => <h3 class='nlposts-olist-title'>
* 'excerpt_o' => <ul class='nlposts-olist-excerpt'><li>
* Block:
* 'wrapper_o' => <div class='nlposts-wrapper nlposts-block container'>
* 'wtitle_o' => <h2 class='nlposts-block-wtitle'>
* 'item_o' => <div class='nlposts-block-item'>
* 'content_o' => <div class='nlposts-container nlposts-block-container $nlp_instance'>
* 'meta_o' => <span class='nlposts-block-meta'>
* 'thumbnail_o' => <ul class='nlposts-block-thumbnail thumbnails'>
* 'thumbnail_io' => <li class='nlposts-block-thumbnail-litem span3'>
* 'pagination_o' => <div class='nlposts-block-pagination pagination'>
* 'title_o' => <h3 class='nlposts-block-title'>
* 'excerpt_o' => <div class='nlposts-block-excerpt'><p>
$nlp_instance is replaced by .nlp-instance-X where X is a number o the name of the instance passed via shortcode.
= Shortcode Options =
This is an just an example with the default values which means I could have used `[nlposts]` instead, but this will show you how the parameters
are passed. For more examples please visit the Network Latest Post website.
`[nlposts title=NULL
number_posts=10
time_frame=0
title_only=TRUE
display_type=ulist
blog_id=NULL
ignore_blog=NULL
thumbnail=FALSE
thumbnail_wh=80x80
thumbnail_class=NULL
thumbnail_filler=placeholder
custom_post_type=post
category=NULL
tag=NULL
paginate=FALSE
posts_per_page=NULL
excerpt_length=NULL
auto_excerpt=FALSE
excerpt_trail=text
full_meta=FALSE
sort_by_date=FALSE
sorting_order=NULL
sorting_limit=NULL
post_status=publish
css_style=NULL
instance=NULL
]`
* @title : Widget/Shortcode main title (section title)
* @number_posts : Number of posts BY blog to retrieve. Ex: 10 means, retrieve 10 posts for each blog found in the network
* @time_frame : Period of time to retrieve the posts from in days. Ex: 5 means, find all articles posted in the last 5 days
* @title_only : Display post titles only, if false then excerpts will be shown
* @display_type : How to display the articles, as an: unordered list (ulist), ordered list (olist) or block elements
* @blog_id : None, one or many blog IDs to be queried. Ex: 1,2 means, retrieve posts for blogs 1 and 2 only
* @ignore_blog : It takes the same values as blog_id but in this case this blogs will be ignored. Ex: 1,2 means, display all but 1 and 2
* @thumbnail : If true then thumbnails will be shown, if active and not found then a placeholder will be used instead
* @thumbnail_wh : Thumbnails size, width and height in pixels, while using the shortcode or a function this parameter must be passed like: '80x80'
* @thumbnail_class : Thumbnail class, set a custom class (alignleft, alignright, center, etc)
* @thumbnail_filler : Placeholder to use if the post's thumbnail couldn't be found, options: placeholder, kittens, puppies (what?.. I can be funny sometimes)
* @custom_post_type : Specify a custom post type: post, page or something-you-invented
* @category : Category or categories you want to display. Ex: cats,dogs means, retrieve posts containing the categories cats or dogs
* @tag : Same as categoy WordPress treats both taxonomies the same way; by the way, you can pass one or many (separated by commas)
* @paginate : Display results by pages, if used then the parameter posts_per_page must be specified, otherwise pagination won't be displayed
* @posts_per_page : Set the number of posts to display by page (paginate must be activated)
* @excerpt_length : Set the excerpt's length in case you think it's too long for your needs Ex: 40 means, 40 words (40 by default)
* @auto_excerpt : If true then it will generate an excerpt from the post content, it's useful for those who forget to use the Excerpt field in the post edition page
* @excerpt_trail : Set the type of trail you want to append to the excerpts: text, image. The text will be _more_, the image is inside the plugin's img directory and it's called excerpt_trail.png
* @full_meta : Display the date and the author of the post, for the date/time each blog time format will be used
* @sort_by_date : Sorting capabilities, this will take all posts found (regardless their blogs) and sort them in order of recency, putting newest first
* @sorting_order : Specify the sorting order: 'newer' means from newest to oldest posts, 'older' means from oldest to newest
* @sorting_limit : Limit the number of posts to display. Ex: 5 means display 5 posts from all those found (even if 20 were found, only 5 will be displayed)
* @post_status : Specify the status of the posts you want to display: publish, new, pending, draft, auto-draft, future, private, inherit, trash
* @css_style : Use a custom CSS style instead of the one included by default, useful if you want to customize the front-end display: filename (without extension), this file must be located where your active theme CSS style is located, this parameter should be used only once by page (it will affect all shorcodes/widgets included in that page)
* @instance : This parameter is intended to differenciate each instance of the widget/shortcode/function you use, it's required in order for the asynchronous pagination links to work
== Changelog ==
= 3.0 =
* Network Latest Posts was totally rewritten, it no longer uses Angelo's code. WordPress hooks took its place. All the nasty hackery and workarounds
are gone.
* Support for RTL installations added.
* Sorting capabilities added, it's now possible to display the latest posts first regardless the blogs they were found.
* Name changed for some parameters to match their functionality.
* Some parameters no longer exist (display_root, wrapo, wrapc) they are no longer useful
* Thumbnail size, class and replacement added
* Display type added, 3 styles by default, it makes it easier for people with limited CSS knowledge to tweak the visual appearance.
* Fixed some bugs in the auto_excerpt function
* CSS style allows you to use your own css file to adapt the output to your active theme (when used it will unload the default styles)
* Instance is used to include multiple instances in the same page as a widget or as a shortcode, fixing the pagination bug which didn't work when used multiple times.
* Widget now includes multi-instance support extending the WP_Widget class, you can added as many times as you want to all your widgetized zones.
* Shortcode button added the TinyMCE editor, now you just need to fill the form and it will insert the shortcode with the parameters into the post/page content.
* Renamed some functions to avoid incompatibility with other plugins using default function names.
* Main folders and sub-folder installations supported.
= 2.0.4 =
* NEW feature added `auto_excerpt` will generate an excerpt from the post's content
* NEW feature added `full_meta` will display the author's display name, the date and the time when the post was published
= 2.0.3 =
* Excerpt Length proposed by Tim (trailsherpa.com)
* It's possible now to display the posts published in the main blog (network root) using the display_root parameter
= 2.0.2 =
* Bug fix: When using only one category only one article from each blog was displayed. Now it displays the number specified with the `number`
parameter as expected - Thanks to Marcalbertson for spotting this
= 2.0.1 =
* Added missing spaces before "published in" string: Lines 347, 358 & 399 - Spotted by Josh Maxwell
= 2.0 =
* NEW feature added `cat` which allows you to filter by one or more categories - Proposed by Jenny Beaumont
* NEW feature added `tag` which allows you to filter by one or more tags - Proposed by Jenny Beaumont
* NEW feature added `paginate` which allows you to paginate the results using the number parameter as the number of results to display by page
* NEW CSS file added
* NEW img folder added
= 1.2 =
* Fixed the repeated `` tags for the widget list
* NEW feature added `cpt` which allows you to display a specific post's type (post, page, etc) - Proposed by John Hawkins (9seeds.com)
* NEW feature added `ignore_blog` which allows you to ignore one or various blogs' ids - Proposed by John Hawkins (9seeds.com)
* Added the Domain name with the IDs to the list of blog ids in the Widget
* Some other minor bugs fixed
= 1.1 =
* Fixed the missing `` tags for the widget list
* NEW feature added `blogid` which allows you to display the latest posts for a specific blog
* NEW feature added `thumbnail` to display the thumbnail of each post
* The widget includes now a list where you can select the blog's id for which you want to display the latest posts
= 1.0 =
* Added Widget option to display excerpt
* Markup improved to make CSS Styling easier
* Added Uninstall hook
* Added Shortcode functionality
* Plugin based in Multisite Recent Posts Widget
== Screenshots ==
1. NLPosts Shortcode in Edit Page
2. NLPosts Insert Shortcode Form
3. NLPosts Shortcode Output
4. Results by Page
5. NLPosts Multi-instance Widget
6. NLPosts Widget: Some Options
7. NLPosts Sidebar Widget Area
8. NLPosts Footer Widget Area
9. NLPosts in RTL Installation
10. NLPosts Shortcode & Widget in RTL
== Frequently Asked Questions ==
= Why did you do this plugin? =
Because I have 3 blogs and I needed a way to display the latest posts from them in the main blog of my Network.
= If I want you to add a new feature, will you do it? =
I like new ideas, but please keep it real and be patient, I try to work as fast as I can but I have also other things to do :).
= What do I need in order to make this plugin work for me? =
Technically nothing, but the pagination feature uses jQuery to load the content without reloading the page. It's prettier that way but it's up
to you (pagination is not Javascript dependant, no jQuery = no fancy loading effects that's all). jQuery is included by default in WordPress, so you don't need to do anything or add anything.
= I can't see the thumbnails =
Your theme have to support thumbnails, just add this to the function.php inside your theme folder:
`add_theme_support('post-thumbnails');`
= OMG this plugin is awesome! I want to buy you a coke and send you a message, where can I do it? =
Please visit my website https://laelite.info if you want to support my work please consider making a donation, even 1$ can make a difference :)