luya\web\JsonLd

Complexity

Total Complexity

24

Size/Duplication

Total Lines	293
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	23

Importance

Changes

0

22 Methods

Rating	Name	Duplication	Size	Complexity
A	article()	0	4	1
A	blogPosting()	0	4	1
A	thing()	0	4	1
A	creativeWork()	0	4	1
A	event()	0	4	1
A	liveBlogPosting()	0	4	1
A	organization()	0	4	1
A	person()	0	4	1
A	place()	0	4	1
A	socialMediaPosting()	0	4	1
A	imageObject()	0	4	1
A	aggregateRating()	0	4	1
A	rating()	0	4	1
A	comment()	0	4	1
A	contactPoint()	0	4	1
A	country()	0	4	1
A	offer()	0	4	1
A	postalAddress()	0	4	1
A	propertyValue()	0	4	1
A	addGraph()	0	13	2
A	reset()	0	5	1
A	registerView()	0	10	2

<?php

namespace luya\web;

use Yii;
use yii\helpers\Json;
use yii\base\BaseObject;
use luya\Exception;
use luya\web\jsonld\Person;
use luya\web\jsonld\Event;
use luya\web\jsonld\Place;
use luya\web\jsonld\LiveBlogPosting;
use luya\web\jsonld\Article;
use luya\web\jsonld\BlogPosting;
use luya\web\jsonld\CreativeWork;
use luya\web\jsonld\Organization;
use luya\web\jsonld\SocialMediaPosting;
use luya\web\jsonld\Thing;
use luya\web\jsonld\ImageObject;
use luya\web\jsonld\AggregateRating;
use luya\web\jsonld\Rating;
use luya\web\jsonld\Comment;
use luya\web\jsonld\ContactPoint;
use luya\web\jsonld\Country;
use luya\web\jsonld\Offer;
use luya\web\jsonld\PostalAddress;
use luya\web\jsonld\PropertyValue;

/**
 * Registerin Microdata as JsonLD.
 *
 * In order to register a json ld tag just call:
 *
 * ```php
 * JsonLd::person()
 *    ->setGivenName('Albert')
 *    ->setFamilyName('Einstein')
 *    ->setBirthPlace('Ulm, Germany');
 * ```
 *
 * Or any other tags. This will register the json ld output into the layout file of the view.
 *
 * @see https://schema.org/docs/schemas.html
 * @author Basil Suter <basil@nadar.io>
 * @since 1.0.0
 */
