PHPackages                             placidapp/placid-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. [Image & Media](/categories/media)
4. /
5. placidapp/placid-laravel

ActiveLibrary[Image & Media](/categories/media)

placidapp/placid-laravel
========================

Placid.app Laravel Integration

v1.0.1(3y ago)585.9k↓28.6%5MITPHPPHP ^7.4|^8.0

Since Aug 15Pushed 3y ago2 watchersCompare

[ Source](https://github.com/placidapp/placid-laravel)[ Packagist](https://packagist.org/packages/placidapp/placid-laravel)[ Docs](https://github.com/placidapp/placid-laravel)[ RSS](/packages/placidapp-placid-laravel/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

[![Placid for Laravel - Automatic image creation from templates](https://camo.githubusercontent.com/f075ac7b6eeacb297bd64b2c846b976eeb6892ca692a8972d4bddde305d7ca4a/68747470733a2f2f706c616369642e6170702f696d616765732f6769746875622d6865616465722d6c61726176656c2e6a7067)](https://camo.githubusercontent.com/f075ac7b6eeacb297bd64b2c846b976eeb6892ca692a8972d4bddde305d7ca4a/68747470733a2f2f706c616369642e6170702f696d616765732f6769746875622d6865616465722d6c61726176656c2e6a7067)

Placid for Laravel
==================

[](#placid-for-laravel)

[![Latest Version](https://camo.githubusercontent.com/ef202e720f4c64129ab9a8a4b107dd20d40dd30a9b0488bd9d4c9d9bef380cfc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f706c616369646170702f706c616369642d6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](https://github.com/placidapp/placid-laravel/releases)[![Total Downloads](https://camo.githubusercontent.com/3b3506dc29afa632bf1c1a5b0a194b9704f718db0bb1273052a8d8834096126c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f706c616369646170702f706c616369642d6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/placidapp/placid-laravel)[![MadeWithLaravel.com shield](https://camo.githubusercontent.com/197f42698f614f0afc8b1dbb271ce1e5117726dd8485ea267cfc8639d94a5dab/68747470733a2f2f6d616465776974686c61726176656c2e636f6d2f73746f726167652f7265706f2d736869656c64732f313731382d736869656c642e737667)](https://madewithlaravel.com/p/placid-laravel/shield-link)

This package enables you to automatically create images from [Placid](https://placid.app) templates. You can use the REST API or the URL API to create placid.app embed links with your variables to dynamically set the image content.

About Placid
------------

[](#about-placid)

To use this package, you will need a [Placid](https://placid.app) account, where you can add, design and edit image templates.

It is a service that automatically creates share images for your content: Open Graph images (og:images), Twitter Card images and Pinterest images. This saves you hours to make your content shareable after publishing. We offer a bunch of nice preset designs you can use out of the box as well.

**More than share images:** With our editor you have full control over your templates, so you can use it for other types of images to add to your content as well (like teasers or blog graphics).

Create a placid.app image URL
-----------------------------

[](#create-a-placidapp-image-url)

```
$templateId = "qsraj";

$template = Placid::template($templateId)
$template
    ->elementText($title)
    ->text("I am a dynamic image");

$imageURL = $template->toPlacidUrl(); // - https://placid.app/u/qsraj?title=I%20am%20a%20dynamic%20Image%21
```

[![Dynamically created image with Placid](https://camo.githubusercontent.com/650ba96c0d47048220b1ff4fc93bcb2dd683baf56bb7db05d76e309b2d1a5011/68747470733a2f2f706c616369642e6170702f696d616765732f6769746875622d646f6b752d616e696d6174696f6e5f6f70742e676966)](https://camo.githubusercontent.com/650ba96c0d47048220b1ff4fc93bcb2dd683baf56bb7db05d76e309b2d1a5011/68747470733a2f2f706c616369642e6170702f696d616765732f6769746875622d646f6b752d616e696d6174696f6e5f6f70742e676966)

Generate an Image
-----------------

[](#generate-an-image)

Using the `image()` function on the template object will result in returning a [GeneratedImage Object](https://github.com/placidapp/placid-php/blob/master/src/GeneratedImage.php). When the image has been created, the webhook defined in your config will be called!

```
 $image = $template->image();
```

`image(true)` will wait for the image to being finished:

```
 $image = $template->image(true); // - https://placid.app/u/qsraj?title=I%20am%20a%20dynamic%20Image%21
```

Fields
------

[](#fields)

You can add different elements onto your template that can be changed and filled dynamically.

### Text field

[](#text-field)

```
$template
    ->elementText("text") // - Layer name in your template
    ->text("This is the text")
    ->color('#ff0022'); // - Text color as hex-code
```

**PLEASE NOTE:** The text color can only be changed when you use the `image()` function to generate an image, not if you use the URL API.

### Picture field

[](#picture-field)

```
$template
    ->elementPicture('picture') // - Layer name in your template
    ->imageFromUrl(
        "https://madewithvuejs.com/mandant/madewithvuejs/images/logo.png" // - image source
    );

$template
    ->elementPicture('picture') // - Layer name in your template
    ->imageFromWebsite("https://madewithvuejs.com"); // - URL of a page to screenshot
```

### Browserframe field

[](#browserframe-field)

```
$template
    ->elementBrowserframe('browserframe') // - Layer name in your template
    ->imageFromUrl(
        "https://madewithvuejs.com/mandant/madewithvuejs/images/logo.png" // - image source
    )
    ->url("madewithvuejs.com"); // - URL that will be displayed in the browserframe's address bar

$template
    ->elementBrowserframe('browserframe') // - Layer name in your template
    ->imageFromWebsite("https://madewithvuejs.com") // - URL of a page to screenshot
    ->url("madewithvuejs.com"); // - URL that will be displayed in the browserframe's address bar
```

### Rectangle field

[](#rectangle-field)

```
$template
    ->elementRectangle('rectangle') // - Layer name in your template
    ->backgroundColor("#000000"); // - Background color as hex-code
```

**PLEASE NOTE:** The background color can only be changed when you use the `image()` function to generate an image, not if you use the URL API.

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

[](#installation)

You can install this package via composer using this command:

```
composer require placidapp/placid-laravel
```

The package will automatically register itself.

You can publish the config-file with:

```
php artisan vendor:publish --provider="Placid\Laravel\PlacidLaravelServiceProvider" --tag="config"
```

These are the contents of the published config file:

```
return [
    /**
     * Placid API Token
     */
    'api-token' => null,

    /**
     * Placid Success Webhook
     *
     * Will be called when your created image is ready
     */
    'webhook_url' => null
];
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity36

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 92.3% 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 ~1070 days

Total

2

Last Release

1399d ago

PHP version history (2 changes)v1.0PHP ^7.1

v1.0.1PHP ^7.4|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/4766aac7f4ee1481e28c8b2f9e53b1c019b5006fb77582972c8c69e98c4c8b17?d=identicon)[arminulrich](/maintainers/arminulrich)

---

Top Contributors

[![arminulrich](https://avatars.githubusercontent.com/u/632486?v=4)](https://github.com/arminulrich "arminulrich (12 commits)")[![ghostzero](https://avatars.githubusercontent.com/u/6547306?v=4)](https://github.com/ghostzero "ghostzero (1 commits)")

---

Tags

imageslaravelphpplacidlaravelimagesplacid

### Embed Badge

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

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

###  Alternatives

[okipa/laravel-medialibrary-ext

Extra features for spatie/laravel-medialibrary package.

1011.2k](/packages/okipa-laravel-medialibrary-ext)

PHPackages © 2026

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