Clicky Popular Posts

Display the most popular posts from Clicky Analytics with configurable time periods, post types, and caching.

Description

Clicky Popular Posts integrates with Clicky Analytics to display your most popular posts based on real visitor data. This plugin provides a flexible and customizable way to showcase your top-performing content to increase engagement and page views.

Key Features:

• Real Analytics Data: Uses Clicky Analytics API to fetch actual visitor statistics
• Flexible Time Periods: Choose from last 7 days, 14 days, 30 days, yesterday, last week, or last month
• Post Type Filtering: Select which post types to include (posts, pages, custom post types, woocommerce products)
• Caching System: Built-in caching to improve performance and reduce API calls
• Customizable Display: Configure number of posts, widget title, and view count visibility
• Shortcode Support: Easy integration anywhere with [clicky_popular_posts] shortcode
• Security First: Proper data sanitization, nonce verification, and security checks

Shortcode Usage:

The plugin provides a flexible shortcode with multiple attributes:

• [clicky_popular_posts] - Basic usage with default settings
• [clicky_popular_posts limit="5"] - Show only 5 posts
• [clicky_popular_posts title="Popular Content"] - Custom title
• [clicky_popular_posts post_types="post,page"] - Specific post types
• [clicky_popular_posts period="last-30-days"] - Custom time period
• [clicky_popular_posts show_views="false"] - Hide view counts

Requirements:

• Active Clicky Analytics account
• Clicky Site ID and API Key (Site Key)
• WordPress 4.7 or higher
• PHP 7.4 or higher

Installation

1. Upload the plugin files to the /wp-content/plugins/clicky-popular-posts directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to Settings > Clicky Popular Posts to configure the plugin.
4. Enter your Clicky Analytics Site ID and API Key (found in your Clicky account).
5. Configure your preferred settings (time period, post types, cache duration, etc.).
6. Use the shortcode [clicky_popular_posts] in posts, pages, or widgets to display popular posts.

Frequently Asked Questions

Where do I find my Clicky Site ID and API Key?

1. Log into your Clicky Analytics account
2. Go to your site's dashboard
3. Site ID is displayed in the URL or site settings
4. API Key (Site Key) can be found in Preferences > API

How often does the plugin update the popular posts?

The plugin uses a caching system to improve performance. By default, data is cached for 60 minutes, but you can adjust this from 1 minute to 24 hours in the settings.

Can I display popular posts from specific post types only?

Yes! In the plugin settings, you can select which post types to include. The plugin supports all public post types including custom post types.

The plugin shows "No popular posts data available" - what's wrong?

This usually means:

• Your Clicky Site ID or API Key is incorrect
• Your site doesn't have enough traffic data for the selected time period
• The API connection is blocked by your hosting provider
• Use the "Test API Connection" button in settings to diagnose the issue

Can I customize the appearance of the popular posts list?

Yes! The plugin includes CSS classes that you can style:

• .clicky-popular-posts-container - Main container
• .clicky-popular-posts - The list
• .clicky-popular-posts li - Individual list items
• .cpp-views - View count spans

Does this work with caching plugins?

Yes, the plugin is compatible with caching plugins. It has its own internal caching system that works alongside page caching solutions.

Can I use multiple shortcodes with different settings?

Absolutely! You can use the shortcode multiple times with different attributes:

• [clicky_popular_posts limit="3" period="yesterday" title="Yesterday's Top Posts"]
• [clicky_popular_posts post_types="page" limit="5" title="Popular Pages"]

Screenshots

1. Plugin settings page with all configuration options
2. Example of popular posts display on the frontend
3. Shortcode usage examples and attributes
4. API connection test interface

Changelog

1.3

• Enhanced security with proper nonce verification
• Improved error handling and user feedback
• Added support for multiple time periods (yesterday, last week, last month)
• Better sanitization of all user inputs
• Optimized caching system with automatic cleanup
• Added comprehensive shortcode attribute support
• Improved admin interface with better descriptions
• Fixed PHP 8.0+ compatibility issues

1.2

• Added caching system for improved performance
• Support for custom post types
• Configurable number of posts to display
• Added view count display option
• Better error handling and API validation

1.1

• Added shortcode support
• Improved admin interface
• Added post type filtering
• Enhanced security measures

1.0

• Initial release
• Basic Clicky Analytics integration
• Simple popular posts display

Upgrade Notice

1.3

This version includes important security improvements and new features. Recommended for all users.

1.2

Major performance improvements with caching system. Update recommended for better site speed.

1.1

Adds shortcode support and improved functionality. Backup before updating.

Additional Information

Support: For support, feature requests, or bug reports, please visit our support page or contact us directly.

Privacy: This plugin connects to Clicky Analytics API to retrieve popular posts data. No personal information is transmitted beyond what's necessary for API authentication.

Performance: The plugin is optimized for performance with built-in caching, minimal database queries, and efficient API usage.

Compatibility:

• WordPress Multisite compatible
• Translation ready
• Works with popular themes and page builders
• Compatible with major caching plugins

Developer Notes:

• Uses WordPress coding standards
• Follows security best practices
• Includes comprehensive sanitization and validation
• Extensible with WordPress hooks and filters