Profile Enhancements - Gender Bit: Show gender symbol next to username in postbits and many other places

My first public mod. Please be kind to me

Description:
Gender Bit shows gender symbol next to username in postbits. See "prerequisite" and "Installation guide" below.

Features:

• Fully uses plugins so there is no need to customize any templates
• Makes use of the built-in User Profile Field system
• Configurable through vBulletin Options
• Includes a number of male-or-female symbol sets to choose from
• Easily enable/disable the gender symbols in various places
  • Postbits, private messages, announcements etc
  • Memberlist
  • Profile pages
• No database changes, no extra queries (instead it utilizes existing queries to fetch the gender info), no template edits, in short, no mess.
• Version 1.0.2 and above: Now also takes care of default profile pictures and friends' avatars by showing default male/female avatar accordingly
• Version 1.0.2 and above: Exposes a globally-scoped function genderbit_getgender for other mods and plugins to make use (refer change logs below for details)
• New in 1.1.0: Support for the third gender type ...

Prerequisite:
A custom user profile field designated for members' gender must be manually created in user profile field manager. If your forum does not already have one and you have no idea how to create it, please read included README.txt for instructions.

Download guide:

• Download and install the latest version only. The older versions are there for record purpose only.
• The main product package file is Gender Bit x.x.x.zip. You would only need to install this to get the gender symbols in your postbits.
• Gender Bit Ext x.x.x (requires Gender Bit x.x.x).zip is an extension product that displays gender-aware default avatars for your users. Only install this if you want to have the default avatars showing sillhoutte of a man or a woman depending on your users' genders.

Installation guide:

1. Upload the includes and images folders (inside the zipped upload folder) to your vbulletin directory (usually /forum). The folders should merge with existing /forum/includes and /forum/images.
2. Import the product XML in AdminCP product manager. Then, head straight to the option page for Gender Bit under vBulletin Options.
3. Configure the "User profile field name" to be the name of the user profile field. Usually it is in the form of 'fieldX' where X is a number.
4. Also configure the "Field value: Male" and "Field value: Female" to be the value(s) of the profile field when a member selects "Male" or "Female" respectively. If there are multiple values that refer to male (or female), separate them using pipe characters, example: Boy|Gentleman
5. Lastly configure the other options to your likings.
6. Save and the gender symbol will appear in postbits for members who have set their gender profile field.

Upgrading guide:
Same as installation, with the only difference is to tick the "Overwrite" checkbox when importing the product xml). Also, you would need to check the options page (Admin CP > vBulletin Options > Gender Bit) for any new settings.

Uninstallation guide:
To uninstall simply uninstall the product from AdminCP product manager. Optionally delete the images and xml files:
/images/misc/gender_*.gif
/images/misc/unknown_*.gif
/includes/xml/bitfield_genderbit*.xml

Changelogs:

Version 1.0
- Initial version

Version 1.0.1
- Replaced align="absmiddle" with CSS to pass XHTML validation
- Extra image sets for male/female with a new option in vB Options to choose which set to use

Version 1.0.2
- Fixed php errors in private messages and a few other places
- New: Option to show gender symbol in memberlist
- New: Gender Bit can now take care of default profile pictures and friends' avatar to show default male/female avatar
- New: Exposes a globally-scoped function genderbit_getgender($registry, $userinfo, $unknown='') that returns 'male', 'female' or $unknown. The three parameters are:

• $registry: the vbulletin core object, usually $vbulletin but may be $this->registry in some vb classes
• $userinfo: the userinfo array, which usually holds 'userid' and 'username'
• $unknown: string to return if $userinfo does not contain gender information. default to empty string

Version 1.1.0
- Major revamps.
- Added: a lots more places where the gender symbols will appear, with options to turn each one of them on/off in vBulletin Options
- Added: the third gender for those who think two genders are not enough.
- Changed: Gender Bit will only look for the images in forumdir/images/misc by default unless overridden in vBulletin Options.
- Starting from this version, the handling of gender-aware default avatars and profile pictures have been separated into an extension product named "Gender Bit Extension". Gender Bit does NOT require Gender Bit Extension to operate but Gender Bit Extension REQUIRES Gender Bit.

Note: Should also work in vB 3.6.x, but I haven't done any testing in that vB version.

