Day 34 - PitchEngine/code-wyoming GitHub Wiki

Advanced Wordpressin'

Custom Templating

You can define your own template items (beyond just header, footer, and sidebar) using the get_template_part function.

<?php get_template_part( $slug, $name ); ?>

Examples

<?php get_template_part( 'loop', 'index' ); ?>
//This will get the first file that exists among these, in this priority

//1. wp-content/themes/twentytenchild/loop-index.php
//2. wp-content/themes/twentyten/loop-index.php
//3. wp-content/themes/twentytenchild/loop.php
//4. wp-content/themes/twentyten/loop.php
<?php get_template_part( 'nav' );           // Navigation bar (nav.php) ?>
<?php get_template_part( 'nav', '2' );      // Navigation bar #2 (nav-2.php) ?>
<?php get_template_part( 'nav', 'single' ); // Navigation bar to use in single pages (nav-single.php) ?>

Post & Body Classes

What they're for

.post {
	    /* styles for all posts */
}
.post-4564 {
	    /* styles for only post ID number 4564 */
}
.category-dancing {
	    /* styles for all posts within the category of dancing */
}

Body Class

<body <?php body_class($class); ?>>

Post Class

Only use this inside of the loop, as it applies to posts.

<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>

Javascript

Use wp_enqueue_script.

This is how your theme plays nicely with plugins when both need jQuery - we don't want jQuery to get loaded twice!

<?php wp_enqueue_script( $handle, $src, $deps, $ver, $in_footer ); ?>

Custom Queries

<?php 
// the query
$the_query = new WP_Query( $args ); ?>

<?php if ( $the_query->have_posts() ) : ?>

  <!-- pagination here -->

  <!-- the loop -->
  <?php while ( $the_query->have_posts() ) : $the_query->the_post(); ?>
    <h2><?php the_title(); ?></h2>
  <?php endwhile; ?>
  <!-- end of the loop -->

  <!-- pagination here -->

  <?php wp_reset_postdata(); ?>

<?php else:  ?>
  <p><?php _e( 'Sorry, no posts matched your criteria.' ); ?></p>
<?php endif; ?>

Parameters

Author

author=1
author=3,5
author_name=matt_enlow

Category

cat=4
category_name=adventure_journal,photo_journal

Tags

tag=climbing,skiing //has any
tag=climbing+camping //has all
tag_id=13

So many, many others

Check out the nav menu on the codex wp_query section. http://codex.wordpress.org/Class_Reference/WP_Query

Params in action

$args = array(
    'tag' => 'skiing+climbing',
    'author_name' => 'matt_enlow'
);
$the_query = new WP_Query( $args ); ?>

Reset your data!

After you're done using a custom query, reset everything back to the original, url based query via this function.

<?php wp_reset_postdata(); ?>
⚠️ **GitHub.com Fallback** ⚠️