brotkrueml/schema-virtuallocation

Add-on to the TYPO3 schema extension, providing pending type VirtualLocation

v1.3.0 2022-10-06 16:23 UTC

Requires

• php: >=7.2
• brotkrueml/schema: ^1.7 || ^2.0
• typo3/cms-core: ^10.4.11 || ^11.5 || ^12.0

Requires (Dev)

• brotkrueml/coding-standards: ~2.0.2

GPL-2.0-or-later

• Chris Müller

• seo
• JSON-LD
• schema.org
• TYPO3 CMS
• TYPO3 Extension
• structured data

README

This extension is an add-on for the TYPO3 schema extension and provides the VirtualLocation type. It can be assigned as location to the Event type. As it is a pending type by now it is not provided by the schema extension. When this type is taken into the core vocabulary this extension is obsolete.

Also, this extension serves as a blueprint for extending the schema extension with own type models and view helpers.

Requirements

The extension in the latest version supports TYPO3 v10 LTS, TYPO3 v11 LTS and TYPO3 v12. Use version 1.2 for compatibility with TYPO3 v9 LTS. It requires at least the schema extension in version 1.7.

Installation

With composer:

composer req brotkrueml/schema-virtuallocation

Usage

Using the API

$location = \Brotkrueml\Schema\Type\TypeFactory::createType('VirtualLocation');
$location->setProperty('url', 'https://example.org/join/12345');

$event = \Brotkrueml\Schema\Type\TypeFactory::createType('Event');
$event
    ->setProperty('name' 'A virtual event')
    ->setProperty('location', $location)
;

Using the View Helpers

<schema:type.event name="A virtual event">
    <schema:type.virtualLocation
        -as="location"
        url="https://example.org/join/12345"
    />
</schema:type.event>

Both cases produce the following JSON-LD ouput:

{
    "@context": "http://schema.org",
    "@type": "Event",
    "location": {
        "@type": "VirtualLocation",
        "url": "https://example.org/join/12345"
    },
    "name": "A virtual event"
}

For more information have a look into the schema documentation.