README

TgaAudienceBundle 是一个完整、可扩展且灵活的 Symfony 2 扩展包，用于轻松跟踪您的网站受众和访问者行为。

其目标是尽可能简单地进行安装和使用。

安装

TgaAudience 是一个经典的扩展包，专为 Symfony 2.2 设计。您可以使用 Composer 来安装它

{
    "require": {
        "tga/audience": "dev-master"
    }
}

作为一个经典的扩展包，在您的内核中加载它

$bundles = array(
	// ...
	new Tga\AudienceBundle\TgaAudienceBundle(),
	// ...
);

该扩展包需要在数据库中存储数据。因此，使用 doctrine，运行

php app/console doctrine:schema:update --force

以创建两个必需的表。

之后，扩展包将自动运行。它将在适当的时间保存所需数据，并通过 HTTP 请求来找到存储数据的最佳方式。您无需担心这一点！

使用

现在，您可能想查看由扩展包存储的数据。有两种方法可以实现

使用默认界面

默认界面默认可用。您只需加载路由

tga_audience:
    resource: "@TgaAudienceBundle/Controller/"
    type:     annotation
    prefix:   /audience

并安装资源

php app/console assets:install

现在，您可以通过 http://mydomain.com/audience 访问界面

使用自定义界面

默认界面只是显示统计信息的一种简单方式，但您可能希望限制访问或加载更多数据。如果您想创建自定义的统计信息显示，这非常简单。

该扩展包提供了一个服务，可以访问您在默认界面中可以查看的所有计算过的统计信息：这个服务是 tga_audience.stats。使用它，您可以获取处理器（分析数据以找到统计信息的对象）以及您想要的每个统计信息

$processor = $this->get('tga_audience.stats')->getProcessor();

$processor->getUniqueVisitors();
$processor->getUniqueVisitorsCount();
$processor->getPageCalls();
$processor->getPageCallsCount();
$processor->getAverageVisitedPages();
$processor->getAverageDuration();
$processor->getAverageTimeToLoad();
$processor->getPlatforms();
$processor->getBrowsers();
$processor->getMostUsedRoutes();
$processor->getBrowsersVersions();
$processor->getExternalSources();
$processor->getMostUsedExternalSources();

配置

默认配置是

tga_audience:
    session_duration: 300       # Duration meanwhile a visitor is unique
    disabled_routes: []         # List of disabled routes to not track with the bundle
    environnements: ['prod']    # List of environnements where the bundle will track requests

许可证

Apache (参见 LICENSE.md)。