Pagination extends Intangible uses PaginationTrait
Represents pagination information for a collection of items.
Extends Intangible
as defined in schema.org.
This class can be used to describe limits, offsets, and bounds for paginated collections in JSON-LD or structured data.
Tags
Table of Contents
Constants
- CONTEXT = 'https://schema.ooop.fr'
- The @context of the json-ld representation of the thing.
- LIMIT = 'limit'
- The attribute key for the 'limit' property.
- MAX_LIMIT = 'maxLimit'
- The attribute key for the 'maxLimit' property.
- MIN_LIMIT = 'minLimit'
- The attribute key for the 'minLimit' property.
- NUMBER_OF_PAGES = 'numberOfPages'
- The attribute key for the 'numberOfPages' property.
- OFFSET = 'offset'
- The attribute key for the 'offset' property.
- PAGE = 'page'
- The attribute key for the 'page' property.
Properties
- $_from : string|null
- The metadata to indicates the edge 'from' identifier.
- $_id : null|string
- The metadata identifier of the item.
- $_key : null|string
- The metadata unique key identifier of the thing.
- $_rev : null|string
- The metadata revision value of the thing.
- $_to : string|null
- The metadata to indicates the edge 'to' identifier.
- $active : bool|null
- The active flag.
- $additionalType : array<string|int, mixed>|string|null|object
- An additionalType for the item.
- $alternateName : string|object|null
- An alias for the item.
- $created : null|string|DateTime
- Date of creation of the resource.
- $description : string|null
- A short description of the item.
- $disambiguatingDescription : string|null
- 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.
- $hasPart : string|Thing|array<string|int, mixed>|null
- Indicates an item that this part of this item.
- $id : null|int|string
- The unique identifier of the item.
- $identifier : string|null
- The identifier of the item.
- $image : string|object|null
- The image reference of this resource.
- $isPartOf : string|Thing|array<string|int, mixed>|null
- Indicates an item that this item is part of.
- $license : string|object|null
- A legal document giving official permission to do something with the resource.
- $limit : int|null
- The number of items to return per page.
- $maxLimit : int|null
- The maximum allowed number of items per page.
- $minLimit : int|null
- The minimum allowed number of items per page.
- $modified : null|string|DateTime
- Date on which the resource was changed.
- $name : int|string|null
- The name of the item.
- $numberOfPages : int|null
- The number of pages in the paginated collection.
- $offset : int|null
- The number of items to skip before starting to collect the result set.
- $page : int|null
- The current page number in the paginated collection.
- $publisher : string|array<string|int, mixed>|Person|Organization|null
- The publisher of the resource.
- $url : int|string|null
- URL of the item.
- $atContext : string|null
- The JSON-LD `@context` value.
- $atType : string|null
- The JSON-LD `@type` value.
Methods
- __construct() : mixed
- Constructor to hydrate public properties from an array or stdClass.
- jsonSerialize() : array<string|int, mixed>
- Serializes the current object into a JSON-LD array.
- withAtContext() : $this
- Sets the internal JSON-LD `@context` attribute.
- withAtType() : $this
- Sets the internal JSON-LD `@type` attribute.
- withJSONLDMeta() : $this
- Initializes both JSON-LD metadata: `@type` and `@context`.
Constants
CONTEXT
The @context of the json-ld representation of the thing.
public
mixed
CONTEXT
= 'https://schema.ooop.fr'
LIMIT
The attribute key for the 'limit' property.
public
mixed
LIMIT
= 'limit'
Used to identify the maximum number of items to return per page in an array, JSON, or other structured representation.
MAX_LIMIT
The attribute key for the 'maxLimit' property.
public
mixed
MAX_LIMIT
= 'maxLimit'
Represents the upper bound on the number of items that can be requested per page.
MIN_LIMIT
The attribute key for the 'minLimit' property.
public
mixed
MIN_LIMIT
= 'minLimit'
Represents the lower bound on the number of items that can be requested per page.
NUMBER_OF_PAGES
The attribute key for the 'numberOfPages' property.
public
mixed
NUMBER_OF_PAGES
= 'numberOfPages'
Represents the total number of pages in the paginated collection. Can be used to generate pagination controls or metadata.
OFFSET
The attribute key for the 'offset' property.
public
mixed
OFFSET
= 'offset'
Indicates the number of items to skip before starting to collect the result set.
PAGE
The attribute key for the 'page' property.
public
mixed
PAGE
= 'page'
Indicates the current page number in the paginated collection.
Properties
$_from
The metadata to indicates the edge 'from' identifier.
public
string|null
$_from
$_id
The metadata identifier of the item.
public
null|string
$_id
$_key
The metadata unique key identifier of the thing.
public
null|string
$_key
$_rev
The metadata revision value of the thing.
public
null|string
$_rev
$_to
The metadata to indicates the edge 'to' identifier.
public
string|null
$_to
$active
The active flag.
public
bool|null
$active
$additionalType
An additionalType for the item.
public
array<string|int, mixed>|string|null|object
$additionalType
$alternateName
An alias for the item.
public
string|object|null
$alternateName
$created
Date of creation of the resource.
public
null|string|DateTime
$created
$description
A short description of the item.
public
string|null
$description
$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.
public
string|null
$disambiguatingDescription
$hasPart
Indicates an item that this part of this item.
public
string|Thing|array<string|int, mixed>|null
$hasPart
$id
The unique identifier of the item.
public
null|int|string
$id
$identifier
The identifier of the item.
public
string|null
$identifier
$image
The image reference of this resource.
public
string|object|null
$image
$isPartOf
Indicates an item that this item is part of.
public
string|Thing|array<string|int, mixed>|null
$isPartOf
$license
A legal document giving official permission to do something with the resource.
public
string|object|null
$license
$limit
The number of items to return per page.
public
int|null
$limit
Can be null if unspecified. Used to limit the number of items returned in a paginated collection.
$maxLimit
The maximum allowed number of items per page.
public
int|null
$maxLimit
This can be used to enforce an upper bound on the limit
value.
$minLimit
The minimum allowed number of items per page.
public
int|null
$minLimit
This can be used to enforce a lower bound on the limit
value.
$modified
Date on which the resource was changed.
public
null|string|DateTime
$modified
$name
The name of the item.
public
int|string|null
$name
$numberOfPages
The number of pages in the paginated collection.
public
int|null
$numberOfPages
Tags
$offset
The number of items to skip before starting to collect the result set.
public
int|null
$offset
Useful for paginated collections where items are retrieved in segments.
$page
The current page number in the paginated collection.
public
int|null
$page
Starts at 1 by convention. Can be null if not specified.
$publisher
The publisher of the resource.
public
string|array<string|int, mixed>|Person|Organization|null
$publisher
$url
URL of the item.
public
int|string|null
$url
$atContext
The JSON-LD `@context` value.
private
string|null
$atContext
= null
Default is https://schema.org
.
$atType
The JSON-LD `@type` value.
private
string|null
$atType
= null
This can be manually set or automatically inferred from the class name.
Methods
__construct()
Constructor to hydrate public properties from an array or stdClass.
public
__construct([array<string|int, mixed>|object|null $init = null ]) : mixed
This allows objects to be quickly populated with associative data without manually setting each property.
Parameters
- $init : array<string|int, mixed>|object|null = null
-
A data array or object used to initialize the instance. Keys must match public property names.
Tags
jsonSerialize()
Serializes the current object into a JSON-LD array.
public
jsonSerialize() : array<string|int, mixed>
Includes public properties, the JSON-LD @context
and @type
.
Null values are automatically removed.
Tags
Return values
array<string|int, mixed> —JSON-LD representation of the object.
withAtContext()
Sets the internal JSON-LD `@context` attribute.
public
withAtContext(string $context) : $this
Useful if you need a custom JSON-LD context.
Parameters
- $context : string
Return values
$thiswithAtType()
Sets the internal JSON-LD `@type` attribute.
public
withAtType(string $type) : $this
Allows overriding the default type inferred from the class.
Parameters
- $type : string
Return values
$thiswithJSONLDMeta()
Initializes both JSON-LD metadata: `@type` and `@context`.
public
withJSONLDMeta([string|null $atType = null ][, string|null $atContext = null ]) : $this
Can be called from constructor or later to override default values.
Parameters
- $atType : string|null = null
-
Optional JSON-LD type
- $atContext : string|null = null
-
Optional JSON-LD context