« Archive complete | Main | Valentine Bride »

February 12, 2004

How To: The Scripturizer for Dummies

Update: 03.06.06! Wow, apparently this is quite useful to some people. It still works, as far as I know, for the latest versions of Movable Type. I noticed a lot of misspellings in this, so I am trying to correct it and make it as concise as possible.

The Scripturizer plugin is an extremely useful tool for Movable Type users. It turns Scripture quotations into active links to Bible Gateway's website in whatever version you prefer. So, say I'm typing along in my typical format...

...which is why I fail to see how anyone of a non-Calvinist position can read Romans 9:16 and not grasp His complete freedom in the bestowal or withholding of mercy, which He exercises not based on anything in man.

Click on it and you'll see where it leads. I've chosen the ESV for my website, but you can substitute it for the Bible version of your choice (KJV, NIV, NASB, etc.).

I have had quite a fun time learning how all this works as a newbie. Because I've failed to find good documentation anywhere on this plugin, I thought I'd provide some myself in the hopes that others will find it useful.

First, upload the code
Go to the website and locate the code. Copy the code from the first box (titled, Scripturizer.pl) into a new text file in any text editor. Save it as "Scripturizer.pl" and make sure it's text-only (not .rtf, nor .doc, etc.). Upload this into your Movable Type plugin folder. Here's how I did it at mine:

http://www.robhulson.com/mt/plugins/Scripturizer.pl

Copy the next bit of text (titled, "Scripturizer.pm"), save it as a file and name it “Scripturizer.pm” Put this one in the following directory:

http://www.robhulson.com/mt/extlib/Sermonizer/Scripturizer.pm

Notice you need to create a folder/directory in the /extlib folder called “Sermonizer.” Did I mention that exact spelling is essential?

Change permissions to 755
Change the permissions of both files to “755” and they’ll be usable files. Don’t ask me why; I’m a newbie! A visual FTP client will let you do this, and if you’re telnetting in, you probably already know how to chmod.

Log out
The documentation recommends you log out of your Movable Type admin. I figure you might as well do it.

