| filter
name |
description |
example/s |
extra
info |
| cpfilter_name:[term] |
shows
products that include the matched term |
cpfilter_name:large+mug |
- case-insensitive
-
terms can be combined
-
use + to represent spaces
-
use ~word~ to match a whole term (cpfilter_name:~mug~ will match
"large mug" but not "muggy" or "smug")
-
place a - before the term to limit to products that don't match
that term (cpfilter_name:-shirt)
|
| cpfilter_cost:[price] |
shows
products that meet a specific pricing criteria |
cpfilter_cost:14.99
(products that cost 14.99)
cpfilter_cost:~14.99
(products that cost up to 14.99)
cpfilter_cost:14.99~
(products that cost 14.99 and up) |
- cost
filters can be combined with non-cost filters
-
cost filters cannot be combined with other cost filters
|
cpfilter_type:[number]
*number
based on
cafePress product type number |
shows
products of a specific type based on the product type number designated
by CafePress |
cpfilter_type:7
(only ash grey t-shirts)
cpfilter_type:15,
cpfilter_type:80
(only boxer shorts and thongs) |
- available
type numbers can be found here
-
type filters can be combined with non-type filters
-
type filters can be combined with other type filters
|
cpfilter_newest:[number]
*number
of most recent
products to show |
shows
items based on their newness |
cpfilter_newest:15
(shows the 15 most recently added products) |
- newest
filters can be combined with non-newest filters
-
newest filters cannot be combined with other newest filters
|
| cpfilter_sort:[sort
criteria] |
shows
items based on a specific sort order |
cpfilter_sort:productname
(sort by name)
cpfilter_sort:productcostup
(cheapest at top)
cpfilter_sort:productcostdown
(most expensive at top)
cpfilter_sort:storeid
(by store ID, for multiple-store-ID stores)
cpfilter_sort:old2new
(oldest first)
cpfilter_sort:new2old
(newest first) |
-
sort filters override default product thumbnail sort method
-
sort filters can be combined with non-sort filters
-
sort filters cannot be combined with other sort filters
|
| cpfilter_template:[filename] |
allows
a filter to be displayed within a specific html template layout different
from that of the main store. |
cpfilter_template:catstore.html
cpfilter_template:templates/catstore.html |
- sets
a customized template for a specific store and all of its products
-
file must end in one of the following extensions: .htm, .html,
.txt, .tmpl, .tpl, .template
-
filename root is the cpshop directory
-
filename can include sub-directories (i.e. templates/template1.txt)
-
filename cannot include multiple dots in succession (i.e. ../filename.html)
-
template filters can be combined with non-template filters
-
template filters cannot be combined with other template filters
|
| cpfilter_template:[columns] |
allows
the specific filter to display columns differently from that of the
main store. |
cpfilter_columns:4 |
-
forces display to specified number of columns
- overrides
admin setting
-
columns filters can be combined with non-columns filters
-
columns filters cannot be combined with other columns filters
|
| cpfilter_rowsperpage:[rows] |
forces
page numbers if more than specified number of rows are necessary |
cpfilter_rowsperpage:5 |
- overrides
admin setting
-
rowsperpage filters can be combined with non-rowsperpage filters
-
rowsperpage filters cannot be combined with other rowsperpage
filters
|
| cpfilter_literal |
displays
section thumbnails rather than individual products. |
cpfilter_literal
(displayed as is, with no parameters) |
- example:
if you entered store1/123,store2/456,store3/678,cpfilter_literal
as an entry, the store would display three thumbnails, linking
to each of those three entries individually, instead of combining
their contents into one large section
-
forces display of entered sections instead of processing
-
can only be used in conjunction with premium shop sections
o can not be combined with basic shops and premium shop main pages
|
| cpfilter_inherit |
causes
filters to persist throughout subsections |
cpfilter_inherit
(displayed as is, with no parameters) |
- common
usage: use mystoreid,cpfilter_inherit,cpfilter_columns:2 to display
every thumbnail page in a store with 2 columns (not just the first
page)
|
| cpfilter_killsection:[section#] |
prevents
a particular subsection from being displayed |
cpfilter_killsection:347285 |
- if
the subsection to be killed is below the top level, then must
be used with cpfilter_inherit
-
can be entered multiple times to block multiple subsections
|