← All changes | includes/activity/class-actor.php +10 -170 9.2.0 → 5.7.0 View file →

		@@ -15,54 +15,8 @@
15	15	*
16	16	* Represents an individual actor.
17	17	*
18	18	* @see https://www.w3.org/TR/activitystreams-vocabulary/#actor-types
19		- *
20		- * @method string[]|null get_also_known_as() Gets the also known as property of the actor.
21		- * @method array|null get_attribution_domains() Gets domains allowed to use fediverse:creator for this actor.
22		- * @method bool|null get_discoverable() Gets whether the actor is discoverable.
23		- * @method string[]|null get_endpoints() Gets the endpoint property of the actor.
24		- * @method string|null get_featured() Gets the featured posts collection of the actor.
25		- * @method string|null get_featured_tags() Gets the featured tags collection of the actor.
26		- * @method string|null get_followers() Gets the followers collection of the actor.
27		- * @method string|null get_following() Gets the following collection of the actor.
28		- * @method array|null get_implements() Gets the list of implemented specifications.
29		- * @method string|null get_inbox() Gets the inbox property of the actor.
30		- * @method bool|null get_indexable() Gets whether the actor is indexable.
31		- * @method bool|null get_invisible() Gets whether the actor is invisible.
32		- * @method string|null get_liked() Gets the liked collection of the actor.
33		- * @method bool|null get_manually_approves_followers() Gets whether the actor manually approves followers.
34		- * @method string|null get_moderators() Gets the moderators endpoint URL.
35		- * @method string|null get_moved_to() Gets the target of the actor move.
36		- * @method string|null get_outbox() Gets the outbox property of the actor.
37		- * @method bool|null get_posting_restricted_to_mods() Gets whether posting is restricted to moderators.
38		- * @method string|null get_preferred_username() Gets the preferred username of the actor.
39		- * @method string|array|null get_public_key() Gets the public key of the actor.
40		- * @method array get_streams() Gets the list of supplementary collections.
41		- * @method string|null get_webfinger() Gets the WebFinger resource.
42		- *
43		- * @method Actor set_also_known_as( array $also_known_as ) Sets the also known as property of the actor.
44		- * @method Actor set_attribution_domains( array $attribution_domains ) Sets domains allowed to use fediverse:creator for this actor.
45		- * @method Actor set_discoverable( bool $discoverable ) Sets whether the actor is discoverable.
46		- * @method Actor set_endpoints( string|array $endpoints ) Sets the endpoint property of the actor.
47		- * @method Actor set_featured( string $featured ) Sets the featured posts collection of the actor.
48		- * @method Actor set_featured_tags( string $featured_tags ) Sets the featured tags collection of the actor.
49		- * @method Actor set_followers( string $followers ) Sets the followers collection of the actor.
50		- * @method Actor set_following( string $following ) Sets the following collection of the actor.
51		- * @method Actor set_implements( array $implements ) Sets the list of implemented specifications.
52		- * @method Actor set_inbox( string $inbox ) Sets the inbox property of the actor.
53		- * @method Actor set_indexable( bool $indexable ) Sets whether the actor is indexable.
54		- * @method Actor set_invisible( bool $invisible ) Sets whether the actor is invisible.
55		- * @method Actor set_liked( string $liked ) Sets the liked collection of the actor.
56		- * @method Actor set_manually_approves_followers( bool $manually_approves_followers ) Sets whether the actor manually approves followers.
57		- * @method Actor set_moderators( string $moderators ) Sets the moderators endpoint URL.
58		- * @method Actor set_moved_to( string $moved_to ) Sets the target of the actor move.
59		- * @method Actor set_outbox( string $outbox ) Sets the outbox property of the actor.
60		- * @method Actor set_posting_restricted_to_mods( bool $posting_restricted_to_mods ) Sets whether posting is restricted to moderators.
61		- * @method Actor set_preferred_username( string $preferred_username ) Sets the preferred username of the actor.
62		- * @method Actor set_public_key( string|array $public_key ) Sets the public key of the actor.
63		- * @method Actor set_streams( array $streams ) Sets the list of supplementary collections.
64		- * @method Actor set_webfinger( string $webfinger ) Sets the WebFinger resource.
65	19	*/
66	20	class Actor extends Base_Object {
67	21	// Reduced context for actors. TODO: still unused.
68	22	const JSON_LD_CONTEXT = array(
		@@ -72,10 +26,8 @@
72	26	array(
73	27	'schema' => 'http://schema.org#',
74	28	'toot' => 'http://joinmastodon.org/ns#',
75	29	'lemmy' => 'https://join-lemmy.org/ns#',
76		- 'litepub' => 'http://litepub.social/ns#',
77		- 'gts' => 'https://gotosocial.org/ns#',
78	30	'manuallyApprovesFollowers' => 'as:manuallyApprovesFollowers',
79	31	'PropertyValue' => 'schema:PropertyValue',
80	32	'value' => 'schema:value',
81	33	'Hashtag' => 'as:Hashtag',
		@@ -102,29 +54,11 @@
102	54	'attributionDomains' => array(
103	55	'@id' => 'toot:attributionDomains',
104	56	'@type' => '@id',
105	57	),
106		- 'implements' => array(
107		- '@id' => 'https://w3id.org/fep/844e/implements',
108		- '@type' => '@id',
109		- '@container' => '@list',
110		- ),
111		- 'interactionPolicy' => array(
112		- '@id' => 'gts:interactionPolicy',
113		- '@type' => '@id',
114		- ),
115		- 'canFeature' => array(
116		- '@id' => 'https://w3id.org/fep/7aa9#canFeature',
117		- '@type' => '@id',
118		- ),
119		- 'automaticApproval' => array(
120		- '@id' => 'gts:automaticApproval',
121		- '@type' => '@id',
122		- ),
123	58	'postingRestrictedToMods' => 'lemmy:postingRestrictedToMods',
124	59	'discoverable' => 'toot:discoverable',
125	60	'indexable' => 'toot:indexable',
126		- 'invisible' => 'litepub:invisible',
127	61	),
128	62	);
129	63
130	64	/**
		@@ -231,15 +165,16 @@
231	165	*/
232	166	protected $endpoints;
233	167
234	168	/**
235		- * It's not part of the ActivityPub protocol, but it's a quite common
	169	+ * It's not part of the ActivityPub protocol but it's a quite common
236	170	* practice to handle an actor public key with a publicKey array:
237	171	* [
238		- * 'id' => 'https://my-example.com/actor#main-key'
239		- * 'owner' => 'https://my-example.com/actor',
	172	+ * 'id' => 'https://my-example.com/actor#main-key'
	173	+ * 'owner' => 'https://my-example.com/actor',
240	174	* 'publicKeyPem' => '-----BEGIN PUBLIC KEY-----
241		- * [...]
	175	+ * MIIBI [...]
	176	+ * DQIDAQAB
242	177	* -----END PUBLIC KEY-----'
243	178	* ]
244	179	*
245	180	* @see https://www.w3.org/wiki/SocialCG/ActivityPub/Authentication_Authorization#Signing_requests_using_HTTP_Signatures
		@@ -248,10 +183,10 @@
248	183	*/
249	184	protected $public_key;
250	185
251	186	/**
252		- * It's not part of the ActivityPub protocol, but it's a quite common
253		- * practice to lock an account. If enabled, new followers will not be
	187	+ * It's not part of the ActivityPub protocol but it's a quite common
	188	+ * practice to lock an account. If anabled, new followers will not be
254	189	* automatically accepted, but will instead require you to manually
255	190	* approve them.
256	191	*
257	192	* WordPress does only support 'false' at the moment.
		@@ -259,9 +194,9 @@
259	194	* @see https://docs.joinmastodon.org/spec/activitypub/#as
260	195	*
261	196	* @context as:manuallyApprovesFollowers
262	197	*
263		- * @var boolean|null
	198	+ * @var boolean
264	199	*/
265	200	protected $manually_approves_followers = false;
266	201
267	202	/**
		@@ -269,9 +204,9 @@
269	204	* published articles.
270	205	*
271	206	* @see https://blog.joinmastodon.org/2024/07/highlighting-journalism-on-mastodon/
272	207	*
273		- * @var array|null
	208	+ * @var array
274	209	*/
275	210	protected $attribution_domains = null;
276	211
277	212	/**
		@@ -283,103 +218,8 @@
283	218
284	219	/**
285	220	* The alsoKnownAs of the actor.
286	221	*
287		- * @var array|null
	222	+ * @var array
288	223	*/
289	224	protected $also_known_as;
290		-
291		- /**
292		- * The Featured-Posts.
293		- *
294		- * @see https://docs.joinmastodon.org/spec/activitypub/#featured
295		- *
296		- * @context {
297		- * "@id": "http://joinmastodon.org/ns#featured",
298		- * "@type": "@id"
299		- * }
300		- *
301		- * @var string|null
302		- */
303		- protected $featured;
304		-
305		- /**
306		- * The Featured-Tags.
307		- *
308		- * @see https://docs.joinmastodon.org/spec/activitypub/#featuredTags
309		- *
310		- * @context {
311		- * "@id": "http://joinmastodon.org/ns#featuredTags",
312		- * "@type": "@id"
313		- * }
314		- *
315		- * @var string|null
316		- */
317		- protected $featured_tags;
318		-
319		- /**
320		- * Whether the User is discoverable.
321		- *
322		- * @see https://docs.joinmastodon.org/spec/activitypub/#discoverable
323		- *
324		- * @context http://joinmastodon.org/ns#discoverable
325		- *
326		- * @var boolean|null
327		- */
328		- protected $discoverable;
329		-
330		- /**
331		- * Whether the User is indexable.
332		- *
333		- * @see https://docs.joinmastodon.org/spec/activitypub/#indexable
334		- *
335		- * @context http://joinmastodon.org/ns#indexable
336		- *
337		- * @var boolean|null
338		- */
339		- protected $indexable;
340		-
341		- /**
342		- * The WebFinger Resource.
343		- *
344		- * @see https://codeberg.org/fediverse/fep/src/branch/main/fep/2c59/fep-2c59.md
345		- *
346		- * @var string|null
347		- */
348		- protected $webfinger;
349		-
350		- /**
351		- * URL to the Moderators endpoint.
352		- *
353		- * @see https://join-lemmy.org/docs/contributors/05-federation.html
354		- *
355		- * @var string|null
356		- */
357		- protected $moderators;
358		-
359		- /**
360		- * Restrict posting to mods.
361		- *
362		- * @see https://join-lemmy.org/docs/contributors/05-federation.html
363		- *
364		- * @var boolean|null
365		- */
366		- protected $posting_restricted_to_mods;
367		-
368		- /**
369		- * Listing Implemented Specifications on the Application Actor
370		- *
371		- * @see https://codeberg.org/fediverse/fep/src/branch/main/fep/844e/fep-844e.md
372		- *
373		- * @var array|null
374		- */
375		- protected $implements;
376		-
377		- /**
378		- * Whether the User is invisible.
379		- *
380		- * @see https://litepub.social/
381		- *
382		- * @var boolean|null
383		- */
384		- protected $invisible = null;
385	225	}