OG-kép generálás Laravelben — 523service/laravel-og-image

php -r 'print_r(gd_info());'

// JPG: fotós háttérnél kb. 120 KB, a PNG kb. 400 KB.
'default_format' => 'jpg',

// Háttérképek: kulcs => fájl. URL-ből csak a KULCS adható meg, útvonal soha.
'images' => [
    'hero' => public_path('img/hero.webp'),
],

// Ezt használja, ha az URL-ben nincs `p` paraméter (és ilyenkor a `p` ki is marad az URL-ből).
'default_preset' => 'brand',

'presets' => [
    'brand' => [
        'background' => '02243f',   // háttérszín (6 jegyű hex, # nélkül)
        'foreground' => 'ffffff',   // cím színe
        'accent' => 'bff230',       // kicker / kiemelés színe
        'muted' => 'd5dee8',        // lábléc, tagline színe
        'image' => 'hero',          // háttérkép KULCSA az `images` tömbből (null = csak szín)
        'overlay' => [              // átmenetes sötétítés a fotó fölött
            'color' => '02243f',
            'from' => 0.95,         // átlátszatlanság az egyik oldalon
            'to' => 0.62,           // ... és a másikon
        ],
        'logo' => [                 // szöveges logó
            'type' => 'text',
            'text' => 'ACME',
            'tagline' => "Sor 1\nSor 2",
        ],
        // vagy képes logó:
        // 'logo' => ['type' => 'image', 'path' => public_path('logo.png'), 'height' => 64],
        'host' => null,             // null = az APP_URL hostja „www.” nélkül
        'footer' => '+36 1 234 5678', // jobb alsó szöveg; ha változik, emeld a `version`-t!
    ],
],

<x-og-image::meta
    :title="$title"
    kicker="Blog"
    :path="request()->getPathInfo()"
/>

<x-og-image::meta :url="asset('kep.jpg')" :title="$title" />

og_image_url('Cím', kicker: 'Blog', path: '/blog/x');

OgImage::url(['title' => 'Cím', 'kicker' => 'Blog', 'p' => 'dark', 'accent' => 'ff6600'], 'png');

{{-- resources/views/pages/szolgaltatasok.blade.php --}}
@extends('layouts.site')

@section('title', 'Szolgáltatásaink | Márka')
@section('og_kicker', 'Szolgáltatások')
@section('og_title', 'Minden, amire a projektednek szüksége van')

{{-- resources/views/layouts/site.blade.php, <head> --}}
@php
    $pageTitle = trim($__env->yieldContent('title'));
    $ogTitle = trim($__env->yieldContent('og_title')) ?: \Illuminate\Support\Str::beforeLast($pageTitle, ' | ');
    $ogKicker = trim($__env->yieldContent('og_kicker')) ?: null;
    $canonical = url()->current();
@endphp

<link rel="canonical" href="{{ $canonical }}">

@if (filled($fixedOgImage ?? null)) {{-- pl. adminban feltöltött kép --}}
    <x-og-image::meta :url="$fixedOgImage" :title="$ogTitle" />
@else
    <x-og-image::meta
        :title="$ogTitle"
        :kicker="$ogKicker"
        :path="parse_url($canonical, PHP_URL_PATH) ?: '/'"
    />
@endif

use Illuminate\Support\Facades\File;
use Illuminate\Support\Str;

beforeEach(function () {
    config(['og-image.cache_path' => storage_path('framework/testing/og-'.Str::random(8))]);
});

afterEach(function () {
    File::deleteDirectory(config('og-image.cache_path'));
});

it('aláírt og:image URL-t ír ki', function () {
    $this->get('/')
        ->assertOk()
        ->assertSee('property="og:image"', false)
        ->assertSee('/og/', false);
});

Task: install and configure the 523service/laravel-og-image package in THIS Laravel project, so that every public page gets its own signed, file-cached 1200x630 Open Graph image (rendered with GD, no headless browser).

