1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
namespace Spatie\SchemaOrg; |
4
|
|
|
|
5
|
|
|
use \Spatie\SchemaOrg\Contracts\BlogPostingContract; |
6
|
|
|
use \Spatie\SchemaOrg\Contracts\ArticleContract; |
7
|
|
|
use \Spatie\SchemaOrg\Contracts\CreativeWorkContract; |
8
|
|
|
use \Spatie\SchemaOrg\Contracts\SocialMediaPostingContract; |
9
|
|
|
use \Spatie\SchemaOrg\Contracts\ThingContract; |
10
|
|
|
|
11
|
|
|
/** |
12
|
|
|
* A blog post. |
13
|
|
|
* |
14
|
|
|
* @see http://schema.org/BlogPosting |
15
|
|
|
* |
16
|
|
|
*/ |
17
|
|
|
class BlogPosting extends BaseType implements BlogPostingContract, ArticleContract, CreativeWorkContract, SocialMediaPostingContract, ThingContract |
18
|
|
|
{ |
19
|
|
|
/** |
20
|
|
|
* The subject matter of the content. |
21
|
|
|
* |
22
|
|
|
* @param \Spatie\SchemaOrg\Contracts\ThingContract|\Spatie\SchemaOrg\Contracts\ThingContract[] $about |
23
|
|
|
* |
24
|
|
|
* @return static |
25
|
|
|
* |
26
|
|
|
* @see http://schema.org/about |
27
|
|
|
*/ |
28
|
|
|
public function about($about) |
29
|
|
|
{ |
30
|
|
|
return $this->setProperty('about', $about); |
31
|
|
|
} |
32
|
|
|
|
33
|
|
|
/** |
34
|
|
|
* The human sensory perceptual system or cognitive faculty through which a |
35
|
|
|
* person may process or perceive information. Expected values include: |
36
|
|
|
* auditory, tactile, textual, visual, colorDependent, chartOnVisual, |
37
|
|
|
* chemOnVisual, diagramOnVisual, mathOnVisual, musicOnVisual, textOnVisual. |
38
|
|
|
* |
39
|
|
|
* @param string|string[] $accessMode |
40
|
|
|
* |
41
|
|
|
* @return static |
42
|
|
|
* |
43
|
|
|
* @see http://schema.org/accessMode |
44
|
|
|
*/ |
45
|
|
|
public function accessMode($accessMode) |
46
|
|
|
{ |
47
|
|
|
return $this->setProperty('accessMode', $accessMode); |
48
|
|
|
} |
49
|
|
|
|
50
|
|
|
/** |
51
|
|
|
* A list of single or combined accessModes that are sufficient to |
52
|
|
|
* understand all the intellectual content of a resource. Expected values |
53
|
|
|
* include: auditory, tactile, textual, visual. |
54
|
|
|
* |
55
|
|
|
* @param \Spatie\SchemaOrg\Contracts\ItemListContract|\Spatie\SchemaOrg\Contracts\ItemListContract[] $accessModeSufficient |
56
|
|
|
* |
57
|
|
|
* @return static |
58
|
|
|
* |
59
|
|
|
* @see http://schema.org/accessModeSufficient |
60
|
|
|
*/ |
61
|
|
|
public function accessModeSufficient($accessModeSufficient) |
62
|
|
|
{ |
63
|
|
|
return $this->setProperty('accessModeSufficient', $accessModeSufficient); |
64
|
|
|
} |
65
|
|
|
|
66
|
|
|
/** |
67
|
|
|
* Indicates that the resource is compatible with the referenced |
68
|
|
|
* accessibility API ([WebSchemas wiki lists possible |
69
|
|
|
* values](http://www.w3.org/wiki/WebSchemas/Accessibility)). |
70
|
|
|
* |
71
|
|
|
* @param string|string[] $accessibilityAPI |
72
|
|
|
* |
73
|
|
|
* @return static |
74
|
|
|
* |
75
|
|
|
* @see http://schema.org/accessibilityAPI |
76
|
|
|
*/ |
77
|
|
|
public function accessibilityAPI($accessibilityAPI) |
78
|
|
|
{ |
79
|
|
|
return $this->setProperty('accessibilityAPI', $accessibilityAPI); |
80
|
|
|
} |
81
|
|
|
|
82
|
|
|
/** |
83
|
|
|
* Identifies input methods that are sufficient to fully control the |
84
|
|
|
* described resource ([WebSchemas wiki lists possible |
85
|
|
|
* values](http://www.w3.org/wiki/WebSchemas/Accessibility)). |
86
|
|
|
* |
87
|
|
|
* @param string|string[] $accessibilityControl |
88
|
|
|
* |
89
|
|
|
* @return static |
90
|
|
|
* |
91
|
|
|
* @see http://schema.org/accessibilityControl |
92
|
|
|
*/ |
93
|
|
|
public function accessibilityControl($accessibilityControl) |
94
|
|
|
{ |
95
|
|
|
return $this->setProperty('accessibilityControl', $accessibilityControl); |
96
|
|
|
} |
97
|
|
|
|
98
|
|
|
/** |
99
|
|
|
* Content features of the resource, such as accessible media, alternatives |
100
|
|
|
* and supported enhancements for accessibility ([WebSchemas wiki lists |
101
|
|
|
* possible values](http://www.w3.org/wiki/WebSchemas/Accessibility)). |
102
|
|
|
* |
103
|
|
|
* @param string|string[] $accessibilityFeature |
104
|
|
|
* |
105
|
|
|
* @return static |
106
|
|
|
* |
107
|
|
|
* @see http://schema.org/accessibilityFeature |
108
|
|
|
*/ |
109
|
|
|
public function accessibilityFeature($accessibilityFeature) |
110
|
|
|
{ |
111
|
|
|
return $this->setProperty('accessibilityFeature', $accessibilityFeature); |
112
|
|
|
} |
113
|
|
|
|
114
|
|
|
/** |
115
|
|
|
* A characteristic of the described resource that is physiologically |
116
|
|
|
* dangerous to some users. Related to WCAG 2.0 guideline 2.3 ([WebSchemas |
117
|
|
|
* wiki lists possible |
118
|
|
|
* values](http://www.w3.org/wiki/WebSchemas/Accessibility)). |
119
|
|
|
* |
120
|
|
|
* @param string|string[] $accessibilityHazard |
121
|
|
|
* |
122
|
|
|
* @return static |
123
|
|
|
* |
124
|
|
|
* @see http://schema.org/accessibilityHazard |
125
|
|
|
*/ |
126
|
|
|
public function accessibilityHazard($accessibilityHazard) |
127
|
|
|
{ |
128
|
|
|
return $this->setProperty('accessibilityHazard', $accessibilityHazard); |
129
|
|
|
} |
130
|
|
|
|
131
|
|
|
/** |
132
|
|
|
* A human-readable summary of specific accessibility features or |
133
|
|
|
* deficiencies, consistent with the other accessibility metadata but |
134
|
|
|
* expressing subtleties such as "short descriptions are present but long |
135
|
|
|
* descriptions will be needed for non-visual users" or "short descriptions |
136
|
|
|
* are present and no long descriptions are needed." |
137
|
|
|
* |
138
|
|
|
* @param string|string[] $accessibilitySummary |
139
|
|
|
* |
140
|
|
|
* @return static |
141
|
|
|
* |
142
|
|
|
* @see http://schema.org/accessibilitySummary |
143
|
|
|
*/ |
144
|
|
|
public function accessibilitySummary($accessibilitySummary) |
145
|
|
|
{ |
146
|
|
|
return $this->setProperty('accessibilitySummary', $accessibilitySummary); |
147
|
|
|
} |
148
|
|
|
|
149
|
|
|
/** |
150
|
|
|
* Specifies the Person that is legally accountable for the CreativeWork. |
151
|
|
|
* |
152
|
|
|
* @param \Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $accountablePerson |
153
|
|
|
* |
154
|
|
|
* @return static |
155
|
|
|
* |
156
|
|
|
* @see http://schema.org/accountablePerson |
157
|
|
|
*/ |
158
|
|
|
public function accountablePerson($accountablePerson) |
159
|
|
|
{ |
160
|
|
|
return $this->setProperty('accountablePerson', $accountablePerson); |
161
|
|
|
} |
162
|
|
|
|
163
|
|
|
/** |
164
|
|
|
* An additional type for the item, typically used for adding more specific |
165
|
|
|
* types from external vocabularies in microdata syntax. This is a |
166
|
|
|
* relationship between something and a class that the thing is in. In RDFa |
167
|
|
|
* syntax, it is better to use the native RDFa syntax - the 'typeof' |
168
|
|
|
* attribute - for multiple types. Schema.org tools may have only weaker |
169
|
|
|
* understanding of extra types, in particular those defined externally. |
170
|
|
|
* |
171
|
|
|
* @param string|string[] $additionalType |
172
|
|
|
* |
173
|
|
|
* @return static |
174
|
|
|
* |
175
|
|
|
* @see http://schema.org/additionalType |
176
|
|
|
*/ |
177
|
|
|
public function additionalType($additionalType) |
178
|
|
|
{ |
179
|
|
|
return $this->setProperty('additionalType', $additionalType); |
180
|
|
|
} |
181
|
|
|
|
182
|
|
|
/** |
183
|
|
|
* The overall rating, based on a collection of reviews or ratings, of the |
184
|
|
|
* item. |
185
|
|
|
* |
186
|
|
|
* @param \Spatie\SchemaOrg\Contracts\AggregateRatingContract|\Spatie\SchemaOrg\Contracts\AggregateRatingContract[] $aggregateRating |
187
|
|
|
* |
188
|
|
|
* @return static |
189
|
|
|
* |
190
|
|
|
* @see http://schema.org/aggregateRating |
191
|
|
|
*/ |
192
|
|
|
public function aggregateRating($aggregateRating) |
193
|
|
|
{ |
194
|
|
|
return $this->setProperty('aggregateRating', $aggregateRating); |
195
|
|
|
} |
196
|
|
|
|
197
|
|
|
/** |
198
|
|
|
* An alias for the item. |
199
|
|
|
* |
200
|
|
|
* @param string|string[] $alternateName |
201
|
|
|
* |
202
|
|
|
* @return static |
203
|
|
|
* |
204
|
|
|
* @see http://schema.org/alternateName |
205
|
|
|
*/ |
206
|
|
|
public function alternateName($alternateName) |
207
|
|
|
{ |
208
|
|
|
return $this->setProperty('alternateName', $alternateName); |
209
|
|
|
} |
210
|
|
|
|
211
|
|
|
/** |
212
|
|
|
* A secondary title of the CreativeWork. |
213
|
|
|
* |
214
|
|
|
* @param string|string[] $alternativeHeadline |
215
|
|
|
* |
216
|
|
|
* @return static |
217
|
|
|
* |
218
|
|
|
* @see http://schema.org/alternativeHeadline |
219
|
|
|
*/ |
220
|
|
|
public function alternativeHeadline($alternativeHeadline) |
221
|
|
|
{ |
222
|
|
|
return $this->setProperty('alternativeHeadline', $alternativeHeadline); |
223
|
|
|
} |
224
|
|
|
|
225
|
|
|
/** |
226
|
|
|
* The actual body of the article. |
227
|
|
|
* |
228
|
|
|
* @param string|string[] $articleBody |
229
|
|
|
* |
230
|
|
|
* @return static |
231
|
|
|
* |
232
|
|
|
* @see http://schema.org/articleBody |
233
|
|
|
*/ |
234
|
|
|
public function articleBody($articleBody) |
235
|
|
|
{ |
236
|
|
|
return $this->setProperty('articleBody', $articleBody); |
237
|
|
|
} |
238
|
|
|
|
239
|
|
|
/** |
240
|
|
|
* Articles may belong to one or more 'sections' in a magazine or newspaper, |
241
|
|
|
* such as Sports, Lifestyle, etc. |
242
|
|
|
* |
243
|
|
|
* @param string|string[] $articleSection |
244
|
|
|
* |
245
|
|
|
* @return static |
246
|
|
|
* |
247
|
|
|
* @see http://schema.org/articleSection |
248
|
|
|
*/ |
249
|
|
|
public function articleSection($articleSection) |
250
|
|
|
{ |
251
|
|
|
return $this->setProperty('articleSection', $articleSection); |
252
|
|
|
} |
253
|
|
|
|
254
|
|
|
/** |
255
|
|
|
* A media object that encodes this CreativeWork. This property is a synonym |
256
|
|
|
* for encoding. |
257
|
|
|
* |
258
|
|
|
* @param \Spatie\SchemaOrg\Contracts\MediaObjectContract|\Spatie\SchemaOrg\Contracts\MediaObjectContract[] $associatedMedia |
259
|
|
|
* |
260
|
|
|
* @return static |
261
|
|
|
* |
262
|
|
|
* @see http://schema.org/associatedMedia |
263
|
|
|
*/ |
264
|
|
|
public function associatedMedia($associatedMedia) |
265
|
|
|
{ |
266
|
|
|
return $this->setProperty('associatedMedia', $associatedMedia); |
267
|
|
|
} |
268
|
|
|
|
269
|
|
|
/** |
270
|
|
|
* An intended audience, i.e. a group for whom something was created. |
271
|
|
|
* |
272
|
|
|
* @param \Spatie\SchemaOrg\Contracts\AudienceContract|\Spatie\SchemaOrg\Contracts\AudienceContract[] $audience |
273
|
|
|
* |
274
|
|
|
* @return static |
275
|
|
|
* |
276
|
|
|
* @see http://schema.org/audience |
277
|
|
|
*/ |
278
|
|
|
public function audience($audience) |
279
|
|
|
{ |
280
|
|
|
return $this->setProperty('audience', $audience); |
281
|
|
|
} |
282
|
|
|
|
283
|
|
|
/** |
284
|
|
|
* An embedded audio object. |
285
|
|
|
* |
286
|
|
|
* @param \Spatie\SchemaOrg\Contracts\AudioObjectContract|\Spatie\SchemaOrg\Contracts\AudioObjectContract[]|\Spatie\SchemaOrg\Contracts\ClipContract|\Spatie\SchemaOrg\Contracts\ClipContract[] $audio |
287
|
|
|
* |
288
|
|
|
* @return static |
289
|
|
|
* |
290
|
|
|
* @see http://schema.org/audio |
291
|
|
|
*/ |
292
|
|
|
public function audio($audio) |
293
|
|
|
{ |
294
|
|
|
return $this->setProperty('audio', $audio); |
295
|
|
|
} |
296
|
|
|
|
297
|
|
|
/** |
298
|
|
|
* The author of this content or rating. Please note that author is special |
299
|
|
|
* in that HTML 5 provides a special mechanism for indicating authorship via |
300
|
|
|
* the rel tag. That is equivalent to this and may be used interchangeably. |
301
|
|
|
* |
302
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $author |
303
|
|
|
* |
304
|
|
|
* @return static |
305
|
|
|
* |
306
|
|
|
* @see http://schema.org/author |
307
|
|
|
*/ |
308
|
|
|
public function author($author) |
309
|
|
|
{ |
310
|
|
|
return $this->setProperty('author', $author); |
311
|
|
|
} |
312
|
|
|
|
313
|
|
|
/** |
314
|
|
|
* An award won by or for this item. |
315
|
|
|
* |
316
|
|
|
* @param string|string[] $award |
317
|
|
|
* |
318
|
|
|
* @return static |
319
|
|
|
* |
320
|
|
|
* @see http://schema.org/award |
321
|
|
|
*/ |
322
|
|
|
public function award($award) |
323
|
|
|
{ |
324
|
|
|
return $this->setProperty('award', $award); |
325
|
|
|
} |
326
|
|
|
|
327
|
|
|
/** |
328
|
|
|
* Awards won by or for this item. |
329
|
|
|
* |
330
|
|
|
* @param string|string[] $awards |
331
|
|
|
* |
332
|
|
|
* @return static |
333
|
|
|
* |
334
|
|
|
* @see http://schema.org/awards |
335
|
|
|
*/ |
336
|
|
|
public function awards($awards) |
337
|
|
|
{ |
338
|
|
|
return $this->setProperty('awards', $awards); |
339
|
|
|
} |
340
|
|
|
|
341
|
|
|
/** |
342
|
|
|
* Fictional person connected with a creative work. |
343
|
|
|
* |
344
|
|
|
* @param \Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $character |
345
|
|
|
* |
346
|
|
|
* @return static |
347
|
|
|
* |
348
|
|
|
* @see http://schema.org/character |
349
|
|
|
*/ |
350
|
|
|
public function character($character) |
351
|
|
|
{ |
352
|
|
|
return $this->setProperty('character', $character); |
353
|
|
|
} |
354
|
|
|
|
355
|
|
|
/** |
356
|
|
|
* A citation or reference to another creative work, such as another |
357
|
|
|
* publication, web page, scholarly article, etc. |
358
|
|
|
* |
359
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $citation |
360
|
|
|
* |
361
|
|
|
* @return static |
362
|
|
|
* |
363
|
|
|
* @see http://schema.org/citation |
364
|
|
|
*/ |
365
|
|
|
public function citation($citation) |
366
|
|
|
{ |
367
|
|
|
return $this->setProperty('citation', $citation); |
368
|
|
|
} |
369
|
|
|
|
370
|
|
|
/** |
371
|
|
|
* Comments, typically from users. |
372
|
|
|
* |
373
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CommentContract|\Spatie\SchemaOrg\Contracts\CommentContract[] $comment |
374
|
|
|
* |
375
|
|
|
* @return static |
376
|
|
|
* |
377
|
|
|
* @see http://schema.org/comment |
378
|
|
|
*/ |
379
|
|
|
public function comment($comment) |
380
|
|
|
{ |
381
|
|
|
return $this->setProperty('comment', $comment); |
382
|
|
|
} |
383
|
|
|
|
384
|
|
|
/** |
385
|
|
|
* The number of comments this CreativeWork (e.g. Article, Question or |
386
|
|
|
* Answer) has received. This is most applicable to works published in Web |
387
|
|
|
* sites with commenting system; additional comments may exist elsewhere. |
388
|
|
|
* |
389
|
|
|
* @param int|int[] $commentCount |
390
|
|
|
* |
391
|
|
|
* @return static |
392
|
|
|
* |
393
|
|
|
* @see http://schema.org/commentCount |
394
|
|
|
*/ |
395
|
|
|
public function commentCount($commentCount) |
396
|
|
|
{ |
397
|
|
|
return $this->setProperty('commentCount', $commentCount); |
398
|
|
|
} |
399
|
|
|
|
400
|
|
|
/** |
401
|
|
|
* The location depicted or described in the content. For example, the |
402
|
|
|
* location in a photograph or painting. |
403
|
|
|
* |
404
|
|
|
* @param \Spatie\SchemaOrg\Contracts\PlaceContract|\Spatie\SchemaOrg\Contracts\PlaceContract[] $contentLocation |
405
|
|
|
* |
406
|
|
|
* @return static |
407
|
|
|
* |
408
|
|
|
* @see http://schema.org/contentLocation |
409
|
|
|
*/ |
410
|
|
|
public function contentLocation($contentLocation) |
411
|
|
|
{ |
412
|
|
|
return $this->setProperty('contentLocation', $contentLocation); |
413
|
|
|
} |
414
|
|
|
|
415
|
|
|
/** |
416
|
|
|
* Official rating of a piece of content—for example,'MPAA PG-13'. |
417
|
|
|
* |
418
|
|
|
* @param \Spatie\SchemaOrg\Contracts\RatingContract|\Spatie\SchemaOrg\Contracts\RatingContract[]|string|string[] $contentRating |
419
|
|
|
* |
420
|
|
|
* @return static |
421
|
|
|
* |
422
|
|
|
* @see http://schema.org/contentRating |
423
|
|
|
*/ |
424
|
|
|
public function contentRating($contentRating) |
425
|
|
|
{ |
426
|
|
|
return $this->setProperty('contentRating', $contentRating); |
427
|
|
|
} |
428
|
|
|
|
429
|
|
|
/** |
430
|
|
|
* A secondary contributor to the CreativeWork or Event. |
431
|
|
|
* |
432
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $contributor |
433
|
|
|
* |
434
|
|
|
* @return static |
435
|
|
|
* |
436
|
|
|
* @see http://schema.org/contributor |
437
|
|
|
*/ |
438
|
|
|
public function contributor($contributor) |
439
|
|
|
{ |
440
|
|
|
return $this->setProperty('contributor', $contributor); |
441
|
|
|
} |
442
|
|
|
|
443
|
|
|
/** |
444
|
|
|
* The party holding the legal copyright to the CreativeWork. |
445
|
|
|
* |
446
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $copyrightHolder |
447
|
|
|
* |
448
|
|
|
* @return static |
449
|
|
|
* |
450
|
|
|
* @see http://schema.org/copyrightHolder |
451
|
|
|
*/ |
452
|
|
|
public function copyrightHolder($copyrightHolder) |
453
|
|
|
{ |
454
|
|
|
return $this->setProperty('copyrightHolder', $copyrightHolder); |
455
|
|
|
} |
456
|
|
|
|
457
|
|
|
/** |
458
|
|
|
* The year during which the claimed copyright for the CreativeWork was |
459
|
|
|
* first asserted. |
460
|
|
|
* |
461
|
|
|
* @param float|float[]|int|int[] $copyrightYear |
462
|
|
|
* |
463
|
|
|
* @return static |
464
|
|
|
* |
465
|
|
|
* @see http://schema.org/copyrightYear |
466
|
|
|
*/ |
467
|
|
|
public function copyrightYear($copyrightYear) |
468
|
|
|
{ |
469
|
|
|
return $this->setProperty('copyrightYear', $copyrightYear); |
470
|
|
|
} |
471
|
|
|
|
472
|
|
|
/** |
473
|
|
|
* The creator/author of this CreativeWork. This is the same as the Author |
474
|
|
|
* property for CreativeWork. |
475
|
|
|
* |
476
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $creator |
477
|
|
|
* |
478
|
|
|
* @return static |
479
|
|
|
* |
480
|
|
|
* @see http://schema.org/creator |
481
|
|
|
*/ |
482
|
|
|
public function creator($creator) |
483
|
|
|
{ |
484
|
|
|
return $this->setProperty('creator', $creator); |
485
|
|
|
} |
486
|
|
|
|
487
|
|
|
/** |
488
|
|
|
* The date on which the CreativeWork was created or the item was added to a |
489
|
|
|
* DataFeed. |
490
|
|
|
* |
491
|
|
|
* @param \DateTimeInterface|\DateTimeInterface[] $dateCreated |
492
|
|
|
* |
493
|
|
|
* @return static |
494
|
|
|
* |
495
|
|
|
* @see http://schema.org/dateCreated |
496
|
|
|
*/ |
497
|
|
|
public function dateCreated($dateCreated) |
498
|
|
|
{ |
499
|
|
|
return $this->setProperty('dateCreated', $dateCreated); |
500
|
|
|
} |
501
|
|
|
|
502
|
|
|
/** |
503
|
|
|
* The date on which the CreativeWork was most recently modified or when the |
504
|
|
|
* item's entry was modified within a DataFeed. |
505
|
|
|
* |
506
|
|
|
* @param \DateTimeInterface|\DateTimeInterface[] $dateModified |
507
|
|
|
* |
508
|
|
|
* @return static |
509
|
|
|
* |
510
|
|
|
* @see http://schema.org/dateModified |
511
|
|
|
*/ |
512
|
|
|
public function dateModified($dateModified) |
513
|
|
|
{ |
514
|
|
|
return $this->setProperty('dateModified', $dateModified); |
515
|
|
|
} |
516
|
|
|
|
517
|
|
|
/** |
518
|
|
|
* Date of first broadcast/publication. |
519
|
|
|
* |
520
|
|
|
* @param \DateTimeInterface|\DateTimeInterface[] $datePublished |
521
|
|
|
* |
522
|
|
|
* @return static |
523
|
|
|
* |
524
|
|
|
* @see http://schema.org/datePublished |
525
|
|
|
*/ |
526
|
|
|
public function datePublished($datePublished) |
527
|
|
|
{ |
528
|
|
|
return $this->setProperty('datePublished', $datePublished); |
529
|
|
|
} |
530
|
|
|
|
531
|
|
|
/** |
532
|
|
|
* A description of the item. |
533
|
|
|
* |
534
|
|
|
* @param string|string[] $description |
535
|
|
|
* |
536
|
|
|
* @return static |
537
|
|
|
* |
538
|
|
|
* @see http://schema.org/description |
539
|
|
|
*/ |
540
|
|
|
public function description($description) |
541
|
|
|
{ |
542
|
|
|
return $this->setProperty('description', $description); |
543
|
|
|
} |
544
|
|
|
|
545
|
|
|
/** |
546
|
|
|
* A sub property of description. A short description of the item used to |
547
|
|
|
* disambiguate from other, similar items. Information from other properties |
548
|
|
|
* (in particular, name) may be necessary for the description to be useful |
549
|
|
|
* for disambiguation. |
550
|
|
|
* |
551
|
|
|
* @param string|string[] $disambiguatingDescription |
552
|
|
|
* |
553
|
|
|
* @return static |
554
|
|
|
* |
555
|
|
|
* @see http://schema.org/disambiguatingDescription |
556
|
|
|
*/ |
557
|
|
|
public function disambiguatingDescription($disambiguatingDescription) |
558
|
|
|
{ |
559
|
|
|
return $this->setProperty('disambiguatingDescription', $disambiguatingDescription); |
560
|
|
|
} |
561
|
|
|
|
562
|
|
|
/** |
563
|
|
|
* A link to the page containing the comments of the CreativeWork. |
564
|
|
|
* |
565
|
|
|
* @param string|string[] $discussionUrl |
566
|
|
|
* |
567
|
|
|
* @return static |
568
|
|
|
* |
569
|
|
|
* @see http://schema.org/discussionUrl |
570
|
|
|
*/ |
571
|
|
|
public function discussionUrl($discussionUrl) |
572
|
|
|
{ |
573
|
|
|
return $this->setProperty('discussionUrl', $discussionUrl); |
574
|
|
|
} |
575
|
|
|
|
576
|
|
|
/** |
577
|
|
|
* Specifies the Person who edited the CreativeWork. |
578
|
|
|
* |
579
|
|
|
* @param \Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $editor |
580
|
|
|
* |
581
|
|
|
* @return static |
582
|
|
|
* |
583
|
|
|
* @see http://schema.org/editor |
584
|
|
|
*/ |
585
|
|
|
public function editor($editor) |
586
|
|
|
{ |
587
|
|
|
return $this->setProperty('editor', $editor); |
588
|
|
|
} |
589
|
|
|
|
590
|
|
|
/** |
591
|
|
|
* An alignment to an established educational framework. |
592
|
|
|
* |
593
|
|
|
* @param \Spatie\SchemaOrg\Contracts\AlignmentObjectContract|\Spatie\SchemaOrg\Contracts\AlignmentObjectContract[] $educationalAlignment |
594
|
|
|
* |
595
|
|
|
* @return static |
596
|
|
|
* |
597
|
|
|
* @see http://schema.org/educationalAlignment |
598
|
|
|
*/ |
599
|
|
|
public function educationalAlignment($educationalAlignment) |
600
|
|
|
{ |
601
|
|
|
return $this->setProperty('educationalAlignment', $educationalAlignment); |
602
|
|
|
} |
603
|
|
|
|
604
|
|
|
/** |
605
|
|
|
* The purpose of a work in the context of education; for example, |
606
|
|
|
* 'assignment', 'group work'. |
607
|
|
|
* |
608
|
|
|
* @param string|string[] $educationalUse |
609
|
|
|
* |
610
|
|
|
* @return static |
611
|
|
|
* |
612
|
|
|
* @see http://schema.org/educationalUse |
613
|
|
|
*/ |
614
|
|
|
public function educationalUse($educationalUse) |
615
|
|
|
{ |
616
|
|
|
return $this->setProperty('educationalUse', $educationalUse); |
617
|
|
|
} |
618
|
|
|
|
619
|
|
|
/** |
620
|
|
|
* A media object that encodes this CreativeWork. This property is a synonym |
621
|
|
|
* for associatedMedia. |
622
|
|
|
* |
623
|
|
|
* @param \Spatie\SchemaOrg\Contracts\MediaObjectContract|\Spatie\SchemaOrg\Contracts\MediaObjectContract[] $encoding |
624
|
|
|
* |
625
|
|
|
* @return static |
626
|
|
|
* |
627
|
|
|
* @see http://schema.org/encoding |
628
|
|
|
*/ |
629
|
|
|
public function encoding($encoding) |
630
|
|
|
{ |
631
|
|
|
return $this->setProperty('encoding', $encoding); |
632
|
|
|
} |
633
|
|
|
|
634
|
|
|
/** |
635
|
|
|
* Media type typically expressed using a MIME format (see [IANA |
636
|
|
|
* site](http://www.iana.org/assignments/media-types/media-types.xhtml) and |
637
|
|
|
* [MDN |
638
|
|
|
* reference](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types)) |
639
|
|
|
* e.g. application/zip for a SoftwareApplication binary, audio/mpeg for |
640
|
|
|
* .mp3 etc.). |
641
|
|
|
* |
642
|
|
|
* In cases where a [[CreativeWork]] has several media type representations, |
643
|
|
|
* [[encoding]] can be used to indicate each [[MediaObject]] alongside |
644
|
|
|
* particular [[encodingFormat]] information. |
645
|
|
|
* |
646
|
|
|
* Unregistered or niche encoding and file formats can be indicated instead |
647
|
|
|
* via the most appropriate URL, e.g. defining Web page or a |
648
|
|
|
* Wikipedia/Wikidata entry. |
649
|
|
|
* |
650
|
|
|
* @param string|string[] $encodingFormat |
651
|
|
|
* |
652
|
|
|
* @return static |
653
|
|
|
* |
654
|
|
|
* @see http://schema.org/encodingFormat |
655
|
|
|
*/ |
656
|
|
|
public function encodingFormat($encodingFormat) |
657
|
|
|
{ |
658
|
|
|
return $this->setProperty('encodingFormat', $encodingFormat); |
659
|
|
|
} |
660
|
|
|
|
661
|
|
|
/** |
662
|
|
|
* A media object that encodes this CreativeWork. |
663
|
|
|
* |
664
|
|
|
* @param \Spatie\SchemaOrg\Contracts\MediaObjectContract|\Spatie\SchemaOrg\Contracts\MediaObjectContract[] $encodings |
665
|
|
|
* |
666
|
|
|
* @return static |
667
|
|
|
* |
668
|
|
|
* @see http://schema.org/encodings |
669
|
|
|
*/ |
670
|
|
|
public function encodings($encodings) |
671
|
|
|
{ |
672
|
|
|
return $this->setProperty('encodings', $encodings); |
673
|
|
|
} |
674
|
|
|
|
675
|
|
|
/** |
676
|
|
|
* A creative work that this work is an |
677
|
|
|
* example/instance/realization/derivation of. |
678
|
|
|
* |
679
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[] $exampleOfWork |
680
|
|
|
* |
681
|
|
|
* @return static |
682
|
|
|
* |
683
|
|
|
* @see http://schema.org/exampleOfWork |
684
|
|
|
*/ |
685
|
|
|
public function exampleOfWork($exampleOfWork) |
686
|
|
|
{ |
687
|
|
|
return $this->setProperty('exampleOfWork', $exampleOfWork); |
688
|
|
|
} |
689
|
|
|
|
690
|
|
|
/** |
691
|
|
|
* Date the content expires and is no longer useful or available. For |
692
|
|
|
* example a [[VideoObject]] or [[NewsArticle]] whose availability or |
693
|
|
|
* relevance is time-limited, or a [[ClaimReview]] fact check whose |
694
|
|
|
* publisher wants to indicate that it may no longer be relevant (or helpful |
695
|
|
|
* to highlight) after some date. |
696
|
|
|
* |
697
|
|
|
* @param \DateTimeInterface|\DateTimeInterface[] $expires |
698
|
|
|
* |
699
|
|
|
* @return static |
700
|
|
|
* |
701
|
|
|
* @see http://schema.org/expires |
702
|
|
|
*/ |
703
|
|
|
public function expires($expires) |
704
|
|
|
{ |
705
|
|
|
return $this->setProperty('expires', $expires); |
706
|
|
|
} |
707
|
|
|
|
708
|
|
|
/** |
709
|
|
|
* Media type, typically MIME format (see [IANA |
710
|
|
|
* site](http://www.iana.org/assignments/media-types/media-types.xhtml)) of |
711
|
|
|
* the content e.g. application/zip of a SoftwareApplication binary. In |
712
|
|
|
* cases where a CreativeWork has several media type representations, |
713
|
|
|
* 'encoding' can be used to indicate each MediaObject alongside particular |
714
|
|
|
* fileFormat information. Unregistered or niche file formats can be |
715
|
|
|
* indicated instead via the most appropriate URL, e.g. defining Web page or |
716
|
|
|
* a Wikipedia entry. |
717
|
|
|
* |
718
|
|
|
* @param string|string[] $fileFormat |
719
|
|
|
* |
720
|
|
|
* @return static |
721
|
|
|
* |
722
|
|
|
* @see http://schema.org/fileFormat |
723
|
|
|
*/ |
724
|
|
|
public function fileFormat($fileFormat) |
725
|
|
|
{ |
726
|
|
|
return $this->setProperty('fileFormat', $fileFormat); |
727
|
|
|
} |
728
|
|
|
|
729
|
|
|
/** |
730
|
|
|
* A person or organization that supports (sponsors) something through some |
731
|
|
|
* kind of financial contribution. |
732
|
|
|
* |
733
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $funder |
734
|
|
|
* |
735
|
|
|
* @return static |
736
|
|
|
* |
737
|
|
|
* @see http://schema.org/funder |
738
|
|
|
*/ |
739
|
|
|
public function funder($funder) |
740
|
|
|
{ |
741
|
|
|
return $this->setProperty('funder', $funder); |
742
|
|
|
} |
743
|
|
|
|
744
|
|
|
/** |
745
|
|
|
* Genre of the creative work, broadcast channel or group. |
746
|
|
|
* |
747
|
|
|
* @param string|string[] $genre |
748
|
|
|
* |
749
|
|
|
* @return static |
750
|
|
|
* |
751
|
|
|
* @see http://schema.org/genre |
752
|
|
|
*/ |
753
|
|
|
public function genre($genre) |
754
|
|
|
{ |
755
|
|
|
return $this->setProperty('genre', $genre); |
756
|
|
|
} |
757
|
|
|
|
758
|
|
|
/** |
759
|
|
|
* Indicates an item or CreativeWork that is part of this item, or |
760
|
|
|
* CreativeWork (in some sense). |
761
|
|
|
* |
762
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[] $hasPart |
763
|
|
|
* |
764
|
|
|
* @return static |
765
|
|
|
* |
766
|
|
|
* @see http://schema.org/hasPart |
767
|
|
|
*/ |
768
|
|
|
public function hasPart($hasPart) |
769
|
|
|
{ |
770
|
|
|
return $this->setProperty('hasPart', $hasPart); |
771
|
|
|
} |
772
|
|
|
|
773
|
|
|
/** |
774
|
|
|
* Headline of the article. |
775
|
|
|
* |
776
|
|
|
* @param string|string[] $headline |
777
|
|
|
* |
778
|
|
|
* @return static |
779
|
|
|
* |
780
|
|
|
* @see http://schema.org/headline |
781
|
|
|
*/ |
782
|
|
|
public function headline($headline) |
783
|
|
|
{ |
784
|
|
|
return $this->setProperty('headline', $headline); |
785
|
|
|
} |
786
|
|
|
|
787
|
|
|
/** |
788
|
|
|
* The identifier property represents any kind of identifier for any kind of |
789
|
|
|
* [[Thing]], such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides |
790
|
|
|
* dedicated properties for representing many of these, either as textual |
791
|
|
|
* strings or as URL (URI) links. See [background |
792
|
|
|
* notes](/docs/datamodel.html#identifierBg) for more details. |
793
|
|
|
* |
794
|
|
|
* @param \Spatie\SchemaOrg\Contracts\PropertyValueContract|\Spatie\SchemaOrg\Contracts\PropertyValueContract[]|string|string[] $identifier |
795
|
|
|
* |
796
|
|
|
* @return static |
797
|
|
|
* |
798
|
|
|
* @see http://schema.org/identifier |
799
|
|
|
*/ |
800
|
|
|
public function identifier($identifier) |
801
|
|
|
{ |
802
|
|
|
return $this->setProperty('identifier', $identifier); |
803
|
|
|
} |
804
|
|
|
|
805
|
|
|
/** |
806
|
|
|
* An image of the item. This can be a [[URL]] or a fully described |
807
|
|
|
* [[ImageObject]]. |
808
|
|
|
* |
809
|
|
|
* @param \Spatie\SchemaOrg\Contracts\ImageObjectContract|\Spatie\SchemaOrg\Contracts\ImageObjectContract[]|string|string[] $image |
810
|
|
|
* |
811
|
|
|
* @return static |
812
|
|
|
* |
813
|
|
|
* @see http://schema.org/image |
814
|
|
|
*/ |
815
|
|
|
public function image($image) |
816
|
|
|
{ |
817
|
|
|
return $this->setProperty('image', $image); |
818
|
|
|
} |
819
|
|
|
|
820
|
|
|
/** |
821
|
|
|
* The language of the content or performance or used in an action. Please |
822
|
|
|
* use one of the language codes from the [IETF BCP 47 |
823
|
|
|
* standard](http://tools.ietf.org/html/bcp47). See also |
824
|
|
|
* [[availableLanguage]]. |
825
|
|
|
* |
826
|
|
|
* @param \Spatie\SchemaOrg\Contracts\LanguageContract|\Spatie\SchemaOrg\Contracts\LanguageContract[]|string|string[] $inLanguage |
827
|
|
|
* |
828
|
|
|
* @return static |
829
|
|
|
* |
830
|
|
|
* @see http://schema.org/inLanguage |
831
|
|
|
*/ |
832
|
|
|
public function inLanguage($inLanguage) |
833
|
|
|
{ |
834
|
|
|
return $this->setProperty('inLanguage', $inLanguage); |
835
|
|
|
} |
836
|
|
|
|
837
|
|
|
/** |
838
|
|
|
* The number of interactions for the CreativeWork using the WebSite or |
839
|
|
|
* SoftwareApplication. The most specific child type of InteractionCounter |
840
|
|
|
* should be used. |
841
|
|
|
* |
842
|
|
|
* @param \Spatie\SchemaOrg\Contracts\InteractionCounterContract|\Spatie\SchemaOrg\Contracts\InteractionCounterContract[] $interactionStatistic |
843
|
|
|
* |
844
|
|
|
* @return static |
845
|
|
|
* |
846
|
|
|
* @see http://schema.org/interactionStatistic |
847
|
|
|
*/ |
848
|
|
|
public function interactionStatistic($interactionStatistic) |
849
|
|
|
{ |
850
|
|
|
return $this->setProperty('interactionStatistic', $interactionStatistic); |
851
|
|
|
} |
852
|
|
|
|
853
|
|
|
/** |
854
|
|
|
* The predominant mode of learning supported by the learning resource. |
855
|
|
|
* Acceptable values are 'active', 'expositive', or 'mixed'. |
856
|
|
|
* |
857
|
|
|
* @param string|string[] $interactivityType |
858
|
|
|
* |
859
|
|
|
* @return static |
860
|
|
|
* |
861
|
|
|
* @see http://schema.org/interactivityType |
862
|
|
|
*/ |
863
|
|
|
public function interactivityType($interactivityType) |
864
|
|
|
{ |
865
|
|
|
return $this->setProperty('interactivityType', $interactivityType); |
866
|
|
|
} |
867
|
|
|
|
868
|
|
|
/** |
869
|
|
|
* A flag to signal that the item, event, or place is accessible for free. |
870
|
|
|
* |
871
|
|
|
* @param bool|bool[] $isAccessibleForFree |
872
|
|
|
* |
873
|
|
|
* @return static |
874
|
|
|
* |
875
|
|
|
* @see http://schema.org/isAccessibleForFree |
876
|
|
|
*/ |
877
|
|
|
public function isAccessibleForFree($isAccessibleForFree) |
878
|
|
|
{ |
879
|
|
|
return $this->setProperty('isAccessibleForFree', $isAccessibleForFree); |
880
|
|
|
} |
881
|
|
|
|
882
|
|
|
/** |
883
|
|
|
* A resource from which this work is derived or from which it is a |
884
|
|
|
* modification or adaption. |
885
|
|
|
* |
886
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|\Spatie\SchemaOrg\Contracts\ProductContract|\Spatie\SchemaOrg\Contracts\ProductContract[]|string|string[] $isBasedOn |
887
|
|
|
* |
888
|
|
|
* @return static |
889
|
|
|
* |
890
|
|
|
* @see http://schema.org/isBasedOn |
891
|
|
|
*/ |
892
|
|
|
public function isBasedOn($isBasedOn) |
893
|
|
|
{ |
894
|
|
|
return $this->setProperty('isBasedOn', $isBasedOn); |
895
|
|
|
} |
896
|
|
|
|
897
|
|
|
/** |
898
|
|
|
* A resource that was used in the creation of this resource. This term can |
899
|
|
|
* be repeated for multiple sources. For example, |
900
|
|
|
* http://example.com/great-multiplication-intro.html. |
901
|
|
|
* |
902
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|\Spatie\SchemaOrg\Contracts\ProductContract|\Spatie\SchemaOrg\Contracts\ProductContract[]|string|string[] $isBasedOnUrl |
903
|
|
|
* |
904
|
|
|
* @return static |
905
|
|
|
* |
906
|
|
|
* @see http://schema.org/isBasedOnUrl |
907
|
|
|
*/ |
908
|
|
|
public function isBasedOnUrl($isBasedOnUrl) |
909
|
|
|
{ |
910
|
|
|
return $this->setProperty('isBasedOnUrl', $isBasedOnUrl); |
911
|
|
|
} |
912
|
|
|
|
913
|
|
|
/** |
914
|
|
|
* Indicates whether this content is family friendly. |
915
|
|
|
* |
916
|
|
|
* @param bool|bool[] $isFamilyFriendly |
917
|
|
|
* |
918
|
|
|
* @return static |
919
|
|
|
* |
920
|
|
|
* @see http://schema.org/isFamilyFriendly |
921
|
|
|
*/ |
922
|
|
|
public function isFamilyFriendly($isFamilyFriendly) |
923
|
|
|
{ |
924
|
|
|
return $this->setProperty('isFamilyFriendly', $isFamilyFriendly); |
925
|
|
|
} |
926
|
|
|
|
927
|
|
|
/** |
928
|
|
|
* Indicates an item or CreativeWork that this item, or CreativeWork (in |
929
|
|
|
* some sense), is part of. |
930
|
|
|
* |
931
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $isPartOf |
932
|
|
|
* |
933
|
|
|
* @return static |
934
|
|
|
* |
935
|
|
|
* @see http://schema.org/isPartOf |
936
|
|
|
*/ |
937
|
|
|
public function isPartOf($isPartOf) |
938
|
|
|
{ |
939
|
|
|
return $this->setProperty('isPartOf', $isPartOf); |
940
|
|
|
} |
941
|
|
|
|
942
|
|
|
/** |
943
|
|
|
* Keywords or tags used to describe this content. Multiple entries in a |
944
|
|
|
* keywords list are typically delimited by commas. |
945
|
|
|
* |
946
|
|
|
* @param string|string[] $keywords |
947
|
|
|
* |
948
|
|
|
* @return static |
949
|
|
|
* |
950
|
|
|
* @see http://schema.org/keywords |
951
|
|
|
*/ |
952
|
|
|
public function keywords($keywords) |
953
|
|
|
{ |
954
|
|
|
return $this->setProperty('keywords', $keywords); |
955
|
|
|
} |
956
|
|
|
|
957
|
|
|
/** |
958
|
|
|
* The predominant type or kind characterizing the learning resource. For |
959
|
|
|
* example, 'presentation', 'handout'. |
960
|
|
|
* |
961
|
|
|
* @param string|string[] $learningResourceType |
962
|
|
|
* |
963
|
|
|
* @return static |
964
|
|
|
* |
965
|
|
|
* @see http://schema.org/learningResourceType |
966
|
|
|
*/ |
967
|
|
|
public function learningResourceType($learningResourceType) |
968
|
|
|
{ |
969
|
|
|
return $this->setProperty('learningResourceType', $learningResourceType); |
970
|
|
|
} |
971
|
|
|
|
972
|
|
|
/** |
973
|
|
|
* A license document that applies to this content, typically indicated by |
974
|
|
|
* URL. |
975
|
|
|
* |
976
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $license |
977
|
|
|
* |
978
|
|
|
* @return static |
979
|
|
|
* |
980
|
|
|
* @see http://schema.org/license |
981
|
|
|
*/ |
982
|
|
|
public function license($license) |
983
|
|
|
{ |
984
|
|
|
return $this->setProperty('license', $license); |
985
|
|
|
} |
986
|
|
|
|
987
|
|
|
/** |
988
|
|
|
* The location where the CreativeWork was created, which may not be the |
989
|
|
|
* same as the location depicted in the CreativeWork. |
990
|
|
|
* |
991
|
|
|
* @param \Spatie\SchemaOrg\Contracts\PlaceContract|\Spatie\SchemaOrg\Contracts\PlaceContract[] $locationCreated |
992
|
|
|
* |
993
|
|
|
* @return static |
994
|
|
|
* |
995
|
|
|
* @see http://schema.org/locationCreated |
996
|
|
|
*/ |
997
|
|
|
public function locationCreated($locationCreated) |
998
|
|
|
{ |
999
|
|
|
return $this->setProperty('locationCreated', $locationCreated); |
1000
|
|
|
} |
1001
|
|
|
|
1002
|
|
|
/** |
1003
|
|
|
* Indicates the primary entity described in some page or other |
1004
|
|
|
* CreativeWork. |
1005
|
|
|
* |
1006
|
|
|
* @param \Spatie\SchemaOrg\Contracts\ThingContract|\Spatie\SchemaOrg\Contracts\ThingContract[] $mainEntity |
1007
|
|
|
* |
1008
|
|
|
* @return static |
1009
|
|
|
* |
1010
|
|
|
* @see http://schema.org/mainEntity |
1011
|
|
|
*/ |
1012
|
|
|
public function mainEntity($mainEntity) |
1013
|
|
|
{ |
1014
|
|
|
return $this->setProperty('mainEntity', $mainEntity); |
1015
|
|
|
} |
1016
|
|
|
|
1017
|
|
|
/** |
1018
|
|
|
* Indicates a page (or other CreativeWork) for which this thing is the main |
1019
|
|
|
* entity being described. See [background |
1020
|
|
|
* notes](/docs/datamodel.html#mainEntityBackground) for details. |
1021
|
|
|
* |
1022
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $mainEntityOfPage |
1023
|
|
|
* |
1024
|
|
|
* @return static |
1025
|
|
|
* |
1026
|
|
|
* @see http://schema.org/mainEntityOfPage |
1027
|
|
|
*/ |
1028
|
|
|
public function mainEntityOfPage($mainEntityOfPage) |
1029
|
|
|
{ |
1030
|
|
|
return $this->setProperty('mainEntityOfPage', $mainEntityOfPage); |
1031
|
|
|
} |
1032
|
|
|
|
1033
|
|
|
/** |
1034
|
|
|
* A material that something is made from, e.g. leather, wool, cotton, |
1035
|
|
|
* paper. |
1036
|
|
|
* |
1037
|
|
|
* @param \Spatie\SchemaOrg\Contracts\ProductContract|\Spatie\SchemaOrg\Contracts\ProductContract[]|string|string[] $material |
1038
|
|
|
* |
1039
|
|
|
* @return static |
1040
|
|
|
* |
1041
|
|
|
* @see http://schema.org/material |
1042
|
|
|
*/ |
1043
|
|
|
public function material($material) |
1044
|
|
|
{ |
1045
|
|
|
return $this->setProperty('material', $material); |
1046
|
|
|
} |
1047
|
|
|
|
1048
|
|
|
/** |
1049
|
|
|
* Indicates that the CreativeWork contains a reference to, but is not |
1050
|
|
|
* necessarily about a concept. |
1051
|
|
|
* |
1052
|
|
|
* @param \Spatie\SchemaOrg\Contracts\ThingContract|\Spatie\SchemaOrg\Contracts\ThingContract[] $mentions |
1053
|
|
|
* |
1054
|
|
|
* @return static |
1055
|
|
|
* |
1056
|
|
|
* @see http://schema.org/mentions |
1057
|
|
|
*/ |
1058
|
|
|
public function mentions($mentions) |
1059
|
|
|
{ |
1060
|
|
|
return $this->setProperty('mentions', $mentions); |
1061
|
|
|
} |
1062
|
|
|
|
1063
|
|
|
/** |
1064
|
|
|
* The name of the item. |
1065
|
|
|
* |
1066
|
|
|
* @param string|string[] $name |
1067
|
|
|
* |
1068
|
|
|
* @return static |
1069
|
|
|
* |
1070
|
|
|
* @see http://schema.org/name |
1071
|
|
|
*/ |
1072
|
|
|
public function name($name) |
1073
|
|
|
{ |
1074
|
|
|
return $this->setProperty('name', $name); |
1075
|
|
|
} |
1076
|
|
|
|
1077
|
|
|
/** |
1078
|
|
|
* An offer to provide this item—for example, an offer to sell a |
1079
|
|
|
* product, rent the DVD of a movie, perform a service, or give away tickets |
1080
|
|
|
* to an event. Use [[businessFunction]] to indicate the kind of transaction |
1081
|
|
|
* offered, i.e. sell, lease, etc. This property can also be used to |
1082
|
|
|
* describe a [[Demand]]. While this property is listed as expected on a |
1083
|
|
|
* number of common types, it can be used in others. In that case, using a |
1084
|
|
|
* second type, such as Product or a subtype of Product, can clarify the |
1085
|
|
|
* nature of the offer. |
1086
|
|
|
* |
1087
|
|
|
* @param \Spatie\SchemaOrg\Contracts\DemandContract|\Spatie\SchemaOrg\Contracts\DemandContract[]|\Spatie\SchemaOrg\Contracts\OfferContract|\Spatie\SchemaOrg\Contracts\OfferContract[] $offers |
1088
|
|
|
* |
1089
|
|
|
* @return static |
1090
|
|
|
* |
1091
|
|
|
* @see http://schema.org/offers |
1092
|
|
|
*/ |
1093
|
|
|
public function offers($offers) |
1094
|
|
|
{ |
1095
|
|
|
return $this->setProperty('offers', $offers); |
1096
|
|
|
} |
1097
|
|
|
|
1098
|
|
|
/** |
1099
|
|
|
* The page on which the work ends; for example "138" or "xvi". |
1100
|
|
|
* |
1101
|
|
|
* @param int|int[]|string|string[] $pageEnd |
1102
|
|
|
* |
1103
|
|
|
* @return static |
1104
|
|
|
* |
1105
|
|
|
* @see http://schema.org/pageEnd |
1106
|
|
|
*/ |
1107
|
|
|
public function pageEnd($pageEnd) |
1108
|
|
|
{ |
1109
|
|
|
return $this->setProperty('pageEnd', $pageEnd); |
1110
|
|
|
} |
1111
|
|
|
|
1112
|
|
|
/** |
1113
|
|
|
* The page on which the work starts; for example "135" or "xiii". |
1114
|
|
|
* |
1115
|
|
|
* @param int|int[]|string|string[] $pageStart |
1116
|
|
|
* |
1117
|
|
|
* @return static |
1118
|
|
|
* |
1119
|
|
|
* @see http://schema.org/pageStart |
1120
|
|
|
*/ |
1121
|
|
|
public function pageStart($pageStart) |
1122
|
|
|
{ |
1123
|
|
|
return $this->setProperty('pageStart', $pageStart); |
1124
|
|
|
} |
1125
|
|
|
|
1126
|
|
|
/** |
1127
|
|
|
* Any description of pages that is not separated into pageStart and |
1128
|
|
|
* pageEnd; for example, "1-6, 9, 55" or "10-12, 46-49". |
1129
|
|
|
* |
1130
|
|
|
* @param string|string[] $pagination |
1131
|
|
|
* |
1132
|
|
|
* @return static |
1133
|
|
|
* |
1134
|
|
|
* @see http://schema.org/pagination |
1135
|
|
|
*/ |
1136
|
|
|
public function pagination($pagination) |
1137
|
|
|
{ |
1138
|
|
|
return $this->setProperty('pagination', $pagination); |
1139
|
|
|
} |
1140
|
|
|
|
1141
|
|
|
/** |
1142
|
|
|
* The position of an item in a series or sequence of items. |
1143
|
|
|
* |
1144
|
|
|
* @param int|int[]|string|string[] $position |
1145
|
|
|
* |
1146
|
|
|
* @return static |
1147
|
|
|
* |
1148
|
|
|
* @see http://schema.org/position |
1149
|
|
|
*/ |
1150
|
|
|
public function position($position) |
1151
|
|
|
{ |
1152
|
|
|
return $this->setProperty('position', $position); |
1153
|
|
|
} |
1154
|
|
|
|
1155
|
|
|
/** |
1156
|
|
|
* Indicates a potential Action, which describes an idealized action in |
1157
|
|
|
* which this thing would play an 'object' role. |
1158
|
|
|
* |
1159
|
|
|
* @param \Spatie\SchemaOrg\Contracts\ActionContract|\Spatie\SchemaOrg\Contracts\ActionContract[] $potentialAction |
1160
|
|
|
* |
1161
|
|
|
* @return static |
1162
|
|
|
* |
1163
|
|
|
* @see http://schema.org/potentialAction |
1164
|
|
|
*/ |
1165
|
|
|
public function potentialAction($potentialAction) |
1166
|
|
|
{ |
1167
|
|
|
return $this->setProperty('potentialAction', $potentialAction); |
1168
|
|
|
} |
1169
|
|
|
|
1170
|
|
|
/** |
1171
|
|
|
* The person or organization who produced the work (e.g. music album, |
1172
|
|
|
* movie, tv/radio series etc.). |
1173
|
|
|
* |
1174
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $producer |
1175
|
|
|
* |
1176
|
|
|
* @return static |
1177
|
|
|
* |
1178
|
|
|
* @see http://schema.org/producer |
1179
|
|
|
*/ |
1180
|
|
|
public function producer($producer) |
1181
|
|
|
{ |
1182
|
|
|
return $this->setProperty('producer', $producer); |
1183
|
|
|
} |
1184
|
|
|
|
1185
|
|
|
/** |
1186
|
|
|
* The service provider, service operator, or service performer; the goods |
1187
|
|
|
* producer. Another party (a seller) may offer those services or goods on |
1188
|
|
|
* behalf of the provider. A provider may also serve as the seller. |
1189
|
|
|
* |
1190
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $provider |
1191
|
|
|
* |
1192
|
|
|
* @return static |
1193
|
|
|
* |
1194
|
|
|
* @see http://schema.org/provider |
1195
|
|
|
*/ |
1196
|
|
|
public function provider($provider) |
1197
|
|
|
{ |
1198
|
|
|
return $this->setProperty('provider', $provider); |
1199
|
|
|
} |
1200
|
|
|
|
1201
|
|
|
/** |
1202
|
|
|
* A publication event associated with the item. |
1203
|
|
|
* |
1204
|
|
|
* @param \Spatie\SchemaOrg\Contracts\PublicationEventContract|\Spatie\SchemaOrg\Contracts\PublicationEventContract[] $publication |
1205
|
|
|
* |
1206
|
|
|
* @return static |
1207
|
|
|
* |
1208
|
|
|
* @see http://schema.org/publication |
1209
|
|
|
*/ |
1210
|
|
|
public function publication($publication) |
1211
|
|
|
{ |
1212
|
|
|
return $this->setProperty('publication', $publication); |
1213
|
|
|
} |
1214
|
|
|
|
1215
|
|
|
/** |
1216
|
|
|
* The publisher of the creative work. |
1217
|
|
|
* |
1218
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $publisher |
1219
|
|
|
* |
1220
|
|
|
* @return static |
1221
|
|
|
* |
1222
|
|
|
* @see http://schema.org/publisher |
1223
|
|
|
*/ |
1224
|
|
|
public function publisher($publisher) |
1225
|
|
|
{ |
1226
|
|
|
return $this->setProperty('publisher', $publisher); |
1227
|
|
|
} |
1228
|
|
|
|
1229
|
|
|
/** |
1230
|
|
|
* The publishingPrinciples property indicates (typically via [[URL]]) a |
1231
|
|
|
* document describing the editorial principles of an [[Organization]] (or |
1232
|
|
|
* individual e.g. a [[Person]] writing a blog) that relate to their |
1233
|
|
|
* activities as a publisher, e.g. ethics or diversity policies. When |
1234
|
|
|
* applied to a [[CreativeWork]] (e.g. [[NewsArticle]]) the principles are |
1235
|
|
|
* those of the party primarily responsible for the creation of the |
1236
|
|
|
* [[CreativeWork]]. |
1237
|
|
|
* |
1238
|
|
|
* While such policies are most typically expressed in natural language, |
1239
|
|
|
* sometimes related information (e.g. indicating a [[funder]]) can be |
1240
|
|
|
* expressed using schema.org terminology. |
1241
|
|
|
* |
1242
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|string|string[] $publishingPrinciples |
1243
|
|
|
* |
1244
|
|
|
* @return static |
1245
|
|
|
* |
1246
|
|
|
* @see http://schema.org/publishingPrinciples |
1247
|
|
|
*/ |
1248
|
|
|
public function publishingPrinciples($publishingPrinciples) |
1249
|
|
|
{ |
1250
|
|
|
return $this->setProperty('publishingPrinciples', $publishingPrinciples); |
1251
|
|
|
} |
1252
|
|
|
|
1253
|
|
|
/** |
1254
|
|
|
* The Event where the CreativeWork was recorded. The CreativeWork may |
1255
|
|
|
* capture all or part of the event. |
1256
|
|
|
* |
1257
|
|
|
* @param \Spatie\SchemaOrg\Contracts\EventContract|\Spatie\SchemaOrg\Contracts\EventContract[] $recordedAt |
1258
|
|
|
* |
1259
|
|
|
* @return static |
1260
|
|
|
* |
1261
|
|
|
* @see http://schema.org/recordedAt |
1262
|
|
|
*/ |
1263
|
|
|
public function recordedAt($recordedAt) |
1264
|
|
|
{ |
1265
|
|
|
return $this->setProperty('recordedAt', $recordedAt); |
1266
|
|
|
} |
1267
|
|
|
|
1268
|
|
|
/** |
1269
|
|
|
* The place and time the release was issued, expressed as a |
1270
|
|
|
* PublicationEvent. |
1271
|
|
|
* |
1272
|
|
|
* @param \Spatie\SchemaOrg\Contracts\PublicationEventContract|\Spatie\SchemaOrg\Contracts\PublicationEventContract[] $releasedEvent |
1273
|
|
|
* |
1274
|
|
|
* @return static |
1275
|
|
|
* |
1276
|
|
|
* @see http://schema.org/releasedEvent |
1277
|
|
|
*/ |
1278
|
|
|
public function releasedEvent($releasedEvent) |
1279
|
|
|
{ |
1280
|
|
|
return $this->setProperty('releasedEvent', $releasedEvent); |
1281
|
|
|
} |
1282
|
|
|
|
1283
|
|
|
/** |
1284
|
|
|
* A review of the item. |
1285
|
|
|
* |
1286
|
|
|
* @param \Spatie\SchemaOrg\Contracts\ReviewContract|\Spatie\SchemaOrg\Contracts\ReviewContract[] $review |
1287
|
|
|
* |
1288
|
|
|
* @return static |
1289
|
|
|
* |
1290
|
|
|
* @see http://schema.org/review |
1291
|
|
|
*/ |
1292
|
|
|
public function review($review) |
1293
|
|
|
{ |
1294
|
|
|
return $this->setProperty('review', $review); |
1295
|
|
|
} |
1296
|
|
|
|
1297
|
|
|
/** |
1298
|
|
|
* Review of the item. |
1299
|
|
|
* |
1300
|
|
|
* @param \Spatie\SchemaOrg\Contracts\ReviewContract|\Spatie\SchemaOrg\Contracts\ReviewContract[] $reviews |
1301
|
|
|
* |
1302
|
|
|
* @return static |
1303
|
|
|
* |
1304
|
|
|
* @see http://schema.org/reviews |
1305
|
|
|
*/ |
1306
|
|
|
public function reviews($reviews) |
1307
|
|
|
{ |
1308
|
|
|
return $this->setProperty('reviews', $reviews); |
1309
|
|
|
} |
1310
|
|
|
|
1311
|
|
|
/** |
1312
|
|
|
* URL of a reference Web page that unambiguously indicates the item's |
1313
|
|
|
* identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or |
1314
|
|
|
* official website. |
1315
|
|
|
* |
1316
|
|
|
* @param string|string[] $sameAs |
1317
|
|
|
* |
1318
|
|
|
* @return static |
1319
|
|
|
* |
1320
|
|
|
* @see http://schema.org/sameAs |
1321
|
|
|
*/ |
1322
|
|
|
public function sameAs($sameAs) |
1323
|
|
|
{ |
1324
|
|
|
return $this->setProperty('sameAs', $sameAs); |
1325
|
|
|
} |
1326
|
|
|
|
1327
|
|
|
/** |
1328
|
|
|
* Indicates (by URL or string) a particular version of a schema used in |
1329
|
|
|
* some CreativeWork. For example, a document could declare a schemaVersion |
1330
|
|
|
* using an URL such as http://schema.org/version/2.0/ if precise indication |
1331
|
|
|
* of schema version was required by some application. |
1332
|
|
|
* |
1333
|
|
|
* @param string|string[] $schemaVersion |
1334
|
|
|
* |
1335
|
|
|
* @return static |
1336
|
|
|
* |
1337
|
|
|
* @see http://schema.org/schemaVersion |
1338
|
|
|
*/ |
1339
|
|
|
public function schemaVersion($schemaVersion) |
1340
|
|
|
{ |
1341
|
|
|
return $this->setProperty('schemaVersion', $schemaVersion); |
1342
|
|
|
} |
1343
|
|
|
|
1344
|
|
|
/** |
1345
|
|
|
* A CreativeWork such as an image, video, or audio clip shared as part of |
1346
|
|
|
* this posting. |
1347
|
|
|
* |
1348
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[] $sharedContent |
1349
|
|
|
* |
1350
|
|
|
* @return static |
1351
|
|
|
* |
1352
|
|
|
* @see http://schema.org/sharedContent |
1353
|
|
|
*/ |
1354
|
|
|
public function sharedContent($sharedContent) |
1355
|
|
|
{ |
1356
|
|
|
return $this->setProperty('sharedContent', $sharedContent); |
1357
|
|
|
} |
1358
|
|
|
|
1359
|
|
|
/** |
1360
|
|
|
* The Organization on whose behalf the creator was working. |
1361
|
|
|
* |
1362
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[] $sourceOrganization |
1363
|
|
|
* |
1364
|
|
|
* @return static |
1365
|
|
|
* |
1366
|
|
|
* @see http://schema.org/sourceOrganization |
1367
|
|
|
*/ |
1368
|
|
|
public function sourceOrganization($sourceOrganization) |
1369
|
|
|
{ |
1370
|
|
|
return $this->setProperty('sourceOrganization', $sourceOrganization); |
1371
|
|
|
} |
1372
|
|
|
|
1373
|
|
|
/** |
1374
|
|
|
* The "spatial" property can be used in cases when more specific properties |
1375
|
|
|
* (e.g. [[locationCreated]], [[spatialCoverage]], [[contentLocation]]) are |
1376
|
|
|
* not known to be appropriate. |
1377
|
|
|
* |
1378
|
|
|
* @param \Spatie\SchemaOrg\Contracts\PlaceContract|\Spatie\SchemaOrg\Contracts\PlaceContract[] $spatial |
1379
|
|
|
* |
1380
|
|
|
* @return static |
1381
|
|
|
* |
1382
|
|
|
* @see http://schema.org/spatial |
1383
|
|
|
*/ |
1384
|
|
|
public function spatial($spatial) |
1385
|
|
|
{ |
1386
|
|
|
return $this->setProperty('spatial', $spatial); |
1387
|
|
|
} |
1388
|
|
|
|
1389
|
|
|
/** |
1390
|
|
|
* The spatialCoverage of a CreativeWork indicates the place(s) which are |
1391
|
|
|
* the focus of the content. It is a subproperty of |
1392
|
|
|
* contentLocation intended primarily for more technical and detailed |
1393
|
|
|
* materials. For example with a Dataset, it indicates |
1394
|
|
|
* areas that the dataset describes: a dataset of New York weather |
1395
|
|
|
* would have spatialCoverage which was the place: the state of New York. |
1396
|
|
|
* |
1397
|
|
|
* @param \Spatie\SchemaOrg\Contracts\PlaceContract|\Spatie\SchemaOrg\Contracts\PlaceContract[] $spatialCoverage |
1398
|
|
|
* |
1399
|
|
|
* @return static |
1400
|
|
|
* |
1401
|
|
|
* @see http://schema.org/spatialCoverage |
1402
|
|
|
*/ |
1403
|
|
|
public function spatialCoverage($spatialCoverage) |
1404
|
|
|
{ |
1405
|
|
|
return $this->setProperty('spatialCoverage', $spatialCoverage); |
1406
|
|
|
} |
1407
|
|
|
|
1408
|
|
|
/** |
1409
|
|
|
* Indicates sections of a Web page that are particularly 'speakable' in the |
1410
|
|
|
* sense of being highlighted as being especially appropriate for |
1411
|
|
|
* text-to-speech conversion. Other sections of a page may also be usefully |
1412
|
|
|
* spoken in particular circumstances; the 'speakable' property serves to |
1413
|
|
|
* indicate the parts most likely to be generally useful for speech. |
1414
|
|
|
* |
1415
|
|
|
* The *speakable* property can be repeated an arbitrary number of times, |
1416
|
|
|
* with three kinds of possible 'content-locator' values: |
1417
|
|
|
* |
1418
|
|
|
* 1.) *id-value* URL references - uses *id-value* of an element in the page |
1419
|
|
|
* being annotated. The simplest use of *speakable* has (potentially |
1420
|
|
|
* relative) URL values, referencing identified sections of the document |
1421
|
|
|
* concerned. |
1422
|
|
|
* |
1423
|
|
|
* 2.) CSS Selectors - addresses content in the annotated page, eg. via |
1424
|
|
|
* class attribute. Use the [[cssSelector]] property. |
1425
|
|
|
* |
1426
|
|
|
* 3.) XPaths - addresses content via XPaths (assuming an XML view of the |
1427
|
|
|
* content). Use the [[xpath]] property. |
1428
|
|
|
* |
1429
|
|
|
* |
1430
|
|
|
* For more sophisticated markup of speakable sections beyond simple ID |
1431
|
|
|
* references, either CSS selectors or XPath expressions to pick out |
1432
|
|
|
* document section(s) as speakable. For this |
1433
|
|
|
* we define a supporting type, [[SpeakableSpecification]] which is defined |
1434
|
|
|
* to be a possible value of the *speakable* property. |
1435
|
|
|
* |
1436
|
|
|
* @param \Spatie\SchemaOrg\Contracts\SpeakableSpecificationContract|\Spatie\SchemaOrg\Contracts\SpeakableSpecificationContract[]|string|string[] $speakable |
1437
|
|
|
* |
1438
|
|
|
* @return static |
1439
|
|
|
* |
1440
|
|
|
* @see http://schema.org/speakable |
1441
|
|
|
*/ |
1442
|
|
|
public function speakable($speakable) |
1443
|
|
|
{ |
1444
|
|
|
return $this->setProperty('speakable', $speakable); |
1445
|
|
|
} |
1446
|
|
|
|
1447
|
|
|
/** |
1448
|
|
|
* A person or organization that supports a thing through a pledge, promise, |
1449
|
|
|
* or financial contribution. e.g. a sponsor of a Medical Study or a |
1450
|
|
|
* corporate sponsor of an event. |
1451
|
|
|
* |
1452
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $sponsor |
1453
|
|
|
* |
1454
|
|
|
* @return static |
1455
|
|
|
* |
1456
|
|
|
* @see http://schema.org/sponsor |
1457
|
|
|
*/ |
1458
|
|
|
public function sponsor($sponsor) |
1459
|
|
|
{ |
1460
|
|
|
return $this->setProperty('sponsor', $sponsor); |
1461
|
|
|
} |
1462
|
|
|
|
1463
|
|
|
/** |
1464
|
|
|
* A CreativeWork or Event about this Thing. |
1465
|
|
|
* |
1466
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[]|\Spatie\SchemaOrg\Contracts\EventContract|\Spatie\SchemaOrg\Contracts\EventContract[] $subjectOf |
1467
|
|
|
* |
1468
|
|
|
* @return static |
1469
|
|
|
* |
1470
|
|
|
* @see http://schema.org/subjectOf |
1471
|
|
|
*/ |
1472
|
|
|
public function subjectOf($subjectOf) |
1473
|
|
|
{ |
1474
|
|
|
return $this->setProperty('subjectOf', $subjectOf); |
1475
|
|
|
} |
1476
|
|
|
|
1477
|
|
|
/** |
1478
|
|
|
* The "temporal" property can be used in cases where more specific |
1479
|
|
|
* properties |
1480
|
|
|
* (e.g. [[temporalCoverage]], [[dateCreated]], [[dateModified]], |
1481
|
|
|
* [[datePublished]]) are not known to be appropriate. |
1482
|
|
|
* |
1483
|
|
|
* @param \DateTimeInterface|\DateTimeInterface[]|string|string[] $temporal |
1484
|
|
|
* |
1485
|
|
|
* @return static |
1486
|
|
|
* |
1487
|
|
|
* @see http://schema.org/temporal |
1488
|
|
|
*/ |
1489
|
|
|
public function temporal($temporal) |
1490
|
|
|
{ |
1491
|
|
|
return $this->setProperty('temporal', $temporal); |
1492
|
|
|
} |
1493
|
|
|
|
1494
|
|
|
/** |
1495
|
|
|
* The temporalCoverage of a CreativeWork indicates the period that the |
1496
|
|
|
* content applies to, i.e. that it describes, either as a DateTime or as a |
1497
|
|
|
* textual string indicating a time period in [ISO 8601 time interval |
1498
|
|
|
* format](https://en.wikipedia.org/wiki/ISO_8601#Time_intervals). In |
1499
|
|
|
* the case of a Dataset it will typically indicate the relevant time |
1500
|
|
|
* period in a precise notation (e.g. for a 2011 census dataset, the year |
1501
|
|
|
* 2011 would be written "2011/2012"). Other forms of content e.g. |
1502
|
|
|
* ScholarlyArticle, Book, TVSeries or TVEpisode may indicate their |
1503
|
|
|
* temporalCoverage in broader terms - textually or via well-known URL. |
1504
|
|
|
* Written works such as books may sometimes have precise temporal |
1505
|
|
|
* coverage too, e.g. a work set in 1939 - 1945 can be indicated in ISO 8601 |
1506
|
|
|
* interval format format via "1939/1945". |
1507
|
|
|
* |
1508
|
|
|
* Open-ended date ranges can be written with ".." in place of the end date. |
1509
|
|
|
* For example, "2015-11/.." indicates a range beginning in November 2015 |
1510
|
|
|
* and with no specified final date. This is tentative and might be updated |
1511
|
|
|
* in future when ISO 8601 is officially updated. |
1512
|
|
|
* |
1513
|
|
|
* @param \DateTimeInterface|\DateTimeInterface[]|string|string[] $temporalCoverage |
1514
|
|
|
* |
1515
|
|
|
* @return static |
1516
|
|
|
* |
1517
|
|
|
* @see http://schema.org/temporalCoverage |
1518
|
|
|
*/ |
1519
|
|
|
public function temporalCoverage($temporalCoverage) |
1520
|
|
|
{ |
1521
|
|
|
return $this->setProperty('temporalCoverage', $temporalCoverage); |
1522
|
|
|
} |
1523
|
|
|
|
1524
|
|
|
/** |
1525
|
|
|
* The textual content of this CreativeWork. |
1526
|
|
|
* |
1527
|
|
|
* @param string|string[] $text |
1528
|
|
|
* |
1529
|
|
|
* @return static |
1530
|
|
|
* |
1531
|
|
|
* @see http://schema.org/text |
1532
|
|
|
*/ |
1533
|
|
|
public function text($text) |
1534
|
|
|
{ |
1535
|
|
|
return $this->setProperty('text', $text); |
1536
|
|
|
} |
1537
|
|
|
|
1538
|
|
|
/** |
1539
|
|
|
* A thumbnail image relevant to the Thing. |
1540
|
|
|
* |
1541
|
|
|
* @param string|string[] $thumbnailUrl |
1542
|
|
|
* |
1543
|
|
|
* @return static |
1544
|
|
|
* |
1545
|
|
|
* @see http://schema.org/thumbnailUrl |
1546
|
|
|
*/ |
1547
|
|
|
public function thumbnailUrl($thumbnailUrl) |
1548
|
|
|
{ |
1549
|
|
|
return $this->setProperty('thumbnailUrl', $thumbnailUrl); |
1550
|
|
|
} |
1551
|
|
|
|
1552
|
|
|
/** |
1553
|
|
|
* Approximate or typical time it takes to work with or through this |
1554
|
|
|
* learning resource for the typical intended target audience, e.g. 'PT30M', |
1555
|
|
|
* 'PT1H25M'. |
1556
|
|
|
* |
1557
|
|
|
* @param \Spatie\SchemaOrg\Contracts\DurationContract|\Spatie\SchemaOrg\Contracts\DurationContract[] $timeRequired |
1558
|
|
|
* |
1559
|
|
|
* @return static |
1560
|
|
|
* |
1561
|
|
|
* @see http://schema.org/timeRequired |
1562
|
|
|
*/ |
1563
|
|
|
public function timeRequired($timeRequired) |
1564
|
|
|
{ |
1565
|
|
|
return $this->setProperty('timeRequired', $timeRequired); |
1566
|
|
|
} |
1567
|
|
|
|
1568
|
|
|
/** |
1569
|
|
|
* Organization or person who adapts a creative work to different languages, |
1570
|
|
|
* regional differences and technical requirements of a target market, or |
1571
|
|
|
* that translates during some event. |
1572
|
|
|
* |
1573
|
|
|
* @param \Spatie\SchemaOrg\Contracts\OrganizationContract|\Spatie\SchemaOrg\Contracts\OrganizationContract[]|\Spatie\SchemaOrg\Contracts\PersonContract|\Spatie\SchemaOrg\Contracts\PersonContract[] $translator |
1574
|
|
|
* |
1575
|
|
|
* @return static |
1576
|
|
|
* |
1577
|
|
|
* @see http://schema.org/translator |
1578
|
|
|
*/ |
1579
|
|
|
public function translator($translator) |
1580
|
|
|
{ |
1581
|
|
|
return $this->setProperty('translator', $translator); |
1582
|
|
|
} |
1583
|
|
|
|
1584
|
|
|
/** |
1585
|
|
|
* The typical expected age range, e.g. '7-9', '11-'. |
1586
|
|
|
* |
1587
|
|
|
* @param string|string[] $typicalAgeRange |
1588
|
|
|
* |
1589
|
|
|
* @return static |
1590
|
|
|
* |
1591
|
|
|
* @see http://schema.org/typicalAgeRange |
1592
|
|
|
*/ |
1593
|
|
|
public function typicalAgeRange($typicalAgeRange) |
1594
|
|
|
{ |
1595
|
|
|
return $this->setProperty('typicalAgeRange', $typicalAgeRange); |
1596
|
|
|
} |
1597
|
|
|
|
1598
|
|
|
/** |
1599
|
|
|
* URL of the item. |
1600
|
|
|
* |
1601
|
|
|
* @param string|string[] $url |
1602
|
|
|
* |
1603
|
|
|
* @return static |
1604
|
|
|
* |
1605
|
|
|
* @see http://schema.org/url |
1606
|
|
|
*/ |
1607
|
|
|
public function url($url) |
1608
|
|
|
{ |
1609
|
|
|
return $this->setProperty('url', $url); |
1610
|
|
|
} |
1611
|
|
|
|
1612
|
|
|
/** |
1613
|
|
|
* The version of the CreativeWork embodied by a specified resource. |
1614
|
|
|
* |
1615
|
|
|
* @param float|float[]|int|int[]|string|string[] $version |
1616
|
|
|
* |
1617
|
|
|
* @return static |
1618
|
|
|
* |
1619
|
|
|
* @see http://schema.org/version |
1620
|
|
|
*/ |
1621
|
|
|
public function version($version) |
1622
|
|
|
{ |
1623
|
|
|
return $this->setProperty('version', $version); |
1624
|
|
|
} |
1625
|
|
|
|
1626
|
|
|
/** |
1627
|
|
|
* An embedded video object. |
1628
|
|
|
* |
1629
|
|
|
* @param \Spatie\SchemaOrg\Contracts\ClipContract|\Spatie\SchemaOrg\Contracts\ClipContract[]|\Spatie\SchemaOrg\Contracts\VideoObjectContract|\Spatie\SchemaOrg\Contracts\VideoObjectContract[] $video |
1630
|
|
|
* |
1631
|
|
|
* @return static |
1632
|
|
|
* |
1633
|
|
|
* @see http://schema.org/video |
1634
|
|
|
*/ |
1635
|
|
|
public function video($video) |
1636
|
|
|
{ |
1637
|
|
|
return $this->setProperty('video', $video); |
1638
|
|
|
} |
1639
|
|
|
|
1640
|
|
|
/** |
1641
|
|
|
* The number of words in the text of the Article. |
1642
|
|
|
* |
1643
|
|
|
* @param int|int[] $wordCount |
1644
|
|
|
* |
1645
|
|
|
* @return static |
1646
|
|
|
* |
1647
|
|
|
* @see http://schema.org/wordCount |
1648
|
|
|
*/ |
1649
|
|
|
public function wordCount($wordCount) |
1650
|
|
|
{ |
1651
|
|
|
return $this->setProperty('wordCount', $wordCount); |
1652
|
|
|
} |
1653
|
|
|
|
1654
|
|
|
/** |
1655
|
|
|
* Example/instance/realization/derivation of the concept of this creative |
1656
|
|
|
* work. eg. The paperback edition, first edition, or eBook. |
1657
|
|
|
* |
1658
|
|
|
* @param \Spatie\SchemaOrg\Contracts\CreativeWorkContract|\Spatie\SchemaOrg\Contracts\CreativeWorkContract[] $workExample |
1659
|
|
|
* |
1660
|
|
|
* @return static |
1661
|
|
|
* |
1662
|
|
|
* @see http://schema.org/workExample |
1663
|
|
|
*/ |
1664
|
|
|
public function workExample($workExample) |
1665
|
|
|
{ |
1666
|
|
|
return $this->setProperty('workExample', $workExample); |
1667
|
|
|
} |
1668
|
|
|
|
1669
|
|
|
} |
1670
|
|
|
|