Administrative and Maintenance Tools - Rank Ordering

This product will, upon installation, add a column to your "ranks" table labeled "rankorder" and will edit your "/admincp/ranks.php" and "/includes/functions_ranks.php" files so that you may assign display ordering for your defined ranks. The original code is stored as "/admincp/ranks_orig.php" and "/includes/functions_ranks_orig.php" respectively. When uninstalled, your database and files are restored to their original condition.

This add-on utilizes code written by DragonBlade and n8td as posted here:

where do I change the order of rank images?

This add-on simply automates all of the file edits and the database change into one easy step.

When you go to your "User Rank Manager" you will see a new field titled "Rank Order" associated with each defined rank:



And when you edit a rank, you will find a new field on the form into which you can set the rank order:



Rank ordering can be used to control the order in which your various ranks are displayed in user postbits and profile pages. The smaller the number, the higher in the stack a rank will be displayed.

For example, suppose you have a rank for the forum owner(s) and you want this to be on top regardless of the other ranks the owners might have. You could assign this rank a rank order of 0. Then you may have several ranks which indicate a user's position in your staff, such as administrators, global moderators, forum moderators, etc. No one user would have more than 1 of these ranks, and so you could assign these a rank order of 1. This way any of the owners who are also an admin/global mod/mod would have the site owner rank on top and then their staff position rank next.

In this manner, you can assign rank orders to completely control the order in which all of your ranks are displayed:



Note: Once you edit your ranks to assign the rank order, you must run "update user titles and ranks" in order for the ordering to take effect.

Update: version 1.1

• Added missed file edit which allows for new ranks to be successfully added after installing this add-on.

Update: version 1.2

• Reads path to admin control panel folder from config.php.

Note: If you have not renamed your "admincp" folder, then you don't need to update to v. 1.2. If you edited the v. 1.1 .XML file to use your renamed "admincp" folder, then you also don't need to upgrade to v. 1.2. If you do decide to upgrade to v. 1.2 anyway, then you need to uninstall v. 1.1 first. If you wish to keep the rank ordering you've already defined, then you need to edit the product's uninstall code to remove the following db query:

PHP Code:

// Remove "rankorder" column from "ranks" table

$vbulletin->db->hide_errors();
$vbulletin->db->query_write("
    ALTER TABLE`" . TABLE_PREFIX . "ranks`
        DROP COLUMN rankorder
"); 


To Install:

In AdminCP go to Plugins & Products -> Manage Products -> Add/Import Product.

Click on "Choose File" and browse to the product .xml file that was packaged in the .zip file.

Click "Import"

There are no settings to set, once installed, the product is active. :up:

Note: When updating your vB, please follow these steps after completing the upgrade:

First, delete the files "/includes/functions_ranks_orig.php" and "admincp/ranks_orig.php".

Next, edit the "Rank Ordering" product to remove the uninstall code completely and save it.

Then, uninstall the product.

Lastly, reinstall the product, and the new PHP files will be backed up and then edited, and you'll be back in business.

Support for this product can be found here:

• MHB - Rank Ordering
• TAZ - Rank Ordering

[Cody.9791]

Originally Posted by MarkFL

Did you get any errors when installing?

Here's what I suggest doing:

1. Rename /admincp/ranks_orig.php to /admincp/ranks_xxx.php
2. Uninstall this product.
3. Delete /admincp/ranks.php
4. Rename /admincp/ranks_xxx.php to /admincp/ranks.php
5. Upload a copy of "functions_ranks.php" to your "includes" folder.
6. Install the product again.
7. Verifiy the 4 files I asked about before are all present. If so, see if the rank ordering function works.

When I installed it the first time, I received an error. It said,

"Internal Server Error

The server encountered an internal error or misconfiguration and was unable to complete your request.
Please contact the server administrator to inform of the time the error occurred and of anything you might have done that may have caused the error.

More information about this error may be available in the server error log."

I uninstalled it and re-installed it and got the same error.

Where would I find a copy of the "functions_ranks.php" to copy to my "includes" folder?

[MarkFL]

You should be able to grab a fresh copy from your vB files on your hard drive?

[4ngeluxpunk]

Excellent, here's a tutorial on how to do old manually: http://vbforos.com/forum/recursos/ti...go-de-usuarios

[Cody.9791]

Originally Posted by MarkFL

Did you get any errors when installing?

Here's what I suggest doing:

1. Rename /admincp/ranks_orig.php to /admincp/ranks_xxx.php
2. Uninstall this product.
3. Delete /admincp/ranks.php
4. Rename /admincp/ranks_xxx.php to /admincp/ranks.php
5. Upload a copy of "functions_ranks.php" to your "includes" folder.
6. Install the product again.
7. Verifiy the 4 files I asked about before are all present. If so, see if the rank ordering function works.

I currently have the product installed and active. I go into my file manager to do the things that you suggested, but I'm not seeing "admincp/ranks_orig.php" I just see "admincp/ranks.php". I do have "includes/functions_ranks.php" however. I went to see if the display order is showing for the ranks and it is not. What do you suggest?

[MarkFL]

Were those two files on your server prior to installing this add-on?

[Cody.9791]

Originally Posted by MarkFL

Were those two files on your server prior to installing this add-on?

admincp/ranks.php & includes/functions_ranks.php? Yes, I believe so. I didn't upload any files myself.

[MarkFL]

If those files were present before the installation of this add-on, then you should find that you have copies of the originals as well as the modified versions of the originals.

Here is what I recommend doing. Uninstall the product, then delete "admincp/ranks.php" and "includes/functions_ranks.php" from your server. Upload unaltered versions of these two files from your installation fileset on your hard drive to the correct locations. Finally, install this product again. Verify that you now have 4 files (the originals that have been renamed and the modified versions).

[Cody.9791]

Originally Posted by MarkFL

If those files were present before the installation of this add-on, then you should find that you have copies of the originals as well as the modified versions of the originals.

Here is what I recommend doing. Uninstall the product, then delete "admincp/ranks.php" and "includes/functions_ranks.php" from your server. Upload unaltered versions of these two files from your installation fileset on your hard drive to the correct locations. Finally, install this product again. Verify that you now have 4 files (the originals that have been renamed and the modified versions).

I followed your exact steps.

When I went to install the product again, I got the following error:

"Internal Server Error
The server encountered an internal error or misconfiguration and was unable to complete your request.

Please contact the server administrator to inform of the time the error occurred and of anything you might have done that may have caused the error.

More information about this error may be available in the server error log."

The product shows to be installed. I went and checked the files in the directory and only "admincp/ranks.php" & "includes/functions_ranks.php" are there. Not the other two.

[MarkFL]

Without knowing the nature of the server errors, I really don't know what to tell you. It sounds like a permissions issue (chmod 777) though.

[Total-AI]

I'm having a similar issue on vBulletin 4.2.3. The plugin is installed, and I'm receiving no errors, but neither file has been created and as far as I can tell the database hasn't been affected either. It's late now so I'm not able to fiddle around with my file settings, however I'll try in the morning and let you know how I get on.

Edit: Ended up getting the plugin to install but it deleted the contents of my ranks.php and functions_ranks.php files. Not sure what the go there was. Any suggestions?