• Download on WordPress.org
• Support Forums (post bug reports / requests here)

A quick screenshot:

In case you’re wondering if you will loose existing ads from the theme – no, they will be imported by the plugin.

For theme developers – to add “ad location” support in your theme, pass an action tag to the registerAdLocation() method. Example:

if(defined('AdManager::VERSION'))
  AdManager()->registerAdLocation('after_header', __('After theme header'));

What does it do:

• Allow your site users to rate posts (of any kind)
• Display the average post rating, vote count or weighted (bayesian) rating within your posts
• Display a widget with the top rated posts in your sidebar

A few screenshots:

• Download on WordPress.org
• Support forums

atom()->setContextArgs('primary_menu', array('walker' => new ThumbMenuWalker()));

class ThumbMenuWalker extends AtomWalkerNavMenu{

  // register the thumbnail size, 64 pixel square, cropped
  function __construct(){
    add_image_size('nav-thumb', 64, 64, true);
  }

  // override start_el
  function start_el(&$output, $item, $depth, $args) {

    $classes = empty($item->classes) ? array() : (array)$item->classes;

    $classes = join(' ', apply_filters('nav_menu_css_class', array_filter($classes), $item, $args));
    $classes = $classes ? ' class="'.esc_attr($classes).'"' : '';

    $output .= "\n<li{$classes}>";

    $attributes  = !empty($item->attr_title) ? ' title="'.esc_attr($item->attr_title).'"' : '';
    $attributes .= !empty($item->target) ? ' target="'.esc_attr($item->target).'"' : '';
    $attributes .= !empty($item->xfn) ? ' rel="'.esc_attr($item->xfn).'"' : '';
    $attributes .= !empty($item->url) ? ' href="'.esc_attr($item->url).'"' : '';

    $excerpt = $thumb = '';

    // 2nd level+
    if($depth > 0){
      $post = new AtomObjectPost($item->object_id);

      // thumbnail image
      if(post_type_supports($item->object, 'thumbnail'))
        $thumb = $post->getThumbnail('nav-thumb');

    if($thumb)
      $attributes .= ' class="clear-block"';

      // short description from the content, 100 is the max. character count
      $excerpt = $post->getContent(100, array(
        'cutoff'       => 'sentence',  // cut off just after the sentence ends
        'allowed_tags' => array(),     // no html
        'more'         => false,       // no 'more' text / link
      ));

      if($excerpt)
        $excerpt = "<small>{$excerpt}</small>";
      
      atom()->resetCurrentPost();
    }

    $content = $args->link_before.$thumb.'<span class="tt">'.apply_filters('the_title', $item->title, $item->ID).$excerpt.'</span>'.$args->link_after;
    $output .= apply_filters('walker_nav_menu_start_el', "{$args->before}<a{$attributes}>{$content}</a>{$args->after}", $item, $depth, $args);
  }

}

The CSS:

.nav img, .nav .no-img{
  float:left;
  margin-right: 5px;
} 

.nav .tt{
  overflow:hidden;
  display:block;
  font-weight:bold;  
}  

.nav small{
  font-size:11px;  
  display:block;
  margin-top: 5px;
}

The result should be something like this:

First, define the maximum image sizes (note that we will only downsize, smaller images will get browser-resized):

define('MAX_AVATAR_WIDTH', 96);
define('MAX_AVATAR_HEIGHT', 96);

This goes in the child theme’s functions-user.php file.

Next, create the form which lets users upload the image. I chose the author.php template here, but you can easily add it inside the dashboard trough some hooks.

<?php if(is_user_logged_in() && get_current_user_id() === (int)get_query_var('author')): ?>
<form method="POST" enctype="multipart/form-data" action="">
  <input type="file" name="user_avatar" />
  <input type="hidden" name="action" value="wp_handle_upload" />
  <input type="submit" value="Upload new Avatar" />
</form>
<?php endif; ?>

The actual upload processing. You can have this in the same author template before get_header(), or inside the child theme’s functions:

if(is_user_logged_in() && isset($_FILES['user_avatar'])){

  // we need this for the wp_handle_upload function
  require_once ABSPATH.'wp-admin/includes/file.php';

  // ID of the current user
  $current_user_id = get_current_user_id();

  // just be aware that GIFs are annoying as fuck
  $allowed_image_types = array(
    'jpg|jpeg|jpe' => 'image/jpeg',
    'png'          => 'image/png',
    'gif'          => 'image/gif',
  );

  // let wp do the upload checks, file moving etc.
  $status = wp_handle_upload($_FILES['user_avatar'], array('mimes' => $allowed_image_types));

  // no errors? Get the uploaded file path and resize it
  if(empty($status['error'])){

    // resize it
    $resized = image_resize($status['file'], MAX_AVATAR_WIDTH, MAX_AVATAR_HEIGHT, $crop = true);

    // resize failed, display the reason
    if(is_wp_error($resized))
      wp_die($resized->get_error_message());

    // determine the resized file URL
    $uploads = wp_upload_dir();
    $resized_url = $uploads['url'].'/'.basename($resized);

    // insert the file URL into the current user meta
    update_user_meta($current_user_id, 'custom_avatar', $resized_url);

  // error, show it
  }else{
    wp_die(sprintf(__('Upload Error: %s'), $status['error']));

  }

}

