Skip to content

Repository files navigation

<<<<<<< HEAD

Gallery WooCommerce Elementor

A comprehensive WordPress plugin that transforms your WooCommerce shop into a stunning photography gallery inspired by Chris Burkard's style. Features advanced masonry layouts, Elementor widgets, and photo print variations.

Features

Gallery Styles

  • Chris Burkard Style: Professional masonry layout with varied item sizes
  • Modern Style: Clean grid layout with smooth animations
  • Classic Style: Traditional gallery with elegant overlays
  • Minimal Style: Simple and clean presentation

Core Features

  • Advanced masonry layouts with proper aspect ratios
  • Elementor widgets for custom gallery designs
  • Photo print variations with automatic pricing
  • Lightbox functionality with keyboard navigation
  • Social sharing integration
  • Responsive design for all devices
  • Performance optimization with lazy loading
  • Customizable colors and typography

Photo Prints System

  • Automatic variation generation for print sizes
  • 15 standard print sizes (20Γ—30 to 150Γ—200 cm)
  • 3 mounting options (Print only, Print + Mount, Print + Frame)
  • Crop overlay visualization for aspect ratios
  • WPML integration for multi-language pricing
  • Bulk operations for managing multiple products

Elementor Widgets

  • Gallery Grid Widget
  • Product Masonry Widget
  • Featured Products Widget
  • Product Carousel Widget
  • Category Grid Widget

Requirements

  • WordPress 5.0 or higher
  • PHP 7.4 or higher
  • WooCommerce 8.0 or higher
  • Elementor 3.20 or higher

Installation

  1. Download the plugin zip file
  2. Go to WordPress Admin β†’ Plugins β†’ Add New
  3. Click "Upload Plugin" and select the zip file
  4. Activate the plugin
  5. Configure settings in Gallery β†’ General Settings

Configuration

Basic Setup

  1. Navigate to Gallery β†’ General Settings
  2. Choose your preferred gallery style
  3. Set the number of columns and gap size
  4. Enable/disable lightbox and social sharing
  5. Save settings

Photo Prints Setup

  1. Go to Gallery β†’ Photo Prints
  2. Set USD exchange rate for multi-language support
  3. Configure auto-apply for specific categories
  4. Customize pricing matrix if needed
  5. Use bulk actions to apply to existing products

Elementor Integration

  1. Create a new page with Elementor
  2. Search for "Gallery WooCommerce" widgets
  3. Drag and drop widgets to your page
  4. Configure widget settings
  5. Publish your page

Shortcodes

Gallery Shortcode

[gwe_gallery columns="auto" style="chris-burkard" per_page="12" enable_lightbox="true" enable_social="true"]

Featured Products Shortcode

[gwe_featured_products per_page="6" columns="3"]

Product Carousel Shortcode

[gwe_product_carousel per_page="8" slides_to_show="4" autoplay="true"]

Hooks and Filters

Actions

  • gwe_before_gallery_item
  • gwe_after_gallery_item
  • gwe_before_lightbox_open
  • gwe_after_lightbox_close

Filters

  • gwe_gallery_item_classes
  • gwe_lightbox_image_size
  • gwe_social_share_platforms
  • gwe_print_sizes
  • gwe_print_prices

Customization

CSS Custom Properties

:root {
    --gwe-primary-color: #2c3e50;
    --gwe-secondary-color: #34495e;
    --gwe-accent-color: #e74c3c;
    --gwe-text-color: #333333;
    --gwe-overlay-color: rgba(0, 0, 0, 0.7);
    --gwe-border-radius: 8px;
    --gwe-transition-speed: 0.3s;
    --gwe-gap: 20px;
}

JavaScript Events

// Gallery initialized
$(document).on('gwe_gallery_initialized', function(e, $gallery) {
    // Custom code
});

// Lightbox opened
$(document).on('gwe_lightbox_opened', function(e, imageSrc) {
    // Custom code
});

Performance

The plugin includes several performance optimizations:

  • Lazy loading for images
  • Efficient CSS Grid layouts
  • Optimized JavaScript with debouncing
  • Caching system for gallery data
  • Minimal database queries

Support

For support and documentation:

  • Visit the plugin admin panel β†’ System Status
  • Check the debug information for troubleshooting
  • Ensure all requirements are met
  • Disable other plugins to test for conflicts

Changelog

Version 2.0.0

  • Complete rewrite with modern architecture
  • Added Elementor widgets
  • Enhanced photo prints system
  • Improved performance and caching
  • New gallery styles and customization options
  • WPML integration
  • Bulk operations for photo prints

License

This plugin is licensed under the GNU General Public License v2.0 or later.

Credits

Developed by EhsanSoft Inspired by Chris Burkard's photography style

Chris Burkard Gallery Plugin

A professional WordPress plugin that transforms your WooCommerce shop into a stunning photography gallery inspired by Chris Burkard's style.

🎯 Features

Core Gallery Features

  • Masonry Layout: Beautiful Pinterest-style responsive gallery layout
  • Lightbox Gallery: Full-screen image viewing with navigation and zoom
  • Favorites System: Allow users to save favorite images to personal collections
  • Social Sharing: Integrated sharing to Facebook, Twitter, Pinterest, and Instagram
  • Mobile Optimized: Fully responsive design with touch gestures
  • Performance Optimized: Lazy loading, image optimization, and caching

