Ingeni Content Blocks

=== Ingeni Custom Post Widget === Contributors: vanderwijk, Bruce McKinnon Tags: widget, sidebar, content block, block, custom, post, shortcode, wysiwyg, wpml, featured image Requires at least: 4.0 Tested up to: 5.7 Stable tag: 3.1.6 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html

This plugin enables you to edit and display Content Blocks in a sidebar widget or using a shortcode.

== Description ==

The Content Blocks allows you to display the contents of a specific custom post in a widget on in the content area using a shortcode.

Even though you could use the text widget that comes with the default WordPress install, this plugin has some major benefits:

• The Content Blocks plugin enables users to use the WYSIWYG editor for editing the content and adding images.
• If you are using the standard WordPress text widgets to display content on various areas of your template, this content can only be edited by users with administrator access. If you would like non-administrator accounts to modify the widget content, you can use this plugin to provide them access to the custom posts that provide the content for the widget areas.
• You can even use the featured image functionality to display them in a widget.
• The Content Blocks plugin is compatible with the WPML Multi-Language plugin and automatically shows the correct language in the widget area.
• The Content Blocks can be included in posts and pages using the built-in shortcode functionality.

This plugin creates a 'content_block' custom post type. You can choose to either display the title on the page or use it to describe the contents and widget position of the content block. Note that these content blocks can only be displayed in the context of the page. I have added 'public' => false to the custom post type which means that it is not accessible outside the page context.

To add content to a widget, drag it to the required position in the sidebar and select the title of the custom post in the widget configuration.

Includes the following translations:

• Swedish (sv_SE) by Andreas Larsson
• Spanish (es_ES) by IBIDEM GROUP
• Portuguese (pt_BR) by Ronaldo Chevalier
• Polish (pl_PL) by Kuba Skublicki
• Dutch (nl_NL) by Johan van der Wijk
• Czech (cs_CZ) by Martin Kucera

More translations are very welcome!

== Screenshots ==

1. After activating the plugin a new post type called 'Content Blocks' is added.
2. The widget has a select box to choose the content block. Click on the 'Edit Content Block' link to edit the selected Content Block custom post.
3. You will find a button above the WYSIWYG editor that allows you to insert the content block using the shortcode.
4. After clicking the 'Add Content Block' button you can select a content block and insert the shortcode in the content area.

== Installation ==

1. First you will have to upload the plugin to the /wp-content/plugins/ folder.
2. Then activate the plugin in the plugin panel. You will see that a new custom post type has been added called Content Block.
3. Type some content for the widget. You can choose to either use the title to describe the content on the page, or to display it. Check 'Show Post Title' to display the title on the page.
4. Go to 'Appearance' > 'Widgets' and drag the Content Block widget to the required position in the sidebar.
5. Select a Content Block from the drop-down list.
6. Check the 'Show Post Title' checkbox if you would like to display the title of your Content Block
7. If you are experiencing issues with content being added automatically to your posts (Social media sharing buttons for instance), check the 'Do not apply content filters' checkbox. Use this with caution!
8. Click save.

== Frequently Asked Questions ==

= Why can't I use the default text-widget? =

Of course you can always use the default text widget, but if you prefer to use the WYSIWYG editor or if you have multiple editors and you don't want to give them administrator rights, it is recommended to use this plugin.

= How can I show the content bock on a specific page? =

It is recommended to install the Widget Logic plugin, this will give you complete flexibility on widget placement.

= How can I display the featured image in the widget? =

This plugin has built-in support for the featured image functionality on the edit screen. Note that featured image will not be resized, so you will have to make sure it is the right size when uploading or restrict the image size via the stylesheet.

= My social sharing plugin adds buttons to all the Content Block areas =

