Modern gallery and portfolio plugin with advanced layouts editor for WordPress.

Website   Documentation   WordPress Plugin   Pro Version

Overview

Visual Portfolio provides powerful tools to showcase your works and photo galleries. Key features:

• 🎨 Visual Gallery Builder
• ⚡ Optimized Performance
• 📱 Responsive Layouts
• 🖼️ Modern Lightbox
• 🎯 SEO Friendly
• 🔄 AJAX Loading

Development

Prerequisites

• PHP >= 7.2
• Node.js >= 22.0
• Composer >= 2.0
• Docker (for the local WordPress environment)

Getting Started

Clone the repository, then run:

./scripts/worktree-setup.sh

That installs dependencies and starts a local WordPress environment. The same script prepares a fresh git worktree.

Development Commands

# Start development
npm run dev

# Build for production
npm run build

# Create plugin zip
npm run build:prod

Code Quality

We use automated tools to ensure code quality. Pre-commit and pre-push hooks are configured for:

• PHP CodeSniffer
• ESLint
• Stylelint

# Linting
npm run lint:php    # Check PHP code
npm run lint:js     # Check JavaScript code
npm run lint:css    # Check CSS code

# Auto-fixing
npm run format:php  # Fix PHP code
npm run format:js   # Fix JavaScript code
npm run format:css  # Fix CSS code

Local WordPress

We use WordPress's official testing environment powered by Docker and wp-env.

npm run env:start    # Start the development and tests sites
npm run env:ports    # Print their URLs
npm run env:stop     # Stop them
npm run play         # Boot the plugin in WordPress Playground, no Docker needed

Every checkout gets its own containers and database. Linked worktrees also get their own ports, so several branches can run at the same time; the main checkout keeps the usual 8888 and 8889.

Testing

# End-to-end tests (Playwright)
npm run test:e2e

# PHP Unit tests
npm run test:unit:php

License

This project is licensed under the GPL-2.0-or-later License - see the LICENSE file for details.