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.

[zeroality]

Dude you have no idea how awesome this is for a Pokemon-based message board since Pokemon themselves do hatch from eggs and 'evolve' in stages.

In fact, the egg sprite in those screenshots looks like it was ripped off of the Gameboy Advance games?

Looks great. I'll install tomorrow most likely.

[antialiasis]

Heh, indeed it was. Pok?mon fan with Pok?mon forum here.

[zeroality]

That explains it. Well, I finally got around to actually doing this but now I have a problem.

I created an adoptable but the 'next stage' stuff isn't working.

I am 99% sure that I put in all the stuff properly and it works just fine, creates the adoptable. They just don't go on to the next stage when the user gets the appropriate number of posts. There are no errors either.

Any ideas? :\

[antialiasis]

That's most likely just because the adoptables are updated via a scheduled task. It should run every hour exactly (as in one o'clock, two o'clock, three o'clock, etc). Wait until that time has passed and then see if it hasn't been updated.

(You can, of course, run the scheduled task immediately through the Admin CP if you'd rather not wait to test it - not that said adoptable shouldn't already have been updated now, if the member had enough posts at the time you posted here.)

[zeroality]

I removed all the stages so no, it didn't update because there's nothing to update.

I'll check that out, thanks.

[givemeplain]

nice hack. by any chance could you make it that more than one user can adopt the same thing? by making an adoptable unique to every person, there would have to be hundreds to accomdate any medium sized - larger forum.

[Doc31]

Originally Posted by 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

I third forth and fith this motion. needs to have a link to adoptable in postbit or people dont know you even have one unless they check your profile. and who bothers with that.

[haytham]

Maybe it is a mistake on my side but I doubt it. I have installed this hack and all hell broke lose on my forum. I can't modify permissions for groups. I get this erroratabase error in vBulletin 3.6.1:

Invalid SQL:
UPDATE usergroup SET

### UPDATE QUERY GENERATED BY fetch_query_sql() ###
`title` = 'Registered Users',
`description` = '',
`usertitle` = '',
`opentag` = '',
`closetag` = '',
`passwordexpires` = '0',
`passwordhistory` = '0',
`adoptpermissions` = '15',
`maxadopted` = '5',
`arcadepermissions` = '7',
`forumpermissions` = '1044991',
`genericpermissions` = '304723919',
`attachlimit` = '0',
`pmquota` = '50',
`pmpermissions` = '3',
`pmsendmax` = '0',
`calendarpermissions` = '17',
`wolpermissions` = '1',
`adminpermissions` = '0',
`genericoptions` = '63',
`profilepicmaxwidth` = '100',
`profilepicmaxheight` = '100',
`profilepicmaxsize` = '65535',
`avatarmaxwidth` = '80',
`avatarmaxheight` = '80',
`avatarmaxsize` = '20000',
`signaturepermissions` = '172031',
`sigpicmaxwidth` = '500',
`sigpicmaxheight` = '100',
`sigpicmaxsize` = '20000',
`sigmaxrawchars` = '800',
`sigmaxchars` = '400',
`sigmaxlines` = '0',
`sigmaxsizebbcode` = '7',
`sigmaximages` = '2'
WHERE usergroupid=2;

MySQL Error : Unknown column 'adoptpermissions' in 'field list'
Error Number : 1054
Date : Friday, October 13th 2006 @ 06:34:18 AM
Script : http://www.XXXX.com/XXX/admincp/usergroup.php?do=update
Referrer : http://www.XXXX.com/XXX/admincp/user...&usergroupid=2
IP Address : XXX.229.XXX.84
Username : haytham
Classname : vb_database
=====================================
I tried to uninstall the hack but got this message:
-------------
Database error in vBulletin 3.6.1:

Invalid SQL:
DROP TABLE adopt;

MySQL Error : Unknown table 'adopt'
Error Number : 1051
Date : Friday, October 13th 2006 @ 06:37:06 AM
Script : http://www.XXXX.com/XXX/admincp/plug...do=productkill
Referrer : http://www.XXXX.com/XXX/admincp/plug...=adoptables&s=
IP Address : XXX.229.XXX.84
Username : haytham
Classname : vb_database
-==================================
so what can I do now to uninstall this hack?

[antialiasis]

Hmm, it looks like something went wrong during the installation itself. Couldn't be sure exactly what it is, but from the looks of it, the hack isn't really installed at your forum so you don't exactly need to uninstall it...

Okay, the code seems to be a little buggy. I'm going to reupload the product and you can try it again.

[Ophelia]

I would like for the egg to show up in the area where their name is when they post (I can never remember what that is called). Right under their avatar. Is there a way to do this?