ComunicAPI/classes/components/posts.php

183 lines
4.5 KiB
PHP
Raw Normal View History

2017-12-24 15:35:50 +00:00
<?php
/**
* Posts management class
*
* @author Pierre HUBERT
*/
class Posts {
2017-12-24 16:45:05 +00:00
/**
* Visibility levels
*/
//Posts that can be seen by anyone
const VISIBILITY_PUBLIC = 1;
//Posts that can be seen by the friends of the user
const VISIBILITY_FRIENDS = 2;
//Posts that can be seen by the user only
const VISIBILITY_USER = 3;
/**
2017-12-25 07:56:51 +00:00
* Table informations
2017-12-24 16:45:05 +00:00
*/
2017-12-25 07:56:51 +00:00
//Name of the table
2017-12-24 16:45:05 +00:00
const TABLE_NAME = "texte";
2017-12-25 07:56:51 +00:00
//Translation of posts types between the API language and the database structure
const POSTS_TYPE = array(
"texte" => "text",
"image" => "image",
"webpage_link" => "weblink",
"pdf" => "pdf",
"video" => "movie",
"count_down" => "countdown",
"sondage" => "survey",
"youtube" => "youtube"
);
2017-12-24 16:45:05 +00:00
/**
* Get the visibility level of a user other another user
*
* @param int $userID The ID of the user to fetch
* @param int $targetID The ID of the user target
* @return int Visibility level
*/
public function getUserVisibility(int $userID, int $targetID) : int {
//If the user making the request and the target user are the same
if($userID == $targetID)
return $this::VISIBILITY_USER;
//Check user if is signed out
if($userID == 0)
return $this::VISIBILITY_PUBLIC;
//Check if the two users are friends or not
if(CS::get()->components->friends->are_friend($userID, $targetID))
//Users are friends
return $this::VISIBILITY_FRIENDS;
else
//Users are not friend
return $this::VISIBILITY_PUBLIC;
}
/**
* Get a list of post of a user
*
* @param int $userID The ID of the user making the request
* @param int $targetID The ID of the target user
* @param int $visibilityLevel Visibility level required
* @param int $startPoint The startpoint for the request (0 stands for none)
2017-12-25 07:56:51 +00:00
* @param int $limit The maximum number of messages to fetch
2017-12-24 16:45:05 +00:00
*/
2017-12-25 07:56:51 +00:00
public function getUserPosts(int $userID, int $targetID, int $visibilityLevel, int $startPoint = 0, int $limit = 10) : array {
//Check the value of limit (security)
if($limit < 1){
throw new Exception("The limit of the query must absolutly be positive !");
}
2017-12-24 16:45:05 +00:00
//Prepare the request on the database
$conditions = "WHERE ID_personne = ? AND (";
$dataConds = array($targetID);
//Add the visibility level conditions
$conditions .= "(niveau_visibilite <= ?)";
$dataConds[] = $visibilityLevel;
//If user is signed in, include all the posts that he has created
if($userID > 0){
$conditions .= " OR (ID_amis = ?) ";
$dataConds[] = $userID;
}
2017-12-25 07:56:51 +00:00
//Close permissions conditions
2017-12-24 16:45:05 +00:00
$conditions .= ")";
2017-12-25 07:56:51 +00:00
//Add startpoint condition if required (and get older messages)
if($startPoint != 0){
$conditions .= " AND ID <= ? ";
$dataConds[] = $startPoint;
}
//Specify order and limit
$conditions.= " ORDER BY ID DESC LIMIT ".$limit;
2017-12-24 16:45:05 +00:00
//Perform the request
2017-12-25 07:56:51 +00:00
$list = CS::get()->db->select(
2017-12-24 16:45:05 +00:00
$this::TABLE_NAME,
$conditions,
$dataConds
);
2017-12-25 07:56:51 +00:00
//Parse posts
$posts = array();
foreach($list as $post){
$posts[] = $this->parse_post($post);
}
return $posts;
}
/**
* Parse a user post from the database into
* the standardized version of post structure
*
* @param array $src Informations about the post from the database
* @return array Parsed informations about the post
*/
private function parse_post(array $src) : array {
$info = array();
//Specify post ID
$info["ID"] = $src["ID"];
//Determine user ID
$info["userID"] = $src["ID_amis"] == 0 ? $src["ID_personne"] : $src["ID_amis"];
//Time when the message was sent
$info["post_time"] = strtotime($src["date_envoi"]);
//Content of the message
$info["content"] = $src["texte"];
//Visibility level
$info["visibility_level"] = $src["niveau_visibilite"];
//Determine the kind of post
$info["kind"] = $this::POSTS_TYPE[$src["type"]];
//Document info
$info["file_size"] = $src["size"];
$info["file_type"] = $src["file_type"];
$info["file_path"] = $src["path"];
$info["file_path_url"] = $src["path"] == null ? null : path_user_data($src["path"], false);
//Video specific
$info["video_id"] = $src["idvideo"];
//Countdown timer specific
$info["year_end"] = $src["annee_fin"];
$info["month_end"] = $src["mois_fin"];
$info["day_end"] = $src["jour_fin"];
//Weblink specific
$info["link_url"] = $src["url_page"];
$info["link_title"] = $src["titre_page"];
$info["link_description"] = $src["description_page"];
$info["link_image"] = $src["image_page"];
return $info;
2017-12-24 16:45:05 +00:00
}
2017-12-24 15:35:50 +00:00
}
//Register component
Components::register("posts", new Posts());