Skip to content

Latest commit

 

History

History
164 lines (118 loc) · 4.22 KB

README.md

File metadata and controls

164 lines (118 loc) · 4.22 KB
Raw

NPR Posts Plugin

A WordPress plugin that displays your newest, most popular, and random posts in an elegant tabbed interface.

Description

NPR Posts Plugin provides a simple yet effective way to showcase different categories of your posts:

  • Newest posts
  • Most popular posts (based on comment count)
  • Random posts

The plugin uses a clean, modern tabbed interface that smoothly transitions between different post lists.

Features

  • Responsive tabbed interface
  • Displays 5 posts per category (customizable)
  • Supports both regular posts and custom post types
  • Easy to implement using shortcode
  • Lightweight and optimized for performance
  • RTL support
  • Async JavaScript loading
  • Customizable through WordPress filters

Installation

  1. Download the plugin files
  2. Upload the plugin folder to the /wp-content/plugins/ directory
  3. Activate the plugin through the 'Plugins' menu in WordPress

Usage

Basic Usage

Use the shortcode [npr_tab] in any post, page, or widget where you want to display the tabbed posts interface.

Example:

[npr_tab]

Customization Through Filters

The plugin provides filters to customize the query parameters without modifying the plugin files. Here are some common customization examples:

1. Change Number of Posts Displayed

Add this code to your theme's functions.php file or a site-specific plugin:

add_filter('npr_query_args', function($args) {
    $args['posts_per_page'] = 10; // Change from default 5 to 10 posts
    return $args;
});

2. Include Custom Post Types

To display custom post types alongside regular posts:

add_filter('npr_query_args', function($args) {
    // Replace 'product' and 'course' with your custom post type names
    $args['post_type'] = ['post', 'product', 'course'];
    return $args;
});

3. Advanced Customization Example

Customize different parameters based on tab type:

add_filter('npr_query_args', function($args) {
    // Customize based on orderby parameter to target specific tabs
    switch ($args['orderby']) {
        case 'ID': // Newest posts tab
            $args['posts_per_page'] = 8;
            $args['post_type'] = ['post', 'news'];
            break;
            
        case 'comment_count': // Popular posts tab
            $args['posts_per_page'] = 5;
            $args['post_type'] = ['post'];
            $args['minimum_comments'] = 3; // Only posts with at least 3 comments
            break;
            
        case 'rand': // Random posts tab
            $args['posts_per_page'] = 3;
            $args['post_type'] = ['product']; // Only show random products
            break;
    }
    
    return $args;
});

4. Filter Posts by Category

Show posts from specific categories:

add_filter('npr_query_args', function($args) {
    $args['category__in'] = [4, 7]; // Replace with your category IDs
    return $args;
});

CSS Customization

The plugin uses the following main CSS classes that you can customize:

  • .wrap: Main container
  • .tabs: Tab navigation container
  • .active: Active tab style
  • #content: Content area for posts

Add your custom CSS to your theme's stylesheet:

/* Example: Change tab colors */
.tabs li a {
    background: #your-color;
}

.tabs li a.active {
    background: #your-active-color;
}

Requirements

  • WordPress 5.0 or higher
  • PHP 7.2 or higher

Frequently Asked Questions

How do I change the number of posts displayed?

Use the npr_query_args filter as shown in the Customization section above.

Can I show custom post types?

Yes, use the npr_query_args filter to modify the post_type parameter. See the examples in the Customization section.

Can I change the tab labels?

Currently, the tab labels are filterable through WordPress translations. You can add translations for your language or use a translation plugin.

Changelog

1.0.0

  • Initial release
  • Added customization filters
  • Added support for custom post types
  • Added RTL support

License

This plugin is licensed under the GPL v2 or later.

Credits

Created by Sadeq Yaqobi (http://siteyar.net/sadeq-yaqobi/)

Support

For support, please visit http://siteyar.net/plugins/

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.