This plugin is designed for WordPress multisite installations. It was created to display posts (from all post types) from any any blog (subdomain) on any other blog or main website. You may choose which types to list (default are posts) and organize them accordingly. This saves you much programming and does all the work for you. This plugins is free!!!

Below is a list of shortcode parameters with some examples.

---

show_title=’true’

Whether to show/hide the post titles in the list. Default is true.

Shortcode used.

[netsposts]

This will include the post titles by default.

Now the shortcode to hide the titles.

[netsposts show_title='false']

As you can see the titles are no longer showing.

---

limit=’100′

This limits the total number of posts that will be displayed. The default is one hundred. Doesn’t matter whether pagination is activated or deactivated. So if you have a 1000 posts only 100 will be displayed. The rest will be ignored.

---

number_latest_x_posts_excluded=’0′

This feature allows you to skip an x number of posts by date. So if x equals 5 the last five posts created (the closest to today and including today) will not be shown. This feature is designed so you may have one or more featured post(s) and then list the remaining.

This example will use the following shortcode.

[netsposts number_latest_x_posts_excluded='1' order_post_by='date_order desc']

As in the previous example above there was a post created on Feb 22, 2022 so used in conjunction with the order_post_by parameter it would appear at the top of the list so it is excluded. If ‘date_order desc’ was used then the earliest created post date would have appeared at the top and it would’ve been excluded.

---

taxonomy_offset_names=”

taxonomy_offset_type=’category’ // category|tag|any

These to parameters would only offset the posts that belonged to the given categories. So let’s say you only want posts from a certain category or tag to be offset enter them here. That way if you have more than one shortcode on the page you can target them directly. Like your featured listing will have one post from each category then you may have two different shortcodes below (one for tag and one for category) that will not show the posts in the first listing.

---

show_categories=”

This will show a list of the categories the post belongs to. So using the following shortcode.

[netsposts show_categories='true']

will show the category list that the post is related to.

As you can see they all belong to a category called uncategorized and the name with a link to the given category shows.

days=’0′

Allows you how many days old a post can be before it drops off the list. So if you only want them to go back about a year or so you would just add days=’365′ and after 365 days the posts will no longer show. Default is 0 which means no expiration date.

Note: This does not delete or do anything to the posts themselves just excludes them from the list.

---

title=”

This parameter adds a title name to the whole shortcode list. It has nothing to do with the individual titles of each post. So in the following list I’m going to give the whole group a title of Uncategorized Posts.

[netsposts show_categories='true' title='Uncategorized Posts']

You may style and change the color of the title using simple css. You may remove the border underneath the title also.

---

titles_only=”

Used to display titles only. Nothing else will be shown. Great for neat short to the point links. Default is false.

Note: The posts meta data will still be shown. It may be removed using a shortcode parameter which will be explained further on down this page.

[netsposts titles_only='true']

---

include_link_title=”

Whether to include a link in the posts title. The default is false.

[netsposts include_link_title='true']

---

exclude_link_title_posts=

This works in conjunction with the include_link_title above. So if include_link_title is set to true then you may individually remove the link per post by entering their post_id. So for example we’re going to remove the post that is titled Test Post One. This post has a post_id of 13.

Note: For multiple posts you use a comma separated list. exclude_link_title_posts=’24,32′ will not put a link in the title with post_id’s of 24 and 32.

[netsposts include_link_title='true' exclude_link_title_posts='13']

As you can see the post titled Test Post One has no link associated with its title.

---

link_open_new_window=”

[netsposts include_link_title='true' exclude_link_title_posts='13' link_open_new_window='true']

This adds the target=”_blank” parameter to the link. That way the titles that are linked when clicked on will open in a new window/tab. Default is false.

---

wrap_start=’null’

wrap_end=’null’

These two arguments will enclose the list of posts with any html you would like. That is each individual post. Let’s say you want to wrap a div around each post and add a padding and a background plus border. This is a quick way to do it.

[netsposts wrap_start='<div style="background-color: aliceblue; padding: 1em; border: 2px solid #ccc;">' wrap_end='</div>']

In the example above the paragraph gaps are gone because I wrapped each post with <div></div> instead of <p></p> because WordPress redoes the styling (even in raw html mode) for the paragraph tags. So you would have to add back the margins. If you want it to stay consistent you would give the same margins as WordPress gives the paragraphs by default which is 1em. So you may redo the shortcode to look as such.

[netsposts wrap_start='<div style="background-color: aliceblue; padding: 1em; border: 2px solid #ccc; margin-bottom: 1em;">' wrap_end='</div>']

