README

Meta (Facebook) Pixel integration for Bagisto — track visitors, measure conversions and supercharge your Meta Ads retargeting & optimization campaigns. 🚀

Built with ❤️ by Vfix Technology

✨ Features

✅ Zero-Code Setup — auto-discovered provider, just install and enable
🎛️ Easy Admin Configuration — enable, paste your Pixel ID, and you're done
📊 11 Tracked Events — 10 toggleable events + automatic PageView, full-funnel from product view to purchase
🔀 Server-Side + Client-Side Tracking — backend events for reliability, client-side capture for AJAX interactions
🎚️ Fine-Grained Event Control — toggle each of the 10 events on or off individually
🐛 Excellent Developer Experience — browser console logging utilities
🧪 3 Debug Behaviors — a single toggle combined with APP_DEBUG gives Debug Only, Track + Debug, or Track Only
⚡ Lightweight & Async — non-blocking snippet with no impact on storefront speed
🎨 Native Admin UI — Facebook Pixel card and icon inside Admin → Configure

📌 Tracked Events

🏷️ Event	📍 When?	📦 Additional Data
PageView	When a user visits any shop page	—
ViewContent	When a user views a product detail page	`content_ids`, `content_name`, `value`
AddToCart	When a user clicks Add to Cart or Buy Now	`product_id`, `quantity`, `value`
ViewCart	When a user opens the shopping cart page	`content_ids`, `contents`, `value`
InitiateCheckout	When a user opens the checkout page (incl. Buy Now)	`content_ids`, `contents`, `value`
AddShippingInfo	When a user fills the address and proceeds to shipping	`content_ids`, `contents`, `value`
AddPaymentInfo	When a user selects a payment method (COD, Razorpay, Cashfree, …)	`content_ids`, `contents`, `value`, `payment_method`
CompleteRegistration	When a user registers an account	—
SignIn	When a user signs in to the store	—
Lead	When a user subscribes to the newsletter	—
Purchase	When a user completes an order	`content_ids`, `contents`, `value`, `payment_method`, `eventID`

💡 PageView is tracked automatically whenever the Pixel is enabled. All other events are ON by default and can be toggled from the admin panel.

🚀 Requirements

Requirement	Version
🐘 PHP	`>= 8.3`
🛒 Bagisto	`2.3.x` / `2.4.x`
🧩 Composer	`>= 2.0`

📦 Installation

⚠️ Run all commands from the root directory of your Bagisto project.

composer require vfixtechnology/bagisto-facebook-pixel

🧩 After Install

composer dump-autoload
php artisan optimize:clear

🧠 No provider registration needed. The package declares its provider under extra.laravel.providers, and Bagisto runs Laravel's php artisan package:discover automatically after every composer install/update (via the post-autoload-dump script). Auto-discovery is enabled by default in stock Bagisto 2.3.x and 2.4.x.

⚙️ You only need to register it manually if your project has turned auto-discovery off — e.g. vfixtechnology/bagisto-facebook-pixel is listed under extra.laravel.dont-discover, "*" is used, or Composer was run with --no-scripts. In that case add this line to bootstrap/providers.php:
Vfixtechnology\FacebookPixel\Providers\FacebookPixelServiceProvider::class,

🛠️ Configuration

🧭 Go to Admin Panel → Configure → Facebook Pixel
🎛️ Settings
- Toggle Enable Facebook Pixel ➡️ ON
- Paste your Pixel ID (e.g. 123456789012345)
- (Optional) Enable Debug Mode for development
📊 Event Tracking
- PageView is always enabled automatically
- Toggle ViewContent, AddToCart, ViewCart, InitiateCheckout, AddShippingInfo, AddPaymentInfo, CompleteRegistration, SignIn, Lead, Purchase as needed
💾 Click Save

That's it! 🎉 Open any shop page and view the HTML source — you'll see:

<!-- Bagisto Facebook Pixel | Pixel ID: 123456789012345 -->

🐛 Debug Modes

Debugging is automatically selected based on APP_DEBUG (.env) and the Debug Mode toggle in the admin panel:

`APP_DEBUG` value	🔧 "Debug Mode" option	Active Mode	📣 Console Logging	📤 Sent to Facebook
Any	✅ ON	Debug Only	✅ Yes	❌ No
`true`	❌ OFF	Track and Debug	✅ Yes	✅ Yes
`false`	❌ OFF	Track Only (silent)	❌ No	✅ Yes

🧪 Debug Only — perfect for development. Logs everything to the browser console, sends nothing to Meta. Ideal for testing.
🏗️ Track and Debug — great for staging. Real data sent + console logs for verification.
🚀 Track Only — the production default. Clean, silent, performance-optimized.

⚙️ How It Works

The package is designed for maximum reliability — most activities are tracked from backend Laravel events and injected into the next rendered shop page, while AJAX-only interactions (Add to Cart, checkout steps) are captured client-side:

🏷️ Event	🧩 Trigger
ViewContent	Product detail page render
AddToCart	`checkout.cart.add.after` — AJAX button clicks handled client-side
ViewCart	Cart page render
InitiateCheckout	Checkout page render (`Buy Now` landing)
AddShippingInfo	Checkout address step submit
AddPaymentInfo	Checkout payment method selection
CompleteRegistration	`customer.registration.after`
SignIn	`customer.after.login`
Lead	`customer.subscription.after`
Purchase	`checkout.order.save.after`

🗂️ Package Structure

packages/Vfixtechnology/FacebookPixel/
├── composer.json
└── src/
    ├── Config/system.php              # Admin config (Settings + Event Tracking)
    ├── FacebookPixel.php              # Core helper
    ├── Http/helpers.php               # facebook_pixel() helper
    ├── Listeners/                     # Backend event listeners
    ├── Providers/                     # Service + Event providers
    └── Resources/views/               # Pixel head snippet, ViewContent script, credit

🤝 Support

Need help? We're just one message away! 💬

📧	Email	info@vfixtechnology.com
📞	Phone	+91 8447 525 204
💬	WhatsApp	Chat with us

💬 Clicking the WhatsApp link pre-fills this message: "I found you from GitHub. Need help in installing Facebook Pixel extension for Bagisto."

We usually reply within 24 hours ⏰.

💼 Customization & Paid Installation

🛠️ Contact us for customization or paid installation support. We can tailor the extension to your business (extra events, custom params, server-side Conversions API) or install and configure it for you end-to-end.

📧 info@vfixtechnology.com · 💬 WhatsApp

📄 License

MIT — free to use, modify and distribute. See the LICENSE file.

Made with ❤️ by Vfix Technology — Laravel & Bagisto development experts.

vfixtechnology / bagisto-facebook-pixel

Package info

Security

Statistics