SemanticWeb-Schema/lib/SemanticWeb/Schema/Thing.pm
use utf8;
package SemanticWeb::Schema::Thing;
# ABSTRACT: The most generic type of item.
use v5.14;
use Moo;
extends qw/ SemanticWeb::Schema /;
use MooX::JSON_LD 'Thing';
use Ref::Util qw/ is_plain_hashref /;
# RECOMMEND PREREQ: Ref::Util::XS
use namespace::autoclean;
our $VERSION = 'v23.0.0';
has additional_type => (
is => 'rw',
predicate => '_has_additional_type',
json_ld => 'additionalType',
);
has alternate_name => (
is => 'rw',
predicate => '_has_alternate_name',
json_ld => 'alternateName',
);
has description => (
is => 'rw',
predicate => '_has_description',
json_ld => 'description',
);
has disambiguating_description => (
is => 'rw',
predicate => '_has_disambiguating_description',
json_ld => 'disambiguatingDescription',
);
has identifier => (
is => 'rw',
predicate => '_has_identifier',
json_ld => 'identifier',
);
has image => (
is => 'rw',
predicate => '_has_image',
json_ld => 'image',
);
has main_entity_of_page => (
is => 'rw',
predicate => '_has_main_entity_of_page',
json_ld => 'mainEntityOfPage',
);
has name => (
is => 'rw',
predicate => '_has_name',
json_ld => 'name',
);
has potential_action => (
is => 'rw',
predicate => '_has_potential_action',
json_ld => 'potentialAction',
);
has same_as => (
is => 'rw',
predicate => '_has_same_as',
json_ld => 'sameAs',
);
has subject_of => (
is => 'rw',
predicate => '_has_subject_of',
json_ld => 'subjectOf',
);
has url => (
is => 'rw',
predicate => '_has_url',
json_ld => 'url',
);
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
SemanticWeb::Schema::Thing - The most generic type of item.
=head1 VERSION
version v23.0.0
=head1 DESCRIPTION
The most generic type of item.
=head1 ATTRIBUTES
=head2 C<additional_type>
C<additionalType>
=for html <p>An additional type for the item, typically used for adding more specific
types from external vocabularies in microdata syntax. This is a
relationship between something and a class that the thing is in. Typically
the value is a URI-identified RDF class, and in this case corresponds to
the use of rdf:type in RDF. Text values can be used sparingly, for cases
where useful information can be added without their being an appropriate
schema to reference. In the case of text values, the class label should
follow the schema.org <a
href="http://schema.org/docs/styleguide.html">style guide</a>.</p>
A additional_type should be one of the following types:
=over
=item C<Str>
=back
=head2 C<_has_additional_type>
A predicate for the L</additional_type> attribute.
=head2 C<alternate_name>
C<alternateName>
An alias for the item.
A alternate_name should be one of the following types:
=over
=item C<Str>
=back
=head2 C<_has_alternate_name>
A predicate for the L</alternate_name> attribute.
=head2 C<description>
A description of the item.
A description should be one of the following types:
=over
=item C<InstanceOf['SemanticWeb::Schema::TextObject']>
=item C<Str>
=back
=head2 C<_has_description>
A predicate for the L</description> attribute.
=head2 C<disambiguating_description>
C<disambiguatingDescription>
A sub property of description. A short description of the item used to
disambiguate from other, similar items. Information from other properties
(in particular, name) may be necessary for the description to be useful for
disambiguation.
A disambiguating_description should be one of the following types:
=over
=item C<Str>
=back
=head2 C<_has_disambiguating_description>
A predicate for the L</disambiguating_description> attribute.
=head2 C<identifier>
The identifier property represents any kind of identifier for any kind of L<SemanticWeb::Schema::Thing>, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See L<background notes|/docs/datamodel.html#identifierBg> for more details.
A identifier should be one of the following types:
=over
=item C<InstanceOf['SemanticWeb::Schema::PropertyValue']>
=item C<Str>
=back
=head2 C<_has_identifier>
A predicate for the L</identifier> attribute.
=head2 C<image>
An image of the item. This can be a L<SemanticWeb::Schema::URL> or a fully described L<SemanticWeb::Schema::ImageObject>.
A image should be one of the following types:
=over
=item C<InstanceOf['SemanticWeb::Schema::ImageObject']>
=item C<Str>
=back
=head2 C<_has_image>
A predicate for the L</image> attribute.
=head2 C<main_entity_of_page>
C<mainEntityOfPage>
Indicates a page (or other CreativeWork) for which this thing is the main
entity being described. See [background
notes](/docs/datamodel.html#mainEntityBackground) for details.
A main_entity_of_page should be one of the following types:
=over
=item C<InstanceOf['SemanticWeb::Schema::CreativeWork']>
=item C<Str>
=back
=head2 C<_has_main_entity_of_page>
A predicate for the L</main_entity_of_page> attribute.
=head2 C<name>
The name of the item.
A name should be one of the following types:
=over
=item C<Str>
=back
=head2 C<_has_name>
A predicate for the L</name> attribute.
=head2 C<potential_action>
C<potentialAction>
Indicates a potential Action, which describes an idealized action in which
this thing would play an 'object' role.
A potential_action should be one of the following types:
=over
=item C<InstanceOf['SemanticWeb::Schema::Action']>
=back
=head2 C<_has_potential_action>
A predicate for the L</potential_action> attribute.
=head2 C<same_as>
C<sameAs>
URL of a reference Web page that unambiguously indicates the item's
identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or
official website.
A same_as should be one of the following types:
=over
=item C<Str>
=back
=head2 C<_has_same_as>
A predicate for the L</same_as> attribute.
=head2 C<subject_of>
C<subjectOf>
A CreativeWork or Event about this Thing.
A subject_of should be one of the following types:
=over
=item C<InstanceOf['SemanticWeb::Schema::CreativeWork']>
=item C<InstanceOf['SemanticWeb::Schema::Event']>
=back
=head2 C<_has_subject_of>
A predicate for the L</subject_of> attribute.
=head2 C<url>
URL of the item.
A url should be one of the following types:
=over
=item C<Str>
=back
=head2 C<_has_url>
A predicate for the L</url> attribute.
=head1 SEE ALSO
L<SemanticWeb::Schema>
=head1 SOURCE
The development version is on github at L<https://github.com/robrwo/SemanticWeb-Schema>
and may be cloned from L<git://github.com/robrwo/SemanticWeb-Schema.git>
=head1 BUGS
Please report any bugs or feature requests on the bugtracker website
L<https://github.com/robrwo/SemanticWeb-Schema/issues>
When submitting a bug or request, please include a test-file or a
patch to an existing test-file that illustrates the bug or desired
feature.
=head1 AUTHOR
Robert Rothenberg <rrwo@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is Copyright (c) 2018-2023 by Robert Rothenberg.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
=cut