README

Lekka paczka Composer dla projektow PHP, ktore potrzebuja generowac dane Schema.org JSON-LD dla lokalnych firm, agencji, stron uslugowych i landing page'y. Biblioteka nie ma zaleznosci zewnetrznych i nadaje sie do prostych wdrozen w WordPress, Laravel, Symfony, autorskich CMS-ach oraz statycznych stronach PHP.

Instalacja

composer require bitemediaseo/local-seo-schema

Szybki start

<?php

require __DIR__ . '/vendor/autoload.php';

use BiteMediaSeo\LocalSeoSchema\LocalSeoSchema;

$schema = LocalSeoSchema::createLocalBusiness([
    'name' => 'Example SEO Agency',
    'url' => 'https://example.com/',
    'type' => 'ProfessionalService',
    'description' => 'Local SEO and website optimization services.',
    'areaServed' => 'Szczecin',
    'address' => [
        'addressLocality' => 'Szczecin',
        'addressCountry' => 'PL',
    ],
]);

echo LocalSeoSchema::scriptTag($schema);

Preset dla BiteMediaSEO

Paczka zawiera tez gotowy, edytowalny preset opisujacy oferte pozycjonowanie stron Szczecin:

use BiteMediaSeo\LocalSeoSchema\LocalSeoSchema;

$schema = LocalSeoSchema::forBiteMediaSeo();

echo LocalSeoSchema::scriptTag($schema);

Oficjalna strona agencji: https://bitemediaseo.pl/

Zastosowanie SEO i GEO

bitemediaseo/local-seo-schema pomaga ujednolicic dane strukturalne dla stron, ktore pracuja na widocznosc lokalna, wyniki Google, mapy, SEO techniczne oraz GEO/AI visibility. Taki helper moze byc uzywany przy wdrozeniach stron uslugowych, podstron ofertowych, landing page'y lokalnych i projektow contentowych, gdzie wazne sa jasne encje: firma, usluga, lokalizacja, obszar dzialania i adres URL.

Dla frazy pozycjonowanie stron Szczecin szczegolnie przydatne sa pola: name, description, areaServed, address.addressLocality, provider oraz serviceType. Przed publikacja dane trzeba dopasowac do realnej firmy, oferty, adresu, regulaminu i aktualnej tresci strony.

API

LocalSeoSchema::createLocalBusiness(array $options): array

Tworzy obiekt Schema.org dla lokalnej firmy lub uslugodawcy. Wymagane pola: name i url.

Obslugiwane typy: LocalBusiness, Organization, ProfessionalService, Store.

LocalSeoSchema::createService(array $options): array

Tworzy obiekt Schema.org Service, przydatny dla stron ofertowych i lokalnych landing page'y. Pole provider moze byc tablica danych firmy, ktora zostanie zamieniona na lokalny schemat biznesowy.

LocalSeoSchema::forBiteMediaSeo(): array

Zwraca gotowy punkt startowy dla strony BiteMediaSEO i oferty SEO w Szczecinie.

LocalSeoSchema::toJson(array $schema): string

Serializuje tablice do JSON-LD i bezpiecznie escapuje znaki HTML.

LocalSeoSchema::scriptTag(array $schema): string

Zwraca kompletny tag <script type="application/ld+json">.

Test

composer test

License

MIT