=== Include ===

Contributors: mflynn, cngann, Clear_Code, bmcswee, flynndev
Tags: shortcode,shortcodes,page,pages,post,posts,loop,the loop,include,include other post,include other page,get,utilities,fetch,content
Requires at least: 2.5
Tested up to: 5.2
Stable tag: 4.0.25
License: GPL-3.0
License URI: https://spdx.org/licenses/GPL-3.0.html

Include one Page or Post into another.

== Description ==

The Include plugin for WordPress allows you to include the content of one page, post, or other such WordPress object into any other with a shortcode.


**Shortcode: `[include]`**

*Parameters*

* id: the page/post/etc id to use
* slug: the page slug to use to find the ID
* title: the type of element to wrap the title with.  If set to "" no title will be displayed.
 * Default: h2
* title_class: a class to assign to the title
* wrap: the type of element to wrap the entire include area with.  If set to "" no wrap will be applied.
 * Default: div
* wrap_class: a class you want assigned to the wrap.
 * Default: 'included'
* hr: Display a hr before the include.  Set to "" to not display the hr.
* recursion:
 * Options:
  * strict: only show first page, do not run `[include]` if it's included
  * weak: only filter out shortcodes with the same id as the current shortcode to prevent infinite loops
 * Default: weak

*Depreciated Parameters*

These parameters are depreciated, but still supported (for now).

* title_wrapper_elem: old name for title
* title_wrapper_class: old name for title_class

*Example*

`[include id="XXX" title="true" title_elem="h2" title_class="include-title" hr="" recursion="weak" wrap="article" wrap_class="news"]`
`[include slug="hello-world"]`

A shortcode that includes other posts / pages with no nesting of the shortcode, to allow for multiple pages to call each other so that they display their chunks in different orders.

**Shortcode: `[include_children]`**

*Parameters*

* id: the page/post/etc id to use
* slug: the page slug to use to find the ID
* title: the type of element to wrap the title with.  If set to "" no title will be displayed.
 * Default: h2
* title_class: a class to assign to the title
* wrap: the type of element to wrap the entire include area with.  If set to "" no wrap will be applied.
 * Default: div
* wrap_class: a class you want assigned to the wrap.
 * Default: 'included'
* hr: Display a hr before the include.  Set to "" to not display the hr.
* recursion:
 * Options:
  * strict: only show first page, do not run `[include]` if it's included
  * weak: only filter out shortcodes with the same id as the current shortcode to prevent infinite loops
 * Default: weak

*Depreciated Parameters*

These parameters are depreciated, but still supported (for now).

* title_wrapper_elem: old name for title
* title_wrapper_class: old name for title_class

Same as Include, except that if no ID is given, it includes all child pages of the current page, in order.
If an ID is given it includes the child pages of that page, in order.

== Screenshots ==



== Changelog ==

= 4.0.3 =
* Attempting to override server setting conflict with Mustache

= 4.0.0 =
* Updated Include to use new WP_Query Method of nested looping instead of cloning $wpdb
* Updated this to use my PluginFramework

= 3.4.48 =
* Adding Pugin Framework

= 3.4.41 =
* Fixed Tag Overriding Error 

= 3.4.23 =
* Removing Banner
* Adding Grunt and SH Builder

= 3.4.0 =
* Adding Auto-Deploy Script

= 3.3 =
* Updated Compatibility

= 3.2 =
* Fixed Bug: Title remained constant across multiple includes.  Thanks for the report and solution by: isundil.
* Removed comments that were basically notes from initial Development

= 3.1 =
* Fixed bug: Lack of support for custom post types.

= 3.0 =
* Fixed bug: Not working for posts.  Thanks to stovesy for the code.

= 2.6 =
* Fixed bug: Multiple instance of the same include failing.

= 2.5 = 
* Fix for sizable bug.  Settings panel didn’t do anything… Now it does.

= 2.4 =
* Fix for 2.3 array bug

= 2.3 =
* Updated documentation to be displaying the correct information.
* Code Cleanup

= 2.0 =
* Addition of wrap attribute
* Addition of wrap_class attribute
* Addition of include_children shortcode

= 1.7.1 =
* Bugfix for site php error

= 1.7 =
* Added Full PHPdoc Documentation and Line-By-Line comments for what's happening

= 1.6 =
* Added anchor tag

= 1.4 =
* Added Documentation

= 1.3 =
* Removed dependency on PHP 5.3+
* Determined correct "requires at least" version

= 1.2 =
* Added 'hr' Parameter
* Added changelog
* Added cngann as author

= 1.0 =
* First Check-In
1. Activate the plugin through the 'Plugins' menu in WordPress


== Upgrade Notices ==

= 4.0.24 =
+ Removed fopen dependancy to allow for compatability with more servers

= 4.0.14 =
+ Requires Server Setting: allow_url_fopen

= 4.0.3 =
+ PHP Version Requirement: >=  5.4.0 

= 4.0.0 =
+ Please make sure you know what your options are before you update this plugin, as the update may lose those options.  Sorry, this is a complete rewrite of the plugin.

= 3.4.41 =
+ Fixed Tag Overriding Error

= 3.2 =
* Fixed Bug: Title remained constant across multiple includes.

= 3.1 =
* Fixed bug: Lack of support for custom post types.

= 3.0 =
* Now works with Posts again.