=== Rikochey ===
Contributors: rikochey
Tags: forms, leads, contact form, lead tracking, captcha
Requires at least: 6.5
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Place your Rikochey forms in any page with a shortcode, and trace every lead back to its source, its campaign and its revenue.

== Description ==

Rikochey collects the requests sent from the forms of your websites and turns each one into a lead you can follow: where it came from, which campaign brought it, and what it earned you.

This plugin connects your WordPress site to your Rikochey organization:

* **Connect with one API key**, created in your Rikochey workspace.
* **See the forms of your website** and copy their shortcode in one click.
* **Paste the shortcode** into a page, a post or a widget: the form shows up with its fields, its validation, its captcha and its appearance.
* **Visits are measured** on every page, so that each lead keeps its source and its campaign.

No Rikochey account yet? Create one, or contact the team to be guided through your onboarding: links are on the plugin's settings page.

== Installation ==

1. Download the plugin from the Rikochey home page, or from your website's page in your Rikochey workspace (**WordPress plugin** section).
2. In WordPress, go to **Plugins → Add New Plugin → Upload Plugin**, choose the ZIP file, then activate the plugin.
3. In Rikochey, open **Organization → API tokens**, click **Create a token** and copy the key.
4. In WordPress, open **Rikochey**, paste the key and click **Connect**.
5. Copy the shortcode of a form, for example `[rikochey form="contact"]`, and paste it into a page.

== Frequently Asked Questions ==

= Where do I find my API key? =

In your Rikochey workspace: **Organization → API tokens → Create a token**. The key is shown only once: copy it right away.

= The form does not show up =

Check that the form is active and linked to the website in Rikochey, then click **Refresh** on the plugin page. The shortcode identifier must match the form's identifier.

= Submissions are refused =

Rikochey only accepts submissions sent from the domain declared for the website. The plugin warns you when the domain of WordPress and the domain declared in Rikochey differ.

= Can a form show in several languages? =

Yes, once you have translated it in Rikochey. The form follows the language of the page, which WordPress, WPML and Polylang already set: labels, error messages and the confirmation message all follow it. When the form does not offer the page's language, it shows in its source language. To force one of its languages, add it to the shortcode: `[rikochey form="contact" lang="en"]`.

= Can I keep my own form markup? =

Yes: put `data-rikochey-form="contact"` on your own `<form>` tag. The field `name` attributes must match the field names set in Rikochey.

= Does the plugin send data to Rikochey? =

The WordPress server calls the Rikochey API with your key to list your websites and forms. Visitors' browsers load the Rikochey script, which measures visits and sends form submissions. The default captcha uses no cookie.

== Changelog ==

= 1.0.0 =
* First release: connection by API key, list of forms, shortcode, script loaded on every page.
