PHPackages                             contentpulseio/laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. contentpulseio/laravel

ActiveLibrary[API Development](/categories/api)

contentpulseio/laravel
======================

Laravel integration for ContentPulse.io — webhook ingestion, local content storage, and rendering.

v0.1.14(1w ago)052—6.3%MITPHPPHP ^8.2

Since Jun 6Pushed 3d agoCompare

[ Source](https://github.com/contentpulseio/laravel)[ Packagist](https://packagist.org/packages/contentpulseio/laravel)[ Docs](https://github.com/contentpulseio/laravel)[ RSS](/packages/contentpulseio-laravel/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (72)Versions (15)Used By (0)

ContentPulse for Laravel
========================

[](#contentpulse-for-laravel)

Laravel integration for [ContentPulse.io](https://contentpulse.io). Receives content webhooks, stores a local copy of the published content, and renders it through your own layout. Once content is delivered, your app serves it from its own database with no runtime dependency on ContentPulse.

Requirements
------------

[](#requirements)

- PHP `^8.2`
- Laravel `^10 | ^11 | ^12`

Installation
------------

[](#installation)

```
composer require contentpulseio/laravel
php artisan contentpulse:install
php artisan migrate
```

The package is published on [Packagist](https://packagist.org/packages/contentpulseio/laravel), so the command above works out of the box. `contentpulse:install` publishes the config and migration; the service provider is auto-discovered.

If you install from a private fork instead of Packagist, add the repository to your `composer.json` before requiring:

```
"repositories": [
    { "type": "vcs", "url": "https://github.com/contentpulseio/laravel" }
]
```

Set your credentials in `.env`:

```
CONTENTPULSE_API_KEY=your-api-key
CONTENTPULSE_WEBHOOK_SECRET=your-webhook-secret
# optional
CONTENTPULSE_BASE_URL=https://contentpulse.io
CONTENTPULSE_TIMEOUT=30
```

How it works
------------

[](#how-it-works)

1. Register the webhook endpoint (`webhooks/contentpulse`) in your ContentPulse dashboard. Incoming requests are verified against `CONTENTPULSE_WEBHOOK_SECRET`.
2. On `content.*` events the package fetches the item and upserts it into the `contentpulse_contents` table.
3. Published content is served from the local store via the bundled routes:
    - `GET /resources` — index
    - `GET /resources/{slug}` — single item

Set your layout so rendered content slots into your site chrome:

```
CONTENTPULSE_LAYOUT=layouts.app
```

Webhooks
--------

[](#webhooks)

The package ships a ready-to-use webhook receiver — no controller or middleware to write in your app.

- **Endpoint:** `POST /webhooks/contentpulse` (override with `CONTENTPULSE_WEBHOOK_PATH`).
- **Signature:** every request is verified by the `VerifyContentPulseSignature`middleware. It computes `hash_hmac('sha256', , CONTENTPULSE_WEBHOOK_SECRET)`and compares it (constant-time) to the `X-Webhook-Signature` header.
    - Secret not set → `503`
    - Missing/invalid signature → `401`
    - Valid → `200 {"status":"ok"}`
- **Handled events** (from the `event` field or `X-Webhook-Event` header, with `data.content_id` as the ContentPulse ULID):
    - `content.created`, `content.updated`, `content.published` → fetch the item from the API and upsert it into `contentpulse_contents`
    - `content.deleted` → remove the local row

Register the endpoint in your ContentPulse dashboard (Webhooks) pointing at `https://your-app.test/webhooks/contentpulse`, subscribe to the `content.*`events, and set the signing secret to match `CONTENTPULSE_WEBHOOK_SECRET`. Published content then syncs automatically; `contentpulse:sync` is only needed for the initial backfill.

Local image downloads
---------------------

[](#local-image-downloads)

When `CONTENTPULSE_DOWNLOAD_IMAGES=true` (default in the package config), synced featured images and variants are fetched onto your filesystem disk and stored as app-relative URLs (e.g. `/storage/media/blog/{hash}.webp`). Downloads reject empty/HTML responses and only persist a relative URL after the file is verified on disk; otherwise the upstream ContentPulse URL is kept.

If local files go missing (disk cleanup, failed deploy, etc.) while the database still points at relative URLs, repair them:

```
php artisan contentpulse:repair-images --dry-run
php artisan contentpulse:repair-images
php artisan contentpulse:repair-images --external-id=01KXXXXXXXXXXXXXXXXXXXXXXX
```

`contentpulse:repair-images` re-fetches each affected item from the API and re-runs image localization.

Using your own design (decoupled read model)
--------------------------------------------

[](#using-your-own-design-decoupled-read-model)

Already have a blog with your own `Post` model, controller, views, and SEO? Keep all of it. The package `Content` model is a plain, queryable Eloquent model that exposes a post-like surface, so it drops into your existing views with no trait, no base class, and no changes to your `Post` model.

### Scopes

[](#scopes)

```
use ContentPulse\Laravel\Models\Content;

Content::published()->get();          // status = published, newest first
Content::whereCategory('laravel')->get();
Content::whereTag('seo')->get();
```

### Post-like accessors (built in)

[](#post-like-accessors-built-in)

AccessorReturns`title`, `excerpt`, `slug`, `featured_image`columns`content`pre-rendered HTML (`rendered_html`)`read_time`minutes (from `word_count`)`categories`, `tags``Collection` of `{name, slug}` objects`meta_title`, `meta_description`, `meta_keywords`SEO fields`views`, `user``0` / `null` (override in your view if needed)`published_at``Carbon`### Merge with your existing posts

[](#merge-with-your-existing-posts)

Because the field surface matches a typical `Post`, you can render both sources through the same Blade views:

```
use App\Models\Post;
use ContentPulse\Laravel\Models\Content;

public function index()
{
    $feed = Post::published()->get()
        ->concat(Content::published()->get())
        ->sortByDesc('published_at')
        ->values();

    return view('blog.index', ['posts' => $feed]);
}

public function show(string $slug)
{
    $post = Post::published()->where('slug', $slug)->first()
        ?? Content::published()->where('slug', $slug)->firstOrFail();

    return view('blog.show', ['post' => $post]);
}
```

Your views, your routes, your SEO tags — the package only supplies the data.

### Or just echo the HTML

[](#or-just-echo-the-html)

```
$content = Content::published()->where('slug', $slug)->firstOrFail();

echo $content->rendered_html;
```

Customizing the design
----------------------

[](#customizing-the-design)

The bundled Blade views are fully overridable. Publish them into your app to own the markup and styling:

```
php artisan vendor:publish --tag=contentpulse-views
```

This copies the views to `resources/views/vendor/contentpulse/`:

- `index.blade.php` — list page
- `show.blade.php` — single item
- `partials/head.blade.php` — SEO meta tags / JSON-LD
- `partials/styles.blade.php` — base CSS

Laravel automatically loads the published copies instead of the package defaults, so edit them freely. Delete a file to fall back to the package version. Package updates never overwrite your published views.

Artisan
-------

[](#artisan)

```
php artisan contentpulse:sync --locale=en
```

Backfills the local store from the API (useful for the initial import).

License
-------

[](#license)

MIT

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance99

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

14

Last Release

10d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0fc056b672a7c2d04438f2955d425978dfe78d8c34e47c7cebf7e252382fc691?d=identicon)[contentpulse](/maintainers/contentpulse)

---

Top Contributors

[![contentpulseio](https://avatars.githubusercontent.com/u/264545974?v=4)](https://github.com/contentpulseio "contentpulseio (31 commits)")

---

Tags

laravelcontentcmsapi clientseocontentpulse

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/contentpulseio-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/contentpulseio-laravel/health.svg)](https://phpackages.com/packages/contentpulseio-laravel)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M347](/packages/psalm-plugin-laravel)[laravel/cashier

Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services.

2.5k30.2M151](/packages/laravel-cashier)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

77922.3M186](/packages/laravel-mcp)[api-platform/laravel

API Platform support for Laravel

58174.6k17](/packages/api-platform-laravel)[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k15.1M136](/packages/laravel-pulse)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M133](/packages/roots-acorn)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)