ePub

ePubVersion Logo Image

ePubVersion is FREE software, but

Please Consider a Gift

to Help Support Further Development.

Amount

v1.3 Has been RELEASED and is ready for download!

ePubVersion (7z)- v1.3 - 435 downloads - Posted by KirstynF

ePubVersion (bz2)- v1.3 - 269 downloads - Posted by KirstynF

ePubVersion (gz)- v1.3 - 273 downloads - Posted by KirstynF

ePubVersion (zip)- v1.3 - 512 downloads - Posted by KirstynF

 



Manage ePub
What is it?:

  • ePubVersion is an eFiction 3.x module that creates on-the-fly ePUB eBooks for Single Chapter and Multi Chapter stories.
  • eFiction is a CMS catering to Fiction Archive sites.
  • ePub (or EPUB, ePUB, EPub, epub) is an Electronic Publication format (or eBook) supported by most Hardware and Software eBook readers. The most notible exception being the Amazon Kindle. For more information on ePub and devices that support them, Click Here.

 

Requirements:

  • PHP – 5.3.2
  • I use don’t use any specialized MySQL functions. I use MySQL5 for testing and development, but again, have no specific requirements other than that.
  • PHP needs to be compiled with TIDY in order to use the TIDY option.
  • Apache Mod_Rewrite is needed for Search/Stanza friendly URL’s
  • PHP needs to be compiled with CURL support to enable CURL as an option for image retrieval.
  • PHP needs to have URL_FOPEN enabled to enable URL_FOPEN/get_file_contents() as an option for image retrieval.
  • I make GREAT use of preg_match/preg_replace so your webhost needs to have perl regular expressions (regexp/PCRE) enabled in PHP.
  • PHP needs to be compiled with DOM support
  • PHP needs to be compiled with GD support and PNG/JPEG/GIF GD extensions to properly support images.

 

Changelog:

  • v1.3 - Fixed errors introduced by v1.3rc1
  • v1.3 - Added {cover} {printthumb} {printepub} {epubcount} to available template variables.
  • v1.3 – Added support for changing the ePub “Language” identifier.
  • v1.3 – Added support for site wide “Cover” images for stories.
  • v1.3 – Added support for author uploaded/custom “Cover” images for stores.
  • v1.3 – Upgraded EPub.php to current released version.
  • v1.3 – Upgraded HTML Purifier to current released version.
  • v1.3 – Added the ability to use “Cover” images on your eFiction Front page and Stories pages…
  • v1.3 – Improved handling of extraneous character sets.
  • v1.3 – Fixed several reported errors.
  • v1.3 - Fixed Dynamic Banner code.
  • v1.2 – Added Dynamic Banner option to banners list.
  • v1.2 – Incorporated changes to browse pages to fix errors as reported by Calash (THX!)
  • v1.2 – Added ePub Download Counter
  • v1.2 – Added pre-processing preg_replace filter for pre-processing conversion of <b><i><u><em><s><strong> into span tags.
  • v1.2 – Added routine for a Combined TIDY+PURE. This option creates the largest resource hit on your server, as it essentially processes each page 4 times. (once for images, once for pre-processing,  and then once each to filter through TIDY and HTMLPurifier). Each step improves the output book for better compatibility on more readers).
  • v1.2 – Added support for HTMLPurifier (PURE). HTMLPurifier outputs pretty XHTML compliant source pages that make for optimally redered ePub eBooks.
  • v1.1 – Added choice of URL_FOPEN/get_file_contents() support for those whom don’t have CURL for image retrieval.
  • v1.1 – Added choice of NONE which filters all IMG tags from the source material, and creates a image-less ePub eBook.
  • v1.0 – Added Image Support
  • v1.0 – Added Admin Configure/Options Panel
  • v1.0 – Added Author Configure/Manage Panel
  • v1.0 – Added ePub Browse Panel
  • v1.0 – Added Update script
  • v1.0 – Added Tidy support
  • v1.0 – Added ability to turn off ePub Creations for non logged in users
  • v1.0 – Fixed double header error on Cover page (caused crash in Stanza)
  • v1.0 – Added Title Sanitation (Caused crash in Stanza)
  • v1.0 – Cleaned up code where needed. Compacted some bits.
  • v0.9 – copied formatstory() and nblr2() functions from corefunctions.php to epubversion.php to remove errors caused by stories with content warnings.
  • v0.9 – Removed includes for TemplatePower, corefunctions.php. pagesetup.php
  • v0.9 – more general code cleanup.
  • v0.8 – Added small configuration section at the top of epubversion.php that can be used to configure $sitename, $siteurl, and $sitetagline which are used for the OPF File’s publisher line, and the “Brought to you by” line on the coverpage.
  • v0.8 - added ‘exit();’ right after the epub is sent to the user in order to stop erroneous/extra data being sent and causing some ebook readers to detect a bad ebpu/zip container.

 

 

