Insert Pages

• Fixes quicktag button missing in WordPress 6.0 (also fixes "QTags is not defined) javascript error while editing posts).
• Add Simple WP Membership integration (content protected with Simple WP Membership will only be shown to authorized users or admins when inserted).

• Fix missing Visual Composer script/style enqueues.
• Tested up to WordPress 6.0.
• Bump gutenberg npm development dependencies.

• Add custom CSS/JS enqueue for inserted pages with blocks from the Ultimate Addons for Gutenberg plugin.
• Default to "normal" insert method instead of "legacy."
• Bump gutenberg development dependencies.

• Fix Insert Pages block styles affecting other blocks. Props @drsdre for the report!
• Fix gutenberg block deprecation notices.
• Tested up to WordPress 5.9.

• Security: Prevent unprivileged users from inserting private posts by others.
• Security: Filter out possible XSS in post meta using wp_kses_post() when using display=all.
• New Setting: Only show Authors and Contributors their own content in the TinyMCE Insert Pages popup.

• Fix TinyMCE dialog not closing properly. Props @astaryne for the report!

• Add insert_pages_tinymce_state filter to set TinyMCE modal field defaults. Details
• Add insert_pages_available_templates filter to customize the list of allowed custom templates. Details
• Update TinyMCE plugin to match changes in current wp-link dialog in core.
• Fix TinyMCE modal height on mobile.
• Ensure scripts/styles are loaded before adding TinyMCE plugin.

• Allow Insert Pages TinyMCE widget to run in a front-end wp_editor().

• Fix jQuery deprecation notices in WordPress 5.7.
• Tested up to WordPress 5.7.

• Allow adding query vars for the inserted page (for example, to insert a specific tab of the WooCommerce My Account page: [insert page=my-account display=content querystring=pagename=my-account&downloads]).
• Tested up to WordPress 5.6.1.

• Prevent Flamingo (Contact Forms 7 plugin) inbound messages with the same slug as an existing inserted page from showing up.

• Tested up to WordPress 5.5.1.
• Update gutenberg block loading method to newer version.
• Fix warning about Gutenberg block being registered multiple times if ACF is installed.
• Fix Gutenberg devDependency security warnings.
• Fix being unable to insert the same page twice if the first insert uses a custom template.

• Save users selected display and template in the TinyMCE dialog for restoring next time they insert a page. Props @ladygeekgeek for the idea!
• Tested up to WordPress 5.4.2.
• Bump lodash from 4.17.15 to 4.17.19 (dev dependency only).

• Support custom scripts and styles in inserted pages created with Visual Composer version 26.0.

• Fix for loop detection: we had accidentally prevented pages from inserting another page multiple times (not in a loop).

• Revert change affecting Elementor using legacy insert method. Props @progameinc for reporting it so quickly!

• Update Gutenberg block (replace deprecated calls).
• Add automatic loop detection; nested inserts now work by default.
• Deprecate insert_pages_apply_nesting_check filter since it's now unnecessary.

• Add FAQ for creating a custom template. Details
• Parse <!--nextpage--> separators in Content and All displays on legacy insert mode. Details
• Add support for custom templates for Insert Pages within Elementor and Beaver Builder. Details

• Fix Gutenberg block assets (js, css) loading on front end.
• Add option to disable Insert Pages Gutenberg block.

• Add Gutenberg block.
• Fix for WSOD in WordPress versions before 5.0 (unintentionally included Gutenberg block in last release).
• Fix PHP warnings in some contexts.

• Larger Insert Page modal height in Classic Editor (accommodate larger WP 5.3 form elements).
• Update npm packages (gutenberg build dependencies).
• Tested up to WordPress 5.3.

• Respect <!--more--> quicktag in excerpt and excerpt-only displays (in normal insert method).
• Add a custom <!--crop--> quicktag in excerpt and excerpt-only displays (in normal insert method). Excerpt can be trimmed to anything between <!--crop--> and <!--more--> quicktags.

• Fix for nested inserted pages all using custom templates. Props @masterbip for discovering the issue!

• Fix incorrect link in excerpt's 'Continue reading' link. Props @bogyo74 for discovering the bug!
• Fix empty id attribute rendering if no custom ID provided. Props @theschappy for finding and fixing this bug!

• Add 'id' shortcode param that sets the html id attribute on the wrapper element for an inserted page. Useful for anchor links. Props @Seb33300 for the suggestion!
• Fix for WPBakery Visual Composer inline styles in inserted pages. Props @Seb33300 for the pull request!

• Add 'public' shortcode param that lets private inserted pages be visible to anonymous users. Props @ahtcx for the suggestion.
• Fix for inserted pages shown on BuddyPress profiles. Props @IdleWanderer for the report!
• Fix for querystring option missing from widget settings.

• Fix for Elementor rendering in legacy mode.
• Fix for Post Thumbnail display in legacy mode.

• Add integration with WPBakery Page Builder (Visual Composer).
• Fix error messages about deprecated functions in PHP 7.2.
• Adhere to WordPress Coding Standards.

• Fix custom field values coming from parent post in certain contexts. Props @chrisneward for catching it!
• Add post-thumbnail display to output just the featured image of a post. Props @pereztroff for the feature request.

• Add querystring parameter to the shortcode to pass custom querystring values to any custom templates.

Example: [insert page='your-page' display='your-custom-template.php' querystring='foo=bar&baz=qux']

Note: If you need to use arrays in your querystring variables, use braces {} instead of brackets [], since WordPress shortcodes cannot have brackets inside them. The plugin will convert the braces internally. Example: querystring='foo[]=bar&foo[]=baz'

• Add support for inserting pages/posts built with Elementor.

• Add insert_pages_override_display filter so site admins can enforce a specific display on all inserted pages.

• Fix for custom templates issues on certain platforms (e.g., Windows).

• Support looking up hierarchical pages by slug; insert hierarchical pages by path (not slug).
• Fix for php warning when displaying meta values that are strings instead of arrays.

• Restrict custom template paths to theme directory (prevent directory traversal attacks).

• Fix for loading inline CSS from SiteOrigin Page Builder version 2.5 or later. Props @alexgso for the pull request!

• Revert TinyMCE filter hook to 3.1.9 method due to continued Divi theme compatibility issues.
• Add configurable option to load TinyMCE filter in a different location to support SiteOrigin PageBuilder users.
• Fix missing JS on front-end ACF forms with WYSIWYG editors.

• Revert TinyMCE filter move for SiteOrigin PageBuilder since it breaks compatibility with Divi theme. Instead, hook into the filter multiple times, and make sure the Insert Pages button is registered each time. Props @trevorp for the report.

• Fix for toolbar button disappearing when the SiteOrigin PageBuilder Widgets Bundle plugin is enabled. Props @JarkkoLaine for figuring that one out! Ref: https://wordpress.org/support/topic/button-in-the-toolbar-of-tinymce-disappear-conflict-page-builder/

• Support shortcode_atts_insert filter for filtering the shortcode's default attributes. Props @gtrout for the pull request!

• Fix for widget being used in the Beaver Builder widget interface.

• Plugin is now translatable (internationalization). Props @maxgx for getting the ball rolling and creating a translation.

• Fix for TinyMCE toolbar button not appearing for authors and contributors. Props @fernandosalvato for the report.
• Fix for deprecation warning in PHP 7. Props @christer_f for the report.

• Fix for php warning when inserting page outside of The Loop while using Beaver Builder. Props @jeffreytanuwidjaja for the report.

• Compatibility for for php versions lower than 5.3. Replace closure with create_function().

• Prevent menu items and page attachments from being insertable; this fixes problems with inserting pages via slug when there is a menu item with the same slug as a page/post. Props @k7f7 for tracking this one down!

• Fix for custom template dropdown not enabling when configuring the widget on the theme customizer page (customize.php). Props @aassouad for finding this!

• Fix: Add compatibility for PHP 5.2 in the widget registration code. See https://codex.wordpress.org/Widgets_API

• Feature: Insert Page widget. Go to Appearance > Widgets to add the Insert Page widget to any of your widget areas. Specify a page slug or ID in the widget, and that page will get displayed in the widget area.

• Hotfix: Inserting posts with custom paths using legacy insert method.

• Hotfix: Version 3 broke some plugin compatibility (most notably with Beaver Builder and Page Builder by SiteOrigin). This update should restore functionality.
• Hotfix: Version 3 broke some page displays (e.g., content, all). This update should restore functionality.

• Hotfix: 2.9.1 broke extra classes added to the inserted page wrapper.
• Feature: Expose extra classes and inline status in tinymce dialog.
• One more API change to insert_pages_wrap_content_filter (2nd parameter is a WP_Post now instead of an array of WP_Posts, since we only ever insert one page). Example 1: `/**
  • Enable nested shortcodes by hooking into insert_pages_wrap_content. *
  • @param string $content The post content of the inserted page.
  • @param array $inserted_page The post object returned from querying the inserted page.
  • @param array $attributes Extra parameters modifying the inserted page.
  • page: Page ID or slug of page to be inserted.
  • display: Content to display from inserted page.
  • class: Extra classes to add to inserted page wrapper element.
  • inline: Boolean indicating wrapper element should be a span.
  • should_apply_nesting_check: Whether to disable nested inserted pages.
  • should_apply_the_content_filter: Whether to apply the_content filter to post contents and excerpts.
  • wrapper_tag: Tag to use for the wrapper element (e.g., div, span). / function your_custom_wrapper_function( $content, $inserted_page, $attributes ) { return do_shortcode( $content ); } add_filter( 'insert_pages_wrap_content', 'your_custom_wrapper_function', 9, 3 ); Example 2: /*
  • Completely modify markup generated by Insert Pages by hooking into insert_pages_wrap_content. *
  • @param string $content The post content of the inserted page.
  • @param array $inserted_page The post object returned from querying the inserted page.
  • @param array $attributes Extra parameters modifying the inserted page.
  • page: Page ID or slug of page to be inserted.
  • display: Content to display from inserted page.
  • class: Extra classes to add to inserted page wrapper element.
  • inline: Boolean indicating wrapper element should be a span.
  • should_apply_nesting_check: Whether to disable nested inserted pages.
  • should_apply_the_content_filter: Whether to apply the_content filter to post contents and excerpts.
  • wrapper_tag: Tag to use for the wrapper element (e.g., div, span). */ function your_custom_wrapper_function( $content, $inserted_page, $attributes ) { // Remove the default filter that wraps the content in a div or span. remove_all_filters( 'insert_pages_wrap_content', 10 ); // Return your custom wrapper around the content. return "
    $content
    "; } add_filter( 'insert_pages_wrap_content', 'your_custom_wrapper_function', 9, 3 );`

• API Change: modify insert_pages_wrap_content filter. Props @heiglandreas. Example 1: `/**
  • Enable nested shortcodes by hooking into insert_pages_wrap_content. *
  • @param string $content The post content of the inserted page.
  • @param array $posts The array of post objects (typically 1) returned from querying the inserted page.
  • @param array $attributes Extra parameters modifying the inserted page.
  • page: Page ID or slug of page to be inserted.
  • display: Content to display from inserted page.
  • class: Extra classes to add to inserted page wrapper element.
  • inline: Boolean indicating wrapper element should be a span.
  • should_apply_nesting_check: Whether to disable nested inserted pages.
  • should_apply_the_content_filter: Whether to apply the_content filter to post contents and excerpts.
  • wrapper_tag: Tag to use for the wrapper element (e.g., div, span). / function your_custom_wrapper_function( $content, $posts, $attributes ) { return do_shortcode( $content ); } add_filter( 'insert_pages_wrap_content', 'your_custom_wrapper_function', 9, 3 ); Example 2: /*
  • Completely modify markup generated by Insert Pages by hooking into insert_pages_wrap_content. *
  • @param string $content The post content of the inserted page.
  • @param array $posts The array of post objects (typically 1) returned from querying the inserted page.
  • @param array $attributes Extra parameters modifying the inserted page.
  • page: Page ID or slug of page to be inserted.
  • display: Content to display from inserted page.
  • class: Extra classes to add to inserted page wrapper element.
  • inline: Boolean indicating wrapper element should be a span.
  • should_apply_nesting_check: Whether to disable nested inserted pages.
  • should_apply_the_content_filter: Whether to apply the_content filter to post contents and excerpts.
  • wrapper_tag: Tag to use for the wrapper element (e.g., div, span). */ function your_custom_wrapper_function( $content, $posts, $attributes ) { return "
    $content
    "; } add_filter( 'insert_pages_wrap_content', 'your_custom_wrapper_function', 11, 3 );`

• Add filter for altering the markup generated by Insert Pages. This filter is used internally at priority 10, so if you want to modify $content, do it earlier (priority 1-9); if you want to reconstruct the generated markup using the supplied parameters, do it after (priority 11+). Example 1: `/**
  • Enable nested shortcodes by hooking into insert_pages_wrap_content. *
  • @param string $wrapper_tag The html element to wrap the content in (typically div or span).
  • @param string $extra_classes Space-delimited list of classes to add to the wrapper element.
  • @param int $post_id The ID of the inserted page.
  • @param string $content The post content of the inserted page. / function your_custom_wrapper_function( $wrapper_tag, $extra_classes, $post_id, $content ) { return do_shortcode( $content ); } add_filter( 'insert_pages_wrap_content', 'your_custom_wrapper_function', 9, 4 ); Example 2: /*
  • Completely modify markup generated by Insert Pages by hooking into insert_pages_wrap_content. *
  • @param string $wrapper_tag The html element to wrap the content in (typically div or span).
  • @param string $extra_classes Space-delimited list of classes to add to the wrapper element.
  • @param int $post_id The ID of the inserted page.
  • @param string $content The post content of the inserted page. */ function your_custom_wrapper_function( $wrapper_tag, $extra_classes, $post_id, $content ) { return "
    $content
    "; } add_filter( 'insert_pages_wrap_content', 'your_custom_wrapper_function', 11, 4 );`

• Feature: Add options page with option to insert page IDs instead of page slugs (users of WPML will need this feature if translated pages all share the same page slug).
• Feature: Inserted pages with Beaver Builder enabled now embed correctly.
• Fix: TinyMCE toolbar button states (active, disabled) have been fixed.
• Fix: TinyMCE cursor detection inside an existing shortcode has been fixed.
• Fix: Expanded options in Insert Pages popup now correctly remembers last choice.
• Fix: Restore missing spinners in search dialog.
• Fix: prevent PHP warning when rendering wp_editor() outside of edit context. Props Jerry Benton.

• Add shortcode attribute to wrap inserted content in an inline element (span) instead of a block level element (div). Example usage: Lorem ipsum [insert page='my-page' display='content' inline] dolor sit amet.
• Add filter to wrap inserted content in an inline element (span) instead of a block level element (div). Example usage: function theme_init() { // Show a message in place of an inserted page if that page cannot be found. add_filter( 'insert_pages_use_inline_wrapper', function ( $should_use_inline_wrapper ) { return true; } ); } add_action( 'init', 'theme_init' );

• Add filter to show a message when an inserted page cannot be found. Example usage: function theme_init() { // Show a message in place of an inserted page if that page cannot be found. add_filter( 'insert_pages_not_found_message', function ( $content ) { return 'Page could not be found.'; } ); } add_action( 'init', 'theme_init' );

• Fix: Prevent Insert Pages from breaking tinymce if wp_editor() is called outside of an admin context.

• Fix: Query data wasn't getting reset properly when viewing a category archive containing a post with an inserted page, causing date and author information in post footers in the twentyfifteen theme to show incorrect information. This has been resolved.

• Maintenance release: prevent infinite loops when using a custom template that doesn't call the_post().

• Add insert_pages_apply_nesting_check filter. Use it to disable the deep nesting check which prevents inserted pages from being embedded within other inserted pages. Example usage: function theme_init() { // Disable nesting check to allow inserted pages within inserted pages. add_filter( 'insert_pages_apply_nesting_check', function ( $should_apply ) { return false; } ); } add_action( 'init', 'theme_init' );

• Update for WordPress 3.9 (update to work under tinymce4);
• Can now edit existing shortcodes (click inside them, then click the toolbar button).