{"id":131500,"date":"2020-11-20T22:19:33","date_gmt":"2020-11-20T22:19:33","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/swidget-for-cmp\/"},"modified":"2023-07-17T19:17:30","modified_gmt":"2023-07-17T19:17:30","slug":"swidget-for-cmp","status":"publish","type":"plugin","link":"https:\/\/cn.wordpress.org\/plugins\/swidget-for-cmp\/","author":18325130,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.11.0","stable_tag":"trunk","tested":"6.0.11","requires":"4.1.0","requires_php":"5.2","requires_plugins":null,"header_name":"SWidget for CMP","header_author":"Carnegie Museums of Pittsburgh","header_description":"Siriusware Widget for Carnegie Museusms of Pittsburgh","assets_banners_color":"9db3b5","last_updated":"2023-07-17 19:17:30","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/CMP-Studio\/swidget-cmp","header_author_uri":"http:\/\/www.carnegiemuseums.org","rating":0,"author_block_rating":0,"active_installs":0,"downloads":1731,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","faq","changelog"],"tags":{"1.10.0":{"tag":"1.10.0","author":"heimanj","date":"2023-03-20 21:04:38"},"1.11.0":{"tag":"1.11.0","author":"heimanj","date":"2023-07-17 19:17:30"},"1.3.3":{"tag":"1.3.3","author":"heimanj","date":"2020-11-30 22:49:08"},"1.4.0":{"tag":"1.4.0","author":"heimanj","date":"2021-02-22 19:32:23"},"1.5.0":{"tag":"1.5.0","author":"heimanj","date":"2021-09-13 15:52:04"},"1.6.0":{"tag":"1.6.0","author":"heimanj","date":"2022-06-07 18:07:35"},"1.7.0":{"tag":"1.7.0","author":"heimanj","date":"2022-08-16 15:36:03"},"1.8.0":{"tag":"1.8.0","author":"heimanj","date":"2022-08-25 17:48:58"},"1.8.1":{"tag":"1.8.1","author":"heimanj","date":"2022-08-25 20:23:08"},"1.9.0":{"tag":"1.9.0","author":"heimanj","date":"2022-11-17 19:20:58"},"1.9.1":{"tag":"1.9.1","author":"heimanj","date":"2022-12-16 15:47:59"}},"upgrade_notice":{"1.6.0":"<p>Added maintenance-mode setting and <code>swaddtocarttimed_firstga<\/code> shortcode<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":2423899,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":2423899,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.10.0","1.11.0","1.3.3","1.4.0","1.5.0","1.6.0","1.7.0","1.8.0","1.8.1","1.9.0","1.9.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2422578,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2422578,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"One instance of the plugin in use for the Carnegie Science Center","2":"Two instances of the plugin in use for CMANH"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[282,80,193266],"plugin_category":[43,45],"plugin_contributors":[193267,193268],"plugin_business_model":[],"class_list":["post-131500","plugin","type-plugin","status-publish","hentry","plugin_tags-ecommerce","plugin_tags-shortcode","plugin_tags-siriusware","plugin_category-customization","plugin_category-ecommerce","plugin_contributors-heimanj","plugin_contributors-jgordoncmp","plugin_committers-heimanj"],"banners":{"banner":"https:\/\/ps.w.org\/swidget-for-cmp\/assets\/banner-772x250.png?rev=2423899","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/swidget-for-cmp\/assets\/icon-256x256.png?rev=2423899","icon_2x":"https:\/\/ps.w.org\/swidget-for-cmp\/assets\/icon-256x256.png?rev=2423899","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/swidget-for-cmp\/assets\/screenshot-1.png?rev=2422578","caption":"One instance of the plugin in use for the Carnegie Science Center"},{"src":"https:\/\/ps.w.org\/swidget-for-cmp\/assets\/screenshot-2.png?rev=2422578","caption":"Two instances of the plugin in use for CMANH"}],"raw_content":"<!--section=description-->\n<p>Allows the site of the Carnegie Museums of Pittsburgh to display Siriusware widgets using shortcodes.  See below for descriptions of these shortcodes.<\/p>\n\n<h3>Shortcodes<\/h3>\n\n<h4>Add to Cart<\/h4>\n\n<pre><code>[swaddtocart site=\"siteID\" item=\"itemID\"]   \n<\/code><\/pre>\n\n<h4>Quick Checkout<\/h4>\n\n<pre><code>[swcheckout site=\"siteID\" item=\"itemID\"]\n<\/code><\/pre>\n\n<h4>Add to Cart Timed<\/h4>\n\n<pre><code>[swaddtocarttimed site=\"siteID\" group=\"groupCode\"]   \n<\/code><\/pre>\n\n<h4>Quick Checkout Timed<\/h4>\n\n<pre><code>[swcheckouttimed site=\"siteID\" group=\"groupCode\"]\n<\/code><\/pre>\n\n<h4>Add to Cart Timed (auto-select earliest GA)<\/h4>\n\n<pre><code>[swaddtocarttimed_firstga site=\"siteID\" group=\"groupCode\"]  \n<\/code><\/pre>\n\n<p><em>Automatically selects a date\/time to match or be after the earliest General Admission present in the cart<\/em><\/p>\n\n<h4>1-Click Add to Cart<\/h4>\n\n<pre><code>[swoneclickaddtocart site=\"siteID\" item=\"itemID\" mod=\"modID\"]  \n<\/code><\/pre>\n\n<p>Optional parameter <code>date=\"YYYYMMDD\"<\/code> should only be used for timed items.<br \/>\n<em>Note: timed items use the item ID of the timeslot, NOT the group ID.<\/em><\/p>\n\n<h4>1-Click Checkout<\/h4>\n\n<pre><code>[swoneclickcheckout site=\"siteID\" item=\"itemID\" mod=\"modID\"]  \n<\/code><\/pre>\n\n<p>Optional parameter <code>date=\"YYYYMMDD\"<\/code> should only be used for timed items.<br \/>\n<em>Note: timed items use the item ID of the timeslot, NOT the group ID.<\/em><\/p>\n\n<h4>Multi-Item Add to Cart<\/h4>\n\n<pre><code>[swmulticart site=\"siteID\" items=\"itemsString\"]  \n<\/code><\/pre>\n\n<p><em>Desplays a series of items as a drop-down menu.  \"items\" expects a comma-delimited list of Siriusware item IDs.<\/em><\/p>\n\n<h4>Multi-Item Quick Checkout<\/h4>\n\n<pre><code>[swmulticheckout items=\"itemsString\"]  \n<\/code><\/pre>\n\n<p>Optional parameter <code>site=\"siteID\"<\/code><br \/>\n<em>Desplays a series of items as a drop-down menu.  \"items\" expects a comma-delimited list of Siriusware item IDs.<\/em><\/p>\n\n<h4>Cart<\/h4>\n\n<pre><code>[swcart site=\"siteID\"]   \n<\/code><\/pre>\n\n<h4>Gift Card Balance Check<\/h4>\n\n<pre><code>[swcardbalance]   \n<\/code><\/pre>\n\n<h3>Options Reference<\/h3>\n\n<p>All options can be managed on the WordPress admin page for the swidget plugin.<\/p>\n\n<h4>Item Widgets:<\/h4>\n\nGeneral\n\n<ul>\n<li><strong>Date Format<\/strong> (<code>sw_date_format<\/code>) - How dates are displayed in placeholders.  Uses the moment.js library.  <a href=\"http:\/\/momentjs.com\/docs\/#\/displaying\/format\/\">Info on formats found here<\/a><\/li>\n<li><strong>Low Qty<\/strong> (<code>sw_low_qty<\/code>) - The point when the <em>low quantity<\/em> message shows<\/li>\n<li><strong>Radio Button Cutoff for Timed Items<\/strong> (<code>sw_radio_cutoff<\/code>) - the maximum number before the input changes to dropdown<\/li>\n<li><strong>Display Product Name<\/strong> (<code>sw_display_product_name<\/code>) - Show the name of the product (defaults to Yes)<\/li>\n<li><strong>Open checkout in new tab<\/strong> (<code>sw_open_tab<\/code>) - Open the checkout page in a new tab\/window<\/li>\n<li><strong>Display checkout link after adding items<\/strong> (<code>sw_display_checkout_link<\/code>)<\/li>\n<li><strong>Fill all dates for timed items<\/strong> (<code>sw_fill_dates<\/code>)<\/li>\n<li><strong>Show time selector if only one option<\/strong> (<code>sw_show_only_one_time<\/code>)<\/li>\n<li><strong>Show *.00 decimal points<\/strong> (<code>sw_hide_price_decimal<\/code>)<\/li>\n<li><strong>Pre-Selected Date<\/strong> (<code>sw_pre_selected_date<\/code>) - A date to be pre-selected from the drop-down menu, in <code>YYYY-MM-DD<\/code> format (timed ticketing)<\/li>\n<li><strong>Pre-Selected Time<\/strong> (<code>sw_pre_selected_time<\/code>) - A time to be pre-selected from the drop-down menu\/radio buttons,  in <code>H:mm<\/code> format (timed ticketing)<\/li>\n<li><strong>Override-Price Start<\/strong> (<code>sw_overrideprice_start<\/code>) - Date to begin overriding price, in <code>YYYY-MM-DD<\/code> format (timed ticketing)<\/li>\n<li><strong>Override-Price End<\/strong> (<code>sw_overrideprice_end<\/code>) - Date to end overriding price, in <code>YYYY-MM-DD<\/code> format (timed ticketing)<\/li>\n<\/ul>\n\nMessages\n\n<ul>\n<li><strong>Loading<\/strong> (<code>sw_msg_loading<\/code>) - The message that displays while the tickets are loading<\/li>\n<li><strong>Not yet on sale<\/strong> (<code>sw_msg_too_early<\/code>) - Message displayed if the product is not yet available to purchase<\/li>\n<li><strong>Offline sales only<\/strong> (<code>sw_msg_offline_only<\/code>) - Message displayed when the item is available to be sold in Siriusware but <em>not<\/em> with e-commerce<\/li>\n<li><strong>Site Maintenance<\/strong> (<code>sw_msg_maintenance<\/code>) - The message that is displayed when the site is undergoing maintenance<\/li>\n<li><strong>Expired<\/strong> (<code>sw_msg_expired<\/code>) - The message that is displayed when the item is no longer on sale<\/li>\n<li><strong>Low Quantity<\/strong> (<code>sw_msg_low_qty<\/code>) - The message that displays when there is low quantity<\/li>\n<li><strong>Sold Out<\/strong> (<code>sw_msg_sold_out<\/code>) - The message that displays when the item is sold out<\/li>\n<li><strong>Add To Cart<\/strong> (<code>sw_msg_add_to_cart<\/code>) - A message for when an item is added to cart (Note: only for swaddtocart widgets)<\/li>\n<\/ul>\n\nText Modification\n\n<ul>\n<li><strong>Free<\/strong> (<code>sw_txt_free<\/code>) - The text to display when an item is free (Replaces $0.00).<\/li>\n<li><strong>Additional Fee<\/strong> (<code>sw_txt_fee<\/code>) - The text for additional fees<\/li>\n<li><strong>Checkout Button<\/strong> (<code>sw_txt_checkout<\/code>) - The text for the <em>quick<\/em> checkout button<\/li>\n<li><strong>Checkout Button (Free item)<\/strong> (<code>sw_txt_free_checkout<\/code>) - This replaces the <em>quick<\/em> checkout text if all items in the widget are free<\/li>\n<li><strong>Add to Cart Button<\/strong> (<code>sw_txt_add_to_cart<\/code>) - Text for the add-to-cart widget's checkout button<\/li>\n<li><strong>Checkout Link<\/strong> (<code>sw_txt_checkout_link<\/code>) - The text to display as the checkout link<\/li>\n<li><strong>Discount<\/strong> (<code>sw_txt_discount<\/code>) - The text for discounts<\/li>\n<li><strong>Member Discount<\/strong> (<code>sw_txt_member_discount<\/code>) - The text to show how much one would pay if they are a member<\/li>\n<li><strong>Member Exclusive<\/strong> (<code>sw_txt_members_only<\/code>) - The text to indicate that an item is for members only<\/li>\n<li><strong>Select New Date<\/strong> (<code>sw_txt_select_new_date<\/code>) - The label text for the date selector (timed ticketing)<\/li>\n<li><strong>Select New Time<\/strong> (<code>sw_txt_select_new_time<\/code>) - The label text for the time selector (timed ticketing)<\/li>\n<li><strong>Select New Item<\/strong> (<code>sw_txt_select_new_item<\/code>) - The label text for the item selector (multi-item)<\/li>\n<li><strong>Date Dropdown Placeholder<\/strong> (<code>sw_txt_date_dropdown_placeholder<\/code>) - The default text for the date selector (timed ticketing)<\/li>\n<li><strong>Time Dropdown Placeholder<\/strong> (<code>sw_txt_time_dropdown_placeholder<\/code>) - The default text for the time selector (timed ticketing)<\/li>\n<li><strong>Item Dropdown Placeholder<\/strong> (<code>sw_txt_item_dropdown_placeholder<\/code>) - The default text for the item selector (multi-item)<\/li>\n<li><strong>Pay What you Wish Placeholder<\/strong> (<code>sw_txt_pay_what_you_wish<\/code>) - The default text for the pay what you wish message<\/li>\n<\/ul>\n\n<h4>Cart Widgets<\/h4>\n\nGeneral\n\n<ul>\n<li><strong>Open checkout in new tab<\/strong> (<code>sw_open_tab<\/code>) - Open the checkout page in a new tab\/window<\/li>\n<li><strong>Display dates for timed items in cart<\/strong> (<code>sw_display_timed_dates_in_cart<\/code>)<\/li>\n<\/ul>\n\nMessages\n\nText Modification\n\n<ul>\n<li><strong>Checkout Button<\/strong> (<code>sw_txt_cart<\/code>) - The text for the cart widget's checkout button<\/li>\n<\/ul>\n\n<h3>Placeholders<\/h3>\n\n<p>Place holders are a special string which will be replace with information from the item.  They can be used in any of the above options.<\/p>\n\n<ul>\n<li><code>#{stock}<\/code> - How many tickets are remaining<\/li>\n<li><code>#{name}<\/code> - The name of the ticket<\/li>\n<li><code>#{start_sale}<\/code> - When the tickets go on sale<\/li>\n<li><code>#{end_sale}<\/code> - When the tickets go off sale (both online and offline)<\/li>\n<\/ul>\n\n<h3>Options Hierarchy<\/h3>\n\n<p>The following is the priority of where the widget gets its settings from (lower numbers trump higher numbers)<\/p>\n\n<ol>\n<li>Options passed with the shortcode<\/li>\n<li>Options set in WP admin<\/li>\n<li>Default settings from the widget itself<\/li>\n<\/ol>\n\n<h3>Message Hierarchy<\/h3>\n\n<p>The following is the priority of the messages<\/p>\n\n<ol>\n<li>Past sale end<\/li>\n<li>Sold Out<\/li>\n<li>Offline sales only<\/li>\n<li>Prior to sale start<\/li>\n<li>[No message, ticket can be sold]<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='who%20is%20this%20plugin%20designed%20for%3F'><h3>Who is this plugin designed for?<\/h3><\/dt>\n<dd><p>The webmasters of the four Carnegie Museums of Pittsburgh can can use this plugin on their WordPress sites to sell tickets for their various offerings.<\/p><\/dd>\n<dt id='what%20does%20this%20plugin%20actually%20do%3F'><h3>What does this plugin actually do?<\/h3><\/dt>\n<dd><p>It adds shortcodes to WordPress that will render the specified ecommerce item\/group\/cart on the page (via empty divs and jQuery commands).<\/p><\/dd>\n<dt id='does%20it%20use%20any%20external%20libraries%3F'><h3>Does it use any external libraries?<\/h3><\/dt>\n<dd><p>Other than WordPress' installation of jQuery and our own self-hosted JavaScript file, the plugin includes and makes use of <a href=\"https:\/\/momentjs.com\/\">Moment.js<\/a> for date handling and  <a href=\"https:\/\/github.com\/pippinsplugins\">Pippin Williamson<\/a>'s <a href=\"https:\/\/github.com\/easydigitaldownloads\/Easy-Digital-Downloads\/blob\/master\/includes\/class-edd-session.php\">EDD_Session class<\/a> for session handling.<\/p><\/dd>\n<dt id='can%20i%20use%20this%20plugin%20for%20other%20purposes%3F'><h3>Can I use this plugin for other purposes?<\/h3><\/dt>\n<dd><p>Sure, if it will help you out.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.11.0<\/h4>\n\n<ul>\n<li>Added override-price start\/end options<\/li>\n<\/ul>\n\n<h4>1.10.0<\/h4>\n\n<ul>\n<li>Added <code>Show *.00 decimal points<\/code> option<\/li>\n<\/ul>\n\n<h4>1.9.1<\/h4>\n\n<ul>\n<li>Bug fix for <code>swaddtocarttimed_firstga<\/code> functionality<\/li>\n<\/ul>\n\n<h4>1.9.0<\/h4>\n\n<ul>\n<li>Added <code>swmulticart<\/code> and <code>swmulticheckout<\/code> shortcodes and functionality<\/li>\n<\/ul>\n\n<h4>1.8.1<\/h4>\n\n<ul>\n<li>Removed \"Max Displayed Qty\" option (in favor of item-specific settings) <\/li>\n<\/ul>\n\n<h4>1.8.0<\/h4>\n\n<ul>\n<li>Added \"Max Displayed Qty\" option<\/li>\n<\/ul>\n\n<h4>1.7.0<\/h4>\n\n<ul>\n<li>Added <code>swcardbalance<\/code> shortcode and functionality<\/li>\n<\/ul>\n\n<h4>1.6.0<\/h4>\n\n<ul>\n<li>Added maintenance-mode setting<\/li>\n<\/ul>\n\n<h4>1.5.0<\/h4>\n\n<ul>\n<li>Added <code>swaddtocarttimed_firstga<\/code> shortcode and functionality<\/li>\n<li>Added support for pre-selected dates\/times for timed ticketing<\/li>\n<\/ul>\n\n<h4>1.4.1<\/h4>\n\n<ul>\n<li>Reorganized Settings page<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>Added 1-click shortcodes<\/li>\n<li>Added a \"Display dates for timed items in cart\" option<\/li>\n<\/ul>\n\n<h4>1.3.3<\/h4>\n\n<ul>\n<li>Clarification of PHP session-handling behavior<\/li>\n<\/ul>\n\n<h4>1.3.2<\/h4>\n\n<ul>\n<li>Further changes to generic names<\/li>\n<\/ul>\n\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>Added namespace, session sanitation\/validation and replace CURL with HTTP API<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>First version designed for the WordPress Plugins directory<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Better error handling (and falls back to PHP sessions if EDD class not present)<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Adding Pay What You Wish setting<\/li>\n<\/ul>","raw_excerpt":"Allows the site of the Carnegie Museums of Pittsburgh to display Siriusware widgets using shortcodes.  See below for descriptions of these shortcodes.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/131500","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=131500"}],"author":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/heimanj"}],"wp:attachment":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=131500"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=131500"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=131500"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=131500"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=131500"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=131500"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}