Troubleshooting (aka why aren't the symbols/images showing?)

Step 1:
In { AdminCP > vBulletin Options > Gendet Bit } check if you have configured "Field value: Male" and "Field value: Female" to match what your members would choose if they are male or female. If in your forum/language "Shalabadaba" means "male" and "Shubidubidu" means "female", enter Field value: Male = "Shalabadaba" and Field value: Female = "Shubidubidu". Just overwrite the default "Male" and "Female" in the textboxes.

Step 2 (version 1.1.0 and above):
Still in { AdminCP > vBulletin Options > Gendet Bit }. Try setting Gender symbols image set = "Text/Font" to see if the symbols appear. If it does then you forgot to upload the images into ALL /images/misc folders for ALL STYLES installed in your forum.

Step 3:
From your showthread pages, find the following part (page navigation):

Right-click on the down-pointing arrow and select "Properties" from the popup menu. Check the path to the file, usually in the form of "http://www.yoursite.net/forum/images/misc/menu_open.gif". The bolded part is the path of the misc images folder for your current style. If it says "http://www.yoursite.net/forum/images/yuppie/v4/misc/menu_open.gif" then upload the gender images into forum/images/yuppie/v4/misc/

[gamerfu]

Originally Posted by Nadeemjp

yes isr I did all these steps and yet nothing is appearing in the profile or with the user name.
in the very first post of a thread, however, i can see a little "noVstats" written in the bottom left of the first post....i dont know why it is there.

is there any suggestion?

Glad someone brought this up!

I have uploaded all the files and followed all the instructions too.

I am having the same problem, but on my board they do not display at all.

All files uploaded too.

It was after I installed EXT. I have uninstalled and deleted and reinstalled and reuploaded more than enough times.

Installed 1.0.2 and 1.1.0, both do not work.

Could you take a look at my board ReCom?

[Nadeemjp]

oh i figured out what was wrong

actually there were 2 things.

1) when i created the field, i accidently instead of assigning the field number in the vb options, assigned the field display order number. (both are different since i have been creating and deleting fields). when i corrected the field number, the sign appeared.

2) then another thing i was not doing correctly was that when you write your preferences like boy or gentleman or male or female or lady etc, if you write in upper case then the members have to write accordingly. if the upper case is mixed with lower case, then the images wont display.

I am glad that i figured out this, but i am really disappointed in the support. no support has been provided here which is really frustrating and i might even uninstall this hack as an agitation.

[gamerfu]

I did everything, even what is stated above. Also, the Text does not display.

Still not working...

[Sunka]

Installed.
Thank you!

[ReCom]

I was visiting my hometown, that has no internet access, for one week and just look at people whining as if they paid me for my supports. Many others managed to install and get this thing working on their forums in many languages so if something is wrong, it's your forum, or you.

Uninstall it, or delete it from your recycle bin. I lose nothing, just like I gain nothing posting this addon up and answering posts.

I am disappointed in losers.

[Hasann]

thanks it is working fine

[gamerfu]

Originally Posted by ReCom

I was visiting my hometown, that has no internet access, for one week and just look at people whining as if they paid me for my supports. Many others managed to install and get this thing working on their forums in many languages so if something is wrong, it's your forum, or you.

Uninstall it, or delete it from your recycle bin. I lose nothing, just like I gain nothing posting this addon up and answering posts.

I am disappointed in losers.

I installed the Genderbit, then installed the EXT before setting the profile fields. How can I clean out my database to fix this?

It has not been working after that. No matter what I do.

[ReCom]

Originally Posted by gamerfu

I installed the Genderbit, then installed the EXT before setting the profile fields. How can I clean out my database to fix this?

It has not been working after that. No matter what I do.

Gender Bit and Ext do not modify your database (other than what vbulletin does to absorb the addon into its environment). To uninstall them, just use the product manager (uninstall Ext before Gender Bit). Nothing will be left over in the database.

Post up link to your forum and a screenshot of the Gender Bit options AdminCP page, and I'll point out what you did wrong.

[gamerfu]

Here are the pictures you requested.

Simple fix? :erm: *crosses fingers*

[ReCom]

Originally Posted by gamerfu

Here are the pictures you requested.

Simple fix? :erm: *crosses fingers*

In the fifth picture (the big "User Profile Field Name") you should enter field60 instead of just 60.

Yup, a simple fix indeed. All these troubles would have not happened if you had looked at the 2nd screenshot in the main post above for the sample how the User Profile Field Name should be entered.