← All changes | includes/activity/class-actor.php +10 -157 8.2.1 → 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,9 +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	30	'manuallyApprovesFollowers' => 'as:manuallyApprovesFollowers',
78	31	'PropertyValue' => 'schema:PropertyValue',
79	32	'value' => 'schema:value',
80	33	'Hashtag' => 'as:Hashtag',
		@@ -101,17 +54,11 @@
101	54	'attributionDomains' => array(
102	55	'@id' => 'toot:attributionDomains',
103	56	'@type' => '@id',
104	57	),
105		- 'implements' => array(
106		- '@id' => 'https://w3id.org/fep/844e/implements',
107		- '@type' => '@id',
108		- '@container' => '@list',
109		- ),
110	58	'postingRestrictedToMods' => 'lemmy:postingRestrictedToMods',
111	59	'discoverable' => 'toot:discoverable',
112	60	'indexable' => 'toot:indexable',
113		- 'invisible' => 'litepub:invisible',
114	61	),
115	62	);
116	63
117	64	/**
		@@ -218,15 +165,16 @@
218	165	*/
219	166	protected $endpoints;
220	167
221	168	/**
222		- * 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
223	170	* practice to handle an actor public key with a publicKey array:
224	171	* [
225		- * 'id' => 'https://my-example.com/actor#main-key'
226		- * 'owner' => 'https://my-example.com/actor',
	172	+ * 'id' => 'https://my-example.com/actor#main-key'
	173	+ * 'owner' => 'https://my-example.com/actor',
227	174	* 'publicKeyPem' => '-----BEGIN PUBLIC KEY-----
228		- * [...]
	175	+ * MIIBI [...]
	176	+ * DQIDAQAB
229	177	* -----END PUBLIC KEY-----'
230	178	* ]
231	179	*
232	180	* @see https://www.w3.org/wiki/SocialCG/ActivityPub/Authentication_Authorization#Signing_requests_using_HTTP_Signatures
		@@ -235,10 +183,10 @@
235	183	*/
236	184	protected $public_key;
237	185
238	186	/**
239		- * It's not part of the ActivityPub protocol, but it's a quite common
240		- * 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
241	189	* automatically accepted, but will instead require you to manually
242	190	* approve them.
243	191	*
244	192	* WordPress does only support 'false' at the moment.
		@@ -246,9 +194,9 @@
246	194	* @see https://docs.joinmastodon.org/spec/activitypub/#as
247	195	*
248	196	* @context as:manuallyApprovesFollowers
249	197	*
250		- * @var boolean|null
	198	+ * @var boolean
251	199	*/
252	200	protected $manually_approves_followers = false;
253	201
254	202	/**
		@@ -256,9 +204,9 @@
256	204	* published articles.
257	205	*
258	206	* @see https://blog.joinmastodon.org/2024/07/highlighting-journalism-on-mastodon/
259	207	*
260		- * @var array|null
	208	+ * @var array
261	209	*/
262	210	protected $attribution_domains = null;
263	211
264	212	/**
		@@ -270,103 +218,8 @@
270	218
271	219	/**
272	220	* The alsoKnownAs of the actor.
273	221	*
274		- * @var array|null
	222	+ * @var array
275	223	*/
276	224	protected $also_known_as;
277		-
278		- /**
279		- * The Featured-Posts.
280		- *
281		- * @see https://docs.joinmastodon.org/spec/activitypub/#featured
282		- *
283		- * @context {
284		- * "@id": "http://joinmastodon.org/ns#featured",
285		- * "@type": "@id"
286		- * }
287		- *
288		- * @var string|null
289		- */
290		- protected $featured;
291		-
292		- /**
293		- * The Featured-Tags.
294		- *
295		- * @see https://docs.joinmastodon.org/spec/activitypub/#featuredTags
296		- *
297		- * @context {
298		- * "@id": "http://joinmastodon.org/ns#featuredTags",
299		- * "@type": "@id"
300		- * }
301		- *
302		- * @var string|null
303		- */
304		- protected $featured_tags;
305		-
306		- /**
307		- * Whether the User is discoverable.
308		- *
309		- * @see https://docs.joinmastodon.org/spec/activitypub/#discoverable
310		- *
311		- * @context http://joinmastodon.org/ns#discoverable
312		- *
313		- * @var boolean|null
314		- */
315		- protected $discoverable;
316		-
317		- /**
318		- * Whether the User is indexable.
319		- *
320		- * @see https://docs.joinmastodon.org/spec/activitypub/#indexable
321		- *
322		- * @context http://joinmastodon.org/ns#indexable
323		- *
324		- * @var boolean|null
325		- */
326		- protected $indexable;
327		-
328		- /**
329		- * The WebFinger Resource.
330		- *
331		- * @see https://codeberg.org/fediverse/fep/src/branch/main/fep/2c59/fep-2c59.md
332		- *
333		- * @var string|null
334		- */
335		- protected $webfinger;
336		-
337		- /**
338		- * URL to the Moderators endpoint.
339		- *
340		- * @see https://join-lemmy.org/docs/contributors/05-federation.html
341		- *
342		- * @var string|null
343		- */
344		- protected $moderators;
345		-
346		- /**
347		- * Restrict posting to mods.
348		- *
349		- * @see https://join-lemmy.org/docs/contributors/05-federation.html
350		- *
351		- * @var boolean|null
352		- */
353		- protected $posting_restricted_to_mods;
354		-
355		- /**
356		- * Listing Implemented Specifications on the Application Actor
357		- *
358		- * @see https://codeberg.org/fediverse/fep/src/branch/main/fep/844e/fep-844e.md
359		- *
360		- * @var array|null
361		- */
362		- protected $implements;
363		-
364		- /**
365		- * Whether the User is invisible.
366		- *
367		- * @see https://litepub.social/
368		- *
369		- * @var boolean|null
370		- */
371		- protected $invisible = null;
372	225	}