=== Jassn Popular Posts ===
Contributors: jass345
Donate link: https://www.paypal.com/donate
Tags: popular posts, popular posts widget, posts, widget, sidebar
Requires at least: 4.9
Tested up to: 7.0
Requires PHP: 7.0
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display popular posts with customizable image dimensions, responsive settings, and multiple display options.

== Description ==

Jassn Popular Posts is a powerful plugin that displays your most popular posts based on comment count. It offers extensive customization options including responsive settings for different devices, image size control, and color customization.

**Features:**

* Display popular posts based on comment count
* Responsive settings for desktop, tablet, and mobile
* Customizable image dimensions (width and height)
* Multiple image sizes support
* Color customization (title and background)
* Shortcode support: [jassnpopo_popular_posts]
* Widget support
* Clean and modern design
* Lightweight and fast
* Translation ready
* GPL licensed
* Mobile friendly
* Fully security hardened

== Installation ==

1. Upload `jassn-popular-posts` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings > Popular Posts to configure the plugin
4. Use the shortcode `[jassnpopo_popular_posts]` or add the widget to your sidebar

== Frequently Asked Questions ==

= How do I display popular posts? =

Use the shortcode `[jassnpopo_popular_posts]` in any post or page, or add the "Jassn Popular Posts" widget to your sidebar.

= Can I customize image sizes? =

Yes! You can set image width, height, and choose from available WordPress image sizes in the settings page.

= Does this work with responsive themes? =

Yes! The plugin includes responsive settings for desktop, tablet, and mobile devices.

= How are popular posts determined? =

Posts are sorted by comment count in descending order.

= Can I change the number of posts displayed? =

Yes, you can set the number of posts in the settings page or using the `number` parameter in the shortcode: `[jassnpopo_popular_posts number=10]`

= Is this plugin compatible with caching plugins? =

Yes, the plugin works with all major caching plugins.

= Can I use this with page builders? =

Yes, the shortcode works with all page builders including Elementor, Gutenberg, and WPBakery.

== Changelog ==

= 1.0.6 =
* Changed prefix from "jpp" to "jassnpopo" (9 characters - meets WordPress requirement)
* Removed unprefixed shortcode "enhanced_popular_posts"
* Added range validation for numeric settings (min/max clamping)
* Improved sanitization with absint and range validation

= 1.0.5 =
* Fixed translators comment placement

= 1.0.4 =
* Fixed translators comment placement for i18n compliance

= 1.0.3 =
* Fixed fatal error due to duplicate function declarations
* Removed inline <style> tags – now uses wp_add_inline_style() properly

= 1.0.2 =
* Fixed PHP version requirement to 7.0
* Improved sanitization with whitelist validation

= 1.0.1 =
* Security hardening: All outputs properly escaped
* Removed discouraged load_plugin_textdomain()

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.6 =
Prefix change and sanitization improvements. Please update your shortcodes to use [jassnpopo_popular_posts].

= 1.0.5 =
i18n fix.

= 1.0.3 =
Critical bug fix – please update immediately.

== Screenshots ==

1. Settings page - General settings
2. Settings page - Color settings
3. Settings page - Responsive settings
4. Frontend display example
5. Widget configuration

== Support ==

For support, please visit the WordPress support forums or contact the developer through the WordPress.org profile.

== Credits ==

Developed by Jaswant Singh
WordPress.org Profile: https://profiles.wordpress.org/jass345/

== License ==

This plugin is licensed under GPLv2 or later.