Roadmap:

  • v1.3 – eBook Cover Selection for Authors and Site Admins
  • v1.4 – PDF Creation
  • v2.0 – Template.Power Support? (not sure this is even possible).
  • v3.0OPDS Catalog Creation. Will allows users to add your eFiction site as an eBook Catalog/Provider/Store in their favorite eBook readers.

Current issues:

  • All Formatting is currently hardcoded into ePubVersion (I will work on putting the Template.Power template support back in in a later release, but I was having issues mixing the EPub class and the Template.Power class).

 

Credits:

This module was coded/adapted by Kirstyn Amanda Fox (GeekBrat [at] Gmail [dot] Com) , is released under GPL and is free to use. Use it to your hearts content. Please leave my info in any derivative works, as I have left those whom came before me.

This module makes use of PHP’s Tidy function.

This module makes use of HTML Purifier by Edward Z. Yang
- http://htmlpurifier.org/

This moudule makes use of the EPub and ZIP  PHP classes by Asbjorn Grandt
http://www.phpclasses.org/package/6115

This module is being based on DisplayWord for eFiction 3.0 by Tammy Keefer
http://efiction.hugosnebula.com/

 

 

 

 

Legacy/Old Version Downloads:

  • ePubVersion (gz)- v1.3rc1 - 265 downloads - Posted by KirstynF
  • ePubVersion (7z)- v1.2 - 311 downloads - Posted by KirstynF
  • ePubVersion (gz)- v1.2 - 332 downloads - Posted by KirstynF
  • ePubVersion (zip)- v1.2 - 423 downloads - Posted by KirstynF
  • ePubVersion (gz)- v1.0u1 - 317 downloads - Posted by KirstynF
  • ePubVersion (zip)- v1.0u1 - 328 downloads - Posted by KirstynF
  • ePubVersion (zip)- v0.9 - 347 downloads - Posted by KirstynF
  • ePubVersion (7z)- v0.9 - 333 downloads - Posted by KirstynF
  • ePubVersion (tar)- v0.9 - 311 downloads - Posted by KirstynF

Powered by HTML Purifier

eFiction LOGO Image

