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
29
48
87
Business & Economics
51
Business ethics
58
Campaigns
88
Chief executive officers
3
Cosmology
24
Doctrines
50
Economic aspects of Social media
46
English Science fiction
42
Entrepreneurship
47
Existential psychotherapy
67
Fantasy fiction
8
57
68
Fiancés
40
Fiction
25
39
52
75
84
Human behavior
1
Ignotus Award winner
5
In library
6
9
18
43
53
70
77
81
86
Information superhighway
17
Internet Archive Wishlist
16
20
21
23
33
36
54
55
Juvenile literature
71
Meditation
64
Motivation
73
New York Times bestseller
7
19
Pelvic pain
34
Philanthropists
31
Politics and government
49
66
69
72
Popular Print Disabled Books
10
Rand al'Thor (Fictitious character)
63
Rich people
60
61
Rocketry
65
Roman Empire
26
Science fiction
41
Seiun Award
62
Social aspects
91
Social psychology
56
Uncategorized
2
11
12
13
22
27
28
30
32
35
37
38
44
45
74
76
78
79
80
82
83
85
89
90
92
93
Waisenkind
14
Wealth
59
genetics
4
prize:pulitzer=1998
15

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
29
48
87
Business & Economics
51
Business ethics
58
Campaigns
88
Chief executive officers
3
Cosmology
24
Doctrines
50
Economic aspects of Social media
46
English Science fiction
42
Entrepreneurship
47
Existential psychotherapy
67
Fantasy fiction
8
57
68
Fiancés
40
Fiction
25
39
52
75
84
Human behavior
1
Ignotus Award winner
5
In library
6
9
18
43
53
70
77
81
86
Information superhighway
17
Internet Archive Wishlist
16
20
21
23
33
36
54
55
Juvenile literature
71
Meditation
64
Motivation
73
New York Times bestseller
7
19
Pelvic pain
34
Philanthropists
31
Politics and government
49
66
69
72
Popular Print Disabled Books
10
Rand al'Thor (Fictitious character)
63
Rich people
60
61
Rocketry
65
Roman Empire
26
Science fiction
41
Seiun Award
62
Social aspects
91
Social psychology
56
Uncategorized
2
11
12
13
22
27
28
30
32
35
37
38
44
45
74
76
78
79
80
82
83
85
89
90
92
93
Waisenkind
14
Wealth
59
genetics
4
prize:pulitzer=1998
15

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%

"Still round the corner there may wait / A new road or a secret gate / And though I oft have passed them by / A day will come at last when I / Shall take the hidden paths that run / West of the Moon, East of the Sun. " - J.R.R. Tolkien

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.