vBstory - an Interactive Story for vB (1.0 Final)

.

This script is pretty much dead - but if you wanted to see the concept live on, visit http://unknowntales.net/



----------------
Author
----------------

VBstory (1.0 Final)
by Daniel Hollands of Ninth Dimension.
http://ninthdimension.biz/

I do custom vB scripts as well as web design and development using PHP and MySQL.
If you would like some more information on the work I do, please visit the URL above.

----------------
About
----------------

This hack allows you to add an Interactive Story to your forum.

Once a user has chosen a story arranged into genres, they will be presented with
a chapter to read. After reading this chapter they will be presented with two
paths to follow, both of which will present a new chapter, and a further two
paths.

Eventually the user will be given the ability to add their own chapters to the
database, which will be done via a form presented on the site.

Hopefully this will encourage your users to be more active on your site, thus
giving you a higher hit rate.

----------------
Install
----------------

PLEASE MAKE A BACKUP OF ANY FILES EDITED AND YOUR DATABASE BEFORE
INSTALLING THIS HACK. If you loose all your data as a result of installing this
hack, it's your fault, not mine.

1, Upload the vbstory.php file to your forum root directory.
2, Upload the vbstory_admin.php file to your admin directory.
3, Upload the two images to your images directory.
4, Run the three SQL queries in the sql.txt file (don't just run this file, read it).
5, Add the templates listed in the templates.txt file to your site.
6, Make the file changes listed in the files.txt file. (Only one is required).
7, Using the new menu items in your admin panel (you might need to refresh it
after adding the templates) add at least one genre, and as many stories as you
want.
8, Link to vbstory.php (some examples will be provided in the final release.
9, Post a link to your vBstory in the vBstory thread on vB.org.
10, !GOLDEN RULE! Enjoy.
11, (Optional) If you want your Super Mods to have access to the admin scripts,
just upload the vbstory_admin.php file to your mod directory and complete the first
file edit instruction on the index.php file in your mod directory.

----------------
Upgrade
----------------

If you are running vBstory beta 0.5 or later you will not need to run the SQL
queries again. However if you want a fresh install, you will need to remove the
three vbs_ tables from your database.

IMPORTANT - You will need to replace ALL your vbstory templates with the new ones contained
within this archive. EVERY template has been changed.

----------------
To Do
----------------

I've not really got any more plans for this version of vBstory. I will be making a
more advanced version of vBstory for my own use, but I've not yet decided if I'm
going to release it yet.

----------------
Support
----------------

So far as I can tell, this version of vBstory is fully bug free. After a little while,
provided no errors are reported, I'll be releasing this as a final.

If you have any problems running or using this hack, please post a message in
the vBstory thread at vB.org. If you receive a serious error, I'll try to provide
support via IM (AIM, ICQ, MSN or Yahoo).

----------------
Demo
----------------

No demo at the moment, will be back soon.

[Ninth Dimension]

<font size="4">F.A.Q. for vBstory</font>

Q: where does Suggest a Story get mailed to?
A: when someone submits a story it get's added directly to the database but not displayed. You need to go into the Admin CP and select to display the story if you like it.

Q: Which versons of vB will this work with.
A: It should work with all versons from it's development verson (vB v2.2.6) right up to the current (vB v2.3.0) and beyond (i've not yet had a mess about with vB 3, so i've no idea about that, but in theory, yes).

[[D]Vincent]

So what all was added onto in this version?

[Ninth Dimension]

The only thing new in this verson is that the path that was chosen is displayed on the add chapter form.

It's 100% stable and working as I like it at the moment so I've decided to remove it from the beta forum.

[Erwin]

Great to hear that is alpha! Shall upgrade when I find the time...

[xxxsaint]

A neat little tweak for your online.php maybe ?
------------------------------
case 'vbstory':
$userinfo[where] = "Reading an <a href='vbstory.php'> interactive story </a>";
break;
-------------------------------

i like it , it's awesome ty and this helps have another way to direct people to it

[Ninth Dimension]

That's a good idea, I personally left the link out of the line because I was worried that some ppl might be running it in another dir that the forum dir (like me) but then if I think about it, anyone that can run it in another dir without problems should easily be able to edit the link.

If I add any new features i'll change the info in the online.php file

[NexDog]

Yea, will install this in the afternoon. Thanks for getting it out of Beta!

[NexDog]

[high]* NexDog clicks install
[/high]

http://www.hostnexus.com/forum/vbstory.php

Which template is that typo in?

Please choose a grenre from the list below:

[NexDog]

Ummm, where does Suggest a Story get mailed to? Haven't received anything at the forum admin address.