WPBookList Categories Extension Guide

Let me guess – you just recently purchased the wonderful WPBookList Categories Extension for WPBooklist, and now you’re here seeking guidance on how to get the most our of your new purchase. What?! You haven’t purchased the WPBookList Categories Extension!?! Stop everything you’re doing right now and buy the WPBookList Categories Extensions – otherwise this webpage will fill with nothing but links to the WPBookList Categories Extension until you do so. Seriously. It will, I promise.

Fine, you called my bluff, that won’t actually happen – however, the quality of your life will severely diminish if you don’t buy the WPBookList Categories Extension. For those who have, read on ye faithful WPBookList user…

Basic Usage

So here’s the most basic, barebones way of using the WPBookList Categories Extension:

[wpbooklist_categories]

You can see the output of that shortcode below…

Biography & Autobiography
77
Business & Economics
76
Fiction
3
27
Juvenile Nonfiction
1
Uncategorized
5
7
8
11
12
15
16
17
19
21
24
25
28
49
50
53
55
58
64
66
71
70
31
33
39
42
45
46
48
18
20
22
23
26
29
36
41
44
51
52
54
56
57
59
60
61
62
63
65
69
72
68
73
30
32
34
35
37
38
40
43
47
2
4
6
9
10
13
14
67
74
75

Placing that shortcode wherever shortcodes work on your website will display your default Library, organized by category. The width of the Categories view should be as wide as the rest of the content on your page – it shouldn’t be any different from say, a paragraph of text or, if you’ve placed this in a sidebar, the total width of that sidebar.

Categories Width

Speaking of width, if you’d like to specify exactly how wide your Category view should be, use the default Categories shortcode with the ‘Width’ argument (I know, crazy right!?):

[wpbooklist_categories width="70"]

You can see the output of this shortcode below – a narrower instance of the output above…

Biography & Autobiography
77
Business & Economics
76
Fiction
3
27
Juvenile Nonfiction
1
Uncategorized
5
7
8
11
12
15
16
17
19
21
24
25
28
49
50
53
55
58
64
66
71
70
31
33
39
42
45
46
48
18
20
22
23
26
29
36
41
44
51
52
54
56
57
59
60
61
62
63
65
69
72
68
73
30
32
34
35
37
38
40
43
47
2
4
6
9
10
13
14
67
74
75

This shortcode will output the same Category view as the shortcode from above, pulling books in from your default Library, but with a width of 70% – so roughly speaking, if you also have a full-width paragraph of text on the page you’ve placed this shortcode on, then this Categories view will be about 70% of the width of that paragraph of text.

Let’s say you wanted to pull books from a different Library – simply use the ‘table’ argument like so:

[wpbooklist_categories table="nonfiction"]

Biography
2
Psychology
1

The output above is the same kind of awesome content you’ve come to expect from the WPBookList Categories Extension, but this time its pulling books from my sample ‘nonfiction’ Library.

Auto-Converting

Just one more thing to discuss – the auto-converting of existing WPbookList Libraries to ‘Category’ Libraries if the visitor viewing your website is doing so from a mobile device. Below this paragraph I’ve placed the regular WPBookList shortcode we’ve all come to know and love oh-so-much. For brevity’s sake, I’m using my much smaller ‘nonfiction’ Library.

wp_wpbooklist_jre_nonfiction

Search By: Title Author Category

Filter by Publication Year Range

To

Total Books: 2

Finished: 1

Signed: 0

First Editions: 0

Total Pages Read: 832

Categories: 2

Library Completion: 50.00%

"It might be that to surrender to happiness was to accept defeat, but it was a defeat better than many victories. " - W. Somerset Maugham, Of Human Bondage

1
2

If you’re reading this post on a desktop or laptop, you should see a regular ‘ol WPBookList Library above, but if you’re on a mobile device, you should see the output above automatically converted to the Categories view provided by the WPBookList Categories Extension. To enable this auto-converting magic, just check the box that reads “Enable Auto-Converting to ‘Categories’ View” on the ‘Categories’ menu page. Below is a screenshot:

 

This is where you set the Categories Mobile Option

 

That’s it! Now you’re a WPBookList Categories Master!

 

 

Share WPBookList Everywhere!
2 responses...

So…what are the category extension shortcode options? (isn’t this the page on which the link said they would appear?)

Comments are closed.