WooCommerce Integration

  • Seamless integration with WooCommerce product pages
  • Support for product variations and print sizes
  • Compatible with Photo Prints Matrix plugin
  • Enhanced product galleries with lightbox functionality

Elementor Integration

  • Custom Elementor widgets for gallery display
  • Drag-and-drop gallery building
  • Real-time preview and customization
  • Compatible with Elementor Plus Addons

πŸ“‹ Requirements

  • WordPress 5.0 or higher
  • PHP 7.4 or higher
  • WooCommerce 3.0 or higher (required)
  • Elementor (recommended but optional)

πŸš€ Installation

Automatic Installation

  1. Navigate to Plugins β†’ Add New in your WordPress admin
  2. Search for "Chris Burkard Gallery"
  3. Click Install Now and then Activate

Manual Installation

  1. Download the plugin from GitHub
  2. Upload the plugin-baha folder to your /wp-content/plugins/ directory
  3. Activate the plugin through the Plugins menu in WordPress

Using the Installer

  1. Download the install-gallery-plugin.php file
  2. Upload it to your /wp-content/plugins/ directory
  3. Activate the "Gallery Installer" plugin
  4. Navigate to Plugins β†’ Gallery Installer to install the main plugin

βš™οΈ Configuration

Basic Setup

  1. After activation, go to Gallery β†’ Settings
  2. Configure your gallery preferences:
    • Enable/disable masonry layout
    • Set default columns
    • Configure lightbox settings
    • Set up social sharing platforms

Style Customization

  1. Navigate to Gallery β†’ Settings β†’ Style
  2. Choose your theme style:
    • Chris Burkard (default)
    • Minimal
    • Modern
    • Classic
    • Dark
    • Light
  3. Customize colors and animation speeds

Performance Settings

  1. Go to Gallery β†’ Settings β†’ Performance
  2. Enable lazy loading for better performance
  3. Set image quality preferences
  4. Configure caching options

🎨 Usage

Adding Gallery to Shop Pages

The plugin automatically transforms your WooCommerce shop pages into galleries. Simply:

  1. Create products in WooCommerce with high-quality images
  2. Set up product categories for organization
  3. The gallery will automatically display on shop and category pages

Using Elementor Widgets

  1. Edit a page with Elementor
  2. Search for "Chris Burkard Gallery" widgets
  3. Drag and drop widgets to your page
  4. Configure widget settings:
    • Gallery Masonry: Main gallery display
    • Gallery Lightbox: Lightbox functionality
    • Gallery Featured: Featured images showcase

Shortcodes

// Display gallery with specific category
[cbg_gallery category="landscape"]

// Display gallery with custom columns
[cbg_gallery columns="3"]

// Display featured gallery
[cbg_featured count="6"]

πŸ”§ Advanced Features

Image Optimization

The plugin includes automatic image optimization:

  • JPEG compression (85% quality)
  • PNG optimization (compression level 6)
  • WebP support
  • Responsive image sizes

Caching System

Built-in caching for improved performance:

  • Browser caching headers
  • WordPress object cache integration
  • Asset versioning for cache busting

Lazy Loading

Automatic lazy loading for all gallery images:

  • Native loading="lazy" attribute
  • Background image lazy loading
  • Intersection Observer API support

πŸ“± Mobile Optimization

The plugin is fully optimized for mobile devices:

  • Responsive grid layout
  • Touch gesture support
  • Swipe navigation in lightbox
  • Optimized image sizes for mobile
  • Fast loading on mobile connections

πŸ› οΈ Troubleshooting

Common Issues

Plugin not working after activation

  • Ensure WooCommerce is installed and activated
  • Check PHP version (requires 7.4+)
  • Clear your browser cache

Gallery not displaying

  • Verify products have featured images
  • Check that you're on a shop or category page
  • Ensure "Enable Masonry Layout" is checked in settings

Lightbox not working

  • Check for JavaScript conflicts in browser console
  • Ensure no other lightbox plugins are active
  • Verify jQuery is loading properly

Performance issues

  • Enable lazy loading in settings
  • Optimize your images before uploading
  • Consider using a caching plugin

Getting Support

  • Create an issue on GitHub
  • Check the documentation
  • Contact support through the plugin's admin panel

πŸ”„ Updates

The plugin automatically checks for updates. You can:

  • Update from the WordPress admin dashboard
  • Download the latest version from GitHub
  • Use the built-in update checker

πŸ“„ License

This plugin is licensed under the GPL v2 or later.

🀝 Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

πŸ“ˆ Changelog

Version 2.0.0

  • Removed AI optimization features
  • Removed analytics tracking
  • Simplified installation process
  • Improved performance
  • Enhanced mobile optimization
  • Fixed compatibility issues

Version 1.0.0

  • Initial release
  • Core gallery functionality
  • WooCommerce integration
  • Elementor widgets
  • Mobile optimization

πŸ”— Links


Note: This plugin is inspired by Chris Burkard's photography style but is not affiliated with or endorsed by Chris Burkard.

d7996608f6f09b78cf99ebf7a1227d72c113c23a

About

plugin

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages