Description
Add SalesVu store “widgets” using the simple [salesvu]
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!). At a minimum you must supply the src
and script
parameters, e.g:
[salesvu src="https://www.salesvu.com/widget-url?storeid=000&etc" script="https://www.salesvu.com/widget-script-url/file.js"]
All Parameters:
| Parameter | Description | Unit | Example | Default |
| --------------------- | ---------------------------------------------------------- | ------ | -------------------------------------------------------------- | ----------------------------------------------------------------- |
| src | SalesVu Widget Store URL | url | src="https://www.salesvu.com/widget-url?storeid=000&etc" | โ ๏ธ required |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| script | SalesVu Widget Script URL | url | script="https://www.salesvu.com/widget-script-url/file.js" | โ ๏ธ required |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| width | Widget width | # (px) | width="500" | 100% |
| | | % | width="50%" | |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| height | Widget height | # (px) | height="800" | 800 |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| scrolling | Allow or disallow scrolling | yes | scrolling="yes" | yes |
| | | no | scrolling="no" | |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| frameborder | Show or hide the iframe border | show | frameborder="1" | 0 |
| | | hide | frameborder="0" | |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| marginheight | Height of the widget margin | # (px) | marginheight="10" | 0 |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| marginwidth | Width of the widget margin | # (px) | marginwidth="10" | 0 |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| id | Add an ID to the iframe | string | id="whatever" | tvoow |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| class | Add class(es) to the iframe | string | class="cheese fork broccoli" | |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| 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" | false |
| | | id | same_height_as="div#content" | |
| | | tag | same_height_as="main" | |
| | | false | same_height_as="false" | |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| any_other_param | Add an arbitrary HTML parameter(s) to the iframe | string | any_other_param="any_value" | |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
| any_other_empty_param | Add an "empty" HTML parameter(s) to the iframe | string | any_other_empty_param="allowfullscreen" | |
| _____________________ | __________________________________________________________ | ______ | ______________________________________________________________ | _________________________________________________________________ |
Installation
- Install and Activate the Plugin on the Plugins Admin page
- 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
Reviews
Contributors & Developers
“Embed SalesVu” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Embed SalesVu” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
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