186 lines
4.7 KiB
PHP
186 lines
4.7 KiB
PHP
<?php
|
|
/**
|
|
* Inspired by the PHP ActivityPub Library by @Landrok
|
|
*
|
|
* @link https://github.com/landrok/activitypub
|
|
*/
|
|
|
|
namespace Activitypub\Activity;
|
|
|
|
use Activitypub\Activity\Base_Object;
|
|
|
|
/**
|
|
* \Activitypub\Activity\Activity implements the common
|
|
* attributes of an Activity.
|
|
*
|
|
* @see https://www.w3.org/TR/activitystreams-core/#activities
|
|
* @see https://www.w3.org/TR/activitystreams-core/#intransitiveactivities
|
|
*/
|
|
class Activity extends Base_Object {
|
|
const JSON_LD_CONTEXT = array(
|
|
'https://www.w3.org/ns/activitystreams',
|
|
);
|
|
|
|
/**
|
|
* @var string
|
|
*/
|
|
protected $type = 'Activity';
|
|
|
|
/**
|
|
* Describes the direct object of the activity.
|
|
* For instance, in the activity "John added a movie to his
|
|
* wishlist", the object of the activity is the movie added.
|
|
*
|
|
* @see https://www.w3.org/TR/activitystreams-vocabulary/#dfn-object-term
|
|
*
|
|
* @var string
|
|
* | Base_Object
|
|
* | Link
|
|
* | null
|
|
*/
|
|
protected $object;
|
|
|
|
/**
|
|
* Describes one or more entities that either performed or are
|
|
* expected to perform the activity.
|
|
* Any single activity can have multiple actors.
|
|
* The actor MAY be specified using an indirect Link.
|
|
*
|
|
* @see https://www.w3.org/TR/activitystreams-vocabulary/#dfn-actor
|
|
*
|
|
* @var string
|
|
* | \ActivityPhp\Type\Extended\AbstractActor
|
|
* | array<Actor>
|
|
* | array<Link>
|
|
* | Link
|
|
*/
|
|
protected $actor;
|
|
|
|
/**
|
|
* The indirect object, or target, of the activity.
|
|
* The precise meaning of the target is largely dependent on the
|
|
* type of action being described but will often be the object of
|
|
* the English preposition "to".
|
|
* For instance, in the activity "John added a movie to his
|
|
* wishlist", the target of the activity is John's wishlist.
|
|
* An activity can have more than one target.
|
|
*
|
|
* @see https://www.w3.org/TR/activitystreams-vocabulary/#dfn-target
|
|
*
|
|
* @var string
|
|
* | ObjectType
|
|
* | array<ObjectType>
|
|
* | Link
|
|
* | array<Link>
|
|
*/
|
|
protected $target;
|
|
|
|
/**
|
|
* Describes the result of the activity.
|
|
* For instance, if a particular action results in the creation of
|
|
* a new resource, the result property can be used to describe
|
|
* that new resource.
|
|
*
|
|
* @see https://www.w3.org/TR/activitystreams-vocabulary/#dfn-result
|
|
*
|
|
* @var string
|
|
* | ObjectType
|
|
* | Link
|
|
* | null
|
|
*/
|
|
protected $result;
|
|
|
|
/**
|
|
* An indirect object of the activity from which the
|
|
* activity is directed.
|
|
* The precise meaning of the origin is the object of the English
|
|
* preposition "from".
|
|
* For instance, in the activity "John moved an item to List B
|
|
* from List A", the origin of the activity is "List A".
|
|
*
|
|
* @see https://www.w3.org/TR/activitystreams-vocabulary/#dfn-origin
|
|
*
|
|
* @var string
|
|
* | ObjectType
|
|
* | Link
|
|
* | null
|
|
*/
|
|
protected $origin;
|
|
|
|
/**
|
|
* One or more objects used (or to be used) in the completion of an
|
|
* Activity.
|
|
*
|
|
* @see https://www.w3.org/TR/activitystreams-vocabulary/#dfn-instrument
|
|
*
|
|
* @var string
|
|
* | ObjectType
|
|
* | Link
|
|
* | null
|
|
*/
|
|
protected $instrument;
|
|
|
|
/**
|
|
* Set the object and copy Object properties to the Activity.
|
|
*
|
|
* Any to, bto, cc, bcc, and audience properties specified on the object
|
|
* MUST be copied over to the new Create activity by the server.
|
|
*
|
|
* @see https://www.w3.org/TR/activitypub/#object-without-create
|
|
*
|
|
* @param string|Base_Objectr|Link|null $object
|
|
*
|
|
* @return void
|
|
*/
|
|
public function set_object( $object ) {
|
|
// convert array to object
|
|
if ( is_array( $object ) ) {
|
|
$object = self::init_from_array( $object );
|
|
}
|
|
|
|
// set object
|
|
$this->set( 'object', $object );
|
|
|
|
if ( ! is_object( $object ) ) {
|
|
return;
|
|
}
|
|
|
|
foreach ( array( 'to', 'bto', 'cc', 'bcc', 'audience' ) as $i ) {
|
|
$this->set( $i, $object->get( $i ) );
|
|
}
|
|
|
|
if ( $object->get_published() && ! $this->get_published() ) {
|
|
$this->set( 'published', $object->get_published() );
|
|
}
|
|
|
|
if ( $object->get_updated() && ! $this->get_updated() ) {
|
|
$this->set( 'updated', $object->get_updated() );
|
|
}
|
|
|
|
if ( $object->get_attributed_to() && ! $this->get_actor() ) {
|
|
$this->set( 'actor', $object->get_attributed_to() );
|
|
}
|
|
|
|
if ( $object->get_id() && ! $this->get_id() ) {
|
|
$this->set( 'id', $object->get_id() . '#activity' );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The context of an Activity is usually just the context of the object it contains.
|
|
*
|
|
* @return array $context A compacted JSON-LD context.
|
|
*/
|
|
public function get_json_ld_context() {
|
|
if ( $this->object instanceof Base_Object ) {
|
|
$class = get_class( $this->object );
|
|
if ( $class && $class::JSON_LD_CONTEXT ) {
|
|
// Without php 5.6 support this could be just: 'return $this->object::JSON_LD_CONTEXT;'
|
|
return $class::JSON_LD_CONTEXT;
|
|
}
|
|
}
|
|
|
|
return static::JSON_LD_CONTEXT;
|
|
}
|
|
}
|