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

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/venue-family/venue-family-wordpress/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/venue-family/venue-family-wordpress ↗

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"