PLuG Overlay Manager

Chrome Extension for DevRev PLuG Integration

v1.0.0 Chrome Extension

Seamless PLuG Integration

Enable DevRev PLuG widgets on any website using advanced "green screen" masking technology that bypasses CSP restrictions and provides perfect click-through functionality. Supports both anonymous and identified user experiences with email and display name integration.

See It In Action

PLuG seamlessly integrated into the MLB Yankees website

PLuG widget overlay on MLB.com/yankees

Powerful Features

Everything you need for seamless PLuG integration

CSP Bypass

Uses iframe overlay technique to completely bypass Content Security Policy restrictions on any website.

Auto-Activation

Automatically activates PLuG on configured sites with forced reactivation on SPA navigation.

Dynamic Masking

Shows only PLuG widgets while allowing clicks through to the underlying website.

Chat Expansion

Automatically detects when PLuG chat opens and dynamically expands the visible overlay area.

SPA Support

Monitors navigation in single-page applications (React, Vue, Angular) for seamless integration.

Live Configuration

Real-time configuration management with instant updates and pattern-based site matching.

User Identification

Support for identified users with email and display name for personalized PLuG experiences.

Installation

Get up and running in minutes

1

Download the Extension

Download the extension files to your local machine.

Download and extract the extension files
2

Enable Developer Mode

Open Chrome and navigate to chrome://extensions/ and enable "Developer mode" in the top right corner.

3

Load the Extension

Click "Load unpacked" and select the Chrome Extensions/plug-overlay-manager folder.

4

Configure Sites

Right-click the extension icon and select "Options" to configure your PLuG-enabled sites.

Step-by-step installation process

Configuration

Set up your PLuG-enabled sites

Extension options page configuration interface

Site Configuration Fields

Site Name

Friendly name for identification (e.g., "Yankees Website")

URL Pattern

Wildcard pattern to match sites (e.g., "*yankees*")

PLuG App ID

Your DevRev PLuG application identifier

RevUser Email (Optional)

User email for identified PLuG experiences

Display Name (Optional)

Friendly name shown in conversations

URL Pattern Examples

yankees.com → Matches yankees.com and all subpages
*.yankees.com → Matches any subdomain
*yankees* → Matches any URL containing "yankees"
mlb.com/yankees → Matches specific path only

User Identification

Enable personalized PLuG experiences with identified users

Anonymous vs Identified Users

Anonymous Mode

PLuG works without user identification. Conversations are not linked to specific users in DevRev.

Identified Mode

Users are identified by email and display name. Conversations are tracked and linked to specific users in DevRev.

Configuration Fields

RevUser Email (Optional)

User's email address for identification in DevRev conversations

Display Name (Optional)

Friendly name shown in PLuG conversations (only used when email is provided)

PLuG SDK Integration

window.plugSDK.init({
  app_id: "your-app-id",
  identity: {
    user_ref: "user@example.com",
    user_traits: {
      email: "user@example.com",
      display_name: "John Doe"
    }
  }
})

Benefits of User Identification

Personalized conversation history

User tracking in DevRev analytics

Contextual support experiences

Better customer relationship management

Usage

How to use the extension effectively

Manual Toggle

Click the extension icon to manually toggle PLuG overlay on/off for the current site.

Ctrl+Shift+P keyboard shortcut

Auto-Activation

Enable in settings to automatically show PLuG on configured sites. Reactivates on navigation.

Force reactivation overrides manual toggles

Options

Right-click the extension icon to access configuration options and site management.

Manage multiple site configurations

Technical Architecture

How the green screen masking works

Core Technology

Iframe Overlay: Creates isolated environment that bypasses CSP restrictions

CSS Masking: Green screen technique shows only PLuG elements

Click Forwarding: Transparent overlay allows clicks through to website

Dynamic Sizing: Real-time adjustment to PLuG widget dimensions

PLuG Integration

// Anonymous Mode
{
  app_id: "your-devrev-app-id",
  target: domElement
}

// Identified Mode
{
  app_id: "your-devrev-app-id",
  identity: {
    user_ref: "user@example.com",
    user_traits: {
      email: "user@example.com",
      display_name: "John Doe"
    }
  }
}

Browser Compatibility

Chrome 90+ Edge 90+ Chromium

Troubleshooting

Common issues and solutions

PLuG Widget Not Appearing

Check: Extension is enabled and site configuration exists

Verify: URL pattern matches current site

Debug: Open browser console for PLuG initialization logs

Try: Manual toggle with extension icon click

SPA Navigation Issues

Enable: Auto-activation in extension settings

Pattern: Use broader URL patterns like "*domain*"

Monitor: Extension detects pushState/replaceState navigation

Debug Mode

Enable: Debug mode in extension options

Console: Detailed logs with 🚀 🔍 📝 emojis

Monitor: Real-time widget size and position tracking