=== Pixel Clusters === Contributors: kakaroto84 Donate link: https://www.paypal.com/donate/?hosted_button_id=NY5NTM46C5PS4 Tags: cluster, posts, categories, tags, shortcode, responsive, woocommerce, custom post type Requires at least: 6.4 Tested up to: 6.9 Requires PHP: 8.0 Stable tag: 2.1.2 License: GPLv3 or later License URI: http://www.gnu.org/licenses/gpl-3.0.html Create beautiful, responsive post clusters with shortcodes or Gutenberg blocks. Display posts, categories, tags, custom post types, and WooCommerce products in elegant layouts. == Description == **Pixel Clusters** is a powerful yet simple WordPress plugin that allows you to create beautiful clusters of posts, categories, tags, and products using shortcodes. = 🚀 Key Features = * **Gutenberg Block**: Native block editor support with live preview * **4 Display Modes**: Choose from full articles, card layouts, simple lists, or product grids * **Multiple Content Sources**: Works with categories, tags, custom post types, and WooCommerce * **Fully Responsive**: Looks great on all devices - desktop, tablet, and mobile * **Modern Admin Interface**: Clean, AJAX-powered admin panel with live preview * **WooCommerce Integration**: Display products with prices and add-to-cart buttons * **Custom Post Type Support**: Works with any registered custom post type and taxonomy * **Easy to Use**: Simple shortcode generator or Gutenberg block - no coding required * **Performance Optimized**: Lightweight and fast-loading * **Accessibility Ready**: Full keyboard navigation and screen reader support = 🎨 Display Modes = 1. **Full Article** - Image, title, and excerpt in a clean layout 2. **Cards** - Beautiful card grid with images and titles 3. **List** - Simple, elegant list of post titles 4. **Products** - WooCommerce products with prices and cart buttons = 📝 How to Use = **Using Gutenberg Block (Recommended):** 1. Open the Block Editor in any post or page 2. Click the + button to add a block 3. Search for "Pixel Cluster" or find it in the Widgets category 4. Configure settings in the block sidebar 5. See live preview directly in the editor **Using Shortcode Generator:** 1. Go to **Clusters** in your WordPress admin menu 2. Select your preferred display mode 3. Choose the content type (categories, tags, custom post type, etc.) 4. Set the number of posts to display 5. Copy the generated shortcode 6. Paste it in any post, page, or widget = 💡 Example Shortcodes = Display 4 posts from a category: `[cluster type="1" tag_id="5" modo="1" numero="4"]` Display products from WooCommerce: `[cluster type="4" modo="4" numero="6"]` Display custom post type: `[cluster type="3" post_type="portfolio" taxonomy="portfolio_cat" tag_id="10" modo="2" numero="3"]` = 🔧 Shortcode Parameters = * **type** - Content source: 1=Categories, 2=Tags, 3=Custom Post Type, 4=WooCommerce Categories, 5=WooCommerce Tags * **tag_id** - The term ID to filter by (optional) * **modo** - Display mode: 1=Full, 2=Cards, 3=List, 4=Products * **numero** - Number of posts to display (default: 4) * **post_type** - Custom post type slug (for type=3) * **taxonomy** - Custom taxonomy slug (for type=3) == Installation == = Automatic Installation = 1. Go to **Plugins → Add New** in your WordPress admin 2. Search for "Pixel Clusters" 3. Click **Install Now** and then **Activate** = Manual Installation = 1. Download the plugin ZIP file 2. Go to **Plugins → Add New → Upload Plugin** 3. Choose the ZIP file and click **Install Now** 4. Activate the plugin = FTP Installation = 1. Download and unzip the plugin 2. Upload the `pixel-clusters` folder to `/wp-content/plugins/` 3. Activate through the **Plugins** menu in WordPress == Frequently Asked Questions == = Does it work with custom post types? = Yes! Pixel Clusters fully supports custom post types and their taxonomies. Select "Custom Post Type" in the generator and choose your post type and taxonomy. = Is it compatible with WooCommerce? = Absolutely! Display your WooCommerce products with prices and add-to-cart buttons. Select mode 4 (Products) for the best WooCommerce experience. = Can I customize the styling? = Yes, all elements have CSS classes that you can target in your theme's stylesheet or the WordPress Customizer. = Is it responsive? = Yes! All display modes are fully responsive and look great on mobile devices, tablets, and desktops. = Does it support Gutenberg? = Yes! Pixel Clusters includes a native Gutenberg block with full support for: * Live preview in the editor * All display modes and content types * Block alignment (wide and full width) * Server-side rendering for accurate previews Simply search for "Pixel Cluster" in the block inserter to add it to your content. = Is it translation ready? = Yes! The plugin is fully translatable and includes a POT file for translations. == Screenshots == 1. Modern admin interface with shortcode generator 2. Live preview feature 3. Documentation tab with parameter reference 4. Card layout display mode 5. Product grid with WooCommerce integration 6. Mobile responsive design == Changelog == = 2.1.2 = * Tested and confirmed compatible with WordPress 6.9. * Routine code review and compliance validation. = 2.1.1 = * Minor Change = 2.1.0 = **Gutenberg Block Support** * **New**: Native Gutenberg block for the block editor * **New**: Live preview in the block editor * **New**: Block sidebar controls for all settings * **New**: Support for wide and full width alignments * **New**: Server-side rendering for accurate previews * **New**: Dynamic category/tag/taxonomy loading * **Improved**: Better integration with WordPress 6.9 block editor = 2.0.0 = **Major Update - Complete Redesign** * **New**: Modern, AJAX-powered admin interface * **New**: Live shortcode preview feature * **New**: Tab-based navigation (Generator / Documentation) * **New**: Toast notifications for user feedback * **New**: CSS variables for easy customization * **New**: Grid-based responsive layouts * **New**: Improved accessibility (WCAG 2.1 compliant) * **New**: Support for WordPress admin color schemes * **Improved**: Complete CSS rewrite with modern standards * **Improved**: Better WooCommerce integration * **Improved**: Enhanced security with proper escaping and nonces * **Improved**: Code refactored using OOP principles * **Improved**: Performance optimizations * **Improved**: Mobile responsive design * **Fixed**: Various bug fixes and improvements * **Compatibility**: Tested with WordPress 6.9 * **Compatibility**: Tested with PHP 8.0, 8.1, 8.2, and 8.3 = 1.0.8 = * Tested and confirmed compatibility with WordPress 6.9 * Updated Clipboard API to modern standard * Improved output escaping for security = 1.0.7 = * Tested in last WP Version = 1.0.6.1 = * Change required version of PHP = 1.0.6 = * Tested in last WP Version = 1.0.5 = * Tested in last WP Version = 1.0.4 = * Tested in last WP Version = 1.0.3 = * Tested in last WP Version = 1.0.2 = * Tested new version of WP = 1.0.1 = * Added copy button for shortcode = 1.0.0 = * Initial release == Upgrade Notice == = 2.1.0 = New Gutenberg block support! Create post clusters directly in the block editor with live preview. Fully backward compatible with existing shortcodes. = 2.0.0 = Major update with completely redesigned admin interface, live preview, improved responsive design, and enhanced WooCommerce integration. Recommended update for all users. == Privacy Policy == Pixel Clusters does not collect, store, or share any personal data. The plugin does not use cookies, tracking, or external services.