<?php
/**
- * @copyright Copyright (C) 2020, Friendica
+ * @copyright Copyright (C) 2010-2022, the Friendica project
*
* @license GNU AGPL version 3 or any later version
*
* @return int ID of inserted post
* @throws \Exception
*/
- public static function insert(int $uri_id, array $data = [])
+ public static function insert(int $uri_id, array $data = []): int
{
if (empty($uri_id)) {
throw new BadMethodCallException('Empty URI_id');
* @param object $stmt statement object
* @param bool $do_close
* @return array Data array
+ * @todo Find proper type-hint for $stmt and maybe avoid boolean
*/
- public static function toArray($stmt, $do_close = true) {
+ public static function toArray($stmt, bool $do_close = true)
+ {
if (is_bool($stmt)) {
return $stmt;
}
}
/**
- * Check if post data exists
+ * Check if post-user-view records exists
*
* @param array $condition array of fields for condition
*
* @return boolean Are there rows for that condition?
* @throws \Exception
*/
- public static function exists($condition) {
+ public static function exists(array $condition): bool
+ {
return DBA::exists('post-user-view', $condition);
}
/**
- * Counts the posts satisfying the provided condition
+ * Counts the post-user-view records satisfying the provided condition
*
* @param array $condition array of fields for condition
* @param array $params Array of several parameters
* $count = Post::count($condition);
* @throws \Exception
*/
- public static function count(array $condition = [], array $params = [])
+ public static function count(array $condition = [], array $params = []): int
{
return DBA::count('post-user-view', $condition, $params);
}
/**
- * Retrieve a single record from the post table and returns it in an associative array
+ * Counts the post-thread-user-view records satisfying the provided condition
+ *
+ * @param array $condition array of fields for condition
+ * @param array $params Array of several parameters
+ *
+ * @return int
+ *
+ * Example:
+ * $condition = ["uid" => 1, "network" => 'dspr'];
+ * or:
+ * $condition = ["`uid` = ? AND `network` IN (?, ?)", 1, 'dfrn', 'dspr'];
+ *
+ * $count = Post::count($condition);
+ * @throws \Exception
+ */
+ public static function countThread(array $condition = [], array $params = []): int
+ {
+ return DBA::count('post-thread-user-view', $condition, $params);
+ }
+
+ /**
+ * Counts the post-view records satisfying the provided condition
+ *
+ * @param array $condition array of fields for condition
+ * @param array $params Array of several parameters
+ *
+ * @return int
+ *
+ * Example:
+ * $condition = ["network" => 'dspr'];
+ * or:
+ * $condition = ["`network` IN (?, ?)", 1, 'dfrn', 'dspr'];
+ *
+ * $count = Post::count($condition);
+ * @throws \Exception
+ */
+ public static function countPosts(array $condition = [], array $params = []): int
+ {
+ return DBA::count('post-view', $condition, $params);
+ }
+
+ /**
+ * Retrieve a single record from the post-user-view view and returns it in an associative array
*
* @param array $fields
* @param array $condition
* @param array $params
+ * @param bool $user_mode true = post-user-view, false = post-view
* @return bool|array
* @throws \Exception
* @see DBA::select
*/
- public static function selectFirst(array $fields = [], array $condition = [], $params = [])
+ public static function selectFirst(array $fields = [], array $condition = [], array $params = [])
{
$params['limit'] = 1;
}
/**
- * Select rows from the post table and returns them as an array
+ * Retrieve a single record from the post-view view and returns it in an associative array
+ *
+ * @param array $fields
+ * @param array $condition
+ * @param array $params
+ * @return bool|array
+ * @throws \Exception
+ * @see DBA::select
+ */
+ public static function selectFirstPost(array $fields = [], array $condition = [], array $params = [])
+ {
+ $params['limit'] = 1;
+
+ $result = self::selectPosts($fields, $condition, $params);
+
+ if (is_bool($result)) {
+ return $result;
+ } else {
+ $row = self::fetch($result);
+ DBA::close($result);
+ return $row;
+ }
+ }
+
+ /**
+ * Retrieve a single record from the post-thread-user-view view and returns it in an associative array
+ *
+ * @param array $fields
+ * @param array $condition
+ * @param array $params
+ * @return bool|array
+ * @throws \Exception
+ * @see DBA::select
+ */
+ public static function selectFirstThread(array $fields = [], array $condition = [], array $params = [])
+ {
+ $params['limit'] = 1;
+
+ $result = self::selectThread($fields, $condition, $params);
+
+ if (is_bool($result)) {
+ return $result;
+ } else {
+ $row = self::fetch($result);
+ DBA::close($result);
+ return $row;
+ }
+ }
+
+ /**
+ * Select rows from the post-user-view view and returns them as an array
*
* @param array $selected Array of selected fields, empty for all
* @param array $condition Array of fields for condition
* @return array
* @throws \Exception
*/
- public static function selectToArray(array $fields = [], array $condition = [], $params = [])
+ public static function selectToArray(array $fields = [], array $condition = [], array $params = [])
{
$result = self::select($fields, $condition, $params);
* @return boolean|object
* @throws \Exception
*/
- private static function selectView(string $view, array $selected = [], array $condition = [], $params = [])
+ private static function selectView(string $view, array $selected = [], array $condition = [], array $params = [])
{
if (empty($selected)) {
$selected = array_merge(Item::DISPLAY_FIELDLIST, Item::ITEM_FIELDLIST);
}
/**
- * Select rows from the post table
+ * Select rows from the post-user-view view
*
* @param array $selected Array of selected fields, empty for all
* @param array $condition Array of fields for condition
* @return boolean|object
* @throws \Exception
*/
- public static function select(array $selected = [], array $condition = [], $params = [])
+ public static function select(array $selected = [], array $condition = [], array $params = [])
{
return self::selectView('post-user-view', $selected, $condition, $params);
}
/**
- * Select rows from the post table
+ * Select rows from the post-view view
*
* @param array $selected Array of selected fields, empty for all
* @param array $condition Array of fields for condition
* @return boolean|object
* @throws \Exception
*/
- public static function selectThread(array $selected = [], array $condition = [], $params = [])
+ public static function selectPosts(array $selected = [], array $condition = [], array $params = [])
+ {
+ return self::selectView('post-view', $selected, $condition, $params);
+ }
+
+ /**
+ * Select rows from the post-thread-user-view view
+ *
+ * @param array $selected Array of selected fields, empty for all
+ * @param array $condition Array of fields for condition
+ * @param array $params Array of several parameters
+ *
+ * @return boolean|object
+ * @throws \Exception
+ */
+ public static function selectThread(array $selected = [], array $condition = [], array $params = [])
{
return self::selectView('post-thread-user-view', $selected, $condition, $params);
}
* @return boolean|object
* @throws \Exception
*/
- private static function selectViewForUser(string $view, $uid, array $selected = [], array $condition = [], $params = [])
+ private static function selectViewForUser(string $view, int $uid, array $selected = [], array $condition = [], array $params = [])
{
if (empty($selected)) {
$selected = Item::DISPLAY_FIELDLIST;
$condition = DBA::mergeConditions($condition,
["`visible` AND NOT `deleted`
AND NOT `author-blocked` AND NOT `owner-blocked`
- AND (NOT `causer-blocked` OR `causer-id` = ?) AND NOT `contact-blocked`
+ AND (NOT `causer-blocked` OR `causer-id` = ? OR `causer-id` IS NULL) AND NOT `contact-blocked`
AND ((NOT `contact-readonly` AND NOT `contact-pending` AND (`contact-rel` IN (?, ?)))
OR `self` OR `gravity` != ? OR `contact-uid` = ?)
- AND NOT EXISTS (SELECT `uri-id` FROM `post-user` WHERE `hidden` AND `uri-id` = `" . $view . "`.`uri-id` AND `uid` = ?)
+ AND NOT EXISTS (SELECT `uri-id` FROM `post-user` WHERE `uid` = ? AND `uri-id` = `" . $view . "`.`uri-id` AND `hidden`)
AND NOT EXISTS (SELECT `cid` FROM `user-contact` WHERE `uid` = ? AND `cid` = `author-id` AND `blocked`)
AND NOT EXISTS (SELECT `cid` FROM `user-contact` WHERE `uid` = ? AND `cid` = `owner-id` AND `blocked`)
AND NOT EXISTS (SELECT `cid` FROM `user-contact` WHERE `uid` = ? AND `cid` = `author-id` AND `ignored` AND `gravity` = ?)
AND NOT EXISTS (SELECT `cid` FROM `user-contact` WHERE `uid` = ? AND `cid` = `owner-id` AND `ignored` AND `gravity` = ?)",
0, Contact::SHARING, Contact::FRIEND, GRAVITY_PARENT, 0, $uid, $uid, $uid, $uid, GRAVITY_PARENT, $uid, GRAVITY_PARENT]);
- $select_string = '';
-
- if (in_array('pinned', $selected)) {
- $selected = array_flip($selected);
- unset($selected['pinned']);
- $selected = array_flip($selected);
-
- $select_string = "(SELECT `pinned` FROM `post-thread-user` WHERE `uri-id` = `" . $view . "`.`uri-id` AND uid=`" . $view . "`.`uid`) AS `pinned`, ";
- }
-
- $select_string .= implode(', ', array_map([DBA::class, 'quoteIdentifier'], $selected));
+ $select_string = implode(', ', array_map([DBA::class, 'quoteIdentifier'], $selected));
$condition_string = DBA::buildCondition($condition);
$param_string = DBA::buildParameter($params);
}
/**
- * Select rows from the post view for a given user
+ * Select rows from the post-user-view view for a given user
*
* @param integer $uid User ID
* @param array $selected Array of selected fields, empty for all
* @return boolean|object
* @throws \Exception
*/
- public static function selectForUser($uid, array $selected = [], array $condition = [], $params = [])
+ public static function selectForUser(int $uid, array $selected = [], array $condition = [], array $params = [])
{
return self::selectViewForUser('post-user-view', $uid, $selected, $condition, $params);
}
- /**
- * Select rows from the post view for a given user
+ /**
+ * Select rows from the post-view view for a given user
*
* @param integer $uid User ID
* @param array $selected Array of selected fields, empty for all
* @return boolean|object
* @throws \Exception
*/
- public static function selectThreadForUser($uid, array $selected = [], array $condition = [], $params = [])
+ public static function selectPostsForUser(int $uid, array $selected = [], array $condition = [], array $params = [])
+ {
+ return self::selectViewForUser('post-view', $uid, $selected, $condition, $params);
+ }
+
+ /**
+ * Select rows from the post-thread-user-view view for a given user
+ *
+ * @param integer $uid User ID
+ * @param array $selected Array of selected fields, empty for all
+ * @param array $condition Array of fields for condition
+ * @param array $params Array of several parameters
+ *
+ * @return boolean|object
+ * @throws \Exception
+ */
+ public static function selectThreadForUser(int $uid, array $selected = [], array $condition = [], array $params = [])
{
return self::selectViewForUser('post-thread-user-view', $uid, $selected, $condition, $params);
}
/**
- * Retrieve a single record from the post view for a given user and returns it in an associative array
+ * Retrieve a single record from the post-user-view view for a given user and returns it in an associative array
*
* @param integer $uid User ID
* @param array $selected
* @throws \Exception
* @see DBA::select
*/
- public static function selectFirstForUser($uid, array $selected = [], array $condition = [], $params = [])
+ public static function selectFirstForUser(int $uid, array $selected = [], array $condition = [], array $params = [])
{
$params['limit'] = 1;
}
}
- /**
- * Select pinned rows from the item table for a given user
- *
- * @param integer $uid User ID
- * @param array $selected Array of selected fields, empty for all
- * @param array $condition Array of fields for condition
- * @param array $params Array of several parameters
- *
- * @return boolean|object
- * @throws \Exception
- */
- public static function selectPinned(int $uid, array $selected = [], array $condition = [], $params = [])
- {
- $postthreaduser = DBA::select('post-thread-user', ['uri-id'], ['uid' => $uid, 'pinned' => true]);
- if (!DBA::isResult($postthreaduser)) {
- return $postthreaduser;
- }
-
- $pinned = [];
- while ($useritem = DBA::fetch($postthreaduser)) {
- $pinned[] = $useritem['uri-id'];
- }
- DBA::close($postthreaduser);
-
- if (empty($pinned)) {
- return [];
- }
-
- $condition = DBA::mergeConditions(['uri-id' => $pinned, 'uid' => $uid, 'gravity' => GRAVITY_PARENT], $condition);
-
- return self::selectForUser($uid, $selected, $condition, $params);
- }
-
/**
* Update existing post entries
*
* @return boolean was the delete successful?
* @throws \Exception
*/
- public static function delete(array $conditions, array $options = [])
+ public static function delete(array $conditions, array $options = []): bool
{
return DBA::delete('post', $conditions, $options);
}