# acymailing/11.0.4/back/Classes/UrlClickClass.php

AcyMailing – An Ultimate Newsletter Plugin and Marketing Automation Solution for WordPress, version 11.0.4. 293 lines.

- Page: https://pluginprobe.com/plugins/acymailing/11.0.4/code/back/Classes/UrlClickClass.php
- Raw: https://pluginprobe.com/plugins/acymailing/11.0.4/raw/back/Classes/UrlClickClass.php
- Modified: 2025-11-17T10:05:56+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/acymailing/11.0.4/code/back/Classes/UrlClickClass.php#L10-L20`.

```php
<?php

namespace AcyMailing\Classes;

use AcyMailing\Core\AcymClass;
use AcyMailing\Helpers\ScenarioHelper;


class UrlClickClass extends AcymClass
{
    public function __construct()
    {
        parent::__construct();

        $this->table = 'url_click';
    }

    public function save(object $element): ?int
    {
        $urlClick = get_object_vars($element);

        $column = [];
        $valueColumn = [];
        $columnName = acym_getColumns($this->table);

        foreach ($urlClick as $key => $value) {
            if (in_array($key, $columnName)) {
                $column[] = '`'.acym_secureDBColumn($key).'`';
                $valueColumn[] = acym_escapeDB($value);
            }
        }

        $query = '#__acym_url_click ('.implode(',', $column).') VALUES ('.implode(',', $valueColumn).')';

        $onDuplicate = [];

        if (!empty($urlClick['click'])) {
            $onDuplicate[] = 'click = click + 1';
            $automationClass = new AutomationClass();
            $automationClass->trigger('user_click', ['userId' => $urlClick['user_id'], 'mailId' => $urlClick['mail_id']]);

            $scenarioHelper = new ScenarioHelper();
            $scenarioHelper->trigger('user_click', ['userId' => $urlClick['user_id'], 'mailId' => $urlClick['mail_id']]);
        }

        if (!empty($onDuplicate)) {
            $query .= ' ON DUPLICATE KEY UPDATE ';
            $query .= implode(',', $onDuplicate);
            $query = 'INSERT INTO '.$query;
        } else {
            $query = 'INSERT IGNORE INTO '.$query;
        }

        return (int)acym_query($query);
    }

    public function getNumberUsersClicked(array $mailIds = [], bool $isAbTest = false): int
    {
        acym_arrayToInteger($mailIds);

        $query = 'SELECT COUNT(DISTINCT user_id) FROM #__acym_url_click AS url_click';
        $isMultilingual = acym_isMultilingual();

        if (!empty($mailIds) && ($isMultilingual || $isAbTest)) {
            $query .= ' LEFT JOIN #__acym_mail AS mail ON `mail`.`id` = `url_click`.`mail_id` WHERE `mail`.`id` IN ('.implode(
                    ',',
                    $mailIds
                ).') OR  `mail`.`parent_id` IN ('.implode(',', $mailIds).')';
        }

        if (!$isMultilingual && !$isAbTest && !empty($mailIds)) {
            $query .= ' WHERE `url_click`.`mail_id` IN ('.implode(',', $mailIds).')';
        }

        $clickNb = acym_loadResult($query);

        return empty($clickNb) ? 0 : (int)$clickNb;
    }

    public function getAllClickByMailMonth(array $mailIds = [], string $start = '', string $end = ''): array
    {
        acym_arrayToInteger($mailIds);

        $query = 'SELECT COUNT(*) as click, DATE_FORMAT(date_click, \'%Y-%m\') as date_click FROM #__acym_url_click WHERE click > 0';
        $query .= empty($mailIds) ? '' : ' AND `mail_id` IN ('.implode(',', $mailIds).')';
        $query .= empty($start) ? '' : ' AND date_click >= '.acym_escapeDB($start);
        $query .= empty($end) ? '' : ' AND date_click <= '.acym_escapeDB($end);
        $query .= ' GROUP BY MONTH(date_click), YEAR(date_click) ORDER BY date_click';

        return acym_loadObjectList($query);
    }

    public function getAllClickByMailDay(array $mailIds = [], string $start = '', string $end = ''): array
    {
        acym_arrayToInteger($mailIds);

        $query = 'SELECT COUNT(*) as click, DATE_FORMAT(date_click, \'%Y-%m-%d\') as date_click FROM #__acym_url_click WHERE click > 0';
        $query .= empty($mailIds) ? '' : ' AND `mail_id` IN ('.implode(',', $mailIds).')';
        $query .= empty($start) ? '' : ' AND date_click >= '.acym_escapeDB($start);
        $query .= empty($end) ? '' : ' AND date_click <= '.acym_escapeDB($end);
        $query .= ' GROUP BY DAYOFYEAR(date_click), YEAR(date_click) ORDER BY date_click';

        return acym_loadObjectList($query);
    }

    public function getAllClickByMailHour(array $mailIds = [], string $start = '', string $end = ''): array
    {
        acym_arrayToInteger($mailIds);

        $query = 'SELECT COUNT(*) as click, DATE_FORMAT(date_click, \'%Y-%m-%d %H:00:00\') as date_click FROM #__acym_url_click WHERE click > 0';
        $query .= empty($mailIds) ? '' : ' AND `mail_id` IN ('.implode(',', $mailIds).')';
        $query .= empty($start) ? '' : ' AND date_click >= '.acym_escapeDB($start);
        $query .= empty($end) ? '' : ' AND date_click <= '.acym_escapeDB($end);
        $query .= ' GROUP BY HOUR(date_click), DAYOFYEAR(date_click), YEAR(date_click) ORDER BY date_click';

        return acym_loadObjectList($query);
    }

    public function getAllLinkFromEmail(int $id): array
    {
        $queryClickUrl = 'SELECT url.name, SUM(urlclick.click) as click FROM #__acym_url_click AS urlclick 
                          LEFT JOIN #__acym_url AS url ON urlclick.url_id = url.id 
                          WHERE `mail_id` = '.intval($id).' GROUP BY `url_id`';

        $queryCountAllClicks = 'SELECT SUM(click) FROM #__acym_url_click WHERE `mail_id` = '.intval($id);

        return [
            'urls_click' => acym_loadObjectList($queryClickUrl),
            'allClick' => acym_loadResult($queryCountAllClicks),
        ];
    }

    public function getClickRateByMailIds(array $mailsIds = []): int
    {
        $conditionMailId = '';
        if (!empty($mailsIds)) {
            acym_arrayToInteger($mailsIds);
            $conditionMailId = 'WHERE mail_id IN ('.implode(',', $mailsIds).')';
        }
        $query = 'SELECT COUNT(groupStat.user_id) AS nbClick FROM (SELECT user_id FROM #__acym_url_click '.$conditionMailId.' GROUP BY mail_id, user_id) AS groupStat';

        $nbClicks = acym_loadResult($query);

        return empty($nbClicks) ? 0 : (int)$nbClicks;
    }

    public function getUrlsFromMailsWithDetails(array $params): array
    {
        if (empty($params['mail_ids'])) {
            return [];
        }

        if (!is_array($params['mail_ids'])) $params['mail_ids'] = [$params['mail_ids']];
        acym_arrayToInteger($params['mail_ids']);

        $query = 'SELECT url.id, url.name, SUM(click) AS total_click, COUNT(DISTINCT user_id) AS unique_click, mail.subject AS mail_subject, mail.name AS mail_name
                  FROM #__acym_url AS url
                  JOIN #__acym_url_click AS url_click ON url.id = url_click.url_id AND url_click.mail_id IN ('.implode(',', $params['mail_ids']).')
                  JOIN #__acym_mail AS mail ON mail.id = url_click.mail_id';

        $queryCount = 'SELECT COUNT(DISTINCT url.id) AS total FROM #__acym_url AS url
                  JOIN #__acym_url_click AS url_click ON url.id = url_click.url_id AND url_click.mail_id IN ('.implode(',', $params['mail_ids']).')
                  JOIN #__acym_mail AS mail ON mail.id = url_click.mail_id';

        if (!empty($params['search'])) {
            $searchTerms = acym_escapeDB('%'.$params['search'].'%');
            $where[] = 'url.name LIKE '.$searchTerms;
        }

        if (!empty($where)) {
            $query .= ' WHERE ('.implode(') AND (', $where).')';
            $queryCount .= ' WHERE ('.implode(') AND (', $where).')';
        }

        $query .= ' GROUP BY name';

        if (!empty($params['ordering']) && !empty($params['ordering_sort_order'])) {
            $query .= ' ORDER BY '.acym_secureDBColumn($params['ordering']).' '.acym_secureDBColumn(strtoupper($params['ordering_sort_order']));
        } else {
            $query .= ' ORDER BY id DESC';
        }

        return [
            'links_details' => acym_loadObjectList($query, '', $params['offset'], $params['detailedStatsPerPage']),
            'total' => acym_loadObject($queryCount),
            'query' => $query,
        ];
    }

    public function getUserUrlClicksStats(array $params): array
    {
        if (empty($params['mail_ids'])) {
            return [];
        }

        if (!is_array($params['mail_ids'])) $params['mail_ids'] = [$params['mail_ids']];
        acym_arrayToInteger($params['mail_ids']);

        $query = 'SELECT url.id AS url_id,
                        user.id AS user_id,
                        user.email,
                        user.name AS user_name,
                        url.name AS url_name,
                        url_click.date_click,
                        url_click.click,
                        mail.subject AS mail_subject,
                        mail.name AS mail_name
                  FROM #__acym_user AS user 
                  JOIN #__acym_url_click AS url_click ON url_click.user_id = user.id AND url_click.mail_id IN ('.implode(',', $params['mail_ids']).')
                  JOIN #__acym_url AS url ON url.id = url_click.url_id
                  JOIN #__acym_mail AS mail ON mail.id = url_click.mail_id';

        $queryCount = 'SELECT COUNT(DISTINCT user.id) AS total FROM #__acym_user AS user 
                  JOIN #__acym_url_click AS url_click ON url_click.user_id = user.id AND url_click.mail_id IN ('.implode(',', $params['mail_ids']).')
                  JOIN #__acym_url AS url ON url.id = url_click.url_id
                  JOIN #__acym_mail AS mail ON mail.id = url_click.mail_id';

        if (!empty($params['search'])) {
            $searchTerms = acym_escapeDB('%'.$params['search'].'%');
            $where[] = 'url.name LIKE '.$searchTerms.' or user.name LIKE '.$searchTerms.' or user.email LIKE '.$searchTerms;
        }

        if (!empty($where)) {
            $query .= ' WHERE('.implode(') and (', $where).')';
            $queryCount .= ' WHERE('.implode(') and (', $where).')';
        }

        if (!empty($params['ordering']) && !empty($params['ordering_sort_order'])) {
            $query .= ' ORDER BY '.acym_secureDBColumn($params['ordering']).' '.acym_secureDBColumn(strtoupper($params['ordering_sort_order']));
        } else {
            $query .= ' ORDER BY user_id DESC';
        }

        return [
            'user_links_details' => acym_loadObjectList($query, '', $params['offset'], $params['detailedStatsPerPage']),
            'total' => acym_loadObject($queryCount),
            'query' => $query,
        ];
    }

    public function getTotalClicksPerMail(array $mailIds = []): array
    {
        acym_arrayToInteger($mailIds);

        $query = 'SELECT SUM(click) AS total_clicks, COUNT(click) AS unique_clicks, mail_id FROM #__acym_url_click ';
        $query .= empty($mailIds) ? '' : 'WHERE `mail_id` IN ('.implode(',', $mailIds).') ';
        $query .= 'GROUP BY mail_id';

        return acym_loadObjectList($query, 'mail_id');
    }

    public function getOneByMailIdAndUserId(int $mailId, int $userId): ?object
    {
        $urlClick = acym_loadObject('SELECT * FROM #__acym_url_click WHERE mail_id = '.intval($mailId).' AND user_id = '.intval($userId));

        return empty($urlClick) ? null : $urlClick;
    }

    public function getUserMailsClicked(int $userId): array
    {
        return acym_loadObjectList(
            'SELECT user_stat.mail_id, url_click.click
            FROM #__acym_user_stat AS user_stat
            LEFT JOIN #__acym_url_click AS url_click 
                ON url_click.mail_id = user_stat.mail_id 
                AND url_click.user_id = user_stat.user_id
            WHERE user_stat.user_id = '.intval($userId).'
            GROUP BY user_stat.mail_id'
        );
    }

    public function getClicksByMailId(int $mailId): array
    {
        return acym_loadObjectList(
            'SELECT url_click.url_id, url_click.user_id, url_click.click, url_click.date_click, `user`.email, url.url
            FROM #__acym_url_click AS url_click
            LEFT JOIN #__acym_user AS `user` ON url_click.user_id = `user`.id
            JOIN #__acym_url AS url ON url_click.url_id = url.id
            WHERE url_click.mail_id = '.intval($mailId)
        );
    }

    public function getClicksByUserId(int $userId): array
    {
        return acym_loadObjectList(
            'SELECT url.url, url_click.*
            FROM #__acym_url_click AS url_click 
            JOIN #__acym_url AS url ON url.id = url_click.url_id 
            WHERE url_click.user_id = '.intval($userId)
        );
    }
}

```