PHPackages                             bluebirdday/speedcurve-magento - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. bluebirdday/speedcurve-magento

ActiveMagento2-module

bluebirdday/speedcurve-magento
==============================

Integrates SpeedCurve RUM for Magento 2.

1.0.(1y ago)5837↓100%1GPL-3.0JavaScriptPHP ^8.1|^8.2|^8.3

Since May 6Pushed 1y ago1 watchersCompare

[ Source](https://github.com/bluebirdday/speedcurve-magento)[ Packagist](https://packagist.org/packages/bluebirdday/speedcurve-magento)[ RSS](/packages/bluebirdday-speedcurve-magento/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (2)Used By (0)

Bluebirdday Speedcurve Magento 2 Module
=======================================

[](#bluebirdday-speedcurve-magento-2-module)

Overview
--------

[](#overview)

This Magento 2 module integrates the Speedcurve Real User Monitoring (RUM) service, specifically the LUX script, into your Magento store. It is designed for standard Magento 2 frontend themes (Luma-based or custom themes using Layout XML, RequireJS, etc.).

The module allows you to:

- Automatically inject the Speedcurve LUX JavaScript snippet onto your pages.
- Send specific page labels to Speedcurve for better analysis (e.g., 'category-page' for category views, 'product-page' for product views).
- Configure all settings via the Magento Admin Panel, including LUX ID, page labels, and cookie consent handling.

Features
--------

[](#features)

- **Speedcurve RUM Integration:** Injects the necessary Speedcurve LUX JavaScript.
- **Configurable LUX ID:** Set your unique Speedcurve LUX ID via admin configuration.
- **Configurable Page Labels:** Define custom labels sent to Speedcurve for category and product pages via admin configuration (defaults provided).
- **Standard Magento Compatibility:** Uses Layout XML, Blocks, phtml templates, RequireJS, and jQuery for integration.
- **Flexible Cookie Consent:**
    - Option to enable/disable cookie consent check.
    - Configure the specific cookie name used by your consent manager.
    - Configure the value (or part of a value) within the cookie that signifies consent.
    - Choose the logic for checking the cookie (existence, value contains, value does not contain).

[![Speedcurve Config Example](./docs/SpeedcurveConfig.png)](./docs/SpeedcurveConfig.png)

Requirements
------------

[](#requirements)

- Magento 2 (e.g., 2.3.x, 2.4.x)
- Standard Magento 2 Theme (Luma-based or custom using default frontend stack)

Installation
------------

[](#installation)

Install the module via Composer:

```
composer require bluebirdday/speedcurve-magento
bin/magento module:enable Bluebirdday_SpeedcurveMagento
bin/magento setup:upgrade
bin/magento cache:flush
```

For production environments, run the following additional commands:

```
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
```

Configuration
-------------

[](#configuration)

After installation, configure the module in the Magento Admin Panel:

1. Go to **Stores > Configuration > Bluebirdday > Speedcurve**.
2. **General Settings:**
    - **Enable Speedcurve RUM:** Yes/No - Master switch for the module.
    - **LUX ID:** Enter your unique ID provided by Speedcurve. **Required** if enabled.
    - **Enable Cookie Consent Check:** Yes/No - Choose whether to check for consent before loading the script.
    - **Consent Cookie Name:** (Only if consent check enabled) The name of the cookie your consent tool uses (e.g., `CookieConsent`, `amcookie_allowed`). **Required** if consent check enabled.
    - **Consent Cookie Value:** (Only if consent check enabled) The text value (or part of it) inside the cookie that indicates consent (e.g., `performance`, `necessary:true`, `-1`). Leave empty if checking only for cookie existence with the 'Cookie Exists' logic.
    - **Consent Check Logic:** (Only if consent check enabled) How to interpret the cookie:
        - `Cookie Exists`: Loads script if the cookie name exists. Ignores value.
        - `Value Contains`: Loads script if the cookie name exists AND its value contains the text in "Consent Cookie Value". If the value field is empty, this behaves like `Cookie Exists`.
        - `Value Does Not Contain`: Loads script if the cookie name exists AND its value does NOT contain the text in "Consent Cookie Value". If the value field is empty, this check will always fail.
3. **Page Labels:**
    - **Category Page Label:** The label sent on category pages (default: `category-page`).
    - **Product Page Label:** The label sent on product detail pages (default: `product-page`).
4. Save the configuration.

Usage
-----

[](#usage)

Once installed, enabled, and configured with your LUX ID (and potentially cookie consent settings), the module works automatically:

- The layout XML (`default.xml`, `catalog_category_view.xml`, `catalog_product_view.xml`) adds blocks to the page.
- These blocks render phtml templates containing `text/x-magento-init` scripts.
- These scripts initialize the RequireJS modules (`bluebirddaySpeedcurveRum` and `bluebirddaySpeedcurvePageLabel`).
- `bluebirddaySpeedcurveRum.js` checks cookie consent (if configured) and injects the Speedcurve LUX scripts.
- `bluebirddaySpeedcurvePageLabel.js` waits for the main script to load (using a jQuery event `SpeedcurveLoaded`) and then sets the configured `LUX.label`.

You can monitor your Speedcurve RUM dashboard to see data coming in, including the page labels.

License
-------

[](#license)

GNU General Public License v3.0

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see .

Copyright (C) 2024 Bluebird Day

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance49

Moderate activity, may be stable

Popularity23

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 83.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

372d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/38124567?v=4)[Bluebird Day](/maintainers/Bluebirdday)[@bluebirdday](https://github.com/bluebirdday)

---

Top Contributors

[![jesperingels-bbd](https://avatars.githubusercontent.com/u/165291918?v=4)](https://github.com/jesperingels-bbd "jesperingels-bbd (5 commits)")[![jesperingels](https://avatars.githubusercontent.com/u/39624711?v=4)](https://github.com/jesperingels "jesperingels (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bluebirdday-speedcurve-magento/health.svg)

```
[![Health](https://phpackages.com/badges/bluebirdday-speedcurve-magento/health.svg)](https://phpackages.com/packages/bluebirdday-speedcurve-magento)
```

###  Alternatives

[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8044.5M33](/packages/smile-elasticsuite)[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.2M1](/packages/fastly-magento2)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50374.2k18](/packages/dotdigital-dotdigital-magento2-extension)[swissup/module-search-mysql-legacy

Legacy mysql search for magento 2.4

10483.0k](/packages/swissup-module-search-mysql-legacy)[fredden/magento2-module-javascript-error-reporting

A Magento 2 module which captures JavaScript errors for later review by website administrators

3138.1k](/packages/fredden-magento2-module-javascript-error-reporting)[mage-os/module-inventory-reservations-grid

Add a grid with the list of inventory reservations.

126.8k](/packages/mage-os-module-inventory-reservations-grid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)