This plugin adds Internet Archive BookReader into Omeka and is cloned from https://github.com/jsicot/BookReader. The IA BookReader is used to view books from the Internet Archive online and can also be used to view other books. BookReader plugin for Omeka allows you to create online flip book from image files listed in gDoc spreadsheet (clone from https://github.com/duxan/bookreaderspreadsheet).
Therefore this plugin is merge of funcionalities from BookReader and bookreaderspreadsheet explained HERE. Main benefit is that item doesn't need to have all pages/images uploaded to Omeka and that there is no need for composit PDF, so presentation is completely parted from metadata.
- Upload the BookReader plugin folder into your plugins folder on the server;
- Activate it from the admin → Settings → Plugins page
- Click the Configure link to add the following
- URL for custom CSS
- Favicon URL for viewer (reader) pages
- URL for custom php library (default is BookReaderCustom.php)
- Sorting mode for the viewer (omeka default order or original filename order)
- Number of pages in Embed mode (1 or 2)
- Embed all functions (0 for none or 1 for all)
- The width of the inline frame (Embedded Simple Viewer)
- The height of the inline frame (Embedded Simple Viewer)
The viewer is always available at http://www.example.com/viewer/show/{item id}.
If you want to embed it, add this code in the item/show.php file of your theme:
<?php
fire_plugin_hook('book_reader_item_show', array(
'view' => $this,
'item' => $item,
'page' => '0',
'embed_functions' => false,
'mode_page' => 1,
));
?>
If an option is not set, the parameters in the config page will be used. Image number starts from '0' with default functions.
- Thumbs are not set because files are not in database but on custom server place listed in gDoc.
- Link to individual spreadsheet is hardcoded for testing, it needs to be extracted from item metadata.
- Plugin now messes up Zoom.it plugin, so separation is needed.
- Desired behaviour> user uploads PDF, pages are extracted but not added to item, pages converted to jpgs (http://harikrish.wordpress.com/2011/04/07/ubuntu-linux-command-line-tool-to-convert-pdf-to-image-and-from-image-to-pdf/) and linked to plugin to feed bookreader.
The extract ocr and pdfToc plugins are highly recommended.
- Extract ocr allows fulltext searching inside a flip book
- PDF Toc retrieves table of contents from pdf file associated to an item
This plugin is published under GNU/GPL.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
The source code of Internet Archive BookReader is licensed under AGPL v3, as described in the LICENSE file.
- Copyright Internet Archive, 2008-2009
BookReader Omeka plugin:
- Copyright Julien Sicot, 2011-2012
- Copyright Daniel Berthereau, 2013 (upgrade for Omeka 2.0)