WP-PostViews Plugin Guide: Display Post Views and Popular Content

Plugin Introduction

WP-PostViews is a classic WordPress plugin for tracking and displaying post view counts. This guide covers installation, configuration, and usage of its main features.

Basic Usage: Display Post Views

To show view counts in posts or pages, you need to add the appropriate function call to your theme template files.

Step 1: Locate Template Files

Open your current theme's template files, such as:

• wp-content/themes/your-theme/index.php (Homepage)
• wp-content/themes/your-theme/single.php (Single Post)
• wp-content/themes/your-theme/page.php (Single Page)

Step 2: Insert Function Call

Add the following code at an appropriate location in the template file (typically below the post title or near the content):

<?php if(function_exists('the_views')) { the_views(); } ?>

You can customize the display text:

<?php if(function_exists('the_views')) { the_views('Views: '); } ?>

Note: Ensure the code is placed inside the WordPress main loop, typically between <?php while ( have_posts() ) : the_post(); ?> and <?php endwhile; ?>.

Advanced Features: Display Popular Content

1. Show Most Popular Posts/Pages

This feature displays a list of the most-viewed content in a sidebar or custom page template.

Basic usage:

<?php if(function_exists('get_most_viewed')) { get_most_viewed(); } ?>

Custom parameters:

<?php if(function_exists('get_most_viewed')) { get_most_viewed('both', 5); } ?>

Parameter explanation:

• First parameter: Content type. Options: 'post' (posts only), 'page' (pages only), or 'both' (both, default).
• Second parameter: Maximum number of items to display (default is 10).

2. Show Popular Posts in a Specific Category

This function displays the most-viewed posts within a particular category.

Basic usage:

<?php if(function_exists('get_most_viewed_category')) { get_most_viewed_category(); } ?>

Custom parameters:

<?php if(function_exists('get_most_viewed_category')) { get_most_viewed_category(1, 'post', 5); } ?>

Parameter explanation:

• First parameter: Category ID (required).
• Second parameter: Content type ('post', 'page', 'both', default is 'both').
• Third parameter: Maximum number of items to display (default is 10).

Important Notes & Best Practices

1. Function Existence Check: Always use if(function_exists(...)) before calling plugin functions to ensure code only runs when the plugin is active, preventing site errors.
2. Cache Compatibility: If you use page caching plugins (e.g., W3 Total Cache, WP Super Cache), view counts may not update in real-time. Check your cache plugin's documentation for setting exceptions for dynamic content.
3. Performance Considerations: Calling query functions like get_most_viewed on the homepage or archive pages can increase database load. For high-traffic sites, consider using caching or calling via widgets.
4. Plugin Settings: Most display settings (e.g., excluding logged-in users, count delay) can be configured in the WordPress admin under Settings → PostViews.

Using these methods, you can effectively add view count tracking and popular content display to your WordPress site, enhancing user engagement.