README

适用于comments、feedback插件，以及网站用户注册表单。

插件请求Google服务对用户行为进行评估，以防止由机器人发送表单，这些机器人最常发送垃圾邮件。

系统要求

在使用插件之前，请确保您的服务器符合以下要求

• PHP ^7.3|^8.0
• irbees2008/ng-helpers

irbees2008/ng-helpers插件必须被包含。

连接

在更新插件之前，请在管理面板中禁用它。还需要从服务器上删除旧版本。

相同的操作也适用于旧插件ggg_recaptcha。

插件提供两种版本，每种版本都支持自己的编码类型：UTF-8和Windows-1251。您可以下载符合项目编码的插件

• UTF-8
• Windows-1251

请注意，UTF-8是主要编码。

配置

1. 在使用插件之前，请在此处注册并获取reCAPTCHA v3密钥和密钥。
2. 在管理面板中激活ng-grecaptcha插件。
3. 将密钥和密钥插入相应的字段。
4. 不需要对插件进行任何额外操作。

现在，在您的网站右下角将显示reCAPTCHA信息块。

如果使用从模板嵌入页面JavaScript文件选项，您可以在管理控制台中跟踪用户操作，并根据需要进行权限划分。为此，需要为每个表单添加相应的标识符。

例如，对于用户注册表单，可能看起来像这样

<!-- \templates\ВАШ_ШАБЛОН\registration.tpl -->

<form id="register_user" ...>
    <!-- Остальной код формы -->
</form>

使用

comments插件

要在comments插件中使用，请编辑表单模板，在</form>标签之前添加一个隐藏字段。

<!-- \templates\ВАШ_ШАБЛОН\plugins\comments\comments.form.tpl -->

<input type="hidden" name="g-recaptcha-response" value="" />

如果使用AJAX技术发送评论，则需要在发送AJAX请求之前将验证码字段的值添加到JavaScript中。

例如，在同一个模板中，在[not-logged] ... [/not-logged]部分之后添加到script段中

cajax.setVar('g-recaptcha-response', form['g-recaptcha-response'].value);

feedback插件

要在feedback插件中使用，请编辑表单模板，在</form>标签之前添加一个隐藏字段。

<!-- \templates\ВАШ_ШАБЛОН\plugins\feedback\site.form.tpl -->

<input type="hidden" name="g-recaptcha-response" value="" />

注册表单

要在用户注册表单中使用，请编辑表单模板，在</form>标签之前添加一个隐藏字段。

<!-- \templates\ВАШ_ШАБЛОН\registration.tpl -->

<input type="hidden" name="g-recaptcha-response" value="" />

模态窗口中的表单

要在模态窗口中的表单中使用，请编辑表单模板，在</form>标签之前添加一个隐藏字段。

<input type="hidden" name="g-recaptcha-response" value="" />

许可证

ng-grecaptcha是开源软件，根据MIT许可证分发。