This is a quick guide to getting started with the Bible Field Drupal module.
Adding the field to your content type
Click the "Manage Fields" link next to your content type in /admin/content/types and scroll down to the bottom. Select the "Bible reference" type and fill in the rest of the form.
Next, choose your settings. There are two settings specific to Bible Field, the Version and the alphabetical sorting. If set to sort alphabetically, any book fields will be sorted from 1-9 and A-Z, otherwise the sorting will follow the default, which is likely the real order.
The version allows you to select from multiple Bible versions. As an example of using a different source file, I've added a file called hitchhikers_guide_to_the_galaxy.txt in the optional_csv folder to demonstrate how Bible Field can be used for any book reference. If you drag this file over to the bible_csv folder, you'll be able to choose from the default King James Bible or the Hitchhiker's Guide to the Galaxy.
Using the field
Now that you've added the field, you can add references in your nodes. Go to the node add page for the content type you added the field to, and you should see the following:
Here you can select as many references as you need to. When you select a book, the chapter input will automatically be populated with the number of chapters in that book. Choose a starting chapter will automatically set the ending chapter to the same number.
Setting up filters in Views
Once you have content with references, you can set up a View. You can use the book, starting chapter, ending chapter, starting verse and ending verse fields, but there are two special filters as well.
The first is a range selector, to allow searching through a range of chapters and verses.
First, click the plus button next to the Filters section of the view to add a new filter, and select the Content category. Scroll down until you see the following, check the 'Ending chapter' or 'Starting chapter' and click the Add button.
Now you'll see the settings form for the filter. The special one available here is called "Within start and end range, as you see below:
If you select that, and expose the filter, you'll see a select input with a list of chapters. To make this most useful, also add a filter for the book as well and expose it. The resulting form might look something like this when you preview it in Views:
If you do this, the chapter select input should auto-fill with the number of chapters in the selected book. So if someone is doing a search for Genesis, chapter 5, and a piece of content matches a range of Genesis chapters 3-10, it will match.
The second special filter is simple and granular. Add a new filter, select to show only Content filters, and select the "Bible field composite" item, as seen below:
This will open up an options form to allow you to select the granularity of the input. You can choose to display just the book, the book and chapter, or the book, chapter and verse inputs, as you see below:
This filter works only as an exposed filter, so make sure to expose it. When you do, it should look something like this if you selected 'verse' for the granularity:
That's it, enjoy!