Счётчик на иконке приложения

Содержание...

Иконка приложения в главном меню (которое обычно формируется с помощью метода {$wa->apps()}), может отображать индикатор красного цвета с краткой информацией для пользователя, требующей срочного внимания, например, количество новых заказов в интернет-магазине или комментариев в блоге. На рисунке показано, как может выглядеть такой индикатор:

Для того чтобы добавить подобную подсказку для вашего собственного приложения, необходимо создать файл wa-apps/[app_id]/lib/config/[app_id]Config.class.php с классом [app_id]Config, унаследованным от системного класса waAppConfig и реализующим метод onCount(), как показано ниже:

<?php

class myappConfig extends waAppConfig
{

    public function onCount()
    {
        ...
        return $value;
    }
    
}

Значение, возвращаемое методом onCount(), отобразится на индикаторе. При реализации метода следует учитывать, что он автоматически вызывается каждую минуту. Если индикатор нужно скрыть при каких-либо условиях, то в этом случае метод должен вернуть пустое значение.

Изменение ссылки иконки приложения

Помимо отображения индикатора, с помощью метода onCount() также можно изменять адрес ссылки, которой является иконка приложения в главном меню. Например, в приложении «Блог» при появлении новых комментариев (если настроено соответствующее уведомление) ссылка иконки «Блога» указывает на список комментариев; в противном случае ссылка открывает список постов. Таким же образом вы можете динамически изменять URL ссылки своего приложения. Для этого метод onCount() должен возвращать ассоциативный массив со следующими элементами:

[
   'count' => $value, //значение для отображения в индикаторе
   'url' => $url, //URL ссылки для иконки приложения
]
Метод onCount() можно также использовать для выполнения каких-либо операций один раз в минуту — без отображения индикатора. В этом случае метод просто не должен возвращать никакого значения.