I am, and am finding they’re a great way to organise different content on your site and very easy to implement in just a few lines of code.

However, the challenge now is for plugin developers to make their plugins play nice with custom post types. The main thing I’ve noticed so far is that most plugins only tend to add meta boxes to posts and pages, so here’s the first step – getting your WordPress plugin meta boxes to work with custom post types.

A Real World Example

I needed to set some of my custom post type pages not to be indexed by search engines so I picked out the Robots Meta plugin by Joost de Valk – the best plugin for the job in my opinion – installed it, and found it was only showing a meta box when editing my posts and pages.

I’m going to use Joost’s plugin (version 3.3.1) to illustrate how you can get meta boxes to show for custom post types so download it and continue reading below.

The Meta Boxes

The file you’ll need to edit is robots-meta.php. The meta boxes are added to posts and pages by the meta_box function on line 24:

24
25
26
27

function meta_box() {
	add_meta_box('robotsmeta','Robots Meta',array('RobotsMeta_Admin','noindex_option_fill'),'post','side');
	add_meta_box('robotsmeta','Robots Meta',array('RobotsMeta_Admin','noindex_option_fill'),'page','side');
}

Meta Boxes for Custom Post Types

Firstly we’re going to check that the ‘get_post_types’ function exists. If it does then we’ll loop through all the post types and add meta boxes. If not we’ll continue just to add for posts and pages.

24
25
26
27
28
29
30
31

function meta_box() {
	if ( function_exists( 'get_post_types' ) ) {
		// Handle posts, pages and custom post types here
	} else {
		add_meta_box('robotsmeta','Robots Meta',array('RobotsMeta_Admin','noindex_option_fill'),'post','side');
		add_meta_box('robotsmeta','Robots Meta',array('RobotsMeta_Admin','noindex_option_fill'),'page','side');
	}
}

The next step is to get all the post types that have been registered – this will include the built-in post types for posts and pages. We then loop through them:

$post_types = get_post_types( array(), 'objects' );
foreach ( $post_types as $post_type ) {
	// Handle each post type here
}

Then for each post type we are going to add a meta box. It is import to note that when you add a custom post type you can choose wether or not to automatically create the WordPress UI in the admin. We only want to add meta boxes if the UI is generated by WordPress so we add in an ‘if’ statement to check.

24
25
26

if ( $post_type->show_ui ) {
	add_meta_box( 'robotsmeta', 'Robots Meta', array( 'RobotsMeta_Admin', 'noindex_option_fill' ), $post_type->name, 'side' );
}

The Finished Function

So put all that together and this is what you get:

24
25
26
27
28
29
30
31
32
33
34
35
36

function meta_box() {
	if ( function_exists( 'get_post_types' ) ) {
		$post_types = get_post_types( array(), 'objects' );
		foreach ( $post_types as $post_type ) {
			if ( $post_type->show_ui ) {
				add_meta_box( 'robotsmeta', 'Robots Meta', array( 'RobotsMeta_Admin', 'noindex_option_fill' ), $post_type->name, 'side' );
			}
		}
	} else {
		add_meta_box('robotsmeta','Robots Meta',array('RobotsMeta_Admin','noindex_option_fill'),'post','side');
		add_meta_box('robotsmeta','Robots Meta',array('RobotsMeta_Admin','noindex_option_fill'),'page','side');
	}
}

Please Note: This only deomstrates how you can add meta boxes for custom post types. There are other aspects such as checking user capabilities for different post types that may be applicable when you are saving your meta box data. See the capabilities arguments you can set in the register_post_type function.

The latest release contains a suite of functions (my little contribution) to help you customise how pagination is displayed in your WPSC templates.

You can find an in-depth look at these functions and how to use them in the WP e-Commerce Documentation.

Below are some quick examples of what you can do…

Basic paging

Some fairly standard paging with linked page numbers, previous and next links, and arrow links to take to to the first and last pages. You can customise the text that is used for previous, next, first and last links.

<?php echo wpsc_first_products_link( '&laquo;', true ); ?>
<?php echo wpsc_previous_products_link( 'previous', true ); ?>
<?php echo wpsc_pagination(); ?>
<?php echo wpsc_next_products_link( 'next', true ); ?>
<?php echo wpsc_last_products_link( '&raquo;', true ); ?>

Limit the amount of pages

You can limit the amount of page links to show at one time. The above example shows what happens if there are 10 pages of products, but only showing 7 page links at a time. Notice also the text describing which page you’re on and that the previous and first links are greyed out when not applicable – you can also choose to hide them instead of showing inactive links.

Page <?php wpsc_showing_products_page(); ?>:
<?php echo wpsc_first_products_link( '&laquo;', true ); ?>
<?php echo wpsc_previous_products_link( 'previous', true ); ?>
<?php echo wpsc_pagination( 7 ); ?>
<?php echo wpsc_next_products_link( 'next', true ); ?>
<?php echo wpsc_last_products_link( '&raquo;', true ); ?>

Total number of products

There is a function to easily display the total number of products. You can detect if the category has multiple pages and if it doesn’t display something like this instead.

