Major Additions - Adoptables hack for vBulletin 3.6

(For screenshots, please view this thread for vBulletin 3.5.)

Note that if you already have this installed for vBulletin 3.5 and then upgrade to 3.6, it should not be necessary to upgrade this hack; however, if something is wrong, by all means try the new product. No changes have been made to the hack files since the 3.5 version.

----------------------------

This hack adds a little adoption center to your forum where your users can adopt lovely little adoptables which will be 'upgraded' as the user gains the posts needed for the next stage. (Thus, an adoptable can be originally adopted as an egg, ten posts later the egg has cracks in it, twenty posts after that it hatches into a baby [insert something cute and loveable here], still fifty posts after that it has grown a little, and 100 posts later it's an adult - or something in that direction.)

2 template edits
4 files to upload
1 product to install


FEATURES

Admin features
- Specify which usergroups can view adoptables, which can adopt, which can create adoptables and which can edit/delete others' adoptables
- Specify whether all users can view the full adoptable list or only those who can administer adoptables
- Specify a maximum number of adopted adoptables per user for each user group
- Specify whether users can adopt adoptables that they created themselves
- Specify whether to use a "general description" for each adoptable, a description for each stage for an adoptable, or both

Adoptable creation features
- Create adoptables with up to five "stages", each with its own image, minimum posts to adopt it, user-specified posts needed to get from the previous stage to this one, and a custom description (if stage descriptions are enabled)
- View list of all your created adoptables
- Edit the adoptables that you have already created if you slipped up
- Only the first stage can be seen by a potential owner - surprise them with what their adoptable grows into

Adoptable management features
- Easily view a list of all adoptables (adopted and available)
- Edit or delete any adoptable easily from the list

Adopter features
- View a list of all available adoptables, only a button-click away from being yours, or of your own adoptables
- Disown an adoptable if you change your mind
- Release adoptables that are at their final stage to the wild so you can adopt new ones without leaving them for somebody else to pick up
- Show your own adoptables off in your profile


INSTALLATION

1. Download the zip file attached to this post and unzip it.
2. Upload all the files from the upload folder to the appropriate folder in your forum directory.
3. Import product-adoptables.xml through the Admin CP.
4. Two template edits:

###########################################
###########################################

In template MEMBERINFO

FIND

$footer

ABOVE it add

$useradoptables

############################################
############################################

In template navbar

WHERE YOU WANT THE ADOPTION CENTER LINK, add

		<if condition="$permissions['adoptpermissions'] & $vbulletin->bf_ugp_adoptpermissions['canview']"><td class="vbmenu_control"><a href="adopt.php$session[sessionurl_q]">$vbphrase[adoption_center]</a></td></if>

############################################
############################################


5. Modify the adoptable permissions for all your usergroups and the adoptable options under vBulletin options as you want them.
6. You're done! Go notify your users. And if you like it, click Install.


UNINSTALLATION

1. Undo the two template edits above.
2. Uninstall the Adoptables product.
3. Remove adopt.php, includes/functions_adopt.php, includes/xml/bitfield_adoptables.xml and includes/cron/updateadoptables.php from your forum directory.


SUPPORT

Just ask in this thread and I'll do the best I can to help.

[Hoffi]

Is it possible to integrate this with vbBux?
So that you can chosse in Admin CP:
Adoptions cost one Time Money,
Adoptions cost daily Money (or other returning issues)
If you Adopt, yo get Money.

[Ninth Dimension]

This looks like a great hack, just the sort of thing that would work very well on my site... but without any pets included, I can't use it.

I was wondering, has anyone here created any images for this hack, and if so, are they willing to share?

[barny11]

installed today and been running some tests before giving it to our members but have come across a problem.

for some reason its not moving onto the next stage when your post count reaches the minimum posts required to advance.

have double and triple checked the install and all seems ok

any ideas ?

[Spookysalem]

I have noticed this too.....

[antialiasis]

It moves on to the next stage via a scheduled task which runs every hour - it won't happen immediately, and not at all if there is no traffic on the forum to run the cron.

[Spookysalem]

what is the scheduled task that needs to run..?

[antialiasis]

I think I called it something like "Update adoptable stage", and it should have been included with the product as per the 3.6 features that make everything easier. (The cron file was included in the zip package.)

EDIT: Hmm. Oddly, the scheduled task doesn't appear to be part of the product XML, even though the phrases from the task are in the product. Well, I'm putting in the right XML now, and to fix that if you've already installed it, you should just add a new scheduled task, give it the varname "updateadotables", leave all the time settings at the default * except that the first "Minutes" should be 0, set Active to Yes, Log Entries to No, Filename to ./includes/cron/updateadoptables.php, the Product to the Adoptables hack and vBulletin Default to Yes.

[Spookysalem]

Originally Posted by antialiasis

I think I called it something like "Update adoptable stage", and it should have been included with the product as per the 3.6 features that make everything easier. (The cron file was included in the zip package.)

EDIT: Hmm. Oddly, the scheduled task doesn't appear to be part of the product XML, even though the phrases from the task are in the product. Well, I'm putting in the right XML now, and to fix that if you've already installed it, you should just add a new scheduled task, give it the varname "updateadotables", leave all the time settings at the default * except that the first "Minutes" should be 0, set Active to Yes, Log Entries to No, Filename to .includes/cron/updateadoptables.php, the Product to the Adoptables hack and vBulletin Default to Yes.

The part highlighted in your post i could not see where i set it up.

When i run it...it get this error

Warning: main(/home/xxx/xxx/.includes/cron/updateadoptables.php) [function.main]: failed to open stream: No such file or directory in /admincp/cronadmin.php on line 108

Warning: main() [function.include]: Failed opening '/home/xxx/xxx/.includes/cron/updateadoptables.php' for inclusion (include_path='.:/usr/lib/php:/usr/local/lib/php') in /admincp/cronadmin.php on line 108

and now nothing works at all to do with the adoptables.

[antialiasis]

Bleh, that was just a typo... there should be a slash after the . in the file path, of course.

And the vBulletin Default? setting should be at the bottom of the page for creating a new scheduled task in 3.6.

[Spookysalem]

Found the default setting thanks.

However for some reason the adoption tables have gone...is there any way to get them replaced..

thanks