1
0
mirror of https://github.com/flarum/core.git synced 2025-07-21 16:51:34 +02:00

Rework public API based on events

This commit is contained in:
Toby Zerner
2015-07-18 22:59:47 +09:30
parent 178474adf9
commit 77d0bfccd7
136 changed files with 1157 additions and 1245 deletions

View File

@@ -21,12 +21,12 @@ class IndexAction extends SerializeCollectionAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\ActivitySerializer'; public $serializer = 'Flarum\Api\Serializers\ActivitySerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = [ public $include = [
'subject' => true, 'subject' => true,
'subject.user' => true, 'subject.user' => true,
'subject.discussion' => true 'subject.discussion' => true
@@ -35,27 +35,27 @@ class IndexAction extends SerializeCollectionAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = ['user']; public $link = ['user'];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param UserRepository $users * @param UserRepository $users

View File

@@ -18,12 +18,12 @@ class CreateAction extends BaseCreateAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\DiscussionSerializer'; public $serializer = 'Flarum\Api\Serializers\DiscussionSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = [ public $include = [
'posts' => true, 'posts' => true,
'startUser' => true, 'startUser' => true,
'lastUser' => true, 'lastUser' => true,
@@ -34,27 +34,27 @@ class CreateAction extends BaseCreateAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* Instantiate the action. * Instantiate the action.

View File

@@ -22,12 +22,12 @@ class IndexAction extends SerializeCollectionAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\DiscussionSerializer'; public $serializer = 'Flarum\Api\Serializers\DiscussionSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = [ public $include = [
'startUser' => true, 'startUser' => true,
'lastUser' => true, 'lastUser' => true,
'startPost' => false, 'startPost' => false,
@@ -40,27 +40,27 @@ class IndexAction extends SerializeCollectionAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = ['lastTime', 'commentsCount', 'startTime']; public $sortFields = ['lastTime', 'commentsCount', 'startTime'];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param DiscussionSearcher $searcher * @param DiscussionSearcher $searcher
@@ -93,7 +93,7 @@ class IndexAction extends SerializeCollectionAction
$results = $this->searcher->search($criteria, $request->limit, $request->offset, $load); $results = $this->searcher->search($criteria, $request->limit, $request->offset, $load);
// TODO: add query params (filter, sort, include) to the pagination URLs // TODO: add query params (filter, sort, include) to the pagination URLs
static::addPaginationLinks( $this->addPaginationLinks(
$document, $document,
$request, $request,
$request->http ? $this->url->toRoute('flarum.api.discussions.index') : '', $request->http ? $this->url->toRoute('flarum.api.discussions.index') : '',

View File

@@ -19,12 +19,12 @@ class ShowAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\DiscussionSerializer'; public $serializer = 'Flarum\Api\Serializers\DiscussionSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = [ public $include = [
'startUser' => false, 'startUser' => false,
'lastUser' => false, 'lastUser' => false,
'startPost' => false, 'startPost' => false,
@@ -39,27 +39,27 @@ class ShowAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = ['posts', 'posts.discussion']; public $link = ['posts', 'posts.discussion'];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = ['time']; public $sortFields = ['time'];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort = ['time' => 'asc']; public $sort = ['time' => 'asc'];
/** /**
* Instantiate the action. * Instantiate the action.

View File

@@ -17,37 +17,37 @@ class UpdateAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\DiscussionSerializer'; public $serializer = 'Flarum\Api\Serializers\DiscussionSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = []; public $include = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param Dispatcher $bus * @param Dispatcher $bus

View File

@@ -9,37 +9,37 @@ class ShowAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\ForumSerializer'; public $serializer = 'Flarum\Api\Serializers\ForumSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = []; public $include = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* Get the forum, ready to be serialized and assigned to the JsonApi * Get the forum, ready to be serialized and assigned to the JsonApi

View File

@@ -10,37 +10,37 @@ class IndexAction extends SerializeCollectionAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\GroupSerializer'; public $serializer = 'Flarum\Api\Serializers\GroupSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = []; public $include = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* Get the groups, ready to be serialized and assigned to the document * Get the groups, ready to be serialized and assigned to the document

View File

@@ -16,12 +16,12 @@ class IndexAction extends SerializeCollectionAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\NotificationSerializer'; public $serializer = 'Flarum\Api\Serializers\NotificationSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = [ public $include = [
'sender' => true, 'sender' => true,
'subject' => true, 'subject' => true,
'subject.discussion' => true 'subject.discussion' => true
@@ -30,27 +30,27 @@ class IndexAction extends SerializeCollectionAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 10; public $limit = 10;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* Instantiate the action. * Instantiate the action.

View File

@@ -16,37 +16,37 @@ class UpdateAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\NotificationSerializer'; public $serializer = 'Flarum\Api\Serializers\NotificationSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = []; public $include = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param Dispatcher $bus * @param Dispatcher $bus

View File

@@ -16,12 +16,12 @@ class CreateAction extends BaseCreateAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\PostSerializer'; public $serializer = 'Flarum\Api\Serializers\PostSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = [ public $include = [
'user' => true, 'user' => true,
'discussion' => true 'discussion' => true
]; ];
@@ -29,27 +29,27 @@ class CreateAction extends BaseCreateAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = ['discussion.posts']; public $link = ['discussion.posts'];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* Instantiate the action. * Instantiate the action.

View File

@@ -12,12 +12,12 @@ class IndexAction extends SerializeCollectionAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\PostSerializer'; public $serializer = 'Flarum\Api\Serializers\PostSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = [ public $include = [
'user' => true, 'user' => true,
'user.groups' => true, 'user.groups' => true,
'editUser' => true, 'editUser' => true,
@@ -28,27 +28,27 @@ class IndexAction extends SerializeCollectionAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param PostRepository $posts * @param PostRepository $posts

View File

@@ -16,12 +16,12 @@ class ShowAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\PostSerializer'; public $serializer = 'Flarum\Api\Serializers\PostSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = [ public $include = [
'user' => true, 'user' => true,
'user.groups' => true, 'user.groups' => true,
'editUser' => true, 'editUser' => true,
@@ -32,27 +32,27 @@ class ShowAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param PostRepository $posts * @param PostRepository $posts

View File

@@ -16,37 +16,37 @@ class UpdateAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\PostSerializer'; public $serializer = 'Flarum\Api\Serializers\PostSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = []; public $include = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param Dispatcher $bus * @param Dispatcher $bus

View File

@@ -1,6 +1,7 @@
<?php namespace Flarum\Api\Actions; <?php namespace Flarum\Api\Actions;
use Flarum\Api\Events\WillSerializeData; use Flarum\Events\BuildApiAction;
use Flarum\Events\WillSerializeData;
use Flarum\Api\Request; use Flarum\Api\Request;
use Flarum\Api\JsonApiRequest; use Flarum\Api\JsonApiRequest;
use Tobscure\JsonApi\Criteria; use Tobscure\JsonApi\Criteria;
@@ -15,7 +16,7 @@ abstract class SerializeAction extends JsonApiAction
* *
* @var string * @var string
*/ */
public static $serializer; public $serializer;
/** /**
* The relationships that are available to be included (keys), and which * The relationships that are available to be included (keys), and which
@@ -23,42 +24,42 @@ abstract class SerializeAction extends JsonApiAction
* *
* @var array * @var array
*/ */
public static $include = []; public $include = [];
/** /**
* The relationships that are linked by default. * The relationships that are linked by default.
* *
* @var array * @var array
*/ */
public static $link = []; public $link = [];
/** /**
* The maximum number of records that can be requested. * The maximum number of records that can be requested.
* *
* @var integer * @var integer
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* The number of records included by default. * The number of records included by default.
* *
* @var integer * @var integer
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* The fields that are available to be sorted by. * The fields that are available to be sorted by.
* *
* @var array * @var array
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* The default sort field and order to user. * The default sort field and order to user.
* *
* @var string * @var string
*/ */
public static $sort; public $sort;
/** /**
* Handle an API request and return an API response. * Handle an API request and return an API response.
@@ -68,14 +69,14 @@ abstract class SerializeAction extends JsonApiAction
*/ */
public function respond(Request $request) public function respond(Request $request)
{ {
$request = static::buildJsonApiRequest($request); $request = $this->buildJsonApiRequest($request);
$document = new Document(); $document = new Document();
$data = $this->data($request, $document); $data = $this->data($request, $document);
event(new WillSerializeData($this, $data, $request)); event(new WillSerializeData($this, $data, $request));
$serializer = new static::$serializer($request->actor, $request->include, $request->link); $serializer = new $this->serializer($request->actor, $request->include, $request->link);
$document->setData($this->serialize($serializer, $data)); $document->setData($this->serialize($serializer, $data));
@@ -107,17 +108,19 @@ abstract class SerializeAction extends JsonApiAction
* @param Request $request * @param Request $request
* @return JsonApiRequest * @return JsonApiRequest
*/ */
protected static function buildJsonApiRequest(Request $request) protected function buildJsonApiRequest(Request $request)
{ {
$request = new JsonApiRequest($request->input, $request->actor, $request->http); $request = new JsonApiRequest($request->input, $request->actor, $request->http);
$criteria = new Criteria($request->input); $criteria = new Criteria($request->input);
$request->include = static::sanitizeInclude($criteria->getInclude()); event(new BuildApiAction($this));
$request->sort = static::sanitizeSort($criteria->getSort());
$request->include = $this->sanitizeInclude($criteria->getInclude());
$request->sort = $this->sanitizeSort($criteria->getSort());
$request->offset = $criteria->getOffset(); $request->offset = $criteria->getOffset();
$request->limit = static::sanitizeLimit($criteria->getLimit()); $request->limit = $this->sanitizeLimit($criteria->getLimit());
$request->link = static::$link; $request->link = $this->link;
return $request; return $request;
} }
@@ -129,9 +132,9 @@ abstract class SerializeAction extends JsonApiAction
* @param array $include * @param array $include
* @return array * @return array
*/ */
protected static function sanitizeInclude(array $include) protected function sanitizeInclude(array $include)
{ {
return array_intersect($include, array_keys(static::$include)) ?: array_keys(array_filter(static::$include)); return array_intersect($include, array_keys($this->include)) ?: array_keys(array_filter($this->include));
} }
/** /**
@@ -141,9 +144,9 @@ abstract class SerializeAction extends JsonApiAction
* @param array $sort * @param array $sort
* @return array * @return array
*/ */
protected static function sanitizeSort(array $sort) protected function sanitizeSort(array $sort)
{ {
return array_intersect_key($sort, array_flip(static::$sortFields)) ?: static::$sort; return array_intersect_key($sort, array_flip($this->sortFields)) ?: $this->sort;
} }
/** /**
@@ -152,9 +155,9 @@ abstract class SerializeAction extends JsonApiAction
* @param int $limit * @param int $limit
* @return int * @return int
*/ */
protected static function sanitizeLimit($limit) protected function sanitizeLimit($limit)
{ {
return min($limit, static::$limitMax) ?: static::$limit; return min($limit, $this->limitMax) ?: $this->limit;
} }
/** /**
@@ -169,10 +172,10 @@ abstract class SerializeAction extends JsonApiAction
* is unknown ('last' link is ommitted). * is unknown ('last' link is ommitted).
* @return void * @return void
*/ */
protected static function addPaginationLinks(Document $document, JsonApiRequest $request, $url, $total = true) protected function addPaginationLinks(Document $document, JsonApiRequest $request, $url, $total = true)
{ {
$input = []; $input = [];
if ($request->limit != static::$limit) { if ($request->limit != $this->limit) {
array_set($input, 'page.limit', $request->limit); array_set($input, 'page.limit', $request->limit);
} }

View File

@@ -4,7 +4,7 @@ use Flarum\Api\Commands\GenerateAccessToken;
use Flarum\Api\Request; use Flarum\Api\Request;
use Flarum\Core\Users\UserRepository; use Flarum\Core\Users\UserRepository;
use Flarum\Core\Exceptions\PermissionDeniedException; use Flarum\Core\Exceptions\PermissionDeniedException;
use Flarum\Core\Users\Events\UserEmailChangeWasRequested; use Flarum\Events\UserEmailChangeWasRequested;
use Illuminate\Contracts\Bus\Dispatcher; use Illuminate\Contracts\Bus\Dispatcher;
use Zend\Diactoros\Response\JsonResponse; use Zend\Diactoros\Response\JsonResponse;

View File

@@ -15,37 +15,37 @@ class CreateAction extends BaseCreateAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\UserSerializer'; public $serializer = 'Flarum\Api\Serializers\UserSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = []; public $include = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param Dispatcher $bus * @param Dispatcher $bus

View File

@@ -16,7 +16,7 @@ class DeleteAvatarAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\UserSerializer'; public $serializer = 'Flarum\Api\Serializers\UserSerializer';
/** /**
* @param Dispatcher $bus * @param Dispatcher $bus

View File

@@ -22,39 +22,39 @@ class IndexAction extends SerializeCollectionAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\UserSerializer'; public $serializer = 'Flarum\Api\Serializers\UserSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = [ public $include = [
'groups' => true 'groups' => true
]; ];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = ['username', 'postsCount', 'discussionsCount', 'lastSeenTime', 'joinTime']; public $sortFields = ['username', 'postsCount', 'discussionsCount', 'lastSeenTime', 'joinTime'];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param UserSearcher $searcher * @param UserSearcher $searcher
@@ -84,7 +84,7 @@ class IndexAction extends SerializeCollectionAction
$results = $this->searcher->search($criteria, $request->limit, $request->offset, $request->include); $results = $this->searcher->search($criteria, $request->limit, $request->offset, $request->include);
static::addPaginationLinks( $this->addPaginationLinks(
$document, $document,
$request, $request,
$this->url->toRoute('flarum.api.users.index'), $this->url->toRoute('flarum.api.users.index'),

View File

@@ -15,39 +15,39 @@ class ShowAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\CurrentUserSerializer'; public $serializer = 'Flarum\Api\Serializers\CurrentUserSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = [ public $include = [
'groups' => true 'groups' => true
]; ];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param UserRepository $users * @param UserRepository $users

View File

@@ -16,37 +16,37 @@ class UpdateAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\CurrentUserSerializer'; public $serializer = 'Flarum\Api\Serializers\CurrentUserSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = []; public $include = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param Dispatcher $bus * @param Dispatcher $bus

View File

@@ -16,37 +16,37 @@ class UploadAvatarAction extends SerializeResourceAction
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $serializer = 'Flarum\Api\Serializers\UserSerializer'; public $serializer = 'Flarum\Api\Serializers\UserSerializer';
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $include = []; public $include = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $link = []; public $link = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limitMax = 50; public $limitMax = 50;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $limit = 20; public $limit = 20;
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sortFields = []; public $sortFields = [];
/** /**
* @inheritdoc * @inheritdoc
*/ */
public static $sort; public $sort;
/** /**
* @param Dispatcher $bus * @param Dispatcher $bus

View File

@@ -1,6 +1,11 @@
<?php namespace Flarum\Api; <?php namespace Flarum\Api;
use Flarum\Api\Serializers\ActivitySerializer;
use Flarum\Api\Serializers\NotificationSerializer;
use Flarum\Core\Users\Guest; use Flarum\Core\Users\Guest;
use Flarum\Events\RegisterApiRoutes;
use Flarum\Events\RegisterActivityTypes;
use Flarum\Events\RegisterNotificationTypes;
use Flarum\Http\RouteCollection; use Flarum\Http\RouteCollection;
use Flarum\Http\UrlGenerator; use Flarum\Http\UrlGenerator;
use Illuminate\Support\ServiceProvider; use Illuminate\Support\ServiceProvider;
@@ -37,6 +42,45 @@ class ApiServiceProvider extends ServiceProvider
public function boot() public function boot()
{ {
$this->routes(); $this->routes();
$this->registerActivitySerializers();
$this->registerNotificationSerializers();
}
/**
* Register activity serializers.
*/
protected function registerActivitySerializers()
{
$blueprints = [];
$serializers = [
'posted' => 'Flarum\Api\Serializers\PostBasicSerializer',
'startedDiscussion' => 'Flarum\Api\Serializers\PostBasicSerializer',
'joined' => 'Flarum\Api\Serializers\UserSerializer'
];
event(new RegisterActivityTypes($blueprints, $serializers));
foreach ($serializers as $type => $serializer) {
ActivitySerializer::setSubjectSerializer($type, $serializer);
}
}
/**
* Register notification serializers.
*/
protected function registerNotificationSerializers()
{
$blueprints = [];
$serializers = [
'discussionRenamed' => 'Flarum\Api\Serializers\DiscussionBasicSerializer'
];
event(new RegisterNotificationTypes($blueprints, $serializers));
foreach ($serializers as $type => $serializer) {
NotificationSerializer::setSubjectSerializer($type, $serializer);
}
} }
protected function routes() protected function routes()
@@ -268,6 +312,8 @@ class ApiServiceProvider extends ServiceProvider
'flarum.api.groups.delete', 'flarum.api.groups.delete',
$this->action('Flarum\Api\Actions\Groups\DeleteAction') $this->action('Flarum\Api\Actions\Groups\DeleteAction')
); );
event(new RegisterApiRoutes($routes));
} }
protected function action($class) protected function action($class)

View File

@@ -1,10 +1,10 @@
<?php namespace Flarum\Api\Serializers; <?php namespace Flarum\Api\Serializers;
use BadMethodCallException;
use Closure; use Closure;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
use Flarum\Events\ApiAttributes;
use Flarum\Events\ApiRelationship;
use Tobscure\JsonApi\SerializerAbstract; use Tobscure\JsonApi\SerializerAbstract;
use Flarum\Api\Events\SerializeAttributes;
abstract class Serializer extends SerializerAbstract abstract class Serializer extends SerializerAbstract
{ {
@@ -13,13 +13,6 @@ abstract class Serializer extends SerializerAbstract
*/ */
public $actor; public $actor;
/**
* An array of custom relation methods, grouped by subclass.
*
* @var array
*/
protected static $relationMethods = [];
/** /**
* @param User $actor * @param User $actor
* @param array|null $include * @param array|null $include
@@ -39,7 +32,7 @@ abstract class Serializer extends SerializerAbstract
{ {
$attributes = $this->getDefaultAttributes($model); $attributes = $this->getDefaultAttributes($model);
event(new SerializeAttributes($this, $model, $attributes)); event(new ApiAttributes($this, $model, $attributes));
return $attributes; return $attributes;
} }
@@ -57,13 +50,26 @@ abstract class Serializer extends SerializerAbstract
*/ */
protected function getRelationshipFromMethod($name) protected function getRelationshipFromMethod($name)
{ {
if (isset(static::$relationMethods[$name])) { if ($relationship = $this->getCustomRelationship($name)) {
return call_user_func(static::$relationMethods[$name], $this); return $relationship;
} }
return parent::getRelationshipFromMethod($name); return parent::getRelationshipFromMethod($name);
} }
/**
* Get a custom relationship.
*
* @param string $name
* @return mixed
*/
protected function getCustomRelationship($name)
{
return app('events')->until(
new ApiRelationship($this, $name)
);
}
/** /**
* Get a closure that returns a Collection/Resource representing a relation. * Get a closure that returns a Collection/Resource representing a relation.
* *
@@ -154,16 +160,4 @@ abstract class Serializer extends SerializerAbstract
{ {
return $this->getRelationship($serializer, $relation, true); return $this->getRelationship($serializer, $relation, true);
} }
/**
* Add a custom relation to the model.
*
* @param string $name The name of the relation.
* @param callable $callback The callback to execute. This should return a
* relation closure {@see Serializer::getRelationship()}
*/
public static function setRelationMethod($name, callable $callback)
{
static::$relationMethods[get_called_class()][$name] = $callback;
}
} }

View File

@@ -9,7 +9,7 @@ use Flarum\Core\Discussions\Discussion;
use Flarum\Core\Discussions\DiscussionState; use Flarum\Core\Discussions\DiscussionState;
use Flarum\Core\Posts\CommentPost; use Flarum\Core\Posts\CommentPost;
use Flarum\Tags\Tag; use Flarum\Tags\Tag;
use Flarum\Core\Posts\Events\PostWasPosted; use Flarum\Events\PostWasPosted;
use Symfony\Component\Console\Helper\ProgressBar; use Symfony\Component\Console\Helper\ProgressBar;
class ImportCommand extends Command class ImportCommand extends Command

View File

@@ -27,7 +27,7 @@ class Activity extends Model
/** /**
* {@inheritdoc} * {@inheritdoc}
*/ */
protected static $dateAttributes = ['time']; protected $dates = ['time'];
/** /**
* A map of activity types and the model classes to use for their subjects. * A map of activity types and the model classes to use for their subjects.

View File

@@ -1,5 +1,7 @@
<?php namespace Flarum\Core\Activity; <?php namespace Flarum\Core\Activity;
use Flarum\Core\Users\User;
use Flarum\Events\RegisterActivityTypes;
use Flarum\Support\ServiceProvider; use Flarum\Support\ServiceProvider;
use Flarum\Extend; use Flarum\Extend;
@@ -12,18 +14,33 @@ class ActivityServiceProvider extends ServiceProvider
*/ */
public function boot() public function boot()
{ {
$this->extend([ $this->registerActivityTypes();
(new Extend\EventSubscriber('Flarum\Core\Activity\Listeners\UserActivitySyncer')),
(new Extend\ActivityType('Flarum\Core\Activity\PostedBlueprint')) $events = $this->app->make('events');
->subjectSerializer('Flarum\Api\Serializers\PostBasicSerializer'), $events->subscribe('Flarum\Core\Activity\Listeners\UserActivitySyncer');
}
(new Extend\ActivityType('Flarum\Core\Activity\StartedDiscussionBlueprint')) /**
->subjectSerializer('Flarum\Api\Serializers\PostBasicSerializer'), * Register activity types.
*
* @return void
*/
public function registerActivityTypes()
{
$blueprints = [
'Flarum\Core\Activity\PostedBlueprint',
'Flarum\Core\Activity\StartedDiscussionBlueprint',
'Flarum\Core\Activity\JoinedBlueprint'
];
(new Extend\ActivityType('Flarum\Core\Activity\JoinedBlueprint')) event(new RegisterActivityTypes($blueprints));
->subjectSerializer('Flarum\Api\Serializers\UserBasicSerializer')
]); foreach ($blueprints as $blueprint) {
Activity::setSubjectModel(
$blueprint::getType(),
$blueprint::getSubjectModel()
);
}
} }
/** /**

View File

@@ -5,11 +5,11 @@ use Flarum\Core\Activity\PostedBlueprint;
use Flarum\Core\Activity\StartedDiscussionBlueprint; use Flarum\Core\Activity\StartedDiscussionBlueprint;
use Flarum\Core\Activity\JoinedBlueprint; use Flarum\Core\Activity\JoinedBlueprint;
use Flarum\Core\Posts\Post; use Flarum\Core\Posts\Post;
use Flarum\Core\Posts\Events\PostWasPosted; use Flarum\Events\PostWasPosted;
use Flarum\Core\Posts\Events\PostWasDeleted; use Flarum\Events\PostWasDeleted;
use Flarum\Core\Posts\Events\PostWasHidden; use Flarum\Events\PostWasHidden;
use Flarum\Core\Posts\Events\PostWasRestored; use Flarum\Events\PostWasRestored;
use Flarum\Core\Users\Events\UserWasRegistered; use Flarum\Events\UserWasRegistered;
use Illuminate\Contracts\Events\Dispatcher; use Illuminate\Contracts\Events\Dispatcher;
class UserActivitySyncer class UserActivitySyncer
@@ -33,15 +33,15 @@ class UserActivitySyncer
*/ */
public function subscribe(Dispatcher $events) public function subscribe(Dispatcher $events)
{ {
$events->listen('Flarum\Core\Posts\Events\PostWasPosted', __CLASS__.'@whenPostWasPosted'); $events->listen('Flarum\Events\PostWasPosted', __CLASS__.'@whenPostWasPosted');
$events->listen('Flarum\Core\Posts\Events\PostWasHidden', __CLASS__.'@whenPostWasHidden'); $events->listen('Flarum\Events\PostWasHidden', __CLASS__.'@whenPostWasHidden');
$events->listen('Flarum\Core\Posts\Events\PostWasRestored', __CLASS__.'@whenPostWasRestored'); $events->listen('Flarum\Events\PostWasRestored', __CLASS__.'@whenPostWasRestored');
$events->listen('Flarum\Core\Posts\Events\PostWasDeleted', __CLASS__.'@whenPostWasDeleted'); $events->listen('Flarum\Events\PostWasDeleted', __CLASS__.'@whenPostWasDeleted');
$events->listen('Flarum\Core\Users\Events\UserWasRegistered', __CLASS__.'@whenUserWasRegistered'); $events->listen('Flarum\Events\UserWasRegistered', __CLASS__.'@whenUserWasRegistered');
} }
/** /**
* @param \Flarum\Core\Posts\Events\PostWasPosted $event * @param \Flarum\Events\PostWasPosted $event
* @return void * @return void
*/ */
public function whenPostWasPosted(PostWasPosted $event) public function whenPostWasPosted(PostWasPosted $event)
@@ -50,7 +50,7 @@ class UserActivitySyncer
} }
/** /**
* @param \Flarum\Core\Posts\Events\PostWasHidden $event * @param \Flarum\Events\PostWasHidden $event
* @return void * @return void
*/ */
public function whenPostWasHidden(PostWasHidden $event) public function whenPostWasHidden(PostWasHidden $event)
@@ -59,7 +59,7 @@ class UserActivitySyncer
} }
/** /**
* @param \Flarum\Core\Posts\Events\PostWasRestored $event * @param \Flarum\Events\PostWasRestored $event
* @return void * @return void
*/ */
public function whenPostWasRestored(PostWasRestored $event) public function whenPostWasRestored(PostWasRestored $event)
@@ -68,7 +68,7 @@ class UserActivitySyncer
} }
/** /**
* @param \Flarum\Core\Posts\Events\PostWasDeleted $event * @param \Flarum\Events\PostWasDeleted $event
* @return void * @return void
*/ */
public function whenPostWasDeleted(PostWasDeleted $event) public function whenPostWasDeleted(PostWasDeleted $event)
@@ -77,7 +77,7 @@ class UserActivitySyncer
} }
/** /**
* @param \Flarum\Core\Users\Events\UserWasRegistered $event * @param \Flarum\Events\UserWasRegistered $event
* @return void * @return void
*/ */
public function whenUserWasRegistered(UserWasRegistered $event) public function whenUserWasRegistered(UserWasRegistered $event)

View File

@@ -3,6 +3,7 @@
use Flarum\Core\Settings\MemoryCacheSettingsRepository; use Flarum\Core\Settings\MemoryCacheSettingsRepository;
use Flarum\Core\Settings\DatabaseSettingsRepository; use Flarum\Core\Settings\DatabaseSettingsRepository;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
use Flarum\Events\ModelAllow;
use Flarum\Support\ServiceProvider; use Flarum\Support\ServiceProvider;
use Flarum\Extend; use Flarum\Extend;
@@ -21,8 +22,13 @@ class CoreServiceProvider extends ServiceProvider
return get_class($command).'Handler@handle'; return get_class($command).'Handler@handle';
}); });
Forum::allow('*', function (Forum $forum, User $user, $action) { $events = $this->app->make('events');
return $user->hasPermission('forum.'.$action) ?: null;
$events->listen(ModelAllow::class, function (ModelAllow $event) {
if ($event->model instanceof Forum &&
$event->actor->hasPermission('forum.'.$event->action)) {
return true;
}
}); });
} }
@@ -33,7 +39,7 @@ class CoreServiceProvider extends ServiceProvider
*/ */
public function register() public function register()
{ {
$this->app->singleton('Flarum\Core\Settings\SettingsRepository', function() { $this->app->singleton('Flarum\Core\Settings\SettingsRepository', function () {
return new MemoryCacheSettingsRepository( return new MemoryCacheSettingsRepository(
new DatabaseSettingsRepository( new DatabaseSettingsRepository(
$this->app->make('Illuminate\Database\ConnectionInterface') $this->app->make('Illuminate\Database\ConnectionInterface')

View File

@@ -1,7 +1,7 @@
<?php namespace Flarum\Core\Discussions\Commands; <?php namespace Flarum\Core\Discussions\Commands;
use Flarum\Core\Discussions\DiscussionRepository; use Flarum\Core\Discussions\DiscussionRepository;
use Flarum\Core\Discussions\Events\DiscussionWillBeDeleted; use Flarum\Events\DiscussionWillBeDeleted;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;
class DeleteDiscussionHandler class DeleteDiscussionHandler

View File

@@ -1,7 +1,7 @@
<?php namespace Flarum\Core\Discussions\Commands; <?php namespace Flarum\Core\Discussions\Commands;
use Flarum\Core\Discussions\DiscussionRepository; use Flarum\Core\Discussions\DiscussionRepository;
use Flarum\Core\Discussions\Events\DiscussionWillBeSaved; use Flarum\Events\DiscussionWillBeSaved;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;
class EditDiscussionHandler class EditDiscussionHandler

View File

@@ -1,7 +1,7 @@
<?php namespace Flarum\Core\Discussions\Commands; <?php namespace Flarum\Core\Discussions\Commands;
use Flarum\Core\Discussions\DiscussionRepository; use Flarum\Core\Discussions\DiscussionRepository;
use Flarum\Core\Discussions\Events\DiscussionStateWillBeSaved; use Flarum\Events\DiscussionStateWillBeSaved;
use Flarum\Core\Exceptions\PermissionDeniedException; use Flarum\Core\Exceptions\PermissionDeniedException;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;

View File

@@ -1,6 +1,6 @@
<?php namespace Flarum\Core\Discussions\Commands; <?php namespace Flarum\Core\Discussions\Commands;
use Flarum\Core\Discussions\Events\DiscussionWillBeSaved; use Flarum\Events\DiscussionWillBeSaved;
use Flarum\Core\Forum; use Flarum\Core\Forum;
use Illuminate\Contracts\Bus\Dispatcher; use Illuminate\Contracts\Bus\Dispatcher;
use Flarum\Core\Discussions\Discussion; use Flarum\Core\Discussions\Discussion;

View File

@@ -1,10 +1,10 @@
<?php namespace Flarum\Core\Discussions; <?php namespace Flarum\Core\Discussions;
use Flarum\Core\Model; use Flarum\Core\Model;
use Flarum\Core\Discussions\Events\DiscussionWasDeleted; use Flarum\Events\DiscussionWasDeleted;
use Flarum\Core\Discussions\Events\DiscussionWasStarted; use Flarum\Events\DiscussionWasStarted;
use Flarum\Core\Discussions\Events\DiscussionWasRenamed; use Flarum\Events\DiscussionWasRenamed;
use Flarum\Core\Posts\Events\PostWasDeleted; use Flarum\Events\PostWasDeleted;
use Flarum\Core\Posts\Post; use Flarum\Core\Posts\Post;
use Flarum\Core\Posts\MergeablePost; use Flarum\Core\Posts\MergeablePost;
use Flarum\Core\Users\Guest; use Flarum\Core\Users\Guest;
@@ -21,13 +21,10 @@ class Discussion extends Model
{ {
use EventGenerator; use EventGenerator;
use Locked; use Locked;
use VisibleScope;
use ValidatesBeforeSave; use ValidatesBeforeSave;
/** /**
* The table associated with the model. * {@inheritdoc}
*
* @var string
*/ */
protected $table = 'discussions'; protected $table = 'discussions';
@@ -57,11 +54,9 @@ class Discussion extends Model
protected $modifiedPosts = []; protected $modifiedPosts = [];
/** /**
* The attributes that should be mutated to dates. * {@inheritdoc}
*
* @var array
*/ */
protected static $dateAttributes = ['start_time', 'last_time']; protected $dates = ['start_time', 'last_time'];
/** /**
* The user for which the state relationship should be loaded. * The user for which the state relationship should be loaded.

View File

@@ -1,6 +1,6 @@
<?php namespace Flarum\Core\Discussions; <?php namespace Flarum\Core\Discussions;
use Flarum\Core\Discussions\Events\DiscussionWasRead; use Flarum\Events\DiscussionWasRead;
use Flarum\Core\Model; use Flarum\Core\Model;
use Flarum\Core\Support\EventGenerator; use Flarum\Core\Support\EventGenerator;
use Illuminate\Database\Eloquent\Builder; use Illuminate\Database\Eloquent\Builder;
@@ -26,7 +26,7 @@ class DiscussionState extends Model
/** /**
* {@inheritdoc} * {@inheritdoc}
*/ */
protected static $dateAttributes = ['read_time']; protected $dates = ['read_time'];
/** /**
* Mark the discussion as being read up to a certain point. Raises the * Mark the discussion as being read up to a certain point. Raises the

View File

@@ -2,6 +2,8 @@
use Flarum\Core\Search\GambitManager; use Flarum\Core\Search\GambitManager;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
use Flarum\Events\ModelAllow;
use Flarum\Events\RegisterDiscussionGambits;
use Flarum\Support\ServiceProvider; use Flarum\Support\ServiceProvider;
use Flarum\Extend; use Flarum\Extend;
use Illuminate\Contracts\Container\Container; use Illuminate\Contracts\Container\Container;
@@ -15,25 +17,29 @@ class DiscussionsServiceProvider extends ServiceProvider
*/ */
public function boot() public function boot()
{ {
$this->extend([
new Extend\EventSubscriber('Flarum\Core\Discussions\Listeners\DiscussionMetadataUpdater')
]);
Discussion::setValidator($this->app->make('validator')); Discussion::setValidator($this->app->make('validator'));
Discussion::allow('*', function (Discussion $discussion, User $user, $action) { $events = $this->app->make('events');
return $user->hasPermission('discussion.'.$action) ?: null;
});
// Allow a user to rename their own discussion. $events->subscribe('Flarum\Core\Discussions\Listeners\DiscussionMetadataUpdater');
Discussion::allow('rename', function (Discussion $discussion, User $user) {
return $discussion->start_user_id == $user->id ?: null;
// TODO: add limitations to time etc. according to a config setting
});
Discussion::allow('delete', function (Discussion $discussion, User $user) { $events->listen(ModelAllow::class, function (ModelAllow $event) {
return $discussion->start_user_id == $user->id && $discussion->participants_count == 1 ?: null; if ($event->model instanceof Discussion) {
// TODO: add limitations to time etc. according to a config setting if ($event->action === 'rename' &&
$event->model->start_user_id == $event->actor->id) {
return true;
}
if ($event->action === 'delete' &&
$event->model->start_user_id == $event->actor->id &&
$event->model->participants_count == 1) {
return true;
}
if ($event->actor->hasPermission('discussion.'.$event->action)) {
return true;
}
}
}); });
} }
@@ -49,21 +55,15 @@ class DiscussionsServiceProvider extends ServiceProvider
'Flarum\Core\Discussions\Search\Fulltext\MySqlFulltextDriver' 'Flarum\Core\Discussions\Search\Fulltext\MySqlFulltextDriver'
); );
$this->app->instance('flarum.discussionGambits', [
'Flarum\Core\Discussions\Search\Gambits\AuthorGambit',
'Flarum\Core\Discussions\Search\Gambits\UnreadGambit'
]);
$this->app->when('Flarum\Core\Discussions\Search\DiscussionSearcher') $this->app->when('Flarum\Core\Discussions\Search\DiscussionSearcher')
->needs('Flarum\Core\Search\GambitManager') ->needs('Flarum\Core\Search\GambitManager')
->give(function (Container $app) { ->give(function (Container $app) {
$gambits = new GambitManager($app); $gambits = new GambitManager($app);
foreach ($app->make('flarum.discussionGambits') as $gambit) {
$gambits->add($gambit);
}
$gambits->setFulltextGambit('Flarum\Core\Discussions\Search\Gambits\FulltextGambit'); $gambits->setFulltextGambit('Flarum\Core\Discussions\Search\Gambits\FulltextGambit');
$gambits->add('Flarum\Core\Discussions\Search\Gambits\AuthorGambit');
$gambits->add('Flarum\Core\Discussions\Search\Gambits\UnreadGambit');
event(new RegisterDiscussionGambits($gambits));
return $gambits; return $gambits;
}); });

View File

@@ -1,10 +1,10 @@
<?php namespace Flarum\Core\Discussions\Listeners; <?php namespace Flarum\Core\Discussions\Listeners;
use Flarum\Core\Posts\Post; use Flarum\Core\Posts\Post;
use Flarum\Core\Posts\Events\PostWasPosted; use Flarum\Events\PostWasPosted;
use Flarum\Core\Posts\Events\PostWasDeleted; use Flarum\Events\PostWasDeleted;
use Flarum\Core\Posts\Events\PostWasHidden; use Flarum\Events\PostWasHidden;
use Flarum\Core\Posts\Events\PostWasRestored; use Flarum\Events\PostWasRestored;
use Illuminate\Contracts\Events\Dispatcher; use Illuminate\Contracts\Events\Dispatcher;
class DiscussionMetadataUpdater class DiscussionMetadataUpdater
@@ -34,7 +34,7 @@ class DiscussionMetadataUpdater
} }
/** /**
* @param PostWasDeleted $event * @param \Flarum\Events\PostWasDeleted $event
*/ */
public function whenPostWasDeleted(PostWasDeleted $event) public function whenPostWasDeleted(PostWasDeleted $event)
{ {

View File

@@ -7,7 +7,7 @@ use Flarum\Core\Search\SearcherInterface;
use Flarum\Core\Search\GambitManager; use Flarum\Core\Search\GambitManager;
use Flarum\Core\Discussions\DiscussionRepository; use Flarum\Core\Discussions\DiscussionRepository;
use Flarum\Core\Posts\PostRepository; use Flarum\Core\Posts\PostRepository;
use Flarum\Core\Discussions\Events\DiscussionSearchWillBePerformed; use Flarum\Events\DiscussionSearchWillBePerformed;
use Flarum\Core\Search\SearchResults; use Flarum\Core\Search\SearchResults;
use Illuminate\Database\Eloquent\Collection; use Illuminate\Database\Eloquent\Collection;

View File

@@ -12,9 +12,6 @@ class FormatterServiceProvider extends ServiceProvider
*/ */
public function boot() public function boot()
{ {
$this->extend([
new Extend\PostFormatter('Flarum\Core\Formatter\LinkifyFormatter')
]);
} }
/** /**

View File

@@ -1,6 +1,13 @@
<?php namespace Flarum\Core; <?php namespace Flarum\Core;
use Flarum\Core\Exceptions\PermissionDeniedException;
use Flarum\Core\Users\User;
use Flarum\Events\ModelAllow;
use Flarum\Events\ModelDates;
use Flarum\Events\ModelRelationship;
use Flarum\Events\ScopeModelVisibility;
use Illuminate\Contracts\Validation\Factory; use Illuminate\Contracts\Validation\Factory;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model as Eloquent; use Illuminate\Database\Eloquent\Model as Eloquent;
use Illuminate\Database\Eloquent\Relations\Relation; use Illuminate\Database\Eloquent\Relations\Relation;
use LogicException; use LogicException;
@@ -11,6 +18,9 @@ use LogicException;
* Adds the ability for custom relations to be added to a model during runtime. * Adds the ability for custom relations to be added to a model during runtime.
* These relations behave in the same way that you would expect; they can be * These relations behave in the same way that you would expect; they can be
* queried, eager loaded, and accessed as an attribute. * queried, eager loaded, and accessed as an attribute.
*
* Also has a scope method `whereVisibleTo` that scopes a query to only include
* records that the user has permission to see.
*/ */
abstract class Model extends Eloquent abstract class Model extends Eloquent
{ {
@@ -21,20 +31,6 @@ abstract class Model extends Eloquent
*/ */
public $timestamps = false; public $timestamps = false;
/**
* The attributes that should be mutated to dates.
*
* @var array
*/
protected static $dateAttributes = [];
/**
* An array of custom relation methods, grouped by subclass.
*
* @var array
*/
protected static $relationMethods = [];
/** /**
* Get the attributes that should be converted to dates. * Get the attributes that should be converted to dates.
* *
@@ -42,17 +38,56 @@ abstract class Model extends Eloquent
*/ */
public function getDates() public function getDates()
{ {
return array_merge(static::$dateAttributes, $this->dates); $dates = $this->dates;
event(new ModelDates($this, $dates));
return $dates;
} }
/** /**
* Add an attribute to be converted to a date. * Check whether or not a user has permission to perform an action,
* according to the collected conditions.
* *
* @param string $attribute * @param User $actor
* @param string $action
* @return bool
*/ */
public static function addDateAttribute($attribute) public function can(User $actor, $action)
{ {
static::$dateAttributes[] = $attribute; $can = static::$dispatcher->until(new ModelAllow($this, $actor, $action));
if ($can !== null) {
return $can;
}
return false;
}
/**
* Assert that the user has a certain permission for this model, throwing
* an exception if they don't.
*
* @param User $actor
* @param string $action
* @throws PermissionDeniedException
*/
public function assertCan(User $actor, $action)
{
if (! $this->can($actor, $action)) {
throw new PermissionDeniedException;
}
}
/**
* Scope a query to only include records that are visible to a user.
*
* @param Builder $query
* @param User $actor
*/
public function scopeWhereVisibleTo(Builder $query, User $actor)
{
event(new ScopeModelVisibility($this, $query, $actor));
} }
/** /**
@@ -71,40 +106,38 @@ abstract class Model extends Eloquent
// If a custom relation with this key has been set up, then we will load // If a custom relation with this key has been set up, then we will load
// and return results from the query and hydrate the relationship's // and return results from the query and hydrate the relationship's
// value on the "relationships" array. // value on the "relationships" array.
if (isset(static::$relationMethods[get_called_class()][$key])) { if ($relation = $this->getCustomRelation($key)) {
return $this->getCustomRelationship($key);
}
}
/**
* Get a relationship value from a custom relationship method.
*
* @param string $name
* @return mixed
*
* @throws \LogicException
*/
protected function getCustomRelationship($name)
{
$relation = static::$relationMethods[get_called_class()][$name]($this);
if (! $relation instanceof Relation) { if (! $relation instanceof Relation) {
throw new LogicException('Relationship method must return an object of type ' throw new LogicException('Relationship method must return an object of type '
. 'Illuminate\Database\Eloquent\Relations\Relation'); . 'Illuminate\Database\Eloquent\Relations\Relation');
} }
return $this->relations[$name] = $relation->getResults(); return $this->relations[$key] = $relation->getResults();
}
} }
/** /**
* Add a custom relation to the model. * Get a custom relation object.
* *
* @param string $name The name of the relation. * @param string $name
* @param callable $callback The callback to execute. This should return an * @return mixed
* object of type Illuminate\Database\Eloquent\Relations\Relation.
*/ */
public static function setRelationMethod($name, callable $callback) protected function getCustomRelation($name)
{ {
static::$relationMethods[get_called_class()][$name] = $callback; return static::$dispatcher->until(
new ModelRelationship($this, $name)
);
}
/**
* @inheritdoc
*/
public function __call($method, $arguments)
{
if ($relation = $this->getCustomRelation($method)) {
return $relation;
}
return parent::__call($method, $arguments);
} }
} }

View File

@@ -1,6 +1,6 @@
<?php namespace Flarum\Core\Notifications\Listeners; <?php namespace Flarum\Core\Notifications\Listeners;
use Flarum\Core\Discussions\Events\DiscussionWasRenamed; use Flarum\Events\DiscussionWasRenamed;
use Flarum\Core\Posts\DiscussionRenamedPost; use Flarum\Core\Posts\DiscussionRenamedPost;
use Flarum\Core\Notifications\DiscussionRenamedBlueprint; use Flarum\Core\Notifications\DiscussionRenamedBlueprint;
use Flarum\Core\Notifications\NotificationSyncer; use Flarum\Core\Notifications\NotificationSyncer;
@@ -30,7 +30,7 @@ class DiscussionRenamedNotifier
} }
/** /**
* @param DiscussionWasRenamed $event * @param \Flarum\Events\DiscussionWasRenamed $event
*/ */
public function whenDiscussionWasRenamed(DiscussionWasRenamed $event) public function whenDiscussionWasRenamed(DiscussionWasRenamed $event)
{ {

View File

@@ -31,7 +31,7 @@ class Notification extends Model
/** /**
* {@inheritdoc} * {@inheritdoc}
*/ */
protected static $dateAttributes = ['time']; protected $dates = ['time'];
/** /**
* A map of notification types and the model classes to use for their * A map of notification types and the model classes to use for their

View File

@@ -1,6 +1,6 @@
<?php namespace Flarum\Core\Notifications; <?php namespace Flarum\Core\Notifications;
use Flarum\Core\Notifications\Events\NotificationWillBeSent; use Flarum\Events\NotificationWillBeSent;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
use Carbon\Carbon; use Carbon\Carbon;

View File

@@ -1,7 +1,10 @@
<?php namespace Flarum\Core\Notifications; <?php namespace Flarum\Core\Notifications;
use Flarum\Core\Users\User;
use Flarum\Events\RegisterNotificationTypes;
use Flarum\Support\ServiceProvider; use Flarum\Support\ServiceProvider;
use Flarum\Extend; use Flarum\Extend;
use ReflectionClass;
class NotificationsServiceProvider extends ServiceProvider class NotificationsServiceProvider extends ServiceProvider
{ {
@@ -12,13 +15,46 @@ class NotificationsServiceProvider extends ServiceProvider
*/ */
public function boot() public function boot()
{ {
$this->extend([ $events = $this->app->make('events');
(new Extend\EventSubscriber('Flarum\Core\Notifications\Listeners\DiscussionRenamedNotifier')),
(new Extend\NotificationType('Flarum\Core\Notifications\DiscussionRenamedBlueprint')) $events->subscribe('Flarum\Core\Notifications\Listeners\DiscussionRenamedNotifier');
->subjectSerializer('Flarum\Api\Serializers\DiscussionBasicSerializer')
->enableByDefault('alert') $this->registerNotificationTypes();
]); }
/**
* Register notification types.
*
* @return void
*/
public function registerNotificationTypes()
{
$blueprints = [
'Flarum\Core\Notifications\DiscussionRenamedBlueprint' => ['alert']
];
event(new RegisterNotificationTypes($blueprints));
foreach ($blueprints as $blueprint => $enabled) {
Notification::setSubjectModel(
$type = $blueprint::getType(),
$blueprint::getSubjectModel()
);
User::addPreference(
User::getNotificationPreferenceKey($type, 'alert'),
'boolval',
in_array('alert', $enabled)
);
if ((new ReflectionClass($blueprint))->implementsInterface('Flarum\Core\Notifications\MailableBlueprint')) {
User::addPreference(
User::getNotificationPreferenceKey($type, 'email'),
'boolval',
in_array('email', $enabled)
);
}
}
} }
/** /**

View File

@@ -1,7 +1,7 @@
<?php namespace Flarum\Core\Posts\Commands; <?php namespace Flarum\Core\Posts\Commands;
use Flarum\Core\Posts\PostRepository; use Flarum\Core\Posts\PostRepository;
use Flarum\Core\Posts\Events\PostWillBeDeleted; use Flarum\Events\PostWillBeDeleted;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;
class DeletePostHandler class DeletePostHandler

View File

@@ -1,7 +1,7 @@
<?php namespace Flarum\Core\Posts\Commands; <?php namespace Flarum\Core\Posts\Commands;
use Flarum\Core\Posts\PostRepository; use Flarum\Core\Posts\PostRepository;
use Flarum\Core\Posts\Events\PostWillBeSaved; use Flarum\Events\PostWillBeSaved;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;
use Flarum\Core\Posts\CommentPost; use Flarum\Core\Posts\CommentPost;

View File

@@ -1,6 +1,6 @@
<?php namespace Flarum\Core\Posts\Commands; <?php namespace Flarum\Core\Posts\Commands;
use Flarum\Core\Posts\Events\PostWillBeSaved; use Flarum\Events\PostWillBeSaved;
use Flarum\Core\Discussions\DiscussionRepository; use Flarum\Core\Discussions\DiscussionRepository;
use Flarum\Core\Posts\CommentPost; use Flarum\Core\Posts\CommentPost;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;

View File

@@ -2,10 +2,10 @@
use DomainException; use DomainException;
use Flarum\Core\Formatter\FormatterManager; use Flarum\Core\Formatter\FormatterManager;
use Flarum\Core\Posts\Events\PostWasPosted; use Flarum\Events\PostWasPosted;
use Flarum\Core\Posts\Events\PostWasRevised; use Flarum\Events\PostWasRevised;
use Flarum\Core\Posts\Events\PostWasHidden; use Flarum\Events\PostWasHidden;
use Flarum\Core\Posts\Events\PostWasRestored; use Flarum\Events\PostWasRestored;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
/** /**

View File

@@ -1,7 +1,7 @@
<?php namespace Flarum\Core\Posts; <?php namespace Flarum\Core\Posts;
use DomainException; use DomainException;
use Flarum\Core\Posts\Events\PostWasDeleted; use Flarum\Events\PostWasDeleted;
use Flarum\Core\Model; use Flarum\Core\Model;
use Flarum\Core\Support\Locked; use Flarum\Core\Support\Locked;
use Flarum\Core\Support\EventGenerator; use Flarum\Core\Support\EventGenerator;
@@ -42,7 +42,7 @@ class Post extends Model
/** /**
* {@inheritdoc} * {@inheritdoc}
*/ */
protected static $dateAttributes = ['time', 'edit_time', 'hide_time']; protected $dates = ['time', 'edit_time', 'hide_time'];
/** /**
* A map of post types, as specified in the `type` column, to their * A map of post types, as specified in the `type` column, to their
@@ -161,6 +161,7 @@ class Post extends Model
&& isset(static::$models[$attributes['type']]) && isset(static::$models[$attributes['type']])
&& class_exists($class = static::$models[$attributes['type']]) && class_exists($class = static::$models[$attributes['type']])
) { ) {
/** @var Post $instance */
$instance = new $class; $instance = new $class;
$instance->exists = true; $instance->exists = true;
$instance->setRawAttributes($attributes, true); $instance->setRawAttributes($attributes, true);

View File

@@ -2,6 +2,9 @@
use Flarum\Core\Discussions\Discussion; use Flarum\Core\Discussions\Discussion;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
use Flarum\Events\ModelAllow;
use Flarum\Events\RegisterPostTypes;
use Flarum\Events\ScopePostVisibility;
use Flarum\Support\ServiceProvider; use Flarum\Support\ServiceProvider;
use Flarum\Extend; use Flarum\Extend;
@@ -14,45 +17,73 @@ class PostsServiceProvider extends ServiceProvider
*/ */
public function boot() public function boot()
{ {
$this->extend([
new Extend\PostType('Flarum\Core\Posts\CommentPost'),
new Extend\PostType('Flarum\Core\Posts\DiscussionRenamedPost')
]);
Post::setValidator($this->app->make('validator')); Post::setValidator($this->app->make('validator'));
CommentPost::setFormatter($this->app->make('flarum.formatter')); CommentPost::setFormatter($this->app->make('flarum.formatter'));
Post::allow('*', function ($post, $user, $action) { $this->registerPostTypes();
return $post->discussion->can($user, $action.'Posts') ?: null;
$events = $this->app->make('events');
$events->listen(ModelAllow::class, function (ModelAllow $event) {
if ($event->model instanceof Post) {
$post = $event->model;
$action = $event->action;
$actor = $event->actor;
if ($action === 'view' &&
(! $post->hide_user_id || $post->can($actor, 'edit'))) {
return true;
}
// A post is allowed to be edited if the user has permission to moderate
// the discussion which it's in, or if they are the author and the post
// hasn't been deleted by someone else.
if ($action === 'edit' &&
($post->discussion->can($actor, 'editPosts') ||
($post->user_id == $actor->id &&
(! $post->hide_user_id || $post->hide_user_id == $actor->id)))) {
return true;
}
if ($post->discussion->can($actor, $action.'Posts')) {
return true;
}
}
}); });
// When fetching a discussion's posts: if the user doesn't have permission // When fetching a discussion's posts: if the user doesn't have permission
// to moderate the discussion, then they can't see posts that have been // to moderate the discussion, then they can't see posts that have been
// hidden by someone other than themself. // hidden by someone other than themself.
Discussion::addPostVisibilityScope(function ($query, User $user, Discussion $discussion) { $events->listen(ScopePostVisibility::class, function (ScopePostVisibility $event) {
if (! $discussion->can($user, 'editPosts')) { $user = $event->actor;
$query->where(function ($query) use ($user) {
if (! $event->discussion->can($user, 'editPosts')) {
$event->query->where(function ($query) use ($user) {
$query->whereNull('hide_user_id') $query->whereNull('hide_user_id')
->orWhere('hide_user_id', $user->id); ->orWhere('hide_user_id', $user->id);
}); });
} }
}); });
Post::allow('view', function ($post, $user) {
return ! $post->hide_user_id || $post->can($user, 'edit') ?: null;
});
// A post is allowed to be edited if the user has permission to moderate
// the discussion which it's in, or if they are the author and the post
// hasn't been deleted by someone else.
Post::allow('edit', function ($post, $user) {
if ($post->discussion->can($user, 'editPosts') ||
($post->user_id == $user->id && (! $post->hide_user_id || $post->hide_user_id == $user->id))
) {
return true;
} }
});
/**
* Register post types.
*
* @return void
*/
public function registerPostTypes()
{
$models = [
'Flarum\Core\Posts\CommentPost',
'Flarum\Core\Posts\DiscussionRenamedPost'
];
event(new RegisterPostTypes($models));
foreach ($models as $model) {
Post::setModel($model::$type, $model);
}
} }
/** /**

View File

@@ -2,6 +2,8 @@
use Flarum\Core\Exceptions\PermissionDeniedException; use Flarum\Core\Exceptions\PermissionDeniedException;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
use Flarum\Events\ModelAllow;
use Illuminate\Contracts\Events\Dispatcher;
/** /**
* 'Lock' an object, allowing the permission of a user to perform an action to * 'Lock' an object, allowing the permission of a user to perform an action to
@@ -9,75 +11,5 @@ use Flarum\Core\Users\User;
*/ */
trait Locked trait Locked
{ {
/**
* @var callable[]
*/
protected static $conditions = [];
/**
* Get the condition callbacks for the specified action.
*
* @param string $action
* @return callable[]
*/
protected static function getConditions($action)
{
$conditions = array_get(static::$conditions, $action, []);
$all = array_get(static::$conditions, '*', []);
return array_merge($conditions, $all);
}
/**
* Allow the specified action if the given condition is satisfied.
*
* @param string $action
* @param callable $condition The condition callback. Parameters are the
* object that is locked, the user performing the action,
* and the name of the action. This condition will be ignored if it
* returns null; otherwise, the return value will determine whether or
* not the action is allowed.
*/
public static function allow($action, callable $condition)
{
foreach ((array)$action as $action) {
static::$conditions[$action][] = $condition;
}
}
/**
* Check whether or not a user has permission to perform an action,
* according to the collected conditions.
*
* @param User $actor
* @param string $action
* @return bool
*/
public function can(User $actor, $action)
{
foreach ($this->getConditions($action) as $condition) {
$can = $condition($this, $actor, $action);
if ($can !== null) {
return $can;
}
}
return false;
}
/**
* Assert that the user has a certain permission for this model, throwing
* an exception if they don't.
*
* @param User $actor
* @param string $action
* @throws PermissionDeniedException
*/
public function assertCan(User $actor, $action)
{
if (! $this->can($actor, $action)) {
throw new PermissionDeniedException;
}
}
} }

View File

@@ -1,6 +1,7 @@
<?php namespace Flarum\Core\Support; <?php namespace Flarum\Core\Support;
use Illuminate\Contracts\Validation\Factory; use Flarum\Events\ModelValidator;
use Illuminate\Validation\Factory;
use Illuminate\Contracts\Validation\ValidationException; use Illuminate\Contracts\Validation\ValidationException;
use Illuminate\Validation\Validator; use Illuminate\Validation\Validator;
@@ -79,13 +80,11 @@ trait ValidatesBeforeSave
*/ */
protected function makeValidator() protected function makeValidator()
{ {
$dirty = $this->getDirty(); $rules = $this->expandUniqueRules($this->rules);
$rules = $this->expandUniqueRules(array_only($this->rules, array_keys($dirty))); $validator = static::$validator->make($this->getAttributes(), $rules);
$validator = static::$validator->make($dirty, $rules); event(new ModelValidator($this, $validator));
// TODO: event
return $validator; return $validator;
} }

View File

@@ -1,40 +0,0 @@
<?php namespace Flarum\Core\Support;
use Flarum\Core\Users\User;
use Illuminate\Database\Eloquent\Builder;
/**
* Add a query scope to an Eloquent model that filters out records that a user
* is not allowed to view.
*/
trait VisibleScope
{
/**
* @var callable[]
*/
protected static $visibleScopes = [];
/**
* Add a callback to scope a query to only include records that are visible
* to a user.
*
* @param callable $scope
*/
public static function addVisibleScope(callable $scope)
{
static::$visibleScopes[] = $scope;
}
/**
* Scope a query to only include records that are visible to a user.
*
* @param Builder $query
* @param User $user
*/
public function scopeWhereVisibleTo(Builder $query, User $user)
{
foreach (static::$visibleScopes as $scope) {
$scope($query, $user);
}
}
}

View File

@@ -1,7 +1,7 @@
<?php namespace Flarum\Core\Users\Commands; <?php namespace Flarum\Core\Users\Commands;
use Flarum\Core\Users\UserRepository; use Flarum\Core\Users\UserRepository;
use Flarum\Core\Users\Events\UserWillBeSaved; use Flarum\Events\UserWillBeSaved;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;
use Flarum\Core\Exceptions\InvalidConfirmationTokenException; use Flarum\Core\Exceptions\InvalidConfirmationTokenException;
use Flarum\Core\Users\EmailToken; use Flarum\Core\Users\EmailToken;

View File

@@ -1,6 +1,6 @@
<?php namespace Flarum\Core\Users\Commands; <?php namespace Flarum\Core\Users\Commands;
use Flarum\Core\Users\Events\AvatarWillBeDeleted; use Flarum\Events\AvatarWillBeDeleted;
use Flarum\Core\Users\UserRepository; use Flarum\Core\Users\UserRepository;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;
use League\Flysystem\FilesystemInterface; use League\Flysystem\FilesystemInterface;

View File

@@ -2,7 +2,7 @@
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
use Flarum\Core\Users\UserRepository; use Flarum\Core\Users\UserRepository;
use Flarum\Core\Users\Events\UserWillBeDeleted; use Flarum\Events\UserWillBeDeleted;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;
class DeleteUserHandler class DeleteUserHandler

View File

@@ -2,7 +2,7 @@
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
use Flarum\Core\Users\UserRepository; use Flarum\Core\Users\UserRepository;
use Flarum\Core\Users\Events\UserWillBeSaved; use Flarum\Events\UserWillBeSaved;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;
class EditUserHandler class EditUserHandler

View File

@@ -1,7 +1,7 @@
<?php namespace Flarum\Core\Users\Commands; <?php namespace Flarum\Core\Users\Commands;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
use Flarum\Core\Users\Events\UserWillBeSaved; use Flarum\Events\UserWillBeSaved;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;
class RegisterUserHandler class RegisterUserHandler

View File

@@ -1,6 +1,6 @@
<?php namespace Flarum\Core\Users\Commands; <?php namespace Flarum\Core\Users\Commands;
use Flarum\Core\Users\Events\AvatarWillBeSaved; use Flarum\Events\AvatarWillBeSaved;
use Flarum\Core\Users\UserRepository; use Flarum\Core\Users\UserRepository;
use Flarum\Core\Support\DispatchesEvents; use Flarum\Core\Support\DispatchesEvents;
use Illuminate\Support\Str; use Illuminate\Support\Str;

View File

@@ -1,8 +1,8 @@
<?php namespace Flarum\Core\Users\Listeners; <?php namespace Flarum\Core\Users\Listeners;
use Flarum\Core\Settings\SettingsRepository; use Flarum\Core\Settings\SettingsRepository;
use Flarum\Core\Users\Events\UserWasRegistered; use Flarum\Events\UserWasRegistered;
use Flarum\Core\Users\Events\UserEmailChangeWasRequested; use Flarum\Events\UserEmailChangeWasRequested;
use Flarum\Core; use Flarum\Core;
use Flarum\Core\Users\EmailToken; use Flarum\Core\Users\EmailToken;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
@@ -42,7 +42,7 @@ class EmailConfirmationMailer
} }
/** /**
* @param UserWasRegistered $event * @param \Flarum\Events\UserWasRegistered $event
*/ */
public function whenUserWasRegistered(UserWasRegistered $event) public function whenUserWasRegistered(UserWasRegistered $event)
{ {
@@ -56,7 +56,7 @@ class EmailConfirmationMailer
} }
/** /**
* @param UserEmailChangeWasRequested $event * @param \Flarum\Events\UserEmailChangeWasRequested $event
*/ */
public function whenUserEmailChangeWasRequested(UserEmailChangeWasRequested $event) public function whenUserEmailChangeWasRequested(UserEmailChangeWasRequested $event)
{ {

View File

@@ -1,12 +1,12 @@
<?php namespace Flarum\Core\Users\Listeners; <?php namespace Flarum\Core\Users\Listeners;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;
use Flarum\Core\Posts\Events\PostWasPosted; use Flarum\Events\PostWasPosted;
use Flarum\Core\Posts\Events\PostWasDeleted; use Flarum\Events\PostWasDeleted;
use Flarum\Core\Posts\Events\PostWasHidden; use Flarum\Events\PostWasHidden;
use Flarum\Core\Posts\Events\PostWasRestored; use Flarum\Events\PostWasRestored;
use Flarum\Core\Discussions\Events\DiscussionWasStarted; use Flarum\Events\DiscussionWasStarted;
use Flarum\Core\Discussions\Events\DiscussionWasDeleted; use Flarum\Events\DiscussionWasDeleted;
use Illuminate\Contracts\Events\Dispatcher; use Illuminate\Contracts\Events\Dispatcher;
class UserMetadataUpdater class UserMetadataUpdater
@@ -49,7 +49,7 @@ class UserMetadataUpdater
} }
/** /**
* @param PostWasRestored $event * @param \Flarum\Events\PostWasRestored $event
*/ */
public function whenPostWasRestored(PostWasRestored $event) public function whenPostWasRestored(PostWasRestored $event)
{ {
@@ -57,7 +57,7 @@ class UserMetadataUpdater
} }
/** /**
* @param DiscussionWasStarted $event * @param \Flarum\Events\DiscussionWasStarted $event
*/ */
public function whenDiscussionWasStarted(DiscussionWasStarted $event) public function whenDiscussionWasStarted(DiscussionWasStarted $event)
{ {
@@ -65,7 +65,7 @@ class UserMetadataUpdater
} }
/** /**
* @param DiscussionWasDeleted $event * @param \Flarum\Events\DiscussionWasDeleted $event
*/ */
public function whenDiscussionWasDeleted(DiscussionWasDeleted $event) public function whenDiscussionWasDeleted(DiscussionWasDeleted $event)
{ {

View File

@@ -5,7 +5,7 @@ use Flarum\Core\Search\GambitManager;
use Flarum\Core\Search\SearchCriteria; use Flarum\Core\Search\SearchCriteria;
use Flarum\Core\Search\SearchResults; use Flarum\Core\Search\SearchResults;
use Flarum\Core\Users\UserRepository; use Flarum\Core\Users\UserRepository;
use Flarum\Core\Users\Events\UserSearchWillBePerformed; use Flarum\Events\UserSearchWillBePerformed;
/** /**
* Takes a UserSearchCriteria object, performs a search using gambits, * Takes a UserSearchCriteria object, performs a search using gambits,

View File

@@ -4,17 +4,18 @@ use Flarum\Core;
use Flarum\Core\Groups\Group; use Flarum\Core\Groups\Group;
use Flarum\Core\Model; use Flarum\Core\Model;
use Flarum\Core\Notifications\Notification; use Flarum\Core\Notifications\Notification;
use Flarum\Events\RegisterUserPreferences;
use Illuminate\Contracts\Hashing\Hasher; use Illuminate\Contracts\Hashing\Hasher;
use Flarum\Core\Formatter\FormatterManager; use Flarum\Core\Formatter\FormatterManager;
use Flarum\Core\Users\Events\UserWasDeleted; use Flarum\Events\UserWasDeleted;
use Flarum\Core\Users\Events\UserWasRegistered; use Flarum\Events\UserWasRegistered;
use Flarum\Core\Users\Events\UserWasRenamed; use Flarum\Events\UserWasRenamed;
use Flarum\Core\Users\Events\UserEmailWasChanged; use Flarum\Events\UserEmailWasChanged;
use Flarum\Core\Users\Events\UserPasswordWasChanged; use Flarum\Events\UserPasswordWasChanged;
use Flarum\Core\Users\Events\UserBioWasChanged; use Flarum\Events\UserBioWasChanged;
use Flarum\Core\Users\Events\UserAvatarWasChanged; use Flarum\Events\UserAvatarWasChanged;
use Flarum\Core\Users\Events\UserWasActivated; use Flarum\Events\UserWasActivated;
use Flarum\Core\Users\Events\UserEmailChangeWasRequested; use Flarum\Events\UserEmailChangeWasRequested;
use Flarum\Core\Support\Locked; use Flarum\Core\Support\Locked;
use Flarum\Core\Support\VisibleScope; use Flarum\Core\Support\VisibleScope;
use Flarum\Core\Support\EventGenerator; use Flarum\Core\Support\EventGenerator;
@@ -27,7 +28,6 @@ class User extends Model
{ {
use EventGenerator; use EventGenerator;
use Locked; use Locked;
use VisibleScope;
use ValidatesBeforeSave; use ValidatesBeforeSave;
/** /**
@@ -53,7 +53,7 @@ class User extends Model
/** /**
* {@inheritdoc} * {@inheritdoc}
*/ */
protected static $dateAttributes = [ protected $dates = [
'join_time', 'join_time',
'last_seen_time', 'last_seen_time',
'read_time', 'read_time',
@@ -97,6 +97,8 @@ class User extends Model
static::deleted(function ($user) { static::deleted(function ($user) {
$user->raise(new UserWasDeleted($user)); $user->raise(new UserWasDeleted($user));
}); });
event(new RegisterUserPreferences);
} }
/** /**

View File

@@ -1,6 +1,9 @@
<?php namespace Flarum\Core\Users; <?php namespace Flarum\Core\Users;
use Flarum\Core\Search\GambitManager; use Flarum\Core\Search\GambitManager;
use Flarum\Events\ModelAllow;
use Flarum\Events\RegisterUserGambits;
use Flarum\Events\RegisterUserPreferences;
use Flarum\Support\ServiceProvider; use Flarum\Support\ServiceProvider;
use Flarum\Extend; use Flarum\Extend;
use Illuminate\Contracts\Container\Container; use Illuminate\Contracts\Container\Container;
@@ -14,25 +17,32 @@ class UsersServiceProvider extends ServiceProvider
*/ */
public function boot() public function boot()
{ {
$this->extend([
new Extend\EventSubscriber('Flarum\Core\Users\Listeners\UserMetadataUpdater'),
new Extend\EventSubscriber('Flarum\Core\Users\Listeners\EmailConfirmationMailer')
]);
User::setHasher($this->app->make('hash')); User::setHasher($this->app->make('hash'));
User::setFormatter($this->app->make('flarum.formatter')); User::setFormatter($this->app->make('flarum.formatter'));
User::setValidator($this->app->make('validator')); User::setValidator($this->app->make('validator'));
User::addPreference('discloseOnline', 'boolval', true); $events = $this->app->make('events');
User::addPreference('indexProfile', 'boolval', true);
User::allow('*', function (User $user, User $actor, $action) { $events->listen(RegisterUserPreferences::class, function (RegisterUserPreferences $event) {
return $actor->hasPermission('user.'.$action) ?: null; $event->register('discloseOnline', 'boolval', true);
$event->register('indexProfile', 'boolval', true);
}); });
User::allow(['edit', 'delete'], function (User $user, User $actor) { $events->listen(ModelAllow::class, function (ModelAllow $event) {
return $user->id == $actor->id ?: null; if ($event->model instanceof User) {
if (in_array($event->action, ['edit', 'delete']) &&
$event->model->id == $event->actor->id) {
return true;
}
if ($event->actor->hasPermission('user.'.$event->action)) {
return true;
}
}
}); });
$events->subscribe('Flarum\Core\Users\Listeners\UserMetadataUpdater');
$events->subscribe('Flarum\Core\Users\Listeners\EmailConfirmationMailer');
} }
/** /**
@@ -63,19 +73,14 @@ class UsersServiceProvider extends ServiceProvider
public function registerGambits() public function registerGambits()
{ {
$this->app->instance('flarum.userGambits', []);
$this->app->when('Flarum\Core\Users\Search\UserSearcher') $this->app->when('Flarum\Core\Users\Search\UserSearcher')
->needs('Flarum\Core\Search\GambitManager') ->needs('Flarum\Core\Search\GambitManager')
->give(function (Container $app) { ->give(function (Container $app) {
$gambits = new GambitManager($app); $gambits = new GambitManager($app);
foreach ($app->make('flarum.userGambits') as $gambit) {
$gambits->add($gambit);
}
$gambits->setFulltextGambit('Flarum\Core\Users\Search\Gambits\FulltextGambit'); $gambits->setFulltextGambit('Flarum\Core\Users\Search\Gambits\FulltextGambit');
event(new RegisterUserGambits($gambits));
return $gambits; return $gambits;
}); });
} }

View File

@@ -1,8 +1,8 @@
<?php namespace Flarum\Api\Events; <?php namespace Flarum\Events;
use Flarum\Api\Serializers\Serializer; use Flarum\Api\Serializers\Serializer;
class SerializeAttributes class ApiAttributes
{ {
/** /**
* The class doing the serializing. * The class doing the serializing.
@@ -25,6 +25,11 @@ class SerializeAttributes
*/ */
public $attributes; public $attributes;
/**
* @var \Flarum\Core\Users\User
*/
public $actor;
/** /**
* @param Serializer $serializer The class doing the serializing. * @param Serializer $serializer The class doing the serializing.
* @param object $model The model being serialized. * @param object $model The model being serialized.
@@ -35,5 +40,6 @@ class SerializeAttributes
$this->serializer = $serializer; $this->serializer = $serializer;
$this->model = $model; $this->model = $model;
$this->attributes = &$attributes; $this->attributes = &$attributes;
$this->actor = $serializer->actor;
} }
} }

View File

@@ -0,0 +1,26 @@
<?php namespace Flarum\Events;
use Flarum\Api\Serializers\Serializer;
class ApiRelationship
{
/**
* @var Serializer
*/
public $serializer;
/**
* @var string
*/
public $relationship;
/**
* @param Serializer $serializer
* @param string $relationship
*/
public function __construct(Serializer $serializer, $relationship)
{
$this->serializer = $serializer;
$this->relationship = $relationship;
}
}

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Users\Events; <?php namespace Flarum\Events;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Users\Events; <?php namespace Flarum\Events;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;

View File

@@ -0,0 +1,70 @@
<?php namespace Flarum\Events;
use Flarum\Api\Actions\SerializeAction;
class BuildApiAction
{
protected $action;
/**
* @param SerializeAction $action
*/
public function __construct($action)
{
$this->action = $action;
}
public function serializer($serializer)
{
$this->action->serializer = $serializer;
}
public function addInclude($relation, $default = true)
{
$this->action->include[$relation] = $default;
}
public function removeInclude($relation)
{
unset($this->action->include[$relation]);
}
public function addLink($relation)
{
$this->action->link[] = $relation;
}
public function removeLink($relation)
{
if (($k = array_search($relation, $this->action->link)) !== false) {
unset($this->action->link[$k]);
}
}
public function limitMax($limitMax)
{
$this->action->limitMax = $limitMax;
}
public function limit($limit)
{
$this->action->limit = $limit;
}
public function addSortField($field)
{
$this->action->sortFields[] = $field;
}
public function removeSortField($field)
{
if (($k = array_search($field, $this->action->sortFields)) !== false) {
unset($this->action->sortFields[$k]);
}
}
public function sort($sort)
{
$this->action->sort = $sort;
}
}

View File

@@ -0,0 +1,34 @@
<?php namespace Flarum\Events;
use Flarum\Support\ClientAction;
use Flarum\Support\ClientView;
class BuildClientView
{
/**
* @var ClientAction
*/
protected $action;
/**
* @var ClientView
*/
protected $view;
/**
* @var array
*/
protected $keys;
/**
* @param ClientAction $action
* @param ClientView $view
* @param array $keys
*/
public function __construct($action, $view, &$keys)
{
$this->action = $action;
$this->view = $view;
$this->keys = &$keys;
}
}

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Discussions\Events; <?php namespace Flarum\Events;
use Flarum\Core\Discussions\Search\DiscussionSearch; use Flarum\Core\Discussions\Search\DiscussionSearch;
use Flarum\Core\Search\SearchCriteria; use Flarum\Core\Search\SearchCriteria;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Discussions\Events; <?php namespace Flarum\Events;
use Flarum\Core\Discussions\DiscussionState; use Flarum\Core\Discussions\DiscussionState;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Discussions\Events; <?php namespace Flarum\Events;
use Flarum\Core\Discussions\Discussion; use Flarum\Core\Discussions\Discussion;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Discussions\Events; <?php namespace Flarum\Events;
use Flarum\Core\Discussions\DiscussionState; use Flarum\Core\Discussions\DiscussionState;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Discussions\Events; <?php namespace Flarum\Events;
use Flarum\Core\Discussions\Discussion; use Flarum\Core\Discussions\Discussion;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Discussions\Events; <?php namespace Flarum\Events;
use Flarum\Core\Discussions\Discussion; use Flarum\Core\Discussions\Discussion;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Discussions\Events; <?php namespace Flarum\Events;
use Flarum\Core\Discussions\Discussion; use Flarum\Core\Discussions\Discussion;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Discussions\Events; <?php namespace Flarum\Events;
use Flarum\Core\Discussions\Discussion; use Flarum\Core\Discussions\Discussion;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;

View File

@@ -0,0 +1,37 @@
<?php namespace Flarum\Events;
use Flarum\Core\Model;
use Flarum\Core\Users\User;
/**
* The `ModelAllow` event
*/
class ModelAllow
{
/**
* @var Model
*/
public $model;
/**
* @var array
*/
public $actor;
/**
* @var string
*/
public $action;
/**
* @param Model $model
* @param User $actor
* @param $action
*/
public function __construct(Model $model, User $actor, $action)
{
$this->model = $model;
$this->actor = $actor;
$this->action = $action;
}
}

View File

@@ -0,0 +1,30 @@
<?php namespace Flarum\Events;
use Flarum\Core\Model;
/**
* The `ModelDates` event is called to retrieve a list of fields for a model
* that should be converted into date objects.
*/
class ModelDates
{
/**
* @var Model
*/
public $model;
/**
* @var array
*/
public $dates;
/**
* @param Model $model
* @param array $dates
*/
public function __construct(Model $model, array &$dates)
{
$this->model = $model;
$this->dates = &$dates;
}
}

View File

@@ -0,0 +1,30 @@
<?php namespace Flarum\Events;
use Flarum\Core\Model;
/**
* The `ModelRelationship` event is called to retrieve Relation object for a
* model. Listeners should return an Eloquent Relation object.
*/
class ModelRelationship
{
/**
* @var Model
*/
public $model;
/**
* @var string
*/
public $relationship;
/**
* @param Model $model
* @param string $relationship
*/
public function __construct(Model $model, $relationship)
{
$this->model = $model;
$this->relationship = $relationship;
}
}

View File

@@ -0,0 +1,32 @@
<?php namespace Flarum\Events;
use Flarum\Core\Model;
use Illuminate\Validation\Validator;
/**
* The `ModelValidator` event is called when a validator instance for a
* model is being built. This event can be used to add custom rules/extensions
* to the validator for when validation takes place.
*/
class ModelValidator
{
/**
* @var Model
*/
public $model;
/**
* @var Validator
*/
public $validator;
/**
* @param Model $model
* @param Validator $validator
*/
public function __construct(Model $model, Validator $validator)
{
$this->model = $model;
$this->validator = $validator;
}
}

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Notifications\Events; <?php namespace Flarum\Events;
use Flarum\Core\Notifications\Blueprint; use Flarum\Core\Notifications\Blueprint;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Posts\Events; <?php namespace Flarum\Events;
use Flarum\Core\Posts\Post; use Flarum\Core\Posts\Post;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Posts\Events; <?php namespace Flarum\Events;
use Flarum\Core\Posts\CommentPost; use Flarum\Core\Posts\CommentPost;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Posts\Events; <?php namespace Flarum\Events;
use Flarum\Core\Posts\Post; use Flarum\Core\Posts\Post;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Posts\Events; <?php namespace Flarum\Events;
use Flarum\Core\Posts\CommentPost; use Flarum\Core\Posts\CommentPost;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Posts\Events; <?php namespace Flarum\Events;
use Flarum\Core\Posts\CommentPost; use Flarum\Core\Posts\CommentPost;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Posts\Events; <?php namespace Flarum\Events;
use Flarum\Core\Posts\Post; use Flarum\Core\Posts\Post;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;

View File

@@ -1,4 +1,4 @@
<?php namespace Flarum\Core\Posts\Events; <?php namespace Flarum\Events;
use Flarum\Core\Posts\Post; use Flarum\Core\Posts\Post;
use Flarum\Core\Users\User; use Flarum\Core\Users\User;

View File

@@ -0,0 +1,35 @@
<?php namespace Flarum\Events;
use InvalidArgumentException;
use ReflectionClass;
class RegisterActivityTypes
{
/**
* @var array
*/
protected $blueprints;
/**
* @var array
*/
protected $serializers;
public function __construct(array &$blueprints, array &$serializers = [])
{
$this->blueprints = &$blueprints;
$this->serializers = &$serializers;
}
public function register($blueprint, $serializer)
{
if (! (new ReflectionClass($blueprint))->implementsInterface('Flarum\Core\Activity\Blueprint')) {
throw new InvalidArgumentException('Activity blueprint ' . $blueprint
. ' must implement Flarum\Core\Activity\Blueprint');
}
$this->blueprints[] = $blueprint;
$this->serializers[$blueprint::getType()] = $serializer;
}
}

View File

@@ -0,0 +1,19 @@
<?php namespace Flarum\Events;
use Flarum\Http\RouteCollection;
class RegisterApiRoutes
{
/**
* @var RouteCollection
*/
public $routes;
/**
* @param RouteCollection $routes
*/
public function __construct(RouteCollection $routes)
{
$this->routes = $routes;
}
}

View File

@@ -0,0 +1,19 @@
<?php namespace Flarum\Events;
use Flarum\Core\Search\GambitManager;
class RegisterDiscussionGambits
{
/**
* @var GambitManager
*/
public $gambits;
/**
* @param GambitManager $gambits
*/
public function __construct(GambitManager $gambits)
{
$this->gambits = $gambits;
}
}

View File

@@ -0,0 +1,19 @@
<?php namespace Flarum\Events;
use Flarum\Http\RouteCollection;
class RegisterForumRoutes
{
/**
* @var RouteCollection
*/
public $routes;
/**
* @param RouteCollection $routes
*/
public function __construct(RouteCollection $routes)
{
$this->routes = $routes;
}
}

View File

@@ -0,0 +1,19 @@
<?php namespace Flarum\Events;
use Flarum\Locale\LocaleManager;
class RegisterLocales
{
/**
* @var LocaleManager
*/
public $manager;
/**
* @param LocaleManager $manager
*/
public function __construct(LocaleManager $manager)
{
$this->manager = $manager;
}
}

View File

@@ -0,0 +1,35 @@
<?php namespace Flarum\Events;
use InvalidArgumentException;
use ReflectionClass;
class RegisterNotificationTypes
{
/**
* @var array
*/
protected $blueprints;
/**
* @var array
*/
protected $serializers;
public function __construct(array &$blueprints, array &$serializers = [])
{
$this->blueprints = &$blueprints;
$this->serializers = &$serializers;
}
public function register($blueprint, $serializer, $enabledByDefault = [])
{
if (! (new ReflectionClass($blueprint))->implementsInterface('Flarum\Core\Notifications\Blueprint')) {
throw new InvalidArgumentException('Notification blueprint ' . $blueprint
. ' must implement Flarum\Core\Notifications\Blueprint');
}
$this->blueprints[$blueprint] = $enabledByDefault;
$this->serializers[$blueprint::getType()] = $serializer;
}
}

View File

@@ -0,0 +1,16 @@
<?php namespace Flarum\Events;
class RegisterPostTypes
{
protected $models;
public function __construct(array &$models)
{
$this->models = &$models;
}
public function register($class)
{
$this->models[] = $class;
}
}

View File

@@ -0,0 +1,27 @@
<?php namespace Flarum\Events;
use Flarum\Core\Search\GambitManager;
class RegisterUserGambits
{
/**
* @var GambitManager
*/
protected $gambits;
/**
* @param GambitManager $gambits
*/
public function __construct(GambitManager $gambits)
{
$this->gambits = $gambits;
}
/**
* @param string $gambit
*/
public function register($gambit)
{
$this->gambits->add($gambit);
}
}

View File

@@ -0,0 +1,11 @@
<?php namespace Flarum\Events;
use Flarum\Core\Users\User;
class RegisterUserPreferences
{
public function register($key, callable $transformer = null, $default = null)
{
User::addPreference($key, $transformer, $default);
}
}

View File

@@ -0,0 +1,39 @@
<?php namespace Flarum\Events;
use Flarum\Core\Model;
use Flarum\Core\Users\User;
use Illuminate\Database\Eloquent\Builder;
/**
* The `ScopeModelVisibility` event allows constraints to be applied in a query
* to fetch a model, effectively scoping that model's visibility to the user.
*/
class ScopeModelVisibility
{
/**
* @var Model
*/
public $model;
/**
* @var Builder
*/
public $query;
/**
* @var User
*/
public $actor;
/**
* @param Model $model
* @param Builder $query
* @param User $actor
*/
public function __construct(Model $model, Builder $query, User $actor)
{
$this->model = $model;
$this->query = $query;
$this->actor = $actor;
}
}

View File

@@ -0,0 +1,38 @@
<?php namespace Flarum\Events;
use Flarum\Core\Discussions\Discussion;
use Flarum\Core\Users\User;
use Illuminate\Database\Eloquent\Builder;
/**
* The `ScopePostVisibility` event
*/
class ScopePostVisibility
{
/**
* @var Discussion
*/
public $discussion;
/**
* @var Builder
*/
public $query;
/**
* @var User
*/
public $actor;
/**
* @param Discussion $discussion
* @param Builder $query
* @param User $actor
*/
public function __construct(Discussion $discussion, Builder $query, User $actor)
{
$this->discussion = $discussion;
$this->query = $query;
$this->actor = $actor;
}
}

Some files were not shown because too many files have changed in this diff Show More