Note: Notice how double quotes (“) were used for the HTML. For any of these wrapping functions you must do it this way to prevent php errors. Single quotes are used elsewhere in the programming and so to stop false encasement’s this is the correct procedure. Single quotes are highly recommended for all other parameters. There will be times when you are pasting directly in to the template you may have to reverse the single and double quotes to stop php errors.

thumbnail=”

If set to true (default false) then it will show each posts individual featured image. Also works with the FIFU plugin.

[netsposts thumbnail='true']

Note: All the featured images in the above example will be the same because I assigned all of them the same image. If they are different then each individual post will have its own unique image. Examples will be shown later.

---

default_thumbnail=’null’

This parameter will automatically set a default thumbnail to any post that doesn’t have a featured image. Just replace null with the url. So the parameter will look something like this.

default_thumbnail=’https://images.agaveplugins.com/wp-content/uploads/sites/2/2022/02/wordpress-logo-silver.jpg’

Note: The thumbnail will only show if thumbnail=’true’.

---

post_type=’post’

This parameter is shown with the default of post. You may replace post with any post type including pages. If you just wanted to show a list of all pages it would be post_type=’page’.

To keep it simple I’m going to show a listing of pages but limit the number to just three.

[netsposts list='3' post_type='page']

---

include_blog=’null’

Will include blogs that are listed by blog_id and separated by commas.

[netsposts include_blog='1']

As you can see the above post is from the main blog which has a post_id of 1.

---

exclude_blog=’null’

Like the parameter above except this time it will exclude the blog(s) with the give blog_id(s).

[netsposts exclude_blog='1']

As you hover the mouse over the read more links on the given posts you will see none of them are from the main blog.

---

exclude_post=’null’

include_post=’null’

The above parameters are identical to include/exclude blogs except you replace null with a comma separated list of the post id’s. For example exclude_post=’5,9,27′ will not show posts with those given id’s. If it was include_post then only posts with those given id’s will be shown. If you have more than one post with the same id they will both be excluded or included what ever the situation may be.

---

title_length=’null’

This will shorten the title to the given number of words. So if you would like to shorten the titles to just two words you would use the following.

[netsposts title_length='2']

See how the last post in the list had a title of more than two words. Now it’s shortened. This will keep the list looking better. If it’s set to be a link then on hover it will show the whole title name as shown below.

[netsposts title_length='2' include_link_title='true']

---

title_length_characters=’999′

This parameter is the same as above but instead of words it shortens by characters. So let’s say you want to short the list so the title is only nine letters long (spaces count as a character) you would use below.

[netsposts title_length_characters='10']

As you can see it looks a little ugly without the ellipse (three dots after the title) so you may add it back using the ::after psuedo css class. I will show you an example how you may target this shortcode only by also using shortcode_id=” parameter.

taxonomy=”

This parameter was designed to filter the post listings to a given taxonomy. So let’s say you have a category called books then only posts that are in the given category will be shown. Let’s say you also have a tag called books on one of your blogs. Then those will be shown also. Below will show you how to include the posts just by category or type.

taxonomy_type=’category,tag’

So as in the previous example if you set taxonomy_type=’category’ then all the posts in that have a tag of books will not be shown. Only the categories will be shown.

---

show_all_taxonomies=’false’

Includes a listing of all the taxonomies the post belongs to. False is default.

---

show_all_taxonomy_types=’false’

If set to true it will even show custom taxonomy types. Must be set to true if you have custom post types with custom taxonomies or they won’t be shown.

---

exclude_taxonomy=”

If you are listing taxonomies then you may exclude them individually by placing their slugs here.

[netsposts exlude_taxonomy='category,custom_taxonomy']

will include a list of taxonomies with permalink to given taxonomy page.

---

hide_excerpt=’false’

Default is fault but if set to true then the except will not be shown.

[netsposts hide_excerpt='true']

As you can see the excerpt has been removed from the listing.

---

hide_source =’false’

The default is false and when set to true the source of the post will not be shown.

[netsposts hide_source='true']

See how the post date and the name of the blog it was created on are no longer being displayed.

---

include_price=”

If you have woocommerce or wp eStore by tipsandtricks-hq installed you may show the products price. If you have woocommerce installed it would be include_price=’woocommerce’ or for the eStore plugin it would be include_price=’estore’. So the shortcode to list posts from woocommerce would be somthing like below.

[netsposts post_type='product' include_price='woocommerce' taxonomy_type='woocommerce_category']

---

paginate=’false’

By default this plugin will only list one page of posts with a default of 10. All other ones will be ignored. If you would like to show them all then you would change this to true.