Change the templates
Log back in. Here’s where things get dicey! I screwed up royally by misunderstanding what’s supposed to go on, here. I’m assuming you just want to add Scripturizer to your body entries, not sidebars and all that. If so, you need to alter your “Main Index,” and underneath all that (hidden to my eyes), locate the “Category Archive,” “Date-Based Archive,” and “Individual Archive” templates.

  1. Locate the tag <$MTEntryBody$> in each template.
  2. Change it to <$MTEntryBody scripturize="ESV"$> (it's not scripturizer, and make DOUBLY sure there are only two $ symbols. Say "No" to <$MTEntryBody$ scripturize="ESV"$>!
  3. Locate the tag <$MTEntryMore$> in each template.
  4. Chage it to <$MTEntryMore scripturize="ESV"$> Again, no "r" in scripturize and only two $ symbols. Both of these tell Movable Type that when it pulls up data from an entry body or extended entry, Scripturizer should look for Scripture references.

Conclusion
Save each time you update the code. When done, rebuild. If you follow this guide precisely and don’t misspell anything, this ought to work. Let me know if it does. I hope this helps the MT community.

Special thanks to Joseph Markey for helping clear things up for me, and to Dean Peters and Jonathan Fox for creating this thing in the first place.

Posted by rob at February 12, 2004 12:15 PM

Trackback Pings

TrackBack URL for this entry:
http://www.robhulson.com/mt/mt-tb.cgi/1

Listed below are links to weblogs that reference How To: The Scripturizer for Dummies:

» How To: The Scripturizer for Dummies from Heal Your Church Web Site
A week or two ago, I had a friendly back-n-forth with Ted Olsen at Christianity Today over what's "worthwhile" on the blogosphere. My perception is that what is trash to one reader, is treasure to another. That the beauty of... [Read More]

Tracked on February 13, 2004 11:14 AM

» Scripturizer Plugin from the Great Lands
The Scripturizer plugin for Movable Type is scheduled to be updated this weekend. I am looking forward to this and am excited about some of the new features. Rob Hulson has posted an excellent article explaining how to install the... [Read More]

Tracked on February 14, 2004 06:24 AM

» Scripturizer... from Knowtown...
I am slowly discovering the many fun things you can do in Movable Type. I have been experimenting with various plug-ins. I just installed the scripturizer, which takes scripture references (Genesis 1:1, Matt. 1:1-5 or Romans 12 for example) that... [Read More]

Tracked on March 17, 2004 03:20 PM

» Installing the scripturizer from tim's journal
Rob Hulson has a good post on the scripturizer for dummies. Though the Scripturizer.pm link doesn't seem to work. Here's what I did:Go to the version 1.2 blog and copy and paste Scripturizer.plGo to the version 1.3 blog and copy... [Read More]

Tracked on April 23, 2004 03:59 PM

» Scripturizer Plugin from faithful.geek
So last night while I was up until 3 AM, I downloaded and installed the Scripturizer plugin. This plugin causes Bible references in blog entries to automatically be transformed into links to BibleGateway. I have thus far been unable to... [Read More]

Tracked on January 31, 2005 09:14 AM

Comments

You’ve been blogged … and yes, I mean every nice thing I said about you on my blog!

Posted by: Mean Dean at February 13, 2004 11:16 AM

Hey, thanks for the help. My Scripturizer is working. I haven’t had the nerve to go for the patch to allow the abbreviated references to work. Would you consider writing a ‘dummies’ version for that as well? From the original, I am again left hanging, because the post assumes I know where to put the ‘patch’.

It gets a little tedious writing out Deuteronomy every time!

Posted by: Werner at February 13, 2004 11:40 AM

Hang in there Werner, One of my fixes is to put in abbreviations.

Posted by: Mean Dean at February 13, 2004 12:24 PM

Just wanted to say thanks, I was thinking of using the Scripturizer for a while now, but I didn’t know how to get it up and running.

Posted by: Kristen at February 13, 2004 09:31 PM

Hang in there, I’m just about done. I’ll have a post and an update on Sunday. Thanks for your input. I included a variant of Markey’s fix, it takes care of the space issue nicely.

I’m also working in abbreviations … on steriods … XHTML compliant ampersands … and a nice little flip/flop switch for ESV Bible fans.

Posted by: Mean Dean at February 13, 2004 11:03 PM

A while back (just after the esv api service first came out) I hacked the scripturize code so that it would use the api and some php and actually display the bible passage on my website, as opposed to linking off site. The advantage of this was so I could control the layout and design so remained very much part of my website. I’ve stop using the code now, as I for general linking and reading I prefer the New Living Translation. However I still have the code lying around somewhere. It’d need updating to the latest version, but I doubt that would be too hard.

Posted by: Sparticus at February 16, 2004 06:49 AM

OK… I am now officially a dweeb… I have looked at EVERY stinkin template in my MT control panel… and I have YET to find …. hmmmmm… (I know I can read, but… maybe its because its late at night - or I’m almost 40 :) )

Posted by: BrotherPhil at February 17, 2004 11:09 PM

Hey, Phil. Thanks a million! You’ve made me realize I put that key tag in backwards! The reason you couldn’t find it is because it’s <$MTEntryBody$> not <$MTBodyEntry$>

Whoa, do I feel sheepish! I knew it was too good to have it all correct in my first run-through. :o) I’ll make the change accordingly. In the code, BTW, this occurs a few lines after <div class=”blogbody”>

<smacks forehead>

Posted by: Rob Hulson at February 18, 2004 08:29 AM

I’ve done everything you said, read everything I could find, but the plugin isn’t working for me. Please help.

Posted by: David at February 25, 2004 04:51 PM

Ah… I’ve done everything you said to do as well as what some other pages have said, but I am totally lost, it’s not working for me either….

help?

Posted by: Valerie at April 19, 2004 11:45 AM

I tried your instructions, to no avail. I kept getting a @INC not found error, so I changed the Sermonizer/Scripture.pm file to Scripturizer (as recommened on Dean’s site) and that got rid of the error, but still no links on my verses. You can see my site from the URL posted with this comment.

-Joe

Posted by: faithful.geek [TypeKey Profile Page] at January 31, 2005 02:07 AM

Heh, as mentioned at the start of my entry, I’m no expert on this. All I know is what worked for me. You might ask Dean, as he’s always been a phenomenal amount of help to me.

Posted by: Rob Hulson [TypeKey Profile Page] at January 31, 2005 09:12 AM

Thanks for this very helpful tutorial.

One question. My templatees for Movable Type 3.2 don’t seem to have . Any idea how I get Scripturizer to process the extended entries?

Posted by: djtrouten [TypeKey Profile Page] at June 18, 2006 08:38 PM

Post a comment

Thanks for signing in, . Now you can comment. (sign out)

(If you haven't left a comment here before, you may need to be approved by the site owner before your comment will appear. Until then, it won't appear on the entry. Thanks for waiting.)


Remember me?