WordPress Standardized Loop API
Download as PPT, PDF4 likes2,598 views
The document proposes creating a standardized loop API for WordPress that allows plugins to replace a theme's default loop content, similar to how widgets can replace sidebar content, in order to make it easier for themes and plugins to interact and style each other's content without extensive custom coding. It outlines registering callback functions, calling dynamic loop handlers, and establishing common HTML and class structures to provide styling foundations for replacement loop content from plugins.
![register_dynamic_loop_handler function register_dynamic_loop_handler( 油油 油 $function, 油油 油 $args = array(), 油油 油 $priority = 10 ) { 油 油 global $dynamic_loop_handlers; 油 油油 油 油 $dynamic_loop_handlers[$priority][] = 油油 油油油 油 array( $function, $args ); }](https://image.slidesharecdn.com/standardizedloopapi-110530154540-phpapp02/85/WordPress-Standardized-Loop-API-13-320.jpg)
![Responsible [digital] Home Ownership](https://cdn.slidesharecdn.com/ss_thumbnails/pbeventthewebprincess-140829015242-phpapp02-thumbnail.jpg?width=560&fit=bounds)
More Related Content
What's hot (20)
Similar to WordPress Standardized Loop API (20)
WordPress Standardized Loop API
- 1. Standardized Loop API The Next Big Thing?
- 2. Who Am I? Chris Jean chrisjean.com @chrisjean Developer for iThemes Core contributor Person who wants to make WordPress better for everyone
- 3. The Problem There is very little in the way of methods for plugins to interact with a theme at The Loop level. Brief history of integration strategies: Plugin readme.txt files filled with instructions on integrating function and action calls into theme template files. Plugin-provided or custom built page template files. Use of shortcodes as injection points for plugin-generated content. Direct theme and plugin developer discussions to create specific solutions. These solutions simply aren't sustainable.
- 4. The Goal To make it easier for themes to provide a foundation of style that plugins can make use of To make it easier for plugins to provide output that themes can style To do this in a way that does not require the theme to know anything about the plugin and does not require the plugin to know anything about the theme
- 5. Case Study: BuddyPress BuddyPress has a great need to interact with themes at The Loop level. The BuddyPress solution was to build a theme completely tailored油specifically油for the plugin. The end result is that it is extremely difficult to build a BuddyPress-compatible theme without building a child theme of the BuddyPress Default theme.
- 6. The Solution Create a way for themes to allow their The Loop content to be replaced without making the template files more difficult to create or maintain. Create a way for plugins to register custom loop handlers that can replace the theme's default loop. Create an HTML and class standard that provides a consistent foundation that themes can style
- 7. Following in the Footsteps of Sidebars WordPress already has a great example for a standardized way for themes and plugins to coexist and cooperate: Sidebars and Widgets. The power of sidebars and widgets hinges off of the dynamic_sidebar function. This function allows themes to provide default content for sidebars that can be replaced by widgets. The key is to wrap the default theme content in an if statement that uses the results of dynamic_sidebar as the conditional.
- 8. if ( ! dynamic_sidebar( 'primary-widget-area' ) ) : ?> 油 油 <li id="search" class="widget-container widget_search"> 油 油 油 油 <?php get_search_form(); ?> 油 油 </li> 油 油 <li id="archives" class="widget-container"> 油 油 油 油 <h3 class="widget-title">Archives</h3> 油 油 油 油 <ul> 油 油 油 油 油 油 <?php wp_get_archives( 'type=monthly' ); ?> 油 油 油 油 </ul> 油 油 </li> 油 油 <li id="meta" class="widget-container"> 油 油 油 油 <h3 class="widget-title">Meta</h3> 油 油 油 油 <ul> 油 油 油 油 油 油 <?php wp_register(); ?> 油 油 油 油 油 油 <li><?php wp_loginout(); ?></li> 油 油 油 油 油 油 <?php wp_meta(); ?> 油 油 油 油 </ul> 油 油 </li> <?php endif; // end primary widget area ?>
- 9. Standard Loop: The Sidebar Way <?php get_header(); ?> <?php if ( ! dynamic_loop() ) : ?> 油油 油 <div class="loop" > 油 油 油 油 <?php if (have_posts()) : ?> 油 油 油 油 油 油 <?php while (have_posts()) : the_post(); ?> 油 油 油 油 油 油 油 油 <div class="loop-content" > 油 油 油 油 油 油 油 油 油 油 <div <?php post_class( 'hentry' ) ?> id="post-<?php the_ID(); ?>"> 油 油 油 油 油 油 油 油 油 油 油 油 <h2 class="entry-title" ><?php the_title() ?></h2> 油 油 油 油 油 油 油 油 油 油 油 油 <div class="entry-meta" ><?php the_time('F jS, Y') ?></div> 油 油 油 油 油 油 油 油 油 油 油 油 <div class="entry-content" > 油 油 油 油 油 油 油 油 油 油 油 油 油 油 <?php the_content(); ?> 油 油 油 油 油 油 油 油 油 油 油 油 </div> 油 油 油 油 油 油 油 油 油 油 油 油 <div class="entry-meta" ><p><?php the_tags() ?></p></div> 油 油 油 油 油 油 油 油 油 油 </div> 油 油 油 油 油 油 油 油 </div> 油 油 油 油 油 油 <?php endwhile; ?> 油 油 油 油 油 油 <div class="loop-utility" > 油 油 油 油 油 油 油 油 <div class="alignleft"><?php next_posts_link() ?></div> 油 油 油 油 油 油 油 油 <div class="alignright"><?php previous_posts_link() ?></div> 油 油 油 油 油 油 </div> 油 油 油 油 <?php endif; ?> 油 油 </div> <?php endif; ?> <?php get_sidebar(); ?> <?php get_footer(); ?>
- 10. The Solution Create a way for themes to allow their The Loop content to be replaced without making the template files more difficult to create or maintain. Create a way for plugins to register custom loop handlers that can replace the theme's default loop. Create an HTML and class standard that provides a consistent foundation that themes can style
- 11. Registering Dynamic Loop Handlers Themes use the register_sidebar() function to tell WordPress that a sidebar location is available. The arguments give the area a name and configure additional settings. What we need is a way of registering callbacks that plugins can use, not named areas that can be displayed on the back-end. We need a different solution.
- 12. Registering Dynamic Loop Handlers The registration function should accept: A function callback that decides whether or not the loop should be replaced. If the loop is to be replaced, the callback should run code that generates the new loop. An array of arguments to be passed to the callback. A priority in the same fashion as actions and filters.
- 13. register_dynamic_loop_handler function register_dynamic_loop_handler( 油油 油 $function, 油油 油 $args = array(), 油油 油 $priority = 10 ) { 油 油 global $dynamic_loop_handlers; 油 油油 油 油 $dynamic_loop_handlers[$priority][] = 油油 油油油 油 array( $function, $args ); }
- 14. Calling Dynamic Loop Handlers Now all we need is a function that can be used in theme templates to run through the registered callbacks in order of priority. Keeping with the dynamic_sidebar logic, the callback handler should return false if the default loop should be displayed and return true if the default loop is油overridden油and should not be displayed.
- 15. dynamic_loop() function dynamic_loop() { 油 油 global $dynamic_loop_handlers; 油 油油 油 油 if ( empty( $dynamic_loop_handlers ) ) 油 油 油 油 return false; 油 油油 油 油 ksort( $dynamic_loop_handlers ); 油 油油 油 油 foreach ( $dynamic_loop_handlers as $handlers ) { 油 油 油 油 foreach ( $handlers as $callback ) { 油 油 油 油 油 油 list( $function, $args ) = $callback; 油 油 油 油 油 油 if (油is_callable( $function ) ) { 油油 油油油 油油油 油油 油 $result =油call_user_func_array( 油油 油油油 油油油 油油油 油油油 油 $function, $args 油油 油油油 油油油 油油油 油 ); 油油 油油油 油油油 油油 油 if ( false != $result ) 油油 油油油 油油油 油油 油油油 油 return true; 油 油 油 油 } 油 油 } 油 油油 油 油 return false; }
- 16. Standardized HTML and Class Structure While being able to replace The Loop is a big step forward, it will be of limited benefit if the new content uses a completely different structure than the theme. The result will likely be unstyled and will look out of place. The final piece that ties everything together is a HTML and Class structure that establishes a foundation of styling that allows plugin content to look like it belongs on the site.
- 17. <div class="loop"> 油 油 <div class="loop-title"></div>?油 油油 油 油 <div class="loop-utility loop-utility-above"></div>* 油 油 <div class="loop-meta loop-meta-above"></div>* 油 油 <div class="loop-content"> 油 油 油 油 <div class="loop-utility loop-utility-above"></div>* 油 油 油 油 <div class="loop-meta loop-meta-above"></div>* 油 油 油 油 <div class="hentry">+ 油 油 油 油 油 油 <div class="entry-title"></div>? 油 油 油 油 油 油 <div class="entry-utility entry-utility-above"></div>* 油 油 油 油 油 油 <div class="entry-meta entry-meta-above"></div>* 油 油 油 油 油 油 <div class="entry-summary"></div>? 油 油 油 油 油 油 <div class="entry-content"></div>? 油 油 油 油 油 油 <div class="entry-meta entry-meta-below"></div>* 油 油 油 油 油 油 <div class="entry-utility entry-utility-below"></div>* 油 油 油 油 </div> 油 油 油 油 <div class="loop-utility loop-utility-above"></div>* 油 油 油 油 <div class="loop-meta loop-meta-above"></div>* 油 油 油 油 <div id="comments">? 油 油 油 油 油 油 <div id="comments-title"></div>? 油 油 油 油 油 油 <div class="commentlist">? 油 油 油 油 油 油 油 油 <div class="comment"></div>* 油 油 油 油 油 油 </div> 油 油 油 油 油 油 <div id="respond"> 油 油 油 油 油 油 油 油 <div id="reply-title"></div>? 油 油 油 油 油 油 油 油 <form id="commentform"></form> 油 油 油 油 油 油 </div> 油 油 油 油 </div> 油 油 油 油 <div class="loop-utility loop-utility-above"></div>* 油 油 油 油 <div class="loop-meta loop-meta-above"></div>* 油 油 </div> 油 油 <div class="loop-meta loop-meta-below"></div>* 油 油 <div class="loop-utility loop-utility-below"></div>* </div>
- 18. Checking for Standard Theme Support Themes that implement the Standard Loop can use add_theme_support('standard-loop') to indicate that they follow the standard. This allows plugins to use current_theme_supports('standard-loop') to determine the support offered by the current theme and take action as needed if it is not available.
- 19. Possible Future Improvements Adding more classes that are focused on content. These would be in the vein of "Obligatory WordPress Classes" that can be found in most themes of the past few years. Creating a more advanced callback handler that allows for registering criteria for when the callback should be called (thus removing the decision logic from the callback handler).
- 20. Call to Action Are you a theme developer that wants an easier way to allow plugins to provide content that styles nicely in your theme? Are you a plugin developer that wants to have a better way to add generated content inside the theme and also wants that generated content to automatically take on theme styling? Go to loopstandard.com and get involved
- 21. For More Information Go to standardloop.com to get sample code and HTML/Class structures.