class JsonLd extends BaseObject
{
    /**
     * Register new Article.
     *
     * An article, such as a news article or piece of investigative report.
     * Newspapers and magazines have articles of many different types and this is intended to cover them all.
     *
     * @param array $config Optional config array to provided article data via setter methods.
     * @return \luya\web\jsonld\Article
     * @since 1.0.1
     */
    public static function article(array $config = [])
    {
        return self::addGraph((new Article($config)));

The expression self::addGraph(new \luya\web\jsonld\Article($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 61 which is incompatible with the return type documented by luya\web\JsonLd::article of type luya\web\jsonld\Article.

    }

    /**
     * Register new Blog Posting.
     *
     * @param array $config Optional config array to provided blog posting data via setter methods.
     * @return \luya\web\jsonld\BlogPosting
     * @since 1.0.1
     */
    public static function blogPosting(array $config = [])
    {
        return self::addGraph((new BlogPosting($config)));

The expression self::addGraph(new \luya\web\jsonld\BlogPosting($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 73 which is incompatible with the return type documented by luya\web\JsonLd::blogPosting of type luya\web\jsonld\BlogPosting.

    }

    /**
     * Register new Thing.
     *
     * @param array $config Optional config array to provided person data via setter methods.
     * @return \luya\web\jsonld\Thing
     */
    public static function thing(array $config = [])
    {
        return self::addGraph((new Thing($config)));

The expression self::addGraph(new \luya\web\jsonld\Thing($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 84 which is incompatible with the return type documented by luya\web\JsonLd::thing of type luya\web\jsonld\Thing.

    }

    /**
     * Register new CreativeWork.
     *
     * The most generic kind of creative work, including books, movies, photographs, software programs, etc.
     *
     * @param array $config Optional config array to provided creative work data via setter methods.
     * @return \luya\web\jsonld\CreativeWork
     * @since 1.0.1
     */
    public static function creativeWork(array $config = [])
    {
        return self::addGraph((new CreativeWork($config)));

The expression self::addGraph(new \luya\web\jsonld\CreativeWork($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 98 which is incompatible with the return type documented by luya\web\JsonLd::creativeWork of type luya\web\jsonld\CreativeWork.

    }
    
    /**
     * Register new Event.
     *
     * An event happening at a certain time and location, such as a concert, lecture, or festival.
     *
     * @param array $config
     * @return \luya\web\jsonld\Event
     */
    public static function event(array $config = [])
    {
        return self::addGraph((new Event($config)));

The expression self::addGraph(new \luya\web\jsonld\Event($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 111 which is incompatible with the return type documented by luya\web\JsonLd::event of type luya\web\jsonld\Event.

    }

    /**
     * Register new Live Blog Posting.
     *
     * A blog post intended to provide a rolling textual coverage of an ongoing event through continuous updates.
     *
     * @param array $config Optional config array to provided live blog posting data via setter methods.
     * @return \luya\web\jsonld\LiveBlogPosting
     * @since 1.0.1
     */
    public static function liveBlogPosting(array $config = [])
    {
        return self::addGraph((new LiveBlogPosting($config)));

The expression self::addGraph(new \luya\web\jsonld\LiveBlogPosting($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 125 which is incompatible with the return type documented by luya\web\JsonLd::liveBlogPosting of type luya\web\jsonld\LiveBlogPosting.

    }

    /**
     * Register new Organization.
     *
     * An organization such as a school, NGO, corporation, club, etc.
     *
     * @param array $config Optional config array to provided organization data via setter methods.
     * @return \luya\web\jsonld\Organization
     */
    public static function organization(array $config = [])
    {
        return self::addGraph((new Organization($config)));

The expression self::addGraph(new \luya\web\jsonld\Organization($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 138 which is incompatible with the return type documented by luya\web\JsonLd::organization of type luya\web\jsonld\Organization.

    }
    
    /**
     * Register new Person.
     *
     * A person (alive, dead, undead, or fictional).
     *
     * @param array $config Optional config array to provided person data via setter methods.
     * @return \luya\web\jsonld\Person
     */
    public static function person(array $config = [])
    {
        return self::addGraph((new Person($config)));

The expression self::addGraph(new \luya\web\jsonld\Person($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 151 which is incompatible with the return type documented by luya\web\JsonLd::person of type luya\web\jsonld\Person.

    }

    /**
     * Register new Place
     *
     * Entities that have a somewhat fixed, physical extension.
     *
     * @param array $config Optional config array to provided place data via setter methods.
     * @return \luya\web\jsonld\Place
     */
    public static function place(array $config = [])
    {
        return self::addGraph((new Place($config)));

The expression self::addGraph(new \luya\web\jsonld\Place($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 164 which is incompatible with the return type documented by luya\web\JsonLd::place of type luya\web\jsonld\Place.

    }

    /**
     * Register new Social Media Posting.
     *
     * A post to a social media platform, including blog posts, tweets, Facebook posts, etc.
     *
     * @param array $config Optional config array to provided social media posting data via setter methods.
     * @return \luya\web\jsonld\SocialMediaPosting
     * @since 1.0.1
     */
    public static function socialMediaPosting(array $config = [])
    {
        return self::addGraph((new SocialMediaPosting($config)));

The expression self::addGraph(new \luya\web\jsonld\SocialMediaPosting($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 178 which is incompatible with the return type documented by luya\web\JsonLd::socialMediaPosting of type luya\web\jsonld\SocialMediaPosting.

    }

    /**
     * Register new Image Object.
     *
     * @param array $config
     * @return \luya\web\jsonld\ImageObject
     * @since 1.0.3
     */
    public static function imageObject(array $config = [])
    {
        return self::addGraph((new ImageObject($config)));

The expression self::addGraph(new \luya\web\jsonld\ImageObject($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 190 which is incompatible with the return type documented by luya\web\JsonLd::imageObject of type luya\web\jsonld\ImageObject.

    }
    
    /**
     * Register new Aggregated Rating.
     *
     * @param array $config
     * @return \luya\web\jsonld\AggregateRating
     * @since 1.0.3
     */
    public static function aggregateRating(array $config = [])
    {
        return self::addGraph((new AggregateRating($config)));

The expression self::addGraph(new \luya\web\jsonld\AggregateRating($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 202 which is incompatible with the return type documented by luya\web\JsonLd::aggregateRating of type luya\web\jsonld\AggregateRating.

    }

    /**
     * Register new Rating.
     *
     * @param array $config
     * @return \luya\web\jsonld\Rating
     * @since 1.0.3
     */
    public static function rating(array $config = [])
    {
        return self::addGraph((new Rating($config)));

The expression self::addGraph(new \luya\web\jsonld\Rating($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 214 which is incompatible with the return type documented by luya\web\JsonLd::rating of type luya\web\jsonld\Rating.

    }
    
    /**
     * Register new Comment.
     *
     * @param array $config
     * @return \luya\web\jsonld\Comment
     * @since 1.0.3
     */
    public static function comment(array $config = [])
    {
        return self::addGraph((new Comment($config)));

The expression self::addGraph(new \luya\web\jsonld\Comment($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 226 which is incompatible with the return type documented by luya\web\JsonLd::comment of type luya\web\jsonld\Comment.

    }
    
    /**
     * Register new Contact Point.
     *
     * This is mainly used for addresses or user coordinates like email, telephone etc.
     *
     * @param array $config
     * @return \luya\web\jsonld\ContactPoint
     * @since 1.0.3
     */
    public static function contactPoint(array $config = [])
    {
        return self::addGraph((new ContactPoint($config)));

The expression self::addGraph(new \luya\web\jsonld\ContactPoint($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 240 which is incompatible with the return type documented by luya\web\JsonLd::contactPoint of type luya\web\jsonld\ContactPoint.

    }
    
    /**
     * Register new Country.
     *
     * @param array $config
     * @return \luya\web\jsonld\Country
     * @since 1.0.3
     */
    public static function country(array $config = [])
    {
        return self::addGraph((new Country($config)));

The expression self::addGraph(new \luya\web\jsonld\Country($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 252 which is incompatible with the return type documented by luya\web\JsonLd::country of type luya\web\jsonld\Country.

    }

    /**
     * Register new Offer.
     *
     * This is used for selling products.
     *
     * @param array $config
     * @return \luya\web\jsonld\Offer
     * @since 1.0.3
     */
    public static function offer(array $config = [])
    {
        return self::addGraph((new Offer($config)));

The expression self::addGraph(new \luya\web\jsonld\Offer($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 266 which is incompatible with the return type documented by luya\web\JsonLd::offer of type luya\web\jsonld\Offer.

    }
    
    /**
     * Register new Postal Address.
     *
     * @param array $config
     * @return \luya\web\jsonld\PostalAddress
     * @since 1.0.3
     */
    public static function postalAddress(array $config = [])

The parameter $config is not used and could be removed.

    {
        return self::addGraph((new PostalAddress()));

The expression self::addGraph(new \luya\web\jsonld\PostalAddress()); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 278 which is incompatible with the return type documented by luya\web\JsonLd::postalAddress of type luya\web\jsonld\PostalAddress.

    }
    
    /**
     * Register new Property Value.
     *
     * @param array $config
     * @return \luya\web\jsonld\PropertyValue
     * @since 1.0.3
     */
    public static function propertyValue(array $config = [])
    {
        return self::addGraph((new PropertyValue($config)));

The expression self::addGraph(new \luya\web\jsonld\PropertyValue($config)); of type luya\web\jsonld\BaseThing|array adds the type array to the return on line 290 which is incompatible with the return type documented by luya\web\JsonLd::propertyValue of type luya\web\jsonld\PropertyValue.

    }
    
    /**
     * Register graph data.
     *
     * @param \luya\web\jsonld\BaseThing|array $data Can be either an array or an object based on {{luya\web\jsonld\BaseThing}} which contains the Arrayable Inteface.
     * @return array|object
     */
    public static function addGraph($data)
    {
        self::registerView();
        
        if (is_scalar($data)) {
            throw new Exception("Data must be either an array or an object of type luya\web\jsonld\BaseThing.");
        }
        
        Yii::$app->view->params['@context'] = 'https://schema.org';
        Yii::$app->view->params['@graph'][] = $data;
        
        return $data;
    }
    
    /**
     * Reset the JsonLd Data.
     *
     * This method is mainly usefull when working with unit tests for JsonLd.
     */
    public static function reset()
    {
        self::$_view = null;
        Yii::$app->view->params['@graph'] = [];
    }
    
    private static $_view;
    
    /**
     * Register the view file an observe the event which then reads the data from @graph params key.
     */
    protected static function registerView()
    {
        if (self::$_view === null) {
            Yii::$app->view->on(View::EVENT_BEGIN_BODY, function ($event) {
                echo '<script type="application/ld+json">' . Json::encode($event->sender->params) . '</script>';
            });
                    
            self::$_view = true;
        }
    }
}