Skip to content

oxfordpierpont/OneSignal-PWA-for-WordPress

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 

Repository files navigation

OneSignal PWA for WordPress

Author: Oxford Pierpont
Organization: The Oxford Pierpont Corporation
Website: https://oxfordpierpont.com

Transform any WordPress website into a full-featured Progressive Web App (PWA) with comprehensive OneSignal push notification integration in minutes.

Overview

OneSignal PWA for WordPress is the definitive solution for converting WordPress sites into installable, offline-capable Progressive Web Apps with enterprise-grade push notification capabilities. This plugin combines the power of PWA technology with OneSignal's robust messaging platform to deliver app-like experiences that drive engagement, retention, and revenue.

Why This Plugin?

  • One-Click PWA Conversion: Transform any WordPress site into an installable app without coding
  • Complete OneSignal Integration: Full-featured push notification system with advanced targeting and automation
  • Enterprise-Ready: Built for scale with multisite support, API access, and white-label capabilities
  • No Coding Required: Intuitive interface designed for non-technical users
  • Developer-Friendly: Extensive hooks, filters, and APIs for custom implementations
  • Performance Optimized: Minimal impact on site speed with intelligent caching strategies

Core Features

Progressive Web App Capabilities

Manifest Generation & Management

  • Automatic manifest.json generation with all required properties
  • Dynamic manifest updates based on site changes
  • Custom app name, short name, and description
  • Multiple icon size support (72px to 512px)
  • Theme color and background color customization
  • Display mode options (standalone, fullscreen, minimal-ui, browser)
  • Orientation control (portrait, landscape, any)
  • Start URL and scope configuration
  • Category and language settings
  • Screenshots for app store listings
  • Related applications declaration
  • Prefer related applications settings

Service Worker Implementation

  • Comprehensive service worker with versioning
  • Multiple caching strategies:
    • Cache First (performance priority)
    • Network First (freshness priority)
    • Stale While Revalidate (balance)
    • Cache Only (offline-first)
    • Network Only (always fresh)
  • Custom cache naming and versioning
  • Selective caching by post type, page, or URL pattern
  • Cache size limits and cleanup strategies
  • Background sync for offline actions
  • Periodic background sync for content updates
  • Push event handling
  • Notification click handling
  • Custom offline page with branding
  • Skip waiting and claim clients options
  • Service worker update notifications
  • Debug logging and error tracking

Installation Experience

  • Smart install prompts with customizable triggers:
    • Time on site threshold
    • Page views threshold
    • Scroll depth trigger
    • Exit intent detection
    • Custom event triggers
  • Customizable install banner design
  • Multi-language install prompts
  • Install tracking and analytics
  • Re-engagement prompts for declined installations
  • Platform-specific installation instructions
  • iOS Add to Home Screen guidance
  • Desktop installation support
  • Installation success celebrations

App Features

  • App shortcuts for quick actions
  • Share Target API for sharing content to your PWA
  • File handling API for opening files
  • Protocol handlers for custom URL schemes
  • Web Share API integration
  • Badge API for notification counts
  • Contact Picker API integration
  • Idle Detection API
  • Screen Wake Lock API
  • Vibration API for haptic feedback
  • Bluetooth connectivity (experimental)
  • USB device access (experimental)
  • NFC reading capabilities (experimental)

OneSignal Integration

Push Notifications

  • Complete OneSignal REST API integration
  • OneSignal Web SDK implementation
  • User subscription management
  • Notification templates library
  • Rich media notifications (images, videos, GIFs)
  • Action buttons (up to 4 per notification)
  • Custom notification sounds
  • Notification badges and icons
  • Large image support
  • Require interaction option
  • Silent notifications
  • Data-only messages
  • Time-to-live (TTL) settings
  • Notification priority levels
  • Collapse ID for message grouping
  • Android notification channels
  • iOS notification categories
  • Web push with Safari support
  • Notification delivery receipts
  • Delivery optimization

User Segmentation

  • Pre-built segment templates
  • Custom segment builder with visual interface
  • Segment by user properties:
    • Subscription date
    • Last session time
    • Session count
    • Location (country, region, city)
    • Language
    • Device type (mobile, tablet, desktop)
    • Operating system
    • Browser
    • WordPress user role
    • Membership level
    • Purchase history
    • Content consumption patterns
    • Custom tags
    • Custom data fields
  • Dynamic segments that auto-update
  • Segment size preview before sending
  • Segment analytics and insights
  • Segment export and import
  • Nested segment logic (AND/OR/NOT)
  • Lookalike audiences
  • Predictive segments using ML

Automated Messaging

  • Welcome message automation
  • Drip campaign builder
  • Behavioral trigger system:
    • Page visit triggers
    • Time-based triggers
    • Action-based triggers
    • Cart abandonment
    • Browse abandonment
    • Product back in stock
    • Price drop alerts
    • Content publication
    • Comment replies
    • User registration
    • Profile completion
    • Inactivity alerts
    • Re-engagement campaigns
    • Win-back campaigns
    • Milestone celebrations
  • RSS-to-Push automation
  • Scheduled message campaigns
  • Recurring message schedules
  • Time zone optimization
  • Intelligent timing (send time optimization)
  • Frequency capping
  • Message throttling
  • Do-not-disturb hours
  • Quiet time settings

Personalization

  • Dynamic content insertion
  • Personalization tokens:
    • First name, last name
    • Username
    • Email
    • Custom user fields
    • Recent activity
    • Product recommendations
    • Location-based content
    • Weather-based content
    • Time-based content
    • Device-specific content
  • Conditional content blocks
  • A/B/n testing (unlimited variants)
  • Multivariate testing
  • Automatic winner selection
  • Progressive rollout
  • Holdout groups for testing

In-App Messaging

  • Full-screen takeover messages
  • Modal dialogs
  • Slide-up banners
  • Corner notifications
  • Custom HTML messages
  • Image-only messages
  • Video messages
  • Carousel messages
  • Survey and poll messages
  • NPS score collection
  • Feedback forms
  • Rating prompts
  • Message targeting by page/post
  • Display frequency controls
  • Message scheduling
  • A/B testing for in-app messages

Email & SMS Integration

  • Unified messaging across channels
  • Email capture through prompts
  • SMS subscription management
  • Cross-channel campaigns
  • Message coordination
  • Channel preference management
  • Email templates
  • SMS templates
  • Transactional email support
  • Transactional SMS support

WordPress Integration

WooCommerce Integration

  • Order confirmation notifications
  • Shipping update alerts
  • Delivery notifications
  • Order status change alerts
  • Abandoned cart recovery with reminders
  • Browse abandonment campaigns
  • Price drop alerts for viewed products
  • Back in stock notifications
  • Low stock alerts for wishlisted items
  • Product recommendation notifications
  • Cross-sell and upsell campaigns
  • Review request automation
  • Loyalty program integration
  • Points expiration reminders
  • Coupon delivery notifications
  • Flash sale alerts
  • New product announcements
  • Category-specific promotions
  • Personalized product feeds

Easy Digital Downloads

  • Purchase confirmation
  • Download ready notifications
  • License renewal reminders
  • Software update alerts
  • Sale notifications
  • Bundle promotions
  • Subscription renewals

Membership Plugins

  • MemberPress integration
  • Restrict Content Pro support
  • Paid Memberships Pro compatibility
  • Member onboarding sequences
  • Membership expiration warnings
  • Renewal reminders
  • Upgrade promotions
  • Exclusive content alerts
  • Member-only event notifications
  • Access level changes
  • Payment failure alerts
  • Trial ending reminders

