README

Zend Framework 2 的 Google Adsense 视图助手

该模块有助于管理页面上的 AdSense 单元。将它们全部放在一个地方并使用渲染器！

最简单的用法

将广告单元（一个或多个）和发布者 ID（您可以在这里找到）添加到您的配置文件中

return array(
  'zf-snap-google-adsense' => array(
    'publisher-id' => 'pub-1234567890123456',
    'ads' => array(
      'home-page' => array(
        'id' => 1234567890,
        'size' => '336x280',
      ),
    ),
  ),
);

然后通过视图助手在您的视图中渲染广告。您可以使用 googleAdsense 或 adsense 名称

echo $this->adsense('home-page');

这就完成了！默认情况下，adsense 使用异步代码。您可以使用预定义的视图渲染器来更改它。

如何安装？

通过 composer.json

{
  "require": {
    "snapshotpl/zf-snap-google-adsense": "1.*"
  }
}

渲染器

您可以使用实现 ZfSnapGoogleAdSense\View\Helper\Renderer\RendererInterface 的渲染器来渲染您的广告。默认模块提供了一个具有非常有用的视图的简单视图渲染器。

• 异步（默认）：官方异步脚本
• 同步：官方同步脚本
• placeholdit：使用 placehold.it 服务生成占位符图像，非常适合开发或测试环境，您可以自定义它，更多详细信息请参阅 config/module.config.php 并覆盖选项
• html：生成 html div，非常适合开发或测试环境，您可以自定义它，更多详细信息请参阅 config/module.config.php 并覆盖选项

要添加自己的视图到视图渲染，创建视图（在视图中您可以使用 ad 属性，它默认是 \ZfSnapGoogleAdSense\Model\AdUnit 的实例）并添加到视图管理器中，前缀为 zf-snap-google-adsense-renderer-view-*

return array(
  'view_manager' => array(
    'template_map' => array(
      'zf-snap-google-adsense-renderer-view-customview' => __DIR__ . '/my-awesome-custom-view.phtml',
    ),
  ),
);

要更改当前视图渲染器，将视图名称传递给 renderer 选项

return array(
  'zf-snap-google-adsense' => array(
    'renderer' => 'zf-snap-google-adsense-renderer-view-customview',
  ),
);

如果您编写了自己的渲染器，则通过从 service_manager 中传递实例名称。您还可以将自定义参数设置到视图中。要了解它是如何工作的，请查看 config/module.config.php 中的 renderers 数组以及视图渲染器的源代码。

选项

ads 定义广告单元

• id（必需）：广告 ID
• size（必需）：您可以使用字符串或数组定义大小
• type：内容型和链接型。内容单元是默认类型。您可以使用常量或字符串
• name：它在自定义渲染器（placeholdit 和 html）中使用。如果没有定义名称，则广告将通过名称键获取名称

return array(
  'zf-snap-google-adsense' => array(
    'ads' => array(
      'link-ad-by-constat' => array(
        'id' => 1234567890,
        'size' => '336x280',
        'type' => \ZfSnapGoogleAdSense\Model\AdUnit::TYPE_LINK,
      ),
      'link-ad-by-string' => array(
        'id' => 1234567890,
        'size' => array(
          'width' => 336,
          'height' => 280,
        ),
        'type' => 'link',
      ),
      'content-ad' => array(
        'id' => 1234567890,
        'size' => '336x280',
        'type' => \ZfSnapGoogleAdSense\Model\AdUnit::TYPE_CONTENT,
        'name' => 'Content ad under header',
      ),
    ),
  ),
);

enable 如果等于 false，则禁用在页面上的广告

return array(
  'zf-snap-google-adsense' => array(
    'enable' => false,
  ),
);

publisher-id（必需）发布者 ID - 您可以在这里找到

unit-limit 限制页面上的广告数量。默认值

• 3 个内容单元（更多信息）
• 3 个链接单元（更多信息）

return array(
  'zf-snap-google-adsense' => array(
    'unit-limit' => array(
      AdUnit::TYPE_CONTENT => 3,
      AdUnit::TYPE_LINK => 3,
    ),
  ),
);