# Overview Quickly, easily integrate Topspin Offers into customized, dynamically generated Store Pages; recoded and optimized for better Wordpress integration. [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) # Description 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