﻿
=== Cirrus Shield Forms for WordPress ===
Tags: cirrus shield, crm, customer relationship management, marketing automation, sales, customer service, low code, platform, aPaaS, wordpress forms, subscription form, signup form, plugin, sidebar, shortcode
Requires at least: 4.4
Tested up to: 6.2
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Connect your website to your CRM and easily add forms on your WordPress website that send data to Cirrus Shield

== Description ==
<a href="https://www.cirrus-shield.com/?utm_source=wordpress_plugin&utm_medium=plugin&utm_campaign=addons_page" target="_blank">Cirrus Shield</a>’s official plugin for WordPress is a powerful plugin to integrate WordPress with Cirrus Shield. At a glance:
<ul>
<li><b>Website Forms</b> - Create custom subscription forms and easily integrate data from your website in Cirrus Shield</li>
<li><b>Email alerts</b> - Receive an email alert with form data when a form is submitted. You can send the email alert to multiple email recipients</li>
<li><b>Double opt-in</b> - The plugin allows you to manage a double opt-in process</li>
<li><b>Manage subscriptions</b> - Contacts can subscribe to your communications and will receive an email confirmation</li>
<li><b>Logs</b> - All form submissions are logged by the plugin</li>
<li><b>Failover</b> - Even if the communication with the Cirrus Shield REST API is broken, the published form continues to work and will send submitted form data and emails </li>
</ul>

= Forms =
<ul>
<li>Form designer with WYSIWYG and direct HTML / CSS editing (if desired)</li>
<li>Integration as widget or shortcode [cswp_form]</li>
<li>Send a confirmation email</li>
<li>Use a double opt-in confirmation</li>
<li>Customize the messages displayed through the subscription process</li>
</ul> 

= Logs =
<ul>
<li>Access history of all forms successfully submitted through the form to Cirrus Shield</li>
<li>Full double opt-in process is historized for RGPD compliance</li>
<li>Both opt-in and double opt-in process are handled</li>
</ul>

= Failover =
<ul>
<li>If your website is unable to connect to Cirrus Shield, all unsubmitted form data is logged in Cirrus Shield</li>
<li>Whether the form was able to send form data by email or not, unsubmitted form data is logged in Cirrus Shield</li>
</ul>    

= Plugin Support =
To get support, please send an email to <a href="mailto:support@cirrusshield.com">support@cirrusshield.com</a>, we will be happy to help you!

The plugin is available in English and French. 

== Installation ==

1.	In your WordPress admin panel, go to Plugins > New Plugin, search for "CirrusShield for WP" and click "Install now". Alternatively, download the plugin and upload the contents of cirrusshieldforwp.zip to your plugins directory, which may be  /wp-content/plugins/. 
2.	Activate the Cirrus Shield plugin through the 'Plugins' menu in WordPress. 
3.	The "Cirrus Shield" tab must appear in your WordPress side navigation panel, then set your username and password in the plugin homepage.

To get a Cirrus Shield username and password, please <a href="mailto:contact@cirrusshield.com">contact us</a>. We will get back in touch with you.

== Screenshots ==
1. First, your are invited to connect you to your Cirrus Shield account with your username and password in the plugin login page
2. The Homepage gives you access to your forms list and allows you to create or edit forms that will connect to Cirrus Shield
3. When you click on a specific form, you can configure the form fields and subscription process, including custom messages and custom email recipients
4. The list of subscribers page shows you the list of all successful form submissions.
5. The list of unsuccessful form submissions are listed in the list of unsubmitted forms. Those records were not successfully sent to Cirrus Shield.

== Frequently Asked Questions ==

= What is Cirrus Shield? =
CirrusShield is a powerful CRM that lets you manage marketing, sales and customer service activities at your company. Cirrus Shield is also a low-code platform or an aPaaS that lets you create business applications with clicks. You are now able to create applications to manage business processes at your company with zero knowledge in software development. 
Cirrus Shield is accessible from your computer, tablet or smartphone and is packed with features for a very competitive pricing.

= Why send data from my WordPress website to Cirrus Shield ? =
By using Cirrus Shield, you will be able to leverage the Cirrus Shield platform to manage the marketing, sales and customer service activities in one place. With its application creation capabilities,  Cirrus Shield also allows you to manage any business process in your company and improve operational efficiency.

= Why do I need a Cirrus Shield account? =
The Cirrus Shield Forms for WordPress plugin uses Cirrus Shield’s API to synchronize with any module (leads, contacts, etc.). This is why you need a Cirrus Shield account in order to send data from the WordPress plugin to Cirrus Shield.
 
= Which version of Cirrus Shield do I need to use the plugin ? =
The WordPress plugin of Cirrus Shield is available starting with the Professionnal version. We invite you to see our pricing at the following address: https://www.cirrus-shield.fr/tableau-comparatif-des-prix/

= How do I get my get synchronize my lists? =
You have nothing to do - synchronization is automatic! It doesn't matter whether your lists were uploaded on your WordPress interface or on your CirrusShield account: they will always remain up-to-date on both sides.

= How can I get support? =
If you need assistance, you can send us an email at support@cirrus-shield.com.

= How do I create a form? =
In order to create a form, you need to:
1. Go to Wp admin > CirrusShield in order to define your form’s fields and settings
2. Integrate the form in a sidebar using a widget from WP panel > Appearance > Widgets. The CirrusShield widget form should appear in your widgets list, you just to have to drag and drop the widget into the sidebar of your choice. 


== Changelog ==

= 20260827 =
* Replaced Cirrus Shield username/password authentication with OAuth 2.0 Client Credentials (Connected App Client ID/Secret)
* Added a configurable Cirrus Shield URL (defaults to production; can be pointed at a beta environment)
* Added token caching with automatic retry on an expired/revoked token
* Failed form submissions are now logged to Unsubmitted Logs with the reason, and email the site admin
* Various security fixes: nonce/capability checks and parameterized SQL queries throughout

= 20240228 =
* Fixed error on accessing the plugin

= 20231220 =
* Fixed the if condition to not throw 500 internal server error before the response is sent back to the client .

= 20231101 =
* Fixed the if condition to not throw 500 internal server error before the response is sent back to the client.

= 20230519 =
* PHP8 compatibility

= 20230507 =
* WP_Scripts::localize was being called incorrectly. Corrected.
* Refactoring

= 20230504 =
* Correction on safe redirect on init

= 20210903 =
* Custom templates are now available for sending email confirmations.
* The templates should be included in inc/templates/confirm folder. "_fr-FR" suffix 
* should be added to french templates.
* Modified "cs_model_forms" table: changed TemplateID column type from int to 
* varchar(255) in order to accept Ids (= template name).
* Note: Do not remove the default template "temp" & "temp_fr-FR" (ID = -1).

= 20201004 =
* Removing error message with using DbDelta to create tables. Used query instead.
* Enhanced logging
* Bug in SQL for new Form creation due to CSS including single quotes

= 20200908 =
* Bug when submitting form with "Souscription_Newsletter" checkbox
* Now redirect only takes place in case of success
* Updated default CSS for a form

= 20200420 =
* Initial release