[netsposts paginate='true']

As you can see it starts paginating after ten posts and will keep adding another page for each additional block of ten posts.

---

pages=’null’

---

list=’10’

This is how you limit the number of posts to be shown on a page. The default is 10. If used with pagination then each page will have in this example 10 posts. For a quick example you can see what I mean below.

[netsposts list='1']

See how there’s only one post showing. Further on down the page when I explain the pagination feature you will see how it may be combined with the list parameter to spread the list over multiple pages.

excerpt_length=’null’

This is used to shutoff the excerpt after X amount of words. So if you have it set as excerpt_length=’15’ it will stop the excerpt after the 15th complete word.

---

excerpt_letters_length=’400′

Same as above but will cut off the excerpt after the 400th letter(character). Spaces are included as characters.

---

auto_excerpt=’false’

By default this plugin takes the excerpt from the manual excerpt field. If you would like it to create its own from the content block you would set this to true. The plugin will show all raw date so it is highly recommended to use the manual excerpt field on each post so it will display nice and clean.

---

filter_excerpt=’false’

This works in conjunction with the auto_excerpt field above. With the auto_excerpt field set to true and this filter is set to true it will strip all html tags in an effort to display cleaner content in the excerpt field.

---

use_shortcode_in_excerpt=’false’

When set to true it will process all shortcodes. Whether you have the excerpt to use the manual excerpt field (manual excerpt field must be set up to process shortcodes) or the auto excerpt function.

---

show_author=’false’

When set to true the author will be included with the Meta Info as seen below.

[netsposts show_author='true' list='3' except_letters_length='50']

As you see in the example above my author name is being shown. Defaults to how you would like your name to be displayed in the admin user set up area.

---

full_text=’false’

When set to true all text will be shown for the post. So the entire posts page will be displayed.

[netsposts full_text='true' list='1']

size=’thumbnail’

Let’s you choose which thumbnail size (even custom ones you have created yourself) here. The default WordPress sizes are – thumbnail, medium, medium_large and full. Below will be an example of a single post with different thumbnail sizes chosen.

[netsposts include_post='209' thumbnail='true' size='thumbnail']

[netsposts include_post='209' thumbnail='true' size='medium']

[netsposts include_post='209' thumbnail='true' size='medium_large']

See how the different thumbnail sizes are now chosen. Works great with the Featured Image from URL plugin.

---

image_class=’post-thumbnail’

Adds a class to the image thumbnail so for example in the following plugin we will add a class of custom-thumbnail-class.

[netsposts include_post='209' thumbnail='true']

In the following image you will see that the class has been added.

---

date_format=’n/j/Y’

This changes how you would like the date to be displayed in the meta-info. The default is month day year. So to change it like they show in most other countries by day month year you would just change the order. date_format=’j/n/Y’. You may find all parameters in the WordPress Formatting Date and Time.

[netsposts include_post='209' date_format='j/n/Y']

[netsposts include_post='209' date_format='M/j/Y']

This will show you the three letter abbreviated month.

[netsposts include_post='209' date_format='F/j/Y']

This will show you the full text of the month.

Here is a good guide on all date formats and how to use them. https://www.w3schools.com/php/func_date_date.asp

---

end_size=”

mid_size=”

These two parameters are used when paginate is set to true. As an example I’m going to set list=’2′ and paginate=’true’.

[[ netsposts list=’2′ paginate=’true’]]

As you can see this is the default setting because the above are automatically set to null.

Let’s say you want somebody to be able to click on the middle and the end with more choices. Here are two more examples.

[netsposts list='2' paginate='true' mid_size='1' end_size='1']

Note: These should only be used if there is nothing else on the page except for the listings. The page refreshes on each pagination. If you would like to add it on a page with other text then you will use the format listed further on down this page.

---

prev_next=’true’

The default is true and shows text with previous and next to go forward or backward one page at a time.

prev=’« Previous’

Allows you to change the text of the previous and next buttons to whatever you like. Like if you have a different language. For example prev=’Anterior’.

next=’Next »’

Same as above except for the next text. next=’Próximo’

title_color=’#000000′

Allows you to change the color of the title. Only works if the title is not clickable. If it is you must use custom css to target it.

text_color=’#000000′

Works with the excerpt field text.

[netsposts include_post='209' text_color='green' title_color='purple']

These parameters use inline styling. So the above would add style=”color: green;” to the excerpt wrapper and style=”color: purple;” to the title wrapper.

---

meta_info=’true’

This is the default setting. If set to false it will hide all meta_info.

[netsposts include_post='209' meta_info='false']

