]> git.mxchange.org Git - friendica.git/blobdiff - src/Model/Item.php
Changes:
[friendica.git] / src / Model / Item.php
index 8bf133f5d8e65b87ba1b48a5d982b95ecbc3a1ff..bb8080e5fd4f234623d5e90af64b6cb0a9a6df6d 100644 (file)
@@ -96,8 +96,8 @@ class Item
                'event-created', 'event-edited', 'event-start', 'event-finish',
                'event-summary', 'event-desc', 'event-location', 'event-type',
                'event-nofinish', 'event-ignore', 'event-id',
-               "question-id", "question-multiple", "question-voters", "question-end-time",
-               "has-categories", "has-media",
+               'question-id', 'question-multiple', 'question-voters', 'question-end-time',
+               'has-categories', 'has-media',
                'delivery_queue_count', 'delivery_queue_done', 'delivery_queue_failed'
        ];
 
@@ -226,7 +226,7 @@ class Item
 
                foreach ($notify_items as $notify_item) {
                        $post = Post::selectFirst(['uri-id', 'uid'], ['id' => $notify_item]);
-                       Worker::add(PRIORITY_HIGH, "Notifier", Delivery::POST, (int)$post['uri-id'], (int)$post['uid']);
+                       Worker::add(PRIORITY_HIGH, 'Notifier', Delivery::POST, (int)$post['uri-id'], (int)$post['uid']);
                }
 
                return $rows;
@@ -237,9 +237,10 @@ class Item
         *
         * @param array   $condition The condition for finding the item entries
         * @param integer $priority  Priority for the notification
+        * @return void
         * @throws \Friendica\Network\HTTPException\InternalServerErrorException
         */
