3 * @copyright Copyright (C) 2010-2022, the Friendica project
5 * @license GNU AGPL version 3 or any later version
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU Affero General Public License as
9 * published by the Free Software Foundation, either version 3 of the
10 * License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU Affero General Public License for more details.
17 * You should have received a copy of the GNU Affero General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
22 namespace Friendica\Protocol\ActivityPub;
24 use Friendica\Content\Text\BBCode;
25 use Friendica\Content\Text\HTML;
26 use Friendica\Content\Text\Markdown;
27 use Friendica\Core\Logger;
28 use Friendica\Core\Protocol;
29 use Friendica\Core\System;
30 use Friendica\Database\DBA;
32 use Friendica\Model\APContact;
33 use Friendica\Model\Contact;
34 use Friendica\Model\Conversation;
35 use Friendica\Model\Event;
36 use Friendica\Model\GServer;
37 use Friendica\Model\Item;
38 use Friendica\Model\ItemURI;
39 use Friendica\Model\Mail;
40 use Friendica\Model\Tag;
41 use Friendica\Model\User;
42 use Friendica\Model\Post;
43 use Friendica\Protocol\Activity;
44 use Friendica\Protocol\ActivityPub;
45 use Friendica\Protocol\Relay;
46 use Friendica\Util\DateTimeFormat;
47 use Friendica\Util\JsonLD;
48 use Friendica\Util\Strings;
51 * ActivityPub Processor Protocol class
56 * Extracts the tag character (#, @, !) from mention links
61 protected static function normalizeMentionLinks(string $body): string
63 return preg_replace('%\[url=([^\[\]]*)]([#@!])(.*?)\[/url]%ism', '$2[url=$1]$3[/url]', $body);
67 * Convert the language array into a language JSON
69 * @param array $languages
70 * @return string language JSON
72 private static function processLanguages(array $languages)
74 $codes = array_keys($languages);
76 foreach ($codes as $code) {
84 return json_encode($lang);
87 * Replaces emojis in the body
89 * @param array $emojis
92 * @return string with replaced emojis
94 private static function replaceEmojis(int $uri_id, $body, array $emojis)
98 array_column($emojis, 'name'),
99 array_map(function ($emoji) {
100 return '[emoji=' . $emoji['href'] . ']' . $emoji['name'] . '[/emoji]';
105 // We store the emoji here to be able to avoid storing it in the media
106 foreach ($emojis as $emoji) {
107 Post\Link::getByLink($uri_id, $emoji['href']);
113 * Store attached media files in the post-media table
116 * @param array $attachment
119 private static function storeAttachmentAsMedia(int $uriid, array $attachment)
121 if (empty($attachment['url'])) {
125 $data = ['uri-id' => $uriid];
126 $data['type'] = Post\Media::UNKNOWN;
127 $data['url'] = $attachment['url'];
128 $data['mimetype'] = $attachment['mediaType'] ?? null;
129 $data['height'] = $attachment['height'] ?? null;
130 $data['width'] = $attachment['width'] ?? null;
131 $data['size'] = $attachment['size'] ?? null;
132 $data['preview'] = $attachment['image'] ?? null;
133 $data['description'] = $attachment['name'] ?? null;
135 Post\Media::insert($data);
139 * Stire attachment data
141 * @param array $activity
144 private static function storeAttachments($activity, $item)
146 if (empty($activity['attachments'])) {
150 foreach ($activity['attachments'] as $attach) {
151 self::storeAttachmentAsMedia($item['uri-id'], $attach);
156 * Store attachment data
158 * @param array $activity
161 private static function storeQuestion($activity, $item)
163 if (empty($activity['question'])) {
166 $question = ['multiple' => $activity['question']['multiple']];
168 if (!empty($activity['question']['voters'])) {
169 $question['voters'] = $activity['question']['voters'];
172 if (!empty($activity['question']['end-time'])) {
173 $question['end-time'] = $activity['question']['end-time'];
176 Post\Question::update($item['uri-id'], $question);
178 foreach ($activity['question']['options'] as $key => $option) {
179 $option = ['name' => $option['name'], 'replies' => $option['replies']];
180 Post\QuestionOption::update($item['uri-id'], $key, $option);
183 Logger::debug('Storing incoming question', ['type' => $activity['type'], 'uri-id' => $item['uri-id'], 'question' => $activity['question']]);
189 * @param array $activity Activity array
190 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
192 public static function updateItem($activity)
194 $item = Post::selectFirst(['uri', 'uri-id', 'thr-parent', 'gravity', 'post-type'], ['uri' => $activity['id']]);
195 if (!DBA::isResult($item)) {
196 Logger::warning('No existing item, item will be created', ['uri' => $activity['id']]);
197 $item = self::createItem($activity);
202 self::postItem($activity, $item);
206 $item['changed'] = DateTimeFormat::utcNow();
207 $item['edited'] = DateTimeFormat::utc($activity['updated']);
209 $item = self::processContent($activity, $item);
211 self::storeAttachments($activity, $item);
212 self::storeQuestion($activity, $item);
218 Item::update($item, ['uri' => $activity['id']]);
220 if ($activity['object_type'] == 'as:Event') {
221 $posts = Post::select(['event-id', 'uid'], ["`uri` = ? AND `event-id` > ?", $activity['id'], 0]);
222 while ($post = DBA::fetch($posts)) {
223 self::updateEvent($post['event-id'], $activity);
229 * Update an existing event
231 * @param int $event_id
232 * @param array $activity
234 private static function updateEvent(int $event_id, array $activity)
236 $event = DBA::selectFirst('event', [], ['id' => $event_id]);
238 $event['edited'] = DateTimeFormat::utc($activity['updated']);
239 $event['summary'] = HTML::toBBCode($activity['name']);
240 $event['desc'] = HTML::toBBCode($activity['content']);
241 $event['start'] = $activity['start-time'];
242 $event['finish'] = $activity['end-time'];
243 $event['nofinish'] = empty($event['finish']);
244 $event['location'] = $activity['location'];
246 Logger::info('Updating event', ['uri' => $activity['id'], 'id' => $event_id]);
247 Event::store($event);
251 * Prepares data for a message
253 * @param array $activity Activity array
254 * @return array Internal item
255 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
256 * @throws \ImagickException
258 public static function createItem($activity)
261 $item['verb'] = Activity::POST;
262 $item['thr-parent'] = $activity['reply-to-id'];
264 if ($activity['reply-to-id'] == $activity['id']) {
265 $item['gravity'] = GRAVITY_PARENT;
266 $item['object-type'] = Activity\ObjectType::NOTE;
268 $item['gravity'] = GRAVITY_COMMENT;
269 $item['object-type'] = Activity\ObjectType::COMMENT;
272 if (empty($activity['directmessage']) && ($activity['id'] != $activity['reply-to-id']) && !Post::exists(['uri' => $activity['reply-to-id']])) {
273 Logger::notice('Parent not found. Try to refetch it.', ['parent' => $activity['reply-to-id']]);
274 self::fetchMissingActivity($activity['reply-to-id'], $activity, '', Receiver::COMPLETION_AUTO);
277 $item['diaspora_signed_text'] = $activity['diaspora:comment'] ?? '';
279 /// @todo What to do with $activity['context']?
280 if (empty($activity['directmessage']) && ($item['gravity'] != GRAVITY_PARENT) && !Post::exists(['uri' => $item['thr-parent']])) {
281 Logger::info('Parent not found, message will be discarded.', ['thr-parent' => $item['thr-parent']]);
285 $item['network'] = Protocol::ACTIVITYPUB;
286 $item['author-link'] = $activity['author'];
287 $item['author-id'] = Contact::getIdForURL($activity['author']);
288 $item['owner-link'] = $activity['actor'];
289 $item['owner-id'] = Contact::getIdForURL($activity['actor']);
291 if (in_array(0, $activity['receiver']) && !empty($activity['unlisted'])) {
292 $item['private'] = Item::UNLISTED;
293 } elseif (in_array(0, $activity['receiver'])) {
294 $item['private'] = Item::PUBLIC;
296 $item['private'] = Item::PRIVATE;
299 if (!empty($activity['raw'])) {
300 $item['source'] = $activity['raw'];
301 $item['protocol'] = Conversation::PARCEL_ACTIVITYPUB;
302 $item['conversation-href'] = $activity['context'] ?? '';
303 $item['conversation-uri'] = $activity['conversation'] ?? '';
305 if (isset($activity['push'])) {
306 $item['direction'] = $activity['push'] ? Conversation::PUSH : Conversation::PULL;
310 if (!empty($activity['from-relay'])) {
311 $item['direction'] = Conversation::RELAY;
314 if ($activity['object_type'] == 'as:Article') {
315 $item['post-type'] = Item::PT_ARTICLE;
316 } elseif ($activity['object_type'] == 'as:Audio') {
317 $item['post-type'] = Item::PT_AUDIO;
318 } elseif ($activity['object_type'] == 'as:Document') {
319 $item['post-type'] = Item::PT_DOCUMENT;
320 } elseif ($activity['object_type'] == 'as:Event') {
321 $item['post-type'] = Item::PT_EVENT;
322 } elseif ($activity['object_type'] == 'as:Image') {
323 $item['post-type'] = Item::PT_IMAGE;
324 } elseif ($activity['object_type'] == 'as:Page') {
325 $item['post-type'] = Item::PT_PAGE;
326 } elseif ($activity['object_type'] == 'as:Question') {
327 $item['post-type'] = Item::PT_POLL;
328 } elseif ($activity['object_type'] == 'as:Video') {
329 $item['post-type'] = Item::PT_VIDEO;
331 $item['post-type'] = Item::PT_NOTE;
334 $item['isForum'] = false;
336 if (!empty($activity['thread-completion'])) {
337 if ($activity['thread-completion'] != $item['owner-id']) {
338 $actor = Contact::getById($activity['thread-completion'], ['url']);
339 $item['causer-link'] = $actor['url'];
340 $item['causer-id'] = $activity['thread-completion'];
341 Logger::info('Use inherited actor as causer.', ['id' => $item['owner-id'], 'activity' => $activity['thread-completion'], 'owner' => $item['owner-link'], 'actor' => $actor['url']]);
343 // Store the original actor in the "causer" fields to enable the check for ignored or blocked contacts
344 $item['causer-link'] = $item['owner-link'];
345 $item['causer-id'] = $item['owner-id'];
346 Logger::info('Use actor as causer.', ['id' => $item['owner-id'], 'actor' => $item['owner-link']]);
349 $item['owner-link'] = $item['author-link'];
350 $item['owner-id'] = $item['author-id'];
352 $actor = APContact::getByURL($item['owner-link'], false);
353 $item['isForum'] = ($actor['type'] == 'Group');
356 $item['uri'] = $activity['id'];
358 if (empty($activity['published']) || empty($activity['updated'])) {
359 DI::logger()->notice('published or updated keys are empty for activity', ['activity' => $activity, 'callstack' => System::callstack(10)]);
362 $item['created'] = DateTimeFormat::utc($activity['published'] ?? 'now');
363 $item['edited'] = DateTimeFormat::utc($activity['updated'] ?? 'now');
364 $guid = $activity['sc:identifier'] ?: self::getGUIDByURL($item['uri']);
365 $item['guid'] = $activity['diaspora:guid'] ?: $guid;
367 $item['uri-id'] = ItemURI::insert(['uri' => $item['uri'], 'guid' => $item['guid']]);
368 if (empty($item['uri-id'])) {
369 Logger::warning('Unable to get a uri-id for an item uri', ['uri' => $item['uri'], 'guid' => $item['guid']]);
373 $item = self::processContent($activity, $item);
375 Logger::info('Message was not processed');
379 $item['plink'] = $activity['alternate-url'] ?? $item['uri'];
381 self::storeAttachments($activity, $item);
382 self::storeQuestion($activity, $item);
384 // We received the post via AP, so we set the protocol of the server to AP
385 $contact = Contact::getById($item['author-id'], ['gsid']);
386 if (!empty($contact['gsid'])) {
387 GServer::setProtocol($contact['gsid'], Post\DeliveryData::ACTIVITYPUB);
390 if ($item['author-id'] != $item['owner-id']) {
391 $contact = Contact::getById($item['owner-id'], ['gsid']);
392 if (!empty($contact['gsid'])) {
393 GServer::setProtocol($contact['gsid'], Post\DeliveryData::ACTIVITYPUB);
403 * @param array $activity
404 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
405 * @throws \ImagickException
407 public static function deleteItem($activity)
409 $owner = Contact::getIdForURL($activity['actor']);
411 Logger::info('Deleting item', ['object' => $activity['object_id'], 'owner' => $owner]);
412 Item::markForDeletion(['uri' => $activity['object_id'], 'owner-id' => $owner]);
416 * Prepare the item array for an activity
418 * @param array $activity Activity array
419 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
420 * @throws \ImagickException
422 public static function addTag($activity)
424 if (empty($activity['object_content']) || empty($activity['object_id'])) {
428 foreach ($activity['receiver'] as $receiver) {
429 $item = Post::selectFirst(['id', 'uri-id', 'origin', 'author-link'], ['uri' => $activity['target_id'], 'uid' => $receiver]);
430 if (!DBA::isResult($item)) {
431 // We don't fetch missing content for this purpose
435 if (($item['author-link'] != $activity['actor']) && !$item['origin']) {
436 Logger::info('Not origin, not from the author, skipping update', ['id' => $item['id'], 'author' => $item['author-link'], 'actor' => $activity['actor']]);
440 Tag::store($item['uri-id'], Tag::HASHTAG, $activity['object_content'], $activity['object_id']);
441 Logger::info('Tagged item', ['id' => $item['id'], 'tag' => $activity['object_content'], 'uri' => $activity['target_id'], 'actor' => $activity['actor']]);
446 * Prepare the item array for an activity
448 * @param array $activity Activity array
449 * @param string $verb Activity verb
450 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
451 * @throws \ImagickException
453 public static function createActivity($activity, $verb)
455 $item = self::createItem($activity);
460 $item['verb'] = $verb;
461 $item['thr-parent'] = $activity['object_id'];
462 $item['gravity'] = GRAVITY_ACTIVITY;
463 unset($item['post-type']);
464 $item['object-type'] = Activity\ObjectType::NOTE;
466 if (!empty($activity['content'])) {
467 $item['body'] = HTML::toBBCode($activity['content']);
470 $item['diaspora_signed_text'] = $activity['diaspora:like'] ?? '';
472 self::postItem($activity, $item);
476 * Fetch the Uri-Id of a post for the "featured" collection
478 * @param array $activity
481 private static function getUriIdForFeaturedCollection(array $activity)
483 $actor = APContact::getByURL($activity['actor']);
488 // Refetch the account when the "featured" collection is missing.
489 // This can be removed in a future version (end of 2022 should be good).
490 if (empty($actor['featured'])) {
491 $actor = APContact::getByURL($activity['actor'], true);
497 if ($activity['target_id'] != $actor['featured']) {
501 $id = Contact::getIdForURL($activity['actor']);
506 $parent = Post::selectFirst(['uri-id'], ['uri' => $activity['object_id'], 'author-id' => $id]);
507 if (!empty($parent['uri-id'])) {
508 return $parent['uri-id'];
515 * Add a post to the "Featured" collection
517 * @param array $activity
519 public static function addToFeaturedCollection(array $activity)
521 $uriid = self::getUriIdForFeaturedCollection($activity);
526 Logger::debug('Add post to featured collection', ['uri-id' => $uriid]);
528 Post\Collection::add($uriid, Post\Collection::FEATURED);
532 * Remove a post to the "Featured" collection
534 * @param array $activity
536 public static function removeFromFeaturedCollection(array $activity)
538 $uriid = self::getUriIdForFeaturedCollection($activity);
543 Logger::debug('Remove post from featured collection', ['uri-id' => $uriid]);
545 Post\Collection::remove($uriid, Post\Collection::FEATURED);
551 * @param array $activity Activity array
554 * @return int event id
557 public static function createEvent($activity, $item)
559 $event['summary'] = HTML::toBBCode($activity['name'] ?: $activity['summary']);
560 $event['desc'] = HTML::toBBCode($activity['content']);
561 $event['start'] = $activity['start-time'];
562 $event['finish'] = $activity['end-time'];
563 $event['nofinish'] = empty($event['finish']);
564 $event['location'] = $activity['location'];
565 $event['cid'] = $item['contact-id'];
566 $event['uid'] = $item['uid'];
567 $event['uri'] = $item['uri'];
568 $event['edited'] = $item['edited'];
569 $event['private'] = $item['private'];
570 $event['guid'] = $item['guid'];
571 $event['plink'] = $item['plink'];
572 $event['network'] = $item['network'];
573 $event['protocol'] = $item['protocol'];
574 $event['direction'] = $item['direction'];
575 $event['source'] = $item['source'];
577 $ev = DBA::selectFirst('event', ['id'], ['uri' => $item['uri'], 'uid' => $item['uid']]);
578 if (DBA::isResult($ev)) {
579 $event['id'] = $ev['id'];
582 $event_id = Event::store($event);
584 Logger::info('Event was stored', ['id' => $event_id]);
590 * Process the content
592 * @param array $activity Activity array
594 * @return array|bool Returns the item array or false if there was an unexpected occurrence
597 private static function processContent($activity, $item)
599 if (!empty($activity['mediatype']) && ($activity['mediatype'] == 'text/markdown')) {
600 $item['title'] = Markdown::toBBCode($activity['name']);
601 $content = Markdown::toBBCode($activity['content']);
602 } elseif (!empty($activity['mediatype']) && ($activity['mediatype'] == 'text/bbcode')) {
603 $item['title'] = $activity['name'];
604 $content = $activity['content'];
606 // By default assume "text/html"
607 $item['title'] = HTML::toBBCode($activity['name']);
608 $content = HTML::toBBCode($activity['content']);
611 if (!empty($activity['languages'])) {
612 $item['language'] = self::processLanguages($activity['languages']);
615 if (!empty($activity['emojis'])) {
616 $content = self::replaceEmojis($item['uri-id'], $content, $activity['emojis']);
619 $content = self::addMentionLinks($content, $activity['tags']);
621 if (!empty($activity['source'])) {
622 $item['body'] = $activity['source'];
623 $item['raw-body'] = $content;
624 $item['body'] = Item::improveSharedDataInBody($item);
626 if (empty($activity['directmessage']) && ($item['thr-parent'] != $item['uri']) && ($item['gravity'] == GRAVITY_COMMENT)) {
627 $item_private = !in_array(0, $activity['item_receiver']);
628 $parent = Post::selectFirst(['id', 'uri-id', 'private', 'author-link', 'alias'], ['uri' => $item['thr-parent']]);
629 if (!DBA::isResult($parent)) {
630 Logger::warning('Unknown parent item.', ['uri' => $item['thr-parent']]);
633 if ($item_private && ($parent['private'] != Item::PRIVATE)) {
634 Logger::warning('Item is private but the parent is not. Dropping.', ['item-uri' => $item['uri'], 'thr-parent' => $item['thr-parent']]);
638 $content = self::removeImplicitMentionsFromBody($content, $parent);
640 $item['content-warning'] = HTML::toBBCode($activity['summary']);
641 $item['raw-body'] = $item['body'] = $content;
644 self::storeFromBody($item);
645 self::storeTags($item['uri-id'], $activity['tags']);
647 self::storeReceivers($item['uri-id'], $activity['receiver_urls'] ?? []);
649 $item['location'] = $activity['location'];
651 if (!empty($activity['latitude']) && !empty($activity['longitude'])) {
652 $item['coord'] = $activity['latitude'] . ' ' . $activity['longitude'];
655 $item['app'] = $activity['generator'];
661 * Store hashtags and mentions
665 private static function storeFromBody(array $item)
667 // Make sure to delete all existing tags (can happen when called via the update functionality)
668 DBA::delete('post-tag', ['uri-id' => $item['uri-id']]);
670 Tag::storeFromBody($item['uri-id'], $item['body'], '@!');
674 * Generate a GUID out of an URL of an ActivityPub post.
676 * @param string $url message URL
677 * @return string with GUID
679 private static function getGUIDByURL(string $url)
681 $parsed = parse_url($url);
683 $host_hash = hash('crc32', $parsed['host']);
685 unset($parsed["scheme"]);
686 unset($parsed["host"]);
688 $path = implode("/", $parsed);
690 return $host_hash . '-'. hash('fnv164', $path) . '-'. hash('joaat', $path);
694 * Checks if an incoming message is wanted
696 * @param array $activity
698 * @return boolean Is the message wanted?
700 private static function isSolicitedMessage(array $activity, array $item)
702 // The checks are split to improve the support when searching why a message was accepted.
703 if (count($activity['receiver']) != 1) {
704 // The message has more than one receiver, so it is wanted.
705 Logger::debug('Message has got several receivers - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
709 if ($item['private'] == Item::PRIVATE) {
710 // We only look at public posts here. Private posts are expected to be intentionally posted to the single receiver.
711 Logger::debug('Message is private - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
715 if (!empty($activity['from-relay'])) {
716 // We check relay posts at another place. When it arrived here, the message is already checked.
717 Logger::debug('Message is a relay post that is already checked - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
721 if (in_array($activity['completion-mode'] ?? Receiver::COMPLETION_NONE, [Receiver::COMPLETION_MANUAL, Receiver::COMPLETION_ANNOUCE])) {
722 // Manual completions and completions caused by reshares are allowed without any further checks.
723 Logger::debug('Message is in completion mode - accepted', ['mode' => $activity['completion-mode'], 'uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
727 if ($item['gravity'] != GRAVITY_PARENT) {
728 // We cannot reliably check at this point if a comment or activity belongs to an accepted post or needs to be fetched
729 // This can possibly be improved in the future.
730 Logger::debug('Message is no parent - accepted', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
734 $tags = array_column(Tag::getByURIId($item['uri-id'], [Tag::HASHTAG]), 'name');
735 if (Relay::isSolicitedPost($tags, $item['body'], $item['author-id'], $item['uri'], Protocol::ACTIVITYPUB)) {
736 Logger::debug('Post is accepted because of the relay settings', ['uri-id' => $item['uri-id'], 'guid' => $item['guid'], 'url' => $item['uri']]);
744 * Creates an item post
746 * @param array $activity Activity data
747 * @param array $item item array
748 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
749 * @throws \ImagickException
751 public static function postItem(array $activity, array $item)
758 ksort($activity['receiver']);
760 if (!self::isSolicitedMessage($activity, $item)) {
761 DBA::delete('item-uri', ['id' => $item['uri-id']]);
765 foreach ($activity['receiver'] as $receiver) {
766 if ($receiver == -1) {
770 $item['uid'] = $receiver;
772 $type = $activity['reception_type'][$receiver] ?? Receiver::TARGET_UNKNOWN;
774 case Receiver::TARGET_TO:
775 $item['post-reason'] = Item::PR_TO;
777 case Receiver::TARGET_CC:
778 $item['post-reason'] = Item::PR_CC;
780 case Receiver::TARGET_BTO:
781 $item['post-reason'] = Item::PR_BTO;
783 case Receiver::TARGET_BCC:
784 $item['post-reason'] = Item::PR_BCC;
786 case Receiver::TARGET_FOLLOWER:
787 $item['post-reason'] = Item::PR_FOLLOWER;
789 case Receiver::TARGET_ANSWER:
790 $item['post-reason'] = Item::PR_COMMENT;
792 case Receiver::TARGET_GLOBAL:
793 $item['post-reason'] = Item::PR_GLOBAL;
796 $item['post-reason'] = Item::PR_NONE;
799 if (!empty($activity['from-relay'])) {
800 $item['post-reason'] = Item::PR_RELAY;
801 } elseif (!empty($activity['thread-completion'])) {
802 $item['post-reason'] = Item::PR_FETCHED;
805 if ($item['isForum'] ?? false) {
806 $item['contact-id'] = Contact::getIdForURL($activity['actor'], $receiver);
808 $item['contact-id'] = Contact::getIdForURL($activity['author'], $receiver);
811 if (($receiver != 0) && empty($item['contact-id'])) {
812 $item['contact-id'] = Contact::getIdForURL($activity['author']);
815 if (!empty($activity['directmessage'])) {
816 self::postMail($activity, $item);
820 if (!($item['isForum'] ?? false) && ($receiver != 0) && ($item['gravity'] == GRAVITY_PARENT) && !Contact::isSharingByURL($activity['author'], $receiver)) {
821 if ($item['post-reason'] == Item::PR_BCC) {
822 Logger::info('Top level post via BCC from a non sharer, ignoring', ['uid' => $receiver, 'contact' => $item['contact-id']]);
827 !empty($activity['thread-children-type'])
828 && in_array($activity['thread-children-type'], Receiver::ACTIVITY_TYPES)
829 && DI::pConfig()->get($receiver, 'system', 'accept_only_sharer') != Item::COMPLETION_LIKE
831 Logger::info('Top level post from thread completion from a non sharer had been initiated via an activity, ignoring',
832 ['type' => $activity['thread-children-type'], 'user' => $item['uid'], 'causer' => $item['causer-link'], 'author' => $activity['author'], 'url' => $item['uri']]);
839 if ($receiver != 0) {
840 $user = User::getById($receiver, ['account-type']);
841 if (!empty($user['account-type'])) {
842 $is_forum = ($user['account-type'] == User::ACCOUNT_TYPE_COMMUNITY);
846 if (!$is_forum && DI::pConfig()->get($receiver, 'system', 'accept_only_sharer') == Item::COMPLETION_NONE && ($receiver != 0) && ($item['gravity'] == GRAVITY_PARENT)) {
847 $skip = !Contact::isSharingByURL($activity['author'], $receiver);
849 if ($skip && (($activity['type'] == 'as:Announce') || ($item['isForum'] ?? false))) {
850 $skip = !Contact::isSharingByURL($activity['actor'], $receiver);
854 Logger::info('Skipping post', ['uid' => $receiver, 'url' => $item['uri']]);
858 Logger::info('Accepting post', ['uid' => $receiver, 'url' => $item['uri']]);
861 if (($item['gravity'] != GRAVITY_ACTIVITY) && ($activity['object_type'] == 'as:Event')) {
862 $event_id = self::createEvent($activity, $item);
864 $item = Event::getItemArrayForImportedId($event_id, $item);
867 $item_id = Item::insert($item);
869 Logger::info('Item insertion successful', ['user' => $item['uid'], 'item_id' => $item_id]);
871 Logger::notice('Item insertion aborted', ['user' => $item['uid']]);
874 if ($item['uid'] == 0) {
879 // Store send a follow request for every reshare - but only when the item had been stored
880 if ($stored && ($item['private'] != Item::PRIVATE) && ($item['gravity'] == GRAVITY_PARENT) && ($item['author-link'] != $item['owner-link'])) {
881 $author = APContact::getByURL($item['owner-link'], false);
882 // We send automatic follow requests for reshared messages. (We don't need though for forum posts)
883 if ($author['type'] != 'Group') {
884 Logger::info('Send follow request', ['uri' => $item['uri'], 'stored' => $stored, 'to' => $item['author-link']]);
885 ActivityPub\Transmitter::sendFollowObject($item['uri'], $item['author-link']);
891 * Store tags and mentions into the tag table
893 * @param integer $uriid
896 private static function storeTags(int $uriid, array $tags = null)
898 foreach ($tags as $tag) {
899 if (empty($tag['name']) || empty($tag['type']) || !in_array($tag['type'], ['Mention', 'Hashtag'])) {
903 $hash = substr($tag['name'], 0, 1);
905 if ($tag['type'] == 'Mention') {
906 if (in_array($hash, [Tag::TAG_CHARACTER[Tag::MENTION],
907 Tag::TAG_CHARACTER[Tag::EXCLUSIVE_MENTION],
908 Tag::TAG_CHARACTER[Tag::IMPLICIT_MENTION]])) {
909 $tag['name'] = substr($tag['name'], 1);
911 $type = Tag::IMPLICIT_MENTION;
913 if (!empty($tag['href'])) {
914 $apcontact = APContact::getByURL($tag['href']);
915 if (!empty($apcontact['name']) || !empty($apcontact['nick'])) {
916 $tag['name'] = $apcontact['name'] ?: $apcontact['nick'];
919 } elseif ($tag['type'] == 'Hashtag') {
920 if ($hash == Tag::TAG_CHARACTER[Tag::HASHTAG]) {
921 $tag['name'] = substr($tag['name'], 1);
923 $type = Tag::HASHTAG;
926 if (empty($tag['name'])) {
930 Tag::store($uriid, $type, $tag['name'], $tag['href']);
934 public static function storeReceivers(int $uriid, array $receivers)
936 foreach (['as:to' => Tag::TO, 'as:cc' => Tag::CC, 'as:bto' => Tag::BTO, 'as:bcc' => Tag::BCC] as $element => $type) {
937 if (!empty($receivers[$element])) {
938 foreach ($receivers[$element] as $receiver) {
939 if ($receiver == ActivityPub::PUBLIC_COLLECTION) {
940 $name = Receiver::PUBLIC_COLLECTION;
942 $name = trim(parse_url($receiver, PHP_URL_PATH), '/');
945 $target = Tag::getTargetType($receiver);
946 Logger::debug('Got target type', ['type' => $target, 'url' => $receiver]);
947 Tag::store($uriid, $type, $name, $receiver, $target);
954 * Creates an mail post
956 * @param array $activity Activity data
957 * @param array $item item array
958 * @return int|bool New mail table row id or false on error
959 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
961 private static function postMail($activity, $item)
963 if (($item['gravity'] != GRAVITY_PARENT) && !DBA::exists('mail', ['uri' => $item['thr-parent'], 'uid' => $item['uid']])) {
964 Logger::info('Parent not found, mail will be discarded.', ['uid' => $item['uid'], 'uri' => $item['thr-parent']]);
968 Logger::info('Direct Message', $item);
971 $msg['uid'] = $item['uid'];
973 $msg['contact-id'] = $item['contact-id'];
975 $contact = Contact::getById($item['contact-id'], ['name', 'url', 'photo']);
976 $msg['from-name'] = $contact['name'];
977 $msg['from-url'] = $contact['url'];
978 $msg['from-photo'] = $contact['photo'];
980 $msg['uri'] = $item['uri'];
981 $msg['created'] = $item['created'];
983 $parent = DBA::selectFirst('mail', ['parent-uri', 'title'], ['uri' => $item['thr-parent']]);
984 if (DBA::isResult($parent)) {
985 $msg['parent-uri'] = $parent['parent-uri'];
986 $msg['title'] = $parent['title'];
988 $msg['parent-uri'] = $item['thr-parent'];
990 if (!empty($item['title'])) {
991 $msg['title'] = $item['title'];
992 } elseif (!empty($item['content-warning'])) {
993 $msg['title'] = $item['content-warning'];
995 // Trying to generate a title out of the body
996 $title = $item['body'];
998 while (preg_match('#^(@\[url=([^\]]+)].*?\[\/url]\s)(.*)#is', $title, $matches)) {
999 $title = $matches[3];
1002 $title = trim(BBCode::toPlaintext($title));
1004 if (strlen($title) > 20) {
1005 $title = substr($title, 0, 20) . '...';
1008 $msg['title'] = $title;
1011 $msg['body'] = $item['body'];
1013 return Mail::insert($msg);
1017 * Fetch featured posts from a contact with the given url
1019 * @param string $url
1022 public static function fetchFeaturedPosts(string $url)
1024 Logger::info('Fetch featured posts', ['contact' => $url]);
1026 $apcontact = APContact::getByURL($url);
1027 if (empty($apcontact['featured'])) {
1028 Logger::info('Contact does not have a featured collection', ['contact' => $url]);
1032 $pcid = Contact::getIdForURL($url, 0, false);
1034 Logger::info('Contact not found', ['contact' => $url]);
1038 $posts = Post\Collection::selectToArrayForContact($pcid, Post\Collection::FEATURED);
1039 if (!empty($posts)) {
1040 $old_featured = array_column($posts, 'uri-id');
1045 $featured = ActivityPub::fetchItems($apcontact['featured']);
1046 if (empty($featured)) {
1047 Logger::info('Contact does not have featured posts', ['contact' => $url]);
1049 foreach ($old_featured as $uri_id) {
1050 Post\Collection::remove($uri_id, Post\Collection::FEATURED);
1051 Logger::debug('Removed no longer featured post', ['uri-id' => $uri_id, 'contact' => $url]);
1059 foreach ($featured as $post) {
1060 if (empty($post['id'])) {
1063 $id = Item::fetchByLink($post['id']);
1065 $item = Post::selectFirst(['uri-id', 'featured'], ['id' => $id]);
1066 if (!empty($item['uri-id'])) {
1067 if (!$item['featured']) {
1068 Post\Collection::add($item['uri-id'], Post\Collection::FEATURED);
1069 Logger::debug('Added featured post', ['uri-id' => $item['uri-id'], 'contact' => $url]);
1072 Logger::debug('Post already had been featured', ['uri-id' => $item['uri-id'], 'contact' => $url]);
1076 $index = array_search($item['uri-id'], $old_featured);
1077 if (!($index === false)) {
1078 unset($old_featured[$index]);
1084 foreach ($old_featured as $uri_id) {
1085 Post\Collection::remove($uri_id, Post\Collection::FEATURED);
1086 Logger::debug('Removed no longer featured post', ['uri-id' => $uri_id, 'contact' => $url]);
1089 Logger::info('Fetched featured posts', ['new' => $new, 'old' => $old, 'contact' => $url]);
1093 * Fetches missing posts
1095 * @param string $url message URL
1096 * @param array $child activity array with the child of this message
1097 * @param string $relay_actor Relay actor
1098 * @param int $completion Completion mode, see Receiver::COMPLETION_*
1099 * @return string fetched message URL
1100 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1102 public static function fetchMissingActivity(string $url, array $child = [], string $relay_actor = '', int $completion = Receiver::COMPLETION_MANUAL)
1104 if (!empty($child['receiver'])) {
1105 $uid = ActivityPub\Receiver::getFirstUserFromReceivers($child['receiver']);
1110 $object = ActivityPub::fetchContent($url, $uid);
1111 if (empty($object)) {
1112 Logger::notice('Activity was not fetchable, aborting.', ['url' => $url]);
1116 if (empty($object['id'])) {
1117 Logger::notice('Activity has got not id, aborting. ', ['url' => $url, 'object' => $object]);
1121 if (!empty($object['actor'])) {
1122 $object_actor = $object['actor'];
1123 } elseif (!empty($object['attributedTo'])) {
1124 $object_actor = $object['attributedTo'];
1125 if (is_array($object_actor)) {
1126 $compacted = JsonLD::compact($object);
1127 $object_actor = JsonLD::fetchElement($compacted, 'as:attributedTo', '@id');
1134 $signer = [$object_actor];
1136 if (!empty($child['author'])) {
1137 $actor = $child['author'];
1140 $actor = $object_actor;
1143 if (!empty($object['published'])) {
1144 $published = $object['published'];
1145 } elseif (!empty($child['published'])) {
1146 $published = $child['published'];
1148 $published = DateTimeFormat::utcNow();
1152 $activity['@context'] = $object['@context'] ?? ActivityPub::CONTEXT;
1153 unset($object['@context']);
1154 $activity['id'] = $object['id'];
1155 $activity['to'] = $object['to'] ?? [];
1156 $activity['cc'] = $object['cc'] ?? [];
1157 $activity['actor'] = $actor;
1158 $activity['object'] = $object;
1159 $activity['published'] = $published;
1160 $activity['type'] = 'Create';
1162 $ldactivity = JsonLD::compact($activity);
1164 if (!empty($relay_actor)) {
1165 $ldactivity['thread-completion'] = $ldactivity['from-relay'] = Contact::getIdForURL($relay_actor);
1166 $ldactivity['completion-mode'] = Receiver::COMPLETION_RELAY;
1167 } elseif (!empty($child['thread-completion'])) {
1168 $ldactivity['thread-completion'] = $child['thread-completion'];
1169 $ldactivity['completion-mode'] = $child['completion-mode'] ?? Receiver::COMPLETION_NONE;
1171 $ldactivity['thread-completion'] = Contact::getIdForURL($actor);
1172 $ldactivity['completion-mode'] = $completion;
1175 if (!empty($child['type'])) {
1176 $ldactivity['thread-children-type'] = $child['type'];
1179 if (!empty($relay_actor) && !self::acceptIncomingMessage($ldactivity, $object['id'])) {
1183 ActivityPub\Receiver::processActivity($ldactivity, json_encode($activity), $uid, true, false, $signer);
1185 Logger::notice('Activity had been fetched and processed.', ['url' => $url, 'object' => $activity['id']]);
1187 return $activity['id'];
1191 * Test if incoming relay messages should be accepted
1193 * @param array $activity activity array
1194 * @param string $id object ID
1195 * @return boolean true if message is accepted
1197 private static function acceptIncomingMessage(array $activity, string $id)
1199 if (empty($activity['as:object'])) {
1200 Logger::info('No object field in activity - accepted', ['id' => $id]);
1204 $replyto = JsonLD::fetchElement($activity['as:object'], 'as:inReplyTo', '@id');
1205 $uriid = ItemURI::getIdByURI($replyto);
1206 if (Post::exists(['uri-id' => $uriid])) {
1207 Logger::info('Post is a reply to an existing post - accepted', ['id' => $id, 'uri-id' => $uriid, 'replyto' => $replyto]);
1211 $attributed_to = JsonLD::fetchElement($activity['as:object'], 'as:attributedTo', '@id');
1212 $authorid = Contact::getIdForURL($attributed_to);
1214 $body = HTML::toBBCode(JsonLD::fetchElement($activity['as:object'], 'as:content', '@value'));
1217 $tags = Receiver::processTags(JsonLD::fetchElementArray($activity['as:object'], 'as:tag') ?? []);
1218 if (!empty($tags)) {
1219 foreach ($tags as $tag) {
1220 if ($tag['type'] != 'Hashtag') {
1223 $messageTags[] = ltrim(mb_strtolower($tag['name']), '#');
1227 return Relay::isSolicitedPost($messageTags, $body, $authorid, $id, Protocol::ACTIVITYPUB);
1231 * perform a "follow" request
1233 * @param array $activity
1234 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1235 * @throws \ImagickException
1237 public static function followUser($activity)
1239 $uid = User::getIdForURL($activity['object_id']);
1244 $owner = User::getOwnerDataById($uid);
1245 if (empty($owner)) {
1249 $cid = Contact::getIdForURL($activity['actor'], $uid);
1251 self::switchContact($cid);
1252 Contact::update(['hub-verify' => $activity['id'], 'protocol' => Protocol::ACTIVITYPUB], ['id' => $cid]);
1255 $item = ['author-id' => Contact::getIdForURL($activity['actor']),
1256 'author-link' => $activity['actor']];
1258 // Ensure that the contact has got the right network type
1259 self::switchContact($item['author-id']);
1261 $result = Contact::addRelationship($owner, [], $item, false, $activity['content'] ?? '');
1262 if ($result === true) {
1263 ActivityPub\Transmitter::sendContactAccept($item['author-link'], $activity['id'], $owner['uid']);
1266 $cid = Contact::getIdForURL($activity['actor'], $uid);
1271 if (empty($contact)) {
1272 Contact::update(['hub-verify' => $activity['id'], 'protocol' => Protocol::ACTIVITYPUB], ['id' => $cid]);
1275 Logger::notice('Follow user ' . $uid . ' from contact ' . $cid . ' with id ' . $activity['id']);
1279 * Update the given profile
1281 * @param array $activity
1282 * @throws \Exception
1284 public static function updatePerson($activity)
1286 if (empty($activity['object_id'])) {
1290 Logger::info('Updating profile', ['object' => $activity['object_id']]);
1291 Contact::updateFromProbeByURL($activity['object_id']);
1295 * Delete the given profile
1297 * @param array $activity
1298 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1300 public static function deletePerson($activity)
1302 if (empty($activity['object_id']) || empty($activity['actor'])) {
1303 Logger::info('Empty object id or actor.');
1307 if ($activity['object_id'] != $activity['actor']) {
1308 Logger::info('Object id does not match actor.');
1312 $contacts = DBA::select('contact', ['id'], ['nurl' => Strings::normaliseLink($activity['object_id'])]);
1313 while ($contact = DBA::fetch($contacts)) {
1314 Contact::remove($contact['id']);
1316 DBA::close($contacts);
1318 Logger::info('Deleted contact', ['object' => $activity['object_id']]);
1322 * Blocks the user by the contact
1324 * @param array $activity
1325 * @throws \Exception
1327 public static function blockAccount($activity)
1329 $cid = Contact::getIdForURL($activity['actor']);
1334 $uid = User::getIdForURL($activity['object_id']);
1339 Contact\User::setIsBlocked($cid, $uid, true);
1341 Logger::info('Contact blocked user', ['contact' => $cid, 'user' => $uid]);
1345 * Unblocks the user by the contact
1347 * @param array $activity
1348 * @throws \Exception
1350 public static function unblockAccount($activity)
1352 $cid = Contact::getIdForURL($activity['actor']);
1357 $uid = User::getIdForURL($activity['object_object']);
1362 Contact\User::setIsBlocked($cid, $uid, false);
1364 Logger::info('Contact unblocked user', ['contact' => $cid, 'user' => $uid]);
1368 * Accept a follow request
1370 * @param array $activity
1371 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1372 * @throws \ImagickException
1374 public static function acceptFollowUser($activity)
1376 $uid = User::getIdForURL($activity['object_actor']);
1381 $cid = Contact::getIdForURL($activity['actor'], $uid);
1383 Logger::info('No contact found', ['actor' => $activity['actor']]);
1387 self::switchContact($cid);
1389 $fields = ['pending' => false];
1391 $contact = DBA::selectFirst('contact', ['rel'], ['id' => $cid]);
1392 if ($contact['rel'] == Contact::FOLLOWER) {
1393 $fields['rel'] = Contact::FRIEND;
1396 $condition = ['id' => $cid];
1397 Contact::update($fields, $condition);
1398 Logger::info('Accept contact request', ['contact' => $cid, 'user' => $uid]);
1402 * Reject a follow request
1404 * @param array $activity
1405 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1406 * @throws \ImagickException
1408 public static function rejectFollowUser($activity)
1410 $uid = User::getIdForURL($activity['object_actor']);
1415 $cid = Contact::getIdForURL($activity['actor'], $uid);
1417 Logger::info('No contact found', ['actor' => $activity['actor']]);
1421 self::switchContact($cid);
1423 $contact = Contact::getById($cid, ['rel']);
1424 if ($contact['rel'] == Contact::SHARING) {
1425 Contact::remove($cid);
1426 Logger::info('Rejected contact request - contact removed', ['contact' => $cid, 'user' => $uid]);
1427 } elseif ($contact['rel'] == Contact::FRIEND) {
1428 Contact::update(['rel' => Contact::FOLLOWER], ['id' => $cid]);
1430 Logger::info('Rejected contact request', ['contact' => $cid, 'user' => $uid]);
1435 * Undo activity like "like" or "dislike"
1437 * @param array $activity
1438 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1439 * @throws \ImagickException
1441 public static function undoActivity($activity)
1443 if (empty($activity['object_id'])) {
1447 if (empty($activity['object_actor'])) {
1451 $author_id = Contact::getIdForURL($activity['object_actor']);
1452 if (empty($author_id)) {
1456 Item::markForDeletion(['uri' => $activity['object_id'], 'author-id' => $author_id, 'gravity' => GRAVITY_ACTIVITY]);
1460 * Activity to remove a follower
1462 * @param array $activity
1463 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1464 * @throws \ImagickException
1466 public static function undoFollowUser($activity)
1468 $uid = User::getIdForURL($activity['object_object']);
1473 $owner = User::getOwnerDataById($uid);
1474 if (empty($owner)) {
1478 $cid = Contact::getIdForURL($activity['actor'], $uid);
1480 Logger::info('No contact found', ['actor' => $activity['actor']]);
1484 self::switchContact($cid);
1486 $contact = DBA::selectFirst('contact', [], ['id' => $cid]);
1487 if (!DBA::isResult($contact)) {
1491 Contact::removeFollower($contact);
1492 Logger::info('Undo following request', ['contact' => $cid, 'user' => $uid]);
1496 * Switches a contact to AP if needed
1498 * @param integer $cid Contact ID
1499 * @throws \Exception
1501 private static function switchContact($cid)
1503 $contact = DBA::selectFirst('contact', ['network', 'url'], ['id' => $cid]);
1504 if (!DBA::isResult($contact) || in_array($contact['network'], [Protocol::ACTIVITYPUB, Protocol::DFRN]) || Contact::isLocal($contact['url'])) {
1508 Logger::info('Change existing contact', ['cid' => $cid, 'previous' => $contact['network']]);
1509 Contact::updateFromProbe($cid);
1513 * Collects implicit mentions like:
1514 * - the author of the parent item
1515 * - all the mentioned conversants in the parent item
1517 * @param array $parent Item array with at least ['id', 'author-link', 'alias']
1519 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
1521 private static function getImplicitMentionList(array $parent)
1523 $parent_terms = Tag::getByURIId($parent['uri-id'], [Tag::MENTION, Tag::IMPLICIT_MENTION, Tag::EXCLUSIVE_MENTION]);
1525 $parent_author = Contact::getByURL($parent['author-link'], false, ['url', 'nurl', 'alias']);
1527 $implicit_mentions = [];
1528 if (empty($parent_author['url'])) {
1529 Logger::notice('Author public contact unknown.', ['author-link' => $parent['author-link'], 'parent-id' => $parent['id']]);
1531 $implicit_mentions[] = $parent_author['url'];
1532 $implicit_mentions[] = $parent_author['nurl'];
1533 $implicit_mentions[] = $parent_author['alias'];
1536 if (!empty($parent['alias'])) {
1537 $implicit_mentions[] = $parent['alias'];
1540 foreach ($parent_terms as $term) {
1541 $contact = Contact::getByURL($term['url'], false, ['url', 'nurl', 'alias']);
1542 if (!empty($contact['url'])) {
1543 $implicit_mentions[] = $contact['url'];
1544 $implicit_mentions[] = $contact['nurl'];
1545 $implicit_mentions[] = $contact['alias'];
1549 return $implicit_mentions;
1553 * Strips from the body prepended implicit mentions
1555 * @param string $body
1556 * @param array $parent
1559 private static function removeImplicitMentionsFromBody(string $body, array $parent)
1561 if (DI::config()->get('system', 'disable_implicit_mentions')) {
1565 $potential_mentions = self::getImplicitMentionList($parent);
1567 $kept_mentions = [];
1569 // Extract one prepended mention at a time from the body
1570 while(preg_match('#^(@\[url=([^\]]+)].*?\[\/url]\s)(.*)#is', $body, $matches)) {
1571 if (!in_array($matches[2], $potential_mentions)) {
1572 $kept_mentions[] = $matches[1];
1575 $body = $matches[3];
1578 // Re-appending the kept mentions to the body after extraction
1579 $kept_mentions[] = $body;
1581 return implode('', $kept_mentions);
1585 * Adds links to string mentions
1587 * @param string $body
1588 * @param array $tags
1591 protected static function addMentionLinks(string $body, array $tags): string
1593 // This prevents links to be added again to Pleroma-style mention links
1594 $body = self::normalizeMentionLinks($body);
1596 $body = BBCode::performWithEscapedTags($body, ['url'], function ($body) use ($tags) {
1597 foreach ($tags as $tag) {
1598 if (empty($tag['name']) || empty($tag['type']) || empty($tag['href']) || !in_array($tag['type'], ['Mention', 'Hashtag'])) {
1602 $hash = substr($tag['name'], 0, 1);
1603 $name = substr($tag['name'], 1);
1604 if (!in_array($hash, Tag::TAG_CHARACTER)) {
1606 $name = $tag['name'];
1609 $body = str_replace($tag['name'], $hash . '[url=' . $tag['href'] . ']' . $name . '[/url]', $body);