jt782/require-read-terms-php

显示“条款和条件”的模态框,并在提交表单之前要求用户阅读(滚动到页面底部)并同意这些条款。

1.5.1 2022-04-24 01:46 UTC

README

Latest Version on Packagist Tests Total Downloads

显示“条款和条件”的模态框,并在提交表单之前要求用户阅读(滚动到页面底部)并同意这些条款。

安装

您可以通过composer安装此包

composer require jt782/require-read-terms-php

用法

  1. 使用表单目标(例如".class"或"#id")和条款内容初始化类
use Seven82Media\RequireReadTerms\FormTerms;

$terms = new FormTerms(
    '#target-form-id',
    '<p>terms go here</p>'
);
  1. 您可以使用以下方法修改以下值
  • 同意按钮文本:$terms->agreeButtonText("是的,我同意!")
  • 同意按钮颜色:$terms->agreeButtonColor("green")
  • 取消按钮文本:$terms->cancelButtonText("NO,这很愚蠢!")
  • 取消按钮颜色:$terms->cancelButtonColor("red")
  • 宽度:$terms->width("64em")
  1. 在表单中,加载内容并显示按钮
$terms->loadModalDisplayButton()
  1. 如果您想更精确地控制按钮与脚本的位置,您可以分别加载它们
  • 用于按钮显示
$terms->displayButton()
  • 用于脚本输出
$terms->loadScript()
  1. 如果您有一个同意条款的复选框,您可以从视觉上隐藏它,并在用户同意条款后由包进行检查
$terms->checkboxFieldTarget("#agree-to-terms");
?>
<div style="display:none;">
    <input type="checkbox" value="1" name="agreetoterms" id="agree-to-terms" />
</div>

示例

<?php
    $terms = new FormTerms('.test-form', '<p>Term content goes here</p>');
    $terms->checkboxFieldTarget("#agree-to-terms");
?>
<form class="test-form" method="get" action="/form">
    <?php
        $terms->loadModalDisplayButton();
    ?>

    <div style="display:none;">
        <input type="checkbox" value="1" name="agreetoterms" id="agree-to-terms" />
    </div>
    
    <p>
        <button type="submit">Submit</button>
    </p>
</form>

测试

composer test

变更日志

请参阅变更日志以获取有关最近更改的更多信息。

贡献

请参阅贡献指南以获取详细信息。

安全漏洞

请参阅我们的安全策略以了解如何报告安全漏洞。

鸣谢

许可

MIT许可(MIT)。请参阅许可文件以获取更多信息。