Display custom post data in sidebar w/ dropdown

I’m trying to set up a sidebar area that’ll do two things:

  1. Display a drop-down of posts in a given custom post types.
  2. Display post metadata (content and custom fields) if selected post

The thing that’s getting me is two-fold:

  1. Having the selected post metadata display in the sidebar once selected via the dropdown
  2. Having the content refresh via ajax or jquery so it doesn’t refresh the entire page

Related posts

Leave a Reply

1 comment

  1. What you are looking for is a bit involved but I wrote it anyway. Unfortunately it took longer than I planned so I’ve run out of gas on going in depth to explain it but I did document the code so hopefully that will help you follow it and you can download a copy of the code here.

    The Widget in Use on the Website:

    WordPress Widget showing a Dropdown List of Posts
    (source: mikeschinkel.com)

    Note in my example I wrote a generic function to grab all the meta keys and meta values associated with a post to have something to display; that’s what you see on the screen.

    The Widget Configuration in the Admin Console:

    Screenshot of WordPress Widgets Admin Screen
    (source: mikeschinkel.com)

    The Code

    Here’s the code. This can be used in your theme’s functions.php file or as a standalone file in a plugin or theme you are developing:

    <?php
    /*
    Plugin Name: List_Custom_Post_Type_Posts_with_AJAX class
    Version: 0.1
    Author: Mike Schinkel
    Author URI: http://mikeschinkel.com
    
      Shows how to create a widget with a dropdown list of posts for a given post type 
      and then retrieve HTML specific to the selected post via AJAX to insert into the         
      page.
    
      Yes, the name of the class is insanely long in hopes that you'll be forced to 
      think about what would be a better name.
    
      This can be used in your theme's functions.php file or as a standalone file in a
      plugin or theme you are developing.
    
    */
    
    class List_Custom_Post_Type_Posts_with_AJAX extends WP_Widget {
      /*
       * List_Custom_Post_Type_Posts_with_AJAX() used by the Widget API 
       * to initialize the Widget class
       */
      function List_Custom_Post_Type_Posts_with_AJAX() {
        $this->WP_Widget(
          'list-custom-post-type-posts-with-ajax',
          'List Custom Post Type Posts with AJAX',
          // Widget Settings
          array(
            'classname' => 'list-custom-post-type-posts-with-ajax',
            'description' => 'Widget to List List Custom Post Type Posts with AJAX.',
          ),
          // Widget Control Settings
          array(
            'height' => 250,  // Set the form height (doesn't seem to do anything)
            'width'  => 300,  // Set the form width
            'id_base' => 'list-custom-post-type-posts-with-ajax',
          )
        );
      }
      /*
       * widget() used by the Widget API to display a form in the widget area of the admin console
       *
       */
      function form( $instance ) {
        global $wp_post_types;
        $instance = self::defaults($instance);  // Get default values
    
        // Build the options list for our select
        $options = array();
        foreach($wp_post_types as $post_type) {
          if ($post_type->publicly_queryable) {
            $selected_html = '';
            if ($post_type->name==$instance['post_type']) {
              $selected_html = ' selected="true"';
              $post_type_object = $post_type;
            }
            $options[] = "<option value="{$post_type->name}"{$selected_html}>{$post_type->label}</option>";
          }
        }
        $options = implode("n",$options);
    
        // Get form attributes from Widget API convenience functions
        $title_field_id = $this->get_field_id( 'title' );
        $title_field_name = $this->get_field_name( 'title' );
        $post_type_field_id = $this->get_field_id( 'post_type' );
        $post_type_field_name = $this->get_field_name( 'post_type' );
    
        // Get HTML for the form
        $html = array();
        $html = <<<HTML
    <p>
      <label for="{$post_type_field_id}">Post Type:</label>
      <select id="{$post_type_field_id}" name="{$post_type_field_name}">
        {$options}
      </select>
    </p>
    <p>
      <label for="{$title_field_id}">Label:</label>
      <input type="text" id="{$title_field_id}" name="{$title_field_name}"
          value="{$instance['title']}" style="width:90%" />
    </p>
    HTML;
        echo $html;
      }
      /*
       * widget() used by the Widget API to display the widget on the external site
       *
       */
      function widget( $args, $instance ) {
        extract( $args );
        $post_type = $instance['post_type'];
        $dropdown_name = $this->get_field_id( $post_type );
        // jQuery code to response to change in drop down
        $ajax_url = admin_url('admin-ajax.php');
        $script = <<<SCRIPT
    <script type="text/javascript">
    jQuery( function($) {
      var ajaxurl = "{$ajax_url}";
      $("select#{$dropdown_name}").change( function() {
        var data = {
          action: 'get_post_data_via_AJAX',
          post_id: $(this).val()
        };
        $.post(ajaxurl, data, function(response) {
          if (typeof(response)=="string") {
            response = eval('(' + response + ')');
          }
          if (response.result=='success') {
            if (response.html.length==0) {
              response.html = 'Nothing Found';
            }
            $("#{$dropdown_name}-target").html(response.html);
          }
        });
        return false;
      });
    });
    </script>
    SCRIPT;
        echo $script;
        echo $before_widget;
        if ( $instance['title'] )
           echo "{$before_title}{$instance['title']}{$after_title}";
    
        global $wp_post_types;
        // Dirty ugly hack because get_pages() called by wp_dropdown_pages() ignores non-hierarchical post types
        $hierarchical = $wp_post_types[$post_type]->hierarchical;
        $wp_post_types[$post_type]->hierarchical = true;
    
        // Show a drop down of post types
        wp_dropdown_pages(array(
          'post_type'   => $post_type,
          'name'        => $dropdown_name,
          'id'          => $dropdown_name,
          'post_status' => ($post_type=='attachment' ? 'inherit' : 'publish'),
        ));
    
        $wp_post_types[$post_type]->hierarchical = $hierarchical;
    
        echo $after_widget;
    
        // Create our post html target for jQuery to fill in
        echo "<div id="{$dropdown_name}-target"></div>";
    
      }
      /*
       * update() used by the Widget API to capture the values for a widget upon save.
       *
       */
      function update( $new_instance, $old_instance ) {
        return $this->defaults($new_instance);
      }
      /*
       * defaults() conveninence function to set defaults, to be called from 2 places
       *
       */
      static function defaults( $instance ) {
        // Give post_type a default value
        if (!get_post_type_object($instance['post_type']))
          $instance['post_type'] = 'post';
    
        // Give title a default value based on the post type
        if (empty($instance['title'])) {
          global $wp_post_types;
          $post_type_object = $wp_post_types[$instance['post_type']];
          $instance['title'] = "Select a {$post_type_object->labels->singular_name}";
        }
        return $instance;
      }
      /*
       * self::action_init() ensures we have jQuery when we need it, called by the 'init' hook
       *
       */
      static function action_init() {
        wp_enqueue_script('jquery');
      }
      /*
       * self::action_widgets_init() registers our widget when called by the 'widgets_init' hook
       *
       */
      static function action_widgets_init() {
        register_widget( 'List_Custom_Post_Type_Posts_with_AJAX' );
      }
      /*
       * self::get_post_data_via_AJAX() is the function that will be called by AJAX
       *
       */
      static function get_post_data_via_AJAX() {
        $post_id = intval(isset($_POST['post_id']) ? $_POST['post_id'] : 0);
        $html = self::get_post_data_html($post_id);
        $json = json_encode(array(
          'result'  => 'success',
          'html'    => $html,
        ));
        header('Content-Type:application/json',true,200);
        echo $json;
        die();
      }
      /*
       * self::on_load() initializes our hooks
       *
       */
      static function on_load() {
        add_action('init',array(__CLASS__,'action_init'));
        add_action('widgets_init',array(__CLASS__,'action_widgets_init'));
    
        require_once(ABSPATH."/wp-includes/pluggable.php");
        $user = wp_get_current_user();
        $priv_no_priv = ($user->ID==0 ? '_nopriv' : '');
        add_action("wp_ajax{$priv_no_priv}_get_post_data_via_AJAX",array(__CLASS__,'get_post_data_via_AJAX'));
      }
      /*
       *  get_post_data_html($post_id)
       *
       *    This is the function that generates the HTML to send back to the client
       *    Below is a generic want to list post meta but you'll probably want to
       *    write custom code and use the outrageously long named hook called:
       *
       *      'html-for-list-custom-post-type-posts-with-ajax'
       *
       */
      static function get_post_data_html($post_id) {
        $html = array();
        $html[] = '<ul>';
        foreach(get_post_custom($post_id) as $name => $value) {
          $html[] = "<li>{$name}: {$value[0]}</li>";
        }
        $html[] = '</ul>';
        return apply_filters('html-for-list-custom-post-type-posts-with-ajax',implode("n",$html));
      }
    }
    // This sets the necessary hooks
    List_Custom_Post_Type_Posts_with_AJAX::on_load();
    

    Also, if you want to read a good article about coding Widgets, Justin Tadlock has a good one called: