inPIPE by Seresa

inPIPE by Seresa allows you to generate, store, and manage UTM parameters—both plain and coded. The plugin automatically decodes coded UTM query strings when visitors land on your website, pushing the full UTM data to the dataLayer. This helps bypass ad blockers and improves tracking in Google Analytics, Facebook Ads, and other platforms.

• Generate & manage UTM query strings with ease
• Supports both plain and coded UTM parameters
• Decodes coded UTM links on-site and sends data to the dataLayer
• Reduces tracking disruptions caused by ad blockers
• Works with GA4, GTM, Facebook Ads & more

Use WP inPIPE for more reliable UTM tracking and better data collection!

Features

• Generate and store UTM query string URLs based on user input
• Encode UTM parameters to enhance tracking accuracy
• Decode UTM query strings on site visits and push the original UTM data to the dataLayer
• Potentially bypass ad blockers to ensure accurate data collection

Configuration

• Navigate to Admin Dashboard > inPIPE to manage plugin settings.
• Enable automatic UTM processing in the settings panel.
• Use the UTM Coder to create, edit, or delete UTM query strings.

External Services

This plugin connects to external services hosted by Seresa.io for the following purposes:

Subscription Verification & Premium Package Downloads
– Service: The plugin uses the API at [https://sub.seresa.app] to verify premium subscriptions and to download premium packages or updates.
– When:
– Subscription verification occurs when you attempt to access premium features or validate your license.
– Package downloads occur when you install or update premium components from within the plugin.
– Data Sent:
– The plugin sends your license key, site URL, and (if applicable) the requested package identifier to the API.
– Purpose:
– To verify your entitlement to premium features and to deliver premium package files securely.
– Terms of Service: [https://seresa.io/terms]
– Privacy Policy: [https://seresa.io/privacy]

Other Hosted Services
– See below for additional premium features that may rely on external event processing (e.g., Transmute Engine).

1. Subscription Verification

   • What: The plugin connects to https://sub.seresa.app/premium-downloader/v1/verify-subscription to validate subscription codes
   • When: This occurs only when a user enters a subscription code in the admin panel to activate premium features
   • Data sent: Subscription code entered by the user, site URL, and WordPress version
   • Purpose: To verify the validity of subscription purchases and enable premium features
   • Provider: Seresa.io – Terms of Service and Privacy Policy

2. Package Installation

   • What: The plugin connects to https://sub.seresa.app/premium-downloader/v1/download to download premium components
   • When: This occurs only after subscription verification when the user initiates the installation of premium features
   • Data sent: Verified subscription code, site URL, WordPress version, and PHP version
   • Purpose: To securely download and install authorized premium components
   • Provider: Seresa.io – Terms of Service and Privacy Policy

3. Transmute Engine (Premium Feature)

   • What: Premium users’ event data is processed through Transmute Engine, a server-side event processing service
   • When: When events are triggered on your website (page views, clicks, form submissions, etc.)
   • Data sent: Event data, UTM parameters, and tracking information
   • Purpose: To process and route event data to your configured third-party services
   • How it works: Transmute Engine acts as a first-party server to your website, temporarily processing data without permanent storage, and forwarding it to your specified endpoints
   • Provider: Seresa.io – Terms of Service and Privacy Policy

No data is shared with third parties beyond Seresa.io, and all connections use secure HTTPS encryption. Users can choose not to use premium features, in which case no external connections will be made.

Third-Party Libraries

This plugin uses the following third-party libraries:

1. Vue.js

   • What: A progressive JavaScript framework for building user interfaces
   • Website: https://vuejs.org/
   • License: MIT License – https://github.com/vuejs/vue/blob/main/LICENSE

2. Vue Toastification

   • What: Toast notification library for Vue.js
   • Website: https://github.com/Maronato/vue-toastification
   • License: MIT License

3. Lucide Icons

   • What: Beautiful & consistent icon toolkit for Vue.js
   • Website: https://lucide.dev/
   • License: ISC License – https://github.com/lucide-icons/lucide/blob/main/LICENSE

4. Axios

   • What: Promise-based HTTP client for JavaScript
   • Website: https://axios-http.com/
   • License: MIT License

5. Pinia

   • What: State management library for Vue.js
   • Website: https://pinia.vuejs.org/
   • License: MIT License

6. Vue I18n

   • What: Internationalization plugin for Vue.js
   • Website: https://vue-i18n.intlify.dev/
   • License: MIT License

7. Tailwind CSS

   • What: Utility-first CSS framework
   • Website: https://tailwindcss.com/
   • License: MIT License

8. WordPress JavaScript Libraries

   • What: Official WordPress JavaScript libraries (@wordpress/api-fetch, @wordpress/components, @wordpress/element, @wordpress/i18n)
   • Website: https://developer.wordpress.org/block-editor/reference-guides/packages/
   • License: GPL-2.0+ License

All third-party libraries used are compatible with the GPL-2.0+ license of this plugin.

Build Tools and Source Code Access

This plugin uses modern frontend tools (Vue.js, Vite, Axios) to build its admin interface. The full, human-readable source code is included directly within the plugin package under the /src directory.

Included source code:
• /src/ contains all original Vue 3 components, Pinia store, and JavaScript modules
• /dist/ contains the compiled production build
• /src/README.md contains full build instructions and configuration references

Build Toolchain:
• Vue.js 3
• Vite
• Tailwind CSS
• PostCSS
• Vitest
• Grunt

To rebuild the admin interface from source:
1. Navigate to the /src directory
2. Run npm install
3. Run npm run build:free or npm run build:premium to compile assets to /dist

This ensures full compliance with WordPress.org’s guidelines requiring human-readable source code for all minified or bundled assets.

For detailed developer instructions, see /src/README.md.

License

This plugin is licensed under the GNU General Public License v2.0 or later.
For more details, visit: https://www.gnu.org/licenses/gpl-2.0.html

Support

For free users: Report issues on our GitHub page:
🔗 GitHub Issues

For general inquiries, contact us at [email protected].

For premium users: Get priority support at 🔗 seresa.io/support.

1. Upload the plugin folder to your WordPress plugin directory (wp-content/plugins/).
2. Activate the plugin through the Plugins > Installed Plugins menu in WordPress.

Can I use this plugin just to generate UTM parameter query strings?

Yes! The plugin allows you to easily generate UTM parameter query strings for your marketing campaigns. You can create both plain and coded UTM query strings with simple click options. If you only need to generate and use UTM parameters without decoding, you can do so without enabling the decoding feature.

Can I use plain UTM parameters instead of coded ones?

Yes! The plugin supports both plain and coded UTM parameters. If you don’t enable decoding, your standard UTM parameters will work as usual. If you want extra protection against ad blockers, you can enable decoding in the plugin settings.

How do I enable coded UTM decoding?

Go to Settings > WP inPIPE and turn on the option for Coded UTM Processing. When enabled, the plugin will detect and decode coded UTM query strings, replacing them with the full UTM parameters in the URL bar and pushing them to the dataLayer.

How does this help with Google Tag Manager (GTM)?

By pushing decoded UTM parameters directly into the dataLayer, Web GTM can receive the data without requiring extra configurations to extract and manage UTM values. This simplifies tracking setup and ensures cleaner data in your analytics.

1.0.3 – 2025-12-01

CRITICAL Uninstall Fix + Security Improvements + UI Fixes

BUG FIXES

• Fixed Subscription Code Whitespace: Subscription codes with leading/trailing spaces now validate correctly
  • Added trim() to subscription code input before validation and API submission
  • Prevents “Invalid subscription code format” error when users paste codes with extra whitespace

UI ENHANCEMENTS

• Mobile Responsive Buttons: Fixed upgrade buttons in Settings component for mobile view
  • Buttons now stack vertically and take full width on screens 768px and below

CRITICAL BUG FIX

• Fixed Uninstall Table Removal: Resolved critical bug where plugin tables without wp_ prefix were not being removed during uninstallation
  • The Issue: Tables like inpipe_premium_test (without wp_ prefix) were not being deleted
  • Root Cause: Code was incorrectly stripping and re-adding the WordPress prefix to ALL table names
  • The Fix: Now uses full table names directly from database without prefix manipulation
  • Impact: All inpipe tables are now properly removed, regardless of prefix pattern
  • Tested: Verified working with wp_inpipe_*, inpipe_*, and inpipe patterns in Docker WordPress environment

SECURITY ENHANCEMENTS

• Added SQL Injection Protection: Implemented multi-layer security for table DROP operations
  • Layer 1: Regex validation (alphanumeric + underscore only)
  • Layer 2: Must contain ‘inpipe’ string
  • Layer 3: esc_sql() sanitization before query
  • Layer 4: Tables only from trusted SHOW TABLES source
  • Layer 5: Verification with prepared statements
  • Result: All 12 security validation tests passed

TABLES NOW PROPERLY REMOVED

• wp_inpipe_* (standard FREE tables)
• wp_inpipe_premium_* (PREMIUM with wp_ prefix)
• inpipe_premium_* (PREMIUM without wp_ prefix) – NOW FIXED!
• inpipe (backup/custom tables)
• All variations (mixed case, numbers, various prefixes)

DOCUMENTATION

• Updated File Headers: Added @since 1.0.3 documentation to uninstall.php
• Added Test Results: Comprehensive Docker test results documented
• Added Security Summary: Full security validation documentation

1.0.3 (Previous) – 2025-11-27

UI Improvements, Component Enhancements & Subscription API Fix

BUG FIXES

• Fixed Subscription Data Mapping: Corrected API response field mapping in subscription verification process
  • subscription_type now correctly reads from metadata_plan_name (e.g., “Trial”, “Pro”, “Business”)
  • plan_type now correctly reads from plan field (e.g., “Monthly”, “Yearly”)

UI ENHANCEMENTS

• Enhanced Loading Spinner: Added professional loading spinner with smooth animation for Vue admin app loading state
• Improved Loading Container: Better styled loading container with centered layout and visual feedback
• Button Disabled States: Added proper disabled button styling with visual feedback for better UX

COMPONENT UPDATES

• Base Button Component: Added loading spinner animation and disabled state styling
• Vue Admin Controller: Enhanced render_admin_app with inline CSS for loading states
• Settings Component: UI cleanups and improved layout
• Subscription Component: Streamlined interface and better visual hierarchy
• Translation Updates: Enhanced Vue translations for better internationalization

TECHNICAL

• Merged upstream changes with local improvements
• Resolved merge conflicts in Vue admin and button components
• Updated doc blocks with @since 1.0.3 tags

1.0.2 – 2025-11-20

Bug Fixes, Uninstall Improvements & UI Updates

BUG FIXES

• Fixed Premium Upgrade File Issue: Resolved file handling error during premium package installation and upgrade process
• Fixed Incomplete Uninstall After Failed Premium Upgrade: Plugin now properly removes ALL database tables with inpipe_ prefix during uninstall, preventing orphaned premium tables from breaking WordPress admin after failed upgrades
• Fixed Auto-Refresh After Premium Upgrade: Replaced deprecated window.location.reload(true) with cache-busting URL approach to ensure premium features display immediately after upgrade without requiring manual hard refresh

UI & MESSAGING UPDATES

• Updated Upgrade Messaging: Changed all “Upgrade to Premium” messaging to promote “Premium Transmute Engine™ service for WordPress”
• Enhanced Service Description: Added detailed messaging about seamlessly sending event data to multiple endpoints (GA4, Google Ads, Facebook Ads, Klaviyo, Big Query) processed server-side
• Updated Call-to-Action Buttons: Changed upgrade CTAs to “Learn More” and “Free Trial” buttons with new URLs pointing to Transmute Engine pages
• Improved Link Structure: Made “Get a free trial today” a clickable link in settings component
• Terminology Updates: Changed all references from “endPIPEs” to “outPIPEs” throughout the interface
• Removed Premium Feature Cards: Streamlined subscription component by removing individual feature cards in favor of focused upgrade messaging
• Updated Support URLs: Changed documentation and support links to point to support.seresa.io and Seresa YouTube channel
• Consistent Header Sizing: Standardized header sizes across Settings and Subscription components for better visual hierarchy
• Optimized Button Layout: Compressed upgrade buttons to left-aligned layout for better visual flow
• Refined Description Styling: Adjusted upgrade description text sizing for better readability

IMPROVEMENTS

• Simplified Uninstall Logic: Removed complex conditional cleanup logic – uninstall now unconditionally removes ALL tables starting with inpipe_ prefix regardless of detection state
• Enhanced Cleanup Reliability: Uninstall process no longer relies on premium detection; uses pure prefix-based table discovery to ensure complete cleanup in all scenarios
• Improved WordPress Core Options Cleanup: Automatically removes inPIPE references from WordPress core options (uninstall_plugins, recently_activated, cron, _site_transient_update_plugins) during uninstallation
• Modern Browser Compatibility: Updated page reload mechanism to work reliably across all modern browsers by using timestamp-based cache-busting instead of deprecated reload methods
• Enhanced Premium Integration: Improved premium loader functionality and status manager for better premium feature detection and handling
• Improved Vue Admin Interface: Enhanced Vue admin component with improved caching, settings management, and connection handling
• Enhanced Form Components: Significantly improved base input component with 200+ lines of new functionality for better user input handling and validation
• Updated Translation System: Refined Vue translations for better internationalization support with new Transmute Engine™ messaging
• API Endpoint Refinements: Improved API endpoint handling and initialization for more reliable premium integration
• Button Component Enhancement: Added new functionality to base button component for improved user interactions
• Settings Component Updates: Enhanced settings component with improved configuration handling and upgrade messaging

TECHNICAL ENHANCEMENTS

• Updated 10 core files including API endpoints, status manager, Vue admin controller, and Vue components
• Added 374 new lines of functionality with 71 lines of optimization
• Improved premium loader class implementation
• Enhanced API initialization logic

1.0.1 – 2025-07-17

Major Enhancement: Unified Premium Detection System

NEW FEATURES

• Status Manager Integration: Implemented centralized premium detection system for consistent plugin behavior
• Enhanced Uninstall Safety: Added intelligent premium detection during uninstallation with robust fallback mechanisms
• Improved API Reliability: Unified premium detection across all API endpoints and initialization

IMPROVEMENTS

• Premium Detection Consolidation: Replaced 13+ scattered premium detection points with single unified system
  • API Endpoints Free: 5 detection points → 1 unified Status Manager call (80% complexity reduction)
  • API Initialization: 3 detection points → unified premium detection
  • Smart Uninstaller: Enhanced with Status Manager integration plus 4 robust fallback methods
• Enhanced Error Handling: Added comprehensive safety checks and graceful degradation across all components
• Debug Logging: Improved debugging capabilities with detailed Status Manager integration logging
• Code Maintainability: Centralized premium logic reduces maintenance overhead and improves consistency

TECHNICAL ENHANCEMENTS

• API Endpoints: Updated handle_subscription_webhook(), handle_premium_integration(), handle_premium_install(), and handle_premium_install_status() methods with unified premium detection
• Backup System: Enhanced backup creation and restoration with Status Manager integration
• Uninstall Process: Added is_uninstall_context_safe() method for secure Status Manager usage during plugin removal
• WordPress Standards: Maintained full compliance with WordPress coding standards and best practices

SECURITY & RELIABILITY

• Uninstall Context Safety: Added pre-flight checks before Status Manager usage during uninstallation
• Database Validation: Enhanced database connection verification and WordPress function availability checks
• Graceful Degradation: Improved fallback mechanisms when Status Manager unavailable
• Exception Handling: Comprehensive error handling prevents fatal errors during premium detection

COMPATIBILITY

• Backward Compatibility: All existing functionality preserved with zero breaking changes
• WordPress Core: Fully compatible with WordPress 5.0+ requirements
• PHP Compatibility: Maintains PHP 7.4+ compatibility with improved error handling
• Performance: Enhanced premium detection with minimal performance overhead

DEVELOPER NOTES

• Class Documentation: Updated DocBlocks with @since 1.0.1 tags for all modified methods
• API Preservation: 100% API functionality maintained – all endpoints continue to work identically
• Hook Integration: All WordPress action and filter hooks preserved without modifications
• Debug Support: Enhanced debugging capabilities for troubleshooting premium detection issues

FILES UPDATED

• uninstall.php – Stripped constructor and 4 internal methods: smart uninstaller setup and safety validation
• inpipe-by-seresa.php – Removed 15 init, activation, component loading, and logging functions
• includes/core/class-inpipe-vue-admin.php – Stripped Vue admin controller constructor and 4 methods for cached settings and connections
• includes/core/class-inpipe-status-manager.php – Removed 21 premium detection, validation, and mode management methods
• includes/core/class-inpipe-settings-manager.php – Stripped constructor and load_settings logic
• includes/core/class-inpipe-feature-manager.php – Stripped InPipe_Feature_Manager core feature loader
• includes/free/premium-upgrade/class-inpipe-simple-subscription-verifier.php – Removed verify_with_server
• includes/free/premium-upgrade/class-inpipe-premium-integrator.php – Removed integrate_package and rollback_integration
• includes/free/premium-upgrade/class-inpipe-package-installer.php – Stripped 6 installer and package handling methods
• includes/free/premium-upgrade/class-inpipe-backup-manager.php – Stripped constructor and ensure_wp_constants
• includes/core/api/inpipe-api-init.php – Stripped inpipe_init_api_endpoints
• includes/core/api/class-inpipe-api-endpoints-free.php – Stripped 8 methods covering public UTM validation, premium integration, webhook handling, backup, and install status

UPGRADE NOTES

• Automatic Enhancement: Existing installations automatically benefit from improved premium detection
• No Configuration Required: Changes are transparent to end users
• Plugin Stability: Enhanced reliability for both free and premium installations
• Debugging Improvements: Better error reporting and diagnostic capabilities

1.0.0 – 2025-07-07

• Initial release.