Similar to hide_source=’true’ but does not remove the borders nor the author if show_author=’true’.

[netsposts include_post='209' meta_info='false' show_author='true']

See how the author information is just shown. Because only the meta_info is hidden. While hide_source=’true’ hides the whole section.

---

wrap_title_start=”

wrap_title_end=”

Wraps a div around the title so more personal css touches may be applied.

wrap_image_start=”

wrap_image_end=”

Same as above but surrounds the the image.

wrap_text_start=”

wrap_text_end=”

This wraps the excerpt field.

wrap_price_start=”

wrap_price_end=”

Used for Woocommerce and WP eStore text area.

---

meta_width=’100%’

For the meta info. Default is full width but it may be adjusted to a smaller size if the need be. Example meta_width=’250px’.

---

post_height=’null’

This parameter allows you to set a fixed height to all the listings. This is good if you want to share uniformity. All text overflow will be hidden. It is highly recommended to set an excerpt and title length so they all look the same.

manual_excerpt_length=’null’

manual_excerpt_letters_length=’null’

These parameters are used with the manual excerpt field of the posts. You can set their length by words or individual letters (characters).

---

random=’false’

If you would like to show just a list of lets say 10 posts at random the following shortcode will do.

[netsposts list='10' random='true']

---

order_post_by=”

There are three ways to order the posts (all three have asc and desc capabilities). date_order, title, page_order. So if you would like to order alphabetically by title you would enter the following.

[netsposts order_post_by='title']

If you want to order a posts to show the most recent entry first it would be the following.

[netsposts order_post_by='date_order desc']

use_layout=’default’ //there can be 2 values. if we use “default” then views/post_layout_default.php will

//be used otherwise if we use “inline” – views/post_layout_inline.php will be used

align_thumbnail=’left’ //this attribute can be “left” or “right”‘

wrap_excerpt_start=”

wrap_excerpt_end=”

Advanced Custom Fields Parameters

These parameters were created to add more functionality with the Advanced Custom Fields plugin. Doesn’t matter if it’s the free or pro version. They will work the same.

show_after_date=”

show_before_date=”

First of all for the example look at the following image.

The slug of the two acf fields are coupon_date_start and coupon_date_end. So if you would like the post to start and end on these dates you have to enter the date exactly as shown in the acf field. So an example of the shortcode would be the following.

[netsposts show_after_date='coupon_date_start::08/03/2022' show_before_date='coupon_date_end::10/03/2022']

So the posts with this date setup will only show between these dates.

---

show_for_today=”

This is very useful for showing an event page where you only want to show today’s events. So for example you have a custom field named event_date. You would then input that field in the shortcode.

[netsposts show_for_today='event_date']

Now the posts with an event_date that is equal to today will be shown. So you can create a separate page called Today’s Events.

exclude_all_past_events=”

This is good for an upcoming events page since it will include all upcoming and today’s events. Any post that has an event_date prior than today will not be shown.

show_past_events=”

Will only show events prior to today. Excellent for an events archive page. That is will only show events that have already past.

---

include_acf_fields=’false’

Note: In order to display custom fields from another blog (subdomain) you must have the ACF plugin active on the site that is displaying the posts also. For example if you are displaying the posts on sub3 and sub2 has the ACF fields then the plugin must be active on both sites sub3 and sub2 even if sub3 doesn’t have any custom fields created. The NPE plugin needs the ACF plugin to be active so it can hook in to its code and find the custom field in question.

Enter the custom field names here and they will be shown. So you have an event date and would like it to show just enter the shortcode as such.

[netsposts include_acf_fields='event_date']

You can see the last post has an event day so it’s the only way to show Event Date: 06/11/2036. If you have more than one field to show just separate them by commas.

hide_acf_labels=’false’

when set to true you will see the event date without the label.

See how only the date is showing. 06/11/2036 instead of Event Date: 06/11/2036.

order_post_by_acf_date=’field-name-slug’

