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.

[antialiasis]

Originally Posted by dt~

Uninstalled.

Well, that's too bad, since I just added one of your features... =/

The other one turned out to be bit too much of a hassle code-wise for a not-particularly-useful feature, so I thought it wasn't really worth it in the long run. After all, if you want to see somebody's adoptables, you can just view their profile.

[dashaka2]

I like the idea of this. I have a collectible card site. I was wondering If I can hatch an image of a card. If I can that would be perfect.

Can the Admin setup a page that the users can pick from?

Can users trade them?

Also are there any websites that I can see a working demo on this and what pages it effects?

Looking forward to the repsonses

[AMFMaree]

I like this idea but I would like to have some creatures with it.. I wouldnt know the first thing about creating them.

[AMFMaree]

I second the motion to have a link or the egg within the postbit ...

Once again.. are you going to supply the gifs for us to have a selection to add.. it would be nice if you could..pretty please

[EasyTarget]

cool hack.

how about an option to make your adoptable turn into a fighting creature and pit peoples adoptables against eachother? The adoptables which are more mature can get new features or something

You could challenge someone's adoptable if they have set their status to be available for fights.

maybe an adoptable cemetery if there's like a life expectancy for each adoptable.

or what about adoptables that require care? maybe combine this with vbplaza/vbux so that users can user their points to buy stuff for their adoptable. (food, water, collar, etc) And you can use the vbplaza setting to display gifts, but display stuff that the adoptables have instead.

maybe a runaway center for adoptables that have left their owners do to lack of care.

[Pamela]

This is such a cute idea!!! Can you...or anyone...supply some pet images though. I don't have a clue how to make them myself!

[Reeve of shinra]

These kind of hacks are always very popular... I am sure some people are going to worship you for releasing this. =)

[antialiasis]

Originally Posted by dashaka2

I like the idea of this. I have a collectible card site. I was wondering If I can hatch an image of a card. If I can that would be perfect.

Can the Admin setup a page that the users can pick from?

Can users trade them?

Also are there any websites that I can see a working demo on this and what pages it effects?

Looking forward to the repsonses

You can make any image you want hatch from the egg.

I'm not sure what you mean by the second question - there is already a page listing all available adoptables which users can access.

They can not be traded directly at the moment, but such a feature could probably be implemented in later versions.

This doesn't affect any existing pages except the user profile page - the rest of the adoption center is contained in a new file that you upload when you install the hack. The other template edit is just to add the adoption center link to the navbar.

As for a working demo, well, on my site guests can't see adoptables and my test forum is not accessible from any other IPs than mine, so I guess somebody else would have to show you one. =/ At least you have the screenshots.

I like this idea but I would like to have some creatures with it.. I wouldnt know the first thing about creating them.

This is such a cute idea!!! Can you...or anyone...supply some pet images though. I don't have a clue how to make them myself!

Well, the thing is that I'm no better at it than you are. I let my users create adoptables for each other, and then just watch on the sidelines. So sorry, I'm afraid I can't supply you with pet images.

cool hack.

how about an option to make your adoptable turn into a fighting creature and pit peoples adoptables against eachother? The adoptables which are more mature can get new features or something

You could challenge someone's adoptable if they have set their status to be available for fights.

maybe an adoptable cemetery if there's like a life expectancy for each adoptable.

or what about adoptables that require care? maybe combine this with vbplaza/vbux so that users can user their points to buy stuff for their adoptable. (food, water, collar, etc) And you can use the vbplaza setting to display gifts, but display stuff that the adoptables have instead.

maybe a runaway center for adoptables that have left their owners do to lack of care.

I think you're looking for something more like P3tz. That's a full-fledged virtual pet thing that's compatible with currency systems where the pets can fight each other and need care. This is meant just to be a simple little thing if you're not looking for all those features and just want your users to be able to adopt something and then leave it alone.

[Renae]

I also second having the adopted animal on the postbit, instead of the profile. I'm sure this would not be hard to do though. I'm sure it's just moving things around. Or even in both.

I understand you cannot make the adoptables, I dont' think I can either. I've been asking members to step up and make them. But maybe we can set up some sort of sharing here, so that if one forurm has a bunch and they want to share, the other people can use their animals too. Just an idea.

[antialiasis]

The problem with putting adoptables in the postbit is mostly all the queries it adds to every thread view.