Learning Management Systems

  • LearnDash integration
  • LifterLMS support
  • Tutor LMS compatibility
  • Course enrollment confirmations
  • Lesson completion notifications
  • Quiz result alerts
  • Certificate earned celebrations
  • Assignment due reminders
  • Course progress updates
  • New course announcements
  • Drip content releases
  • Discussion forum replies
  • Instructor feedback notifications

Community & Social

  • BuddyPress integration
  • BuddyBoss platform support
  • bbPress forum notifications
  • wpForo compatibility
  • Friend request alerts
  • Private message notifications
  • Activity mention alerts
  • Group invitation notifications
  • Group activity updates
  • Forum post replies
  • Topic subscriptions
  • Reputation milestone notifications

Events & Bookings

  • The Events Calendar integration
  • Event Espresso support
  • Events Manager compatibility
  • Event reminder notifications
  • Ticket purchase confirmations
  • Event updates and changes
  • RSVP confirmations
  • Waitlist notifications
  • Check-in reminders
  • Post-event follow-ups
  • Upcoming event digests

Forms & Submissions

  • WPForms integration
  • Gravity Forms support
  • Contact Form 7 compatibility
  • Formidable Forms support
  • Ninja Forms integration
  • Form submission confirmations
  • Admin notification routing
  • Multi-step form progress
  • Abandoned form recovery
  • Form completion reminders

Content & SEO

  • Yoast SEO integration
  • Rank Math compatibility
  • All in One SEO support
  • New post publication alerts
  • Content update notifications
  • Comment reply notifications
  • Post approval notifications
  • Content recommendation engine
  • Trending content alerts
  • Personalized content feeds
  • Reading list updates
  • Bookmark notifications
  • Author follow system

Multilingual Support

  • WPML integration
  • Polylang compatibility
  • TranslatePress support
  • qTranslate-X integration
  • Language-specific notifications
  • Automatic language detection
  • Localized message templates
  • RTL language support
  • Character set handling

Analytics & Reporting

PWA Analytics

  • Installation tracking
  • Installation source attribution
  • Install prompt acceptance rate
  • Install prompt dismissal rate
  • Uninstall tracking
  • App launch tracking
  • Session duration in PWA mode
  • Feature usage analytics
  • Offline usage statistics
  • Cache hit/miss rates
  • Service worker performance metrics
  • Network request analytics
  • Storage usage tracking

Notification Analytics

  • Delivery metrics
  • Open rate tracking
  • Click-through rate analysis
  • Conversion tracking
  • Conversion attribution
  • Revenue attribution
  • Time to conversion
  • Notification influence
  • Click heatmaps
  • Action button performance
  • Unsubscribe tracking
  • Bounce tracking
  • Engagement scoring
  • Lifetime value analysis

User Analytics

  • User acquisition tracking
  • Subscriber growth rate
  • Retention rate analysis
  • Churn rate monitoring
  • Cohort analysis
  • User journey mapping
  • Funnel analysis
  • Path analysis
  • Session replay
  • User property tracking
  • Custom event tracking
  • Goal completion tracking
  • Segment performance comparison

Advanced Analytics

  • Real-time analytics dashboard
  • Custom report builder
  • Scheduled report delivery
  • Data export (CSV, JSON, XML)
  • API access to analytics data
  • Data warehouse integration
  • Google Analytics integration
  • Google Tag Manager support
  • Facebook Pixel integration
  • Custom dimension tracking
  • Attribution modeling
  • Multi-touch attribution
  • Incrementality testing
  • Revenue impact analysis

Performance & Optimization

Caching Strategies

  • Intelligent cache management
  • Resource prioritization
  • Critical CSS extraction
  • Above-the-fold optimization
  • Lazy loading for images
  • Lazy loading for iframes
  • Lazy loading for videos
  • Intersection Observer implementation
  • Prefetching strategies
  • Preloading critical resources
  • Preconnect to required origins
  • DNS prefetch optimization
  • Resource hints implementation

