Adoptables hack

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 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 "I have installed this hack".


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 server directory.


Support

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


Version history

1.2: Added feature to allow or disallow normal users to view full adoptable list. To upgrade: Download the new zip file, reinstall the product with Allow Overwrite definitely set to ON, and reupload adopt.php.
1.1: Fixed missing templates and custom Who's Online status bug. To upgrade: Download the zip file again and reinstall the product, making sure that Allow Overwrite is set to ON. Nothing else has been changed.
1.0: Initial release.

[FLMom]

sounds cute and something I might be interested in..do you have any screenshots?

[The Chief]

we need screenies

[antialiasis]

Oh, yeah, the screenies. I tend to forget them for some reason.

I'm making some now. Should be there in a couple of minutes.

EDIT: Screenshots added.

[The Chief]

Originally Posted by antialiasis

Oh, yeah, the screenies. I tend to forget them for some reason.

I'm making some now. Should be there in a couple of minutes.

EDIT: Screenshots added.

Looks interesting, I might give it a shot tommorow ;D

[FLMom]

I am also going to try it out tomorrow when I have more time. Good job and thank you :banana:

[Protoman]

is this almost like a pets sorta thing? but based on posting?

and at some point can you make them die so they have to adopt a new one?

[Dan]

Interesting modification. Nice job I see a lot of promise with this one.

[dirtycrow]

what do they look like once they hatch?

[FLMom]

I tried installing it but had trouble, so I will try again in the morning

Also, can you recommend a place to put the Adoption Link, I tried placing it in several different spots within my navbar template and none worked. Thanks!