19 Responses to ePub

  • Tammy:

    Your download links aren’t working.

  • Lyndsie:

    When I click on any of the download links: “Sorry, no posts matched your criteria.”

  • Download links have been fixed.

    -HuGgLeS-
    -P/KAF/PT

  • Sue:

    Thank you for creating this! My users are really looking forward to this feature.

    I’m trying to install the module but get:

    Parse error: syntax error, unexpected ‘”‘ in /XXX/fictioning.net/modules/epubversion/version.php on line 11

  • Thanks for the note! just add a ” before epubversion on line 11.

    The line looks like this now:
    $moduleName = ePubVersion";

    You want it to look like this:
    $moduleName = "ePubVersion";

    Or you can wait for the next release which will be out in a few days that will sanitize the story output making it proper xhtml (choice of regex or tidy) and possibly even image support!

    -P/KAF/PT

  • Sue:

    Wait? Are you kidding? This is very exciting!

    Thank you for the prompt fix. The module installed and the icon displays, but when I try to “epub” a story, I get:

    Notice: Undefined variable: skin in /XXX/fictioning.net/includes/class.TemplatePower.inc.php on line 146

    Notice: Use of undefined constant SITEKEY – assumed ‘SITEKEY’ in /XXX/fictioning.net/includes/corefunctions.php on line 242

    Warning: array_key_exists() [function.array-key-exists]: The first argument should be either a string or an integer in XXX/fictioning.net/includes/storyblock.php on line 103

    Error: Unable to send file Another_Case_Scenario_[1].epub. HTML Headers have already been sent from /XXX/fictioning.net/includes/class.TemplatePower.inc.php in line 146

    This is going to be mega! I can’t thank you enough for taking the time to develop this module.

  • in epubversion.php go ahead and comment out the following lines, starting at or around line 85:
    include (_BASEDIR."includes/class.TemplatePower.inc.php");
    if(file_exists("$skindir/printstory.tpl")) $tpl = new TemplatePower( "$skindir/printword.tpl" );
    else $tpl = new TemplatePower(_BASEDIR."modules/displayword/default_tpls/printword.tpl");

    Once that is taken care of, try making an ePub of a book that doesn’t have a content warning attached and see if that goes through. I will have to try a work-around for the content warning stuff.

    Ignore the instructions about commenting out the TemplatePower stuff, it’s needed by other functions. Try the suggestion about a story without a content warning tho and see if that helps.

  • Page updated. New code released to fix previous error report.

  • Sue:

    Working! Thank you so much. This is just brilliant. Congratulations on all your work.

  • Annica:

    Hi, I’ve just installed this on my site and am currently testing it out.
    I saw your question over at efiction about including a pdf option. I’d love that and if it’s possible to have epub and pdf in one Mod then that’s what I’d prefer any day.

    Great work!

  • It’s definately something I’m looking into. I’m actually thinking about modifying Tammy’s original “Display Word” mod and including it too, creating like an “Export Version” mod that contains as many formats as I can produce. I’m currently sideline by other projects, but have the next release of ePubVersion nearly ready. IT includes a lot of small changes, that can be used to spice up your eFiction site in general (see examples @ TGFiction.Net [the thumbnail images]).

    Thanks for the comment! I’m a Comment WHORE!
    -P/KAF/PT

  • Sue:

    Hi,
    I’ve got to move the site to another host and…long story short, I’m reskinning and whatnot and I need to uninstall the module.
    When I try via the admin area, I get a blank screen.
    What should I delete etc?

    cheers and thanks again,
    Sue

  • Sue:

    Me again :)

    All installed on the new host now. When I try to uninstall on that I get:

    Fatal error: Cannot redeclare validemail() (previously declared in /home/xxx/public_html/includes/corefunctions.php:26) in /home/xxx/public_html/includes/corefunctions.php on line 28

  • K_B:

    I’d love to install this but I get the following :

    A fatal MySQL error was encountered.
    Query: select `epubimg` from `settingsfanfiction_settings` limit 0
    Error: ()

  • There will be an update shortly, I promise :)

  • Nice plugin – with a little work it integrates with nearly every kind of fanfiction archiv – in my case with a heavily changed efiction 2.0.3.

    Thanks for your work, I think our users love it ;)

  • Dazza:

    I have this error when installing

    A fatal MySQL error was encountered.
    Query: select `epubimg` from `settingsfanfiction_settings` limit 0
    Error: (1054) Unknown column ‘epubimg’ in ‘field list’

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

">tensibly-mortarless -->
April 2014
M T W T F S S
« Feb    
 123456
78910111213
14151617181920
21222324252627
282930  

FREE ePub eBooks!

Recent Comments

  • New Meaning : Sugar And Spice by Sasha Nexus [All Visitors] February 18, 2014
    (New) Chapter Six :Revelation (New) Tony is asked by Jenny, his sister, to replace a sick friend in order to get a new computer. The catch is that Tony will have to become a Girl Scout! Will Tony choose Sugar and Spice in the end? New Meaning : Sugar and SpiceBy Sasha Nexus All thru life there are choices that can give new meaning to our lives. There is no o […]
  • Costumes by Teekabell [All Visitors] January 7, 2013
    Every kid knows Costumes are for Halloween, and the rest of the year you are not supposed to wear costumes. So what happens when you decide the outfit you wear every day is really just a costume? […]
  • For My Princess by Cat Lochley [All Visitors] November 15, 2012
      Written especially for LG Tales. When Aron entered the castle with his mother neither of them could have known what lay ahead. Being in the wrong place at the wrong time leads him to a royal encounter that will take him on a journey of discovery and adventure. Can he keep his secret safe and do his royal duty? How will his relationship with the Princess de […]
  • The Pink Painting Smock by Nessa D [All Visitors] August 17, 2012
    Milo couldn't understand how it had happened, all of the boys in the class knew that when it was time for art class you either brought your own apron or made sure that you got to the art cupboard first, yet here he was at the end of the line and the only thing left was the pink painting smock.
  • The Magic Swing Set by Heather Rose [All Visitors] August 16, 2012
    What would happen if you swung all the way over a swing set? Would the world change? Would you? In this story, two friends experience what happens when you take a trip over the Magic Swing Set.