Collections
Not every view of a model is the same kind of view. A post can be opened on its own page, shown as a teaser in the sidebar, or read inside the newsletter. A collection is a name you record a view under, so you can count those kinds apart while they stay views of the same post.
Recording into a collection
Section titled “Recording into a collection”Pass the name to collection() before record():
// On the post pageviews($post)->record();
// In the sidebar teaserviews($post)->collection('sidebar')->record();
// When the newsletter's tracking pixel loadsviews($post)->collection('newsletter')->record();A view recorded without collection() has no collection: its collection column is null. A name is any string you
pick. There is nothing to register.
The middleware and the browser beacon take the collection as an argument:
Route::get('/amp/posts/{post}', ShowAmpPost::class) ->middleware(RecordViews::using('post', collection: 'amp'));@viewsBeacon($post, collection: 'amp')Counting a collection
Section titled “Counting a collection”Add the same collection() to any count:
views($post)->collection('sidebar')->count(); // sidebar viewsviews($post)->collection('sidebar')->unique()->period(Period::pastDays(7))->count(); // unique, this weekTo see every collection at once, use countByCollection():
views($post)->countByCollection();// ['' => 1200, 'sidebar' => 340, 'newsletter' => 88]The empty string '' stands for the views without a collection. The list is sorted by count, most viewed first.
Everything else follows the collection
Section titled “Everything else follows the collection”collection() works with every part of the package that reads views, so you can keep a kind of view separate from
start to finish:
| What | Example |
|---|---|
| Ordering | Post::orderByViews('desc', null, 'sidebar')->get() |
| Trending | views(Post::class)->collection('sidebar')->trending() |
| Also viewed | views($post)->collection('sidebar')->alsoViewed(5) |
| Recommended | $user->recommended(Post::class, collection: 'articles') |
| Live presence | views($product)->collection('checkout')->live()->count() |
| Tests | $fake->assertRecorded($post, fn ($record) => $record->collection === 'sidebar') |
A cooldown is kept per collection as well. A reader who opens the post page and then sees its teaser in the sidebar is recorded once in each.
When to use a collection
Section titled “When to use a collection”Use a collection when the same model is seen in clearly different places and you want separate numbers for each. Keep
the number of names small and fixed, like sidebar, newsletter or amp.
For a detail you only look up now and then, such as the campaign that brought the reader in, use context. For a value you want to chart or rank by across all views, such as the device or the country, use a dimension.
With rollups, counts of one model in a collection are summarised by the
viewable_collection grouping, which is on by default. Counts of a whole model type in a collection need
type_collection, which is off.