Download the PHP package musonza/laravel-activity-streams without Composer

Laravel Activity Streams

Table of Contents

Introduction

This package enables you to have activity streams in your laravel applications.

Installation

Install with composer

Once the composer installation is finished, you can add alias for the facade. Open config/app.php, and make the following update:

1) Add a new item to the aliases array:

1) Publish the configuration file into your app's config directory, by running the following command:

1) Publish the migrations into your app's migrations directory, by running the following command:

1) Run the migrations:

Usage

Facade

Whenever you use the ActivityStreams facade in your code, remember to add the following line to your namespace imports:

Giving a model an ability to have a Feed

Use the HasFeed trait to allow a model to have a feed.

Create a model Feed

After adding the HasFeed trait you can create a feed for the Model as follows

On-Demand Feeds

Sometimes you may want to create a Feed that's does not belong to a Model. For example, you want to add activities to a Trending Feed for your application:

Create a class to represent the Trending feed under a namespace of choice

Then run an artisan command that ships with the package

some-unique-id is unique with respect to $table->unique(['some-unique-id', 'App\Trending']);

Create an Activity

An example of an activity will be something like John liked a photo in 2018Album

Actors

Valid Actors

You can pass in an Eloquent Model as an actor or any Object that implements Musonza\ActivityStreams\Contracts\ActivityActor interface

Targets

Valid Targets

You can pass in an Eloquent Model as a target or any Object that implements Musonza\ActivityStreams\Contracts\ActivityTarget interface

Objects

Valid Objects

You can pass in an Eloquent Model as an object or any Object that implements Musonza\ActivityStreams\Contracts\ActivityObject interface

Get supported verbs

Add an activity to a Feed

Add multiple activities to a Feed

Adds a Collection of activities to a Feed

Add an activity to multiple Feeds

Adds an Activity to a Collection feeds

Events

You can leverage and listen for the following events to perform actions in your application. For instance you can listen for an ActivityCreated event and depending on your business logic add the created event to a Feed or multiple feeds.

ActivityCreated

Musonza\ActivityStreams\Models\Activity\ActivityCreated

ActivityDeleted

Musonza\ActivityStreams\Models\Activity\ActivityDeleted

FeedCreated

Musonza\ActivityStreams\Models\Activity\FeedCreated

FeedDeleted

Musonza\ActivityStreams\Models\Activity\FeedDeleted

Configuration

FAQ

See more on Activity Streams specifications here