{"id":110,"date":"2025-04-05T18:02:52","date_gmt":"2025-04-05T18:02:52","guid":{"rendered":"https:\/\/getpetitioner.com\/?post_type=docs&p=110"},"modified":"2025-04-27T17:31:23","modified_gmt":"2025-04-27T17:31:23","slug":"captcha","status":"publish","type":"docs","link":"https:\/\/getpetitioner.com\/docs\/captcha\/","title":{"rendered":"Configuring captcha"},"content":{"rendered":"\n

To protect your petition forms from spam, the Petitioner plugin supports Google reCAPTCHA, hCaptcha, and Cloudflare Turnstile. You can choose either depending on your preference and use case.<\/p>\n\n\n\n\n\n\n\n

\n

Note: do not try to use multiple at the same time<\/h3>\n\n\n\n

These captcha libraries are not meant to be used together and will cause conflicts if you try.<\/p>\n<\/div>\n\n\n\n

Configuring reCaptcha<\/h2>\n\n\n\n

First of, you will need to get your credentials. <\/p>\n\n\n\n

    \n
  1. Go to https:\/\/www.google.com\/recaptcha\/admin\/create<\/a> and create a new reCaptcha instance. Add a label and use the v3 version of the captcha.<\/li>\n\n\n\n
  2. Add your domain (e.g., example.com)<\/li>\n\n\n\n
  3. Accept Terms and click Submit<\/strong><\/li>\n\n\n\n
  4. Copy your Site Key<\/strong> and Secret Key<\/strong><\/li>\n<\/ol>\n\n\n\n

    Now that you have your credentials:<\/p>\n\n\n\n

      \n
    1. Go to Petitioner \u2192 Settings \u2192Integrations<\/strong>. Find Google reCAPTCHA v3<\/strong> and click “Configure”<\/strong><\/li>\n\n\n\n
    2. Click “Enabled”<\/strong> to enable<\/li>\n\n\n\n
    3. Enter your site key and the secret key.<\/li>\n\n\n\n
    4. Close the popup and hit “Save Changes”<\/strong><\/li>\n<\/ol>\n\n\n\n

      Configuring hCaptcha<\/h2>\n\n\n\n

      Getting credentials is similar to reCAPTCHA:<\/p>\n\n\n\n

        \n
      1. Go to: https:\/\/www.hcaptcha.com\/<\/a><\/li>\n\n\n\n
      2. Sign in and navigate to the Sites<\/strong> section<\/li>\n\n\n\n
      3. Add a new site and domain<\/li>\n\n\n\n
      4. Choose the difficulty level<\/li>\n\n\n\n
      5. Copy your Site Key<\/strong> and Secret Key<\/strong><\/li>\n<\/ol>\n\n\n\n

        Now lets add them to Petitioner:<\/p>\n\n\n\n

          \n
        1. Go to Petitioner \u2192 Settings \u2192Integrations<\/strong><\/strong>. Find hCaptcha<\/strong> and click “Configure”<\/strong><\/li>\n\n\n\n
        2. Click “Enabled”<\/strong> to enable<\/li>\n\n\n\n
        3. Enter your site key and the secret key.<\/li>\n\n\n\n
        4. Close the popup and hit “Save Changes”<\/strong><\/li>\n<\/ol>\n\n\n\n

          Configuring Cloudflare Turnstile<\/h2>\n\n\n\n

          Turnstile is very similar to the above:<\/p>\n\n\n\n

            \n
          1. Go to Cloudflare Turnstile Dashboard<\/a><\/li>\n\n\n\n
          2. Navigate to Turnstile \u2192 Add site<\/strong><\/li>\n\n\n\n
          3. Add a new site and domain<\/li>\n\n\n\n
          4. Choose \u201cManaged\u201d mode<\/li>\n\n\n\n
          5. Copy your Site Key<\/strong> and Secret Key<\/strong><\/li>\n<\/ol>\n\n\n\n

            Now lets add them to Petitioner:<\/p>\n\n\n\n

              \n
            1. Go to Petitioner \u2192 Settings \u2192Integrations<\/strong><\/strong>. Find Cloudflare Turnstile<\/strong> and click “Configure”<\/strong><\/li>\n\n\n\n
            2. Click “Enabled”<\/strong><\/li>\n\n\n\n
            3. Enter your site key and the secret key.<\/li>\n\n\n\n
            4. Close the popup and hit “Save Changes”<\/strong><\/li>\n<\/ol>\n","protected":false},"featured_media":0,"menu_order":0,"template":"","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-110","docs","type-docs","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/getpetitioner.com\/wp-json\/wp\/v2\/docs\/110","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/getpetitioner.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/getpetitioner.com\/wp-json\/wp\/v2\/types\/docs"}],"version-history":[{"count":11,"href":"https:\/\/getpetitioner.com\/wp-json\/wp\/v2\/docs\/110\/revisions"}],"predecessor-version":[{"id":152,"href":"https:\/\/getpetitioner.com\/wp-json\/wp\/v2\/docs\/110\/revisions\/152"}],"wp:attachment":[{"href":"https:\/\/getpetitioner.com\/wp-json\/wp\/v2\/media?parent=110"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}