Title: VI: Include Post By
Author: Knighthawk
Published: <strong>April 7, 2020</strong>
Last modified: July 27, 2020

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/vi-include-post-by.svg)

# VI: Include Post By

 By [Knighthawk](https://profiles.wordpress.org/knighthawk/)

[Download](https://downloads.wordpress.org/plugin/vi-include-post-by.zip)

 * [Details](https://pcd.wordpress.org/plugins/vi-include-post-by/#description)
 * [Reviews](https://pcd.wordpress.org/plugins/vi-include-post-by/#reviews)
 * [Development](https://pcd.wordpress.org/plugins/vi-include-post-by/#developers)

 [Support](https://wordpress.org/support/plugin/vi-include-post-by/)

## Description

VI: Include Post By – provides your pages and posts with shortcodes allowing you
to display other pages and posts inside them either by their ID or by post category.
Options to display title,meta,content,thumbnail,excerpt,footer.

### Coming Soon

More display options.
 Taxonomy and post type agnostic setable default thumbnail
grab the actual small thumbnail image for srcset

### Instructions

Shortcode for including a single post by its ID

    ```
    [include-post-by-id
     id="123"
     link="true"
     moretext="Continue Reading"
     card="false"
     display="title,meta,thumbnail,content,excerpt,more,footer,all"
     display_header="title,meta,thumbnail,content,excerpt,more,footer,all"
     display_body="title,meta,thumbnail,content,excerpt,more,footer,all"
     display_footer="title,meta,thumbnail,content,excerpt,more,footer,all"
     image_size="thumbnail,medium,large,full,custom-image-size"
     class_inner="custom-class-name"
     class_header="custom-class-name"
     class_body="custom-class-name"
     class_footer="custom-class-name"
     class_thumbnail="custom-class-name"
    ]
    ```

 * id = post to be shown
 * link = whether the title/thubmnail are links to the post
 * moretext = edit the text of the read-more link
 * card = will set class names to bootstrap cards, no further class customization
   is required
 * display[x] = display options as a CSV, order counts
 * class[x] = a custom class name that will be added to each container element

Shortcode for including single/multiple posts by their category.
 Every option required
or used in the include-post-by-id will also pass through here. This function will
query the DB and then call include-post-by-id once for each resulting post. Shown
here are only the options which are unique to this function.

    ```
    [include-post-by-cat
     cat="123"
     order="DESC"
     orderby="date"
     paginate=true
     perpage="5"
     offset="0"
     class_container="custom-class-name"
    ]
    ```

 * cat = category to be shown
 * order = sort order
 * orderby = what to sort by
 * paginate = true/false
 * perpage = items per page. -1 = all
 * offset = how many posts to skip, useful if you are combining multiple includes
 * class_container = custom-class-name used in the wrapper element

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“VI: Include Post By” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Knighthawk ](https://profiles.wordpress.org/knighthawk/)

[Translate “VI: Include Post By” into your language.](https://translate.wordpress.org/projects/wp-plugins/vi-include-post-by)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/vi-include-post-by/),
check out the [SVN repository](https://plugins.svn.wordpress.org/vi-include-post-by/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/vi-include-post-by/)
by [RSS](https://plugins.trac.wordpress.org/log/vi-include-post-by/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

_0.4.200706_
 * update: aspect-ratio to use jQuery for simpler WP usage

_0.4.200611_
 * added: support for a choice in thumbnail size

_0.4.200520_
 * Update: display and class * added: card = true for auto bootstrap
class names * added: display_header, display_body, display_footer. each internal
element can be targeted to a header, body, and footer * added: class for the header,
body,footer, and thumbnail * changed: thumbnail is now displayed as a background
image in a container with styling set to a given aspect ratio. * todo: may add suport
for classic thumbnails

_0.4.200417_
 * Update: transients * Only uses a single transient, and lookup. Offset
is processed internally rather than putting the weight on a DB query. * Update: 
paginate * Page numbers and “…” now work properly under all tested circumstances.*
re-write was needed after the transient/offset changes.

_0.4.200411_
 * Fixed: offset now works as expected. * Was previously only working
for pageination, it now works with both pageination AND a starting offset.

_0.4.200403_
 * Updated Class names

_0.3.191125_
 * Fixing the ‘thumbnail’ and ‘more’ functions

_0.3.191113_
 * Added the custom class entry field that will place a class name 
in the wrapper element

_0.3.191007_
 * added the baility for the display input field to actually cause 
the output to be in that order

_0.2.181219_
 * fixed bug in include-post-by-id where display data was being cached
between multiple executions

_0.2.181214_
 * tested and functional

_0.1.181213_
 * self contained code, not reliant on functions from outside WP core

_0.1.181212_
 * FPL

## Meta

 *  Version **0.4.200706**
 *  Last updated **6 years ago**
 *  Active installations **10+**
 *  WordPress version ** 4.0 or higher **
 *  Tested up to **5.4.19**
 *  PHP version ** 5.2.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/vi-include-post-by/)
 * Tags
 * [options](https://pcd.wordpress.org/plugins/tags/options/)[params](https://pcd.wordpress.org/plugins/tags/params/)
   [post](https://pcd.wordpress.org/plugins/tags/post/)[shortcode](https://pcd.wordpress.org/plugins/tags/shortcode/)
   [vars](https://pcd.wordpress.org/plugins/tags/vars/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/vi-include-post-by/advanced/)

## Ratings

No reviews have been submitted yet.

[Add my review](https://wordpress.org/support/plugin/vi-include-post-by/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/vi-include-post-by/reviews/)

## Contributors

 *   [ Knighthawk ](https://profiles.wordpress.org/knighthawk/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/vi-include-post-by/)