REM State

29 Jan

In Series 2.2.0

Well, it’s that time again: I’m ready to cut loose a new version of In Series. The minor version bump means that there are new features, too! For those of you who don’t want to dig through PHP, or who want to be able to switch templates on a whim, I’ve added out-of-the-box hyperlink generation. New (English-speaking) users can just start the plugin and go — everything should “just work.” Naturally, you can customize (or disable) the automatic hyperlinks, but hopefully this will make the plugin accessible to more users (and friendlier to existing users).

I also cleaned up some snippets of code here and there, which should help with maintenance in the future. The strings should all be internationalized, now, so translation may be possible — however, at present, my attempts to localize (i.e., create an actual translation) have failed. If anyone knows more about WordPress’ translation architecture, let me know; I’m keen to get things ready for translators.

Naturally, I’ll be adding some more images to the screenshots section to show off the new UI and link-insertion, so keep an eye out! If you have any trouble with this version, let me know by leaving a comment for this post. If any major bugs pop up, I’ll try to be forthcoming with a 2.2.1 release; I haven’t encountered any bugs over the last couple of days here on REM State, but that doesn’t mean there aren’t any.

Finally, for a semi-comprehensive list of new features that 2.2 brings over 2.1:

  • Automatic insertion of series relation information into posts
    • Inserting <link> tags (next and prev relations)
    • Inserting series next/previous hyperlinks at the end of posts
    • Prefixing series titles to post names
    • Inserting tables of contents into posts
  • Internationalized strings (mostly translation ready)
  • Quick-and-dirty function documentation (in the plugin code)

Get In Series 2.2.0

19 Responses to “In Series 2.2.0”

  1. trackback trackback:
    1
    Bloganbieter.de

    Tipps wie man Artikel-Serien schreibt…

    Es gibt verschiedene Wege um Leser an das eigene Blog zu binden. Eine Methode ist das Schreiben von Serien-Artikeln, in denen ein Thema Stück für Stück beleuchtet und erklärt wird. Hierbei streut man die Informationen, die man den Lesern mitteilen …

    Reply to this comment.
  2. AvatarJoe
    2

    Hey Guy(sorry I don’t know your name),
    I have used v 2.0 and it semi-worked for me. I adapted a little and it seemed to be Ok.
    However, when I upgraded to WP 2.1 It Doesn’t Work at all.
    If I upgrade In Series to the newest version, will it be compatible? And, do I have to make any/alot of changes to my existing series on my Blog?
    Thanks, I like the plugin, but I need it to work.
    Joe

    Reply to this comment.
  3. AvatarQuandary
    3
    Author Comment

    Sorry; I haven’t tried it with WordPress 2.1 (I’m putting off the upgrade since I _just_ got everything working with 2.0). I’ll set up a testbed and try it out, though, since I’m sure that other people will be using it with WordPress 2.1 too.

    You should not have to make any changes to your existing articles/series when upgrading to the latest In Series; it should “Just Work.” If you have to do anything beyond installing/deactivating/activating the plugin to make it work, let me know; I’ll try to fix it.

    As far as pre-2.1 releases of In Series goes — I have no clue. All I know, right now, is how 2.1 and 2.2 relate to 2.0 (the version I inherited from the previous maintainer). I’d be happy to help you troubleshoot, though; hop into #in-series on irc.freenode.net and give a holler, if you can. If not, let me know here, and I’ll e-mail you directly.

    Thanks for the feedback!

    Reply to this comment.
  4. AvatarJoe
    4

    Thanks for the quick answer Quandary, I think I’ll just jump in and see if I (it) floats.
    I will certainly let you know how it works, if there are any problems or Not.
    It’s getting a little late in my neck of the woods, so I’ll check it out tomorrow.
    Thanks again for your help.
    Joe

    Reply to this comment.
  5. AvatarQuandary
    5
    Author Comment

    I just tried In Series 2.2.0 on WordPress 2.1 (default theme), and it seems to work fine.

    Maybe the reason In Series stopped working when you went to WordPress 2.1 is because you didn’t take your modified theme along? The old (pre 2.2) In Series plugins required that you hand-code the tags into the theme. If you install In Series 2.2.0 and still don’t see any series-related hyperlinks, try enabling the “automagic” hyperlinks through Options->Series in the admin control panel.

    Let me know of your success/failure; I’ll try to help out in the latter case, if I can.

    Reply to this comment.
  6. AvatarJoe
    6

    Hey Quandary,
    SUCCESS…
    I basically had to undo the whole original version. One bit at a time after installation. I was getting double lists etc and nothing under the post itself.
    I was running into a problem because I had to make so many adjustments to the original version, it started causing problems with WP 2.1
    Anyway, it works perfectly now. Thanks, it is exactly what I wanted from the first.
    Joe
    PS. I didn’t notice in the .txt on how to put a list in the sidebar, so this is how I did it.
    I just picked a good spot, added a title and put in the code:
    <?php all_series(‘’); ?>
    That put a list in the sidebar, click on a series post name and it takes them right to the first in the series.

    Thanks again,
    J.

    Reply to this comment.
  7. AvatarQuandary
    7
    Author Comment

    By “undo the whole original version,” do you mean you had to remove the In Series tags that you’d put into your template files?

    Also, yes — the all_series() function is the way to drop in the list of articles right now. However, I still need to provide an automagic way to put the series list it into the sidebar (probably the most common place to put it), based on a configuration option. Note that, if you pass all_series() the right options, you can make it sort by the (pseudo-)most-recently-posted-to series, instead of alphabetically. If you check the actual plugin source, the function is documented (search for “function all_series” and “function get_all_series”). To be honest, I haven’t given the in_series.txt file the attention it deserves, yet.

    You’re welcome, and thanks for the feedback. :)

    Reply to this comment.
  8. AvatarJoe
    8

    Quandary,

    Yeah, it’s a long story, but with the original in order to get the thing to work in the sidebar I had to put all the tags in the sidebar.php and I actually had to use the hyper-link for the first post to have it show up.
    Weird, but it worked. And instead of showing the list in the series at the end of posts, it showed in the Main List of Series as a sub=list.

    Anyway, it works just fine now. I’m not going to mess with it. As they say, “If it ain’t broke, don’t fix it.”

    When I do my next series, I’ll really see the improvements (I hope) and let you know what I find out from a users standpoint.

    Thanks,
    Joe

    Reply to this comment.
  9. AvatarDan
    9

    Like what you’ve done in updating the plugin. I’m working on moving the series TOC to my sidebar for single posts, rather than having it appear above or below the post. I’ve figured out how to put the series TOC there–used series_table_of_contents(”)–but I can’t figure out how to list the series title. I’ve looked through the plugin source, and I’m not sure what I need to use.

    Reply to this comment.
  10. AvatarDan
    10

    One more question: is there a way to style the previous/next links at the bottom of the TOC?

    Reply to this comment.
  11. AvatarQuandary
    11
    Author Comment

    [Fixed in head]

    Good questions. Sadly there is no API for getting the name of the current post’s series. Also, I have not created classes for the In Series previous/next links.

    Both are easy fixes, and I’ll roll them into my plans for 2.3.

    Reply to this comment.
  12. AvatarQuandary
    12
    Author Comment

    I might do another release for the classing bug; I’ve added the fix to the 2.2 maintenance branch, so you can give that a try (if you don’t want to run the latest SVN trunk version).

    Reply to this comment.
  13. AvatarDan
    13

    Great! Look forward to seeing upcoming releases. Thanks!

    Reply to this comment.
  14. AvatarKWiz
    14

    I’ve activated the plugin, updated my options, set up my series, etc. When I look at the posts in the series, sometimes I get a full Table of Contents with the Article Series and name of the series. Sometimes the TOC disappears and the only thing that appears is the Previous in Series, Next In Series link. How can I fix this so that for each post in the series it shows the Article Series, Name, TOC, AND the Previous/Next In Series?

    Reply to this comment.
  15. AvatarQuandary
    15
    Author Comment

    If it doesn’t show up for every one, that’s a bug. If you can get me access to the database details (I just need the postmeta table), that would be ideal. It’s probably an issue with one of the SQL queries.

    Reply to this comment.
  16. AvatarKWiz
    16

    Quandary,

    Not being a techie, I’m not sure what you’re asking for.

    Also, it is my understanding that I need to add some code into my single post template; however, I have not done that at all, and the plugin is working. Am I mistaken, or what?

    Thanks for supporting this plugin. Even with these slight issues, I absolutely love it!

    Reply to this comment.
  17. AvatarQuandary
    17
    Author Comment

    @KWiz

    As far as template editing goes: nope; one of the points of the 2.2 releases and beyond is to eliminate the requirement of editing templates. I realize that folks like you might want to have something that works “out of the box” without extra setup, hassle, and technical details.

    Reply to this comment.
  18. AvatarOriri
    18

    Love the plugin, having a blast organizing my articles with it - but for the life if me, I haven’t been able to get the ToC to stay at the bottom. I set it in the admin menu, but it resets to the top. Also, even after checking the show in multi box, the ToC doesn’t show up on my site’s default view. It shows up on the singles though. Is this a template issue? (Using the Melissa Theme by Lisa Sabin-Wilson, if that helps at all.)

    Sorry to be such a n00b!

    Reply to this comment.
  19. AvatarQuandary
    19
    Author Comment

    @Oriri

    Shh! Maybe everyone will install In Series 2.2.2 and no one will notice… ;)

    And the ToC in multi is a “missing feature.” I promise I’ll get it in eventually!

    Reply to this comment.

Leave a Reply

Comment Preview:

© 2009 REM State | Entries (RSS) and Comments (RSS)

Global Positioning System Gazettewordpress logo