Asset Optimization

  • JavaScript minification
  • CSS minification
  • HTML minification
  • GZIP compression
  • Brotli compression
  • Image optimization
  • WebP conversion
  • AVIF support
  • Responsive images
  • Image lazy loading
  • Video optimization
  • Font optimization
  • Subset font loading
  • Icon font elimination
  • SVG optimization

Database Optimization

  • Query optimization
  • Database indexing
  • Transient cleanup
  • Auto-save cleanup
  • Revision management
  • Comment cleanup
  • Orphaned data removal
  • Database table optimization
  • Query caching
  • Object caching support

CDN Integration

  • Cloudflare integration
  • StackPath support
  • KeyCDN compatibility
  • BunnyCDN integration
  • Amazon CloudFront support
  • Custom CDN configuration
  • Asset URL rewriting
  • Cache purging
  • Geographic optimization

Loading Performance

  • Code splitting
  • Tree shaking
  • Dynamic imports
  • Module bundling
  • Critical path optimization
  • Render-blocking elimination
  • Parser-blocking reduction
  • Layout shift prevention
  • First Input Delay optimization
  • Time to Interactive improvement
  • Largest Contentful Paint optimization

Security Features

Authentication & Access

  • Two-factor authentication for admin
  • Role-based access control
  • IP whitelisting
  • IP blacklisting
  • Rate limiting
  • Brute force protection
  • Login attempt monitoring
  • Session management
  • Forced password resets
  • Password strength enforcement

Data Security

  • API key encryption
  • Secure credential storage
  • HTTPS enforcement
  • SSL/TLS verification
  • Content Security Policy headers
  • X-Frame-Options headers
  • X-Content-Type-Options headers
  • Referrer-Policy headers
  • Permissions-Policy headers
  • Feature-Policy implementation
  • Subresource Integrity (SRI)
  • CORS configuration
  • Secure cookie flags
  • HttpOnly cookies
  • SameSite cookie attributes

Privacy & Compliance

  • GDPR compliance toolkit
  • CCPA compliance features
  • Cookie consent integration
  • Privacy policy generator
  • Terms of service templates
  • Data processing agreements
  • User consent management
  • Consent logging
  • Double opt-in for subscriptions
  • Granular privacy controls
  • Data export functionality
  • Right to be forgotten
  • Data portability
  • Privacy by design
  • Data minimization
  • Purpose limitation
  • Storage limitation
  • Integrity and confidentiality

Spam & Abuse Prevention

  • CAPTCHA integration (reCAPTCHA v2/v3)
  • hCaptcha support
  • Turnstile integration
  • Honeypot fields
  • Time-based validation
  • Behavioral analysis
  • Comment moderation
  • User reporting system
  • Automated abuse detection
  • Subscription verification

Audit & Monitoring

  • Activity logging
  • Security event logging
  • Failed login tracking
  • Configuration change logs
  • User action auditing
  • API request logging
  • Error logging
  • Performance logging
  • Compliance audit trails
  • Log retention policies
  • Log export functionality

Developer Features

APIs & Webhooks

  • RESTful API
  • GraphQL API support
  • Webhook system:
    • User subscription events
    • Notification delivery events
    • Installation events
    • Uninstallation events
    • Campaign events
    • Custom event webhooks
  • OAuth authentication
  • JWT token support
  • API rate limiting
  • API versioning
  • API documentation (Swagger/OpenAPI)
  • Postman collection

WordPress Hooks & Filters

  • 200+ action hooks
  • 150+ filter hooks
  • Custom post type hooks
  • Taxonomy hooks
  • User hooks
  • Comment hooks
  • Admin hooks
  • Frontend hooks
  • AJAX hooks
  • Cron hooks
  • Plugin lifecycle hooks

Custom Development

  • JavaScript SDK
  • PHP SDK
  • Custom integration API
  • Template override system
  • Child theme support
  • Custom CSS injection
  • Custom JavaScript injection
  • Code snippets manager
  • Function library
  • Helper utilities
  • Debugging tools

