Thorsten Frommen

Use the new Text Modules custom post type and display a text module by either shortcode or widget.
Have you ever wanted to use some pieces of text information more than once? For instance, contact information such as a postal address? Or some slogan, motto or claim?
This is exactly when Text Modules kicks in.
<h4>Usage</h4>
This plugin registers a simple post type for text modules. A text module can be accessed either via shortcode (by means of the text module’s ID or slug) or via a new Tex Modules widget.
Filters
In order to customize certain aspects of the plugin, it provides you with several filters. For each of these, a short description as well as a code example on how to alter the default behavior is given below. Just put the according code snippet in your theme’s <code>functions.php</code> file or your customization plugin, or to some other appropriate place.
<code>text_modules_after_widget_content</code>
This filter lets you alter the HTML after the widget content.
<pre><code>/**
 * Filter the HTML after the widget content.
 *
 * @param string $after_widget_content Some HTML after the widget content.
 */
add_filter( 'text_modules_after_widget_content', function() {

 return '';
} );
</code></pre>
<code>text_modules_before_widget_content</code>
This filter lets you alter the HTML before the widget content.
<pre><code>/**
 * Filter the HTML before the widget content.
 *
 * @param string $before_widget_content Some HTML before the widget content.
 */
add_filter( 'text_modules_before_widget_content', function() {

 return '';
} );
</code></pre>
<code>text_modules_post_type</code>
Yes, you can alter the post type (slug).
<pre><code>/**
 * Filter the post type.
 *
 * @param string $post_type Post type.
 */
add_filter( 'text_modules_post_type', function() {

 return 'exotic_stuff';
} );
</code></pre>
<code>text_modules_post_type_args</code>
If you want to alter a specific post type argument but you can’t find a fitting filter, there’s <code>text_modules_post_type_args</code>, which provides you with the complete args array.
<pre><code>/**
 * Filter the post type args.
 *
 * @param array $args Post type args.
 */
add_filter( 'text_modules_post_type_args', function( $args ) {

 // Use hierarchical external content
 $args[ 'hierarchical' ] = TRUE;

 return $args;
} );
</code></pre>
<code>text_modules_post_type_description</code>
The post type description can be customized by using the <code>text_modules_post_type_description</code> filter.
<pre><code>/**
 * Filter the post type description.
 *
 * @param string $description Post type description.
 */
add_filter( 'text_modules_post_type_description', function() {

 // Provide a description
 return 'Simple post type for text modules.';
} );
</code></pre>
<code>text_modules_post_type_labels</code>
In case you don’t like the labels, easily adapt them to your liking.
<pre><code>/**
 * Filter the post type labels.
 *
 * @param array $labels Post type labels.
 */
add_filter( 'text_modules_post_type_labels', function( $labels ) {

 // A little more horror, please...
 $labels[ 'not_found' ] = 'ZOMG, no text module found!!1!!1!!oneone!!!1!eleven!1!';

 return $labels;
} );
</code></pre>
<code>text_modules_post_type_supports</code>
This filter provides you with the post type supports.
<pre><code>/**
 * Filter the post type supports.
 *
 * @param array $supports Post type supports.
 */
add_filter( 'text_modules_post_type_supports', function( $supports ) {

 // Let's add revisions for our post type
 if ( ! in_array( 'revisions', $supports ) ) {
 $supports[] = 'revisions';
 }

 return $supports;
} );
</code></pre>
<code>text_modules_shortcode_apply_do_shortcode</code>
By default, do_shortcode() will be called on the shortcode output. Of course, you can change that.
<pre><code>/**
 * Filter if the shortcode should apply do_shortcode() to the output.
 *
 * @param bool $do_shortcode Should the shortcode apply do_shortcode()?
 */
add_filter( 'text_modules_shortcode_apply_do_shortcode', '__return_false' );
</code></pre>
<code>text_modules_shortcode_callback</code>
In case you would like to adapt how the shortcode data is handled, you can provide your own shortcode callback. This can either be a string holding the function name, or an array with either a class name or an object, and the according method.
<pre><code>/**
 * Filter the shortcode callback.
 *
 * @param array|string $callback Shortcode callback.
 */
add_filter( 'text_modules_shortcode_callback', function() {

 return 'my_text_modules_shortcode_callback';
} );
</code></pre>
<code>text_modules_shortcode_id_attribute_name</code>
This filter lets you alter the shortcode’s ‘id’ attribute name.
<pre><code>/**
 * Filter the 'id' shortcode attribute name.
 *
 * @param string $name Attribute name.
 */
add_filter( 'text_modules_shortcode_id_attribute_name', function() {

 return 'post_id';
} );
</code></pre>
<code>text_modules_shortcode_output</code>
This filter lets you alter the shortcode output. The second parameter holds the shortcode attributes array.
<pre><code>/**
 * Filter the shortcode output.
 *
 * @param string $output Shortcode output.
 * @param array $atts Shortcode attributes array.
 */
