包简介

Kirby Plugin for interfacing with Posthog

README 文档

README

Kirby Plugin for interfacing with Posthog

Install

unzip master.zip as folder site/plugins/kirby3-posthog or
git submodule add https://github.com/bnomei/kirby3-posthog.git site/plugins/kirby3-posthog or
composer require bnomei/kirby3-posthog

Setup

You can set the apikey and host in the config.

site/config/config.php

return [
    // other config settings ...
    'bnomei.posthog.apikey' => 'YOUR-KEY-HERE',
    'bnomei.posthog.host' => 'YOUR-HOST-HERE',
];

You can also set a callback if you use the dotenv Plugin.

site/config/config.php

return [
    // other config settings ...
    'bnomei.posthog.apikey' => function() { return env('POSTHOG_APIKEY'); },
    'bnomei.posthog.host' => function() { return env('POSTHOG_HOST'); },
];

Javascript

Output the tracking Javascript via the snippet included in the plugin.

  <?php snippet('posthog'); ?>
  </body>
</html>

Usage

PHP track pageview

site/template/default.php

<?php
// track page view event for current kirby user or identified posthog user
$page->posthogCapturePageView();

// be careful to not have any whitespace before <html>
><html>
    <!-- ... --->
</html>

PHP helper function

Use the posthog()-helper to access Posthog. You can use all methods from the Posthog PHP library.

<?php

posthog()->capture([
    'distinctId' => site()->posthogDistinctId(),
    'event' => 'movie played',
    'properties' => array(
        'movieId' => '123',
        'category' => 'romcom'
    )
])

In addition to the posthog()-helper this plugin adds the following features to the original library.

Disabled on localhost by default
Cache for Feature Flag list - it would otherwise send a http request to your posthog instance every time you access the list. It still will send one for every feature flag check.

Warning

Using the static class from the official Posthog docs is not supported.

Settings

bnomei.posthog.	Default	Description
apikey	`string or callback`
personalapikey	`string or callback`
host	`string or callback`
enabled	`true or false or 'force'`	but disabled on localhost setups by default
featureflags	`1`	duration (in minutes) to cache the feature flags in minutes

Tip

Read more about apikey and personalapikey here: https://posthog.com/docs/api

Dependencies

Posthog PHP

Disclaimer

This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please create a new issue.

License

MIT

It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.

bnomei/kirby3-posthog 适用场景与选型建议

bnomei/kirby3-posthog 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 468 次下载、GitHub Stars 达 2，最近一次更新时间为 2022 年 03 月 21 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「analytics」「kirby」「kirby-plugin」「kirby-cms」「posthog」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 bnomei/kirby3-posthog 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 bnomei/kirby3-posthog 我们能提供哪些服务？

定制开发 / 二次开发

基于 bnomei/kirby3-posthog 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 bnomei/kirby3-posthog 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

johannschopplich/kirbylog 28

Zero-dependency global `kirbylog()` helper for any content

beebmx/kirby-courier 40

Courier offers a convenient and painless solution for creating emails tailored for your Kirby website.

nswdpc/silverstripe-analytics-chooser 0

Analytics chooser extensions for site settings.

beebmx/kirby-blade 14

Blade template for Kirby

charlielangridge/fathom-stats-display 3

A Laravel Nova Card to show Fathom Analytics stats.

arnoson/kirby-loupe 40

Search Kirby with Loupe

bnomei/kirby3-posthog

包简介

关键字：