{"id":42625033,"url":"https://github.com/placidapp/placid-laravel","last_synced_at":"2026-01-29T04:57:28.914Z","repository":{"id":45430635,"uuid":"202333695","full_name":"placidapp/placid-laravel","owner":"placidapp","description":"✨ Automatic image creation from templates ","archived":false,"fork":false,"pushed_at":"2022-07-20T18:09:29.000Z","size":12,"stargazers_count":59,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-31T18:17:50.415Z","etag":null,"topics":["images","laravel","php","placid"],"latest_commit_sha":null,"homepage":"https://placid.app","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/placidapp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-14T11:06:19.000Z","updated_at":"2025-02-11T11:48:54.000Z","dependencies_parsed_at":"2022-07-19T05:17:17.854Z","dependency_job_id":null,"html_url":"https://github.com/placidapp/placid-laravel","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/placidapp/placid-laravel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/placidapp%2Fplacid-laravel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/placidapp%2Fplacid-laravel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/placidapp%2Fplacid-laravel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/placidapp%2Fplacid-laravel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/placidapp","download_url":"https://codeload.github.com/placidapp/placid-laravel/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/placidapp%2Fplacid-laravel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28862950,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T22:56:21.783Z","status":"online","status_checked_at":"2026-01-29T02:00:06.714Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["images","laravel","php","placid"],"created_at":"2026-01-29T04:57:28.309Z","updated_at":"2026-01-29T04:57:28.899Z","avatar_url":"https://github.com/placidapp.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Placid for Laravel - Automatic image creation from templates](https://placid.app/images/github-header-laravel.jpg)\n\n# Placid for Laravel\n[![Latest Version](https://img.shields.io/github/release/placidapp/placid-laravel.svg?style=flat-square)](https://github.com/placidapp/placid-laravel/releases)\n[![Total Downloads](https://img.shields.io/packagist/dt/placidapp/placid-laravel.svg?style=flat-square)](https://packagist.org/packages/placidapp/placid-laravel)\n[![MadeWithLaravel.com shield](https://madewithlaravel.com/storage/repo-shields/1718-shield.svg)](https://madewithlaravel.com/p/placid-laravel/shield-link)\n\nThis 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.\n\n## About Placid\nTo use this package, you will need a [Placid](https://placid.app) account, where you can add, design and edit image templates.\n\nIt 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.\n\n**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).\n\n## Create a placid.app image URL\n```php\n$templateId = \"qsraj\";\n\n$template = Placid::template($templateId)\n$template\n    -\u003eelementText($title)\n    -\u003etext(\"I am a dynamic image\");\n\n$imageURL = $template-\u003etoPlacidUrl(); // - https://placid.app/u/qsraj?title=I%20am%20a%20dynamic%20Image%21\n\n```\n![Dynamically created image with Placid](https://placid.app/images/github-doku-animation_opt.gif)\n\n\n## Generate an Image\n\nUsing 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!\n\n```php\n $image = $template-\u003eimage();\n```\n\n`image(true)` will wait for the image to being finished: \n```php\n $image = $template-\u003eimage(true); // - https://placid.app/u/qsraj?title=I%20am%20a%20dynamic%20Image%21\n```\n\n## Fields\nYou can add different elements onto your template that can be changed and filled dynamically.\n\n### Text field\n```php\n$template\n    -\u003eelementText(\"text\") // - Layer name in your template\n    -\u003etext(\"This is the text\")\n    -\u003ecolor('#ff0022'); // - Text color as hex-code\n```\n\n**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.\n\n### Picture field\n```php\n$template\n    -\u003eelementPicture('picture') // - Layer name in your template\n    -\u003eimageFromUrl(\n        \"https://madewithvuejs.com/mandant/madewithvuejs/images/logo.png\" // - image source\n    );\n\n$template\n    -\u003eelementPicture('picture') // - Layer name in your template\n    -\u003eimageFromWebsite(\"https://madewithvuejs.com\"); // - URL of a page to screenshot\n```\n\n### Browserframe field\n```php\n$template\n    -\u003eelementBrowserframe('browserframe') // - Layer name in your template\n    -\u003eimageFromUrl(\n        \"https://madewithvuejs.com/mandant/madewithvuejs/images/logo.png\" // - image source \n    )\n    -\u003eurl(\"madewithvuejs.com\"); // - URL that will be displayed in the browserframe's address bar\n\n$template\n    -\u003eelementBrowserframe('browserframe') // - Layer name in your template\n    -\u003eimageFromWebsite(\"https://madewithvuejs.com\") // - URL of a page to screenshot\n    -\u003eurl(\"madewithvuejs.com\"); // - URL that will be displayed in the browserframe's address bar\n```\n\n### Rectangle field\n```php\n$template\n    -\u003eelementRectangle('rectangle') // - Layer name in your template\n    -\u003ebackgroundColor(\"#000000\"); // - Background color as hex-code\n```\n\n**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.\n\n\n## Installation\n\nYou can install this package via composer using this command:\n\n```bash\ncomposer require placidapp/placid-laravel\n```\n\nThe package will automatically register itself.\n\nYou can publish the config-file with:\n\n```bash\nphp artisan vendor:publish --provider=\"Placid\\Laravel\\PlacidLaravelServiceProvider\" --tag=\"config\"\n```\n\nThese are the contents of the published config file:\n\n```php\nreturn [\n    /**\n     * Placid API Token\n     */\n    'api-token' =\u003e null,\n\n    /**\n     * Placid Success Webhook\n     *\n     * Will be called when your created image is ready\n     */\n    'webhook_url' =\u003e null\n];\n```\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplacidapp%2Fplacid-laravel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplacidapp%2Fplacid-laravel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplacidapp%2Fplacid-laravel/lists"}