first commit
This commit is contained in:
CHIEFSOFT\ameye
@@ -0,0 +1,250 @@
|
||||
<?php
|
||||
/**
|
||||
* @file classes/emailTemplate/Collector.php
|
||||
*
|
||||
* Copyright (c) 2014-2021 Simon Fraser University
|
||||
* Copyright (c) 2000-2021 John Willinsky
|
||||
* Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
|
||||
*
|
||||
* @class Collector
|
||||
*
|
||||
* @brief A helper class to configure a Query Builder to get a collection of email templates
|
||||
*/
|
||||
|
||||
namespace PKP\emailTemplate;
|
||||
|
||||
use Illuminate\Database\Query\Builder;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\LazyCollection;
|
||||
use PKP\core\interfaces\CollectorInterface;
|
||||
use PKP\plugins\Hook;
|
||||
|
||||
/**
|
||||
* @template T of EmailTemplate
|
||||
*/
|
||||
class Collector implements CollectorInterface
|
||||
{
|
||||
public DAO $dao;
|
||||
|
||||
/**
|
||||
* Retrieve all matches from query builder limited by those
|
||||
* which are custom templates or have been modified from the
|
||||
* default.
|
||||
*/
|
||||
public ?bool $isModified = null;
|
||||
public int $contextId;
|
||||
public ?array $keys = null;
|
||||
public ?string $searchPhrase = null;
|
||||
public ?int $count = null;
|
||||
public ?int $offset = null;
|
||||
public ?array $alternateTo = null;
|
||||
|
||||
public const EMAIL_TEMPLATE_STAGE_DEFAULT = 0;
|
||||
|
||||
public function __construct(DAO $dao, int $contextId)
|
||||
{
|
||||
$this->dao = $dao;
|
||||
$this->contextId = $contextId;
|
||||
}
|
||||
|
||||
/**
|
||||
* @copydoc DAO::getMany()
|
||||
* @return LazyCollection<int,T>
|
||||
*/
|
||||
public function getMany(): LazyCollection
|
||||
{
|
||||
return $this->dao->getMany($this);
|
||||
}
|
||||
|
||||
public function getCount(): int
|
||||
{
|
||||
return $this->dao->getCount($this);
|
||||
}
|
||||
|
||||
public function isModified(?bool $isModified): self
|
||||
{
|
||||
$this->isModified = $isModified;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set email keys filter
|
||||
*/
|
||||
public function filterByKeys(?array $keys): self
|
||||
{
|
||||
$this->keys = $keys;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set query search phrase
|
||||
*/
|
||||
public function searchPhrase(?string $phrase): self
|
||||
{
|
||||
$this->searchPhrase = $phrase;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Limit the number of objects retrieved
|
||||
*/
|
||||
public function limit(?int $count): self
|
||||
{
|
||||
$this->count = $count;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Offset the number of objects retrieved, for example to
|
||||
* retrieve the second page of contents
|
||||
*/
|
||||
public function offset(?int $offset): self
|
||||
{
|
||||
$this->offset = $offset;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Filter results by custom templates that are alternates of another other email
|
||||
*
|
||||
* @param string[] $emailTemplateKeys One or more default email template keys
|
||||
*/
|
||||
public function alternateTo(?array $emailTemplateKeys): self
|
||||
{
|
||||
$this->alternateTo = $emailTemplateKeys;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* This method performs a UNION on the default and custom template
|
||||
* tables, and returns the final SQL string and merged bindings.
|
||||
*
|
||||
* Use a UNION to ensure the query will match rows in email_templates and
|
||||
* email_templates_default. This ensures that custom templates which have
|
||||
* no default in email_templates_default are still returned. These templates
|
||||
* should not be returned when a role filter is used.
|
||||
*/
|
||||
public function getQueryBuilder(): Builder
|
||||
{
|
||||
$q = $this->isModified === true || !is_null($this->alternateTo)
|
||||
? $this->getCustomQueryBuilder()
|
||||
: $this->getDefaultQueryBuilder()->union($this->getCustomQueryBuilder());
|
||||
|
||||
$q
|
||||
->when(!is_null($this->count), function (Builder $q) {
|
||||
return $q->limit($this->count);
|
||||
})
|
||||
|
||||
->when(!is_null($this->count) && !is_null($this->offset), function (Builder $q) {
|
||||
return $q->offset($this->offset);
|
||||
});
|
||||
|
||||
$q->orderBy('email_key');
|
||||
|
||||
return $q;
|
||||
}
|
||||
|
||||
/**
|
||||
* If you try to execute the query returned by this method, it will
|
||||
* cause an error in PostgreSQL.
|
||||
*
|
||||
* Call `->distinct()` on the query builder returned by this method
|
||||
* before executing it, or use `->union()` to join it with
|
||||
* `self::getCustomQueryBuilder()` (see self::getQueryBuilder()).
|
||||
*
|
||||
* @see self::getCompiledQuery()
|
||||
*
|
||||
*/
|
||||
protected function getDefaultQueryBuilder(): Builder
|
||||
{
|
||||
$q = DB::table('email_templates_default_data as etddata')
|
||||
->select('email_key')
|
||||
->selectRaw('NULL as email_id')
|
||||
->selectRaw($this->contextId . ' as context_id')
|
||||
->selectRaw('NULL as alternate_to')
|
||||
|
||||
->whereNotIn('etddata.email_key', function (Builder $q) {
|
||||
$q->select('et.email_key')
|
||||
->from('email_templates as et')
|
||||
->where('et.context_id', $this->contextId);
|
||||
})
|
||||
|
||||
->when(!is_null($this->keys), function (Builder $q) {
|
||||
return $q->whereIn('email_key', $this->keys);
|
||||
})
|
||||
|
||||
// search phrase
|
||||
->when(!is_null($this->searchPhrase), function (Builder $q) {
|
||||
$words = explode(' ', $this->searchPhrase);
|
||||
$likePattern = DB::raw("CONCAT('%', LOWER(?), '%')");
|
||||
foreach ($words as $word) {
|
||||
$q->where(function (Builder $q) use ($word, $likePattern) {
|
||||
$q->where(DB::raw('LOWER(etddata.subject)'), 'LIKE', $likePattern)->addBinding($word)
|
||||
->orWhere(DB::raw('LOWER(etddata.body)'), 'LIKE', $likePattern)->addBinding($word)
|
||||
->orWhere(DB::raw('LOWER(etddata.email_key)'), 'LIKE', $likePattern)->addBinding($word);
|
||||
});
|
||||
}
|
||||
});
|
||||
|
||||
// Add app-specific query statements
|
||||
Hook::call('EmailTemplate::Collector::default', [$q, $this]);
|
||||
|
||||
return $q;
|
||||
}
|
||||
|
||||
/**
|
||||
* Execute query builder for custom email templates
|
||||
* and email templates that have been modified from
|
||||
* the default.
|
||||
*
|
||||
* @see self::getCompiledQuery()
|
||||
*
|
||||
*/
|
||||
protected function getCustomQueryBuilder(): Builder
|
||||
{
|
||||
$q = DB::table($this->dao->table . ' as et')
|
||||
->select([
|
||||
'et.email_key',
|
||||
'et.email_id',
|
||||
'et.context_id',
|
||||
'et.alternate_to',
|
||||
])
|
||||
|
||||
->where('et.context_id', $this->contextId)
|
||||
|
||||
->when(!is_null($this->keys), function (Builder $q) {
|
||||
return $q->whereIn('et.email_key', $this->keys);
|
||||
})
|
||||
|
||||
->when(!is_null($this->alternateTo), function (Builder $q) {
|
||||
return $q->whereIn('et.alternate_to', $this->alternateTo);
|
||||
})
|
||||
|
||||
->when(!is_null($this->searchPhrase), function (Builder $q) {
|
||||
$words = explode(' ', $this->searchPhrase);
|
||||
$likePattern = DB::raw("CONCAT('%', LOWER(?), '%')");
|
||||
foreach ($words as $word) {
|
||||
$q->where(function (Builder $q) use ($word, $likePattern) {
|
||||
$q->whereIn('et.email_id', function ($q) use ($word, $likePattern) {
|
||||
return $q->select('ets.email_id')
|
||||
->from('email_templates_settings as ets')
|
||||
->where(function ($q) use ($word, $likePattern) {
|
||||
$q->where('ets.setting_name', 'subject');
|
||||
$q->where(DB::raw('LOWER(ets.setting_value)'), 'LIKE', $likePattern)->addBinding($word);
|
||||
})
|
||||
->orWhere(function ($q) use ($word, $likePattern) {
|
||||
$q->where('ets.setting_name', 'body');
|
||||
$q->where(DB::raw('LOWER(ets.setting_value)'), 'LIKE', $likePattern)->addBinding($word);
|
||||
});
|
||||
})
|
||||
->orWhere(DB::raw('LOWER(et.email_key)'), 'LIKE', $likePattern)->addBinding($word);
|
||||
});
|
||||
}
|
||||
});
|
||||
|
||||
// Add app-specific query statements
|
||||
Hook::call('EmailTemplate::Collector::custom', [$q, $this]);
|
||||
|
||||
return $q;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user