<?php if ( wpsc_has_pages() ) : ?>
   <!-- Insert pagination for multiple pages -->
<?php else : ?>
   Showing <?php echo wpsc_total_product_count(); ?> products
<?php endif; ?>

Number of products showing

You can display an indication as to which products are showing depending on which page you’re viewing.

Showing <?php echo wpsc_showing_products(); ?> of <?php echo wpsc_total_product_count(); ?> products:

What next?

The new WP e-Commerce default themes contain examples of pagination so hop into your templates and create some nice pagination…

But what if you want the link to redirect to a page instead of triggering this popup? You just need to make a small change to your checkout template. Here’s what you need to do…

In The Admin

In the admin, instead of specifying terms and conditions text we are going to enter a URL. Make sure your URL is a full path including ‘http://’ as this will make it easier to detect wether the content is a URL or plain text.

Changes in your WP e-Commerce Theme

Your WP e-Commerce theme files usually reside in the ‘wp-content/uploads/wpsc/themes/your-theme’ directory. To change the terms and conditions link to link to another page rather that popup you will need to edit the ‘shopping_cart_page.php’ file.

In this file look for the terms and condition code. It will be near the bottom and should look a bit like this:

297
298
299
300
301
302
303

<?php if(get_option('terms_and_conditions') != '') : ?>
<tr>
   <td colspan='2'>
      <input type='checkbox' value='yes' name='agree' /> <?php echo TXT_WPSC_TERMS1;?><a class='thickbox' target='_blank' href='<?php echo get_option('siteurl')."?termsandconds=true&amp;width=360&amp;height=400'"; ?>' class='termsandconds'><?php echo TXT_WPSC_TERMS2;?></a>
   </td>
</tr>
<?php endif; ?>

What we will do is change this code so if the contents of your terms and condition is a link (beginning http://) it will write a link to that page rather than a popup. The new code with the if statement should look like this:

297
298
299
300
301
302
303
304
305
306
307
308

<?php if ( get_option('terms_and_conditions') != '' ) : ?>
<tr class="terms">
   <td colspan='2'>
      <input type='checkbox' value='yes' name='agree' /> <?php echo TXT_WPSC_TERMS1;?>
      <?php if ( substr(get_option('terms_and_conditions' ), 0, 7) == 'http://' ) { ?>
         <a target='_blank' href='<?php echo get_option('terms_and_conditions'); ?>' class='termsandconds'><?php echo TXT_WPSC_TERMS2;?></a>
      <?php } else { ?>
         <a class='thickbox' target='_blank' href='<?php echo get_option('siteurl')."?termsandconds=true&amp;width=360&amp;height=400'"; ?>' class='termsandconds'><?php echo TXT_WPSC_TERMS2;?></a>
      <?php } ?>
   </td>
</tr>
<?php endif; ?>

And that’s all there is to it.

This update fixed a pretty major bug which prevented the list showing the correct branch of subpages when the start depth was greater than 1 (secondary level pages).

Now this is fixed you’ll be able to display a list of only tertiary level pages – Useful if you have a site with a horizontal navigation with drop down menus for secondary level navigation, and want to show and subpages of the secondary level as a list in your sidebar.

What’s more the plugin now includes a widget so you can easily add a list of subpages into your sidebar.

Widget Examples

The following configuration will display a list of secondary and tertiary level pages (depths 1 to 2) for the currently selected primary navigation item. The list of pages will show for all pages that are subpages (or sub-subpages) of that primary page.

The widget below will only display the tertiary level (depth 2) of navigation for subpages of the currently selected secondary level page.

WP e-Commerce 3.7.5 adds the following styles to the body tag:

• wpsc
• wpsc-home
• wpsc-single-product
• wpsc-single-product-id
• wpsc-category
• wpsc-category-id
• wpsc-group-id
• wpsc-shopping-cart
• wpsc-transaction-details
• wpsc-user-account

These extra classes will give you more flexibility when designing themes for WP e-Commerce.

Where are these classes included?

wpsc
Included in every WP e-Commerce page.

wpsc-home
Included on the main WP e-Commerce shop page.

wpsc-single-product & wpsc-single-product-id
Included on single product pages. The wpsc-single-product-id class allows you to set css rules for a single product based on the product id.

wpsc-category & wpsc-category-id
Included on category and individual product pages. The wpsc-category-id class allows you to set css rules for different categories. As these classes are also applied to single product pages, if a product appears in more than one category you could style a product page differently depending on which category you click through from.

wpsc-group-id
Included on category and single product pages. The group id is set based on the group in which the current category resides.

wpsc-shopping-cart
Including on the shop cart checkout page.

wpsc-transaction-details
Including on the transaction details page displayed after a successful purchase.

wpsc-user-account
Including on the WP e-Commerce user account pages.

Ideas how to use these classes in your WP e-Commerce theme…

1. Style a special product differently using wpsc-single-product-id.
2. Style products in a sale category to display differently using wpsc-category-id.
3. Create a group for brands with brands as sub-categories and differentiate this view from your standard product categories using wpsc-group-id.