=== StageShow === Contributors: Malcolm-OPH Donate link: https://www.corondeck.co.uk/StageShow/donate.html Tags: cart, payment, theater, theatre, tickets Requires at least: 3.0 Tested up to: 6.7.2 Stable tag: 10.0.3 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html StageShow adds the facility for an online Box-Office for Small Theatres/Drama Groups, records sales, validates tickets and provides sales downloads. == Description == StageShow provides a number of simple admin pages to allow the definition of Show names, Performance date and times and ticket Prices and types. Then a single Wordpress shortcode adds a online BoxOffice to your website. StageShow uses its own integrated Shopping Trolley to collect orders, and a "Payment Gateway" to collect payments, allowing purchasers to pay using a credit/debit card. StageShow records sales and to collects buyer information from the gateway. See thebFeatures Summary below for full details). Each sale is fully recorded, with contact and payment details, tickets purchased and the transaction reference from the payment gateway, all saved to the Wordpress database. Confirmation emails containing these details, which can be customised as required, are sent to each purchaser and can be copied to the system administrator. Emails use the MIME encoded email format which allows fonts, images etc. to be defined in the email template. StageShow includes the facility on the admin pages to verify the transaction number for use at show time. Sales can also be exported to a "TAB Separated Text" file to produce a printed sales list, or for further processing by other applications (i.e. Spreadsheets etc.). StageShow Features Summary * No limit on number of Shows or Performances * Unlimited number of Ticket Types for each performance * Unlimited user defined "Price Plans" to set prices when adding a performance * "Admin Only" ticket prices (only available via Admin menus) * Discounted Tickets/Discount Codes * Allocated Seating * Customisable Seating Layouts * Optional ticket Reservations for logged in users (i.e. Unpaid ticket sales) * Reservation Client Details captured from Users Profile * Integrated Shopping Trolley * Integrated Payment PayPal, PayFast, Stripe or Mollie Payment Gateways * Payments accepted using Credit/Debit cards * EMail confirmation of Booking to Client and (optionally) to Administrator * MIME Encoded EMails so HTML/Text mixed format emails supported * Barcode or QR Code of Transaction ID in sale confirmation emails * Logging of Online Ticket Validation attempts * Multiple Terminal Support for Verification * Editing of Sale Entries * Show title output on Box Office page customisable per show (text/HTML) * Customisable Performance titles on Box Office page per performance (text/HTML) * Optional sales summary EMail (to a specified email address) on each new sale * Booking Closing Time can be specified for each performance * Custom Style Sheets * Manual entry of ticket sales for telephone sales etc. * Online and Offline Sale Transaction ID validation * Export of Ticket Sales and Settings as "TAB Separated Text" format file * Access to StageShow Admin pages/features controlled by custom capabilities * Requires registration with a supported Payment Gateway * Extensive Help (in PDF format) file shipped with plugin == Installation == First Time Installation * Download the plugin archive * Open the Wordpress Dashboard for your site * Click "Add New" under the "Plugins" menu * Select the "Upload Plugin" option * Under "Install a plugin in .zip format" browse to the plugin archive file you downloaded * Click Install Now. * After it has installed, activate the plugin. Manual Upgrade/Update * On the WP Plugins Page deactivate (but do NOT delete) the current StageShow plugin * Using FTP (or your ISPs file manager) delete the current stageshow plugin folder in the wp-content/plugins folder * Now Proceed as for the First Time Installation == Frequently Asked Questions == = How do I get help? = * Read these FAQs * Read the documentation * Contact the plugin author here. Requests for help that are already well documented may get a sharp response! = How do I set up StageShow? = * Install the plugin and activate it * Go to the StageShow - Settings page and enter your payment gateway details and click "Save Settings" * Now go to the show, performance and prices pages and set up your show! * Create a page on your website for the Box Office (or edit an existing one) and add the tag [sshow-boxoffice] to it = What PayPal settings are required? = PayPal API Access must be enabled - and the associated User, Password, Signature and EMail entries added to "Stageshow" settings. IPN (Instant Payment Notification) must be enabled for Sales to be recorded by the PlugIn. Payment will still be accepted and the sale will be recorded by PayPal if IPN is disabled. Set the "IPN Listener" URL to https://{Your Site URL}/wp-content/plugins/stageshow/stageshow_NotifyURL.php. = Why can't I edit the PayPal settings? = PayPal Login details cannot be changed if one or more performance entries are present. The StageShow plugin creates a PayPal "Saved Button" when a performance is added to the show. There is currently no mechanism to recreate these buttons if the PayPal configuration is changed, hence the limitation. = What WordPress settings are required? = StageShow needs the WordPress setting of TimeZone to be correctly set-up (i.e. to a City) for time-sensitive functionality to operate correctly. The current value can be found on the Settings->General admin page. = Why can't I delete a show or performances? = A performance cannot be deleted if there are sales recorded for it and the show start time has not yet been reached. A show cannot be deleted if performances are still configured for it. = How do I add a Booking Form to my site? = Add the tag [sshow-boxoffice] to either a new or existing page on your site. This will be replaced by the booking form when the page is viewed by a user. = Do my purchasers have to have a PayPal account? = No. Turning on the "PayPal Account Optional" setting on the sellers PayPal account allows purchasers to use a Credit or Debit card without the need for a PayPal account. Details are in the StageShow help file. = How can I customise the EMails? = The EMails generated by the StageShow plugin are defined by a template file. Template defaults are in the {Plugins Folder}/{Plugin Name}/templates/email folder, which is copied to the {Uploads Folder}/stageshow/email when the plugin is Activated or Updated. The default email template is stageshow_EMail.php. The default template can be copied to new a file in the uploads folder, which can then be used to create a custom template, which can then in turn be selected using the Admin->Settings page. The template file can be modified as required. A number of "Tags" can be included in the EMail template, which will be replaced by data relating to the sale extracted from the database. = What tags can be used in the EMail template? = The following tags can be used in the EMail template: * [salePPName] Buyer PayPal Account Details: Name * [salePPStreet] Buyer PayPal Account Details: Street * [salePPCity] Buyer PayPal Account Details: City * [salePPState] Buyer PayPal Account Details: State * [salePPZip] Buyer PayPal Account Details: Zip/Post Code * [salePPCountry] Buyer PayPal Account Details: Country * [saleDateTime] Sale Details: Date and Time * [saleName] Sale Details: Buyer Name * [saleEMail] Sale Details: Buyer EMail * [salePaid] Sale Details: Paid * [saleTxnId] Sale Details: PayPal Transaction ID (TxnId) * [saleStatus] Sale Details: PayPal Transaction Status * [saleBarcode] Sale Details: PayPal Transaction ID converted to a Barcodes (Only for StageShow+) * [startloop] Marker for the start of a loop for each ticket type purchased * [endloop] Marker for the end of the loop * [ticketName] Sale Details: Ticket Name * [ticketType] Sale Details: Ticket Type ID * [ticketQty] Sale Details: Ticket Quantity * [organisation] The Organsiation ID (as on the Settings Page) * [adminEMail] The Admin EMail (as on the Settings Page) * [url] The Site Home Page URL = How can I use my own images on the Checkout page? = Default Images in the {Plugins Folder}/{Plugin Name}/templates/images folder are copied to the {Uploads Folder}/{Plugin Name}/images when the plugin is Activated or Updated. Custom images can be copied to this folder (using FTP) and can then be selected using the Admin->Settings page. = Where is the User Guide? = A copy of the User Guide, as a pdf file, is included with StageShow distributions. This can be accessed via a link on the Overview page. The User Guide can also be downloaded or viewed here. == Screenshots == 1. Screenshot 1: Overview Page 2. Screenshot 2: Seating Plans Setup 3. Screenshot 3: Discount Codes Setup 4. Screenshot 4: Shows Setup 5. Screenshot 5: Price Plans Setup 6. Screenshot 6: Performances Setup 7. Screenshot 7: Performances Setup (Showing Options) 8. Screenshot 8: Ticket Types and Prices Setup 9. Screenshot 9: Sales Log Summary 10. Screenshot 10: Sales Log Summary (Showing Details) 11. Screenshot 11: Admin Tools Page (Showing Sale Verification) 12. Screenshot 12: PayPal Settings Page 13. Screenshot 13: General Settings Page 15. Screenshot 14: Advanced Settings Page 16. Screenshot 15: Reservations Settings Page 17. Screenshot 16: Shows Box Office Page 18. Screenshot 17: Calendar View Page 19. Screenshot 18: Select Seats Page 20. Screenshot 19: Sample EMail == Changelog == = 10.0.3 (28/03/2025) = * Bug Fix: 404 Error on redirect to Payment Gateway = 10.0.2 (24/03/2025) = * Version No Updated to resolve v10.0.1 Upload Error = 10.0.1 (23/03/2025) = * Bug Fix: Manual entry or editing of sales * Bug Fix: Add Price Plan not adding Seating Plan * Bug Fix: Undefined variable $jscode (since 10.0) * Fixed Float to Int Warning displaying barcode * Stripe php library updated = 10.0 (20/03/2025) = * Security Update * Added check for "rogue"