-       public static function markForDeletion($condition, $priority = PRIORITY_HIGH)
+       public static function markForDeletion(array $condition, int $priority = PRIORITY_HIGH)
        {
                $items = Post::select(['id'], $condition);
                while ($item = Post::fetch($items)) {
@@ -253,9 +254,10 @@ class Item
         *
         * @param array   $condition The condition for finding the item entries
         * @param integer $uid       User who wants to delete this item
+        * @return void
         * @throws \Friendica\Network\HTTPException\InternalServerErrorException
         */
-       public static function deleteForUser($condition, $uid)
+       public static function deleteForUser(array $condition, int $uid)
        {
                if ($uid == 0) {
                        return;
@@ -282,11 +284,10 @@ class Item
         *
         * @param integer $item_id
         * @param integer $priority Priority for the notification
-        *
         * @return boolean success
         * @throws \Friendica\Network\HTTPException\InternalServerErrorException
         */
-       public static function markForDeletionById($item_id, $priority = PRIORITY_HIGH)
+       public static function markForDeletionById(int $item_id, int $priority = PRIORITY_HIGH): bool
        {
                Logger::info('Mark item for deletion by id', ['id' => $item_id, 'callstack' => System::callstack()]);
                // locate item to be deleted
@@ -331,7 +332,7 @@ class Item
                // If item has attachments, drop them
                $attachments = Post\Media::getByURIId($item['uri-id'], [Post\Media::DOCUMENT]);
                foreach($attachments as $attachment) {
-                       if (preg_match("|attach/(\d+)|", $attachment['url'], $matches)) {
+                       if (preg_match('|attach/(\d+)|', $attachment['url'], $matches)) {
                                Attach::delete(['id' => $matches[1], 'uid' => $item['uid']]);
                        }
                }
@@ -360,7 +361,7 @@ class Item
 
                        // send the notification upstream/downstream
                        if ($priority) {
-                               Worker::add(['priority' => $priority, 'dont_fork' => true], "Notifier", Delivery::DELETION, (int)$item['uri-id'], (int)$item['uid']);
+                               Worker::add(['priority' => $priority, 'dont_fork' => true], 'Notifier', Delivery::DELETION, (int)$item['uri-id'], (int)$item['uid']);
                        }
                } elseif ($item['uid'] != 0) {
                        Post\User::update($item['uri-id'], $item['uid'], ['hidden' => true]);
@@ -372,7 +373,14 @@ class Item
                return true;
        }
 
-       public static function guid($item, $notify)
+       /**
+        * Get guid from given item record
+        *
+        * @param array $item Item record
+        * @param bool Whether to notify (?)
+        * @return string Guid
+        */
+       public static function guid(array $item, bool $notify): string
        {
                if (!empty($item['guid'])) {
                        return trim($item['guid']);
@@ -425,7 +433,13 @@ class Item
                return $guid;
        }
 
-       private static function contactId($item)
+       /**
+        * Returns contact id from given item record
+        *
+        * @param array $item Item record
+        * @return int Contact id
+        */
+       private static function contactId(array $item): int
        {
                if (!empty($item['contact-id']) && DBA::exists('contact', ['self' => true, 'id' => $item['contact-id']])) {
                        return $item['contact-id'];
@@ -451,17 +465,17 @@ class Item
         * @param array $item The item fields that are to be inserted
         * @throws \Exception
         */
-       private static function spool($orig_item)
+       private static function spool(array $item)
        {
                // Now we store the data in the spool directory
                // We use "microtime" to keep the arrival order and "mt_rand" to avoid duplicates
                $file = 'item-' . round(microtime(true) * 10000) . '-' . mt_rand() . '.msg';
 
                $spoolpath = System::getSpoolPath();
-               if ($spoolpath != "") {
+               if ($spoolpath != '') {
                        $spool = $spoolpath . '/' . $file;
 
-                       file_put_contents($spool, json_encode($orig_item));
+                       file_put_contents($spool, json_encode($item));
                        Logger::warning("Item wasn't stored - Item was spooled into file", ['file' => $file]);
                }
        }
@@ -469,10 +483,10 @@ class Item
        /**
         * Check if the item array is a duplicate
         *
-        * @param array $item
+        * @param array $item Item record
         * @return boolean is it a duplicate?
         */
-       private static function isDuplicate(array $item)
+       private static function isDuplicate(array $item): bool
        {
                // Checking if there is already an item with the same guid
                $condition = ['guid' => $item['guid'], 'network' => $item['network'], 'uid' => $item['uid']];
@@ -521,10 +535,10 @@ class Item
        /**
         * Check if the item array is valid
         *
-        * @param array $item
+        * @param array $item Item record
         * @return boolean item is valid
         */
-       public static function isValid(array $item)
+       public static function isValid(array $item): bool
        {
                // When there is no content then we don't post it
                if (($item['body'] . $item['title'] == '') && (empty($item['uri-id']) || !Post\Media::existsByURIId($item['uri-id']))) {
@@ -591,10 +605,10 @@ class Item
        /**
         * Check if the item array is too old
         *
-        * @param array $item
+        * @param array $item Item record
         * @return boolean item is too old
         */
-       public static function isTooOld(array $item)
+       public static function isTooOld(array $item): bool
        {
                // check for create date and expire time
                $expire_interval = DI::config()->get('system', 'dbclean-expire-days', 0);
@@ -623,15 +637,20 @@ class Item
        /**
         * Return the id of the given item array if it has been stored before
         *
-        * @param array $item
-        * @return integer item id
+        * @param array $item Item record
+        * @return integer Item id or zero on error
         */
-       private static function getDuplicateID(array $item)
+       private static function getDuplicateID(array $item): int
        {
                if (empty($item['network']) || in_array($item['network'], Protocol::FEDERATED)) {
-                       $condition = ["`uri-id` = ? AND `uid` = ? AND `network` IN (?, ?, ?, ?)",
-                               $item['uri-id'], $item['uid'],
-                               Protocol::ACTIVITYPUB, Protocol::DIASPORA, Protocol::DFRN, Protocol::OSTATUS];
+                       $condition = ['`uri-id` = ? AND `uid` = ? AND `network` IN (?, ?, ?, ?)',
+                               $item['uri-id'],
+                               $item['uid'],
+                               Protocol::ACTIVITYPUB,
+                               Protocol::DIASPORA,
+                               Protocol::DFRN,
+                               Protocol::OSTATUS
+                       ];
                        $existing = Post::selectFirst(['id', 'network'], $condition);
                        if (DBA::isResult($existing)) {
                                // We only log the entries with a different user id than 0. Otherwise we would have too many false positives
@@ -640,12 +659,12 @@ class Item
                                                'uri-id' => $item['uri-id'],
                                                'uid' => $item['uid'],
                                                'network' => $item['network'],
-                                               'existing_id' => $existing["id"],
-                                               'existing_network' => $existing["network"]
+                                               'existing_id' => $existing['id'],
+                                               'existing_network' => $existing['network']
                                        ]);
                                }
 
-                               return $existing["id"];
+                               return $existing['id'];
                        }
                }
                return 0;
@@ -658,7 +677,7 @@ class Item
         * @return array item array with parent data
         * @throws \Exception
         */
-       private static function getTopLevelParent(array $item)
+       private static function getTopLevelParent(array $item): array
        {
                $fields = ['uid', 'uri', 'parent-uri', 'id', 'deleted',
                        'uri-id', 'parent-uri-id',
@@ -709,7 +728,7 @@ class Item
         * @param array $item
         * @return integer gravity
         */
-       private static function getGravity(array $item)
+       private static function getGravity(array $item): int
        {
                $activity = DI::activity();
 
@@ -724,11 +743,20 @@ class Item
                } elseif ($activity->match($item['verb'], Activity::ANNOUNCE)) {
                        return GRAVITY_ACTIVITY;
                }
+
                Logger::info('Unknown gravity for verb', ['verb' => $item['verb']]);
                return GRAVITY_UNKNOWN;   // Should not happen
        }
 
-       public static function insert(array $item, int $notify = 0, bool $post_local = true)
+       /**
+        * Inserts item record
+        *
+        * @param array $item Item array to be inserted
+        * @param int   $notify Notification (type?)
+        * @param bool  $post_local (???)
+        * @return int Zero means error, otherwise primary key (id) is being returned
+        */
+       public static function insert(array $item, int $notify = 0, bool $post_local = true): int
        {
                $orig_item = $item;
 
@@ -869,7 +897,7 @@ class Item
                Contact::checkAvatarCache($item['owner-id']);
 
                // The contact-id should be set before "self::insert" was called - but there seems to be issues sometimes
-               $item["contact-id"] = self::contactId($item);
+               $item['contact-id'] = self::contactId($item);
 
                if (!empty($item['direction']) && in_array($item['direction'], [Conversation::PUSH, Conversation::RELAY]) &&
                        empty($item['origin']) &&self::isTooOld($item)) {
@@ -944,8 +972,8 @@ class Item
                $item['thr-parent-id'] = ItemURI::getIdByURI($item['thr-parent']);
 
                // Is this item available in the global items (with uid=0)?
-               if ($item["uid"] == 0) {
-                       $item["global"] = true;
+               if ($item['uid'] == 0) {
+                       $item['global'] = true;
 
                        // Set the global flag on all items if this was a global item entry
                        Post::update(['global' => true], ['uri-id' => $item['uri-id']]);
@@ -954,8 +982,8 @@ class Item
                }
 
                // ACL settings
-               if (!empty($item["allow_cid"] . $item["allow_gid"] . $item["deny_cid"] . $item["deny_gid"])) {
-                       $item["private"] = self::PRIVATE;
+               if (!empty($item['allow_cid'] . $item['allow_gid'] . $item['deny_cid'] . $item['deny_gid'])) {
+                       $item['private'] = self::PRIVATE;
                }
 
                if ($notify && $post_local) {
@@ -1225,7 +1253,6 @@ class Item
 
                if ($posted_item['origin'] && ($posted_item['uid'] != 0) && in_array($posted_item['gravity'], [GRAVITY_PARENT, GRAVITY_COMMENT])) {
                        DI::cache()->delete(ActivityPub\Transmitter::CACHEKEY_OUTBOX . $posted_item['uid']);
-                       DI::cache()->delete(ActivityPub\Transmitter::CACHEKEY_PROFILE . $posted_item['uid']);
                }
 
                return $post_user_id;
@@ -1324,7 +1351,7 @@ class Item
         * @param string  $signed_text Original text (for Diaspora signatures), JSON encoded.
         * @throws \Exception
         */
-       public static function distribute($itemid, $signed_text = '')
+       public static function distribute(int $itemid, string $signed_text = '')
        {
                $condition = ["`id` IN (SELECT `parent` FROM `post-user-view` WHERE `id` = ?)", $itemid];
                $parent = Post::selectFirst(['owner-id'], $condition);
@@ -1418,7 +1445,7 @@ class Item
         * @param integer $source_uid User id of the source post
         * @return integer stored item id
         */
-       public static function storeForUserByUriId(int $uri_id, int $uid, array $fields = [], int $source_uid = 0)
+       public static function storeForUserByUriId(int $uri_id, int $uid, array $fields = [], int $source_uid = 0): int
        {
                if ($uid == $source_uid) {
                        Logger::warning('target UID must not be be equal to the source UID', ['uri-id' => $uri_id, 'uid' => $uid]);
@@ -1526,7 +1553,7 @@ class Item
         * @return integer stored item id
         * @throws \Exception
         */
-       private static function storeForUser(array $item, int $uid)
+       private static function storeForUser(array $item, int $uid): int
        {
                if (Post::exists(['uri-id' => $item['uri-id'], 'uid' => $uid])) {
                        if (!empty($item['event-id'])) {
@@ -1614,7 +1641,7 @@ class Item
         * @param integer $itemid Item ID that should be added
         * @throws \Exception
         */
-       private static function addShadow($itemid)
+       private static function addShadow(int $itemid)
        {
                $fields = ['uid', 'private', 'visible', 'deleted', 'network', 'uri-id'];
                $condition = ['id' => $itemid, 'gravity' => GRAVITY_PARENT];
@@ -1677,7 +1704,7 @@ class Item
         * @param integer $itemid Item ID that should be added
         * @throws \Exception
         */
-       private static function addShadowPost($itemid)
+       private static function addShadowPost(int $itemid)
        {
                $item = Post::selectFirst(self::ITEM_FIELDLIST, ['id' => $itemid]);
                if (!DBA::isResult($item)) {
@@ -1741,7 +1768,7 @@ class Item
         * @return string detected language
         * @throws \Text_LanguageDetect_Exception
         */
-       private static function getLanguage(array $item)
+       private static function getLanguage(array $item): string
        {
                if (!empty($item['language'])) {
                        return $item['language'];
@@ -1785,7 +1812,7 @@ class Item
                return '';
        }
 
-       public static function getLanguageMessage(array $item)
+       public static function getLanguageMessage(array $item): string
        {
                $iso639 = new \Matriphe\ISO639\ISO639;
 
@@ -1803,24 +1830,24 @@ class Item
         * Posts that are created on this system are using System::createUUID.
         * Received ActivityPub posts are using Processor::getGUIDByURL.
         *
-        * @param string $uri uri of an item entry
-        * @param string $host hostname for the GUID prefix
-        * @return string unique guid
+        * @param string      $uri uri of an item entry
+        * @param string|null $host hostname for the GUID prefix
+        * @return string Unique guid
         */
-       public static function guidFromUri($uri, $host)
+       public static function guidFromUri(string $uri, string $host = null): string
        {
                // Our regular guid routine is using this kind of prefix as well
                // We have to avoid that different routines could accidentally create the same value
                $parsed = parse_url($uri);
 
                // Remove the scheme to make sure that "https" and "http" doesn't make a difference
-               unset($parsed["scheme"]);
+               unset($parsed['scheme']);
 
                // Glue it together to be able to make a hash from it
-               $host_id = implode("/", $parsed);
+               $host_id = implode('/', $parsed);
 
                // Use a mixture of several hashes to provide some GUID like experience
-               return hash("crc32", $host) . '-'. hash('joaat', $host_id) . '-'. hash('fnv164', $host_id);
+               return hash('crc32', $host) . '-'. hash('joaat', $host_id) . '-'. hash('fnv164', $host_id);
        }
 
        /**
@@ -1832,9 +1859,9 @@ class Item
         * @return string
         * @throws \Friendica\Network\HTTPException\InternalServerErrorException
         */
-       public static function newURI($uid, $guid = "")
+       public static function newURI(int $uid, string $guid = ''): string
        {
-               if ($guid == "") {
+               if ($guid == '') {
                        $guid = System::createUUID();
                }
 
@@ -1851,7 +1878,7 @@ class Item
         * @param array $arr Contains the just posted item record
         * @throws \Exception
         */
-       private static function updateContact($arr)
+       private static function updateContact(array $arr)
        {
                // Unarchive the author
                $contact = DBA::selectFirst('contact', [], ['id' => $arr["author-id"]]);
@@ -1898,7 +1925,7 @@ class Item
                }
        }
 
-       public static function setHashtags($body)
+       public static function setHashtags(string $body): string
        {
                $body = BBCode::performWithEscapedTags($body, ['noparse', 'pre', 'code', 'img'], function ($body) {
                        $tags = BBCode::getTags($body);
@@ -1972,7 +1999,7 @@ class Item
         * @throws \Friendica\Network\HTTPException\InternalServerErrorException
         * @throws \ImagickException
         */
-       private static function tagDeliver($uid, $item_id)
+       private static function tagDeliver(int $uid, int $item_id): bool
        {
                $mention = false;
 
@@ -2067,7 +2094,7 @@ class Item
                self::performActivity($item['id'], 'announce', $item['uid']);
        }
 
-       public static function isRemoteSelf($contact, &$datarray)
+       public static function isRemoteSelf(array $contact, array &$datarray): bool
        {
                if (!$contact['remote_self']) {
                        return false;
@@ -2161,7 +2188,7 @@ class Item
         * @throws \Friendica\Network\HTTPException\InternalServerErrorException
         * @throws \ImagickException
         */
-       public static function fixPrivatePhotos($s, $uid, $item = null, $cid = 0)
+       public static function fixPrivatePhotos(string $s, int $uid, array $item = null, int $cid = 0): string
        {
                if (DI::config()->get('system', 'disable_embedded')) {
                        return $s;
@@ -2255,13 +2282,14 @@ class Item
                return $new_body;
        }
 
-       private static function hasPermissions($obj)
+       private static function hasPermissions(array $obj)
        {
                return !empty($obj['allow_cid']) || !empty($obj['allow_gid']) ||
                        !empty($obj['deny_cid']) || !empty($obj['deny_gid']);
        }
 
-       private static function samePermissions($uid, $obj1, $obj2)
+       // @TODO $uid is unused parameter
+       private static function samePermissions($uid, array $obj1, array $obj2): bool
        {
                // first part is easy. Check that these are exactly the same.
                if (($obj1['allow_cid'] == $obj2['allow_cid'])
@@ -2289,7 +2317,7 @@ class Item
         * @return array
         * @throws \Exception
         */
-       public static function enumeratePermissions(array $obj, bool $check_dead = false)
+       public static function enumeratePermissions(array $obj, bool $check_dead = false): array
        {
                $aclFormater = DI::aclFormatter();
 
@@ -2377,7 +2405,7 @@ class Item
                Logger::notice('User ' . $uid . ": expired $expired items; expire items: $expire_items, expire notes: $expire_notes, expire starred: $expire_starred, expire photos: $expire_photos");
        }
 
-       public static function firstPostDate($uid, $wall = false)
+       public static function firstPostDate(int $uid, bool $wall = false)
        {
                $user = User::getById($uid, ['register_date']);
                if (empty($user)) {
@@ -2418,7 +2446,7 @@ class Item
         *            array $arr
         *            'post_id' => ID of posted item
         */
-       public static function performActivity(int $item_id, string $verb, int $uid, string $allow_cid = null, string $allow_gid = null, string $deny_cid = null, string $deny_gid = null)
+       public static function performActivity(int $item_id, string $verb, int $uid, string $allow_cid = null, string $allow_gid = null, string $deny_cid = null, string $deny_gid = null): bool
        {
                if (empty($uid)) {
                        return false;
@@ -2612,7 +2640,7 @@ class Item
         * @param integer $owner_id User ID for which the permissions should be fetched
         * @return array condition
         */
-       public static function getPermissionsConditionArrayByUserId(int $owner_id)
+       public static function getPermissionsConditionArrayByUserId(int $owner_id): array
        {
                $local_user = local_user();
                $remote_user = Session::getRemoteContactID($owner_id);
@@ -2644,7 +2672,7 @@ class Item
         * @param string $table
         * @return string
         */
-       public static function getPermissionsSQLByUserId(int $owner_id, string $table = '')
+       public static function getPermissionsSQLByUserId(int $owner_id, string $table = ''): string
        {
                $local_user = local_user();
                $remote_user = Session::getRemoteContactID($owner_id);
@@ -2692,7 +2720,7 @@ class Item
         * @param \Friendica\Core\L10n $l10n
         * @return string
         */
-       public static function postType(array $item, \Friendica\Core\L10n $l10n)
+       public static function postType(array $item, \Friendica\Core\L10n $l10n): string
        {
                if (!empty($item['event-id'])) {
                        return $l10n->t('event');
@@ -2758,10 +2786,10 @@ class Item
         * Given an item array, convert the body element from bbcode to html and add smilie icons.
         * If attach is true, also add icons for item attachments.
         *
-        * @param array   $item
-        * @param boolean $attach
-        * @param boolean $is_preview
-        * @param boolean $only_cache
+        * @param array   $item Record from item table
+        * @param boolean $attach If true, add icons for item attachments as well
+        * @param boolean $is_preview Whether this is a preview
+        * @param boolean $only_cache Whether only cached HTML should be updated
         * @return string item body html
         * @throws \Friendica\Network\HTTPException\InternalServerErrorException
         * @throws \ImagickException
@@ -2770,7 +2798,7 @@ class Item
         * @hook  prepare_body ('item'=>item array, 'html'=>body string, 'is_preview'=>boolean, 'filter_reasons'=>string array) after first bbcode to html
         * @hook  prepare_body_final ('item'=>item array, 'html'=>body string) after attach icons and blockquote special case handling (spoiler, author)
         */
-       public static function prepareBody(array &$item, $attach = false, $is_preview = false, $only_cache = false)
+       public static function prepareBody(array &$item, bool $attach = false, bool $is_preview = false, bool $only_cache = false): string
        {
                $a = DI::app();
                Hook::callAll('prepare_body_init', $item);
@@ -2803,7 +2831,8 @@ class Item
                        $shared_uri_id = 0;
                        $shared_links = [];
                }
-               $attachments = Post\Media::splitAttachments($item['uri-id'], $item['guid'] ?? '', $shared_links, $item['has-media']);
+
+               $attachments = Post\Media::splitAttachments($item['uri-id'], $item['guid'] ?? '', $shared_links, $item['has-media'] ?? false);
                $item['body'] = self::replaceVisualAttachments($attachments, $item['body'] ?? '');
 
                $item['body'] = preg_replace("/\s*\[attachment .*?\].*?\[\/attachment\]\s*/ism", "\n", $item['body']);
@@ -2812,7 +2841,7 @@ class Item
                $s = $item["rendered-html"];
 
                if ($only_cache) {
-                       return;
+                       return '';
                }
 
                // Compile eventual content filter reasons
@@ -2892,7 +2921,7 @@ class Item
         * @param int    $type
         * @return bool
         */
-       public static function containsLink(string $body, string $url, int $type = 0)
+       public static function containsLink(string $body, string $url, int $type = 0): bool
        {
                // Make sure that for example site parameters aren't used when testing if the link is contained in the body
                $urlparts = parse_url($url);
@@ -2925,15 +2954,23 @@ class Item
         * @param string $body
         * @return string modified body
         */
-       private static function replaceVisualAttachments(array $attachments, string $body)
+       private static function replaceVisualAttachments(array $attachments, string $body): string
        {
                DI::profiler()->startRecording('rendering');
 
                foreach ($attachments['visual'] as $attachment) {
                        if (!empty($attachment['preview'])) {
-                               $body = str_replace($attachment['preview'], Post\Media::getPreviewUrlForId($attachment['id'], Proxy::SIZE_LARGE), $body);
+                               $proxy   = Post\Media::getPreviewUrlForId($attachment['id'], Proxy::SIZE_LARGE);
+                               $search  = ['[img=' . $attachment['preview'] . ']', ']' . $attachment['preview'] . '[/img]'];
+                               $replace = ['[img=' . $proxy . ']', ']' . $proxy . '[/img]'];
+
+                               $body = str_replace($search, $replace, $body);
                        } elseif ($attachment['filetype'] == 'image') {
-                               $body = str_replace($attachment['url'], Post\Media::getUrlForId($attachment['id']), $body);
+                               $proxy   = Post\Media::getUrlForId($attachment['id']);
+                               $search  = ['[img=' . $attachment['url'] . ']', ']' . $attachment['url'] . '[/img]'];
+                               $replace = ['[img=' . $proxy . ']', ']' . $proxy . '[/img]'];
+
+                               $body = str_replace($search, $replace, $body);
                        }
                }
                DI::profiler()->stopRecording();
@@ -2948,7 +2985,7 @@ class Item
         * @param string $content
         * @return string modified content
         */
-       private static function addVisualAttachments(array $attachments, array $item, string $content, bool $shared)
+       private static function addVisualAttachments(array $attachments, array $item, string $content, bool $shared): string
        {
                DI::profiler()->startRecording('rendering');
                $leading = '';
@@ -3040,7 +3077,7 @@ class Item
         * @param array  $ignore_links A list of URLs to ignore
         * @return string modified content
         */
-       private static function addLinkAttachment(int $uriid, array $attachments, string $body, string $content, bool $shared, array $ignore_links)
+       private static function addLinkAttachment(int $uriid, array $attachments, string $body, string $content, bool $shared, array $ignore_links): string
        {
                DI::profiler()->startRecording('rendering');
                // Don't show a preview when there is a visual attachment (audio or video)
@@ -3154,7 +3191,7 @@ class Item
         * @param string $content
         * @return string modified content
         */
-       private static function addNonVisualAttachments(array $attachments, array $item, string $content)
+       private static function addNonVisualAttachments(array $attachments, array $item, string $content): string
        {
                DI::profiler()->startRecording('rendering');
                $trailing = '';
@@ -3186,7 +3223,7 @@ class Item
                return $content;
        }
 
-       private static function addQuestions(array $item, string $content)
+       private static function addQuestions(array $item, string $content): string
        {
                DI::profiler()->startRecording('rendering');
                if (!empty($item['question-id'])) {
@@ -3202,13 +3239,28 @@ class Item
                                $percent = $question['voters'] ? ($option['replies'] / $question['voters'] * 100) : 0;
 
                                $options[$key]['percent'] = $percent;
-                               $options[$key]['vote']    = DI::l10n()->t('%s (%d%s, %d votes)', $option['name'], round($percent, 1), '%', $option['replies']);
+
+                               if ($question['voters'] > 0) {
+                                       $options[$key]['vote'] = DI::l10n()->t('%s (%d%s, %d votes)', $option['name'], round($percent, 1), '%', $option['replies']);
+                               } else {
+                                       $options[$key]['vote'] = DI::l10n()->t('%s (%d votes)', $option['name'], $option['replies']);
+                               }
+                       }
+
+                       if (!empty($question['voters']) && !empty($question['endtime'])) {
+                               $summary = DI::l10n()->t('%d voters. Poll end: %s', $question['voters'], Temporal::getRelativeDate($question['endtime']));
+                       } elseif (!empty($question['voters'])) {
+                               $summary = DI::l10n()->t('%d voters.', $question['voters']);
+                       } elseif (!empty($question['endtime'])) {
+                               $summary = DI::l10n()->t('Poll end: %s', Temporal::getRelativeDate($question['endtime']));
+                       } else {
+                               $summary = '';
                        }
 
                        $content .= Renderer::replaceMacros(Renderer::getMarkupTemplate('content/question.tpl'), [
                                '$question' => $question,
                                '$options'  => $options,
-                               '$summary'  => DI::l10n()->t('%d voters. Poll end: %s', $question['voters'], Temporal::getRelativeDate($question['endtime'])),
+                               '$summary'  => $summary,
                        ]);
        }
                DI::profiler()->stopRecording();
@@ -3222,7 +3274,7 @@ class Item
         * @return boolean|array False if item has not plink, otherwise array('href'=>plink url, 'title'=>translated title)
         * @throws \Exception
         */
-       public static function getPlink($item)
+       public static function getPlink(array $item)
        {
                if (!empty($item['plink']) && Network::isValidHttpUrl($item['plink'])) {
                        $plink = $item['plink'];
@@ -3269,7 +3321,7 @@ class Item
         *
         * @return boolean "true" when it is a forum post
         */
-       public static function isForumPost(int $uri_id)
+       public static function isForumPost(int $uri_id): bool
        {
                foreach (Tag::getByURIId($uri_id, [Tag::EXCLUSIVE_MENTION]) as $tag) {
                        if (DBA::exists('contact', ['uid' => 0, 'nurl' => Strings::normaliseLink($tag['url']), 'contact-type' => Contact::TYPE_COMMUNITY])) {
@@ -3287,7 +3339,7 @@ class Item
         *
         * @return integer item id
         */
-       public static function searchByLink($uri, $uid = 0)
+       public static function searchByLink(string $uri, int $uid = 0): int
        {
                $ssl_uri = str_replace('http://', 'https://', $uri);
                $uris = [$uri, $ssl_uri, Strings::normaliseLink($uri)];
@@ -3312,7 +3364,7 @@ class Item
         *
         * @return string URI
         */
-       public static function getURIByLink(string $uri)
+       public static function getURIByLink(string $uri): string
        {
                $ssl_uri = str_replace('http://', 'https://', $uri);
                $uris = [$uri, $ssl_uri, Strings::normaliseLink($uri)];
@@ -3338,7 +3390,7 @@ class Item
         *
         * @return integer item id
         */
-       public static function fetchByLink(string $uri, int $uid = 0)
+       public static function fetchByLink(string $uri, int $uid = 0): int
        {
                Logger::info('Trying to fetch link', ['uid' => $uid, 'uri' => $uri]);
                $item_id = self::searchByLink($uri, $uid);
@@ -3384,7 +3436,7 @@ class Item
         *
         * @return array with share information
         */
-       public static function getShareArray($item)
+       public static function getShareArray(array $item): array
        {
                if (!preg_match("/(.*?)\[share(.*?)\]\s?(.*?)\s?\[\/share\]\s?/ism", $item['body'], $matches)) {
                        return [];
@@ -3407,7 +3459,7 @@ class Item
         *
         * @return array item array with data from the original item
         */
-       public static function addShareDataFromOriginal(array $item)
+       public static function addShareDataFromOriginal(array $item): array
        {
                $shared = self::getShareArray($item);
                if (empty($shared)) {
@@ -3468,7 +3520,7 @@ class Item
         * @return bool
         * @throws \Exception
         */
-       protected static function isAllowedByUser(array $item, int $user_id)
+       protected static function isAllowedByUser(array $item, int $user_id): bool
        {
                if (!empty($item['author-id']) && Contact\User::isBlocked($item['author-id'], $user_id)) {
                        Logger::notice('Author is blocked by user', ['author-link' => $item['author-link'], 'uid' => $user_id, 'item-uri' => $item['uri']]);
@@ -3500,7 +3552,7 @@ class Item
         * @param array $item
         * @return string body
         */
-       public static function improveSharedDataInBody(array $item)
+       public static function improveSharedDataInBody(array $item): string
        {
                $shared = BBCode::fetchShareAttributes($item['body']);
                if (empty($shared['link'])) {