{"id":37780,"date":"2015-07-24T12:56:17","date_gmt":"2015-07-24T12:56:17","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/text-modules\/"},"modified":"2015-08-20T00:32:39","modified_gmt":"2015-08-20T00:32:39","slug":"text-modules","status":"publish","type":"plugin","link":"https:\/\/azb.wordpress.org\/plugins\/text-modules\/","author":14599396,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.1","stable_tag":"trunk","tested":"4.3.34","requires":"3.0.0","requires_php":"","requires_plugins":"","header_name":"Text Modules","header_author":"Thorsten Frommen","header_description":"","assets_banners_color":"","last_updated":"2015-08-20 00:32:39","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/ipm-frommen.de\/wordpress","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/text-modules\/","header_author_uri":"http:\/\/ipm-frommen.de\/wordpress","rating":5,"author_block_rating":0,"active_installs":50,"downloads":2359,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"1205728","resolution":"128x128","location":"assets"},"icon-256x256.png":{"filename":"icon-256x256.png","revision":"1205728","resolution":"256x256","location":"assets"}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1225711","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1225711","resolution":"2","location":"assets"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1225711","resolution":"3","location":"assets"}},"screenshots":{"1":"List table<\/strong> - Here you can see all text modules together with their individual slug and shortcode.","2":"Meta box<\/strong> - Here you can see the currently edited text module's shortcode.","3":"Widget<\/strong> - Use any text module in a Text Module widget."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1794,5851,10447,86,749],"plugin_category":[],"plugin_contributors":[80310],"plugin_business_model":[],"class_list":["post-37780","plugin","type-plugin","status-publish","hentry","plugin_tags-custom-post-type","plugin_tags-module","plugin_tags-modules","plugin_tags-post","plugin_tags-text","plugin_contributors-ipm-frommen","plugin_committers-tfrommen"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/text-modules\/assets\/icon-128x128.png?rev=1205728","icon_2x":"https:\/\/ps.w.org\/text-modules\/assets\/icon-256x256.png?rev=1205728","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/text-modules\/assets\/screenshot-1.png?rev=1225711","caption":"List table<\/strong> - Here you can see all text modules together with their individual slug and shortcode."},{"src":"https:\/\/ps.w.org\/text-modules\/assets\/screenshot-2.png?rev=1225711","caption":"Meta box<\/strong> - Here you can see the currently edited text module's shortcode."},{"src":"https:\/\/ps.w.org\/text-modules\/assets\/screenshot-3.png?rev=1225711","caption":"Widget<\/strong> - Use any text module in a Text Module widget."}],"raw_content":"\n

Use the new Text Modules custom post type and display a text module by either shortcode or widget.<\/strong><\/p>\n\n

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?<\/p>\n\n

This is exactly when Text Modules<\/em> kicks in.<\/p>\n\n

Usage<\/h4>\n\n

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.<\/p>\n\n

Filters<\/strong><\/p>\n\n

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 functions.php<\/code> file or your customization<\/em> plugin, or to some other appropriate place.<\/p>\n\n

text_modules_after_widget_content<\/code><\/strong><\/p>\n\n

This filter lets you alter the HTML after the widget content.<\/p>\n\n

