Download the PHP package ideacrafters/laravel-dittofeed without Composer

On this page you can find all versions of the php package ideacrafters/laravel-dittofeed. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package laravel-dittofeed

Dittofeed Laravel SDK

Latest Version on Packagist Total Downloads License

Laravel SDK for Dittofeed - an open-source customer engagement platform. This package provides a seamless integration with Laravel, enabling you to easily track user events, send targeted emails, and build automated customer journeys.

Features

Requirements

Installation

Install the package via Composer:

The package will automatically register itself via Laravel's package auto-discovery.

Configuration

Publish the configuration file:

Add your Dittofeed credentials to your .env file:

Quick Start

Basic Event Tracking

Automatic User Tracking

The SDK automatically resolves the current authenticated user:

Usage Guide

Event Tracking

Identify Users

Associate a user with their traits:

Track Events

Track custom events with properties:

Track Page Views

Track page views (automatically includes URL, referrer, etc.):

Track Screen Views

For mobile applications:

Group Users

Associate users with groups or organizations:

Model Integration

Add the TracksDittofeedEvents trait to your models for automatic event tracking:

Now model events are automatically tracked:

Automatic Page View Tracking

Enable automatic page view tracking by adding the middleware to your app/Http/Kernel.php:

Or register it as a route middleware alias:

Then use it on specific routes:

Automatic Authentication Event Tracking

The SDK automatically tracks user registration, login, and logout events when auto_track.auth_events is enabled in the config (enabled by default).

Events tracked:

Queue Support

Enable queue support for asynchronous event processing:

Events will be dispatched to your queue and processed asynchronously.

Batch Operations

Send multiple events in a single request:

Admin API

Access the Admin API for managing templates, segments, and journeys:

Testing

Use the fake implementation in your tests:

Available Assertions

Artisan Commands

Test Your Integration

Sends test events to verify your integration is working correctly.

Flush Event Queue

Manually flush any queued events.

View Configuration

Display your current Dittofeed configuration and status.

Configuration

Environment Variables

Variable Description Default
DITTOFEED_WRITE_KEY Your write key for the Public API -
DITTOFEED_ADMIN_KEY Your admin key for the Admin API -
DITTOFEED_HOST Dittofeed host URL https://app.dittofeed.com
DITTOFEED_WORKSPACE_ID Your workspace ID -
DITTOFEED_QUEUE_ENABLED Enable queue support false
DITTOFEED_QUEUE_NAME Queue name default
DITTOFEED_QUEUE_CONNECTION Queue connection null
DITTOFEED_TIMEOUT HTTP timeout in seconds 30
DITTOFEED_DEBUG Enable debug logging false
DITTOFEED_TESTING Enable testing mode (no events sent) false

Auto-Tracking Configuration

Context Enrichment

Automatically enrich events with contextual data:

Advanced Usage

Custom User ID Resolver

Define a custom resolver for the user ID:

Or set it in the config:

Custom Event Properties in Models

Define custom properties for model events:

Manual Custom Events in Models

Best Practices

  1. Use Queues - Enable queue support for better performance
  2. Be Selective - Only track events that provide value
  3. Name Consistently - Use consistent event naming (e.g., "Object Action")
  4. Include Context - Add relevant properties to events
  5. Test Thoroughly - Use the fake implementation in tests
  6. Secure Keys - Never commit API keys to version control
  7. Monitor Errors - Enable debug mode during development

Security

Troubleshooting

Events Not Appearing

  1. Check your write key is correct
  2. Verify your host URL is correct
  3. Enable debug mode to see API responses
  4. Run php artisan dittofeed:test to test your integration

Queue Jobs Failing

  1. Ensure your queue worker is running
  2. Check queue logs for errors
  3. Verify network connectivity to Dittofeed
  4. Increase retry attempts if needed

Performance Issues

  1. Enable queue support for async processing
  2. Use batch operations for multiple events
  3. Disable unnecessary auto-tracking
  4. Optimize model event tracking

Support

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

Changelog

Please see CHANGELOG.md for recent changes.

License

The MIT License (MIT). Please see LICENSE for more information.

Credits

Related Packages


All versions of laravel-dittofeed with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0|^8.1|^8.2|^8.3
illuminate/contracts Version ^9.0|^10.0|^11.0|^12.0
guzzlehttp/guzzle Version ^7.0
ramsey/uuid Version ^4.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package ideacrafters/laravel-dittofeed contains the following files

Loading the files please wait ...