Finally, hook into the avatar display function and get the avatar user meta field:

add_filter('get_avatar', 'custom_avatars', 10, 3);

function custom_avatars($avatar, $id_or_email, $size){
  if(is_user_logged_in()){
    $current_user = wp_get_current_user();
    $image_url = get_user_meta($current_user->ID, 'custom_avatar', true);
    if($user_avatar !== false)
      return '<img src="'.$image_url.'" class="avatar photo" width="'.$size.'" height="'.$size.'" alt="'.$current_user->display_name .'" />';
  }

  return $avatar;
}

Because get_the_excerpt() / the_excerpt() will call get_the_content() if the post doesn’t have an excerpt set, in many cases you get your filter applied on excerpts as well. This can lead to unwanted text inside them, like escaped javascript code.

If you don’t want your filter to be applied to excerpts, then remove it during the time in which the excerpt is being generated. Here’s one way to do it:

add_filter('the_content', 'my_plugin_filter');

// remove our filter, as early as possible
add_filter('get_the_excerpt', function($text){
  remove_filter('the_content', 'my_plugin_filter');
  return $text;
}, -999);

// add it back after wp_trim_excerpt was applied, in case the theme calls the_content after
add_filter('get_the_excerpt', function($text){
  add_filter('the_content', 'my_plugin_filter');
  return $text;
}, 999);

Another way is to check if the excerpt is being processed within your filter:

add_filter('the_content', 'my_plugin_filter');

function my_plugin_filter($text){
  if(in_array('get_the_excerpt', $GLOBALS['wp_current_filter'])) return $text;

  // not the excerpt, do your stuff here...
  return $text;
}

• A very extensible code base
• Context-aware layout selection
• Extensive support for child themes (auto-creation, better template routing)
• Advanced theme settings panel with live preview for design-related tweaks
• Improved WordPress widgets:
  • Archives with CPT support
  • Blog list (multi-site only) with ajax support
  • Calendar with ajax and CPT support
  • Links (replaces “blogroll”)
  • Menu (replaces “custom menu), allows you to create expand/collapse lists
  • Login form with ajax support
  • Pages
  • Posts, with ajax, CPT and templating support
  • Recent Comments, with ajax and templating support
  • Splitter, a helper widget that’s able to group other widgets in columns
  • Tabs, helper widget that groups arbitrary widgets in tabs, extremely flexible
  • A more customizable Tag Cloud widget
  • Terms (replaces “categories”), with support for custom taxonomies and templating
  • Text widget with the ability to edit in visual mode
  • Top Commenters with templating support
  • Twitter feed
  • Users, with ajax and templating support
• Relevant shortcodes, most important:
  • [widget] – drop arbitrary widgets anywhere
  • [query] – custom queries with templating support within the editor
• Modules that can further extend functionality: Featured Gallery, Ad management
• Many more features

…so, here are all the steps:

First download and install Poedit.

Select the theme you wish to translate and extract or copy the theme files into a new directory. In this example, I’m unzipping all the theme files inside the C:\mystique directory. Now open the PoEdit application, and create a new catalog  (File > New catalog), or you can open an existing catalog from the theme directory, if the theme has one. For example, the en_US.po file for Mystique.

From the menu, select Catalog > settings and fill all the required information.

Don’t close the settings window yet. Click on the Paths tab and change the local path from 1st line with your path to the theme files, in our example C:\mystique

Click OK, then update the catalog (Catalog > Update from sources) to verify that your path to the theme is correct, and to update all the strings. You can also update the catalog from a existing .pot template, if the theme has one (that way you wouldn’t need to extract all the theme files on your computer).

If you don’t get any errors, you can start translating the theme by selecting each string in bold from the list, and typing the translation in editable area from the bottom. Here’s a sample phrase translated to French:

Be careful with the php values, such as %s, %2$s etc. Always include them in the translated string! If you want to hide some of them you can use html comments – for example if you want to hide the author link in Mystique (original string: Posted by %1$s in %2$s):

Posté <!-- par %1$s --> dans %2$s

When you’re finished, save your catalog by using the languagecode_COUNTRYCODE file naming convention, eg. as fr_FR, and upload the compiled catalog that was generated by PoEdit (eg. fr_FR.mo) to your server, in the appropriate theme language file directory. That’s it

Related resources:
WordPress in Your Language
Belorussian translation of this article (by Patricia Clausnitzer)

Mystique is a free WordPress theme that attempts to top commercial templates in terms of design and functionality. Some of its features include 4 theme widgets, page templates for different layout styles and a advanced interface for the theme settings…

Another clean/light style theme. Some of its features include the ability to switch between the normal image-based design to a entirely CSS based one (without images), a few background/color variations, fluid layout, optional 3rd column and many more…

Support this project