Register Members List Search Today's Posts Mark Forums Read

Reply
 
Mod Options
Gender Bit: Show gender symbol next to username in postbits and many other places Details »
Gender Bit: Show gender symbol next to username in postbits and many other places
Mod Version: 1.1.0, by ReCom (Member) ReCom is offline
Developer Last Online: Jul 2014 I like it Show Printable Version Email this Page

This modification is in the archives.
vB Version: 3.7.x Rating: (15 votes - 4.80 average) Installs: 158
Released: 20 Nov 2008 Last Update: 27 Nov 2008 Downloads: 1229
Not Supported Uses Plugins Additional Files Re-usable Code  

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/

Download Now

Only licensed members can download files, Click Here for more information.

Screenshots

Click image for larger version

Name:	genderbit.gif
Views:	477
Size:	2.2 KB
ID:	89582   Click image for larger version

Name:	genderbit_cfg.gif
Views:	1003
Size:	23.9 KB
ID:	89583   Click image for larger version

Name:	genderbit_imgset.gif
Views:	1049
Size:	6.5 KB
ID:	89630   Click image for larger version

Name:	genderbit_profile.gif
Views:	972
Size:	83.4 KB
ID:	89679  

Show Your Support

  • To receive notifications regarding updates -> Click to Mark as Installed.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
Comments
  #2  
Old 20 Nov 2008, 03:19
ReCom ReCom is offline
 
Join Date: Mar 2008
First post reserved!

My first public mod (although I've created a number of mods used only on my site).

Please be kind to me
Reply With Quote
  #3  
Old 20 Nov 2008, 04:17
DarkGizmo DarkGizmo is offline
 
Join Date: Apr 2008
Real name: Anthony
Cool mod! installed!
Reply With Quote
  #4  
Old 20 Nov 2008, 07:08
ReCom ReCom is offline
 
Join Date: Mar 2008
I just realized that in the normal postbit template (non-legacy), both options in the "Gender bit location in postbit" setting give the same result but if the forum uses postbit_legacy, the result will be different. I only tested it on postbit_legacy so I was not aware that that particular setting doesn't do much difference in normal postbit. All is good though.
Reply With Quote
  #5  
Old 20 Nov 2008, 07:27
sensimilla sensimilla is offline
 
Join Date: Dec 2004
Real name: Eric Estrada
Ive just installed previous version by peterska yesterday, but i might look into your code aswell, thanks.
Reply With Quote
  #6  
Old 20 Nov 2008, 14:31
Ash Ketchum's Avatar
Ash Ketchum Ash Ketchum is offline
 
Join Date: Jan 2008
Real name: Jonathan
I can't seem to install it....
__________________
To right the countless wrongs of our days. We shine this light of true redemption. That this place would become a paradise. What a wonderful world such would be....
Reply With Quote
  #7  
Old 20 Nov 2008, 23:38
ReCom ReCom is offline
 
Join Date: Mar 2008
Originally Posted by Ash Ketchum View Post
I can't seem to install it....
Did you import the included product-genderbit.xml file in AdminCP > Plugins & Products > Manage Products ?

Did you create a custom user profile page for members' gender using AdminCP > User Profile Fields > Add New User Profile Field ?

Did you configure Gender Bit to use that custom user profile field in Admin CP > vBulletin Options > vBulletin Options > Gender Bit ?
Reply With Quote
  #8  
Old 21 Nov 2008, 00:43
neoxi's Avatar
neoxi neoxi is offline
 
Join Date: Mar 2007
Real name: Ozgur
thank you.. installed
__________________
Özgür Dünya Özgürce Düşler
Reply With Quote
  #9  
Old 21 Nov 2008, 01:01
P.Jackson P.Jackson is offline
 
Join Date: Sep 2003
Real name: Paul
anyone got images for a dark based forum?
Reply With Quote
  #10  
Old 21 Nov 2008, 07:27
ReCom ReCom is offline
 
Join Date: Mar 2008
Originally Posted by P.Jackson View Post
anyone got images for a dark based forum?
Version 1.0.1 comes with a few image sets to choose from. Re-download the package above and install+upload. "Pixel Precision", "Japanese Kanji", "Bee & Flower" and "Toilet Sign" sets should look okay in dark-styled forum. Test for me please?
Reply With Quote
  #11  
Old 21 Nov 2008, 13:49
PAKIDIL PAKIDIL is offline
 
Join Date: Jan 2007
i want to know formats like .swf or flv will work using this hack ?
Reply With Quote
  #12  
Old 21 Nov 2008, 15:13
ReCom ReCom is offline
 
Join Date: Mar 2008
Originally Posted by PAKIDIL View Post
i want to know formats like .swf or flv will work using this hack ?
What are you going to do with the .swf or .flv?
Reply With Quote
  #13  
Old 22 Nov 2008, 08:19
LisaJH LisaJH is offline
 
Join Date: Nov 2007
Real name: LJ
I dont understand what i have to write in the Profile Field bit....
__________________
www.wildmums.com
Reply With Quote
  #14  
Old 22 Nov 2008, 09:10
ReCom ReCom is offline
 
Join Date: Mar 2008
Originally Posted by LisaJH View Post
I dont understand what i have to write in the Profile Field bit....
Please refer to the second screenshot and see if it helps you, otherwise read on.

First, do you already have a User Profile Field for gender (look in AdminCP > User Profile Fields > User Profile Field Manager).

If you don't, create one by going to AdminCP > User Profile Fields > Add New User Profile Field. Select Profile Field Type = Single-selection Menu and click 'Continue'. On the next page put title, descriptions etc, but for the Options box, enter 'male' and 'female' text in your forum language. Save the new user profile field.

Back in User Profile Field Manager, find the user profile field for gender that you created. Look at its 'Name' column, there should be 'fieldX' written there (where X is a number). In my forum it is 'field5' but it might be different in yours.

Now go to AdminCP > vBulletin Options > vBulletin Options > Gender Bit and enter the 'fieldX' in the "User profile field name". Also configure the 'male' and 'female' values to match the texts you entered in the 'Options' box when creating the user profile field.

That said, this addon will only give useful outputs if your members update the gender profile field.
Reply With Quote
  #15  
Old 22 Nov 2008, 14:31
ReCom ReCom is offline
 
Join Date: Mar 2008
Version 1.0.2 is up with many changes (see change logs)

A special note to other coders, version 1.0.2 exposes a globally-scoped function (refer changelogs) that your mod/plugin can call to get the user gender so that it is possible to build upon this mod. One nice idea for mod is the gender-aware phrase system that many have requested in this forum.

Maybe I should stop looking at the code or else I won't stop adding features ...
Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off


New To Site? Need Help?

All times are GMT. The time now is 00:01.

Layout Options | Width: Wide Color: