WP-Spreadplugin

Description

This is a small WordPress plugin for displaying the articles of your Spreadshirt-Shop in WordPress. The plugin uses the Spreadshirt API to display and don’t uses iframes!
If you add an article to the cart and then click on the cart link, you will be redirected to the usual Spreadshirt basket. The whole payment and order process is handeled by Spreadshirt.

Using the plugin is quite easy!
You only need to add the shortcode to your new or existing page and you’re done!

ATTENTION
This plugin doesn’t work for users using the new Spreadshirt user area. Only few of products are displayed, not all your selected ones. You might use Spreadshop of Spreadshirt then: https://developer.spreadshirt.net/display/spreadShop/SpreadShop

Current features

  • Infinity Scrolling
  • Uses Spreadshirt-Basket (A click on the basket opens the spreadshirt own basket)
  • Price listing
  • Choose color and sizes
  • Language support (de_DE, en_GB, fr_FR, nl_NL, nn_NO, nb_NO, da_DK, it_IT based on WordPress installation, more on request)
  • Social buttons
  • Enhanced article zoom
  • Display article descriptions
  • Cache
  • Choose or direct link to the product category
  • Sorting and filtering
  • Adding products to the basket without page reload
  • Choose between article or design view (click on a design shows the articles inside the website)
  • Settings page/admin page for easier configuration
  • No premium shop necessary except you want to link to and use the designer
  • Basket
  • Own product pages
  • Basket Widget
  • and many more…

