gnowland/embed-salesvu

A WordPress Plugin for adding SalesVu store 'widgets' (iframes) to your website with a simple Shortcode.

v1.0.2 2020-11-30 09:12 UTC

Requires

• php: >=5.4.0
• composer/installers: ~1.0

GPL-3.0-or-later

• Gifford Nowland

• shop
• plugin
• wordpress
• store
• iframe
• embed
• shortcode
• reservations
• wordpress plugin
• salesvu
• e-store

README

A WordPress Plugin for adding SalesVu store "widgets" to your website with a simple Shortcode.

💭 Rationale

WordPress removes <iframe> and <script> HTML tags for a variety of security reasons.

⚠️ HTTP(S)

Important: Your site must be using HTTPS! You cannot embed secure SalesVu store pages into an insecure HTTP website.

👾 Parameters

Embed SalesVu accepts the same parameters as the <iframe> html tag (plus some extras!):

Parameter	Description	Example	Default
src	SalesVu Widget Store URL	URL: src="https://www.salesvu.com /widget-url?storeid=000&etc"	N/A
script	SalesVu Widget Script URL	URL: script="https://www.salesvu.com /widget-script-url/file.js"	N/A
width	Widget width	Pixels: width="500" Percent: width="100%"	100%
height	Widget height	Pixels: height="800"	800
scrolling	Allow or disallow scrolling	Allow: scrolling="yes" Disallow: scrolling="no"	yes
frameborder	Show or hide the <iframe> border	Show: frameborder="1" Hide: frameborder="0"	0
marginheight	Height of the margin	Pixels: marginheight="10"	0
marginwidth	Width of the margin	Pixels: marginwidth="10"	0
id	Add an ID to the <iframe>	String: id="anything"	tvoow
class	Add classes to the <iframe>	String: class="class1 class2"	N/A
style	Add CSS styles to the <iframe>	String: style="margin: 30px; padding: 20px;"	border: none; overflow: visible; width: 100%; background: #FFF;
same_height_as	Set the height of the <iframe> to the same as target element	Class: same_height_as="div.sidebar" ID: same_height_as="div#content" Tag: same_height_as="body"	false
any_other_param	Add an arbitrary parameter to the <iframe>	String: any_other_param="any_value"	N/A
any_other_empty_param	Add an empty parameter to the <iframe>	String: any_other_empty_param ="allowfullscreen"	N/A

Changelog

1.0.2

• Docs: Fixed readme parameters table

1.0.1

• Docs: Add installation instructions and changelog to README
• Docs: Added Parameters and HTTPS warning to README
• Cleanup: Remove unsupported allowtransparency tag from parameters
• Bugfix: Allow both ID & Classes in same_height_as
• Improvements: Increase default height to 800px

1.0.0

• Initial Release

Installation

1. Install and Activate the Plugin on the Plugins Admin page
2. Add shortcode [salesvu src="https://www.salesvu.com/widget-url?storeid=000&etc=etc" script="https://www.salesvu.com/widget-script-url/file.js"] to page or post content