Source of truth: https://github.com/523service/laravel-og-image (README.md, config/og-image.php, CHANGELOG.md). Step-by-step guide: https://523.hu/knowledge/laravel-og-image-beallitasa. Read the repo README and config before changing anything. Do not invent options, parameters or commands that are not in the package.

1. Investigate first (read-only):
   - Follow this project's CLAUDE.md / conventions (tests, formatter, docs, commit rules).
   - Check PHP >= 8.2, Laravel 11 or 12, and that ext-gd has FreeType + JPEG/PNG support (php -r "print_r(gd_info());"). Stop and tell me if something is missing.
   - Find the public layout(s) and how <title>, meta description and canonical URL are built. List any existing og:image / twitter:image tags and any admin field for a fixed share image.
   - Check whether a sitemap.xml exists (needed by og:warm).
   - Look for brand colours, logo files and contact data (phone) in the CSS, config and views.

2. Install (the package is NOT on Packagist, use the VCS repository):
   composer config repositories.og-image vcs https://github.com/523service/laravel-og-image
   composer require 523service/laravel-og-image:^1.0
   php artisan vendor:publish --tag=og-image-config
   Add /public/og/ to .gitignore.
   Add OG_IMAGE_VERSION=1 to .env.example (and OG_IMAGE_SECRET= / OG_IMAGE_URL= empty, with a short comment). Never write real secret values anywhere.

3. Configure config/og-image.php:
   - Create one preset for the brand and set it as default_preset: background, foreground, accent, muted (6-digit hex without #), optional background photo via the images key map (key => public_path(...), only keys in URLs), overlay, logo (text logo with optional tagline, or image logo with path + height), host (null = APP_URL host without www), footer (e.g. phone number).
   - Use default_format jpg if the preset has a photo background, otherwise png is fine.
   - Keep the bundled Montserrat fonts unless the project already ships STATIC TTF fonts (no variable fonts).
   - Keep cache_path as the public directory of route.prefix.

4. Wire it into the layout <head>:
   - Use <x-og-image::meta :title="..." :kicker="..." :path="..." />.
   - Pattern: pages may define @section('og_title') and @section('og_kicker'); otherwise the title comes from the page <title> with the " | Brand" suffix stripped, and the path from the canonical URL.
   - If the project has a fixed / admin-uploaded share image, it takes priority: <x-og-image::meta :url="..." :title="..." />.
   - Remove the old, duplicated og:image / twitter:image / twitter:card tags. Keep og:title, og:description etc.
   - Add og_kicker (and og_title where the page title is too long or too generic) to the main public pages.

5. Tests (in this project's test framework and style):
   - In tests, point og-image.cache_path to a temporary directory (e.g. storage_path('framework/testing/og-<random>')) and delete it afterwards.
   - Cover: the layout prints a signed /og/<32 hex>.<jpg|png> og:image URL and twitter:card=summary_large_image; og_title / og_kicker are used; the fixed image wins when set; the image URL returns 200 with the right content type and writes the file; a tampered URL returns 403.
   - Run only the affected test files, run the code formatter, and fix failures.

6. Finish:
   - Update the project docs/changelog if the project rules require it.
   - Do NOT commit, push or deploy unless I ask. Tell me the deploy steps instead:
     php artisan config:cache; php artisan og:warm (needs sitemap.xml); keep public/og writable and out of git, the deploy must not delete it; on suPHP/suEXEC shared hosting run chmod -R go-w after deploy (group-writable files give 500); bump OG_IMAGE_VERSION whenever the design or burned-in data (e.g. the footer phone number) changes, then og:clear + og:warm; check with the Facebook Sharing Debugger and LinkedIn Post Inspector.
   - Report: changed files, the chosen preset values, and anything you could not verify.

Stop and ask me if: the layout structure is unclear, there are several unrelated layouts, an existing OG image solution conflicts with this one, or brand values below are missing and cannot be found in the project.

Brand values (fill in or leave empty):
- Colours (background / foreground / accent / muted):
- Logo (text + tagline, or image file path):
- Footer text (e.g. phone number):