aboutsummaryrefslogtreecommitdiffstats
path: root/phpBB/phpbb/report/report_handler_interface.php
diff options
context:
space:
mode:
authorjaviexin <javiexin@gmail.com>2017-05-21 18:25:57 +0200
committerjaviexin <javiexin@gmail.com>2017-05-21 18:25:57 +0200
commit37c48a59c318c12547c371f0d0a8bc84f5206dcf (patch)
treea45b111970e291ff871733cfe003a74e0631c441 /phpBB/phpbb/report/report_handler_interface.php
parent60d6667eb4c5ad8a02d67dea62bc2d5b9553f958 (diff)
parentbd12504f6cf03b36821a5cea2bf77a419496dcdb (diff)
downloadforums-37c48a59c318c12547c371f0d0a8bc84f5206dcf.tar
forums-37c48a59c318c12547c371f0d0a8bc84f5206dcf.tar.gz
forums-37c48a59c318c12547c371f0d0a8bc84f5206dcf.tar.bz2
forums-37c48a59c318c12547c371f0d0a8bc84f5206dcf.tar.xz
forums-37c48a59c318c12547c371f0d0a8bc84f5206dcf.zip
Merge branch 'ticket/15068' of https://github.com/javiexin/phpbb into ticket/15068
Diffstat (limited to 'phpBB/phpbb/report/report_handler_interface.php')
-rw-r--r--phpBB/phpbb/report/report_handler_interface.php43
1 files changed, 43 insertions, 0 deletions
diff --git a/phpBB/phpbb/report/report_handler_interface.php b/phpBB/phpbb/report/report_handler_interface.php
new file mode 100644
index 0000000000..8dafc392d0
--- /dev/null
+++ b/phpBB/phpbb/report/report_handler_interface.php
@@ -0,0 +1,43 @@
+<?php
+/**
+ *
+ * This file is part of the phpBB Forum Software package.
+ *
+ * @copyright (c) phpBB Limited <https://www.phpbb.com>
+ * @license GNU General Public License, version 2 (GPL-2.0)
+ *
+ * For full copyright and license information, please see
+ * the docs/CREDITS.txt file.
+ *
+ */
+
+namespace phpbb\report;
+
+interface report_handler_interface
+{
+ /**
+ * Reports a message
+ *
+ * @param int $id
+ * @param int $reason_id
+ * @param string $report_text
+ * @param int $user_notify
+ * @return null
+ * @throws \phpbb\report\exception\empty_report_exception when the given report is empty
+ * @throws \phpbb\report\exception\already_reported_exception when the entity is already reported
+ * @throws \phpbb\report\exception\entity_not_found_exception when the entity does not exist or the user does not have viewing permissions for it
+ * @throws \phpbb\report\exception\invalid_report_exception when the entity cannot be reported for some other reason
+ */
+ public function add_report($id, $reason_id, $report_text, $user_notify);
+
+ /**
+ * Checks if the message is reportable
+ *
+ * @param int $id
+ * @return null
+ * @throws \phpbb\report\exception\already_reported_exception when the entity is already reported
+ * @throws \phpbb\report\exception\entity_not_found_exception when the entity does not exist or the user does not have viewing permissions for it
+ * @throws \phpbb\report\exception\invalid_report_exception when the entity cannot be reported for some other reason
+ */
+ public function validate_report_request($id);
+}