CLI Commands

  • WP-CLI integration
  • Notification sending via CLI
  • User management commands
  • Cache management commands
  • Configuration import/export
  • Bulk operations
  • Automated testing commands
  • Deployment commands
  • Backup and restore
  • Migration utilities

Development Tools

  • Debug mode
  • Console logging
  • Error reporting
  • Performance profiling
  • Query monitoring
  • Cache debugging
  • Service worker debugging
  • Notification testing
  • Sandbox environment
  • Staging support
  • Version control integration
  • Code linting
  • Unit testing framework
  • Integration testing tools

Multisite Features

Network Administration

  • Centralized management dashboard
  • Network-wide settings
  • Site-level overrides
  • Bulk site configuration
  • Template site creation
  • Configuration inheritance
  • Network activation
  • Site-specific activation
  • Sub-site management

Multi-Network Support

  • Cross-network messaging
  • Shared user segments
  • Consolidated analytics
  • Network hierarchy management
  • Permission delegation
  • White-label configuration per network

White Label & Branding

Customization

  • Plugin rebranding
  • Custom plugin name
  • Custom author information
  • Custom support links
  • Custom documentation URLs
  • Logo replacement
  • Color scheme customization
  • Admin interface skinning
  • Email template branding
  • Notification branding
  • Loading screen customization

Client Management

  • Client portal access
  • Limited admin capabilities
  • Custom user roles
  • Branded reporting
  • Custom domains
  • Subdomain provisioning

Import & Export

Configuration Management

  • Settings export (JSON)
  • Settings import
  • Configuration templates
  • Bulk configuration
  • Environment migration
  • Staging to production sync
  • Configuration versioning
  • Rollback capability

Data Migration

  • User migration from other platforms
  • Notification history export
  • Analytics data export
  • Segment export
  • Campaign templates export
  • Cross-site migration tools

Internationalization

Translation Support

  • Translation-ready codebase
  • POT file generation
  • 50+ language translations included
  • RTL language support
  • Translation management interface
  • WPML integration
  • Polylang integration
  • GlotPress compatibility

Localization

  • Date and time formatting
  • Number formatting
  • Currency formatting
  • Timezone handling
  • Regional content adaptation

Content Features

Dynamic Content

  • Conditional content blocks
  • User-specific content
  • Location-based content
  • Weather-based content
  • Time-based content
  • Device-specific content
  • Content personalization engine
  • Dynamic product recommendations
  • Related content suggestions
  • Trending content identification

Content Scheduling

  • Message scheduling
  • Campaign calendar
  • Content expiration
  • Evergreen campaigns
  • Seasonal campaigns
  • Event-triggered content
  • Time zone optimization
  • Send time optimization

Monetization Features

Subscription Management

  • Subscription tier integration
  • Payment reminder notifications
  • Renewal reminders
  • Upgrade prompts
  • Downgrade prevention
  • Payment failure handling
  • Trial expiration alerts
  • Grace period management

Promotional Campaigns

  • Discount code distribution
  • Flash sale notifications
  • Limited-time offers
  • Bundle promotions
  • Upsell campaigns
  • Cross-sell campaigns
  • Cart recovery
  • Loyalty program integration

Affiliate & Referral

  • Referral tracking
  • Affiliate link integration
  • Commission tracking
  • Referral reward notifications
  • Milestone achievements
  • Leaderboard notifications

User Experience

Accessibility

  • WCAG 2.1 AA compliance
  • ARIA label support
  • Keyboard navigation
  • Screen reader compatibility
  • High contrast mode
  • Reduced motion support
  • Focus indicators
  • Skip links
  • Alt text management
  • Semantic HTML

Design & UI

  • Mobile-first design
  • Responsive layouts
  • Touch-friendly interfaces
  • Gesture support
  • Smooth animations
  • Loading states
  • Empty states
  • Error states
  • Success states
  • Dark mode support
  • Light mode support
  • Auto theme detection
  • Custom theme builder

