Download the PHP package kustomer/kustomer-integration without Composer
On this page you can find all versions of the php package kustomer/kustomer-integration. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kustomer/kustomer-integration
More information about kustomer/kustomer-integration
Files in kustomer/kustomer-integration
Package kustomer-integration
Short Description Integrate Magento eCommerce site with Kustomer service
License OSL-3.0 AFL-3.0
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 kustomer-integration
Kustomer Extension for Adobe Commerce 2.x
This extension allows publication of Adobe Commerce events to Kustomer. It provides a KustomerEventObserver class that you can extend to publish events to your Kustomer account.
Installation
$ composer require kustomer/kustomer-integrationfrom your Adobe Commerce project root$ bin/magento module:enable Kustomer_KustomerIntegration --clear-static-content$ bin/magento setup:upgrade$ bin/magento setup:di:compile
Notes
Packagist
If you are using the default adobe commerce metapackage, you will need to add the packagist repo to your store's composer.json:
Find more detailed instructions here
Cron
The extension makes use of a cron job to collect events and send them to Kustomer and thus requires cron to be installed on the Adobe Commerce server.
You can check if the cron was installed correctly with crontab -l. If the cron does not show up, run bin/magento cron:install in your Adobe Commerce dir. This command is available with Adobe Commerce 2.2.
Setup
Use of this extension requires an active Kustomer subscription. More information about Kustomer can be found on our website.
Before you can start sending data to Kustomer, you must install the Adobe Commerce app in your Kustomer account. You can do this by logging into the Kustomer app then go to Settings>>App Directory and click Install for Adobe Commerce.
Once Adobe Commerce is enabled on your Kustomer account, you need to create an API key so your Adobe Commerce store can send data to Kustomer. In the Kustomer app, go to Settings>>API Keys. Create a key here with the role org.user and keep a copy of the key handy. You will need it.
Next, go to your Adobe Commerce store's admin site and navigate to Store>>Configuration>>Customers>>Kustomer (if the Kustomer option is not available, see the installation instructions above). Select the store/website you want to integrate with Kustomer (or stay in the default scope if you want to use the integration globally). Enter the API key you generated in Kustomer into the API Key box and make sure the Enabled option is set to Yes. Next, select any of the default events you want to broadcast to Kustomer (such as when a new Customer is created) and click Save. You should be all set!
Pausing the Extension
If you want to stop sending data to Kustomer, you can turn off the extension at any time by returning to the settings page and setting the Enabled value to No. Note that any data collected while the extension is off will not be sent to Kustomer.
Custom Events and Objects
While the Kustomer Extension comes with a few pre-made events (new customers, orders, etc.), it is possible to send add your own custom events to Kustomer. To do this, create your own module and make sure kustomer/kustomer-integration is one of the requirements in composer.json. For more information about creating Adobe Commerce Modules, see the Adobe Commerce Developer Documentation.
Then create an Observer under Observers/MySubscriptionObserver.php and extend the KustomerEventObserver class. If you wanted to send a custom Subscription object to Kustomer when it is created, you might do something like this:
Note that the KustomerEventObserver.publish() method requires a $type string, an array of $data (this is will be your object in Kustomer) and a $customer variable that is either a customer ID or an instance of CustomerInterface.
We also recommend you explicitly select which fields you send to Kustomer. This will avoid inadvertently sharing information you may not want to share with Kustomer, such as passwords.
Once your observer is ready, you need to register it in your module's etc/events.xml file. This example might look like this:
Subscription objects will automatically be ingested by Kustomer and associated with your customer as Kustom Objects belonging to a dynamically-generated Klass.
Customer Only Events
If you just want to send the Customer object, you can assign $type a value of 'customer' and pass an empty array as $data:
