Download the PHP package vizor-vr/laravel-vizor without Composer

Vizor for Laravel

Laravel package for the Vizor VR video player. Provides 7 Blade components, 6 Livewire components with reactive state, an Alpine.js plugin, a full API facade, Filament admin integration, license validation middleware, and a Tailwind CSS preset -- everything you need to embed 360/VR/WebXR video in a Laravel application.

Requirements

• PHP 8.2+
• Laravel 11 or 12
• Livewire 3+

Installation

The install command publishes the config file, the Alpine.js plugin, and generates a test page at /vizor-test.

Quick Start

1. Install the package

2. Add environment variables

3. Use a Blade component

Visit /vizor-test to verify the player renders correctly.

Blade Components

All 7 components auto-include the player script via @vizorScripts and accept an optional {{ $slot }} for child elements.

Video

Image

Tour

Cinema

Live Stream

Playlist

Annotations

Nest <x-vizor-annotation> inside a video component to place 3D hotspots:

Livewire Components

Full server-side reactive state with two-way binding. All components use the HasVizorEvents and HasVizorProps traits.

Usage

Server-Side Control

All video-based Livewire components expose play(), pause(), and seek() methods you can call from other Livewire components or from Blade:

Generating Custom Components

Scaffold a new Livewire component with Vizor boilerplate:

This creates app/Livewire/MyCustomPlayer.php and resources/views/livewire/my-custom-player.blade.php with the full event handler scaffold.

Alpine.js Plugin

For projects that don't use Livewire, the Alpine.js plugin provides client-side reactive bindings with no server round-trips.

Setup

Register the plugin in your resources/js/app.js:

Usage

The vizorPlayer data component exposes: ready, playing, currentTime, duration, volume, muted, fullscreen, loading, error -- plus methods play(), pause(), togglePlay(), seek(t), toggleMute(), setVolume(v), enterFullscreen(), exitFullscreen().

Vizor Facade

The Vizor facade provides typed access to the Vizor REST API. It is backed by the VizorManager class and configured via VIZOR_API_KEY and VIZOR_API_URL.

Content

Analytics

API Keys

License Keys

Billing

Artisan Commands

All commands accept --force to overwrite existing files.

Middleware

The vizor.license middleware validates your license key against the Vizor API (with cache). On failure it degrades the tier to free (watermark, mono only) rather than blocking the request.

Route Group

Configuration

Filament Integration

The package includes a Filament v3 plugin with a content resource and an embeddable player widget.

Setup

Enable in your .env:

Register the plugin in your panel provider:

This adds:

• Content Resource -- full CRUD table for Vizor content
• Player Widget -- embeddable VR player widget for dashboards

Broadcasting

Optionally broadcast player events (play, pause, ended, ready, error, timeupdate) over Laravel Echo for real-time dashboards or collaborative features.

Enable

Listen

Events broadcast: PlayerReady, PlayerPlay, PlayerPause, PlayerEnded, PlayerError, PlayerTimeUpdate.

Tailwind CSS Preset

Import the preset in your tailwind.config.js for Vizor-specific utilities:

Included utilities

Configuration Reference

Publish the config file with php artisan vendor:publish --tag=vizor-config.

Publishable Assets

Supported Formats

The FormatEnum enum covers all 19 projection formats:

Testing

The package uses Pest with both unit and feature tests.

Tests cover: service provider registration, Blade components, Livewire components, Facade API client, middleware, commands, broadcasting, Filament plugin, Tailwind preset, config, enums, and traits.

Changelog

See CHANGELOG.md for release history.

License

The MIT License (MIT). See LICENSE for details.