WP Manifestindependent plugin directory
manifest / events / venue-family-wordpress

Venue Family — Theaters, Studios & Event Spaces

Official WordPress plugin for Venue Family — Theaters, Studios & Event Spaces

by Venue Family Cooperative · github.com/venue-family/venue-family-wordpress · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/venue-family/venue-family-wordpress/archive/refs/heads/main.zip

Readme

Venue Family WordPress Plugin

Official WordPress integration for Venue Family.

Features

  • Gutenberg Blocks: 8 native block types registered in a dedicated Venue Family category (event-list, calendar, tickets, form, locations, widget, signin, orders).
  • Elementor Page Builder: 5 custom Elementor widgets available directly in the Elementor visual panel.
  • Shortcodes: 11 shortcodes for all page builders (Elementor, Divi, Beaver Builder, Classic Editor, Bricks).
  • Auto-Resizing & Scroll: Zero-dependency window.postMessage bridge for dynamic height adjustments and in-embed modal scrolling.
  • Conversion Tracking: Automated integration with Google Analytics 4 (gtag), Google Tag Manager (dataLayer), and Meta Pixel (fbq).
  • Google Event SEO: Automatically injects Schema.org JSON-LD structured data into <head>.
  • Transients Caching: Intelligent 15-minute cached responses with admin "Clear Cache" button.
  • Theme Overrides: Customizable template architecture in your-theme/venue-family/.

Directory Structure

venue-family-wordpress/
├── venue-family.php                  # Main plugin header & lifecycle hooks
├── readme.txt                        # WordPress.org standard metadata
├── README.md                         # Developer documentation
├── composer.json                     # PHP dependencies & test runner
├── package.json                      # npm scripts & test tools
├── .wp-env.json                      # wp-env Docker test environment
├── includes/
│   ├── class-vf-admin.php            # Settings page & AJAX actions
│   ├── class-vf-api-client.php       # HTTP client with transient caching
│   ├── class-vf-seo.php              # Schema.org JSON-LD generator
│   ├── class-vf-analytics.php        # Conversion tracking bridge
│   ├── class-vf-shortcodes.php       # Shortcode handlers & template loader
│   ├── class-vf-blocks.php           # Gutenberg block registrations
│   ├── class-vf-widget.php           # Classic WordPress widget
│   ├── class-vf-elementor.php        # Elementor category & widget manager
│   └── elementor/                    # Dedicated Elementor widget classes
├── assets/
│   ├── js/
│   │   ├── embed-resizer.js          # postMessage event listener & pixel bridge
│   │   ├── admin.js                  # Settings page AJAX scripts
│   │   └── blocks.js                 # Gutenberg blocks definition
│   └── css/
│       ├── admin.css                 # Admin styles
│       └── venue-family-public.css   # Responsive public cards, grids & locations
├── templates/
│   ├── event-grid.php
│   ├── event-list.php
│   ├── event-card.php
│   ├── event-single.php
│   ├── location-grid.php
│   ├── location-card.php
│   └── embed-wrapper.php
└── tests/
    ├── phpunit.xml
    ├── bootstrap.php
    ├── Unit/                         # Isolated PHPUnit tests
    └── E2E/                          # Playwright browser tests

Testing & Quality Assurance

1. Isolated Unit Tests (PHPUnit)

composer test

2. Live WordPress Docker Test Environment (wp-env)

npm install
npx wp-env start

Boots a live WordPress instance at http://localhost:8888 with the plugin pre-activated (credentials: admin / password).

3. Playwright E2E Browser & Iframe Tests

npx playwright test

Packaging for Release

To generate a clean .zip archive for distribution or WordPress.org submission:

zip -r venue-family.zip . -x "node_modules/*" "vendor/*" "tests/*" ".git*" ".wp-env.json" "package*.json" "composer*.json" "phpunit.xml"

Read the full README on GitHub →