> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Core-package en eigen drivers - Feedable

> De core-helpers van het feedable-core package en hoe je eigen drivers maakt

## Overzicht van Feedable Core

`feedable-core` is een Composer-package waarin de core-helpers en ingebouwde drivers van Feedable zijn ondergebracht.\
Installeer je het in een nieuw Laravel-project, dan hergebruik je dezelfde basis als de starterkit.

* Package: [invokable/feedable-core](https://github.com/invokable/feedable-core)
* Starterkit: [invokable/feedable](https://github.com/invokable/feedable)

## Response-klassen

Met `Rss2Response` en `JsonFeedResponse` leg je het uitvoerformaat vast.\
Laat je de gebruiker het formaat kiezen, gebruik dan `ResponseFactory`.

```php theme={null}
use Revolution\Feedable\Core\Response\Rss2Response;

return new Rss2Response(
    title: $title,
    items: $items,
);
```

```php theme={null}
use Revolution\Feedable\Core\Enums\Format;
use Revolution\Feedable\Core\Response\ResponseFactory;

Route::get('feed.{format?}', function (Format $format = Format::RSS) use ($title, $items) {
    return ResponseFactory::format($format)->make(
        title: $title,
        items: $items,
    );
});
```

## FeedItem / Author

`FeedItem` is het gedeelde item-object voor RSS/JSON Feed.\
`Author` is het object voor het `authors`-veld en maak je aan met `Author::make()`.

```php theme={null}
use Revolution\Feedable\Core\Elements\Author;
use Revolution\Feedable\Core\Elements\FeedItem;

$item = new FeedItem(
    id: $url,
    url: $url,
    title: $title,
    summary: $summary,
    authors: [Author::make(name: $authorName)->toArray()],
);
```

## Support-helpers

### AbsoluteUri::resolve()

Zet een relatief pad om naar een absoluut pad.

```php theme={null}
use Revolution\Feedable\Core\Support\AbsoluteUri;

$absolute = AbsoluteUri::resolve('https://example.com/', '/images/sample.jpg');
```

### RSS::filterLinks()

```php theme={null}
use Revolution\Feedable\Core\Support\RSS;

$xml = RSS::filterLinks($rss, $links);
```

### RSS::each()

```php theme={null}
use DOMElement;
use Revolution\Feedable\Core\Support\RSS;

$xml = RSS::each($rss, function (DOMElement $item) {
    $title = $item->getElementsByTagName('title')->item(0);

    if ($title && str_contains($title->textContent, 'NGワード')) {
        $item->parentNode?->removeChild($item);
    }
});
```

## Eigen drivers maken

### 1) Direct toevoegen aan de starterkit

De starterkit is een gewone Laravel-app. Je voegt een route toe in `routes/web.php` en implementeert de driver in een controller (of invokable klasse).

```php theme={null}
use App\Http\Controllers\CustomFeedController;
use Revolution\Feedable\Core\Enums\Format;

Route::get('/custom/site.{format?}', CustomFeedController::class)
    ->whereIn('format', array_column(Format::cases(), 'value'));
```

### 2) Toevoegen als Composer-package

Wil je een driver hergebruiken in meerdere projecten, dan is het handiger om de routes te registreren in een ServiceProvider.

```php theme={null}
use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\Route;

class CustomDriverServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        Route::middleware('web')->group(__DIR__.'/../routes/web.php');
    }
}
```

### 3) Informatie registreren met Driver::about() (optioneel)

De registratie via `Driver::about()` is metadata voor weergave in de lijst met ondersteunde sites.\
Zonder registratie werkt de driver zelf ook.

## Referentie: Laravel blog-driver

Bekijk de driver voor de officiële Laravel-blog als implementatievoorbeeld.

* [LaravelBlogDriver.php](https://github.com/invokable/feedable-core/blob/main/src/Drivers/Laravel/LaravelBlogDriver.php)


## Related topics

- [Feedable](/nl/packages/feedable/index.md)
- [Lijst met ondersteunde sites - Feedable](/nl/packages/feedable/drivers.md)
- [Illuminate\Support\Manager — anatomie van het driversysteem](/nl/advanced/manager.md)
- [Gebruik - VOICEVOX Core for PHP](/nl/packages/voicevox-core-php/usage.md)
- [API-referentie - VOICEVOX Core for PHP](/nl/packages/voicevox-core-php/api.md)