If you have an events page and would like to order them where the most current events show first (that is the events that are closest to today and including today you would use something like the following. In the below example I’m assuming you have created a custom post type of Events.

[netsposts post_type='events' order_post_by_acf_date='event_date']

Let’s you’re using regular posts and created a category called events then it would be the following.

[netsposts taxonomy='events' taxonomy_type='category' order_post_by_acf_date='event_date']

The above shortcode would work very well on a custom archive template for events. So you would name a custom template called category-events.php and replace the post query with the above shortcode.

So the template would have:

Instead of the standard custom query. I’ll explain that in a future tutorial how you may use this plugin for archive pages.

acf_date_format=’false’

Same as date_format= except you use the date picker Advanced Custom Fields field.

You may find all parameters in the WordPress Formatting Date and Time.

add_link_to_acf=

Select each acf field and separate them by commas so they will create a permalink to post from all fields. If you would like to only have a select few clickable you would put in their custom field slug in a comma separated list.

[netsposts add_link_to_acf='event_date' include_post='282']

See how the acf date field is now a link directing you to the post it is on.

---

• Taxonomy offsets
  • taxonomy_offset_names=”
  • taxonomy_offsets=”

So for example if you wanted to offset three different categories it would look like so:

[netsposts taxonomy_offset_names='books,flowers,sports' taxonomy_offsets='5,4,10']

then books would be offset by 5, flowers 4, and sports 10. Offsets means it will skip the X most recent posts.

must_include_categories=

Pretty straight forward. Any categories you put in here the post must be in. The post may be in more than one category but if it is any of the categories put here then it will show.

[[netposts must_include_categories=’art,hiking,music,photography’]]

filter_by_title_keywords=’false’

Add a comma separated list of keywords that must be in the post’s title in order for it to be displayed. Any post that does not contain any of the keywords will not be shown.

show_tags=’false’

Default setting is false. When set to true shows all tags this post is related to with links to the individual tag’s archive page.

show_rating=’false’

This plugin works with the Post Ratings Plugin that is available for download to our members. Will display the review star ratings.

page_has_no_child=’false’

When set to true any post that has children (that is they are a parent page) will not be shown. Only very bottom child pages will be listed.

read_more_text=”

This will change the text of the read more link. Like if you want to add arrows or use a different language.

[netsposts read_more_text=' Continue reading →']

Notice how I added a space after the first single quote so there will be a space between the last text in the excerpt and the read more text.

---

add_link_to_date=’false’

When set to true it add’s a link to the date in the meta info field. This way it will take you to the post.

---

show_category_icon=’false’

show_tag_icon=’false’

show_custom_taxonomies=’false’

show_custom_taxonomy_icon=’false’

If any of the above are set to true will show a default icon that will be displayed next to the taxonomies. For example for categories a folder icon will show.

---

remove_blog_prefix=’false’

Sometimes if a multisite is created in a subdomain a /blog/ will be added to the pretty link. This will remove that slug.

load_posts_dynamically=’false’

When set to this parameter and paginate are both set to true it will reload the list of posts without refreshing the page. This will keep the user in the same spot. Works off the shortcode’s ID so one must be created with the parameter shortcode_id=’custom_id’. Shortcode_id can be anything you like.

[netsposts load_posts_dynamically='true' shortcode_id='dynamic_reload_with_icon' list='3' paginate='true']

posts_preloader_icon=”

If you would like to use a different icon while the posts are loading you may enter the full url of the image here. Nothing else just the link to the image.

show_preloader_icon =’true’

If set to false then no loading icon will be displayed. This is my preference as I think it looks cleaner as you can see below.

[netsposts show_preloader_icon ='false' load_posts_dynamically='true' shortcode_id='dynamic_reload_without_icon' list='3' paginate='true']

shortcode_id =’null’

This parameter is optional and may be used for design purposes. But when you choose to reload your posts dynamically (without refreshing the page) then you must create a unique ID for this post if you have more than one on any given page. Remember ID’s that is id=”custom_id” can only be used once per page. That is every other shortcode that is on the same exact page must have a different ID name.

show_only_after_x_days_old=’null’

If you don’t want to show posts that are less than thirty days old then you would add the argument to the shortcode. It would look like this.

[netsposts show_only_after_x_days_old='30']

Then only posts that are 30 days or older will be shown. That is if a post was created yesterday then it will not be shown.

exclude_read_more_link=”

Some people don’t like read more links. They are happy with just the image and title being clickable. So you may remove it using this parameter.

[netsposts list='3' exclude_read_more_link='true' include_link_title='true']

---

Deprecated Parameters

The below parameters are no longer in use and have been deprecated. Please ignore these.

menu_name=”

menu_class=”

Note: These have been deprecated and are no longer in use. It added a simple menu to the page. Please ignore these two parameters.

container_class=”

This is the div that each post is wrapped in. You may add a custom class to the whole container.

column=”

This has been deprecated because with the use of flex box and grid containers you get similar and much better layouts. If you need help and have a page with something similar you’d like to portray just fill out the contact form and let me know :-).

use_image=”

Replaced with thumbnail=”

show_order=’false’

domain_mapping=’site_url’

Deprecated and no longer used.

include_post_meta=”