Join GitHub today
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
=== OpenBook Book Data === Contributors: johnmiedema Tags: book, books, reading, book reviews, library, libraries, book covers, COinS, OpenURL Requires at least: 2.5.1 Tested up to: 3.9.1 Stable tag: 3.5.1 Displays a book's cover image, title, author, links, and other book data from Open Library. == Description == OpenBook is for book reviewers, book bloggers, library webmasters, anyone who wants to put book covers and data on their WordPress blog or website. Use the OpenBook button in the WordPress visual editor or insert an OpenBook 'shortcode' with a book number in a WordPress post, page or widget. OpenBook will display a book cover image, author, and other book data from Open Library (http://openlibrary.org). It also displays links to book websites. Users can control the content through templates and styling through a stylesheet. OpenBook inserts COinS to integrate with applications like Zotero. Librarians can point OpenBook to their library records using an OpenURL resolver. Requirements. To use OpenBook, your server must use PHP 5 or higher, and cURL must be enabled. Find more information or report a problem at the OpenBook support wiki: http://code.google.com/p/openbook4wordpress/. == Installation == Use the plugin menu or the following manual steps: 1. Deactivate any previous version of OpenBook through the 'Plugins' menu in WordPress. 2. Delete any previous version of OpenBook in the `/wp-content/plugins/` directory. 3. Upload the entire openbook folder to the `/wp-content/plugins/` directory. 4. Activate the plugin through the 'Plugins' menu in WordPress. 5. Insert an instance of OpenBook in one of two ways. Using the WordPress visual editor, click the OpenBook button to open a form for entering a book number and options, then click Preview or Insert. Or, in a post, page, or text widget, insert the openbook tags and an ISBN number, like so: [openbook booknumber="0864921535"]. 6. Type your content as usual after the tags By default, OpenBook will display a book cover image, title, author, and publisher, along with links to Open Library, WorldCat, and other book sites. == Frequently Asked Questions == * Where do I find an ISBN number? You can obtain the ISBN for a book by searching for it in Open Library. It is also usually listed in other common sources of book data, e.g., Amazon. * What if the title is not in Open Library? You can add titles to Open Library. It is like Wikipedia for books. * What if the title does not have an ISBN? You can use the Open Library number found in the Open Library URL, e.g., [openbook booknumber="OL882707M"] from http://openlibrary.org/b/OL882707M. * What if the cover image or other data is missing in Open Library? You can add cover images and other data to Open Library. * What happens if Open Library is slow, down, or unavailable? Open Library's cover and/or data servers are up most of the time, but this cannot be guaranteed. OpenBook times out in ten seconds (or the value configured in Settings) and displays a message where the data would normally go: "Open Library Data Unavailable". When Open Library becomes available, the book data will be displayed normally. Alternatively, you can use the "HTML" option available when you use the Visual Editor button. This option embeds the book data in your post instead of making a live call to Open Library. * How do I change the display of OpenBook? Change the content and ordering of display elements using the templates in the Settings panel for OpenBook. Manage the styling by editing the OpenBook stylesheet. * How do I point OpenBook to my library? In the OpenBook Settings panel, configure an OpenURL resolver for your library. * Where do I get more detailed help? * I don't see the OpenBook button on my Visual Editor toolbar Make sure you have the latest version of OpenBook. In the Visual Editor, click CTRL-F5 to force a refresh. The button will appear. OpenBook support site: http://code.google.com/p/openbook4wordpress/ Report a problem: http://code.google.com/p/openbook4wordpress/issues/list Join the OpenBook discussion list: http://groups.google.com/group/openbook4wordpress == Screenshots == 1. Insert a book number, e.g., ISBN, using an OpenBook shortcode. 2. Or use the OpenBook form to insert a book number and parameters. You can preview the display. 3. OpenBook displays book data from Open Library. 4. Customize the display using OpenBook's templates. == Changelog == = 3.5.0 = * Compatibility with WordPress 3.9.1 * Fixed OpenBook button issue for WordPress 3.9 * Note: if you don't see the button on the toolbar right away, click CTRL-F5 to force a refresh * Modified dialog for preview and insert of books * HTML is the default option = 3.4.3 = * Tested compatibility with WordPress 3.8.1 = 3.4.2 = * Minor fixes to COinS, open URL resolver, and Open Library links function