cannaiq/wordpress-plugin/dutchie-analytics/README.md

Dispensary Analytics WordPress Plugin

Beautiful WordPress plugin for displaying Arizona dispensary product data with Elementor widgets and shortcodes.

By CreationShop - https://creationshop.io

Features

• Elementor Widgets: Drag-and-drop widgets for products, stores, brands, and specials
• Beautiful Carousels: Auto-playing product sliders with Swiper.js
• Flexible Shortcodes: Easy-to-use shortcodes for any page builder
• Field Selection: Choose which data fields to display
• Multiple Styles: Modern, Minimal, and Bold card designs
• Responsive Design: Perfect on all devices
• High-Performance: Lazy loading and optimized API calls
• SEO Friendly: Semantic HTML and proper image alt tags

Installation

1. Upload the dutchie-analytics folder to /wp-content/plugins/
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings → Dutchie Analytics
4. Enter your API URL and authentication token
5. Test the connection

Configuration

API Settings

Navigate to Settings → Dutchie Analytics:

• API URL: Your Dutchie Analytics API endpoint (e.g., https://api.dutchieanalytics.com/api)
• API Token: Your JWT authentication token

Shortcodes

Products Grid

Display a grid of products:

[dutchie_products store_id="1" limit="12" columns="4"]

Parameters:

• store_id (required): Store ID
• limit (optional): Number of products (default: 12)
• columns (optional): Grid columns (default: 4)
• category_id (optional): Filter by category
• in_stock (optional): Show only in-stock products (default: true)
• search (optional): Search term
• fields (optional): Comma-separated fields to display
• style (optional): Card style - modern, minimal, bold (default: modern)

Products Carousel

Display a sliding carousel:

[dutchie_carousel store_id="1" limit="20" slides_per_view="4"]

Parameters:

• store_id (required): Store ID
• limit (optional): Number of products (default: 20)
• slides_per_view (optional): Slides visible at once (default: 4)
• category_id (optional): Filter by category
• autoplay (optional): Enable autoplay (default: true)
• style (optional): Card style (default: modern)

Stores List

Display all stores:

[dutchie_stores]

Brands List

Display brands for a store:

[dutchie_brands store_id="1"]

Daily Specials

Display store specials:

[dutchie_specials store_id="1" date="2025-01-15"]

Parameters:

• store_id (required): Store ID
• date (optional): Date for specials (default: today)

Field Selection

Control which fields to display using the fields parameter:

[dutchie_products store_id="1" fields="id,name,price,brand,thc_percentage,in_stock"]

Available Fields:

• id - Product ID
• name - Product name
• brand - Brand name
• price - Price
• description - Description
• thc_percentage - THC %
• cbd_percentage - CBD %
• weight - Weight
• strain_type - Strain type
• in_stock - Stock status
• image_url_full - High-resolution image (2000x2000)

Elementor Widgets

Find all widgets in the Dutchie Analytics category in Elementor:

1. Products Grid - Customizable product grid
2. Products Carousel - Auto-playing slider
3. Stores List - Store directory
4. Brands List - Brand badges
5. Specials - Daily deals

Widget Controls

Each widget provides:

• Content Tab: Data source, filters, display options
• Style Tab: Colors, spacing, card styles
• Advanced Tab: CSS classes, animations

Card Styles

Modern (Default)

• Clean white cards
• Subtle shadows
• Smooth hover effects
• Blue accent colors

Minimal

• Simple borders
• No shadows
• Hover border highlights
• Ultra-clean design

Bold

• Gradient backgrounds
• Vibrant colors
• Large shadows
• Eye-catching design

Customization

Custom CSS

Add custom styles in your theme's CSS:

.dutchie-product-card-modern {
    border-radius: 20px;
    /* Your custom styles */
}

Hooks and Filters

Coming soon: WordPress hooks for advanced customization.

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Elementor (optional, for widgets)

Support

For support, visit: https://dutchieanalytics.com/support

Changelog

1.0.0

• Initial release
• Elementor widgets
• Shortcodes
• Field selection
• Multiple card styles
• Carousel support

License

GPL v2 or later