Onboarding

  • Welcome wizard
  • Setup guide
  • Video tutorials
  • Interactive tooltips
  • Contextual help
  • Feature discovery
  • Progressive disclosure
  • Quick start templates
  • Sample configurations
  • Best practice recommendations

Advanced Features

Geolocation & Geofencing

  • Location tracking (with consent)
  • Geofence creation
  • Location-based notifications
  • Store proximity alerts
  • Event proximity alerts
  • Local weather integration
  • Regional content delivery
  • Distance calculation
  • Map integration

Machine Learning & AI

  • Predictive send time optimization
  • Churn prediction
  • Conversion prediction
  • Content recommendation engine
  • User interest modeling
  • Sentiment analysis
  • Natural language processing
  • Image recognition for content
  • Smart segmentation
  • Anomaly detection
  • Trend detection

Advanced Automation

  • Visual automation builder
  • Multi-step workflows
  • Conditional logic
  • Wait steps
  • Split testing in workflows
  • Goal tracking
  • Conversion attribution
  • Workflow templates
  • Workflow analytics
  • A/B testing within workflows

Enterprise Features

  • SLA guarantees
  • Priority support
  • Dedicated account manager
  • Custom development
  • Implementation services
  • Training programs
  • Certification programs
  • Partner program
  • Reseller program
  • Agency tools

Technical Requirements

System Requirements

  • WordPress 5.8 or higher
  • PHP 7.4 or higher (8.0+ recommended)
  • MySQL 5.7 or higher (8.0+ recommended)
  • HTTPS required for PWA functionality
  • Modern browser support (last 2 versions)

Server Requirements

  • Minimum 512MB RAM
  • 100MB free disk space
  • cURL support
  • JSON support
  • OpenSSL support
  • GD Library or ImageMagick
  • mod_rewrite enabled

OneSignal Account

  • OneSignal account (free or paid)
  • App ID
  • REST API Key
  • User Auth Key (for advanced features)

Installation

  1. Upload the plugin files to /wp-content/plugins/onesignal-pwa/
  2. Activate the plugin through the WordPress 'Plugins' screen
  3. Navigate to Settings → OneSignal PWA
  4. Follow the setup wizard to configure your PWA and OneSignal integration
  5. Test your PWA installation on a mobile device

Quick Start

Basic Setup

  1. Enter your OneSignal App ID and API keys
  2. Upload your app icon (minimum 512x512px)
  3. Configure your app name and colors
  4. Enable push notifications
  5. Publish your PWA

First Notification

  1. Go to OneSignal PWA → Send Notification
  2. Write your message title and content
  3. Select your audience or send to all subscribers
  4. Schedule or send immediately
  5. Track results in the analytics dashboard

Support & Documentation

Pricing

Free Tier

  • Basic PWA functionality
  • Up to 10,000 subscribers
  • 10,000 notifications per month
  • Standard support

Professional ($49/month)

  • Everything in Free
  • Unlimited subscribers
  • Unlimited notifications
  • Advanced segmentation
  • A/B testing
  • Priority support
  • No branding

Enterprise (Custom Pricing)

  • Everything in Professional
  • White label options
  • Multisite support
  • Custom development
  • Dedicated account manager
  • SLA guarantees
  • Training & certification

License

Proprietary License - Copyright © 2024 The Oxford Pierpont Corporation

Credits

Developed by: Oxford Pierpont
Company: The Oxford Pierpont Corporation
Website: https://oxfordpierpont.com

Built with WordPress standards and powered by OneSignal.

Changelog

Version 1.0.0

  • Initial release
  • Complete PWA implementation
  • Full OneSignal integration
  • Advanced features suite
  • WordPress ecosystem integration

About

Transform any WordPress website into a full-featured Progressive Web App (PWA) with comprehensive OneSignal push notification integration in minutes.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages