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

[Snowhog]

Running vBulletin 4.2.3 Patch Level 2.

Installed just now, but there is no rankorder column when I go into User Rank Manager.

Purpose

This product will...edit your "/admincp/ranks.php" and "/includes/functions_ranks.php" files...

Our installation doesn't have directory /admincp; we have /admincontrolpanel instead, so ranks.php hasn't been modified. File /includes/functions_ranks.php wasn't modified either.

Thoughts? Suggestions?

Added:
Just read post#35. Edited the .xml to replace admincp with admincontrolpanel and reloaded. Same result; no rankorder column and the two files remain unchanged.

[MarkFL]

Originally Posted by Snowhog

Running vBulletin 4.2.3 Patch Level 2.

Installed just now, but there is no rankorder column when I go into User Rank Manager.

Our installation doesn't have directory /admincp; we have /admincontrolpanel instead, so ranks.php hasn't been modified. File /includes/functions_ranks.php wasn't modified either.

Thoughts? Suggestions?

Try doing what this user did:

Originally Posted by vpcarrocci

Installed!

It didn't work on the first install but I quickly figured out that it was due to the fact that I had changed the name of the my "admincp" folder. I uninstalled the plug-in and created a new empty folder that I titled as "admincp" and uploaded the rank.php file into it. I then installed the plug-in again, moved the two files from the "admincp" folder into my renamed admincp folder and everything is working just as advertised. I also deleted the dummy admincp folder.

Thanks for the cool plug-in!

Or, you might get away with just uninstalling the product, then rename "/admincontrolpanel" to "/admincp", then install the product, and once you verify it works, rename the folder "/admincp" back to "/admincontrolpanel".

[Snowhog]

Tried uninstalling the MOD first, and then reloading it. Same results.

I can't just rename the /admincontrolpanel to /admincp as doing so results in my not being able to access the AdminCP. I had renamed this folder several years ago for security reasons.

Where in vBulletin is the folder name for admincp set?

[MarkFL]

Originally Posted by Snowhog

Tried uninstalling the MOD first, and then reloading it. Same results.

I can't just rename the /admincontrolpanel to /admincp as doing so results in my not being able to access the AdminCP. I had renamed this folder several years ago for security reasons.

Where in vBulletin is the folder name for admincp set?

In the file "includes/config.php" look for the line:

PHP Code:

    //    ****** PATH TO ADMIN & MODERATOR CONTROL PANELS ****** 


and change them there as well...sorry for leaving out that step, perhaps this is why vpcarrocci used the "dummy folder" method instead.

[Snowhog]

That file exists in two locations; our server forum root as well as /includes.

I edited both files are replaced admincontrolpanel with admincp. Renamed the /admincontrolpanel folder to /admincp.

When I attempt to load the AdminCP it fails with:

The requested URL /admincontrolpanel/index.php was not found on this server.

I've reset both files and renamed the folder back so that at least getting into the AdminCP still works.

Is this likely just a browser cache problem?

[MarkFL]

Try vpcarrocci's method...

[Snowhog]

Duplicating exactly what post #40 did also doesn't work here.

The ranks.php file in the created /admincp folder remains unchanged and the second file: ranks_orig.php; doesn't exist/wasn't created.

The same is true of the /includes/functions.php file. It remains unchanged and the second file: functions_orig.php doesn exist/wasn't created.

Installing the MOD didn't present any errors of any kind.

[MarkFL]

Originally Posted by Snowhog

Duplicating exactly what post #40 did also doesn't work here.

The ranks.php file in the created /admincp folder remains unchanged and the second file: ranks_orig.php; doesn't exist/wasn't created.

The same is true of the /includes/functions.php file. It remains unchanged and the second file: functions_orig.php doesn exist/wasn't created.

Installing the MOD didn't present any errors of any kind.

Send the login credentials to an admin account with FTP access to me by PM, and I will try to resolve the issue.

[Snowhog]

I'll do that if it really becomes necessary.

As neither the source files are being changed; date/time stamp isn't changing; and the backup files aren't being created, I thought maybe it's a permission issue, like it was with the other MOD I mucked with.

Both directories; admincontrolpanel and inlcudes; have permissions of 755. The contents of both directories have permissions of 644. I changed the directories to 775 and the two individual .php files to 775 and reran the installation .xml file. Still didn't get any error notifications, but the result was the same; no backup files created and the original files remained untouched.

Permissions on the directories and the two files have been reset back to what they were.

Is there a way to capture what's going on when the .xml file is run to a log file we can then examine?

[MarkFL]

Originally Posted by Snowhog

I'll do that if it really becomes necessary.

As neither the source files are being changed; date/time stamp isn't changing; and the backup files aren't being created, I thought maybe it's a permission issue, like it was with the other MOD I mucked with.

Both directories; admincontrolpanel and inlcudes; have permissions of 755. The contents of both directories have permissions of 644. I changed the directories to 775 and the two individual .php files to 775 and reran the installation .xml file. Still didn't get any error notifications, but the result was the same; no backup files created and the original files remained untouched.

Permissions on the directories and the two files have been reset back to what they were.

Is there a way to capture what's going on when the .xml file is run to a log file we can then examine?

If you have errors and/or warnings being suppressed by your config.php file, try turning that off (just comment that out) when you run the install. When done, then uncomment those lines.