add_filter( 'text_modules_shortcode_output', function( $output ) {

 return $output . ' Over and out.';
} );
</code></pre>
<code>text_modules_shortcode_query_args</code>
Also, there’s <code>text_modules_shortcode_query_args</code>, which provides you with the complete args array for the shortcode’s query.
<pre><code>/**
 * Filter the shortcode query args.
 *
 * @param array $args Shortcode query args.
 */
add_filter( 'text_modules_shortcode_query_args', function( $args ) {

 // Exclude some text modules by ID
 $args[ 'post__not_in' ] = array( 4, 8, 15, 16, 23, 42 );

 return $args;
} );
</code></pre>
<code>text_modules_shortcode_slug_attribute_name</code>
This filter lets you alter the shortcode’s ‘slug’ attribute name.
<pre><code>/**
 * Filter the 'slug' shortcode attribute name.
 *
 * @param string $name Attribute name.
 */
add_filter( 'text_modules_shortcode_slug_attribute_name', function() {

 return 'post_slug';
} );
</code></pre>
<code>text_modules_shortcode_tag</code>
This filter lets you alter the shortcode’s tag.
<pre><code>/**
 * Filter the shortcode tag.
 *
 * @param string $shortcode_tag Shortcode tag.
 */
add_filter( 'text_modules_shortcode_tag', function() {

 return 'text_block';
} );
</code></pre>
<code>text_modules_shortcode_use_slug</code>
By default, text modules are being queried by their post ID first. Of course, you can change that and use the post slug instead.
<pre><code>/**
 * Filter if the shortcode (query) should use the post slug instead of the post ID.
 *
 * @param bool $use_slug Use slug instead of ID?
 */
add_filter( 'text_modules_shortcode_use_slug', '__return_true' );
</code></pre>
<code>text_modules_widget_form_query_args</code>
Also, there’s <code>text_modules_widget_form_query_args</code>, which provides you with the complete args array for the widget form’s query.
<pre><code>/**
 * Filter the widget form query args.
 *
 * @param array $args Query args.
 */
add_filter( 'text_modules_widget_form_query_args', function( $args ) {

 // Exclude some text modules by ID
 $args[ 'post__not_in' ] = array( 4, 8, 15, 16, 23, 42 );

 return $args;
} );
</code></pre>
<h4>Contribution</h4>
To contribute to this plugin, please see its <a href="https://github.com/tfrommen/text-modules" rel="nofollow ugc">GitHub repository</a>.
If you have a feature request, or if you have developed the feature already, please feel free to use the Issues and/or Pull Requests section.
Of course, you can also provide me with translations if you would like to use the plugin in another not yet included language.

Text Modules

Use the new Text Modules custom post type and display a text module by either shortcode or widget.

<h3>What does it do?</h3>
If you have a site with multiple subpages, you might have some positions in your template where you probably want to manage individual content (like a sidebar, a footer, a banner or whatever). The WordPress widgets can display content in specific widget-positions, but you can’t tell WordPress to only display your content on a certain page – That’s where my plugin comes in.
You can create different module positions, assign content and choose on which pages it will be shown. If you use WordPress as a CMS, this will be very helpful.
<h3>Create Module Positions</h3>
First, you can create different module positions. Rename these as you want. To put a module position in your template you can easily copy & paste the shortcode right next to the positions’s name. if you have already created content, you can drag and drop these around to change their order.
<h3>Create Content</h3>
Now, you can create content for your module positions. You can choose on which pages, categories or posts your content will be displayed. For this information your <a href="https://codex.wordpress.org/Appearance_Menus_Screen/" title="custom menus" rel="nofollow ugc">custom menus</a> will be loaded (which are defined in your template).
If there are categories with posts in your custom menu, click the “+”-button to show them. You also can choose on which posts your content will be displayed here.
<h3>Define your HTML-markup</h3>
In the little metabox on the right side, you can simply define your HTML-markup. Try writing <code>{{post_content}}</code> for your content and <code>{{post_title}}</code> for your title – A list of all values can be <a href="https://codex.wordpress.org/Function_Reference/get_post#Return" title="get_post" rel="nofollow ugc">found here</a>. To reset your markup just click on “Reset”, that will load the standard markup (which can be changed on the settings page).
<h3>Settings</h3>
<ul>
<li>Change your standard HTML-markup. If you click on “Reset” in your moduleposition-posts, this will be loaded.</li>
<li>Change the order of posts in the drop-down menus of your categories. That may be useful if you have a lot of posts in a category and you want to find a special post.</li>
</ul>
<h3>Missing something? Send me an e-mail!</h3>
I’m open to new ideas! Write me: kontakt@philipp-kuehn.com

Module Positions

A simplified equivalent to Joomla's module positions. Create module positions, assign content and choose on which pages it will be shown.

Text Modules vs Module Positions