These instructions have been updated for MoneyPress : CafePress Edition version 4.0 or higher. These codes will not work in older versions. Version 4.0 No longer supports the QuickCafe shortcode. Please replace it with the newer mp-cafepress shortcode.
Using The Plugin¶
This plugin works on both posts and pages and uses a "shortcode". A shortcode is a snippet of text with some information that the plugin translates into a list of products with all of their information and links to the CafePress marketplace or to a CafePress shop. An example of the shortcode is:
[mp-cafepress return="12"]The shortcode above will create a section that displays 12 products from your main CafePress. On the front page or category pages of your blog, it will show only the first three products followed by a "View All" link that takes the visitor to the full page or post. There, the plugin will display the first 21 products. If you leave the "return" field blank it will show all of your products.
If you just want to use your defaults from the admin panel settings page, simply use this type of shortcode:
[mp-cafepress]The shortcode can be entered manually or use the form that the plugin creates under your posting text area when adding or editing posts or pages.
Changing The Look¶
Colors, Fonts, Etc. (CSS)¶
The entire results set is controlled with CSS, including the "buy now" button, and can be changed by editing the CSS via the Plugins/Edit section. Choose the MoneyPress:CafePress Edition plugin and edit the css file listed there.
Shortcode Attributes¶
section_id¶
The section_id attribute is used to limit the product listing results to a single section in your store.
Basic Stores¶
Basic stores only have one section and it is accessed by section ID 0.
Premium Stores¶
Premium stores have multiple sections that are setup during the store creation. When you create a new section the CafePress store builder will show you a section summary within "Storefront Contents". These are typically 7-digit IDs.
Section IDs are optional only if you have added a main product line to your site.
With Premium Stores you can have store sections, a main product line, or both. If you do NOT specify a section ID in MoneyPress CafePress Edition either via the default setting or by specifying it in your shortcode then you MUST have added a main product line within your CafePress store. If you DO specify a section ID you will not see your main product line unless you enter a section ID of 0 in your shortcode attributes.
Quick Examples¶
Put the following tag into your post or page where you want the product listings to appear:
| shortcode | what it does |
| [mp-cafepress] | show a list of products from your main catalog, uses default settings from admin panel. |
| [mp-cafepress return="20"] | same as above, overrides the return value on the settings page, forces 20 items to be shown. |
| [mp-cafepress section_id="107"] | shows a list of products from your CafePress store section # 107 only. |
| [mp-cafepress store_id="another_guys_store" | show products from another store, you must have access to that store or it must be public. |
| [mp-cafepress page="2" return="10"] | shows the 3rd page of products (pages start at 0), which would show products #21-30 in your catalog. |
| [mp-cafepress list_action="listByStoreSection"] | Which CafePress API product lookup action to use. Choose from listByStoreSection, listByStore, listDeepByStore, listAnonymousProducts |