=== Official Topspin Wordpress Plugin === Contributors: theuprising Donate link: http://theuprisingcreative.com/ Tags: Topspin,store,merchandise,shop,music Tested up to: 3.5 Stable tag: 4.0.7 Requires at least: 3.0.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Quickly, easily integrate Topspin Offers into customized, dynamically generated Store Pages; recoded and optimized for better Wordpress integration. == Description == [Installation](https://github.com/topspin/topspin-wordpress/wiki/Installation) [Upgrading](https://github.com/topspin/topspin-wordpress/wiki/Upgrading) [Managing Stores](https://github.com/topspin/topspin-wordpress/wiki/Managing-Stores) [Template Customization](https://github.com/topspin/topspin-wordpress/wiki/Template-Customization) [Frequently Asked Questions](https://github.com/topspin/topspin-wordpress/wiki/Frequently-Asked-Questions) [Roadmap](https://github.com/topspin/topspin-wordpress/wiki/Roadmap) [Changelog](https://github.com/topspin/topspin-wordpress/wiki/Changelog) Developed by [The Uprising Creative](http://theuprisingcreative.com) This plugin is open-source and we offer limited support. If you do have an issue or question, please [open a GitHub issue](https://github.com/topspin/topspin-wordpress/issues) and we'll work to help you out when time allows. *PLEASE NOTE: This plugin is meant to be customized! It will work "out of the box" with just about any theme, but it may not match your site or be as "pretty" as you'd like. Additionally, if your theme uses featured images in the header of posts, you may have to make adjustments to ensure the display of the products is to your liking.* This plugin allows novice and pro Topspin users alike to quickly and easily create integrated, customized, sortable and dynamically generated stores from their Topspin Offers in a few minutes. The plugin allows for the creation of any number of individual Store Pages and configurations of Topspin Offers based on Offer Types and Tags. Store Pages can be restricted to specific Offer Type(s) and/or Tag(s) and can then be sorted by Offer Type(s), Tag(s), or Manually using a new drag-and-drop admin interface. This new version of the plugin has been recoded from scratch to offer better performance and scalability, better integration with Wordpress post types, allows for better deep linking to individual products, support for multiple artists and Wordpress Multi Site, and much more. Although these pages are called Store Pages, they aren't restricted to just the Buy Button Offer Type. You can create dynamic pages featuring Buy Buttons, Email For Media Widgets, Streaming Player Widgets, Single Track Player Widgets, and any combination of them. (For example, a Store Page can be created that lists all Buy Buttons. A second Store Page can be created that lists Streaming Players, or some manually sorted combination of Email-For-Media Widgets, Streaming Players, and Buy Buttons. A third Store Page can be created that lists only Buy Buttons with the Apparel tag, effectively creating an Apparel sub-category for the main store. Since Tags are custom and manually created, you can group your products in an way that works for your individual needs, such as Featured Items, On-Sale Items, etc.) In addition to automatically creating Store Pages, Shortcodes are also generated for each Store Page that allow it's contents to be embedded on any other Page or Post. Shortcodes are also generated for individual offers, allowing any offer to be embedded in any post on your site. The possibilities are endless. (This new version of the Official Topspin Wordpress Plugin is a complete rebuild from the ground up, simplified and optimized to make launching an integrated Topspin Wordpress store in minutes. *This plugin is in active development and more features will be added regularly. If you have a feature request or find a bug, please report it! Please see the Roadmap for more information.*) = Requirements = * Topspin Artist Account ([Sign up for a new account!](http://topspinmedia.com)) * PHP 5.0 or higher * MySQL 5.0 or higher = Live Examples = * [Beastie Boys](http://shop.beastieboys.com) * [Circa Survive](http://circasurvive.com/shop/) * [Black Rebel Motorcycle Club](http://blackrebelmotorcycleclub.shopfirebrand.com) = Features = * Automatic Store Page creation based on Offer Types and Tags * Display of Offers in some or all Offer Types and/or Tag groups * Sorting by Offer Type(s), Tag(s), or Manually via the drag-and-drop admin interface * Ability to select the # of columns for each Store Page from 1-6 * Ability to select the # of Offers to display on each page for Pagination * Ability to set a Featured Item for each Store Page * Customizable store name and slug * Shortcodes for both Store and individual Featured Item content * Immediate output of fully functional Store Pages will little or no CSS or Template customization (novice) * Fully customizable Template and CSS files (pro) * New template tags available to display additional images and/or descriptions in the product grid * Ability for multiple Featured Items on a store page * Ability to embed individual items into any post on the site using new Individual Item Shortcodes * Additional Image added to display inside the More Info Lightbox (see notes) * Ability to link directly to and share an Individual Item's More Info Lightbox using new individual item Google-indexable hash-based permalinks (see notes) = New Features for v4.0 = * Completely rebuilt from the ground up for better performance and Wordpress integration * Individual products, offers and stores are created as Wordpress posts in a custom post type, allowing for better integration, deep linking, SEO indexing, and performance * Ability to sync and create stores for multiple artists under one install * Support for Wordpress Multi Site installs * API Prefetching (optional) * Product images are now cached in the Media Library for use elsewhere on the site * Ability to customize the custom post types used for offers, stores, and products * Ability to mark items On Sale or New with automatic timeouts * Ability to manually sync artists and offers * Ability to create a navigation menu using a drag-and-drop interface == Installation == Please chek out the [Installation Wiki](https://github.com/topspin/topspin-wordpress/wiki/Installation) for a full guide on setting up your WordPress Topspin store. == Usage == Please check out [GitHub page](https://github.com/theuprising/topspin-wordpress) for full usage documentation. == Frequently Asked Questions == Please refer to our [Wiki](https://github.com/topspin/topspin-wordpress/wiki/Frequently-Asked-Questions) for the FAQ's. == Screenshots == 1. Plugin Admin -> Settings Page 2. Plugin Admin -> Offers Listings 3. Plugin Admin -> Stores Listings 4. Plugin Admin -> Edit/Create Store Page 5. Plugin Admin -> Stores Nav Menu Editor 6. Front-End -> View of an out-of-the-box Store Page with a 3 column display and a Featured Item 7. Front-End -> View of a Store Page's "More Details" Colorbox overlay 8. Front-End -> View of the Topspin Checkout Flow overlay == Upgrade Notice == = 4.0.1 = * This fixes several issues for version 3.0 plugin users who are upgrading to 4.0. == Changelog == = 4.0.7 = * Updated the admin to display non-editable fields for cached metadata. * Fixed some PHP warnings. = 4.0.6 = * Bug fix: purge old unattached thumbnail files = 4.0.5 = * Fixed Artists and Offers not updating thumbnail meta data. * Allowed tickets stock to bypass the sold-out check. * Several PHP warning fixes. * Other minor bug fixes. = 4.0.4 = * Updated PHP docblocks. * Fixed ts_the_embed_code() and ts_get_the_embed_code(). * Fixed Group Panel features bug. * Several bug fixes. = 4.0.3 = * Added the ability to change the default grid thumb size (for narrow or wider templates) = 4.0.2 = * Added the ability to group panels * Added the ability to disable the WP admin bar shortcut * Fixed some PHP warnings = 4.0.1 = * Legacy store bug fixes * Fixed some PHP warnings = 4.0.0 = * Complete rewrite from the ground-up for performance increases and better Wordpress integration * Sync multiple artists * Stores, and Offers are now pulled in as WordPress custom post types * Products are now pulled into Wordpress * Inventory for products is now displayed in the CMS * New item tags (site level) * On Sale item tags (store level) * API prefetching (advanced settings) * Photos are now cached into the WordPress Media Library * Spin Tags are pulled in as a custom taxonomy made available for the new Offers custom post type * Wordpress Multi Site support * Improved WP-Cron integration * Ability to resync an individual offer (via Edit Offer) * Individual offer page templates * A wide array of various bug fixes = 3.3.3.3 = * Fixed lightbox handler with auto-filled anchor tags - @ezmiller = 3.3.3.2 = * Fixed JS handler to work with auto-filled anchor tags - @ezmiller * Fixed Topspin_Store::getItem() multiple tag bug - @jackdaw4 = 3.3.3.1 = * Cleaned and updated several upgrade scripts * Fixed several SQL import warnings = 3.3.3 = * Fixed caching issue where only the first 25 returned artists are cached * Updated artist dropdown selector to be ordered by name * Fixed Simplified item listing template to display streaming and embedded widgets * Added new nav menu shortcode/settings panel = 3.3.2.3 = * Fixed WP-Cron issue = 3.3.2.1 = * Fixed plugins rerun upgrades script. = 3.3.2 = * Fixed/updated several initial SQL files. * Updated Fix Upgrade function to rerun all initial SQL before re-running all upgrade scripts. = 3.3.1 = * Fixed plugin upgrade bug. * Fixed some PHP warnings. * Fixed format string for product_get_most_popular_list(). = 3.3 = * Fixed some PHP warnings. * Added caching from the Orders API. * Added internal names for each Store for administrative purposes. * Added new sections in the WordPress Admin: View Most Popular, and View Orders. * Updated colorbox to the latest version and resolves how it is loaded. @blauwers * Updated View Stores to now display store pages in a nested list, the full permalink, and the new internal name. * Updated the items caching method store the campaign ID. * Updated FAQ. * Added new topspin template tags/functions: topspin_get_store_items(), and topspin_get_most_popular_items(). * Moved JS to footer for faster page load performance. @blauwers = 3.2.3 = * Fixed the Product Sorting and Sort By bug to now work with the Preview. * Fixed some PHP warnings. = 3.2.2 = * Added the ability to set parent pages and template files for each store. = 3.2.1 = * Updated [topspin_featured_item] shortcode bug (returning empty item if no featured item is set). * Updated the installation script to add unique key for the currency table. * Updated the default standard/simplified featured item template css to work with fluid layouts. * Fixed the colorbox issue where it loads on all URL hashes. = 3.2 = * Added the ability to add multiple featured items per Store Page * Added notice that switching Artist ID in the settings will clear the content on all current stores * Added a new Items section to show all of the available offers in the cache database * Added a new Individual Items shortcode to allow individual items to be embedded anywhere on the site using the Feature Item template * Fixed and updated various Tag-related output, cache, and sorting bugs * Added output of a Store Preview on the Add and Edit Store pages based on offer types, tags, and sorting method selected (previously a preview was only shown if Manual sorting was selected) * Added a template function topspin_get_item_photos() to output all of an item's images instead of just the poster image * Added a template function topspin_get_items() to output all of an item's data to an array * Added the output of all additional images in the More Info lightbox for each default theme * Added the ability to click a Featured Item to get More Info and see all the additional images * Added Google-indexable hash-based permalinks for each item to allow the page to be opened directly to that item's More Info lightbox when shared * Adjusted the size of the More Info Lightbox images to be larger (400px wide/tall instead of 280px wide/tall) * Adjusted the default layout of the More Info Lightbox for better UI and to include the new additional image thumbnails * Added the ability of the large image inside the More Info Lightbox to be clicked for a larger view inside the Lightbox * Other miscellaneous bug fixes, php warning fixes, and typo corrections = 3.1.3.6 = * Changed the default image of each item to retrieve the large version instead of the medium * Updated the standard template css item list to clear on the last item = 3.1.3.5 = * Removed