Download the PHP package onetracepro/onetrace-bitrix without Composer
On this page you can find all versions of the php package onetracepro/onetrace-bitrix. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download onetracepro/onetrace-bitrix
More information about onetracepro/onetrace-bitrix
Files in onetracepro/onetrace-bitrix
Package onetrace-bitrix
Short Description 1C-Bitrix module for the OneTrace.pro customer data platform: server-side orders, customers and consents, the website tracker, product catalog sync, recommendation widgets and Web Push.
License MIT
Homepage https://onetrace.pro
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package onetrace-bitrix
OneTrace.pro for 1C-Bitrix
Connects a 1C-Bitrix "Site management" store to OneTrace.pro, the customer data platform: orders, customers and newsletter consents from the server, the website tracker, product views, the product catalog, recommendation widgets and Web Push. Abandoned cart, browse abandonment, post-purchase and win-back journeys, product recommendations and predictions work right after you connect the store.
Русская версия
- 1C-Bitrix "Site management" with the modules "Online store" and "Commercial catalog" (editions "Small business" and higher), PHP 8.2–8.5, UTF-8
- Orders and their statuses are sent from the server through a queue with retries (an agent every minute): the checkout never waits for the platform
- Settings per site: each site can send to its own project
- The same events and properties as every OneTrace shop plugin (e-commerce contract), built on onetrace-php, bundled inside the module
What it sends
| Data | When | How |
|---|---|---|
identify — email, phone, name, city, country, language |
registration, login, profile changes, every order | server, secret key |
| Newsletter consent | subscribing and unsubscribing in the module "Email marketing"; a Yes/No order property of the checkout | server, with identify |
order_completed |
the order is placed (any checkout, the admin, the API) | server |
order_paid, order_refunded, order_cancelled |
the order becomes paid, a payment is returned, the order is cancelled | server, once per order event |
add_to_cart, remove_from_cart, checkout_started |
cart changes and the checkout page (sale.order.ajax), for visitors with the tracker cookie or signed in | server |
product_viewed |
the product page: the view counter of the standard catalog.element templates | server, works with the composite cache |
| Page views | the storefront | browser tracker |
| Product catalog | product, price and stock changes, daily, and the "Upload the whole catalog" button | server, products.write |
search |
the first page of the catalog search results, with "Product search" on | server |
Every Bitrix order has a user (the guest checkout registers one), so orders, the cart and the account land in one profile; the browser of the checkout is saved with the order, so its later events (payment, refund) use it too.
Installation
- Download
onetrace.connector.zipfrom the latest release and unpack it into/local/modules/(the folderonetrace.connector). - Marketplace → Installed solutions: install "OneTrace — customer data platform".
- In your OneTrace project, open API keys and create a write key (for the storefront) and a secret key with the
products.writepermission (for the server). - Settings → Product settings → Module settings → OneTrace: on the tab of each site enter the platform address (the domain you open OneTrace at) and both keys, click Test connection.
- Run agents on cron (
agents_use_crontab), otherwise the queue waits for visitors' hits.
Catalog
The catalog is made of the products of the commercial catalog infoblocks bound to the site. Trade offers are not separate products: an offer uploads its parent, and a product with offers takes the lowest offer price. The price is what a guest pays with discounts; the old price — the price before discounts. Categories are the element sections with their parents; the brand — the property BRAND, BRAND_REF or MANUFACTURER; attributes — the properties of the smart filter.
Product search
Turn on Product search in the settings (the plan of the project must include it) and replace the component in the search page of the catalog — in the template of the complex component bitrix:catalog it is search.php:
- The parameters stay the same. The products, their order and their number come from OneTrace — word forms, typos, a query typed in the wrong keyboard layout, the visitor's interests — and are shown by
catalog.sectionof your store. Sorting by price goes to the platform. - A query with a redirect rule (Site → Search of the platform, e.g. "delivery" → the delivery page) opens the rule's page.
- The search fields of the store (
search.titleand forms withq) show suggestions of the tracker while typing instead of the title search popup. - Any error of the platform keeps
bitrix:catalog.search.
Languages of the catalog
The catalog of a project comes from its first site. Other sites connected to the same project (the same address and secret key) with another language have their own copies of the catalog — as the exchange with 1C makes them — and the products and sections with the same XML_ID add translations: names, links on that site and the values of the attributes. The platform shows recommendations, widgets, search results and emails in the visitor's language.
Recommendations and Web Push
- Widgets from Site → Widgets of the platform: place the component OneTrace recommendations (
onetrace:recommendations) in the product page, the cart or any page and set the widget id; pass the product ids of the page (ITEMS) and the section (CATEGORY) where the widget type needs them. - Web Push: turn it on in the settings — the module serves
/cdp-sw.jsfrom the site root (a rule ofurlrewrite.php).
Privacy
- Consents come from the store's own subscriptions; a checkout checkbox counts when you set its order property code in the settings.
- Logout forgets the tracker visitor of the browser, so the next person at this computer starts a new profile.
- Data already sent stays in the OneTrace project; delete profiles there (GDPR).
Development
The tests download the trial distribution of "Small business" (the latest version), pass the installation wizard without a browser (tests/env/wizard.py, adapted from BitrixBox, MIT) and install the module from the working copy: orders go through the sale API (basket, shipment, payment), subscriptions through the "Email marketing" module.
License
MIT
