This repository has been archived on 2024-06-26. You can view files and clone it, but cannot push or open issues or pull requests.
sakura/libraries/Forum/Post.php

233 lines
5.8 KiB
PHP
Raw Normal View History

<?php
2016-02-03 22:22:56 +00:00
/**
* Holds the post object class.
*
* @package Sakura
*/
namespace Sakura\Forum;
2016-01-17 01:58:31 +00:00
use Sakura\Utils;
use Sakura\Database;
use Sakura\User;
use Sakura\BBcode;
use Sakura\Config;
use Sakura\Net;
/**
2016-02-02 21:04:15 +00:00
* Used to serve, create and update posts.
*
* @package Sakura
2016-02-02 21:04:15 +00:00
* @author Julian van de Groep <me@flash.moe>
*/
class Post
{
2016-02-02 21:04:15 +00:00
/**
* The ID of the post.
*
* @var int
*/
public $id = 0;
2016-02-02 21:04:15 +00:00
/**
* The id of the thread this post is a part of.
*
* @var int
*/
public $thread = 0;
2016-02-02 21:04:15 +00:00
/**
* The id of the forum this post is a part of.
*
* @var int
*/
public $forum = 0;
2016-02-02 21:04:15 +00:00
/**
* The User object of the poster.
*
* @var User
*/
public $poster = null;
/**
* The IP address from which this post was created.
*
* @var string
*/
public $ip = "";
2016-02-02 21:04:15 +00:00
/**
* The UNIX timestamp from when this post was created.
*
* @var int
*/
public $time = 0;
2016-02-02 21:04:15 +00:00
/**
* The subject of this post.
*
* @var string
*/
public $subject = "";
2016-02-02 21:04:15 +00:00
/**
* The raw contents of this post.
*
* @var string
*/
public $text = "";
2016-02-02 21:04:15 +00:00
/**
* The parsed contents of this post.
*
* @var string
*/
public $parsed = "";
2016-02-02 21:04:15 +00:00
/**
* The UNIX timestamp of the last time this post was edited.
*
* @var int
*/
public $editTime = 0;
2016-02-02 21:04:15 +00:00
/**
* The reason why this post was edited.
*
* @var string
*/
public $editReason = "";
2016-02-02 21:04:15 +00:00
/**
* The User object of the user that last edited this post.
*
* @var User
*/
public $editUser = null;
/**
* Constructor.
*
* @param int $postId ID of the post that should be constructed.
*/
public function __construct($postId)
{
// Attempt to get the database row
$postRow = Database::fetch('posts', false, ['post_id' => [$postId, '=']]);
// Assign data if a row was returned
if ($postRow) {
$this->id = $postRow['post_id'];
$this->thread = $postRow['topic_id'];
$this->forum = $postRow['forum_id'];
2015-12-29 01:27:49 +00:00
$this->poster = User::construct($postRow['poster_id']);
$this->ip = $postRow['poster_ip'];
$this->time = $postRow['post_time'];
$this->subject = $postRow['post_subject'];
$this->text = $postRow['post_text'];
$this->editTime = $postRow['post_edit_time'];
$this->editReason = $postRow['post_edit_reason'];
2015-12-29 01:27:49 +00:00
$this->editUser = User::construct($postRow['post_edit_user']);
}
// Parse the markup
$this->parsed = BBcode::toHTML(htmlentities($this->text));
}
2016-02-02 21:04:15 +00:00
/**
* Creating a new post.
*
* @param string $subject The subject of the thread.
* @param string $text The raw contents of the post.
* @param User $poster The User object of the poster.
* @param int $thread The ID of the thread this post is a reply to.
* @param mixed $forum The forum this post is a reply in.
*
* @return null|Post Either null, indicating a failure, or the Post object.
*/
public static function create($subject, $text, User $poster, $thread = 0, $forum = 0)
{
// Check if the data meets the requirements
if (strlen($subject) < Config::get('forum_title_min')
|| strlen($subject) > Config::get('forum_title_max')
|| strlen($text) < Config::get('forum_text_min')
|| strlen($text) > Config::get('forum_text_max')) {
return null;
}
// If no thread is specified create a new one
if ($thread) {
$thread = new Thread($thread);
} else {
$thread = Thread::create($forum, $subject);
}
// Stop if the thread ID is 0
if ($thread->id == 0) {
return null;
}
// Insert the post
Database::insert('posts', [
'topic_id' => $thread->id,
'forum_id' => $thread->forum,
2016-01-17 01:58:31 +00:00
'poster_id' => $poster->id,
'poster_ip' => Utils::getRemoteIP(),
'post_time' => time(),
'post_subject' => $subject,
'post_text' => $text,
]);
// Get post id
$id = Database::lastInsertID();
// Update the last post date
$thread->lastUpdate();
// Return the object
return new Post($id);
}
2016-02-02 21:04:15 +00:00
/**
* Commit the changes to the Database.
*
* @return null|Post Either null, indicating a failure, or the Post object.
*/
2016-01-10 18:24:47 +00:00
public function update()
{
2016-01-09 21:57:54 +00:00
// Check if the data meets the requirements
if (strlen($this->subject) < Config::get('forum_title_min')
|| strlen($this->subject) > Config::get('forum_title_max')
|| strlen($this->text) < Config::get('forum_text_min')
|| strlen($this->text) > Config::get('forum_text_max')) {
return null;
}
// Create a thread object
$thread = new Thread($this->thread);
// Update the post
Database::update('posts', [
[
'topic_id' => $thread->id,
'forum_id' => $thread->forum,
2016-01-17 01:58:31 +00:00
'poster_id' => $this->poster->id,
'poster_ip' => Net::pton(Net::IP()),
2016-01-09 21:57:54 +00:00
'post_time' => $this->time,
'post_subject' => $this->subject,
'post_text' => $this->text,
'post_edit_time' => $this->editTime,
'post_edit_reason' => $this->editReason,
2016-01-17 01:58:31 +00:00
'post_edit_user' => $this->editUser->id,
2016-01-09 21:57:54 +00:00
],
[
'post_id' => [$this->id, '='],
]
]);
// Return a new post object
return new Post($this->id);
}
}