Add-On Releases - CES Navbits Designer

CES Navbits Designer
Version: 1.4.3

*** NEWS ***
3/17/2007 - v1.4.3 released
2/25/2007 - v1.4.2 released
2/3/2007 - v1.4.0, v1.4.1 released
2/2/2007 - v1.3.0 released
1/24/2007 - v1.2.3 released
1/15/2007 - v1.2.0, v1.2.1, v1.2.2 released, screenshots updated
1/7/2007 - v1.1.0 completed - withheld due to inefficient processing
1/5/2007 - v1.0.1, 1.0.2, 1.0.3 released, screenshots added
1/4/2007 - v1.0.0 released - Custom Navbits launched

Known Issues:
- If you are a vbWiki Pro user, and you are getting a "Style has not been updated for Custom Navbits" message in your wiki, see this post: #21

What It Does:
Using a wizard in the AdminCP, allows admins to create a breadcrumb path for the vBulletin navbar that could be practically anything. This is useful for automating navbits on custom pages or anywhere else.

For example: After searching for threads or posts, vBulletin's default lastelement is always "Search Results." However, using this mod, I have been able to change it to "Search Results in Threads" and "Search Results in Posts" respectively.

Products to Install: 1
Plugins Included: 1
Files to Upload: 5
Templates to Edit: 1
Files to Edit: 2
Queries Added:* 0

*This now adds ZERO queries to modified pages, which I figure is the query count we all care about.

Mod Features:
- Add navbits for any page in the AdminCP
- Now makes use of the datastore
- Settings in vBulletin Options
- Supports relative and absolute links
- Breadcrumb can use any custom text
- Name your various custom navbit sets
- Use conditionals for further control
- Set execute priority of navbit sets with overlapping conditions
- Navbits immediately updated
- use FORUM_HOME, THIS_PAGE, WIKI_NAME as preset variables
- supports $vboptions, $vbphrase, other variables, and HTML
- Complete support for vbWiki Pro

How many more features can we add to a navbits extension?

Current Syntax:
As of v1.2.0, just fill in the form!

When using $vbulletin options or $vbphrases, do not use quotes inside the brackets:
BAD: $vbulletin->options['option']
GOOD: $vbulletin->options[option]

Tutorials:
- Introduction to creating custom navbits: Basic Tutorial
- How to exclude a parent forum from multiple subforums at once: Parentlist Tutorial

Changelog:
As of Version 1.4.3:
- fixed a warning that would occur in the AdminCP when no custom sets
had been created

As of Version 1.4.2:
- updated product dependency

As of Version 1.4.1:
- fixed a bug where the last element would be empty if script had a
custom set and the conditions returned false
- updated phrases
- fixed bug where table ces_navbits would not be removed from the
database on upgrade

Ideas for Future Versions:
- Suggestions?

Screenshots:
In order, these screenshots show the process:
1. Before Navbits Management
2. AdminCP Link
3. AdminCP Navbits Manager
4. AdminCP Navbits Designer (pre v1.4.1)
5. After Navbits Management

[thincom2000]

vbWiki Pro does not properly get the global variables $first_navbit, $bitters, and $last_navbit

As a result, if you try to modify navbits for a wiki article, you will get a "This style has not been updated for Custom Navbits" error, even though you have made the correct updates. In order to workaround this strangeness, vbWiki Pro users should add the following plugin (this requires vbWiki Pro hooks which is why I am not including this in the product).

Product: CES Navbits Designer
Hookname: vbwikipro_before_navbits
Title: Navbits Globals
Phpcode:

PHP Code:

global $first_navbit, $final_navbit, $bitters; 


[RedGTiVR6]

I've tried installing this mod on our forums and I'm getting an error that it needs 3.6.4 to run. We're currently running 3.6.3.

I noticed in the description that it' listed as just needing 3.6.0.

Perhaps I'm doing something wrong?

[thincom2000]

You can edit the product file in Notepad, and change the product dependency to match your installation. I'll update the product posted here, thanks.

[RedGTiVR6]

sweet!

that did it.

Thanks...

*clicks installed* and rates!

[RedGTiVR6]

Invalid argument supplied for foreach() in /admincp/navbits_designer.php on line 273

Any ideas?

Installed and edited code and templates. When I go to the AdminCP pannel for the NavBits, this is above it.

This is like 273:

	foreach ($ces_navbits AS $navers)

[RedGTiVR6]

Originally Posted by thincom2000

Script Title tells the hack what PHP script to modify navbits in. If you're not sure what this is, open the file and look for the line that starts

PHP Code:

define('THIS_SCRIPT' ... 


The definition of THIS_SCRIPT is what you fill in here.

Pardon my ignorance...but I don't understand this statement. Where do I look to find this? In the .xml file? In one of the uploaded files? In a template? And what does it do?

[thincom2000]

It's in vBulletin's PHP files. For example, on SHOWTHREAD (showthread.php), the line would be:

PHP Code:

define('THIS_SCRIPT', 'showthread'); 


In search.php:

PHP Code:

define('THIS_SCRIPT', 'search'); 


In FORUMHOME, or index.php:

PHP Code:

define('THIS_SCRIPT', 'index'); 


Unless you have them memorized (or for files added by hacks), you have to check the file for the THIS_SCRIPT definition, otherwise this hack won't know what page to change the navbits on.

[Souli]

thx4share

click install and nominate :up:

my navbar:
FORUM_HOME > Forum1 > Forum2 > Forum3 > THIS_PAGE

I need in a specific subforum for all included subs:
Forum2 > Forum3 > THIS_PAGE
is it possible ?

the NAVKEYS (3-4) function doesn?t work

[thincom2000]

Originally Posted by Souli

the NAVKEYS (3-4) function doesn?t work

Don't use parentheses. The readme just shows ( ) to indicate that part is optional.

Originally Posted by Souli

I need in a specific subforum for all included subs:
Forum2 > Forum3 > THIS_PAGE
is it possible ?

This was not possible until Version 1.4.0. If you are running 1.4.x or later,
I have done what you ask with the following:

Script Title: forumdisplay

First URL: FORUM_HOME
URLs: NAVKEYS 3-4
- In this case, Forum Home > Forum1 would be NAVKEYS 1-2
Final URL: THIS_PAGE

First Text: FORUM_HOME
Text: NAVBITS
Final Text: THIS_PAGE

Globals:

$foruminfo, $subforum_is_parent

Condition:

($foruminfo['forumid'] == SUBFORUM_ID) OR $subforum_is_parent

In order for this to work you need to create a plugin to get the current forum's parentlist, and perform a check that will set $subforum_is_parent

Hook Location: forumdisplay_start
Plugin Code:

PHP Code:

global $subforum_is_parent;

$parentlist = array_reverse(explode(',', substr($foruminfo['parentlist'], 0, -3)));
foreach ($parentlist AS $forumID)
{
    $subforum_is_parent = ($forumID == SUBFORUM_ID) ? true : $subforum_is_parent;
} 


Note that additional $subforums can easily be added to this check by creating additional variables in the global statement, and by duplicating the line

PHP Code:

$subforum_is_parent = ($forumID == SUBFORUM_ID) ? true : $subforum_is_parent; 


[Souli]

thank you!

works without any problems :up: