Making plugin output customizable

Shortcode with a custom output template:

You could try the following shortcode demo:

/**
 * The shortcode [history_timeline] with a custom output template.
 */
add_shortcode( 'history_timeline', function( $atts = array(), $content="" )
{
    ob_start();
    if ( '' == locate_template( 'templates/timeline.php', TRUE ) )
            include( plugin_dir_path( __FILE__ ) . 'templates/timeline.php' );

    $html = ob_get_clean();
    return $html;
});

where the shortcode is [history_timeline] and

if ( '' == locate_template( 'templates/timeline.php', TRUE ) )
     include( plugin_dir_path( __FILE__ ) . 'templates/timeline.php' );

means:

  • If /wp-content/themes/MYTHEME/templates/timeline.php is located, then it will be automatically loaded.

  • Else: /wp-content/plugins/history-timeline/templates/timeline.php is loaded.

where we assume that __FILE__ is in the history-timeline root directory.

Related Posts:

  1. Looking for WordPress System Diagrams
  2. How can I load a page template from a plugin?
  3. Overwrite theme file from plugin
  4. How to control output of custom post type without modifying theme?
  5. When is it appropriate to put functions on page template vs. functions.php?
  6. Filter to change the content of 404 page
  7. How to properly use a hook to create template for custom product type in a plugin such as Woocommerce? [closed]
  8. How to check active theme is parent or child wordpress
  9. WordPress removing data attributes for scheduled post
  10. Is there a way to loop through a shortcode datasource to create a table?
  11. creating custom archive template within plugin for custom post type using archive_template filter
  12. Where to call wp_enqueue_script in a plugin with custom template?
  13. Can Page Templates be Applied to Archive and Post Templates?
  14. ORDER BY wp_post custom column name in wp_query
  15. Create a free scripts and styles template within a plugin
  16. How can I turn a custom wordpress page into a product page?
  17. Plugin templates vs Parent Theme
  18. How to make “upgrade safe” theme for a plugin?
  19. What action hook can I use to add a JavaScript to a page post using a theme template that is not including get_header() nor get_footer()?
  20. How to create templates for a custom module to show on the front end within my theme?
  21. Why aren’t some plugin styles loading when I load a template?
  22. Plugin custom post template; without overriding all posts
  23. Best way to distribute templates and code accross multiple wordpress sites?
  24. Load php file with jquery in single.php
  25. Overriding the template files using a plugin for all themes
  26. How do I use a plugin to swap out the template file for a custom post type?
  27. Javascript not being loaded only in custom taxonomy template
  28. Add new header/footer on landing page with plugin
  29. Use a page as a template for a custom post type
  30. Page template compatibility with different themes
  31. How to set custom homepage via a plugin
  32. Template file structure , wordpress hook for altering the template
  33. Displaying External Data – Not Posts
  34. Use different archive template for plugin
  35. How to display custom taxonomy and terms using/creating plugin template
  36. How to check during “pre_get_posts” if WP performing default query for specific custom template?
  37. WP Job Manager – Show recent jobs as cards
  38. Help interpreting @wordpress/create-block-tutorial-template usage error
  39. What is the advantage of using wp_mail?
  40. Plugin directory “Last Updated” not changed after initial commit?
  41. Calling the widget id of a mult-instance widget from inside the widget?
  42. What is the recommended way to create plugin administration forms?
  43. Do I need to call do_action in my plugin?
  44. Fatal error: Call to undefined function wp_mail()
  45. Does WordPress have an Browser Agent?
  46. How Do I Load My Action Earlier Enough?
  47. I can’t find where a hook is being defined in a plugin – Easy Digital Downloads
  48. Filter on the_content ignores shortcodes
  49. Custom theme sufficient or custom plugin neccessary for this feature set?
  50. Replacing WordPress menu functionality with a plugin
  51. Database for development
  52. PHP library that can merge stylesheet with inline style [closed]
  53. How to create multiple Gutenberg blocks in one plugin
  54. How to disable reCaptcha v3 except on Contact Form 7 pages?
  55. How to get color name in PanelColorSettings in custom Gutenberg block?
  56. Fetching the value of forms in WordPress AJAX
  57. Cannot redeclare function error on the same line
  58. How to add setting section in custom post type [closed]
  59. Get Current Menu Location inside Nav_Walker
  60. Append country to ‘pretty’ url but serve same page
  61. Where to add hooks in a class
  62. Insert terms for custom taxonomy on plugin activation, or each page load (init hook)
  63. Adding a brand column to WooCommerce Products
  64. Custom GET Parameters In Plugin’s Admin Page
  65. Adding option to Gallery shortcode
  66. WordPress Search filter to remove possible script injections
  67. Mixing and Matching – Custom templates in a WordPress plugin
  68. Open Graph Object Debugger & url parameters – Page Not Found result
  69. random code at the end of file after plugin upload
  70. How Can I add Fields in wp-option table?
  71. Where do I put my add_action(… and add_filter(… and do I need to remove them?
  72. Can’t find where to modify attrbitutes
  73. ajax recursive calls on wordpress returning answers outsite the function scope
  74. Custom Empty Results page for my Custom Post Type
  75. Add Password Generator on password protected page
  76. WordPress pages are not published due to External database connection with WPDB class
  77. How to optimize multiple insert into wordpress database
  78. How to add custom options for plugin into the add post screen – like yoast seo
  79. How to find where an object first instantiatiation
  80. Clean way to initialize plugin in newly-added site when plugin has been network activated?
  81. Get coordinates of selected area to use in image maps [closed]
  82. Can I attach a plugin via my add_filter callback contents?
  83. How to trigger selected option from a clic. (variation product woocommerce)
  84. WordPress Favicon not Working For Images/Videos/PDFs
  85. why is apiFetch throwing Unhandled Promise Rejection: TypeError: Object is not a function
  86. Show username only if logged in in a else no directly name
  87. Conditionally check if page is using template from plugin directory
  88. plugin css is not being applied to the page
  89. How to save multiple values in custom post type from front end to back end
  90. Yoast and another plugin
  91. Headers already sent on custom plugin (Export function)
  92. Insert Data into Database
  93. Handle changed Woocommerce function
  94. Making Woocommerce optimized for more than 500k products
  95. wp_enqueue_style don’t register all google fonts
  96. API WordPress is Limited? Return False
  97. Add placeholder into contact form 7 recaptcha text field
  98. To remove rendering of menus and header, plugin or theme?
  99. Generating Multiple Divi Pages from Database
  100. Is it smart to require_once wp-admin/includes/plugin.php when you need only one function from it
error code: 523