编辑“Open Web Analytics/过滤器hooks”

{{Open Web Analytics top}}
'''Filters''',过滤器，允许模块的开发者创建一个自定义的模块函数，这些函数可以用来更改OWA产生的各种变量的值。

==注册一个过滤器==
过滤器应该在你的模块构建器中注册。注册一个过滤器函数，需要用到regiserFilter模块方法，将要被过滤的值的名称、以及包含这个过滤器函数的（函数名以及一些可选属性）对象的名称传递给该方法。

录入，我们假设你想过滤OWA为访问者操作系统产生的值，那么注册一个自定义的过滤函数将会如下面所示：
   $this->registerFilter('operating_system', $this, 'myFunctionName');
这行代码注册了一个叫做myFunctionName的过滤函数，传递的是$this这个对象，这个对象告诉OWA这个函数是同一个模块下的一个方法。你也可以将过滤函数包含在其他对象中，然后传递一个对那个对象的引用即可，例如：
    $mynewobject = new yourClass;
   $this->registerFilter('operating_system', $mynewobject, 'myFunctionName');
==过滤器hooks==
下面列举的是可以被用来过滤的值：
=== 事件进程中的 ===
<BR>

{| border=1 cellspacing=0 cellpadding=10
! Value Name（名称）
! Description（说明）
! Arguments（参数）
!Version Added（添加的版本）
|-
| operating_system
| 访问者的操作系统.
| <code>$os</code> - 操作系统, <code>$ua</code> - 访问者的用户代理.
| 1.2.3
|-
| user_agent
| 访问者的用户代理.
|
| 1.2.3
|-
| http_referrer
|访问者的http参照页.
|
| 1.2.3
|-
| http_host
| 访问者的http主机
|
| 1.2.3
|-
| page_type
| 被追踪的页面类型
|
| 1.2.3
|-
| ip_address
| 访问者的ip地址
|
| 1.2.3
|-
| full_host
| 访问者完整的主机名
| <code>$fullhost</code> - 完整的主机名, <code>$ip_address</code> - 访问者的IP地址.
| 1.2.3
|-
| host
| 访问者的主机的域名 
| <code>$host</code> - 中级主机名, <code>$ip_address</code> - 访问者的IP地址.
| 1.2.3
|-
| browser_type
| 访问者的浏览器类型 (eg. Firefox, Safari, etc.)
|
| 1.2.3
|-
| browser
| 访问者浏览器的标签
|
| 1.2.3
|-
| user_name
| 访问者的用户名
|
| 1.2.3
|-
| user_email
| 访问者的Email地址
|
| 1.2.3
|-
| page_url
| 被追踪的页面的url地址
|
| 1.2.3
|-
| target_url
| 被点击的链接的url.
|
| 1.2.3
|-
| post_processed_tracking_event
| 发生了、还未被提交到处理器的事件.
|<code>$event</code> - 一个OWA追踪事件对象.
| 1.2.3
|}



=== Framework （框架）===

{| border=1 cellspacing=0 cellpadding=10
! Value Name（名称）
! Description（说明）
! Arguments（参数）
! Version Added（添加版本）
|-
| auth_status
|  由OWA授权模块返回的授权状态. 在OWA试图授权一个用户时解除. 使用这个过滤器可以添加你自己的授权逻辑。.
| <code>$auth_status</code> (boolean布尔类型)
| 1.3.0
|}
==参考来源==
*http://wiki.openwebanalytics.com/index.php?title=Filters

{{Open Web Analytics}}

[[category:Open Web Analytics]]