Quick Start

{
  sort: true,
  sort_items: [
    { value: 'date', label: 'Date' },
    { value: 'title', label: 'Title' },
    { value: 'menu_order', label: 'Menu Order' }
  ],
  sort_default: 'date'
}

your-theme/
└── visual-portfolio/
    ├── items-list/
    │   └── masonry/
    │       └── layout.php    # Override masonry layout
    └── items-list-item/
        └── classic/
            └── item.php      # Override classic item template

// Example: Override item template
// Copy from: visual-portfolio/templates/items-list-item/classic/item.php
// To: your-theme/visual-portfolio/items-list-item/classic/item.php

// Template loading in classes/class-templates.php:87
public static function find_template($template_name) {
    // Check theme first
    $template = locate_template('visual-portfolio/' . $template_name);
    
    // Fall back to plugin
    if (!$template) {
        $template = visual_portfolio()->plugin_path . 'templates/' . $template_name;
    }
    
    return $template;
}

/* Custom CSS in block settings */
.vp-portfolio__item {
  transition: transform 0.3s ease;
}

.vp-portfolio__item:hover {
  transform: translateY(-5px);
}

/* Use CSS variables for theming */
.vp-portfolio {
  --vp-item-gap: 30px;
  --vp-overlay-bg: rgba(0, 0, 0, 0.8);
}

// Plugin handles asset loading efficiently
// Located in classes/class-assets.php
public function enqueue_scripts() {
    // Only load scripts on pages with Visual Portfolio
    if (!$this->has_portfolio_on_page()) {
        return;
    }
    
    // Modular loading - only load what's needed
    $this->enqueue_layout_assets();
    $this->enqueue_popup_assets();
}