\/**\n * Filter the HTML after the widget content.\n *\n * @param string $after_widget_content Some HTML after the widget content.\n *\/\nadd_filter( 'text_modules_after_widget_content', function() {\n\n    return '<!-- End of Text Modules widget content -->';\n} );\n<\/code><\/pre>\n\n
text_modules_before_widget_content<\/code><\/strong><\/p>\n\n
This filter lets you alter the HTML before the widget content.<\/p>\n\n
\/**\n * Filter the HTML before the widget content.\n *\n * @param string $before_widget_content Some HTML before the widget content.\n *\/\nadd_filter( 'text_modules_before_widget_content', function() {\n\n    return '<!-- Start of Text Modules widget content -->';\n} );\n<\/code><\/pre>\n\n
text_modules_post_type<\/code><\/strong><\/p>\n\n
Yes, you can alter the post type (slug).<\/p>\n\n
\/**\n * Filter the post type.\n *\n * @param string $post_type Post type.\n *\/\nadd_filter( 'text_modules_post_type', function() {\n\n    return 'exotic_stuff';\n} );\n<\/code><\/pre>\n\n
text_modules_post_type_args<\/code><\/strong><\/p>\n\n
If you want to alter a specific post type argument but you can't find a fitting filter, there's text_modules_post_type_args<\/code>, which provides you with the complete args array.<\/p>\n\n
\/**\n * Filter the post type args.\n *\n * @param array $args Post type args.\n *\/\nadd_filter( 'text_modules_post_type_args', function( $args ) {\n\n    \/\/ Use hierarchical external content\n    $args[ 'hierarchical' ] = TRUE;\n\n    return $args;\n} );\n<\/code><\/pre>\n\n
text_modules_post_type_description<\/code><\/strong><\/p>\n\n
The post type description can be customized by using the text_modules_post_type_description<\/code> filter.<\/p>\n\n
\/**\n * Filter the post type description.\n *\n * @param string $description Post type description.\n *\/\nadd_filter( 'text_modules_post_type_description', function() {\n\n    \/\/ Provide a description\n    return 'Simple post type for text modules.';\n} );\n<\/code><\/pre>\n\n
text_modules_post_type_labels<\/code><\/strong><\/p>\n\n
In case you don't like the labels, easily adapt them to your liking.<\/p>\n\n
\/**\n * Filter the post type labels.\n *\n * @param array $labels Post type labels.\n *\/\nadd_filter( 'text_modules_post_type_labels', function( $labels ) {\n\n    \/\/ A little more horror, please...\n    $labels[ 'not_found' ] = 'ZOMG, no text module found!!1!!1!!oneone!!!1!eleven!1!';\n\n    return $labels;\n} );\n<\/code><\/pre>\n\n
text_modules_post_type_supports<\/code><\/strong><\/p>\n\n
This filter provides you with the post type supports.<\/p>\n\n
\/**\n * Filter the post type supports.\n *\n * @param array $supports Post type supports.\n *\/\nadd_filter( 'text_modules_post_type_supports', function( $supports ) {\n\n    \/\/ Let's add revisions for our post type\n    if ( ! in_array( 'revisions', $supports ) ) {\n        $supports[] = 'revisions';\n    }\n\n    return $supports;\n} );\n<\/code><\/pre>\n\n
text_modules_shortcode_apply_do_shortcode<\/code><\/strong><\/p>\n\n
By default, do_shortcode() will be called on the shortcode output. Of course, you can change that.<\/p>\n\n
\/**\n * Filter if the shortcode should apply do_shortcode() to the output.\n *\n * @param bool $do_shortcode Should the shortcode apply do_shortcode()?\n *\/\nadd_filter( 'text_modules_shortcode_apply_do_shortcode', '__return_false' );\n<\/code><\/pre>\n\n
text_modules_shortcode_callback<\/code><\/strong><\/p>\n\n
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.<\/p>\n\n
\/**\n * Filter the shortcode callback.\n *\n * @param array|string $callback Shortcode callback.\n *\/\nadd_filter( 'text_modules_shortcode_callback', function() {\n\n    return 'my_text_modules_shortcode_callback';\n} );\n<\/code><\/pre>\n\n
text_modules_shortcode_id_attribute_name<\/code><\/strong><\/p>\n\n
This filter lets you alter the shortcode's 'id' attribute name.<\/p>\n\n
\/**\n * Filter the 'id' shortcode attribute name.\n *\n * @param string $name Attribute name.\n *\/\nadd_filter( 'text_modules_shortcode_id_attribute_name', function() {\n\n    return 'post_id';\n} );\n<\/code><\/pre>\n\n
text_modules_shortcode_output<\/code><\/strong><\/p>\n\n
This filter lets you alter the shortcode output. The second parameter holds the shortcode attributes array.<\/p>\n\n
\/**\n * Filter the shortcode output.\n *\n * @param string $output Shortcode output.\n * @param array  $atts   Shortcode attributes array.\n *\/\nadd_filter( 'text_modules_shortcode_output', function( $output ) {\n\n    return $output . ' Over and out.';\n} );\n<\/code><\/pre>\n\n
text_modules_shortcode_query_args<\/code><\/strong><\/p>\n\n
Also, there's text_modules_shortcode_query_args<\/code>, which provides you with the complete args array for the shortcode's query.<\/p>\n\n
\/**\n * Filter the shortcode query args.\n *\n * @param array $args Shortcode query args.\n *\/\nadd_filter( 'text_modules_shortcode_query_args', function( $args ) {\n\n    \/\/ Exclude some text modules by ID\n    $args[ 'post__not_in' ] = array( 4, 8, 15, 16, 23, 42 );\n\n    return $args;\n} );\n<\/code><\/pre>\n\n
text_modules_shortcode_slug_attribute_name<\/code><\/strong><\/p>\n\n
This filter lets you alter the shortcode's 'slug' attribute name.<\/p>\n\n
\/**\n * Filter the 'slug' shortcode attribute name.\n *\n * @param string $name Attribute name.\n *\/\nadd_filter( 'text_modules_shortcode_slug_attribute_name', function() {\n\n    return 'post_slug';\n} );\n<\/code><\/pre>\n\n
text_modules_shortcode_tag<\/code><\/strong><\/p>\n\n
This filter lets you alter the shortcode's tag.<\/p>\n\n
\/**\n * Filter the shortcode tag.\n *\n * @param string $shortcode_tag Shortcode tag.\n *\/\nadd_filter( 'text_modules_shortcode_tag', function() {\n\n    return 'text_block';\n} );\n<\/code><\/pre>\n\n
text_modules_shortcode_use_slug<\/code><\/strong><\/p>\n\n
By default, text modules are being queried by their post ID first. Of course, you can change that and use the post slug instead.<\/p>\n\n
\/**\n * Filter if the shortcode (query) should use the post slug instead of the post ID.\n *\n * @param bool $use_slug Use slug instead of ID?\n *\/\nadd_filter( 'text_modules_shortcode_use_slug', '__return_true' );\n<\/code><\/pre>\n\n
text_modules_widget_form_query_args<\/code><\/strong><\/p>\n\n
Also, there's text_modules_widget_form_query_args<\/code>, which provides you with the complete args array for the widget form's query.<\/p>\n\n
\/**\n * Filter the widget form query args.\n *\n * @param array $args Query args.\n *\/\nadd_filter( 'text_modules_widget_form_query_args', function( $args ) {\n\n    \/\/ Exclude some text modules by ID\n    $args[ 'post__not_in' ] = array( 4, 8, 15, 16, 23, 42 );\n\n    return $args;\n} );\n<\/code><\/pre>\n\n
Contribution<\/h4>\n\n
To contribute<\/strong> to this plugin, please see its GitHub repository<\/strong><\/a>.<\/p>\n\n
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.<\/p>\n\n
Of course, you can also provide me with translations if you would like to use the plugin in another not yet included language.<\/p>\n\n\n
This plugin requires PHP 5.3.<\/p>\n\n
    \n
  1. Upload the text-modules<\/code> folder to the \/wp-content\/plugins\/<\/code> directory on your web server.<\/li>\n
  2. Activate the plugin through the Plugins<\/em> menu in WordPress.<\/li>\n
  3. Find the new Text Modules<\/em> menu in your WordPress backend.<\/li>\n<\/ol>\n\n\n
    1.0.1<\/h4>\n\n
      \n
    • Escape translated strings.<\/li>\n
    • Improve namespace imports.<\/li>\n
    • Compatible up to WordPress 4.2.4.<\/li>\n<\/ul>\n\n
      1.0.0<\/h4>\n\n
        \n
      • Initial release.<\/li>\n
      • wordpress.org release.<\/li>\n
      • Compatible up to WordPress 4.2.3.<\/li>\n<\/ul>","raw_excerpt":"Use the new Text Modules custom post type and display a text module by either shortcode or widget.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/37780","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=37780"}],"author":[{"embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/tfrommen"}],"wp:attachment":[{"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=37780"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=37780"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=37780"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=37780"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=37780"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=37780"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}