A plugin that allows you to create an online library! Display tons of info about your favorite books right on your website!
|Author:||Jake Evans (profile at wordpress.org)|
|WordPress version required:||3.0.1|
|WordPress version tested:||4.9.7|
|Added to WordPress repository:||07-10-2016|
|Total downloads:||18 007|
Click to start download
How your books will appear on your website. WPBookList uses most of the default styling of your currently active theme, but WPBookList StylePaks allow you to further customize WPBookList styling to better suite your website.
Here you can create additional libraries, for example, you could create a ‘Currently Reading’ library, a ‘Fiction’ library, a ‘Fantasy’ library, or whatever else you can think of!
With the Affiliates Extension, you can add your Amazon & iTunes Affiliate ID to each book, giving you credit each time a visitor clicks on and/or purchases a title.
Here’s a screenshot of where you can upload your WPBookList StylePaks, changing the look and feel of WPBookList.
The Amazon Localization options, allowing you to set your Amazon reviews and links based on country.
A screenshot of the iOS version of the Official WPBookList companion app. Scan your book’s barcode instead of entering the ISBN numbers manually. Only available with the WPBookList Mobile App Extension.
A second screenshot of the companion app. All that’s required is to input the address of your WPBookList library and you can start scanning books! Only available with the WPBookList Mobile App Extension.
Another shot of the same website - note the review stars!
This is how your books will appear when you click on a title or cover image.
This is how WPBookList can look with the StoreFront Extension activated - notice the prices and the ‘Buy’ image for each title. The StoreFront Extension lets you set your own ‘Buy’ image.
How individual books can look with the StoreFront Extension’ - here you see several purchase links and the price displayed, and you’ll notice that the ‘Finished’, ‘Signed’, and ‘First Edition’ text is hidden.
An example of how the Amazon Reviews look for each title.
A screenshot of the ‘Description’ and ‘Notes’ section for each title, both of which are fully editable.
Another example of a different book.
A screenshot of the options page in the WordPress Dashboard. Here you can control which elements actually get displayed on the page you’ve placed your library on.
How do I add a book? – On the WordPress Dashboard, click on the ‘WPBookList’ link on the left-hand side (marked by a circular icon outlined in orange). Fill out the form, click ‘Add Book’, and that’s it! If you choose to gather book info from Amazon, the only required field is the ISBN/ASIN number.
I’m an author and/or publishing company – can I link to Author’s Websites? – You sure can! If you’ve purchased the StoreFront Extension, then when adding a book, you’ll be given the option to input the Author’s URL, and you’ll then see a link to that URL when viewing that title.
Can I use WPBookList to sell my books? You can with the StoreFront Extension! While WPBookList doesn’t sell books directly, it can be used to link to wherever your books are sold, and display that link, and the price of the title, to your visitors, both in the Library view and the individual Book view. This is only possible with the StoreFront Extension. Check out the StoreFront demo here.
Can I add my own Amazon Affiliate ID to all my books in WPBookList? – Absolutely, but only with the Affiliates Extension.
I’m a publisher/author looking for unique advertising opportunities – do you offer advertising space in WPBookList? I do! I’m currently looking to populate WPBookList with some ‘default’ titles that will come pre-installed when the user first activates WPBookList, and I also have a method of pushing out books to individual websites for all to see. Feel free to reach out at Advertising@WPBookList.com for more info.
Why can’t WPBookList find my book? – While WPBookList will have no problem finding the vast majority of books by their ISBN/ASIN numbers alone, occasionally WPBookList will come across a title that it simply can’t find information for. WPBookList searches through the databases of Amazon, Google, iTunes, and more for information about a title, so the general rule of thumb is that if it can’t be found at amazon.com or Google Books, WPBookList will not be able to automatically pull information for your title.
Does it matter which ISBN number I use? – Nope, WPBookList can find titles using both ISBN-10 and ISBN-13, although using the ISBN-13 number is recommended. You can also leave dashes in the ISBN number when you’re adding a book (for example, if you copy/paste from a different website).
Can I upload my GoodReads library into WPBookList? – You sure can, but only with the Goodreads Extension.
Why does it take so long to upload my Goodreads export? – WPBookList is doing a ton of behind-the-scenes number-crunching for each title, reaching out to several different locations to gather all info possible about each title. As such, this can end up taking quite a while if your export is large… rest assured however that eventually, your entire Goodreads export will be uploaded!
Why shouldn’t I open my Goodreads export file before uploading it to WordPress Book List? – To ensure that nothing goes wrong with the upload process, the Goodreads export file must be in a ‘perfect state’ so to speak… sometimes, on some computers, simply opening the file can make modifications to it, depending on the operating system, the program used to open the file, etc. It’s just a much better idea to never open your Goodreads export and instead upload it straight to WordPress Book List.
Do you provide support for WPBookList? – Absolutely! If there’s something just not right about your WPBookList experience, shoot me an e-mail at TechSupport@WPBookList.com.
How do these StylePak things work? – StylePaks are additional $2 add-ons for WPBookList that change the look and feel of WPBookList. Check out the StylePak Demos Here:
How do these Template Pak things work? – Like StylePaks, Template Paks are additional $2 add-ons for WPBookList that change the look and feel of your WPBookList Pages and Posts. Check ‘em out Here:
What are all of the Shortcode Options for displaying a Cover Image? – To display the cover image of a book that links to it’s Amazon page, simply place this shortcode on page or post: [showbookcover]. The available options are as follows:
- Specify a book: isbn=”xxxxxxxxxxxxxx”
- Set placement: align=”left” or align=”right”
- Specify Library: table=”nameoflibrary”
- Set the size: width=”100″
So, for example, to display a book from a library you created named “fictionlibrary”, on the left side of a page or post, with a size of 100, this shortcode would do the trick:
[showbookcover isbn=”123456789912″ align=”left” width=”100″ table=”fictionlibrary”]
Simply leave out the table option to use the default library.
If all options are left out of the [showbookcover] shortcode, by default WPBookList will display the first book from your default library, aligned to the left, with a size of 100.
Method 1) Simply drop this folder (unzipped) into your WordPress plugin directory (/wp-content/plugins).
Method 2) In the WordPress admin dashboard, click on ‘Plugins’ on the left-hand side, click on ‘Add New’ towards the very top of the page, click on ‘Upload Plugin’, and upload the ‘wpbooklist.zip’ file you downloaded.
Method 3) In the WordPress admin dashboard, click on ‘Plugins’ on the left-hand side, click on ‘Add New’ towards the very top of the page, search for ‘wpbooklist’, and then click ‘Install Now’.
USAGE: Simply paste this shortcode on the page or post you’d like to display your library: [wpbooklist_shortcode], visit that page or post on the front-end (like a visitor to your website would do), and look for the “Add a Book” link. Click on it, enter the ISBN number of the book you’d like to add, fill out the other fields (if you’d like, the only required field is the ISBN number), and click ‘Add Book!’
Smartphone App Setup (with the Mobile App Extension)
2) Open the WPBookList app on your smartphone, press ‘Configure Settings’, and input the address of the page you’ve placed your WPBookList library on.
3) Press ‘Add a Book Now!’, scan your book’s barcode, and watch it appear on your website!
How Can I Translate WPBookList Into My Language Of Choice?
So here’s the kinda-sorta official way to translate WPBookList:
Head to this link: https://translate.wordpress.org/projects/wp-plugins/wpbooklist
Scroll through the list to find the language and locale/dialect you want to translate WPBookList into, and click on the name. On the next page (which should look something like https://translate.wordpress.org/locale/de/formal/wp-plugins/wpbooklist) click on the “Stable (latest release)”, and simply work your way down the list, translating string by string into whatever language you’re working with. You’ll have to be sure to be logged in (log in here: https://login.wordpress.org/?redirect_to=https%3A%2F%2Ftranslate.wordpress.org%2Fprojects%2Fwp-plugins%2Fwpbooklist%2Fstable%2Fde%2Fformal&locale=en_US) before you can provide a translation.
Now when you add these translations, they’ll be saved, and an official member of the WordPress translation team will have to ‘approve’ each one of these translations individually, and it’s usually a first-come-first-served-type thing, meaning it could take quite a while. Luckily, you yourself can apply to be one of these “Official Translators”, with the ability to approve your own translations.
In order to become one of these “Official Translators”, I’ll need to know your official username (the one you used to log in at https://login.wordpress.org/?redirect_to=https%3A%2F%2Ftranslate.wordpress.org%2Fprojects%2Fwp-plugins%2Fwpbooklist%2Fstable%2Fde%2Fformal&locale=en_US) and which specific language/dialect you’re wanting to be an “Official Translator” of, and then I can send in a request. E-mail me those two bits of information to firstname.lastname@example.org.
v1.0.0 – Initial Release of The New WPBookList.
v5.0.1 – Fixed a bug that prevented some titles from being edited – lines 1486 and 1622 were modified – changed the string ‘sep’ to ‘–sep-seperator-sep–’.
v5.0.3 – Modified the Pages & Posts classes to add post excerpts and featured images. Fixed bug that prevented the sharing icons from displaying on Pages & Posts properly. Added additional Post & Page Styling to better accommodate mobile devices. Added top margin to library container. Modified the Post & Page names to ensure uniqueness and compatibility with permalink. Fixed bug that resulted in only one ‘Similar Title’ being displayed in Colorbox. Fixed bug that left slashes in book title.
v5.0.4 – Fixed link to the API tab, introduced code to reload page after saving API Keys, introduced StylePak Advertisement Page, added the Extensions Bundle tile to the Extensions page, fixed positioning of the drop-down on all admin pages, removed the z-index from the book title, fixed misspelling of ‘Available’ in Colorbox class, added margin to bottom of purchase titles on pages/posts, removed the CSS Reset for Phrase tags in the Colorbox CSS file to ensure HTML in the Descriptions and Notes sections displays as expected, fixed a bug that prevented any HTML found in the Description & Notes fields from displaying properly in Colorbox after being edited, fixed bug that prevented some Similar Titles in Colorbox from being displayed properly.
v5.0.5 – Modified class-book.php to make Amazon API call region-specific, fixed typo that prevented the ‘UK’ localization option being checked. Fixed bug that prevented some https links from forming properly in the colorbox.php file. Fixed bug that prevented the ‘Read More’ link on WPBookList Posts from operating properly. Converted the Page and Post ‘StylePaks’ to ‘Templates’. Fixed bug that called the old ‘colors’ function in the colobox.php file. Fixed bug that prevented some pages and posts from displaying their appropriate template. Fixed bug that prevented uploaded zipped Library StylePaks from being used on some websites.
v5.0.6 – Modified Post & Page default styling. Modified the post-template-default.php and page-template-default.php files to better accommodate the StoreFront extension. Modified functions.php file to better accommodate the ‘Similar Titles’ sections of the WPBookList Post & Pages.Modified the class-book.php file to add a secondary way to search for titles on itunes/ibooks. Modified the class-book.php file to change how Amazon reviews are refreshed if expired. Added a filter to check the max key length of db, and modify if needed
v5.0.7 – Added support for the new Kindle Preview Extension
v5.0.8 – Added new purchase links & images (Books-A-Million and Kobo). Fixed a bug that showed the ‘Purchase This Book At:’ text even when all purchase links were hidden. Added the new ‘Kindle Preview’ and ‘TimeSaver Bundle’ extensions to the ‘Extensions’ page. Added function to download a CSV file of ISBN/ASIN numbers on the ‘Backup’ tab of the ‘Settings’ page. Added additional shortcode functionality to display books in a variety of news ways, such as with an excerpt or as a link to the ‘Book View’ colorbox. Fixed a bug that prevented Book View from opening if the Australian Amazon Localization setting was checked. Fixed a bug that prevented custom library settings from saving on some sites. Added some Mobile styling for the Extensions tab. Began adding support for the upcoming WPBookList BookSwapper Extension.
v5.0.9 – Fixed a bug that prevented books from being added on some sites.
5.0.10 – Fixed a few styling issues with the display=“excerpt” shortcode argument. Fixed a bug that prevented some libraries from being displayed if the table name is capitalized. Fixed a bug the prevented the clicking of the ‘Signed’ No checkbox. Fixed a bug that sometimes prevented the review stars from being displayed on WPBookList Posts and Pages. Fixed a bug that sometimes incorrectly lists a book as ‘Finished’ on the WPBookList posts and pages. Fixed the colorbox styling to reduce the blank space between the goodreads widget and the rest of the sections below. Fixed a bug that made all spinners active when editing a book. Fixed a bug that prevented the correct display of Page and Post options when certain checkboxes are checked. Fixed a bug on the ‘Display Options’ page that checked the ‘hide title’ checkbox when the ‘review stars’ checkbox was checked. Added ability to use the ‘action’ argument in the default WPBookList shortcode to link to merchant sites instead of displaying the color box Book View.
5.0.11 – Added additional support for translations
5.0.12 – Modified the Pagination feature to only display if there is a second page, and to only display the book number once if only one title is on page.Added an admin message with links to Extensions and StylePaks. Added additional Translation strings.
5.1.0 – Introduced check in the class-book.php file for Amazon reviews refresh. Added stripslashes function in colorbox.php file for Publisher field. Fixed bug that prevented some Storefront icons from displaying properly in colorbox window. Added StoreFront WooCommerce Support.
5.2.0 – Introduced support for Page and Post templates. Added the ‘Templates’ Submenu Page.
5.3.0 – Introduced support for the new BookFinder Extension.
5.3.0 – Introduced support for the new BookFinder Extension, and introduced the book ‘Reordering’ feature.
5.3.1 – Bug fixes for the ‘Reordering’ feature, the link to view a book after immediately adding it, and a UI fix for the ‘Edit & Delete Books’ tab.
5.3.2 – Added unique ids to some elements in the Book View for compatibility with the new Stylizer Extension. Added class name to the Book View Stats area. Modified the StylePak function to increase reliability. Removed success condition for resetting mouse movements after re-ordering books. Changed the ‘Add Book’ submission to better accommodate all browsers. Modified styling on ‘Edit & Delete Books’ tab. Removed unneeded event handler. Changed styling on ‘Library StylePak’ page. Changed styling on ‘Custom Libraries & Shortcodes’ page. Modified the ‘Ultimate Bundle’ advertisement to reflect the new price. Added Template Pak Image. Removed the color modifications within Colorbox upon completion. Added advertisement for the Stylizer Extension. Added Facebook link. Added support for Holiday StylePaks.
5.3.3 – Fixed a bug that prevented the addition of new books to libraries.
5.3.4 – Added stripslashes to the book’s title of the Post & Page templates. Added advertisement for the Carousel Extension.
5.4.0 – Added ability to specify a ‘post’ or ‘page’ action argument in the WPBookList shortcode, to have the book cover link to it’s associated Page or Post, if it exists. Added code to decode html entities on the Edit Book form. Added a check for existing tables when plugins activates. Added advertisement for the new Categories Extension.
5.5.0. – Added ability to specify the purchase links for Barnes & Noble, Amazon, iTunes, Google Play, Kobo and Books-a-million when editing a book. Added modification to the class-frontend-library-ui.php file to account for and adjust database tables whose prefixes must be capitalized or all lowercase. Added in brand-new ‘Subject’ and ‘Country’ fields for each book. Added support for the new Google Preview Extension. Added the brand-new ‘Filter Panel’ on the front-end Library view. Added new options within the ‘Sort By…’ drop-down box on the front-end Library view.
5.5.2 – Fixed a bug that prevents some db tables from displaying their contents. Fixed a bug in IE that prevented the pagination of libraries from working correctly. Fixed a bug that prevented some multi-site WordPress installs from displaying Extension UIs properly. Fixed a bug that prevented StylePaks on some secure sites from being loaded.
5.5.3 – Added an Exit Survey to WPBookList in an attempt to gather information about why a potential user decides to not use WPBookList.
5.5.5 – Made modifications to the Exit Survey, removed unnecessary files from Colorbox, and removed the Colorbox border images within the css.
5.6.0 – Added support for the new WPBookList Branding Extension.
5.6.1 – Fixed a bug that displayed a broken image within the Book View on some sites that are not using the Branding Extension. Also fixed a bug that prevented some user’s Affiliate IDs from being applied to their links.
5.6.2 – Added advertisement for WPGameList, and switched Amazon Lookup to cloud server.
5.6.3 – Modified the wpdb->prepare statements in the wpbooklist_new_lib_shortcode_action_callback function of ajaxfunctions.php to prevent bug that kept users from deleting custom libraries.
5.7.0 – Introduced StoryTime.
5.7.1 – Fixed a bug that caused APIs to be called twice.
5.8.1 – Eased restriction on how/when .css and .js files get loaded, adding an automatic load if is_home or is_front_page is true, and if the word ‘WPBookList’ appears in Content.
5.8.2 – Added arguments to the wp_register_script() and wp_enqueue_script() functions in functions.php for readmore.min.js, colorbox-min.js, and addthis.js to be loaded in the footer.