For the complete documentation index, see llms.txt. This page is also available as Markdown.

The shop directory

The directory is the page where visitors browse every shop you carry. On most sites it is the second most visited page after the home page.

Where it already is

You do not create it. Cashback Tracker publishes the directory automatically as soon as you have shop pages, at:

https://yoursite.com/shops/

That page is the full thing: the A–Z letter strip, the search box, the sort control and paging, all working without any setup.

Changing the address

/shops/ is the default. To use a different word, add a filter to your theme's functions.php:

add_filter( 'cbtrkr_shops_slug', function () {
    return 'stores';
} );

add_filter( 'cbtrkr_shop_category_slug', function () {
    return 'store-type';
} );

The first moves the directory and every shop page under /stores/; the second moves category archives from /shop-category/ to /store-type/.

Putting shops on other pages

Separately from the directory, the shortcode drops a grid of shop tiles into any page, post or widget:

That is a different tool for a different job. It shows the shops you ask it for and nothing else — no letter strip, no search, no sorting, no paging. Use it for a "top cashback shops" block on your home page, and link to the directory for browsing.

There is a block version too, if you prefer the editor — see Blocks. Full options are on [cashback-shops].

How visitors sort it

Sort
Order

Name

A to Z

Newest

Most recently added shops first

Highest cashback

Best rate first

Best rated

Highest member rating first

Most coupons

Shops with the most live coupons first

On a coupon site, Highest cashback is replaced by Most coupons, since there is no rate to sort on.

How many per page

SettingsGeneralShops per page. Default 24, maximum 100. It applies to the directory and to category archives.

24 is a sensible default. Much higher and the page gets slow and heavy on phones; much lower and browsing becomes a chore.

Category pages

Every shop category has its own archive listing the shops in it, using the same layout and the same per-page setting. Those pages are worth linking to from your navigation — a visitor looking for Fashion is a much better lead than one browsing all 400 shops.

See Shop categories.

Searching

[cashback-shop-search] puts a search box wherever you want one, including outside the directory page. See [cashback-shop-search].

What each tile shows

The shop's logo, its name, its tagline, its star rating, and its cashback rate — or, on a coupon site, how many coupons it has.

The tagline and the stars are what make a tile look finished, and both are easy to leave empty without noticing:

  • Tagline — a short line saying what the shop sells, set per shop. A shop without one shows a gap where the others have a line. See Shop pages.

  • Stars — the average member review score, shown once a shop has been reviewed. See Ratings and reviews.

A shop with no logo shows its name in the space instead, so the grid stays aligned. If a lot of your shops have no logo, the logo service fills them in.

The shop directory

Which shops appear

Only shops that have a published page. The Shop catalog may hold thousands of shops your networks know about, but the directory shows the ones you have actually made pages for.

If a shop is missing from the directory, that is nearly always the reason — see Creating shop pages in bulk.

Pages left as drafts or pending review do not appear either, which is a useful way to build a shop out before it goes live.

Last updated