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.

[theArchitect]

Nice. But is there any chance of a screen shot or a working demo?

Or have you posted those and I just missed them?

[Pathor]

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

..

[Yukino_AE]

this is almost like p3tz lite.

[antialiasis]

Not really. The fundamental difference is that the adoptables don't actually do anything; they're just there. They don't get hungry, need care or anything.

[cooldude714]

I get this MySQL error when I try to edit user group permissions to use it and try to uninstall it as a product.

Database error in vBulletin 3.6.0:

Invalid SQL:
UPDATE usergroup SET

### UPDATE QUERY GENERATED BY fetch_query_sql() ###
	`title` = 'Administrators',
	`description` = '',
	`usertitle` = '',
	`opentag` = '<font color=\"red\"><b>',
	`closetag` = '</b></font>',
	`passwordexpires` = '180',
	`passwordhistory` = '360',
	`forumpermissions` = '1048575',
	`genericpermissions` = '1073741759',
	`attachlimit` = '0',
	`pmquota` = '50',
	`pmpermissions` = '7',
	`pmsendmax` = '5',
	`calendarpermissions` = '63',
	`wolpermissions` = '31',
	`adminpermissions` = '3',
	`genericoptions` = '55',
	`profilepicmaxwidth` = '100',
	`profilepicmaxheight` = '100',
	`profilepicmaxsize` = '65535',
	`avatarmaxwidth` = '80',
	`avatarmaxheight` = '80',
	`avatarmaxsize` = '20000',
	`signaturepermissions` = '245759',
	`sigpicmaxwidth` = '500',
	`sigpicmaxheight` = '100',
	`sigpicmaxsize` = '2000',
	`sigmaxrawchars` = '0',
	`sigmaxchars` = '0',
	`sigmaxlines` = '0',
	`sigmaxsizebbcode` = '7',
	`sigmaximages` = '0',
	`adoptpermissions` = '15',
	`maxadopted` = '50',
	`hkc_competition_permissions` = '3',
	`vbppermissions` = '65529',
	`vbp_discountrate` = '5.00000',
	`vbp_paycheckamount` = '500.00000',
	`vbp_secondarycost` = '0.00000',
	`vbp_primarycost` = '0.00000'
WHERE usergroupid=6;

MySQL Error  : Unknown column 'adoptpermissions' in 'field list'
Error Number : 1054
Date         : Saturday, August 5th 2006 @ 07:01:50 PM
Script       : http://www.limeo.co.uk/community/admincp/usergroup.php?do=update
Referrer     : http://www.limeo.co.uk/community/admincp/usergroup.php?do=edit&usergroupid=6
IP Address   : 84.68.246.195
Username     : Squashter
Classname    : vb_database

Can someone help?

[ssslippy]

Fails to work for me, cant edit the usergroup settings and also gives error for uninstall.

[mighty_warrior]

looks good.thanks

[antialiasis]

Eep... I've been on vacation, but now I return to find a major problem with my hack. @_@

Okay, those were two related problems, both of which have been fixed now. Since the fix edited only the install and uninstall codes, I don't think it's necessary to make this into a separate version. I think you should be okay with just reinstalling the product, but if you get a database error, then run this SQL query:

ALTER TABLE usergroup DROP maxadopted

and then you should definitely be fine when you run through the install process again. Sorry about that; I'm not sure how I managed to miss it when originally testing the hack.

[Spookysalem]

Love it thanks.

Just need to find some adoptables now