vendor/spatie/schema-org/src/WebPage.php line 19

Open in your IDE?
  1. <?php
  3. namespace Spatie\SchemaOrg;
  5. use \Spatie\SchemaOrg\Contracts\WebPageContract;
  6. use \Spatie\SchemaOrg\Contracts\CreativeWorkContract;
  7. use \Spatie\SchemaOrg\Contracts\ThingContract;
  9. /**
  10.  * A web page. Every web page is implicitly assumed to be declared to be of type
  11.  * WebPage, so the various properties about that webpage, such as
  12.  * ```breadcrumb``` may be used. We recommend explicit declaration if these
  13.  * properties are specified, but if they are found outside of an itemscope, they
  14.  * will be assumed to be about the page.
  15.  *
  16.  * @see https://schema.org/WebPage
  17.  *
  18.  */
  19. class WebPage extends BaseType implements WebPageContract, CreativeWorkContract, ThingContract
  20. {
  21.     /**
  22.      * The subject matter of the content.
  23.      *
  24.      * @param \Spatie\SchemaOrg\Contracts\ThingContract|\Spatie\SchemaOrg\Contracts\ThingContract[] $about
  25.      *
  26.      * @return static
  27.      *
  28.      * @see https://schema.org/about
  29.      * @link https://github.com/schemaorg/schemaorg/issues/1670
  30.      */
  31.     public function about($about)
  32.     {
  33.         return $this->setProperty('about', $about);
  34.     }
  36.     /**
  37.      * An abstract is a short description that summarizes a [[CreativeWork]].
  38.      *
  39.      * @param string|string[] $abstract
  40.      *
  41.      * @return static
  42.      *
  43.      * @see https://schema.org/abstract
  44.      * @see https://pending.schema.org
  45.      * @link https://github.com/schemaorg/schemaorg/issues/276
  46.      */
  47.     public function abstract($abstract)
  48.     {
  49.         return $this->setProperty('abstract', $abstract);
  50.     }
  52.     /**
  53.      * The human sensory perceptual system or cognitive faculty through which a
  54.      * person may process or perceive information. Expected values include:
  55.      * auditory, tactile, textual, visual, colorDependent, chartOnVisual,
  56.      * chemOnVisual, diagramOnVisual, mathOnVisual, musicOnVisual, textOnVisual.
  57.      *
  58.      * @param string|string[] $accessMode
  59.      *
  60.      * @return static
  61.      *
  62.      * @see https://schema.org/accessMode
  63.      * @link https://github.com/schemaorg/schemaorg/issues/1100
  64.      */
  65.     public function accessMode($accessMode)
  66.     {
  67.         return $this->setProperty('accessMode', $accessMode);
  68.     }
  70.     /**
  71.      * A list of single or combined accessModes that are sufficient to
  72.      * understand all the intellectual content of a resource. Expected values
  73.      * include:  auditory, tactile, textual, visual.
  74.      *
  75.      * @param \Spatie\SchemaOrg\Contracts\ItemListContract|\Spatie\SchemaOrg\Contracts\ItemListContract[] $accessModeSufficient
  76.      *
  77.      * @return static
  78.      *
  79.      * @see https://schema.org/accessModeSufficient
  80.      * @link https://github.com/schemaorg/schemaorg/issues/1100
  81.      */
  82.     public function accessModeSufficient($accessModeSufficient)
  83.     {
  84.         return $this->setProperty('accessModeSufficient', $accessModeSufficient);
  85.     }
  87.     /**
  88.      * Indicates that the resource is compatible with the referenced
  89.      * accessibility API ([WebSchemas wiki lists possible
  90.      * values](http://www.w3.org/wiki/WebSchemas/Accessibility)).
  91.      *
  92.      * @param string|string[] $accessibilityAPI
  93.      *
  94.      * @return static
  95.      *
  96.      * @see https://schema.org/accessibilityAPI
  97.      */
  98.     public function accessibilityAPI($accessibilityAPI)
  99.     {
  100.         return $this->setProperty('accessibilityAPI', $accessibilityAPI);
  101.     }
  103.     /**
  104.      * Identifies input methods that are sufficient to fully control the
  105.      * described resource ([WebSchemas wiki lists possible
  106.      * values](http://www.w3.org/wiki/WebSchemas/Accessibility)).
  107.      *
  108.      * @param string|string[] $accessibilityControl
  109.      *
  110.      * @return static
  111.      *
  112.      * @see https://schema.org/accessibilityControl
  113.      */
  114.     public function accessibilityControl($accessibilityControl)
  115.     {
  116.         return $this->setProperty('accessibilityControl', $accessibilityControl);
  117.     }
  119.     /**
  120.      * Content features of the resource, such as accessible media, alternatives
  121.      * and supported enhancements for accessibility ([WebSchemas wiki lists
  122.      * possible values](http://www.w3.org/wiki/WebSchemas/Accessibility)).
  123.      *
  124.      * @param string|string[] $accessibilityFeature
  125.      *
  126.      * @return static
  127.      *
  128.      * @see https://schema.org/accessibilityFeature
  129.      */
  130.     public function accessibilityFeature($accessibilityFeature)
  131.     {
  132.         return $this->setProperty('accessibilityFeature', $accessibilityFeature);
  133.     }
  135.     /**
  136.      * A characteristic of the described resource that is physiologically
  137.      * dangerous to some users. Related to WCAG 2.0 guideline 2.3 ([WebSchemas
  138.      * wiki lists possible
  139.      * values](http://www.w3.org/wiki/WebSchemas/Accessibility)).
  140.      *
  141.      * @param string|string[] $accessibilityHazard
  142.      *
  143.      * @return static
  144.      *
  145.      * @see https://schema.org/accessibilityHazard
  146.      */
  147.     public function accessibilityHazard($accessibilityHazard)
  148.     {
  149.         return $this->setProperty('accessibilityHazard', $accessibilityHazard);
  150.     }
  152.     /**
  153.      * A human-readable summary of specific accessibility features or
  154.      * deficiencies, consistent with the other accessibility metadata but
  155.      * expressing subtleties such as "short descriptions are present but long
  156.      * descriptions will be needed for non-visual users" or "short descriptions
  157.      * are present and no long descriptions are needed."
  158.      *
  159.      * @param string|string[] $accessibilitySummary
  160.      *
  161.      * @return static
  162.      *
  163.      * @see https://schema.org/accessibilitySummary
  164.      * @link https://github.com/schemaorg/schemaorg/issues/1100
  165.      */
  166.     public function accessibilitySummary($accessibilitySummary)
  167.     {
  168.         return $this->setProperty('accessibilitySummary', $accessibilitySummary);
  169.     }
  171.     /**
  172.      * Specifies the Person that is legally accountable for the CreativeWork.
  173.      *
  174.      * @param \Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $accountablePerson
  175.      *
  176.      * @return static
  177.      *
  178.      * @see https://schema.org/accountablePerson
  179.      */
  180.     public function accountablePerson($accountablePerson)
  181.     {
  182.         return $this->setProperty('accountablePerson', $accountablePerson);
  183.     }
  185.     /**
  186.      * Indicates a page documenting how licenses can be purchased or otherwise
  187.      * acquired, for the current item.
  188.      *
  189.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $acquireLicensePage
  190.      *
  191.      * @return static
  192.      *
  193.      * @see https://schema.org/acquireLicensePage
  194.      * @see https://pending.schema.org
  195.      * @link https://github.com/schemaorg/schemaorg/issues/2454
  196.      */
  197.     public function acquireLicensePage($acquireLicensePage)
  198.     {
  199.         return $this->setProperty('acquireLicensePage', $acquireLicensePage);
  200.     }
  202.     /**
  203.      * An additional type for the item, typically used for adding more specific
  204.      * types from external vocabularies in microdata syntax. This is a
  205.      * relationship between something and a class that the thing is in. In RDFa
  206.      * syntax, it is better to use the native RDFa syntax - the 'typeof'
  207.      * attribute - for multiple types. Schema.org tools may have only weaker
  208.      * understanding of extra types, in particular those defined externally.
  209.      *
  210.      * @param string|string[] $additionalType
  211.      *
  212.      * @return static
  213.      *
  214.      * @see https://schema.org/additionalType
  215.      */
  216.     public function additionalType($additionalType)
  217.     {
  218.         return $this->setProperty('additionalType', $additionalType);
  219.     }
  221.     /**
  222.      * The overall rating, based on a collection of reviews or ratings, of the
  223.      * item.
  224.      *
  225.      * @param \Spatie\SchemaOrg\Contracts\AggregateRatingContract|\Spatie\SchemaOrg\Contracts\AggregateRatingContract[] $aggregateRating
  226.      *
  227.      * @return static
  228.      *
  229.      * @see https://schema.org/aggregateRating
  230.      */
  231.     public function aggregateRating($aggregateRating)
  232.     {
  233.         return $this->setProperty('aggregateRating', $aggregateRating);
  234.     }
  236.     /**
  237.      * An alias for the item.
  238.      *
  239.      * @param string|string[] $alternateName
  240.      *
  241.      * @return static
  242.      *
  243.      * @see https://schema.org/alternateName
  244.      */
  245.     public function alternateName($alternateName)
  246.     {
  247.         return $this->setProperty('alternateName', $alternateName);
  248.     }
  250.     /**
  251.      * A secondary title of the CreativeWork.
  252.      *
  253.      * @param string|string[] $alternativeHeadline
  254.      *
  255.      * @return static
  256.      *
  257.      * @see https://schema.org/alternativeHeadline
  258.      */
  259.     public function alternativeHeadline($alternativeHeadline)
  260.     {
  261.         return $this->setProperty('alternativeHeadline', $alternativeHeadline);
  262.     }
  264.     /**
  265.      * Indicates a page or other link involved in archival of a
  266.      * [[CreativeWork]]. In the case of [[MediaReview]], the items in a
  267.      * [[MediaReviewItem]] may often become inaccessible, but be archived by
  268.      * archival, journalistic, activist, or law enforcement organizations. In
  269.      * such cases, the referenced page may not directly publish the content.
  270.      *
  271.      * @param \Spatie\SchemaOrg\Contracts\WebPageContract|\Spatie\SchemaOrg\Contracts\WebPageContract[]|string|string[] $archivedAt
  272.      *
  273.      * @return static
  274.      *
  275.      * @see https://schema.org/archivedAt
  276.      * @see https://pending.schema.org
  277.      * @link https://github.com/schemaorg/schemaorg/issues/2450
  278.      */
  279.     public function archivedAt($archivedAt)
  280.     {
  281.         return $this->setProperty('archivedAt', $archivedAt);
  282.     }
  284.     /**
  285.      * The item being described is intended to assess the competency or learning
  286.      * outcome defined by the referenced term.
  287.      *
  288.      * @param \Spatie\SchemaOrg\Contracts\DefinedTermContract|\Spatie\SchemaOrg\Contracts\DefinedTermContract[]|string|string[] $assesses
  289.      *
  290.      * @return static
  291.      *
  292.      * @see https://schema.org/assesses
  293.      * @see https://pending.schema.org
  294.      * @link https://github.com/schemaorg/schemaorg/issues/2427
  295.      */
  296.     public function assesses($assesses)
  297.     {
  298.         return $this->setProperty('assesses', $assesses);
  299.     }
  301.     /**
  302.      * A media object that encodes this CreativeWork. This property is a synonym
  303.      * for encoding.
  304.      *
  305.      * @param \Spatie\SchemaOrg\Contracts\MediaObjectContract|\Spatie\SchemaOrg\Contracts\MediaObjectContract[] $associatedMedia
  306.      *
  307.      * @return static
  308.      *
  309.      * @see https://schema.org/associatedMedia
  310.      */
  311.     public function associatedMedia($associatedMedia)
  312.     {
  313.         return $this->setProperty('associatedMedia', $associatedMedia);
  314.     }
  316.     /**
  317.      * An intended audience, i.e. a group for whom something was created.
  318.      *
  319.      * @param \Spatie\SchemaOrg\Contracts\AudienceContract|\Spatie\SchemaOrg\Contracts\AudienceContract[] $audience
  320.      *
  321.      * @return static
  322.      *
  323.      * @see https://schema.org/audience
  324.      */
  325.     public function audience($audience)
  326.     {
  327.         return $this->setProperty('audience', $audience);
  328.     }
  330.     /**
  331.      * An embedded audio object.
  332.      *
  333.      * @param \Spatie\SchemaOrg\Contracts\AudioObjectContract|\Spatie\SchemaOrg\Contracts\AudioObjectContract[]|\Spatie\SchemaOrg\Contracts\ClipContract|\Spatie\SchemaOrg\Contracts\ClipContract[]|\Spatie\SchemaOrg\Contracts\MusicRecordingContract|\Spatie\SchemaOrg\Contracts\MusicRecordingContract[] $audio
  334.      *
  335.      * @return static
  336.      *
  337.      * @see https://schema.org/audio
  338.      * @link https://github.com/schemaorg/schemaorg/issues/2420
  339.      */
  340.     public function audio($audio)
  341.     {
  342.         return $this->setProperty('audio', $audio);
  343.     }
  345.     /**
  346.      * The author of this content or rating. Please note that author is special
  347.      * in that HTML 5 provides a special mechanism for indicating authorship via
  348.      * the rel tag. That is equivalent to this and may be used interchangeably.
  349.      *
  350.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $author
  351.      *
  352.      * @return static
  353.      *
  354.      * @see https://schema.org/author
  355.      */
  356.     public function author($author)
  357.     {
  358.         return $this->setProperty('author', $author);
  359.     }
  361.     /**
  362.      * An award won by or for this item.
  363.      *
  364.      * @param string|string[] $award
  365.      *
  366.      * @return static
  367.      *
  368.      * @see https://schema.org/award
  369.      */
  370.     public function award($award)
  371.     {
  372.         return $this->setProperty('award', $award);
  373.     }
  375.     /**
  376.      * Awards won by or for this item.
  377.      *
  378.      * @param string|string[] $awards
  379.      *
  380.      * @return static
  381.      *
  382.      * @see https://schema.org/awards
  383.      */
  384.     public function awards($awards)
  385.     {
  386.         return $this->setProperty('awards', $awards);
  387.     }
  389.     /**
  390.      * A set of links that can help a user understand and navigate a website
  391.      * hierarchy.
  392.      *
  393.      * @param \Spatie\SchemaOrg\Contracts\BreadcrumbListContract|\Spatie\SchemaOrg\Contracts\BreadcrumbListContract[]|string|string[] $breadcrumb
  394.      *
  395.      * @return static
  396.      *
  397.      * @see https://schema.org/breadcrumb
  398.      */
  399.     public function breadcrumb($breadcrumb)
  400.     {
  401.         return $this->setProperty('breadcrumb', $breadcrumb);
  402.     }
  404.     /**
  405.      * Fictional person connected with a creative work.
  406.      *
  407.      * @param \Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $character
  408.      *
  409.      * @return static
  410.      *
  411.      * @see https://schema.org/character
  412.      */
  413.     public function character($character)
  414.     {
  415.         return $this->setProperty('character', $character);
  416.     }
  418.     /**
  419.      * A citation or reference to another creative work, such as another
  420.      * publication, web page, scholarly article, etc.
  421.      *
  422.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $citation
  423.      *
  424.      * @return static
  425.      *
  426.      * @see https://schema.org/citation
  427.      */
  428.     public function citation($citation)
  429.     {
  430.         return $this->setProperty('citation', $citation);
  431.     }
  433.     /**
  434.      * Comments, typically from users.
  435.      *
  436.      * @param \Spatie\SchemaOrg\Contracts\CommentContract|\Spatie\SchemaOrg\Contracts\CommentContract[] $comment
  437.      *
  438.      * @return static
  439.      *
  440.      * @see https://schema.org/comment
  441.      */
  442.     public function comment($comment)
  443.     {
  444.         return $this->setProperty('comment', $comment);
  445.     }
  447.     /**
  448.      * The number of comments this CreativeWork (e.g. Article, Question or
  449.      * Answer) has received. This is most applicable to works published in Web
  450.      * sites with commenting system; additional comments may exist elsewhere.
  451.      *
  452.      * @param int|int[] $commentCount
  453.      *
  454.      * @return static
  455.      *
  456.      * @see https://schema.org/commentCount
  457.      */
  458.     public function commentCount($commentCount)
  459.     {
  460.         return $this->setProperty('commentCount', $commentCount);
  461.     }
  463.     /**
  464.      * Conditions that affect the availability of, or method(s) of access to, an
  465.      * item. Typically used for real world items such as an [[ArchiveComponent]]
  466.      * held by an [[ArchiveOrganization]]. This property is not suitable for use
  467.      * as a general Web access control mechanism. It is expressed only in
  468.      * natural language.
  469.      * 
  470.      * For example "Available by appointment from the Reading Room" or
  471.      * "Accessible only from logged-in accounts ".
  472.      *
  473.      * @param string|string[] $conditionsOfAccess
  474.      *
  475.      * @return static
  476.      *
  477.      * @see https://schema.org/conditionsOfAccess
  478.      * @see https://pending.schema.org
  479.      * @link https://github.com/schemaorg/schemaorg/issues/2173
  480.      */
  481.     public function conditionsOfAccess($conditionsOfAccess)
  482.     {
  483.         return $this->setProperty('conditionsOfAccess', $conditionsOfAccess);
  484.     }
  486.     /**
  487.      * The location depicted or described in the content. For example, the
  488.      * location in a photograph or painting.
  489.      *
  490.      * @param \Spatie\SchemaOrg\Contracts\PlaceContract|\Spatie\SchemaOrg\Contracts\PlaceContract[] $contentLocation
  491.      *
  492.      * @return static
  493.      *
  494.      * @see https://schema.org/contentLocation
  495.      */
  496.     public function contentLocation($contentLocation)
  497.     {
  498.         return $this->setProperty('contentLocation', $contentLocation);
  499.     }
  501.     /**
  502.      * Official rating of a piece of content&#x2014;for example,'MPAA PG-13'.
  503.      *
  504.      * @param \Spatie\SchemaOrg\Contracts\RatingContract|\Spatie\SchemaOrg\Contracts\RatingContract[]|string|string[] $contentRating
  505.      *
  506.      * @return static
  507.      *
  508.      * @see https://schema.org/contentRating
  509.      */
  510.     public function contentRating($contentRating)
  511.     {
  512.         return $this->setProperty('contentRating', $contentRating);
  513.     }
  515.     /**
  516.      * The specific time described by a creative work, for works (e.g. articles,
  517.      * video objects etc.) that emphasise a particular moment within an Event.
  518.      *
  519.      * @param \DateTimeInterface|\DateTimeInterface[] $contentReferenceTime
  520.      *
  521.      * @return static
  522.      *
  523.      * @see https://schema.org/contentReferenceTime
  524.      * @see https://pending.schema.org
  525.      * @link https://github.com/schemaorg/schemaorg/issues/1050
  526.      */
  527.     public function contentReferenceTime($contentReferenceTime)
  528.     {
  529.         return $this->setProperty('contentReferenceTime', $contentReferenceTime);
  530.     }
  532.     /**
  533.      * A secondary contributor to the CreativeWork or Event.
  534.      *
  535.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $contributor
  536.      *
  537.      * @return static
  538.      *
  539.      * @see https://schema.org/contributor
  540.      */
  541.     public function contributor($contributor)
  542.     {
  543.         return $this->setProperty('contributor', $contributor);
  544.     }
  546.     /**
  547.      * The party holding the legal copyright to the CreativeWork.
  548.      *
  549.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $copyrightHolder
  550.      *
  551.      * @return static
  552.      *
  553.      * @see https://schema.org/copyrightHolder
  554.      */
  555.     public function copyrightHolder($copyrightHolder)
  556.     {
  557.         return $this->setProperty('copyrightHolder', $copyrightHolder);
  558.     }
  560.     /**
  561.      * Text of a notice appropriate for describing the copyright aspects of this
  562.      * Creative Work, ideally indicating the owner of the copyright for the
  563.      * Work.
  564.      *
  565.      * @param string|string[] $copyrightNotice
  566.      *
  567.      * @return static
  568.      *
  569.      * @see https://schema.org/copyrightNotice
  570.      * @see https://pending.schema.org
  571.      * @link https://github.com/schemaorg/schemaorg/issues/2659
  572.      */
  573.     public function copyrightNotice($copyrightNotice)
  574.     {
  575.         return $this->setProperty('copyrightNotice', $copyrightNotice);
  576.     }
  578.     /**
  579.      * The year during which the claimed copyright for the CreativeWork was
  580.      * first asserted.
  581.      *
  582.      * @param float|float[]|int|int[] $copyrightYear
  583.      *
  584.      * @return static
  585.      *
  586.      * @see https://schema.org/copyrightYear
  587.      */
  588.     public function copyrightYear($copyrightYear)
  589.     {
  590.         return $this->setProperty('copyrightYear', $copyrightYear);
  591.     }
  593.     /**
  594.      * Indicates a correction to a [[CreativeWork]], either via a
  595.      * [[CorrectionComment]], textually or in another document.
  596.      *
  597.      * @param \Spatie\SchemaOrg\Contracts\CorrectionCommentContract|\Spatie\SchemaOrg\Contracts\CorrectionCommentContract[]|string|string[] $correction
  598.      *
  599.      * @return static
  600.      *
  601.      * @see https://schema.org/correction
  602.      * @see https://pending.schema.org
  603.      */
  604.     public function correction($correction)
  605.     {
  606.         return $this->setProperty('correction', $correction);
  607.     }
  609.     /**
  610.      * The country of origin of something, including products as well as
  611.      * creative  works such as movie and TV content.
  612.      * 
  613.      * In the case of TV and movie, this would be the country of the principle
  614.      * offices of the production company or individual responsible for the
  615.      * movie. For other kinds of [[CreativeWork]] it is difficult to provide
  616.      * fully general guidance, and properties such as [[contentLocation]] and
  617.      * [[locationCreated]] may be more applicable.
  618.      * 
  619.      * In the case of products, the country of origin of the product. The exact
  620.      * interpretation of this may vary by context and product type, and cannot
  621.      * be fully enumerated here.
  622.      *
  623.      * @param \Spatie\SchemaOrg\Contracts\CountryContract|\Spatie\SchemaOrg\Contracts\CountryContract[] $countryOfOrigin
  624.      *
  625.      * @return static
  626.      *
  627.      * @see https://schema.org/countryOfOrigin
  628.      */
  629.     public function countryOfOrigin($countryOfOrigin)
  630.     {
  631.         return $this->setProperty('countryOfOrigin', $countryOfOrigin);
  632.     }
  634.     /**
  635.      * The status of a creative work in terms of its stage in a lifecycle.
  636.      * Example terms include Incomplete, Draft, Published, Obsolete. Some
  637.      * organizations define a set of terms for the stages of their publication
  638.      * lifecycle.
  639.      *
  640.      * @param \Spatie\SchemaOrg\Contracts\DefinedTermContract|\Spatie\SchemaOrg\Contracts\DefinedTermContract[]|string|string[] $creativeWorkStatus
  641.      *
  642.      * @return static
  643.      *
  644.      * @see https://schema.org/creativeWorkStatus
  645.      * @see https://pending.schema.org
  646.      * @link https://github.com/schemaorg/schemaorg/issues/987
  647.      */
  648.     public function creativeWorkStatus($creativeWorkStatus)
  649.     {
  650.         return $this->setProperty('creativeWorkStatus', $creativeWorkStatus);
  651.     }
  653.     /**
  654.      * The creator/author of this CreativeWork. This is the same as the Author
  655.      * property for CreativeWork.
  656.      *
  657.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $creator
  658.      *
  659.      * @return static
  660.      *
  661.      * @see https://schema.org/creator
  662.      */
  663.     public function creator($creator)
  664.     {
  665.         return $this->setProperty('creator', $creator);
  666.     }
  668.     /**
  669.      * Text that can be used to credit person(s) and/or organization(s)
  670.      * associated with a published Creative Work.
  671.      *
  672.      * @param string|string[] $creditText
  673.      *
  674.      * @return static
  675.      *
  676.      * @see https://schema.org/creditText
  677.      * @see https://pending.schema.org
  678.      * @link https://github.com/schemaorg/schemaorg/issues/2659
  679.      */
  680.     public function creditText($creditText)
  681.     {
  682.         return $this->setProperty('creditText', $creditText);
  683.     }
  685.     /**
  686.      * The date on which the CreativeWork was created or the item was added to a
  687.      * DataFeed.
  688.      *
  689.      * @param \DateTimeInterface|\DateTimeInterface[] $dateCreated
  690.      *
  691.      * @return static
  692.      *
  693.      * @see https://schema.org/dateCreated
  694.      */
  695.     public function dateCreated($dateCreated)
  696.     {
  697.         return $this->setProperty('dateCreated', $dateCreated);
  698.     }
  700.     /**
  701.      * The date on which the CreativeWork was most recently modified or when the
  702.      * item's entry was modified within a DataFeed.
  703.      *
  704.      * @param \DateTimeInterface|\DateTimeInterface[] $dateModified
  705.      *
  706.      * @return static
  707.      *
  708.      * @see https://schema.org/dateModified
  709.      */
  710.     public function dateModified($dateModified)
  711.     {
  712.         return $this->setProperty('dateModified', $dateModified);
  713.     }
  715.     /**
  716.      * Date of first broadcast/publication.
  717.      *
  718.      * @param \DateTimeInterface|\DateTimeInterface[] $datePublished
  719.      *
  720.      * @return static
  721.      *
  722.      * @see https://schema.org/datePublished
  723.      */
  724.     public function datePublished($datePublished)
  725.     {
  726.         return $this->setProperty('datePublished', $datePublished);
  727.     }
  729.     /**
  730.      * A description of the item.
  731.      *
  732.      * @param string|string[] $description
  733.      *
  734.      * @return static
  735.      *
  736.      * @see https://schema.org/description
  737.      */
  738.     public function description($description)
  739.     {
  740.         return $this->setProperty('description', $description);
  741.     }
  743.     /**
  744.      * A sub property of description. A short description of the item used to
  745.      * disambiguate from other, similar items. Information from other properties
  746.      * (in particular, name) may be necessary for the description to be useful
  747.      * for disambiguation.
  748.      *
  749.      * @param string|string[] $disambiguatingDescription
  750.      *
  751.      * @return static
  752.      *
  753.      * @see https://schema.org/disambiguatingDescription
  754.      */
  755.     public function disambiguatingDescription($disambiguatingDescription)
  756.     {
  757.         return $this->setProperty('disambiguatingDescription', $disambiguatingDescription);
  758.     }
  760.     /**
  761.      * A link to the page containing the comments of the CreativeWork.
  762.      *
  763.      * @param string|string[] $discussionUrl
  764.      *
  765.      * @return static
  766.      *
  767.      * @see https://schema.org/discussionUrl
  768.      */
  769.     public function discussionUrl($discussionUrl)
  770.     {
  771.         return $this->setProperty('discussionUrl', $discussionUrl);
  772.     }
  774.     /**
  775.      * An [EIDR](https://eidr.org/) (Entertainment Identifier Registry)
  776.      * [[identifier]] representing a specific edit / edition for a work of film
  777.      * or television.
  778.      * 
  779.      * For example, the motion picture known as "Ghostbusters" whose
  780.      * [[titleEIDR]] is "10.5240/7EC7-228A-510A-053E-CBB8-J", has several edits
  781.      * e.g. "10.5240/1F2A-E1C5-680A-14C6-E76B-I" and
  782.      * "10.5240/8A35-3BEE-6497-5D12-9E4F-3".
  783.      * 
  784.      * Since schema.org types like [[Movie]] and [[TVEpisode]] can be used for
  785.      * both works and their multiple expressions, it is possible to use
  786.      * [[titleEIDR]] alone (for a general description), or alongside
  787.      * [[editEIDR]] for a more edit-specific description.
  788.      *
  789.      * @param string|string[] $editEIDR
  790.      *
  791.      * @return static
  792.      *
  793.      * @see https://schema.org/editEIDR
  794.      * @see https://pending.schema.org
  795.      * @link https://github.com/schemaorg/schemaorg/issues/2469
  796.      */
  797.     public function editEIDR($editEIDR)
  798.     {
  799.         return $this->setProperty('editEIDR', $editEIDR);
  800.     }
  802.     /**
  803.      * Specifies the Person who edited the CreativeWork.
  804.      *
  805.      * @param \Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $editor
  806.      *
  807.      * @return static
  808.      *
  809.      * @see https://schema.org/editor
  810.      */
  811.     public function editor($editor)
  812.     {
  813.         return $this->setProperty('editor', $editor);
  814.     }
  816.     /**
  817.      * An alignment to an established educational framework.
  818.      * 
  819.      * This property should not be used where the nature of the alignment can be
  820.      * described using a simple property, for example to express that a resource
  821.      * [[teaches]] or [[assesses]] a competency.
  822.      *
  823.      * @param \Spatie\SchemaOrg\Contracts\AlignmentObjectContract|\Spatie\SchemaOrg\Contracts\AlignmentObjectContract[] $educationalAlignment
  824.      *
  825.      * @return static
  826.      *
  827.      * @see https://schema.org/educationalAlignment
  828.      */
  829.     public function educationalAlignment($educationalAlignment)
  830.     {
  831.         return $this->setProperty('educationalAlignment', $educationalAlignment);
  832.     }
  834.     /**
  835.      * The level in terms of progression through an educational or training
  836.      * context. Examples of educational levels include 'beginner',
  837.      * 'intermediate' or 'advanced', and formal sets of level indicators.
  838.      *
  839.      * @param \Spatie\SchemaOrg\Contracts\DefinedTermContract|\Spatie\SchemaOrg\Contracts\DefinedTermContract[]|string|string[] $educationalLevel
  840.      *
  841.      * @return static
  842.      *
  843.      * @see https://schema.org/educationalLevel
  844.      * @see https://pending.schema.org
  845.      * @link https://github.com/schemaorg/schemaorg/issues/1779
  846.      */
  847.     public function educationalLevel($educationalLevel)
  848.     {
  849.         return $this->setProperty('educationalLevel', $educationalLevel);
  850.     }
  852.     /**
  853.      * The purpose of a work in the context of education; for example,
  854.      * 'assignment', 'group work'.
  855.      *
  856.      * @param \Spatie\SchemaOrg\Contracts\DefinedTermContract|\Spatie\SchemaOrg\Contracts\DefinedTermContract[]|string|string[] $educationalUse
  857.      *
  858.      * @return static
  859.      *
  860.      * @see https://schema.org/educationalUse
  861.      */
  862.     public function educationalUse($educationalUse)
  863.     {
  864.         return $this->setProperty('educationalUse', $educationalUse);
  865.     }
  867.     /**
  868.      * A media object that encodes this CreativeWork. This property is a synonym
  869.      * for associatedMedia.
  870.      *
  871.      * @param \Spatie\SchemaOrg\Contracts\MediaObjectContract|\Spatie\SchemaOrg\Contracts\MediaObjectContract[] $encoding
  872.      *
  873.      * @return static
  874.      *
  875.      * @see https://schema.org/encoding
  876.      */
  877.     public function encoding($encoding)
  878.     {
  879.         return $this->setProperty('encoding', $encoding);
  880.     }
  882.     /**
  883.      * Media type typically expressed using a MIME format (see [IANA
  884.      * site](http://www.iana.org/assignments/media-types/media-types.xhtml) and
  885.      * [MDN
  886.      * reference](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types))
  887.      * e.g. application/zip for a SoftwareApplication binary, audio/mpeg for
  888.      * .mp3 etc.).
  889.      * 
  890.      * In cases where a [[CreativeWork]] has several media type representations,
  891.      * [[encoding]] can be used to indicate each [[MediaObject]] alongside
  892.      * particular [[encodingFormat]] information.
  893.      * 
  894.      * Unregistered or niche encoding and file formats can be indicated instead
  895.      * via the most appropriate URL, e.g. defining Web page or a
  896.      * Wikipedia/Wikidata entry.
  897.      *
  898.      * @param string|string[] $encodingFormat
  899.      *
  900.      * @return static
  901.      *
  902.      * @see https://schema.org/encodingFormat
  903.      */
  904.     public function encodingFormat($encodingFormat)
  905.     {
  906.         return $this->setProperty('encodingFormat', $encodingFormat);
  907.     }
  909.     /**
  910.      * A media object that encodes this CreativeWork.
  911.      *
  912.      * @param \Spatie\SchemaOrg\Contracts\MediaObjectContract|\Spatie\SchemaOrg\Contracts\MediaObjectContract[] $encodings
  913.      *
  914.      * @return static
  915.      *
  916.      * @see https://schema.org/encodings
  917.      */
  918.     public function encodings($encodings)
  919.     {
  920.         return $this->setProperty('encodings', $encodings);
  921.     }
  923.     /**
  924.      * A creative work that this work is an
  925.      * example/instance/realization/derivation of.
  926.      *
  927.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[] $exampleOfWork
  928.      *
  929.      * @return static
  930.      *
  931.      * @see https://schema.org/exampleOfWork
  932.      * @link http://www.w3.org/wiki/WebSchemas/SchemaDotOrgSources#source_bibex
  933.      */
  934.     public function exampleOfWork($exampleOfWork)
  935.     {
  936.         return $this->setProperty('exampleOfWork', $exampleOfWork);
  937.     }
  939.     /**
  940.      * Date the content expires and is no longer useful or available. For
  941.      * example a [[VideoObject]] or [[NewsArticle]] whose availability or
  942.      * relevance is time-limited, or a [[ClaimReview]] fact check whose
  943.      * publisher wants to indicate that it may no longer be relevant (or helpful
  944.      * to highlight) after some date.
  945.      *
  946.      * @param \DateTimeInterface|\DateTimeInterface[] $expires
  947.      *
  948.      * @return static
  949.      *
  950.      * @see https://schema.org/expires
  951.      */
  952.     public function expires($expires)
  953.     {
  954.         return $this->setProperty('expires', $expires);
  955.     }
  957.     /**
  958.      * Media type, typically MIME format (see [IANA
  959.      * site](http://www.iana.org/assignments/media-types/media-types.xhtml)) of
  960.      * the content e.g. application/zip of a SoftwareApplication binary. In
  961.      * cases where a CreativeWork has several media type representations,
  962.      * 'encoding' can be used to indicate each MediaObject alongside particular
  963.      * fileFormat information. Unregistered or niche file formats can be
  964.      * indicated instead via the most appropriate URL, e.g. defining Web page or
  965.      * a Wikipedia entry.
  966.      *
  967.      * @param string|string[] $fileFormat
  968.      *
  969.      * @return static
  970.      *
  971.      * @see https://schema.org/fileFormat
  972.      */
  973.     public function fileFormat($fileFormat)
  974.     {
  975.         return $this->setProperty('fileFormat', $fileFormat);
  976.     }
  978.     /**
  979.      * A person or organization that supports (sponsors) something through some
  980.      * kind of financial contribution.
  981.      *
  982.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $funder
  983.      *
  984.      * @return static
  985.      *
  986.      * @see https://schema.org/funder
  987.      */
  988.     public function funder($funder)
  989.     {
  990.         return $this->setProperty('funder', $funder);
  991.     }
  993.     /**
  994.      * Genre of the creative work, broadcast channel or group.
  995.      *
  996.      * @param string|string[] $genre
  997.      *
  998.      * @return static
  999.      *
  1000.      * @see https://schema.org/genre
  1001.      */
  1002.     public function genre($genre)
  1003.     {
  1004.         return $this->setProperty('genre', $genre);
  1005.     }
  1007.     /**
  1008.      * Indicates an item or CreativeWork that is part of this item, or
  1009.      * CreativeWork (in some sense).
  1010.      *
  1011.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[] $hasPart
  1012.      *
  1013.      * @return static
  1014.      *
  1015.      * @see https://schema.org/hasPart
  1016.      * @link http://www.w3.org/wiki/WebSchemas/SchemaDotOrgSources#source_bibex
  1017.      */
  1018.     public function hasPart($hasPart)
  1019.     {
  1020.         return $this->setProperty('hasPart', $hasPart);
  1021.     }
  1023.     /**
  1024.      * Headline of the article.
  1025.      *
  1026.      * @param string|string[] $headline
  1027.      *
  1028.      * @return static
  1029.      *
  1030.      * @see https://schema.org/headline
  1031.      */
  1032.     public function headline($headline)
  1033.     {
  1034.         return $this->setProperty('headline', $headline);
  1035.     }
  1037.     /**
  1038.      * The identifier property represents any kind of identifier for any kind of
  1039.      * [[Thing]], such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides
  1040.      * dedicated properties for representing many of these, either as textual
  1041.      * strings or as URL (URI) links. See [background
  1042.      * notes](/docs/datamodel.html#identifierBg) for more details.
  1043.      *
  1044.      * @param \Spatie\SchemaOrg\Contracts\PropertyValueContract|\Spatie\SchemaOrg\Contracts\PropertyValueContract[]|string|string[] $identifier
  1045.      *
  1046.      * @return static
  1047.      *
  1048.      * @see https://schema.org/identifier
  1049.      */
  1050.     public function identifier($identifier)
  1051.     {
  1052.         return $this->setProperty('identifier', $identifier);
  1053.     }
  1055.     /**
  1056.      * An image of the item. This can be a [[URL]] or a fully described
  1057.      * [[ImageObject]].
  1058.      *
  1059.      * @param \Spatie\SchemaOrg\Contracts\ImageObjectContract|\Spatie\SchemaOrg\Contracts\ImageObjectContract[]|string|string[] $image
  1060.      *
  1061.      * @return static
  1062.      *
  1063.      * @see https://schema.org/image
  1064.      */
  1065.     public function image($image)
  1066.     {
  1067.         return $this->setProperty('image', $image);
  1068.     }
  1070.     /**
  1071.      * The language of the content or performance or used in an action. Please
  1072.      * use one of the language codes from the [IETF BCP 47
  1073.      * standard](http://tools.ietf.org/html/bcp47). See also
  1074.      * [[availableLanguage]].
  1075.      *
  1076.      * @param \Spatie\SchemaOrg\Contracts\LanguageContract|\Spatie\SchemaOrg\Contracts\LanguageContract[]|string|string[] $inLanguage
  1077.      *
  1078.      * @return static
  1079.      *
  1080.      * @see https://schema.org/inLanguage
  1081.      * @link https://github.com/schemaorg/schemaorg/issues/2382
  1082.      */
  1083.     public function inLanguage($inLanguage)
  1084.     {
  1085.         return $this->setProperty('inLanguage', $inLanguage);
  1086.     }
  1088.     /**
  1089.      * The number of interactions for the CreativeWork using the WebSite or
  1090.      * SoftwareApplication. The most specific child type of InteractionCounter
  1091.      * should be used.
  1092.      *
  1093.      * @param \Spatie\SchemaOrg\Contracts\InteractionCounterContract|\Spatie\SchemaOrg\Contracts\InteractionCounterContract[] $interactionStatistic
  1094.      *
  1095.      * @return static
  1096.      *
  1097.      * @see https://schema.org/interactionStatistic
  1098.      * @link https://github.com/schemaorg/schemaorg/issues/2421
  1099.      */
  1100.     public function interactionStatistic($interactionStatistic)
  1101.     {
  1102.         return $this->setProperty('interactionStatistic', $interactionStatistic);
  1103.     }
  1105.     /**
  1106.      * The predominant mode of learning supported by the learning resource.
  1107.      * Acceptable values are 'active', 'expositive', or 'mixed'.
  1108.      *
  1109.      * @param string|string[] $interactivityType
  1110.      *
  1111.      * @return static
  1112.      *
  1113.      * @see https://schema.org/interactivityType
  1114.      */
  1115.     public function interactivityType($interactivityType)
  1116.     {
  1117.         return $this->setProperty('interactivityType', $interactivityType);
  1118.     }
  1120.     /**
  1121.      * Used to indicate a specific claim contained, implied, translated or
  1122.      * refined from the content of a [[MediaObject]] or other [[CreativeWork]].
  1123.      * The interpreting party can be indicated using [[claimInterpreter]].
  1124.      *
  1125.      * @param \Spatie\SchemaOrg\Contracts\ClaimContract|\Spatie\SchemaOrg\Contracts\ClaimContract[] $interpretedAsClaim
  1126.      *
  1127.      * @return static
  1128.      *
  1129.      * @see https://schema.org/interpretedAsClaim
  1130.      * @see https://pending.schema.org
  1131.      * @link https://github.com/schemaorg/schemaorg/issues/2450
  1132.      */
  1133.     public function interpretedAsClaim($interpretedAsClaim)
  1134.     {
  1135.         return $this->setProperty('interpretedAsClaim', $interpretedAsClaim);
  1136.     }
  1138.     /**
  1139.      * A flag to signal that the item, event, or place is accessible for free.
  1140.      *
  1141.      * @param bool|bool[] $isAccessibleForFree
  1142.      *
  1143.      * @return static
  1144.      *
  1145.      * @see https://schema.org/isAccessibleForFree
  1146.      */
  1147.     public function isAccessibleForFree($isAccessibleForFree)
  1148.     {
  1149.         return $this->setProperty('isAccessibleForFree', $isAccessibleForFree);
  1150.     }
  1152.     /**
  1153.      * A resource from which this work is derived or from which it is a
  1154.      * modification or adaption.
  1155.      *
  1156.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|\Spatie\SchemaOrg\Contracts\ProductContract|\Spatie\SchemaOrg\Contracts\ProductContract[]|string|string[] $isBasedOn
  1157.      *
  1158.      * @return static
  1159.      *
  1160.      * @see https://schema.org/isBasedOn
  1161.      */
  1162.     public function isBasedOn($isBasedOn)
  1163.     {
  1164.         return $this->setProperty('isBasedOn', $isBasedOn);
  1165.     }
  1167.     /**
  1168.      * A resource that was used in the creation of this resource. This term can
  1169.      * be repeated for multiple sources. For example,
  1170.      * http://example.com/great-multiplication-intro.html.
  1171.      *
  1172.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|\Spatie\SchemaOrg\Contracts\ProductContract|\Spatie\SchemaOrg\Contracts\ProductContract[]|string|string[] $isBasedOnUrl
  1173.      *
  1174.      * @return static
  1175.      *
  1176.      * @see https://schema.org/isBasedOnUrl
  1177.      */
  1178.     public function isBasedOnUrl($isBasedOnUrl)
  1179.     {
  1180.         return $this->setProperty('isBasedOnUrl', $isBasedOnUrl);
  1181.     }
  1183.     /**
  1184.      * Indicates whether this content is family friendly.
  1185.      *
  1186.      * @param bool|bool[] $isFamilyFriendly
  1187.      *
  1188.      * @return static
  1189.      *
  1190.      * @see https://schema.org/isFamilyFriendly
  1191.      */
  1192.     public function isFamilyFriendly($isFamilyFriendly)
  1193.     {
  1194.         return $this->setProperty('isFamilyFriendly', $isFamilyFriendly);
  1195.     }
  1197.     /**
  1198.      * Indicates an item or CreativeWork that this item, or CreativeWork (in
  1199.      * some sense), is part of.
  1200.      *
  1201.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $isPartOf
  1202.      *
  1203.      * @return static
  1204.      *
  1205.      * @see https://schema.org/isPartOf
  1206.      */
  1207.     public function isPartOf($isPartOf)
  1208.     {
  1209.         return $this->setProperty('isPartOf', $isPartOf);
  1210.     }
  1212.     /**
  1213.      * Keywords or tags used to describe this content. Multiple entries in a
  1214.      * keywords list are typically delimited by commas.
  1215.      *
  1216.      * @param \Spatie\SchemaOrg\Contracts\DefinedTermContract|\Spatie\SchemaOrg\Contracts\DefinedTermContract[]|string|string[] $keywords
  1217.      *
  1218.      * @return static
  1219.      *
  1220.      * @see https://schema.org/keywords
  1221.      */
  1222.     public function keywords($keywords)
  1223.     {
  1224.         return $this->setProperty('keywords', $keywords);
  1225.     }
  1227.     /**
  1228.      * Date on which the content on this web page was last reviewed for accuracy
  1229.      * and/or completeness.
  1230.      *
  1231.      * @param \DateTimeInterface|\DateTimeInterface[] $lastReviewed
  1232.      *
  1233.      * @return static
  1234.      *
  1235.      * @see https://schema.org/lastReviewed
  1236.      */
  1237.     public function lastReviewed($lastReviewed)
  1238.     {
  1239.         return $this->setProperty('lastReviewed', $lastReviewed);
  1240.     }
  1242.     /**
  1243.      * The predominant type or kind characterizing the learning resource. For
  1244.      * example, 'presentation', 'handout'.
  1245.      *
  1246.      * @param \Spatie\SchemaOrg\Contracts\DefinedTermContract|\Spatie\SchemaOrg\Contracts\DefinedTermContract[]|string|string[] $learningResourceType
  1247.      *
  1248.      * @return static
  1249.      *
  1250.      * @see https://schema.org/learningResourceType
  1251.      */
  1252.     public function learningResourceType($learningResourceType)
  1253.     {
  1254.         return $this->setProperty('learningResourceType', $learningResourceType);
  1255.     }
  1257.     /**
  1258.      * A license document that applies to this content, typically indicated by
  1259.      * URL.
  1260.      *
  1261.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $license
  1262.      *
  1263.      * @return static
  1264.      *
  1265.      * @see https://schema.org/license
  1266.      */
  1267.     public function license($license)
  1268.     {
  1269.         return $this->setProperty('license', $license);
  1270.     }
  1272.     /**
  1273.      * The location where the CreativeWork was created, which may not be the
  1274.      * same as the location depicted in the CreativeWork.
  1275.      *
  1276.      * @param \Spatie\SchemaOrg\Contracts\PlaceContract|\Spatie\SchemaOrg\Contracts\PlaceContract[] $locationCreated
  1277.      *
  1278.      * @return static
  1279.      *
  1280.      * @see https://schema.org/locationCreated
  1281.      */
  1282.     public function locationCreated($locationCreated)
  1283.     {
  1284.         return $this->setProperty('locationCreated', $locationCreated);
  1285.     }
  1287.     /**
  1288.      * Indicates if this web page element is the main subject of the page.
  1289.      *
  1290.      * @param \Spatie\SchemaOrg\Contracts\WebPageElementContract|\Spatie\SchemaOrg\Contracts\WebPageElementContract[] $mainContentOfPage
  1291.      *
  1292.      * @return static
  1293.      *
  1294.      * @see https://schema.org/mainContentOfPage
  1295.      */
  1296.     public function mainContentOfPage($mainContentOfPage)
  1297.     {
  1298.         return $this->setProperty('mainContentOfPage', $mainContentOfPage);
  1299.     }
  1301.     /**
  1302.      * Indicates the primary entity described in some page or other
  1303.      * CreativeWork.
  1304.      *
  1305.      * @param \Spatie\SchemaOrg\Contracts\ThingContract|\Spatie\SchemaOrg\Contracts\ThingContract[] $mainEntity
  1306.      *
  1307.      * @return static
  1308.      *
  1309.      * @see https://schema.org/mainEntity
  1310.      */
  1311.     public function mainEntity($mainEntity)
  1312.     {
  1313.         return $this->setProperty('mainEntity', $mainEntity);
  1314.     }
  1316.     /**
  1317.      * Indicates a page (or other CreativeWork) for which this thing is the main
  1318.      * entity being described. See [background
  1319.      * notes](/docs/datamodel.html#mainEntityBackground) for details.
  1320.      *
  1321.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $mainEntityOfPage
  1322.      *
  1323.      * @return static
  1324.      *
  1325.      * @see https://schema.org/mainEntityOfPage
  1326.      */
  1327.     public function mainEntityOfPage($mainEntityOfPage)
  1328.     {
  1329.         return $this->setProperty('mainEntityOfPage', $mainEntityOfPage);
  1330.     }
  1332.     /**
  1333.      * A maintainer of a [[Dataset]], software package
  1334.      * ([[SoftwareApplication]]), or other [[Project]]. A maintainer is a
  1335.      * [[Person]] or [[Organization]] that manages contributions to, and/or
  1336.      * publication of, some (typically complex) artifact. It is common for
  1337.      * distributions of software and data to be based on "upstream" sources.
  1338.      * When [[maintainer]] is applied to a specific version of something e.g. a
  1339.      * particular version or packaging of a [[Dataset]], it is always  possible
  1340.      * that the upstream source has a different maintainer. The [[isBasedOn]]
  1341.      * property can be used to indicate such relationships between datasets to
  1342.      * make the different maintenance roles clear. Similarly in the case of
  1343.      * software, a package may have dedicated maintainers working on integration
  1344.      * into software distributions such as Ubuntu, as well as upstream
  1345.      * maintainers of the underlying work.
  1346.      *
  1347.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $maintainer
  1348.      *
  1349.      * @return static
  1350.      *
  1351.      * @see https://schema.org/maintainer
  1352.      * @see https://pending.schema.org
  1353.      * @link https://github.com/schemaorg/schemaorg/issues/2311
  1354.      */
  1355.     public function maintainer($maintainer)
  1356.     {
  1357.         return $this->setProperty('maintainer', $maintainer);
  1358.     }
  1360.     /**
  1361.      * A material that something is made from, e.g. leather, wool, cotton,
  1362.      * paper.
  1363.      *
  1364.      * @param \Spatie\SchemaOrg\Contracts\ProductContract|\Spatie\SchemaOrg\Contracts\ProductContract[]|string|string[] $material
  1365.      *
  1366.      * @return static
  1367.      *
  1368.      * @see https://schema.org/material
  1369.      */
  1370.     public function material($material)
  1371.     {
  1372.         return $this->setProperty('material', $material);
  1373.     }
  1375.     /**
  1376.      * The quantity of the materials being described or an expression of the
  1377.      * physical space they occupy.
  1378.      *
  1379.      * @param \Spatie\SchemaOrg\Contracts\QuantitativeValueContract|\Spatie\SchemaOrg\Contracts\QuantitativeValueContract[]|string|string[] $materialExtent
  1380.      *
  1381.      * @return static
  1382.      *
  1383.      * @see https://schema.org/materialExtent
  1384.      * @see https://pending.schema.org
  1385.      * @link https://github.com/schemaorg/schemaorg/issues/1759
  1386.      */
  1387.     public function materialExtent($materialExtent)
  1388.     {
  1389.         return $this->setProperty('materialExtent', $materialExtent);
  1390.     }
  1392.     /**
  1393.      * Indicates that the CreativeWork contains a reference to, but is not
  1394.      * necessarily about a concept.
  1395.      *
  1396.      * @param \Spatie\SchemaOrg\Contracts\ThingContract|\Spatie\SchemaOrg\Contracts\ThingContract[] $mentions
  1397.      *
  1398.      * @return static
  1399.      *
  1400.      * @see https://schema.org/mentions
  1401.      */
  1402.     public function mentions($mentions)
  1403.     {
  1404.         return $this->setProperty('mentions', $mentions);
  1405.     }
  1407.     /**
  1408.      * The name of the item.
  1409.      *
  1410.      * @param string|string[] $name
  1411.      *
  1412.      * @return static
  1413.      *
  1414.      * @see https://schema.org/name
  1415.      */
  1416.     public function name($name)
  1417.     {
  1418.         return $this->setProperty('name', $name);
  1419.     }
  1421.     /**
  1422.      * An offer to provide this item&#x2014;for example, an offer to sell a
  1423.      * product, rent the DVD of a movie, perform a service, or give away tickets
  1424.      * to an event. Use [[businessFunction]] to indicate the kind of transaction
  1425.      * offered, i.e. sell, lease, etc. This property can also be used to
  1426.      * describe a [[Demand]]. While this property is listed as expected on a
  1427.      * number of common types, it can be used in others. In that case, using a
  1428.      * second type, such as Product or a subtype of Product, can clarify the
  1429.      * nature of the offer.
  1430.      *
  1431.      * @param \Spatie\SchemaOrg\Contracts\DemandContract|\Spatie\SchemaOrg\Contracts\DemandContract[]|\Spatie\SchemaOrg\Contracts\OfferContract|\Spatie\SchemaOrg\Contracts\OfferContract[] $offers
  1432.      *
  1433.      * @return static
  1434.      *
  1435.      * @see https://schema.org/offers
  1436.      * @link https://github.com/schemaorg/schemaorg/issues/2289
  1437.      */
  1438.     public function offers($offers)
  1439.     {
  1440.         return $this->setProperty('offers', $offers);
  1441.     }
  1443.     /**
  1444.      * A pattern that something has, for example 'polka dot', 'striped',
  1445.      * 'Canadian flag'. Values are typically expressed as text, although links
  1446.      * to controlled value schemes are also supported.
  1447.      *
  1448.      * @param \Spatie\SchemaOrg\Contracts\DefinedTermContract|\Spatie\SchemaOrg\Contracts\DefinedTermContract[]|string|string[] $pattern
  1449.      *
  1450.      * @return static
  1451.      *
  1452.      * @see https://schema.org/pattern
  1453.      * @see https://pending.schema.org
  1454.      * @link https://github.com/schemaorg/schemaorg/issues/1797
  1455.      */
  1456.     public function pattern($pattern)
  1457.     {
  1458.         return $this->setProperty('pattern', $pattern);
  1459.     }
  1461.     /**
  1462.      * The position of an item in a series or sequence of items.
  1463.      *
  1464.      * @param int|int[]|string|string[] $position
  1465.      *
  1466.      * @return static
  1467.      *
  1468.      * @see https://schema.org/position
  1469.      */
  1470.     public function position($position)
  1471.     {
  1472.         return $this->setProperty('position', $position);
  1473.     }
  1475.     /**
  1476.      * Indicates a potential Action, which describes an idealized action in
  1477.      * which this thing would play an 'object' role.
  1478.      *
  1479.      * @param \Spatie\SchemaOrg\Contracts\ActionContract|\Spatie\SchemaOrg\Contracts\ActionContract[] $potentialAction
  1480.      *
  1481.      * @return static
  1482.      *
  1483.      * @see https://schema.org/potentialAction
  1484.      */
  1485.     public function potentialAction($potentialAction)
  1486.     {
  1487.         return $this->setProperty('potentialAction', $potentialAction);
  1488.     }
  1490.     /**
  1491.      * Indicates the main image on the page.
  1492.      *
  1493.      * @param \Spatie\SchemaOrg\Contracts\ImageObjectContract|\Spatie\SchemaOrg\Contracts\ImageObjectContract[] $primaryImageOfPage
  1494.      *
  1495.      * @return static
  1496.      *
  1497.      * @see https://schema.org/primaryImageOfPage
  1498.      */
  1499.     public function primaryImageOfPage($primaryImageOfPage)
  1500.     {
  1501.         return $this->setProperty('primaryImageOfPage', $primaryImageOfPage);
  1502.     }
  1504.     /**
  1505.      * The person or organization who produced the work (e.g. music album,
  1506.      * movie, tv/radio series etc.).
  1507.      *
  1508.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $producer
  1509.      *
  1510.      * @return static
  1511.      *
  1512.      * @see https://schema.org/producer
  1513.      */
  1514.     public function producer($producer)
  1515.     {
  1516.         return $this->setProperty('producer', $producer);
  1517.     }
  1519.     /**
  1520.      * The service provider, service operator, or service performer; the goods
  1521.      * producer. Another party (a seller) may offer those services or goods on
  1522.      * behalf of the provider. A provider may also serve as the seller.
  1523.      *
  1524.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $provider
  1525.      *
  1526.      * @return static
  1527.      *
  1528.      * @see https://schema.org/provider
  1529.      * @link https://github.com/schemaorg/schemaorg/issues/2289
  1530.      */
  1531.     public function provider($provider)
  1532.     {
  1533.         return $this->setProperty('provider', $provider);
  1534.     }
  1536.     /**
  1537.      * A publication event associated with the item.
  1538.      *
  1539.      * @param \Spatie\SchemaOrg\Contracts\PublicationEventContract|\Spatie\SchemaOrg\Contracts\PublicationEventContract[] $publication
  1540.      *
  1541.      * @return static
  1542.      *
  1543.      * @see https://schema.org/publication
  1544.      */
  1545.     public function publication($publication)
  1546.     {
  1547.         return $this->setProperty('publication', $publication);
  1548.     }
  1550.     /**
  1551.      * The publisher of the creative work.
  1552.      *
  1553.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $publisher
  1554.      *
  1555.      * @return static
  1556.      *
  1557.      * @see https://schema.org/publisher
  1558.      */
  1559.     public function publisher($publisher)
  1560.     {
  1561.         return $this->setProperty('publisher', $publisher);
  1562.     }
  1564.     /**
  1565.      * The publishing division which published the comic.
  1566.      *
  1567.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[] $publisherImprint
  1568.      *
  1569.      * @return static
  1570.      *
  1571.      * @see https://schema.org/publisherImprint
  1572.      * @see https://bib.schema.org
  1573.      */
  1574.     public function publisherImprint($publisherImprint)
  1575.     {
  1576.         return $this->setProperty('publisherImprint', $publisherImprint);
  1577.     }
  1579.     /**
  1580.      * The publishingPrinciples property indicates (typically via [[URL]]) a
  1581.      * document describing the editorial principles of an [[Organization]] (or
  1582.      * individual e.g. a [[Person]] writing a blog) that relate to their
  1583.      * activities as a publisher, e.g. ethics or diversity policies. When
  1584.      * applied to a [[CreativeWork]] (e.g. [[NewsArticle]]) the principles are
  1585.      * those of the party primarily responsible for the creation of the
  1586.      * [[CreativeWork]].
  1587.      * 
  1588.      * While such policies are most typically expressed in natural language,
  1589.      * sometimes related information (e.g. indicating a [[funder]]) can be
  1590.      * expressed using schema.org terminology.
  1591.      *
  1592.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $publishingPrinciples
  1593.      *
  1594.      * @return static
  1595.      *
  1596.      * @see https://schema.org/publishingPrinciples
  1597.      */
  1598.     public function publishingPrinciples($publishingPrinciples)
  1599.     {
  1600.         return $this->setProperty('publishingPrinciples', $publishingPrinciples);
  1601.     }
  1603.     /**
  1604.      * The Event where the CreativeWork was recorded. The CreativeWork may
  1605.      * capture all or part of the event.
  1606.      *
  1607.      * @param \Spatie\SchemaOrg\Contracts\EventContract|\Spatie\SchemaOrg\Contracts\EventContract[] $recordedAt
  1608.      *
  1609.      * @return static
  1610.      *
  1611.      * @see https://schema.org/recordedAt
  1612.      */
  1613.     public function recordedAt($recordedAt)
  1614.     {
  1615.         return $this->setProperty('recordedAt', $recordedAt);
  1616.     }
  1618.     /**
  1619.      * A link related to this web page, for example to other related web pages.
  1620.      *
  1621.      * @param string|string[] $relatedLink
  1622.      *
  1623.      * @return static
  1624.      *
  1625.      * @see https://schema.org/relatedLink
  1626.      */
  1627.     public function relatedLink($relatedLink)
  1628.     {
  1629.         return $this->setProperty('relatedLink', $relatedLink);
  1630.     }
  1632.     /**
  1633.      * The place and time the release was issued, expressed as a
  1634.      * PublicationEvent.
  1635.      *
  1636.      * @param \Spatie\SchemaOrg\Contracts\PublicationEventContract|\Spatie\SchemaOrg\Contracts\PublicationEventContract[] $releasedEvent
  1637.      *
  1638.      * @return static
  1639.      *
  1640.      * @see https://schema.org/releasedEvent
  1641.      */
  1642.     public function releasedEvent($releasedEvent)
  1643.     {
  1644.         return $this->setProperty('releasedEvent', $releasedEvent);
  1645.     }
  1647.     /**
  1648.      * A review of the item.
  1649.      *
  1650.      * @param \Spatie\SchemaOrg\Contracts\ReviewContract|\Spatie\SchemaOrg\Contracts\ReviewContract[] $review
  1651.      *
  1652.      * @return static
  1653.      *
  1654.      * @see https://schema.org/review
  1655.      */
  1656.     public function review($review)
  1657.     {
  1658.         return $this->setProperty('review', $review);
  1659.     }
  1661.     /**
  1662.      * People or organizations that have reviewed the content on this web page
  1663.      * for accuracy and/or completeness.
  1664.      *
  1665.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $reviewedBy
  1666.      *
  1667.      * @return static
  1668.      *
  1669.      * @see https://schema.org/reviewedBy
  1670.      */
  1671.     public function reviewedBy($reviewedBy)
  1672.     {
  1673.         return $this->setProperty('reviewedBy', $reviewedBy);
  1674.     }
  1676.     /**
  1677.      * Review of the item.
  1678.      *
  1679.      * @param \Spatie\SchemaOrg\Contracts\ReviewContract|\Spatie\SchemaOrg\Contracts\ReviewContract[] $reviews
  1680.      *
  1681.      * @return static
  1682.      *
  1683.      * @see https://schema.org/reviews
  1684.      */
  1685.     public function reviews($reviews)
  1686.     {
  1687.         return $this->setProperty('reviews', $reviews);
  1688.     }
  1690.     /**
  1691.      * URL of a reference Web page that unambiguously indicates the item's
  1692.      * identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or
  1693.      * official website.
  1694.      *
  1695.      * @param string|string[] $sameAs
  1696.      *
  1697.      * @return static
  1698.      *
  1699.      * @see https://schema.org/sameAs
  1700.      */
  1701.     public function sameAs($sameAs)
  1702.     {
  1703.         return $this->setProperty('sameAs', $sameAs);
  1704.     }
  1706.     /**
  1707.      * Indicates (by URL or string) a particular version of a schema used in
  1708.      * some CreativeWork. This property was created primarily to
  1709.      *     indicate the use of a specific schema.org release, e.g. ```10.0``` as
  1710.      * a simple string, or more explicitly via URL,
  1711.      * ```https://schema.org/docs/releases.html#v10.0```. There may be
  1712.      * situations in which other schemas might usefully be referenced this way,
  1713.      * e.g.
  1714.      * ```http://dublincore.org/specifications/dublin-core/dces/1999-07-02/```
  1715.      * but this has not been carefully explored in the community.
  1716.      *
  1717.      * @param string|string[] $schemaVersion
  1718.      *
  1719.      * @return static
  1720.      *
  1721.      * @see https://schema.org/schemaVersion
  1722.      */
  1723.     public function schemaVersion($schemaVersion)
  1724.     {
  1725.         return $this->setProperty('schemaVersion', $schemaVersion);
  1726.     }
  1728.     /**
  1729.      * Indicates the date on which the current structured data was generated /
  1730.      * published. Typically used alongside [[sdPublisher]]
  1731.      *
  1732.      * @param \DateTimeInterface|\DateTimeInterface[] $sdDatePublished
  1733.      *
  1734.      * @return static
  1735.      *
  1736.      * @see https://schema.org/sdDatePublished
  1737.      * @see https://pending.schema.org
  1738.      * @link https://github.com/schemaorg/schemaorg/issues/1886
  1739.      */
  1740.     public function sdDatePublished($sdDatePublished)
  1741.     {
  1742.         return $this->setProperty('sdDatePublished', $sdDatePublished);
  1743.     }
  1745.     /**
  1746.      * A license document that applies to this structured data, typically
  1747.      * indicated by URL.
  1748.      *
  1749.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $sdLicense
  1750.      *
  1751.      * @return static
  1752.      *
  1753.      * @see https://schema.org/sdLicense
  1754.      * @see https://pending.schema.org
  1755.      * @link https://github.com/schemaorg/schemaorg/issues/1886
  1756.      */
  1757.     public function sdLicense($sdLicense)
  1758.     {
  1759.         return $this->setProperty('sdLicense', $sdLicense);
  1760.     }
  1762.     /**
  1763.      * Indicates the party responsible for generating and publishing the current
  1764.      * structured data markup, typically in cases where the structured data is
  1765.      * derived automatically from existing published content but published on a
  1766.      * different site. For example, student projects and open data initiatives
  1767.      * often re-publish existing content with more explicitly structured
  1768.      * metadata. The
  1769.      * [[sdPublisher]] property helps make such practices more explicit.
  1770.      *
  1771.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $sdPublisher
  1772.      *
  1773.      * @return static
  1774.      *
  1775.      * @see https://schema.org/sdPublisher
  1776.      * @see https://pending.schema.org
  1777.      * @link https://github.com/schemaorg/schemaorg/issues/1886
  1778.      */
  1779.     public function sdPublisher($sdPublisher)
  1780.     {
  1781.         return $this->setProperty('sdPublisher', $sdPublisher);
  1782.     }
  1784.     /**
  1785.      * One of the more significant URLs on the page. Typically, these are the
  1786.      * non-navigation links that are clicked on the most.
  1787.      *
  1788.      * @param string|string[] $significantLink
  1789.      *
  1790.      * @return static
  1791.      *
  1792.      * @see https://schema.org/significantLink
  1793.      */
  1794.     public function significantLink($significantLink)
  1795.     {
  1796.         return $this->setProperty('significantLink', $significantLink);
  1797.     }
  1799.     /**
  1800.      * The most significant URLs on the page. Typically, these are the
  1801.      * non-navigation links that are clicked on the most.
  1802.      *
  1803.      * @param string|string[] $significantLinks
  1804.      *
  1805.      * @return static
  1806.      *
  1807.      * @see https://schema.org/significantLinks
  1808.      */
  1809.     public function significantLinks($significantLinks)
  1810.     {
  1811.         return $this->setProperty('significantLinks', $significantLinks);
  1812.     }
  1814.     /**
  1815.      * A standardized size of a product or creative work, specified either
  1816.      * through a simple textual string (for example 'XL', '32Wx34L'), a 
  1817.      * QuantitativeValue with a unitCode, or a comprehensive and structured
  1818.      * [[SizeSpecification]]; in other cases, the [[width]], [[height]],
  1819.      * [[depth]] and [[weight]] properties may be more applicable.
  1820.      *
  1821.      * @param \Spatie\SchemaOrg\Contracts\DefinedTermContract|\Spatie\SchemaOrg\Contracts\DefinedTermContract[]|\Spatie\SchemaOrg\Contracts\QuantitativeValueContract|\Spatie\SchemaOrg\Contracts\QuantitativeValueContract[]|\Spatie\SchemaOrg\Contracts\SizeSpecificationContract|\Spatie\SchemaOrg\Contracts\SizeSpecificationContract[]|string|string[] $size
  1822.      *
  1823.      * @return static
  1824.      *
  1825.      * @see https://schema.org/size
  1826.      * @see https://pending.schema.org
  1827.      * @link https://github.com/schemaorg/schemaorg/issues/1797
  1828.      */
  1829.     public function size($size)
  1830.     {
  1831.         return $this->setProperty('size', $size);
  1832.     }
  1834.     /**
  1835.      * The Organization on whose behalf the creator was working.
  1836.      *
  1837.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[] $sourceOrganization
  1838.      *
  1839.      * @return static
  1840.      *
  1841.      * @see https://schema.org/sourceOrganization
  1842.      */
  1843.     public function sourceOrganization($sourceOrganization)
  1844.     {
  1845.         return $this->setProperty('sourceOrganization', $sourceOrganization);
  1846.     }
  1848.     /**
  1849.      * The "spatial" property can be used in cases when more specific properties
  1850.      * (e.g. [[locationCreated]], [[spatialCoverage]], [[contentLocation]]) are
  1851.      * not known to be appropriate.
  1852.      *
  1853.      * @param \Spatie\SchemaOrg\Contracts\PlaceContract|\Spatie\SchemaOrg\Contracts\PlaceContract[] $spatial
  1854.      *
  1855.      * @return static
  1856.      *
  1857.      * @see https://schema.org/spatial
  1858.      */
  1859.     public function spatial($spatial)
  1860.     {
  1861.         return $this->setProperty('spatial', $spatial);
  1862.     }
  1864.     /**
  1865.      * The spatialCoverage of a CreativeWork indicates the place(s) which are
  1866.      * the focus of the content. It is a subproperty of
  1867.      *       contentLocation intended primarily for more technical and detailed
  1868.      * materials. For example with a Dataset, it indicates
  1869.      *       areas that the dataset describes: a dataset of New York weather
  1870.      * would have spatialCoverage which was the place: the state of New York.
  1871.      *
  1872.      * @param \Spatie\SchemaOrg\Contracts\PlaceContract|\Spatie\SchemaOrg\Contracts\PlaceContract[] $spatialCoverage
  1873.      *
  1874.      * @return static
  1875.      *
  1876.      * @see https://schema.org/spatialCoverage
  1877.      */
  1878.     public function spatialCoverage($spatialCoverage)
  1879.     {
  1880.         return $this->setProperty('spatialCoverage', $spatialCoverage);
  1881.     }
  1883.     /**
  1884.      * Indicates sections of a Web page that are particularly 'speakable' in the
  1885.      * sense of being highlighted as being especially appropriate for
  1886.      * text-to-speech conversion. Other sections of a page may also be usefully
  1887.      * spoken in particular circumstances; the 'speakable' property serves to
  1888.      * indicate the parts most likely to be generally useful for speech.
  1889.      * 
  1890.      * The *speakable* property can be repeated an arbitrary number of times,
  1891.      * with three kinds of possible 'content-locator' values:
  1892.      * 
  1893.      * 1.) *id-value* URL references - uses *id-value* of an element in the page
  1894.      * being annotated. The simplest use of *speakable* has (potentially
  1895.      * relative) URL values, referencing identified sections of the document
  1896.      * concerned.
  1897.      * 
  1898.      * 2.) CSS Selectors - addresses content in the annotated page, eg. via
  1899.      * class attribute. Use the [[cssSelector]] property.
  1900.      * 
  1901.      * 3.)  XPaths - addresses content via XPaths (assuming an XML view of the
  1902.      * content). Use the [[xpath]] property.
  1903.      * 
  1904.      * 
  1905.      * For more sophisticated markup of speakable sections beyond simple ID
  1906.      * references, either CSS selectors or XPath expressions to pick out
  1907.      * document section(s) as speakable. For this
  1908.      * we define a supporting type, [[SpeakableSpecification]]  which is defined
  1909.      * to be a possible value of the *speakable* property.
  1910.      *
  1911.      * @param \Spatie\SchemaOrg\Contracts\SpeakableSpecificationContract|\Spatie\SchemaOrg\Contracts\SpeakableSpecificationContract[]|string|string[] $speakable
  1912.      *
  1913.      * @return static
  1914.      *
  1915.      * @see https://schema.org/speakable
  1916.      * @link https://github.com/schemaorg/schemaorg/issues/1389
  1917.      */
  1918.     public function speakable($speakable)
  1919.     {
  1920.         return $this->setProperty('speakable', $speakable);
  1921.     }
  1923.     /**
  1924.      * One of the domain specialities to which this web page's content applies.
  1925.      *
  1926.      * @param \Spatie\SchemaOrg\Contracts\SpecialtyContract|\Spatie\SchemaOrg\Contracts\SpecialtyContract[] $specialty
  1927.      *
  1928.      * @return static
  1929.      *
  1930.      * @see https://schema.org/specialty
  1931.      */
  1932.     public function specialty($specialty)
  1933.     {
  1934.         return $this->setProperty('specialty', $specialty);
  1935.     }
  1937.     /**
  1938.      * A person or organization that supports a thing through a pledge, promise,
  1939.      * or financial contribution. e.g. a sponsor of a Medical Study or a
  1940.      * corporate sponsor of an event.
  1941.      *
  1942.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $sponsor
  1943.      *
  1944.      * @return static
  1945.      *
  1946.      * @see https://schema.org/sponsor
  1947.      */
  1948.     public function sponsor($sponsor)
  1949.     {
  1950.         return $this->setProperty('sponsor', $sponsor);
  1951.     }
  1953.     /**
  1954.      * A CreativeWork or Event about this Thing.
  1955.      *
  1956.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|\Spatie\SchemaOrg\Contracts\EventContract|\Spatie\SchemaOrg\Contracts\EventContract[] $subjectOf
  1957.      *
  1958.      * @return static
  1959.      *
  1960.      * @see https://schema.org/subjectOf
  1961.      * @link https://github.com/schemaorg/schemaorg/issues/1670
  1962.      */
  1963.     public function subjectOf($subjectOf)
  1964.     {
  1965.         return $this->setProperty('subjectOf', $subjectOf);
  1966.     }
  1968.     /**
  1969.      * The item being described is intended to help a person learn the
  1970.      * competency or learning outcome defined by the referenced term.
  1971.      *
  1972.      * @param \Spatie\SchemaOrg\Contracts\DefinedTermContract|\Spatie\SchemaOrg\Contracts\DefinedTermContract[]|string|string[] $teaches
  1973.      *
  1974.      * @return static
  1975.      *
  1976.      * @see https://schema.org/teaches
  1977.      * @see https://pending.schema.org
  1978.      * @link https://github.com/schemaorg/schemaorg/issues/2427
  1979.      */
  1980.     public function teaches($teaches)
  1981.     {
  1982.         return $this->setProperty('teaches', $teaches);
  1983.     }
  1985.     /**
  1986.      * The "temporal" property can be used in cases where more specific
  1987.      * properties
  1988.      * (e.g. [[temporalCoverage]], [[dateCreated]], [[dateModified]],
  1989.      * [[datePublished]]) are not known to be appropriate.
  1990.      *
  1991.      * @param \DateTimeInterface|\DateTimeInterface[]|string|string[] $temporal
  1992.      *
  1993.      * @return static
  1994.      *
  1995.      * @see https://schema.org/temporal
  1996.      */
  1997.     public function temporal($temporal)
  1998.     {
  1999.         return $this->setProperty('temporal', $temporal);
  2000.     }
  2002.     /**
  2003.      * The temporalCoverage of a CreativeWork indicates the period that the
  2004.      * content applies to, i.e. that it describes, either as a DateTime or as a
  2005.      * textual string indicating a time period in [ISO 8601 time interval
  2006.      * format](https://en.wikipedia.org/wiki/ISO_8601#Time_intervals). In
  2007.      *       the case of a Dataset it will typically indicate the relevant time
  2008.      * period in a precise notation (e.g. for a 2011 census dataset, the year
  2009.      * 2011 would be written "2011/2012"). Other forms of content e.g.
  2010.      * ScholarlyArticle, Book, TVSeries or TVEpisode may indicate their
  2011.      * temporalCoverage in broader terms - textually or via well-known URL.
  2012.      *       Written works such as books may sometimes have precise temporal
  2013.      * coverage too, e.g. a work set in 1939 - 1945 can be indicated in ISO 8601
  2014.      * interval format format via "1939/1945".
  2015.      * 
  2016.      * Open-ended date ranges can be written with ".." in place of the end date.
  2017.      * For example, "2015-11/.." indicates a range beginning in November 2015
  2018.      * and with no specified final date. This is tentative and might be updated
  2019.      * in future when ISO 8601 is officially updated.
  2020.      *
  2021.      * @param \DateTimeInterface|\DateTimeInterface[]|string|string[] $temporalCoverage
  2022.      *
  2023.      * @return static
  2024.      *
  2025.      * @see https://schema.org/temporalCoverage
  2026.      */
  2027.     public function temporalCoverage($temporalCoverage)
  2028.     {
  2029.         return $this->setProperty('temporalCoverage', $temporalCoverage);
  2030.     }
  2032.     /**
  2033.      * The textual content of this CreativeWork.
  2034.      *
  2035.      * @param string|string[] $text
  2036.      *
  2037.      * @return static
  2038.      *
  2039.      * @see https://schema.org/text
  2040.      */
  2041.     public function text($text)
  2042.     {
  2043.         return $this->setProperty('text', $text);
  2044.     }
  2046.     /**
  2047.      * A thumbnail image relevant to the Thing.
  2048.      *
  2049.      * @param string|string[] $thumbnailUrl
  2050.      *
  2051.      * @return static
  2052.      *
  2053.      * @see https://schema.org/thumbnailUrl
  2054.      */
  2055.     public function thumbnailUrl($thumbnailUrl)
  2056.     {
  2057.         return $this->setProperty('thumbnailUrl', $thumbnailUrl);
  2058.     }
  2060.     /**
  2061.      * Approximate or typical time it takes to work with or through this
  2062.      * learning resource for the typical intended target audience, e.g. 'PT30M',
  2063.      * 'PT1H25M'.
  2064.      *
  2065.      * @param \Spatie\SchemaOrg\Contracts\DurationContract|\Spatie\SchemaOrg\Contracts\DurationContract[] $timeRequired
  2066.      *
  2067.      * @return static
  2068.      *
  2069.      * @see https://schema.org/timeRequired
  2070.      */
  2071.     public function timeRequired($timeRequired)
  2072.     {
  2073.         return $this->setProperty('timeRequired', $timeRequired);
  2074.     }
  2076.     /**
  2077.      * The work that this work has been translated from. e.g. 物种起源 is a
  2078.      * translationOf “On the Origin of Species”
  2079.      *
  2080.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[] $translationOfWork
  2081.      *
  2082.      * @return static
  2083.      *
  2084.      * @see https://schema.org/translationOfWork
  2085.      * @see https://bib.schema.org
  2086.      */
  2087.     public function translationOfWork($translationOfWork)
  2088.     {
  2089.         return $this->setProperty('translationOfWork', $translationOfWork);
  2090.     }
  2092.     /**
  2093.      * Organization or person who adapts a creative work to different languages,
  2094.      * regional differences and technical requirements of a target market, or
  2095.      * that translates during some event.
  2096.      *
  2097.      * @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $translator
  2098.      *
  2099.      * @return static
  2100.      *
  2101.      * @see https://schema.org/translator
  2102.      */
  2103.     public function translator($translator)
  2104.     {
  2105.         return $this->setProperty('translator', $translator);
  2106.     }
  2108.     /**
  2109.      * The typical expected age range, e.g. '7-9', '11-'.
  2110.      *
  2111.      * @param string|string[] $typicalAgeRange
  2112.      *
  2113.      * @return static
  2114.      *
  2115.      * @see https://schema.org/typicalAgeRange
  2116.      */
  2117.     public function typicalAgeRange($typicalAgeRange)
  2118.     {
  2119.         return $this->setProperty('typicalAgeRange', $typicalAgeRange);
  2120.     }
  2122.     /**
  2123.      * URL of the item.
  2124.      *
  2125.      * @param string|string[] $url
  2126.      *
  2127.      * @return static
  2128.      *
  2129.      * @see https://schema.org/url
  2130.      */
  2131.     public function url($url)
  2132.     {
  2133.         return $this->setProperty('url', $url);
  2134.     }
  2136.     /**
  2137.      * The schema.org [[usageInfo]] property indicates further information about
  2138.      * a [[CreativeWork]]. This property is applicable both to works that are
  2139.      * freely available and to those that require payment or other transactions.
  2140.      * It can reference additional information e.g. community expectations on
  2141.      * preferred linking and citation conventions, as well as purchasing
  2142.      * details. For something that can be commercially licensed, usageInfo can
  2143.      * provide detailed, resource-specific information about licensing options.
  2144.      * 
  2145.      * This property can be used alongside the license property which indicates
  2146.      * license(s) applicable to some piece of content. The usageInfo property
  2147.      * can provide information about other licensing options, e.g. acquiring
  2148.      * commercial usage rights for an image that is also available under
  2149.      * non-commercial creative commons licenses.
  2150.      *
  2151.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $usageInfo
  2152.      *
  2153.      * @return static
  2154.      *
  2155.      * @see https://schema.org/usageInfo
  2156.      * @see https://pending.schema.org
  2157.      * @link https://github.com/schemaorg/schemaorg/issues/2454
  2158.      */
  2159.     public function usageInfo($usageInfo)
  2160.     {
  2161.         return $this->setProperty('usageInfo', $usageInfo);
  2162.     }
  2164.     /**
  2165.      * The version of the CreativeWork embodied by a specified resource.
  2166.      *
  2167.      * @param float|float[]|int|int[]|string|string[] $version
  2168.      *
  2169.      * @return static
  2170.      *
  2171.      * @see https://schema.org/version
  2172.      */
  2173.     public function version($version)
  2174.     {
  2175.         return $this->setProperty('version', $version);
  2176.     }
  2178.     /**
  2179.      * An embedded video object.
  2180.      *
  2181.      * @param \Spatie\SchemaOrg\Contracts\ClipContract|\Spatie\SchemaOrg\Contracts\ClipContract[]|\Spatie\SchemaOrg\Contracts\VideoObjectContract|\Spatie\SchemaOrg\Contracts\VideoObjectContract[] $video
  2182.      *
  2183.      * @return static
  2184.      *
  2185.      * @see https://schema.org/video
  2186.      */
  2187.     public function video($video)
  2188.     {
  2189.         return $this->setProperty('video', $video);
  2190.     }
  2192.     /**
  2193.      * Example/instance/realization/derivation of the concept of this creative
  2194.      * work. eg. The paperback edition, first edition, or eBook.
  2195.      *
  2196.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[] $workExample
  2197.      *
  2198.      * @return static
  2199.      *
  2200.      * @see https://schema.org/workExample
  2201.      * @link http://www.w3.org/wiki/WebSchemas/SchemaDotOrgSources#source_bibex
  2202.      */
  2203.     public function workExample($workExample)
  2204.     {
  2205.         return $this->setProperty('workExample', $workExample);
  2206.     }
  2208.     /**
  2209.      * A work that is a translation of the content of this work. e.g. 西遊記
  2210.      * has an English workTranslation “Journey to the West”,a German
  2211.      * workTranslation “Monkeys Pilgerfahrt” and a Vietnamese  translation
  2212.      * Tây du ký bình khảo.
  2213.      *
  2214.      * @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[] $workTranslation
  2215.      *
  2216.      * @return static
  2217.      *
  2218.      * @see https://schema.org/workTranslation
  2219.      * @see https://bib.schema.org
  2220.      */
  2221.     public function workTranslation($workTranslation)
  2222.     {
  2223.         return $this->setProperty('workTranslation', $workTranslation);
  2224.     }
  2226. }