=== SquareOffs ===
Contributors: squareoffs, humanmade
Donate link:
Tags: squareoff, debate, poll, vote, comment, engagement, forum, opinion, compare, review, discuss, survey
Requires at least: 4.6
Tested up to: 6.7
Requires PHP: 5.4
Stable tag: 4.2.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Easily add [SquareOffs](http://www.squareoffs.com/)® microdebates to your content to increase engagement, revenue, traffic, and insight.

== Description ==
This easy-to-use plugin allows you to embed SquareOffs® directly into your content without ever leaving Wordpress.

SquareOffs microdebates™ allow digital publishers of all sizes to engage readers, increase traffic, gain insight, and generate new revenue. They are more than just another poll. SquareOffs allow you to engage your readers in an interactive conversational debate where they not only choose a side, but can also explain “why” they made their choice. Readers love it because they can make their voice heard, invite others to join the conversation, vote up top reasons supporting their side, and easily access relevant comments within the innovative dual comment stream. Readers are kept on your site rather than social networks, allowing you to own the conversation.

>SquareOffs placed in an article receive 41% more comments than standard commenting systems.
>
>Readers spend an average of 13 seconds longer on article pages when interacting with a SquareOff.

[youtube https://www.youtube.com/watch?v=P9SJWUdoSNs&%3Bt=21s]

Some of the features of the SquareOffs plugin include:

* Embed a small format SquareOff inline in your post or page.
* Embed a wide format SquareOff into your post or page as the content.
* Create a new SquareOff in either the WYSIWYG editor or from the navigation.
* Graphical representation of the shortcode in the Visual editor allows users to easily coordinate the layout of a post or page.
* Increase site traffic when voters share on social media, pulling new readers back to your site.
* Create simple, bite-sized content with which readers can easily engage.
* Easily link your SquareOffs account to the Wordpress plugin during installation.
* Configure display settings, colors, font, social sharing, and more.

== Installation ==
It's easy to install the SquareOffs WordPress plugin.

To install from the wp-admin panel:

1. Login to your admin page at http://yoursite.com/wp-admin/.
1. Navigate to "Plugins" in the left navigation.
1. Click "Add New".
1. If you have already downloaded the SquareOffs plugin, click "Upload Plugin".
1. If you don't already have the .zip, you can search for 'SquareOffs'.
1. Follow the on-screen instructions to install and activate the plugin.

To install manually:

1. Download the SquareOffs plugin .zip file from the WordPress Plugin Directory.
1. Unzip the file and upload to your web server's "/wp-content/plugins/" directory.
1. Activate the SquareOffs plugin through your wp-admin "Plugins" section.

= Connecting Your SquareOffs Account =

Existing Account

If you already have a SquareOffs account, simply click on "SquareOffs" in the left navigation.
Enter your SquareOffs login information (email and password).

New Account

If you do not have a SquareOffs account, no problem. Just create your account in a few simple steps at: https://www.squareoffs.com/registration/new
Once you've signed into SquareOffs, head back to Wordpress and enter your SquareOffs login information (email and password).

The SquareOffs Wordpress Plugin is now ready for use. You can now access the following pages in the left navigation:

1. SquareOffs - view, edit, or delete your SquareOffs and check their statistics.
1. Add New - create new SquareOffs outside of the WYSIWYG editor.
1. Comments - view and moderate comments.
1. Settings - customize SquareOffs colors, fonts, etc. to match your site and manage comment moderation settings.

You will now be able to easily create SquareOffs in your posts with the "Add SquareOff" button above the WYSIWYG editor. Enjoy!

== Frequently Asked Questions ==
= What is a SquareOff? =
A SquareOff is a piece of content publishers use to engage their audience and allow their readers to share their opinions. Each SquareOff contains a question and two sides. Readers vote for their side, and then comment WHY they voted for that side.

= Who can use SquareOffs? =
SquareOffs is great for digital publishers. From boutique bloggers to high traffic news websites, SquareOffs works with any topic, on any website. SquareOffs is also great for brands and agencies to use as a tool in their toolkit to increase brand engagement and loyalty.

= Where do SquareOffs live? =
SquareOffs can be placed on any website, just like a Youtube video. This makes it a great tool to embed within article content, or as a standalone page thus, creating user generated content.

= Where should publishers place SquareOffs on a website? =
This depends on your website, and how your readers interact on your page. Small SquareOffs work great embedded in-line within articles or right on your homepage. Polls Pages are a great to create a new landing page on your site that had not previously existed.

= Why use SquareOffs? =
SquareOffs is designed for digital publishers to create user-generated debate on any topic, on any website. From small bloggers to high traffic news sites, SquareOffs is a simple tool to increase engagement, revenue, traffic, and insight.

Further support:
http://support.squareoffs.com/

Other questions / comments? Reach out to:
info@squareoffs.com

Thanks!

== Changelog ==

= 4.2.3 =
* Tested up to 6.7

= 4.2.3 =
* Added 'allow="identity-credentials-get"' for Google Auth

= 2.2.1 =
* Added character count displays for SquareOffs questions and answers

= 2.2 =
* Increased the SquareOffs question character limit to 100 characters.
* Increased SquareOffs Answer character limit to 40 characters.
* Support SquareOffs being created without reequiring a cover photo
* Made the plugin always available even when its not yet connected to SquareOffs account
* Added Sign in / Create account step during creating of Squareoff if the plugin is yet not connected to the user account.
* Updated to show HTML code when editing as HTML both on Classic and Block Editor.
* Fixed issue with sizing of embed in certain scenarios
* Fixed iFrame not loading on non SSL domains.
* Fixed to work on older version of Wordpress.

= 2.1 =
* Fixes for adding a block in the Gutenberg editor

= 2.0 =
* Tested with Wordpress 5.4.2
* Updated to enable SquareOffs for the new Block Editor and support SquareOff cover photos.

= 1.1.0 =
* Tested with WordPress 4.9
* Allow creation of SquareOff with no end date.

= 1.0.0 =
* Initial release.
* Embed a small format SquareOff inline in your post or page.
* Embed a wide format SquareOff into your post or page as the content.
* Create a new SquareOff in either the WYSIWYG editor or from the navigation.
* Graphical representation of the shortcode in the Visual editor allows users to easily coordinate the layout of a post or page.
* Configure display settings, colors, font, social sharing, and more.

== Upgrade Notice ==

= 2.2.1 =
* Tested with Wordpress 5.7

= 2.2 =
* Tested with Wordpress 5.6

= 2.0.0 =
* Tested with Wordpress 5.4.2

= 1.1.0 =
* Tested with WordPress 4.9
