feat: link to new Google manuals for various types in Admin Panel

CHANGELOG.md

@@ -9,6 +9,7 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ### Added
 - Picture formats avif and webp are recognized as image in Admin Panel
+- Link to new Google manuals for various types in Admin Panel
 
 ### Updated
 - schema.org definition to version 24.0

Classes/Model/Type/Accommodation.php

@@ -16,6 +16,8 @@
 
 /**
  * An accommodation is a place that can accommodate human beings, e.g. a hotel room, a camping pitch, or a meeting room. Many accommodations are for overnight stays, but this is not a mandatory requirement.
+ * For more specific types of accommodations not defined in schema.org, one can use additionalType with external vocabularies.
+ *
  * See also the <a href="https://schema.org/docs/hotels.html">dedicated document on the use of schema.org for marking up hotels and other forms of accommodations</a>.
  */
 #[Type('Accommodation')]

Classes/Model/Type/Article.php

@@ -22,7 +22,7 @@
  * See also [blog post](http://blog.schema.org/2014/09/schemaorg-support-for-bibliographic_2.html).
  */
 #[Type('Article')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/article')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/article')]
 final class Article extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/BlogPosting.php

@@ -20,7 +20,7 @@
  * A blog post.
  */
 #[Type('BlogPosting')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/article')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/article')]
 final class BlogPosting extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/Book.php

@@ -20,7 +20,7 @@
  * A book.
  */
 #[Type('Book')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/book')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/book')]
 final class Book extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/BreadcrumbList.php

@@ -22,7 +22,7 @@
  * The position property is used to reconstruct the order of the items in a BreadcrumbList. The convention is that a breadcrumb list has an itemListOrder of ItemListOrderAscending (lower values listed first), and that the first items in this list correspond to the "top" or beginning of the breadcrumb trail, e.g. with a site or section homepage. The specific values of 'position' are not assigned meaning for a BreadcrumbList, but they should be integers, e.g. beginning with '1' for the first item in the list.
  */
 #[Type('BreadcrumbList')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/breadcrumb')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/breadcrumb')]
 final class BreadcrumbList extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/Campground.php

@@ -17,6 +17,10 @@
 /**
  * A camping site, campsite, or Campground is a place used for overnight stay in the outdoors, typically containing individual CampingPitch locations.
  *
+ * In British English a campsite is an area, usually divided into a number of pitches, where people can camp overnight using tents or camper vans or caravans; this British English use of the word is synonymous with the American English expression campground. In American English the term campsite generally means an area where an individual, family, group, or military unit can pitch a tent or park a camper; a campground may contain many campsites (source: Wikipedia, see [https://en.wikipedia.org/wiki/Campsite](https://en.wikipedia.org/wiki/Campsite)).
+ *
+ *
+ *
  * See also the dedicated [document on the use of schema.org for marking up hotels and other forms of accommodations](/docs/hotels.html).
  */
 #[Type('Campground')]

Classes/Model/Type/CampingPitch.php

@@ -17,6 +17,10 @@
 /**
  * A CampingPitch is an individual place for overnight stay in the outdoors, typically being part of a larger camping site, or Campground.
  *
+ * In British English a campsite, or campground, is an area, usually divided into a number of pitches, where people can camp overnight using tents or camper vans or caravans; this British English use of the word is synonymous with the American English expression campground. In American English the term campsite generally means an area where an individual, family, group, or military unit can pitch a tent or park a camper; a campground may contain many campsites.
+ * (Source: Wikipedia, see [https://en.wikipedia.org/wiki/Campsite](https://en.wikipedia.org/wiki/Campsite).)
+ *
+ *
  * See also the dedicated [document on the use of schema.org for marking up hotels and other forms of accommodations](/docs/hotels.html).
  */
 #[Type('CampingPitch')]

Classes/Model/Type/ClaimReview.php

@@ -20,7 +20,7 @@
  * A fact-checking review of claims made (or reported) in some creative work (referenced via itemReviewed).
  */
 #[Type('ClaimReview')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/factcheck')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/factcheck')]
 final class ClaimReview extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/ContactPoint.php

@@ -11,13 +11,16 @@
 
 namespace Brotkrueml\Schema\Model\Type;
 
+use Brotkrueml\Schema\Attributes\Manual;
 use Brotkrueml\Schema\Attributes\Type;
 use Brotkrueml\Schema\Core\Model\AbstractType;
+use Brotkrueml\Schema\Manual\Publisher;
 
 /**
  * A contact point - for example, a Customer Complaints department.
  */
 #[Type('ContactPoint')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/logo')]
 final class ContactPoint extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/Course.php

@@ -20,7 +20,7 @@
  * A description of an educational course which may be offered as distinct instances which take place at different times or take place at different locations, or be offered through different media or modes of study. An educational course is a sequence of one or more educational events and/or creative works which aims to build knowledge, competence or ability of learners.
  */
 #[Type('Course')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/course')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/course')]
 final class Course extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/CourseInstance.php

@@ -11,13 +11,16 @@
 
 namespace Brotkrueml\Schema\Model\Type;
 
+use Brotkrueml\Schema\Attributes\Manual;
 use Brotkrueml\Schema\Attributes\Type;
 use Brotkrueml\Schema\Core\Model\AbstractType;
+use Brotkrueml\Schema\Manual\Publisher;
 
 /**
  * An instance of a Course which is distinct from other instances because it is offered at a different time or location or through different media or modes of study or to a specific section of students.
  */
 #[Type('CourseInstance')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/course-info')]
 final class CourseInstance extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/CreativeWorkSeries.php

@@ -17,6 +17,8 @@
 /**
  * A CreativeWorkSeries in schema.org is a group of related items, typically but not necessarily of the same kind. CreativeWorkSeries are usually organized into some order, often chronological. Unlike ItemList which is a general purpose data structure for lists of things, the emphasis with CreativeWorkSeries is on published materials (written e.g. books and periodicals, or media such as TV, radio and games).
  *
+ * Specific subtypes are available for describing TVSeries, RadioSeries, MovieSeries, BookSeries, Periodical and VideoGameSeries. In each case, the hasPart / isPartOf properties can be used to relate the CreativeWorkSeries to its parts. The general CreativeWorkSeries type serves largely just to organize these more specific and practical subtypes.
+ *
  * It is common for properties applicable to an item from the series to be usefully applied to the containing group. Schema.org attempts to anticipate some of these cases, but publishers should be free to apply properties of the series parts to the series as a whole wherever they seem appropriate.
  */
 #[Type('CreativeWorkSeries')]

Classes/Model/Type/DataCatalog.php

@@ -20,7 +20,7 @@
  * A collection of datasets.
  */
 #[Type('DataCatalog')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/dataset')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/dataset')]
 final class DataCatalog extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/DataDownload.php

@@ -20,7 +20,7 @@
  * All or part of a Dataset in downloadable form.
  */
 #[Type('DataDownload')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/dataset')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/dataset')]
 final class DataDownload extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/Dataset.php

@@ -20,7 +20,7 @@
  * A body of structured information describing some topic(s) of interest.
  */
 #[Type('Dataset')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/dataset')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/dataset')]
 final class Dataset extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/DiscussionForumPosting.php

@@ -11,13 +11,16 @@
 
 namespace Brotkrueml\Schema\Model\Type;
 
+use Brotkrueml\Schema\Attributes\Manual;
 use Brotkrueml\Schema\Attributes\Type;
 use Brotkrueml\Schema\Core\Model\AbstractType;
+use Brotkrueml\Schema\Manual\Publisher;
 
 /**
  * A posting to a discussion forum.
  */
 #[Type('DiscussionForumPosting')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/discussion-forum')]
 final class DiscussionForumPosting extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/EmployerAggregateRating.php

@@ -20,7 +20,7 @@
  * An aggregate rating of an Organization related to its role as an employer.
  */
 #[Type('EmployerAggregateRating')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/employer-rating')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/employer-rating')]
 final class EmployerAggregateRating extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/EndorsementRating.php

@@ -16,6 +16,10 @@
 
 /**
  * An EndorsementRating is a rating that expresses some level of endorsement, for example inclusion in a "critic's pick" blog, a
+ * "Like" or "+1" on a social network. It can be considered the result of an EndorseAction in which the object of the action is rated positively by
+ * some agent. As is common elsewhere in schema.org, it is sometimes more useful to describe the results of such an action without explicitly describing the Action.
+ *
+ * An EndorsementRating may be part of a numeric scale or organized system, but this is not required: having an explicit type for indicating a positive,
  * endorsement rating is particularly useful in the absence of numeric scales as it helps consumers understand that the rating is broadly positive.
  */
 #[Type('EndorsementRating')]

Classes/Model/Type/Event.php

@@ -20,7 +20,7 @@
  * An event happening at a certain time and location, such as a concert, lecture, or festival. Ticketing information may be added via the offers property. Repeated events may be structured as separate Event objects.
  */
 #[Type('Event')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/event')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/event')]
 final class Event extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/FAQPage.php

@@ -21,7 +21,7 @@
  * A FAQPage is a WebPage presenting one or more "[Frequently asked questions](https://en.wikipedia.org/wiki/FAQ)" (see also QAPage).
  */
 #[Type('FAQPage')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/faqpage')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/faqpage')]
 final class FAQPage extends AbstractType implements WebPageTypeInterface
 {
     protected static array $propertyNames = [

Classes/Model/Type/GeoCircle.php

@@ -16,6 +16,7 @@
 
 /**
  * A GeoCircle is a GeoShape representing a circular geographic area. As it is a GeoShape
+ * it provides the simple textual property 'circle', but also allows the combination of postalCode alongside geoRadius.
  * The center of the circle can be indicated via the 'geoMidpoint' property, or more approximately using 'address', 'postalCode'.
  */
 #[Type('GeoCircle')]

Classes/Model/Type/HomeAndConstructionBusiness.php

@@ -17,6 +17,8 @@
 /**
  * A construction business.
  *
+ * A HomeAndConstructionBusiness is a LocalBusiness that provides services around homes and buildings.
+ *
  * As a LocalBusiness it can be described as a provider of one or more Service\(s).
  */
 #[Type('HomeAndConstructionBusiness')]

Classes/Model/Type/HowTo.php

@@ -11,16 +11,13 @@
 
 namespace Brotkrueml\Schema\Model\Type;
 
-use Brotkrueml\Schema\Attributes\Manual;
 use Brotkrueml\Schema\Attributes\Type;
 use Brotkrueml\Schema\Core\Model\AbstractType;
-use Brotkrueml\Schema\Manual\Publisher;
 
 /**
  * Instructions that explain how to achieve a result by performing a sequence of steps.
  */
 #[Type('HowTo')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/how-to')]
 final class HowTo extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/ImageObject.php

@@ -20,7 +20,7 @@
  * An image file.
  */
 #[Type('ImageObject')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/image-license-metadata')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/image-license-metadata')]
 final class ImageObject extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/JobPosting.php

@@ -20,7 +20,7 @@
  * A listing that describes a job opening in a certain organization.
  */
 #[Type('JobPosting')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/job-posting')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/job-posting')]
 final class JobPosting extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/MobileApplication.php

@@ -20,7 +20,7 @@
  * A software application designed specifically to work well on a mobile device such as a telephone.
  */
 #[Type('MobileApplication')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/software-app')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/software-app')]
 #[Manual(Publisher::Yandex, 'https://yandex.com/support/webmaster/supported-schemas/software.html')]
 final class MobileApplication extends AbstractType
 {

Classes/Model/Type/MonetaryAmountDistribution.php

@@ -20,7 +20,7 @@
  * A statistical distribution of monetary amounts.
  */
 #[Type('MonetaryAmountDistribution')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/estimated-salary')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/estimated-salary')]
 final class MonetaryAmountDistribution extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/Movie.php

@@ -20,7 +20,7 @@
  * A movie.
  */
 #[Type('Movie')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/movie')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/movie')]
 #[Manual(Publisher::Yandex, 'https://yandex.com/support/webmaster/supported-schemas/movie-description.html')]
 final class Movie extends AbstractType
 {

Classes/Model/Type/NewsArticle.php

@@ -22,7 +22,7 @@
  * A more detailed overview of [schema.org News markup](/docs/news.html) is also available.
  */
 #[Type('NewsArticle')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/article')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/article')]
 #[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/paywalled-content')]
 final class NewsArticle extends AbstractType
 {

Classes/Model/Type/Offer.php

@@ -17,6 +17,8 @@
 /**
  * An offer to transfer some rights to an item or to provide a service — for example, an offer to sell tickets to an event, to rent the DVD of a movie, to stream a TV show over the internet, to repair a motorcycle, or to loan a book.
  *
+ * Note: As the businessFunction property, which identifies the form of offer (e.g. sell, lease, repair, dispose), defaults to http://purl.org/goodrelations/v1#Sell; an Offer without a defined businessFunction value can be assumed to be an offer to sell.
+ *
  * For [GTIN](http://www.gs1.org/barcodes/technical/idkeys/gtin)-related fields, see [Check Digit calculator](http://www.gs1.org/barcodes/support/check_digit_calculator) and [validation guide](http://www.gs1us.org/resources/standards/gtin-validation-guide) from [GS1](http://www.gs1.org/).
  */
 #[Type('Offer')]

Classes/Model/Type/OpeningHoursSpecification.php

@@ -17,6 +17,8 @@
 /**
  * A structured value providing information about the opening hours of a place or a certain service inside a place.
  *
+ * The place is __open__ if the opens property is specified, and __closed__ otherwise.
+ *
  * If the value for the closes property is less than the value for the opens property then the hour range is assumed to span over the next day.
  */
 #[Type('OpeningHoursSpecification')]

Classes/Model/Type/PostalAddress.php

@@ -11,13 +11,17 @@
 
 namespace Brotkrueml\Schema\Model\Type;
 
+use Brotkrueml\Schema\Attributes\Manual;
 use Brotkrueml\Schema\Attributes\Type;
 use Brotkrueml\Schema\Core\Model\AbstractType;
+use Brotkrueml\Schema\Manual\Publisher;
 
 /**
  * The mailing address.
  */
 #[Type('PostalAddress')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/logo')]
+#[Manual(Publisher::Yandex, 'https://yandex.com/support/webmaster/supported-schemas/address-organization.html')]
 final class PostalAddress extends AbstractType
 {
     protected static array $propertyNames = [

Classes/Model/Type/Product.php

@@ -20,7 +20,7 @@
  * Any offered product or service. For example: a pair of shoes; a concert ticket; the rental of a car; a haircut; or an episode of a TV show streamed online.
  */
 #[Type('Product')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/product')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/product')]
 #[Manual(Publisher::Yandex, 'https://yandex.com/support/webmaster/supported-schemas/goods-prices.html')]
 final class Product extends AbstractType
 {

Classes/Model/Type/ProfessionalService.php

@@ -17,6 +17,8 @@
 /**
  * Original definition: "provider of professional services."
  *
+ * The general ProfessionalService type for local businesses was deprecated due to confusion with Service. For reference, the types that it included were: Dentist,
+ * AccountingService, Attorney, Notary, as well as types for several kinds of HomeAndConstructionBusiness: Electrician, GeneralContractor,
  * HousePainter, Locksmith, Plumber, RoofingContractor. LegalService was introduced as a more inclusive supertype of Attorney.
  */
 #[Type('ProfessionalService')]

Classes/Model/Type/ProfilePage.php

@@ -11,14 +11,17 @@
 
 namespace Brotkrueml\Schema\Model\Type;
 
+use Brotkrueml\Schema\Attributes\Manual;
 use Brotkrueml\Schema\Attributes\Type;
 use Brotkrueml\Schema\Core\Model\AbstractType;
 use Brotkrueml\Schema\Core\Model\WebPageTypeInterface;
+use Brotkrueml\Schema\Manual\Publisher;
 
 /**
  * Web page type: Profile page.
  */
 #[Type('ProfilePage')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/profile-page')]
 final class ProfilePage extends AbstractType implements WebPageTypeInterface
 {
     protected static array $propertyNames = [

Classes/Model/Type/QAPage.php

@@ -21,7 +21,7 @@
  * A QAPage is a WebPage focussed on a specific Question and its Answer(s), e.g. in a question answering site or documenting Frequently Asked Questions (FAQs).
  */
 #[Type('QAPage')]
-#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/data-types/qapage')]
+#[Manual(Publisher::Google, 'https://developers.google.com/search/docs/appearance/structured-data/qapage')]
 final class QAPage extends AbstractType implements WebPageTypeInterface
 {
     protected static array $propertyNames = [