If your social media sharing plugin adds buttons to the widget areas you could check the 'Do not apply content filters' checkbox. Note that when this is done, WordPress will also stop adding paragraph tags to your text, so use this setting with caution. It is much better to ask the developer of the social media sharing buttons plugin to correctly use the content filters (see http://pippinsplugins.com/playing-nice-with-the-content-filter/ for more information on this). If you are embedding your content block with the shortcode, add the following: suppress_content_filters="yes"

= The featured image is not displayed when using the shortcode =

Currently the shortcode function only outputs the post content and title of the content block, future support for displaying the attached featured image is being considered.

= Can I change the output of the content blocks? =

Yes, you can create your own template for the content blocks, you can do so by adding a file named custom-post-widget.php to your theme folder. More information about this can be found in this support topic

In the example-templates folder of this plugin you can find examples of templates for shortcodes and for widgets.

= I have a feature request =

Please post your feature request on the support forum These new features are on the to-do list:

• Display the content block featured image when using the shortcode
• Front-end editing of the content blocks
• Visual Composer integration

= How can I make advanced changes to the widget layout? =

You can create your own widget template and upload this to your theme folder. See this support topic for more information about this feature.

= Can I make the post type public? =

You can make the post type public by adding the following code to your theme's functions.php file: function filter_content_block_init() { $content_block_public = true; return $content_block_public; } add_filter('content_block_post_type','filter_content_block_init');

Alternatively you can use this third-party plugin.

= Post ID's confuse me, can I use the post slug for embedding a content block? =

Yes, v2.6 now gives you the option to use the content block's url slug in the shortcode. Use the following syntax for doing this: [content_block slug=my-content-block]. Note that if you ever change the slug of a content block, the embedding no longer works. Therefore I recommend using the post ID instead (which never changes).

= Can I specify a custom class for the embedded content blocks? =

By default the shortcode adds a div around the content block with the class content_block. If you like, you can change this class by adding it to the shortcode: [content_block id=198 slug=our-wordpress-plugins class=my-class]

= How can I embed a content block in my template file using php code? =

You can use the do_shortcode function for this: echo do_shortcode('[content_block id= ]');

See http://codex.wordpress.org/Function_Reference/do_shortcode for more information on this function.

= The plugin is not working for me =

Please create a support topic in the forum: http://wordpress.org/support/plugin/custom-post-widget DO NOT click the 'Broken' button in the compatibility area of the plugin directory before creating a support ticket. It is very demotivating for me to see the plugin downloads drop dramatically without being given the chance to help you!

= I love your plugin! What can I do to help? =

Creating and supporting this plugin takes up a lot of my free time, therefore I would highly appreciate it if you could take a couple of minutes to write a review. This will help other WordPress users to start using this plugin and keep me motivated to maintain and support it. Also, if you have a twitter, Facebook or Google+ account, it would be fantastic if you could share the link to this plugin!

== Changelog ==

v2026.01 - Update code - ported security fixes from ContentBlocks plugin

• Updated to PluginUpdateChecker v5.6 v2023.01 - post-type.php - Fix for PHP 8 - strtotime() - do not pass a null to value as param #1

v2022.04 - Fixed various problems around loading CPT meta boxes (meta-box.php) and it's supporting CSS file.

v2022.03 - Make sure wp-admin/includes/plugin.php gets loaded before calling get_plugin_data().

v2022.02 - Left some debug logging in shortcode.php

v2022.01 - Fixed issue with undefined located variable in shortcode.php

V2021.02 - Added support for 'custom-fields' and 'excerpt'

2021.01 - Split off into Ingeni Content Blocks

= 3.2 = Thanks to Bruce from Ingeni Web Solutions it is now possible to use your own template for embedding the custom post shortcode.

= 3.1.6 = Compatibility testing. Also tested on PHP8 and found no issues.

= 3.1.5 = Spanish translation added and readme.txt file updates.

= 3.1.4 = Minor bugfix and upgrade for the clipboard.js script. Thanks to https://wordpress.org/support/users/vikaspandeyd/ for reporting this!

= 3.1 = You can now use a custom html tag to wrap the content block when using a shortcode. See https://wordpress.org/support/topic/add-support-for-spans/ for more information and usage.

= 3.0.4 = Added Gutenberg compatibility for editing content blocks. This is for editing content blocks only. There is no block button yet for inserting a content block in the Gutenberg editor, so you will have to choose the 'Shortcode' widget and insert your content block shortcode there.

= 3.0.3 = Added the option to show the featured image in when using the shortcode. Add featured_image=yes to the shortcode to show it: [content_block featured_image=yes]. By default the medium image size is displayed, you can change it like this: [content_block featured_image=yes featured_image_size=full].

= 3.0.2 = Tested for WordPress 4.8 compatibility.

= 3.0.1 = Added html sanitizing to the Content Block post titles. Thanks to @palpatine1976 for bringing this to my attention.

= 3.0 = Renamed the plugin to Content Blocks to better reflect the purpose.

= 2.9.2 = Minor layout change to the Shortcodes meta box.

= 2.9 = Removed the admin notice, added donation link to plugin overview page. Shortcodes are now displayed on the content block edit screen, thanks to Remkus for suggesting this feature.

= 2.8.5 = Fix for minor compatibility issue when using the Slider Revolution plugin

= 2.8.4 = You can now optionally show the post title when using the shortcode by adding title=yes to the shortcode

= 2.8.3 = Added Hebrew translation as provided by Daniel Cohen Gindi

= 2.8.1 = Updated language files.

= 2.8 = Added the option to suppress the content filters when using the shortcode. Thanks to adelval for providing the code, see https://wordpress.org/support/topic/add-option-to-not-apply-content-filters-in-shortcode?replies=4

= 2.7.9 = Changed method for creating the widget in preparation of PHP7 support.

= 2.7.7 = Added Czech translation.

= 2.7.6 = Added Italian translation.

= 2.7.5 = Updated branding and language files.

= 2.7.4 = The shortcode now includes the slug of the content block (which is still optional), see https://wordpress.org/support/topic/shortcodes-using-slug-name-rather-than-id for more information on this.

= 2.7.2 = The post status is now used for displaying the content blocks in the widget areas, only published content blocks are now displayed. Thanks to tmbdesign.co.uk for suggesting this change.

= 2.7 = Added dismissable support notification.

= 2.6 = Added the possibility for using the content block slug in the shortcode.

= 2.5.7 = Changed the way the button above the content editor is inserted. For background see: http://wordpress.org/support/topic/soliloquy-conflict-1?replies=2

= 2.5.3 = Added filter to 'public' value of the content_block post type to make it possible to use the Visual Composer plugin. See support topic: http://wordpress.org/support/topic/make-post-type-public

= 2.5.2 = Changed require to require_once in custom-post-widget.php to solve a possible issue reported by John Sundberg. Updated SE translation files as provided by Andreas Larsson.

= 2.5 = Added 'Content Block Information' to overview page, updated styling to reflect new 3.8 interface and rewrote javaScript code for inserting shortcode tag

= 2.4.5 = 2.4.5 javaScript fix for inserting shortcode tag

= 2.4.4 = Added unique ID to each content block that is inserted using the shortcode functionality

= 2.4.3 = Changed the way the shortcode button above the editor is called.

= 2.4 = You can now add a description to the content b