vb.org Archive

vb.org Archive (https://vborg.vbsupport.ru/index.php)
-   vB3 General Discussions (https://vborg.vbsupport.ru/forumdisplay.php?f=111)
-   -   construct_page_nav Function (https://vborg.vbsupport.ru/showthread.php?t=118411)

Reven 06-12-2006 08:07 PM

construct_page_nav Function
 
Hey,

I'm having difficulty understanding how to use the in-built function for page navigation (as used in multi-page threads, v3arcade and other addons). Here is the function:

Quote:

Originally Posted by vBulletin API
construct_page_nav (line 1752)

Returns the HTML for multi-page navigation - based on code from 3dfrontier.com

* return: Page navigation HTML

string construct_page_nav (integer $pagenumber, string $perpage, string $results, mixed $address, [mixed $address2 = ''])

* integer $pagenumber: Total number of items found
* string $perpage: Base address for links eg: showthread.php?t=99{&page=4}
* string $results: Ending portion of address for links

Some questions:

1. Does $pagenumber hold the total number of pages viewable? So for instance in a thread with 12 pages, $pagenumber would equal '12'?

2. Am I right in saying that the variable $perpage holds the request parameter and value you're using to tell your script that it is to look at a specific page? So where you want to look at the second page of a thread using showthread.php?t=235&page=2, $perpage would equal 'page=2'?

3. What is $results supposed to hold? Is it supposed to hold any anchors you use such as '#thing' to be dumped on the end of the link to the next page?

I am sure some will agree that some of the descriptions given in the API aren't very descriptive. Thanks for any help, guys.

N.B. If construct_page_nav isn't the function which does this, slap me and direct me to the one that does. However, I'm fairly certain it is, since I've been digging around in the vBulletin files for this.


All times are GMT. The time now is 07:08 AM.

Powered by vBulletin® Version 3.8.12 by vBS
Copyright ©2000 - 2025, vBulletin Solutions Inc.

X vBulletin 3.8.12 by vBS Debug Information
  • Page Generation 0.00916 seconds
  • Memory Usage 1,710KB
  • Queries Executed 10 (?)
More Information
Template Usage:
  • (1)ad_footer_end
  • (1)ad_footer_start
  • (1)ad_header_end
  • (1)ad_header_logo
  • (1)ad_navbar_below
  • (1)bbcode_quote_printable
  • (1)footer
  • (1)gobutton
  • (1)header
  • (1)headinclude
  • (6)option
  • (1)post_thanks_navbar_search
  • (1)printthread
  • (1)printthreadbit
  • (1)spacer_close
  • (1)spacer_open 

Phrase Groups Available:
  • global
  • postbit
  • showthread
Included Files:
  • ./printthread.php
  • ./global.php
  • ./includes/init.php
  • ./includes/class_core.php
  • ./includes/config.php
  • ./includes/functions.php
  • ./includes/class_hook.php
  • ./includes/modsystem_functions.php
  • ./includes/class_bbcode_alt.php
  • ./includes/class_bbcode.php
  • ./includes/functions_bigthree.php 

Hooks Called:
  • init_startup
  • init_startup_session_setup_start
  • init_startup_session_setup_complete
  • cache_permissions
  • fetch_threadinfo_query
  • fetch_threadinfo
  • fetch_foruminfo
  • style_fetch
  • cache_templates
  • global_start
  • parse_templates
  • global_setup_complete
  • printthread_start
  • bbcode_fetch_tags
  • bbcode_create
  • bbcode_parse_start
  • bbcode_parse_complete_precache
  • bbcode_parse_complete
  • printthread_post
  • printthread_complete