What do you need

  • WordPress
  • Spreadshirt shop
  • Spreadshirt API key and secret (US/NA From: https://www.spreadshirt.com/-C6840, EU From: https://www.spreadshirt.net/my-api-keys-C7120)

Known Bugs

  • Filters and sorting / categories disabled, but will return.
  • If using W3TC, please disable page cache for shop pages.

Screenshots

  • Design view
  • Article view
  • Settings page

FAQ

Installation Instructions
  1. Upload the spreadplugin directory to the /wp-content/plugins/wp-spreadplugin Directory (if not exists please create) or install using wordpress plugin installer
  2. Activate the plugin through the Plugins menu in WordPress
  3. Edit default settings using Spreadplugin Options
  4. Create a new site or edit an existing site
  5. Insert shortcode

[spreadplugin]

  1. Go back to Spreadplugin Options and click Rebuild cache. Please wait until the cache has been rebuild.
  2. Done
It shows “No articles in Shop”, but there are articles in the Spreadshirt-Shop

Check if your Spreadshirt Shop has a language and country setting.

I want to use a different currency. Is this possible?

The currency bases on the currency you’re using for your Spreadshirt Shop. So if you want to use DKK instead of EUR, change the currency in the Shop options of your Spreadshirt Shop. But be sure to not have any products in your shop, because Spreadshirt doesn’t allow changing it, when you’ve already products in it. (The solution would be to create a new shop) Please clear the cache of the Spreadplugin plugin in the Spreadplugin settings page when done (you may wait some hours to the spreadshirt cache to refresh).

How do I get the category Id?
  1. You must have already created a category in your spreadshirt shop (http://www.spreadshirt.com/help-C1328/categoryId/3/articleId/147), if not, please do so, now. Please refer to spreadshirt, if you don’t know how.
  2. Please open your normal spreadshirt shop (shopid.spreadshirt.net). In my case: http://welovetee.spreadshirt.de/
  3. Choose a category from the category selection.
  4. The url of your shop has changed to http://welovetee.spreadshirt.de/alsterwasser-C300890 in my case
  5. The category Id in this case is 300890 (the numbers after the “-C” part)
  6. Paste this number in the shop_category="" variable. In my case shop_category="300890".
  7. Save and done.
How to display one category per page? (Custom categories)
  1. Please see How do I get the category Id?
  2. If you have got your category id, create a page in wordpress
  3. Go to text mode
  4. Paste extended shortcode (you don’t need all values, just the one you want to overwrite) [spreadplugin shop_category="CATEGORYID"]
  5. Save and repeat by each category you want to display.
How to display one pre-defined category per page?
  1. Please see How to display one category per page? (Custom categories)
  2. Instead of using shop_category, use shop_productcategory and one of your category names as values. Possible values are Men, Women, Kids & Babies,… But in your language.
How to disable the social buttons?

Add or change in the [spreadplugin] code the value from shop_social="1" to shop_social="0" or use the settings page.

How to disable the product links?

Add or change in the [spreadplugin] code the value from shop_enablelink="1" to shop_enablelink="0" or use the settings page.

How to change the link targets?

Add or change in the [spreadplugin] code the value from shop_linktarget="" to shop_linktarget=”YOUR_IFRAME_NAME”` or whatever it is. Or use the settings page.

I want my checkout page display in an iframe, what is to do?

Add or change in the [spreadplugin] code the value from shop_checkoutiframe="0" to shop_checkoutiframe="1" or shop_checkoutiframe="2". Note: shop_linktarget will be ignored. Or use the settings page.

  • shop_checkoutiframe="0" opens basket in separate window
  • shop_checkoutiframe="1" opens basket in an iframe in the page content
  • shop_checkoutiframe="2" opens basket in an iframe in a modal window
How to default sort?

Add or change in the [spreadplugin] code the value from shop_sortby="" to shop_sortby="name". Available sort options are name, price, recent. Or use the settings page.

I get following error, when I add an article to the basket: “ERROR: Basket not ready yet.”

Please update to the most recent version

How to active edit articles to use the designer shop?

Activate by changing shop_designershop=”0″ to shop_designershop=”DESIGNERSHOPID” where DESIGNERSHOPID is your designer shop ID. Or use the settings page.

How to active designs view?

Activate by changing shop_display=”0″ to shop_display=”1″ or change it in the admin panel. Or use the settings page.

It shows old articles

Please go to the settings page in the admin panel of the plugin and click “Rebuild cache”.

I want to use more than one shop on the same website

Please use the extended shortcode.
This will overwrite the default plugin settings just for the page, where you have added this shortcode.

The infinity scroll always repeats all of my articles on and on and on and..

This might be a problem resulting of a special URL structure (permalinks). In this case, please have a look at your wordpress settings -> permalinks.
If you don’t want to change this setting to another one, please let me know the structure to check it.

The article description should be displayed without clicking “Show description”. How to do it?

Add or edit the shortcode or set in shortcode plugin settings to enable. Shortcode would be shop_showdescription="1" for enabling.

I want to display one design per page

Add or edit the shortcode you are using and add/change following variable shop_design="DESIGNID".
You get the DESIGNID from your spreadshirt admin panel.

If I checkout, the language differs from the language of the shop?!

Please check your Locale setting in your user-data of spreadshirt.
You can find it here: http://www.spreadshirt.net/user-data-C162 or http://www.spreadshirt.com/user-data-C162

How can I change the language of different shop instances?

If you change the language in your wordpress installation, the language of the plugin changes, too. Well, but you can change the language only for the plugin by selecting your language in the spreadplugin options, now. If you have multiple pages with different shops on it and want to use a different language on each page, please use the shortcode and extend your already used shortcode by – for example shop_language="de_DE" – possible values are: de_DE, en_GB, fr_FR, nl_NL, nn_NO, nb_NO, da_DK, it_IT. Your new shortcode could look like this: [spreadplugin shop_language="de_DE"]

“Rebuild cache” reads nothing, but Shop Id is correct!

Change “Shop country:” to “None/Please choose” and click “Rebuild cache” again.

Where do I find great website templates for wordpress?

Please have a look here: http://themeforest.net/category/wordpress?ref=thimo

After updating wordpress, detail page doesn’t work anymore!

Please save Spreadplugin settings again.

Display Designer only on page

Paste [spreadplugin-designer] into your desired page, that’s it.

Reviews

Top Plugin

Super Plugin. Damit ist man voll flexibel beim Designen der eigenen Shopseite.
Daumen hoch! So macht das Laune! 🙂

Awesome plugin ! Nice and simple integration

Nice and simple integration of spreadshirt boutiques.
I use wp-spreadplugin on a complex wp-multisites with mubltiple spreadshirt accounts and hundreds of products …

Special thanks to Thimo, wp-spreadplugin author, for its reactivity and to bring back products filters on 3.9.35 !

Nice job !!!

— Fabien

Good job!

Good job. The pluging is very easy to use and do exactly what I was looking for.

Amazing

Wonderful plugin. It’s making things much easier. Thank you very much for your great work and for the unbelievable nice and helpful individual support.

Awesome!!!

This Plugin is awesome for everyone who would like to integrate his Spreadshirt shop into is Worpress website! I love this plugin!!! 🙂

Read all 62 reviews

Contributors & Developers

“WP-Spreadplugin” is open source software. The following people have contributed to this plugin.

Changelog

3.9.41

  • Added new shortcode [spreadplugin-designer] to display designer only.

3.9.40

  • Prepare for changes in spreadshirt api beginning 28th feburary 2017

3.9.39

  • Hide available colors of products which are out of stock, use following Custom CSS: .spreadplugin-not-on-stock {display:none}

3.9.38

  • Changed price in min view to net price

3.9.36

  • Increased “Rebuild cache” speed

3.9.35

  • enabled filters and sorting again

3.9.33

  • Added Permalink rules for language in URL

3.9.31

  • “Product on stock check” option in Spreadplugin settings added. Now stock check can be switched on or off. If on and product out of stock, you aren’t able to order it. If you disable this option, you are able to order it regardless of the stock status.

3.9.30

  • Removed fly-over animation in min-view

3.9.29

  • Enabled appearance change for those who didn’t rebuild cache yet

3.9.28

  • Stock states enabled again, rebuild cache is highly recommended

3.9.24

  • Enabled compatiblity with W3 Total Cache plugin by disabling it for shop pages

3.9.23

  • CSS changes

3.9.21

  • Disabled isotope when in Design view

3.9.20

  • Added isotope for better grid display
  • Added reading of all products in shop
  • Added color selection in min-view. Can be disabled by CSS using .spreadplugin-article .color-wrapper {display:none}
  • Added new icons

3.9.10

  • Bugfix reading articles when having EU and US shop

3.9.9

  • Option to change “Back to shop” link in Spreadshirt checkout

3.9.8.10

  • Permalink added for blog post day and name structure

3.9.8.9

  • Bugfix

3.9.8.8

  • Language Bugfix
  • Bugfix for using with WPBakery Visual Composer

3.9.8.6

  • Bugfix for image swapper

3.9.8.5

  • Permalinks update hook changed

3.9.8.3

  • Language fix

3.9.8.2

  • Added article price check to use fallback when reading articles with/without language setting.

3.9.8.1

  • Fix for american language / use default language us_US if none set.

3.9.8

  • Siteorigin Pagebuilder workaround added
  • Fix for importing wrong/old articles

3.9.7.9

  • Minor language and additional bugfixes

3.9.7.7

  • Single article bugfix

3.9.7.6

  • SSL restrictions removed

3.9.7.2

  • Checkout fixes
  • Checkout uses shopId now for some users having customized spreadshirt checkout with logo on top. See http://www.spreadshirt.net/-C9397 for more informations.

3.9.7.1

  • Anchor added so you can jump directly to spreadplugin shop if set
  • Basket Widget integrated and not display separatly in plugin list
  • Temporarly removed category and sorting boxes, sorry but will return later

3.9.7

  • Code optimizations
  • Pretty urls for detail pages. If you are having problems with pretty urls, please disable and enable spreadplugin again.
  • Bugfix when on home page

3.9.6.4

  • Function doAjax didn’t read shop_language shortcode

3.9.6.3

  • If shop_language is set in page, it’s getting read now

3.9.6.1

  • Basket auto refresh interval disabled

3.9.6

  • Added separate basket widget

3.9.5.2

  • Url fix

3.9.5

  • Bugfix in Tablomat

3.9.4.1

  • Bugfix

3.9.4

  • Updated integrated designer “Tablomat” to use the shop basket.
  • Removed iframe Designer

3.9.3

  • Bugfix for environments disabled wordpress globals (wp_query)

3.9.2

  • Added close button for basket as user requested

3.9.1

  • Read one article one when using shop_article

3.9

  • Added new tag (shop_article) to just display one article

3.8.9

  • Bugfix with not applied filters

3.8.8

  • Bugfix with doubled content

3.8.7.9

  • Added limit of max read articles. Now you can reduce the quantity of articles to be read.
  • Bugfix for Users using Plugin “Page Builder by SiteOrigin”

3.8.7.8

  • Added japanese thanks to schlafcola.de

3.8.7.7

  • Added spanish, portuguese translation, thanks to schlafcola.de

3.8.7.6

  • bugfixes

3.8.7.4

  • Norway bugfix

3.8.7.3

  • Minor Bugfixes

3.8.7

  • Switched to tablomat to use with designer shop (premium). Please choose “Show Spreadshirt designs in the designer” in “Apperance” -> “Settings”, if you don’t want to display Spreadshirt Marketplace designs.

3.8.6.7

  • Fixed english checkout link

3.8.6.6

  • Fixed problems with the new checkout of spreadshirt

3.8.6.5

  • Renamed some CSS

3.8.6.4

  • Removed the caching block

3.8.6.3

  • Tried to reduce caching problems with other plugins

3.8.6.2

  • One XSS vulnerability fixed

3.8.6

  • CSS fixes

3.8.5

  • Changes in Spreadshirt API
  • Added polish

3.8.4

  • Added Brazil and Australia for US/Canada

3.8.3

  • Minor Bugfixes

3.8.2

  • Responsive detail page

3.8.1

  • Minor Bugfixes

3.8

  • Bugfix release. In some cases, not all articles are displayed and increased debugging.

3.7.9

  • Bugfixing / tried sync from basket to designer again

3.7.8

  • Bugfixing
  • Modified minimal-view and added more effects. See it at http://www.alsterwasser-fisch.com/

3.7.7

  • Sort by place is default again. Place is set via article order in api, which should represent your shop sorting.
  • Zoom can be disabled completly

3.7.6

  • Added shipping costs popup, please rebuild cache!

3.7.5b

  • Added new integrated designer shop called confomat (by spreadshirt). Choose from options between none, integrated designer shop (but shows your chosen design and marketplace designs, if you click on designs tab) and premium (if you have a premium account at spreadshirt with a designer shop activated)
  • This is a beta release!

3.7.3

  • Bugfix: On some newly created shops, the articles didn’t get loaded completly.
  • Bugfix: Error when reading articles with category definded.

3.7.1

  • Bugfix

3.7

  • New code for building caches. The cache is not build on first page load anymore. You have to click on “Rebuild cache” or “Save settings” to trigger cache building. Otherwise the product pages stay empty.

3.6.2

  • Code modifications
  • Small debug mode added. Please enable only if you experience problems (Settings menu)

3.6.1

  • Bugfix in minimal view, Basket won’t open.

3.6

  • Added new minimal view – please be sure to improve the display by adding css
  • Added new configuration option shop_basket_text_icon to enable or disable basket icon
  • Some minor changes
  • Support me by code improvements – if you’ve got some

3.5.8

  • Language of the plugin is now selectable / changeable through shortcode. On questions please see faq
  • Small error message when adding a product failes.
  • Bugfixes

3.5.6.3

  • Some minor fixes
  • Added span tags for size and color label to disable them via css

3.5.6.1

  • Inches on detail pages for US/CA
  • Bugfixes

3.5.6

  • Get rid of some error messages

3.5.5.6

  • Https fixes

3.5.5.5

  • Minor bug fix to get rid of php notices

3.5.5.3

  • Print technique for detail page added

3.5.5.2

  • Language fix french

3.5.5.1

  • Added option to enable or disable lazy load

3.5.5

  • New option to change the zoom behaviour. Please see spreadplugin options at Zoom type.

3.5.4

  • New detail page. Added product details, size table…

3.5.3.4

  • Changed URL style of detail page, so woocommerce installations are not harmed 🙂

3.5.3.3

  • Bugfix: In some cases the detail pages of a product is empty

3.5.3.2

  • Bugfix in Product detail pages

3.5.3.1

  • Bugfix in shop URL

3.5.3

  • Checkout-Language workaround added and set to shop country

3.5.2

  • Replaced fancyBox 2 with magnific-popup

3.5

  • Bugfixes

3.4.2

  • Bugfixes

3.4.1

  • Minor improvements

3.4

  • Added close basket, when click outside
  • Added new option to display product description under article
  • Minor enhancements

3.3.1

  • Italian translation added

3.3

  • Beautiful flyover to basket animation

3.2

  • Depending on stock state the size and color of a product will be hidden (beta) / removed

3.1.5

  • Speed improvements by adding lazy image loading (only loads images when in viewport)

3.1.4

  • Solved session basket problem: On some server configurations, the session couldn’t be reused, so there was created a new session and so the basket contents were lost.
  • Minor Bugfixes

3.1.3

  • Bugfix: Translation problem in detail page fixed

3.1.2

  • Bugfix: Pagination did not work in some conditions

3.1.1

  • Bugfix: Basket has shown wrong prices, when quantity is higher than one

3.1

  • Added own product pages (detail pages)

3.0.1

  • Added new shortcode for displaying only specific designs in specific pages. Please refer faq.

3.0

  • Basket added
  • Minor bugfixes

2.9.6

  • Minor bugfixes
  • Added Text for german locale ‘zzgl. Versandkosten’ if extended price is choosen

2.9.5.1

Norwegian language added

2.9.5

  • JS now loaded at the shortcode call.
  • Timeout limit removed

2.9.4

Pagination bugfix: In some cases, the pagination doesn’t work and always shows the first page.

2.9.3

Price format changed for USD

2.9.2

Bugfix: InfiniteScroll was not disabled correctly – it did show Javascript errors.

2.9.1

Sometimes no articles were displayed, when no designs are available. This has now been fixed.

2.9

  • Add your own custom css in admin interface. This won’t be overwritten by any spreadplugin update.
  • Disable infinite scrolling in admin interface.
  • Added edit article button, if designer shop id is added.

2.8.2

Bugfix: Wrong view was used as default

2.8.1

  • Color picker for zoom image background / choose background color
  • Default sorting changed

2.8

  • Enhanced article zoom
  • Price with tax now displayed only. Can be changed in options/settings page.
  • Two images sizes now available (190 & 280 pixel)

2.7.6

Enhanced cache call method to get always newest API file, when deleting spreadplugin cache.

2.7.5

Bugfix: Script tried to display descriptions of the designs, which is currently not available from spreadshirt

2.7.4

Article description can now be displayed always. Use shop_showdescription="1" to enable or use settings.

2.7.3

Edit article now opens in fancybox when set shop_checkoutiframe="2". It opens in a separate window by default, now. Thanks to grillwear-shop.de

2.7.2

  • Extended admin page
  • An must have update!

2.7.1

  • Fix for Better WP Security users, which were unable to display the options page in some circumstances.

2.7

  • New kick-ass retina social buttons
  • Clean-up release
  • Maybe the last release

2.6.2

  • Bugfixes (Sorting reverted, can’t solve it yet)

2.6.1

  • Bugfixes (incl. sorting bug – hopefully ;-))
  • Added short product description e.g. Women�s Classic T-Shirt, Men�s Classic T-Shirt,…

2.6

  • New social buttons, if you don’t like, just replace in the image directory with your own. See FAQ
  • Speed improvements (got rid of facebook and twitter implementations)

2.5

  • Settings page will now be used for all default settings. If you configure default settings, you’ll just need the minimum shortcode [spreadplugin].
    If you extend your shortcode with additional settings, they will be used! All existing shortcodes may stay untouched at least your shop_locale is not empty.
    If you receive a locale error, please add shop_locale=”us_US” to your shortcode. Please refer https://wordpress.org/extend/plugins/wp-spreadplugin/installation/.
  • Bugfix
  • Please save your old css file. If it’s from Version 2.2.x you can reuse it in 2.5.

2.2.1

  • Sorting added ‘weight’

2.2

  • New sticky toolbar
  • CSS & JS fixes

2.1.3

  • Updated the design view
  • SSL improvements – thanks goes to Marcus from sozenshirts.de for that note
  • Minor bugfixes

2.1.2

Bugfix: Infinity scrolling doesn’t work sometimes when in designs view

2.1

  • Settings page added to regenerate cache because Cache doesn’t regenerate itself anymore due to performance

2.0

  • Added a new shortcode variable to by display designs by default. To enable change shop_display=”0″to shop_display="1".
    Sample (active): http://lovetee.de/shop/
    Sample (disabled/article view): http://lovetee.de/shop-articles/
  • Added Pinterest / Thanks to shirtarrest.com
  • Article category sub-filter
  • CSS fixes

1.9.4

Click on zoom image doesn’t open a separate window anymore. The article description is now displayed in a modal window on the website.

1.9.3

Edit for articles added, if you have a designer shop. Activate by changing shop_designershop=”0″ to shop_designershop=”[DESIGNERSHOPID]”.

1.9.2

  • Bugfix: JS script took each form to submit an article to the basket 🙂
  • Style: Changed some styles to fit most environments

1.9.1

Fancybox added to display checkout in a modal window. Activate by adding or changing shop_checkoutiframe="0" to shop_checkoutiframe="2"

1.9

  • Ajax driven shop (Add products to the basket without reloading the whole content)
  • Internal article cache extended to 2 hours. If you want to change, have a look at row 46 in spreadplugin.php and change the value.

1.8.4

Price formatting added

1.8.3

Compatibility update for using with ‘Simple Facebook Connect’-Plugin

1.8.2a

Dutch language added (nl_NL)

1.8.2

Compatibility update for < PHP 5

1.8.1

Translation for sorting added

1.8

  • Added a new shortcode variable to sort the articles by default. To enable change shop_sortby=””to shop_sortby="[name, price, recent]".
  • Sorting select box added

1.7.4

  • Custom url structures now possible

1.7.3

  • Added a new shortcode variable to open the checkout window in an iframe. To enable change shop_checkoutiframe=”0″to shop_checkoutiframe="1".
  • Bugfix

1.7.1

  • Added a new shortcode variable to change the link targets. To enable change shop_linktarget="" to shop_linktarget=”YOUR_IFRAME_NAME”`.
  • You may hide the product category field by adding a style in the plugin css. E.g. .spreadplugin-items #productCategory {display:none}

1.7

  • Own cache added (updates every 8 hours) – speed improvements.
  • Product category now accessable
  • Shortcode added for direct calls of a category. Add shop_productcategory="" and fill with field value e.g. Women => shop_productcategory="Women"

1.6.5

  • Debugging things, no need to update

1.6.4

  • Each article image has now a link to it’s spreadshirt product details website. Use the shortcode to enable shop_enablelink="1" or disable shop_enablelink="0" this behaviour (default is enabled).

1.6.1

  • Added a new shortcode variable to disable social media buttons. Enable shop_social="1" / Disable shop_social="0"

1.6

  • Define a category to display with shop_category="". Please have a look at the faq for getting the category id. In v2 I hope to have an admin interface which will help you with the configuration.

1.5

  • Shows detailed product description when hovering the article image (mouseover)

1.4.2

  • Zoom image now shows right color of views

1.4.1

  • Size of views increased

1.4

  • Different views of the article available (front, back, left, right)

1.3

  • Language improvements (Thanks to Steve for helping me with french :))

1.2.9

  • Skipping some errors when spreadshirt articles are no more readable (link dead?)

1.2.8

  • Removed some error messages when in WordPress debug mode

1.2.7

  • I missed the multi language features of Twitter and Facebook, so sorry!

1.2.6

  • Added Twitter share button. It pushes description text if available, else it just says ‘Product’. Additionally, it says @URL to product.

1.2.5

  • Added Facebook like button

1.2.2

  • Enabled some error messages

1.2

  • Spreadshirts “Free Color Selection”/Color limitation is now processed

1.1.3

  • Show hide prices using stylesheet
  • French language improvements

1.1

  • jQuery compatibility improvements
  • Currency display fix

1.0